From: dana@hpcvusc (Dana Laursen )
Newsgroups: comp.sys.hp
Subject: Vue 3.0 Front Panel
Summary: front panel configuration notes
Date: 10 Nov 92 18:47:04 GMT
Organization: Hewlett-Packard Company, Corvallis, Oregon USA
X-Newsreader: Tin 1.1 PL5


________________________________________________________________

Vue 3.0 Application Notes
FRONT PANEL CONFIGURATION

October 21, 1992

________________________________________________________________


SUMMARY

Use this document for supplementary reference information
regarding configuration of the Vue 3.0 FRONT PANEL.

There is a section in this document for each FRONT PANEL component:
    FRONT PANEL
    BOX (primary, secondary and subpanel)
    SWITCH
    Blank CONTROL
    Busy CONTROL
    Button CONTROL
    Client CONTROL
    Clock CONTROL
    Date CONTROL
    IconBox CONTROL
    Mail CONTROL
    Monitor_File CONTROL
    IMAGE
    ANIMATION
    ARROW
Refer to one of these sections to find the configuration options
available for a particular component.

To customize the FRONT PANEL:
    Use the EditVuewmrc action in the System_Admin folder
    of the GeneralToolbox, then restart Vuewm.

See the "Porting Notes" section for help converting a VUE 2.0
FRONT PANEL to VUE 3.0 format.

For more information, see the "Customizing the Front Panel"
online help topics, and the vuewmrc(4X) and vuewm(1X) manpages.



________________________________

ICON AND RESOURCE CONFIGURATION
________________________________

Use icons in the FRONT PANEL for the IMAGE (and ALTERNATE_IMAGE) of CONTROLs,
and for PUSH_ANIMATION and DROP_ANIMATION sequences.
The FRONT PANEL automatically selects icons of the proper size
(large, medium or small) and type (multicolor or bitonal).
For icon resources, see PANEL Resources.

Use the Vue IconEditor to edit multicolor (XPM format)
and bitonal (XBM format) icons.
Use the "IconEditor" Icon in the Vue Personal Toolbox Subpanel
or the "Icon Editor" CONTROL in the Vuelite Tools Subpanel to
invoke the IconEditor.
See vueicon (1X) manpage for more information.

Create a $HOME/.vue/icons directory to use for custom icons.
See /usr/vue/icons/Vuewm for the standard FRONT PANEL icons.
For information about the search path for icons, refer to the online
help for the IconEditor (choose "Reference..." from the "Help" menu).

To enable "instance-based" icon browsing in the file manager,
refer to IconBrowse.vf in the /usr/vue/examples directory.


Icon Names
________________________________

The name of an icon includes extensions for size and type.

Here are examples of multicolor icon names:
    logo.l.pm	(large multicolor logo icon)
    logo.m.pm	(medium multicolor logo icon)
    logo.s.pm	(small multicolor logo icon)

Here are examples of bitonal icon names:
    logo.l.bm	(large bitonal logo icon)
    logo.l_m.bm	(large bitonal logo mask)
    logo.m.bm	(medium bitonal logo icon)
    logo.m_m.bm	(medium bitonal logo mask)
    logo.s.bm	(small bitonal logo icon)
    logo.s_m.bm	(small bitonal logo mask)

By convention, only the basename is used in FRONT PANEL definitions.
You may include the size and icon type extensions with icon names
in FRONT PANEL definitions, but this will disable icon lookup
based on color mode and display resolution.


Icon Size and Display Resolution
________________________________

The FRONT PANEL automatically selects icon size based on display resolution.
Here are examples of icon sizes used for common display widths:
    large	1280 (high resolution)
    medium	1024 (medium resolution)
    small	640  (low resolution)

Here are the standard dimensions for FRONT PANEL icons based on icon size:
		primary or subpanel	secondary
    large	64 x 56			52 x 22
    medium	48 x 42			42 x 17
    small	32 x 32			28 x 13


Multicolor Icons
________________________________

The FRONT PANEL uses multicolor (XPM) icons on color displays
with 8 or more planes by default,
or if the useMultiColorIcons resource is set to false.

To add a custom icon:
    Copy similar icon from /usr/vue/icons/Vuewm/Color directory
    to $HOME/.vue/icons/Vuewm/Color directory.
    Use IconEditor to edit icon.

To customize a standard icon:
    Copy standard icon from /usr/vue/icons/Vuewm/Color directory
    to $HOME/.vue/icons/Vuewm/Color directory.
    Use IconEditor to customize icon.

An icon in $HOME/.vue/icons/Vuewm/Color will be used instead of a
standard icon if it has the same name as the standard icon.
A new icon name must be referenced in configuration files.

For a non-rectangular icon, fill the background with transparent color.
With XPM format, mask information is included in the icon file,
so no additional mask file is necessary.

See /usr/vue/icons/Vuewm/Color/*.*.pm for the standard multicolor
FRONT PANEL icons.


Bitonal Icons
________________________________

The FRONT PANEL uses bitonal (XBM) icons on black and white displays
and on color displays with fewer than 8 planes by default,
or if the useMultiColorIcons resource is set to false.

To add a custom bitonal icon:
    Copy similar icon and mask from /usr/vue/icons/Vuewm directory
    to $HOME/.vue/icons/Vuewm directory.
    Use IconEditor to edit icon.

To customize a standard bitonal icon:
    Copy standard icon and mask from /usr/vue/icons/Vuewm directory
    to $HOME/.vue/icons/Vuewm directory.
    Use IconEditor to customize icon.

An icon in $HOME/.vue/icons/Vuewm will be used instead of a
standard icon if it has the same name as the standard icon.
A new icon name must be referenced in configuration files.

For a non-rectangular icon, fill the background with transparent color.
With XBM format, a mask file is required for non-rectangular icons.
IconEditor generates and manages XBM mask files automatically.

See /usr/vue/icons/Vuewm/*.*.bm for the standard bitonal FRONT PANEL icons.


Using Resources
________________________________

To set FRONT PANEL resources:
    Use the EditResources action in the System_Admin folder
    of the GeneralToolbox, then restart Vuewm.



________________________________

FRONT PANEL CONFIGURATION
________________________________

Use the PANEL object to define the BOXes in a FRONT PANEL.

See /usr/vue/config/sys.vuewmrc and /usr/vue/config/panels/*
for the default FRONT PANEL configuration files.


PANEL Components and Attributes
________________________________

BOX		< BOX name >
    Use this keyword to specify the name of a BOX component.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a default HELP_STRING or HELP_TOPIC
    for a FRONT PANEL.


PANEL Resources
________________________________

Vuewm*frontPanel*name:			< PANEL name >
    Use this resource to select the name of the FRONT PANEL.
    The default is FrontPanel for regular Vue,
    LiteFrontPanel for Vuelite.

Vuewm*useDefaultGeometry:		< true | false >
    To always center the FRONT PANEL at the bottom of the display,
    set this resource to true.
    The default is false (use previous location).

Vuewm*useFrontPanel:			< true | false >
    To eliminate the FRONT PANEL, set this resource to false.
    The default is true.

Vuewm*useMultiColorIcons:		< true | false >
    To use bitonal icons instead of color icons in the FRONT PANEL,
    set this resource to false.
    The default is true if the color server is running and
    the color mode is high color, otherwise the default is false.
    This resource must be set to false if the color server is not running.
 
Vuewm*<_panel_name_>*clientDecoration:	< decoration list >
    Use this resource to specify the decorations for the FRONT PANEL. 
    The default is border.

Vuewm*<_panel_name_>*highResFontList:	< font >
Vuewm*<_panel_name_>*mediumResFontList:	< font >
Vuewm*<_panel_name_>*lowResFontList:	< font >
    Use these resources to select the fonts used for
    small, medium and large FRONT PANELs.
    See /usr/vue/app-defaults/Vuewm for default values.

Vuewm*<_Panel_name_>*resolution:	< 640 | 1024 | 1280 >
    Use this resource to select small, medium or large size FRONT PANEL.
    The default is based on display width.

Vuewm*<_Panel_name_>*useEmbossedText:	< true | false >
    To turn off embossed text in a color FRONT PANEL,
    set this resource to false.
    The default is true for color (always false for black and white).

Vuewm*Control.pushButtonClickTime:	< milliseconds >
    Use this resource to specify (for all CONTROLs) the delay
    after a mouse click during which subsequent clicks are ignored.
    The default is 1000 (one second).


PANEL Examples
________________________________

To select the Vuelite FRONT PANEL (and Vuelite session):
    Exit session, select vuelite from options menu, log in.

To use black and white for the FRONT PANEL:
    Use Vuestyle Color dialog to select "black and white" color use,
    restart session.

To customize the FRONT PANEL:
    Use the EditVuewmrc action in the System_Admin folder
    of the GeneralToolbox, then restart the window manager.



________________________________

BOX CONFIGURATION
________________________________

Use the BOX object to define a row in a PANEL object,
and to define the SUBPANEL of a PRIMARY CONTROL.


BOX Components and Attributes
________________________________

BACKGROUND_TILE < icon or image name >
    Use this keyword to specify the BACKGROUND_TILE for a BOX.
    For a secondary BOX, the default is rib.
    For a primary or subpanel BOX the default is none (for color)
    or 50_foreground (for black and white).

COLOR_SET	< color set >
    Use this keyword to specify the COLOR_SET for a BOX.
    COLOR_SET values range from 1 to 8 (active, inactive, primary, secondary,
    followed by four other unnamed color sets).
    For a primary or subpanel BOX the default is the Vuewm primary color set.
    For a secondary BOX the default is the Vuewm secondary color set.

CONTROL		< CONTROL name >
    Use this keyword to specify the name of a CONTROL component.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a default HELP_STRING or HELP_TOPIC
    for a BOX.

LAYOUT_POLICY   < standard | as_needed >
    Use "LAYOUT_POLICY standard" to force standard primary and
    secondary BOX height based on resolution.
    With standard LAYOUT_POLICY the width of a CONTROL
    in a primary or secondary BOX is set to a multiple
    of one half the standard CONTROL width of the BOX,
    resulting in standard sized CONTROLs.
    Use "LAYOUT_POLICY as_needed" for layout based
    on the preferred size of components.
    This means that CONTROLs will be evenly spaced.
    For a subpanel BOX, standard and as_needed LAYOUT_POLICY are equivalent.
    The default is standard for all BOX types.

SWITCH		< SWITCH name >
    Use this keyword to specify the name of a SWITCH component.

TITLE		< title >
    For a subpanel BOX, use this keyword to specify the Vuewm title
    of the subpanel window.
    The default is the name of the BOX.

TYPE		< primary | secondary | subpanel >
    Use this keyword to specify a TYPE for a BOX.
    Use "TYPE primary" for a BOX with space for subpanel ARROWs.
    Use "TYPE secondary" for a shorter BOX with a default BACKGROUND_TILE.
    Use "TYPE subpanel" for a SUBPANEL.
    The default is secondary.


BOX Resources
________________________________

Vuewm*primaryColorSetId:		< color set >
Vuewm*secondaryColorSetId:		< color set >
    Use the primaryColorSetId resource to set the COLOR_SET
    of FRONT PANEL primary and subpanel BOXes.
    Use the secondaryColorSetId resource to set the COLOR_SET
    of FRONT PANEL secondary BOXes and Vuewm dialog boxes.
    COLOR_SET values range from 1 to 8.
    See /usr/vue/app-defaults/Vuewm for default values.

Vuewm*<_BOX_name_>*subpanelDecoration:	< decoration list >
    Use this resource to specify the decorations for a subpanel BOX.
    The default is border.


BOX Icons
________________________________

/usr/vue/icons/Vuewm/rib.*.*
/usr/vue/icons/Vuewm/Color/rib.*.*
    Secondary BOXes use these icons for the default BACKGROUND_TILE
    to get the "ribbing" effect.
    To customize, specify BACKGROUND_TILE for the BOX
    or insert rib.*.* icons earlier in your icon path.


BOX Examples
________________________________

To evenly space CONTROLs in a BOX:
    Define BOX with as_needed LAYOUT_POLICY,
    alternating Blank CONTROLs and regular CONTROLs.
	BOX Middle
	{
	    TYPE             secondary
	    LAYOUT_POLICY    as_needed
	    CONTROL          OuterBlank
	    CONTROL          One
	    CONTROL          InnerBlank
	    CONTROL          Two
	    CONTROL          OuterBlank
	}
    Set default widths for regular CONTROLs and Blank CONTROLs.
	Vuewm*FrontPanel*Middle*Control.width:      56
	Vuewm*FrontPanel*Middle*InnerBlank.width:   28
	Vuewm*FrontPanel*Middle*OuterBlank.width:   14

See also SWITCH Examples, Blank CONTROL Examples and Client CONTROL Examples.



________________________________

SWITCH CONFIGURATION
________________________________

Use the SWITCH object to change from one workspace to another.

Only one SWITCH is allowed.
Include the SWITCH in a primary or secondary BOX.


SWITCH Attributes
________________________________

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a SWITCH.

LAYOUT_POLICY   < standard | as_needed >
    To allow layout based on the preferred size of components,
    set LAYOUT POLICY of the SWITCH to as_needed.
    The default is standard.

NUMBER_OF_ROWS	< number >
    Use this keyword to specify the number of rows in the SWITCH. 
    The default is 2.


SWITCH Resources
________________________________

Vuewm*workspaceList:			< name list >
    Use this resource to specify the number and names
    of workspaces for the SWITCH (and for Vuewm).
    See /usr/vue/app-defaults/Vuewm for default value.

Vuewm*<_workspace_name_>*title:		< title string >
    Use this resource to specify the title of a workspace
    to display in the SWITCH.
    The default value is the workspace (see workspaceList resource).

For font resources, see PANEL Resources.


SWITCH Examples
________________________________

To add three additional workspaces to the SWITCH:
    Use the EditResources action in the System_Admin folder
    of the GeneralToolbox to modify the value of the workspaceList resource.
	Vuewm*workspaceList:    One Two Three Four Five Six Seven Eight Nine
    Restart Vuewm.
    Set LAYOUT_POLICY of Top BOX to as_needed.
	BOX Top
	{
	    TYPE             primary
	    LAYOUT_POLICY    as_needed
	    ...
	}
    Set NUMBER_OF_ROWS to 3.
	SWITCH           Switch
	{
	    NUMBER_OF_ROWS   3
	}

For a single row switch in a separate box:
    Delete Switch reference from Top BOX.
	#   SWITCH           Switch
    Add BOX for SWITCH to PANEL.
	    BOX              Middle
    Define BOX for SWITCH with as_needed LAYOUT_POLICY
    and no BACKGROUND_TILE.
	BOX Middle
	{
	    TYPE             secondary
	    BACKGROUND_TILE  none
	    LAYOUT_POLICY    as_needed
	    SWITCH           Switch
	}
    Set LAYOUT_POLICY of SWITCH to as_needed, NUMBER_OF_ROWS to 1.
	SWITCH           Switch
	{
	    LAYOUT_POLICY    as_needed
	    NUMBER_OF_ROWS   1
	}
    Set minimum width for SWITCH toggles.
	Vuewm*FrontPanel*Switch*Control.width: 100

To invert black and white SWITCH labels:
    Use Vuestyle Color dialog to select an alternate "color" sheme
    for black and white, restart session.



________________________________

BLANK CONTROL CONFIGURATION 
________________________________

Use a Blank CONTROL for spacing between other CONTROLs.
No definition is required for a default Blank CONTROL.


Blank CONTROL Attributes
________________________________

TYPE		< blank >
    Use "TYPE blank" to specify a Blank CONTROL.


Blank CONTROL Resources
________________________________

Vuewm*<_control_name_>.height:		< height >
Vuewm*<_control_name_>.width:		< width >
    Use resources like these to set default sizes for Blank CONTROLS.
    If setting height of Blank CONTROL in a primary or secondary BOX,
    set LAYOUT_POLICY of BOX to as_needed.
    The default width of a Blank CONTROL in a primary or secondary BOX
    is half the standard CONTROL width of the BOX.


Blank CONTROL Examples
________________________________

To specify the width for Blanks CONTROLs in a BOX:
    Use resource to set default width.
	Vuewm*FrontPanel*Bottom*Blank.width:   56

To define a Blank CONTROL that is 100 pixels square:
    Define Blank CONTROL.
	CONTROL Blank100
	{
	    TYPE             Blank
	}
    Use resources to set default size of a Blank100 CONTROL.
	Vuewm*FrontPanel*Blank100.width:   100
	Vuewm*FrontPanel*Blank100.height:  100
    Set as_needed LAYOUT_POLICY for BOX containing Blank100.
	    LAYOUT_POLICY    as_needed

To disable the spanning feature (stretch from previous CONTROL 
to right edge of BOX) for the last CONTROL in a BOX:
    Add a Blank CONTROL at the end of the BOX.
	BOX Middle
	{
	    TYPE             secondary
	    CONTROL          One
	    CONTROL          Two
	    CONTROL          Three
	    CONTROL          Four
	    CONTROL          Blank
	}

See also OuterBlank and InnerBlank in BOX Examples.



________________________________

BUSY CONTROL CONFIGURATION
________________________________

Use a Busy CONTROL in a PANEL to indicate system activity
(alternate between IMAGE and ALTERNATE_IMAGE).
Only one Busy CONTROL may be included in a PANEL.
The Busy CONTROL must be included in secondary BOX
and is always positioned at the far right of the BOX.


Busy CONTROL Attributes
________________________________

ALTERNATE_IMAGE	< icon name >
    Use this keyword to specify an ALTERNATE_IMAGE icon for a Busy CONTROL.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Busy CONTROL.

IMAGE		< icon name >
    Use this keyword to specify the IMAGE icon for a Busy CONTROL.
    The default is the name of the Busy CONTROL.

LABEL		< string >
    Use this keyword to specify a LABEL for a Busy CONTROL.
    The LABEL is positioned to the left of the IMAGE (if any).
    The default (used if LABEL is unspecified and IMAGE is unspecified
    or not found) is the name of the Busy CONTROL.

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.action <name>" or "PUSH_ACTION f.exec <command>"
    to specify a PUSH_ACTION for a Busy CONTROL.

TYPE		< busy >
    Use "TYPE busy" to specify a Busy CONTROL.


Busy CONTROL Resources
________________________________

Vuewm*<_busy_name_>.clientTimeoutInterval:	< milliseconds >
    Use this resource to specify the maximum duration
    to blink the Busy CONTROL when a Client is started.
    The default is 10000 (ten seconds).

Vuewm*<_busy_name_>.waitingBlinkRate:		< milliseconds >
    Use this resource to specify the rate of alternation
    between an IMAGE and an ALTERNATE_IMAGE.

See also pushButtonClickTime in PANEL Resources.


Busy CONTROL Icons
________________________________

/usr/vue/icons/Vuewm/Color/exit.*.pm
/usr/vue/icons/Vuewm/Color/exit02.*.pm
/usr/vue/icons/Vuewm/exit.*.bm
/usr/vue/icons/Vuewm/exit02.*.bm
    These are IMAGE and ALTERNATE_IMAGE icons for a Busy CONTROL
    in a secondary BOX (used for the standard Busy CONTROL).

/usr/vue/icons/Vuewm/Color/exitl.*.pm
/usr/vue/icons/Vuewm/Color/exitl02.*.pm
/usr/vue/icons/Vuewm/exitl.*.bm
/usr/vue/icons/Vuewm/exitl02.*.bm
    These are IMAGE and ALTERNATE_IMAGE icons for a Busy CONTROL
    in a secondary BOX that include only the light
    (no miniature login screen with exit label).

For font and icon resources, see PANEL Resources.


Busy CONTROL Examples
________________________________

To define a Busy CONTROL with a light and a label:
    Define BusyLight CONTROL.
	CONTROL BusyLight
	{
	    TYPE             busy
	    LABEL            "Exit"
	    IMAGE            exitl
	    ALTERNATE_IMAGE  exitl02
	    PUSH_ACTION      f.action EXIT_SESSION
	}
    Use BusyLight CONTROL instead of Busy CONTROL in Bottom BOX.
	    CONTROL          BusyLight



________________________________

BUTTON CONTROL CONFIGURATION
________________________________

Use a Button CONTROL to encapsulate an action or a command,
or as a label.


Button CONTROL Attributes
________________________________

CLIENT_NAME	< client name >
    Use this keyword to specify a CLIENT_NAME for a Button CONTROL.
    The CLIENT_NAME should match the first (res_name) string in the 
    WM_CLASS property on the application's window.
    This is normally set with the -name option in the command line.
    This may be set directly in your PUSH_ACTION if you use f.exec,
    or in the action definition if you use f.action.
    Use the xprop(1) to examine the value of the WM_CLASS property.
    The default is the name of the Button CONTROL.

DROP_ACTION	< action definition >
    Use "f.action <name>" to specify a DROP_ACTION for a Button CONTROL.

DROP_ANIMATION	< animation name >
    Use this keyword to specify a DROP_ANIMATION for a Button CONTROL.
    The DROP_ANIMATION is displayed before the DROP_ACTION is invoked.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Button CONTROL.

IMAGE		< icon name >
    Use this keyword to specify the IMAGE icon for a Button CONTROL.
    The default is the name of the Button CONTROL.

LABEL		< string >
    Use this keyword to specify a LABEL for a Button CONTROL.
    If the CONTROL is in a primary or subpanel BOX,
    the LABEL is positioned below the IMAGE (if any).
    If the CONTROL is in a secondary BOX,
    the LABEL is positioned to the right of the IMAGE (if any).
    The default (used if LABEL is unspecified and IMAGE is unspecified
    or not found) is the name of the Button CONTROL.

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.action <name>" or "PUSH_ACTION f.exec <command>"
    to specify a PUSH_ACTION for a Button CONTROL.

PUSH_ANIMATION	< animation name >
    Use this keyword to specify a PUSH_ANIMATION for a Button CONTROL.
    The PUSH_ANIMATION is displayed before the PUSH_ACTION is invoked.

PUSH_RECALL	< true | false >
    To create a single instance of CLIENT_NAME for a Button CONTROL,
    set this keyword to true.
    To create multiple instances of CLIENT_NAME for a Button CONTROL,
    set this keyword to false.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for a Button CONTROL.
    The Button CONTROL must be in a primary BOX.

TITLE		< title >
    Use this keyword to specify the Vuewm title for the CLIENT_NAME window
    of a Button CONTROL.
    The default is CLIENT_NAME.

TYPE		< button >
    Use "TYPE button" to specify a Button CONTROL.
    The default CONTROL TYPE is button.


Button CONTROL Resources
________________________________

Vuewm*<_control_name_>.height:		< height >
Vuewm*<_control_name_>.width:		< width >
    Use resources like these to set default sizes for Button CONTROLS.
    If setting height of Button CONTROL in a primary or secondary BOX,
    set LAYOUT_POLICY of BOX to as_needed.
    The default width of a Button CONTROL in a primary or secondary BOX
    is half the standard CONTROL width of the BOX.

For font and icon resources, see PANEL Resources.
See also pushButtonClickTime in PANEL Resources.


Button CONTROL Icons
________________________________

/usr/vue/icons/Vuewm/Color/bigtbox.*.pm
/usr/vue/icons/Vuewm/bigtbox.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the toolbox1 "General" CONTROL).

/usr/vue/icons/Vuewm/Color/caction.*.pm
/usr/vue/icons/Vuewm/caction.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the ltool4 "Create Action" CONTROL).

/usr/vue/icons/Vuewm/Color/dclock.*.pm
/usr/vue/icons/Vuewm/dclock.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the ltool2 "Digital Clock" CONTROL).

/usr/vue/icons/Vuewm/Color/djet.*.pm
/usr/vue/icons/Vuewm/djet.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the printer2 "HP Deskjet" CONTROL).

/usr/vue/icons/Vuewm/Color/help.*.pm
/usr/vue/icons/Vuewm/help.*.bm
    These are IMAGE icons for a Help Button CONTROL in a secondary BOX.

/usr/vue/icons/Vuewm/Color/helpmgr.*.pm
/usr/vue/icons/Vuewm/helpmgr.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the Help CONTROL and the help0 "Top Level" CONTROL).

/usr/vue/icons/Vuewm/Color/hfp.*.pm
/usr/vue/icons/Vuewm/hfp.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the help3 "On Front Panel" CONTROL).

/usr/vue/icons/Vuewm/Color/hmanpg.*.pm
/usr/vue/icons/Vuewm/hmanpg.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the help2 "Man Page" CONTROL).

/usr/vue/icons/Vuewm/Color/home.*.pm
/usr/vue/icons/Vuewm/home.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the Home CONTROL).

/usr/vue/icons/Vuewm/Color/honitem.*.pm
/usr/vue/icons/Vuewm/honitem.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the help4 "On Item" CONTROL).

/usr/vue/icons/Vuewm/Color/hptermr.*.pm
/usr/vue/icons/Vuewm/hptermr.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the term2 "Remote Hpterm" CONTROL).

/usr/vue/icons/Vuewm/Color/hwelcom.*.pm
/usr/vue/icons/Vuewm/hwelcom.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the help1 "Welcome" CONTROL).

/usr/vue/icons/Vuewm/Color/ljet.*.pm
/usr/vue/icons/Vuewm/ljet.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the Printer CONTROL and printer0 "Default" CONTROL).

/usr/vue/icons/Vuewm/Color/ljet3.*.pm
/usr/vue/icons/Vuewm/ljet3.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the printer1 "HP Laserjet III" CONTROL).

/usr/vue/icons/Vuewm/Color/lock.*.pm
/usr/vue/icons/Vuewm/lock.*.bm
    These are IMAGE icons for a Button CONTROL in a secondary BOX
    (used for the Lock CONTROL and LiteLock CONTROL).

/usr/vue/icons/Vuewm/Color/logo.*.pm
/usr/vue/icons/Vuewm/logo.*.bm
    These are IMAGE icons for a Button CONTROL in a secondary BOX
    (used for the Logo CONTROL).

/usr/vue/icons/Vuewm/Color/netboxs.*.pm
/usr/vue/icons/Vuewm/netboxs.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the toolbox1 "Network" CONTROL).

/usr/vue/icons/Vuewm/Color/style.*.pm
/usr/vue/icons/Vuewm/style.*.bm
    These are IMAGE icons for a Style Button CONTROL in a secondary BOX.

/usr/vue/icons/Vuewm/Color/stylemg.*.pmn
/usr/vue/icons/Vuewm/stylemg.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the Style CONTROL).

/usr/vue/icons/Vuewm/sysload.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the ltool1 "System Load" CONTROL).

/usr/vue/icons/Vuewm/Color/tbxbook.*.pm
/usr/vue/icons/Vuewm/tbxbook.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the toolbox3 "Marketplace" CONTROL).

/usr/vue/icons/Vuewm/Color/term.*.pm
/usr/vue/icons/Vuewm/term.*.bm
    These are IMAGE icons for a Button CONTROL in a secondary BOX
    (used for the Terminal CONTROL).

/usr/vue/icons/Vuewm/Color/termina.*.pm
/usr/vue/icons/Vuewm/termina.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the Terminals CONTROL and the term0 "Local Hpterm" CONTROL).

/usr/vue/icons/Vuewm/Color/tools.*.pm
/usr/vue/icons/Vuewm/tools.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the Tools CONTROL, toolbox0 "Personal" CONTROL,
    Toolboxes CONTROL and ltool0 "Main Tool" CONTROL).

/usr/vue/icons/Vuewm/Color/vueicon.*.pm
/usr/vue/icons/Vuewm/vueicon.*.bm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the ltool3 "Icon Editor" CONTROL).

/usr/vue/icons/Vuewm/Color/vuepad.*.pm
/usr/vue/icons/Vuewm/vuepad.*.bm
    These are IMAGE icons for a Button CONTROL in a secondary BOX
    (used for the TextEdit CONTROL).

/usr/vue/icons/Vuewm/wsren.*.bm
/usr/vue/icons/Vuewm/Color/wsren.*.pm
    These are IMAGE icons for a Button CONTROL in a secondary BOX
    (used for the LiteRename CONTROL).

/usr/vue/icons/Vuewm/wsrenam.*.bm
/usr/vue/icons/Vuewm/Color/wsrenam.*.pm
    These are IMAGE icons for a Button CONTROL in a secondary BOX
    (used for the Rename CONTROL).

/usr/vue/icons/Vuewm/xterm.*.bm
/usr/vue/icons/Vuewm/Color/xterm.*.pm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the term1 "Local Xterm" CONTROL).

/usr/vue/icons/Vuewm/xtermr.*.bm
/usr/vue/icons/Vuewm/Color/xtermr.*.pm
    These are IMAGE icons for a Button CONTROL in a primary or subpanel BOX
    (used for the term3 "Remote Xterm" CONTROL).


Button CONTROL Examples
________________________________

See also ANIMATION Examples.



________________________________

CLIENT CONTROL CONFIGURATION
________________________________

Use a Client CONTROL to embed an application in the FRONT PANEL
or a subpanel.


Client CONTROL Attributes
________________________________

CLIENT_NAME	< client name >
    Use this keyword to specify a CLIENT_NAME for a Client CONTROL.
    The CLIENT_NAME should match the first (res_name) string in the 
    WM_CLASS property on the application's window.
    This is normally set with the -name option in the f.exec command.
    Use the xprop(1) to examine the value of the WM_CLASS property.
    The default is the name of the Client CONTROL.

CLIENT_GEOMETRY	< width x height >
    Use this keyword to specify a CLIENT_GEOMETRY (width and height)
    for a Client CONTROL.
    If setting height of a Client CONTROL in a primary or secondary BOX,
    set LAYOUT_POLICY of BOX to as_needed.
    The default CLIENT_GEOMETRY is determined by standard
    CONTROL size of the BOX containing the Client CONTROL.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Client CONTROL.

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.exec <command>" to specify a PUSH_ACTION
    for a Client CONTROL (start or restart embedded application).

PUSH_RECALL	< true >
    Use "PUSH_RECALL true" if defining a PUSH_ACTION for a Client CONTROL.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for a Client CONTROL.
    The Client CONTROL must be in a primary BOX.

TYPE		< client >
    Use "TYPE client" to specify a Client CONTROL.


Client CONTROL Resources
________________________________

See also clientTimeoutInterval in Busy CONTROL Resources and
pushButtonClickTime in PANEL Resources.


Client CONTROL Examples
________________________________

To add datebook to the DateSubpanel:
    Add DatebookClient and DatebookLabel to DateSubpanel
    (see /usr/vue/config/panels/fp.date).
	BOX DateSubpanel
	{
	    TYPE     subpanel
	    TITLE    "Datebook"
	    CONTROL  DatebookClient
	    CONTROL  DatebookLabel
	}
    Define DatebookClient CONTROL.
	CONTROL DatebookClient
	{
	    TYPE             client
	    CLIENT_NAME      DatebookClient
	    CLIENT_GEOMETRY  181x190
	    PUSH_ACTION      f.exec
	# put next line at end of previous line
	"/usr/local/bin/X11/datebook -name DatebookClient"
	    PUSH_RECALL      true
	}
    Define DatebookLabel CONTROL
	CONTROL DatebookLabel
	{
	    TYPE             button
	    LABEL            "Datebook"
	}



________________________________

CLOCK CONTROL CONFIGURATION
________________________________

Use a Clock CONTROL to display current time with an analog clock.
No definition is required for a default Clock CONTROL.


Clock CONTROL Attributes
________________________________

CLIENT_NAME	< client name >
    Use this keyword to specify a CLIENT_NAME for a Clock CONTROL.
    The CLIENT_NAME should match the first (res_name) string in the 
    WM_CLASS property on the application's window.
    This is normally set with the -name option in the command line.
    This may be set directly in your PUSH_ACTION if you use f.exec,
    or in the action definition if you use f.action.
    Use the xprop(1) to examine the value of the WM_CLASS property.
    The default is the name of the Clock CONTROL.

DROP_ACTION	< action definition >
    Use "f.action <name>" to specify a DROP_ACTION for a Clock CONTROL.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Clock CONTROL.

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.action <name>" or "PUSH_ACTION f.exec <command>"
    to specify a PUSH_ACTION for a Clock CONTROL.

PUSH_RECALL	< true | false >
    To create a single instance of CLIENT_NAME for a Clock CONTROL,
    set this keyword to true.
    To create multiple instances of CLIENT_NAME for a Clock CONTROL,
    set this keyword to false.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for a Clock CONTROL.
    The Clock CONTROL must be in a primary BOX.

TITLE		< title >
    Use this keyword to specify the Vuewm title for the CLIENT_NAME window
    of a Clock CONTROL.
    The default is CLIENT_NAME.

TYPE		< clock >
    Use "TYPE clock" to specify a Clock CONTROL.


Clock CONTROL Resources
________________________________

Vuewm*<_clock_name_>.chime:		< true | false >
    Set this to true for beep on half hour, double beep on hour.
    The default is false.

Vuewm*<_clock_name_>.clockInterval:	< seconds >
    Use this resource to set the inteval between clock updates.
    The default is 60 (one minute).

For icon resources, see PANEL Resources.
See also pushButtonClickTime in PANEL Resources.


Clock CONTROL Icons
________________________________

/usr/vue/icons/Vuewm/clock.*.bm
/usr/vue/icons/Vuewm/Color/clock.*.pm
    These are the standard icons for a Clock CONTROL
    in a primary or subpanel BOX.


Clock CONTROL Examples
________________________________

To specify a digital Clock in the bottom row:
    Define Client CONTROL for xclock:
	CONTROL DigitalClockClient
	{
	    TYPE             client
	    CLIENT_NAME      DigitalClockClient
	    CLIENT_GEOMETRY  182
	    PUSH_ACTION      f.exec
	# put next line at end of previous line
	"/usr/bin/X11/xclock -digital -padding 0 -name DigitalClockClient"
	    PUSH_RECALL      true
	}
    Add DigitalClockClient to Bottom BOX.
	    CONTROL          DigitalClockClient

To define a square Clock:
    Define square Clock icon(s).
	Draw two one pixel shadow boxes (offset 1x1)
	with bottom shadow color and top shadow color.
	Fill outer area with transparent color.	
	If multicolor, fill Clock face with select color.
	If bitonal, fill Clock face with background color.
	Match offsets and other dimensions to standard Clock icons.
    Add multicolor Clock icon(s) to "$HOME/.vue/icons/Color".
    Add bitonal Clock icon(s) to "$HOME/.vue/icons".



________________________________

DATE CONTROL CONFIGURATION
________________________________

Use a Date CONTROL to display date information.
No definition is required for a default Date CONTROL.


Date CONTROL Attributes
________________________________

CLIENT_NAME	< client name >
    Use this keyword to specify a CLIENT_NAME for a Date CONTROL.
    The CLIENT_NAME should match the first (res_name) string in the 
    WM_CLASS property on the application's window.
    This is normally set with the -name option in the command line.
    This may be set directly in your PUSH_ACTION if you use f.exec,
    or in the action definition if you use f.action.
    Use the xprop(1) to examine the value of the WM_CLASS property.
    The default is the name of the Date CONTROL.

DROP_ACTION	< action definition >
    Use "f.action <name>" to specify a DROP_ACTION for a Date CONTROL.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Date CONTROL.

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.action <name>" or "PUSH_ACTION f.exec <command>"
    to specify a PUSH_ACTION for a Date CONTROL.

PUSH_RECALL	< true | false >
    To create a single instance of CLIENT_NAME for a Date CONTROL,
    set this keyword to true.
    To create multiple instances of CLIENT_NAME for a Date CONTROL,
    set this keyword to false.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for a Date CONTROL.
    The Date CONTROL must be in a primary BOX.

TITLE		< title >
    Use this keyword to specify the Vuewm title for the CLIENT_NAME window
    of a Date CONTROL.
    The default is CLIENT_NAME.

TYPE		< date >
    Use "TYPE date" to specify a Date CONTROL.


Date CONTROL Resources
________________________________

Vuewm*<_date_name_>.format:		< format >
    Use this keyword to specify the format of the Date CONTROL.
    See date(1) manpage for details.
    See /usr/vue/app-defaults/Vuewm for default value.

For font resources, see PANEL Resources.


Date CONTROL Examples
________________________________

See DatebookClient in Client CONTROL Examples and
DigitalClockClient in Clock CONTROL Examples.



________________________________

ICONBOX CONTROL CONFIGURATION
________________________________

Use an IconBox CONTROL to display the Vuewm icon box.
If an IconBox CONTROL is defined, Vuewm creates an icon box for window icons.


Iconbox CONTROL Attributes
________________________________

DROP_ACTION	< action definition >
    Use "f.action <name>" to specify a DROP_ACTION for an Iconbox CONTROL.

DROP_ANIMATION	< animation name >
    Use this keyword to specify a DROP_ANIMATION for an Iconbox CONTROL.
    The DROP_ANIMATION is displayed before the DROP_ACTION is invoked.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for an Iconbox CONTROL.

IMAGE		< icon name >
    Use this keyword to specify the IMAGE icon for an Iconbox CONTROL.

LABEL		< string >
    Use this keyword to specify a LABEL for an Iconbox CONTROL.
    If the CONTROL is in a primary or subpanel BOX,
    the LABEL is positioned below the IMAGE (if any).
    If the CONTROL is in a secondary BOX,
    the LABEL is positioned to the right of the IMAGE (if any).
    The default (used if LABEL is unspecified and IMAGE is unspecified
    or not found) is the name of the Iconbox CONTROL.

PUSH_ACTION	< none >
    The PUSH_ACTION of an Iconbox CONTROL is always set to
    "PUSH_ACTION f.normalize_and_raise -iconbox".

PUSH_ANIMATION	< animation name >
    Use this keyword to specify a PUSH_ANIMATION for an Iconbox CONTROL.
    The PUSH_ANIMATION is displayed before the PUSH_ACTION is invoked.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for an Iconbox CONTROL.
    The Iconbox CONTROL must be in a primary BOX.

TYPE		< iconbox >
    Use "TYPE iconbox" to specify an Iconbox CONTROL.


Iconbox CONTROL Resources
________________________________

Vuewm*<_control_name_>.height:		< height >
Vuewm*<_control_name_>.width:		< width >
    Use resources like these to set default sizes for Iconbox CONTROLS.
    If setting height of Iconbox CONTROL in a primary or secondary BOX,
    set LAYOUT_POLICY of BOX to as_needed.
    The default width of an Iconbox CONTROL in a primary or secondary BOX
    is half the standard CONTROL width of the BOX.

For font and icon resources, see PANEL Resources.
See also pushButtonClickTime in PANEL Resources.


Iconbox CONTROL Icons
________________________________

/usr/vue/icons/Vuewm/Color/iconbox.*.pm
/usr/vue/icons/Vuewm/iconbox.*.bm
    These are IMAGE icons for an Iconbox CONTROL in a secondary BOX
    (used for the standard Iconbox CONTROL).


Iconbox CONTROL Examples
________________________________

To access icon box from FRONT PANEL (and turn on icon box in Vuewm):
    Define Iconbox CONTROL.
	CONTROL Iconbox
	{
	    TYPE             iconbox
	    IMAGE            iconbox
	}
    Add Iconbox CONTROL to Bottom BOX.
	    CONTROL          Iconbox



________________________________

MAIL CONTROL CONFIGURATION 
________________________________

Use the Mail CONTROL to monitor incoming mail.

Based on access time, modification time, and size of the MONITOR_FILE,
the normal IMAGE indicates no new mail.
The ALTERNATE_IMAGE indicates new mail has arrived.


Mail CONTROL Attributes
________________________________

ALTERNATE_IMAGE	< icon name >
    Use this keyword to specify an ALTERNATE_IMAGE icon for a Mail CONTROL.

CLIENT_NAME	< client name >
    Use this keyword to specify a CLIENT_NAME for a Mail CONTROL.
    The CLIENT_NAME should match the first (res_name) string in the 
    WM_CLASS property on the application's window.
    This is normally set with the -name option in the command line.
    This may be set directly in your PUSH_ACTION if you use f.exec,
    or in the action definition if you use f.action.
    Use the xprop(1) to examine the value of the WM_CLASS property.
    The default is the name of the Mail CONTROL.

DROP_ACTION	< action definition >
    Use "f.action <name>" to specify a DROP_ACTION for a Mail CONTROL.

DROP_ANIMATION	< animation name >
    Use this keyword to specify a DROP_ANIMATION for a Mail CONTROL.
    The DROP_ANIMATION is displayed before the DROP_ACTION is invoked.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Mail CONTROL.

IMAGE		< icon name >
    Use this keyword to specify the IMAGE icon for a Mail CONTROL.
    The default is the name of the Mail CONTROL.

LABEL		< string >
    Use this keyword to specify a LABEL for a Mail CONTROL.
    If the CONTROL is in a primary or subpanel BOX,
    the LABEL is positioned below the IMAGE (if any).
    If the CONTROL is in a secondary BOX,
    the LABEL is positioned to the right of the IMAGE (if any).
    The default (used if LABEL is unspecified and IMAGE is unspecified
    or not found) is the name of the Mail CONTROL.

MONITOR_FILE	< mail file >
    Use this keyword to specify the MONITOR_FILE for a Mail CONTROL.
    If the MONITOR_FILE is non-empty and unread, the ALTERNATE_IMAGE
    is displayed, otherwise the normal IMAGE is displayed.
    The default is "/usr/mail/$LOGNAME".

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.action <name>" or "PUSH_ACTION f.exec <command>"
    to specify a PUSH_ACTION for a Mail CONTROL.
    If a PUSH_ACTION is defined, the Mail CONTROL reverts to
    the normal mail IMAGE when clicked.

PUSH_ANIMATION	< animation name >
    Use this keyword to specify a PUSH_ANIMATION for a Mail CONTROL.
    The PUSH_ANIMATION is displayed before the PUSH_ACTION is invoked.

PUSH_RECALL	< true | false >
    To create a single instance of CLIENT_NAME for a Mail CONTROL,
    set this keyword to true.
    To create multiple instances of CLIENT_NAME for a Mail CONTROL,
    set this keyword to false.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for a Mail CONTROL.
    The Mail CONTROL must be in a primary BOX.

TITLE		< title >
    Use this keyword to specify the Vuewm title for the CLIENT_NAME window
    of a Mail CONTROL.
    The default is CLIENT_NAME.

TYPE		< mail >
    Use "TYPE mail" to specify a Mail CONTROL.


Mail CONTROL Resources
________________________________

Vuewm*<_control_name_>.monitorTime:	< milliseconds >
    Use this resource to specify how often to monitor the mail file.
    The default is 30000 (30 seconds).

Vuewm*<_control_name_>.height:		< height >
Vuewm*<_control_name_>.width:		< width >
    Use resources like these to set default sizes for Mail CONTROLS.
    If setting height of Mail CONTROL in a primary or secondary BOX,
    set LAYOUT_POLICY of BOX to as_needed.
    The default width of a Mail CONTROL in a primary or secondary BOX
    is half the standard CONTROL width of the BOX.

For font and icon resources, see PANEL Resources.
See also pushButtonClickTime in PANEL Resources.


Mail CONTROL Icons
________________________________

/usr/vue/icons/Vuewm/Color/mail.*.pm
/usr/vue/icons/Vuewm/Color/mail02.*.pm
/usr/vue/icons/Vuewm/mail.*.bm
/usr/vue/icons/Vuewm/mail02.*.bm
    These are IMAGE and ALTERNATE_IMAGE icons for a Mail CONTROL
    in a primary or subpanel BOX (used for the standard Mail CONTROL).


Mail CONTROL Examples
________________________________

To turn off resynchronization in elm:
    Use "timeout = 0" in the elmrc file ($HOME/.elm/elmrc).
	Otherwise if elm is running when new mail arrives,
	the Mail CONTROL indicates new mail for a period of time,
	then reverts to the normal mail icon.
	This is because elm periodically resynchronizes (wakes up
	to read the mail file) unless "timeout" is turned off.

See also Monitor_File CONTROL Examples.



________________________________

MONITOR_FILE CONTROL CONFIGURATION
________________________________

Use the Monitor_File CONTROL to monitor a file.

The normal IMAGE indicates the MONITOR_FILE is empty or does not exist.
The ALTERNATE_IMAGE indicates the MONITOR_FILE is non-empty.


Monitor_File CONTROL Attributes
________________________________

ALTERNATE_IMAGE	< icon name >
    Use this keyword to specify an ALTERNATE_IMAGE icon
    for a Monitor_File CONTROL.

CLIENT_NAME	< client name >
    Use this keyword to specify a CLIENT_NAME for a Monitor_File CONTROL.
    The CLIENT_NAME should match the first (res_name) string in the 
    WM_CLASS property on the application's window.
    This is normally set with the -name option in the command line.
    This may be set directly in your PUSH_ACTION if you use f.exec,
    or in the action definition if you use f.action.
    Use the xprop(1) to examine the value of the WM_CLASS property.
    The default is the name of the Monitor_File CONTROL.

DROP_ACTION	< action definition >
    Use "f.action <name>" to specify a DROP_ACTION for a Monitor_File CONTROL.

DROP_ANIMATION	< animation name >
    Use this keyword to specify a DROP_ANIMATION for a Monitor_File CONTROL.
    The DROP_ANIMATION is displayed before the DROP_ACTION is invoked.

HELP_STRING	< string >
HELP_TOPIC	< topic name >
    Use these keywords to specify a HELP_STRING or HELP_TOPIC
    for a Monitor_File CONTROL.

IMAGE		< icon name >
    Use this keyword to specify the IMAGE icon for a Monitor_File CONTROL.
    The default is the name of the Monitor_File CONTROL.

LABEL		< string >
    Use this keyword to specify a LABEL for a Monitor_File CONTROL.
    If the CONTROL is in a primary or subpanel BOX,
    the LABEL is positioned below the IMAGE (if any).
    If the CONTROL is in a secondary BOX,
    the LABEL is positioned to the right of the IMAGE (if any).
    The default (used if LABEL is unspecified and IMAGE is unspecified
    or not found) is the name of the Monitor_File CONTROL.

MONITOR_FILE	< monitor file >
    Use this keyword to specify the MONITOR_FILE for a Monitor_File CONTROL.
    This keyword must be specified for a Monitor_File CONTROL (no default).

PUSH_ACTION	< action definition >
    Use "PUSH_ACTION f.action <name>" or "PUSH_ACTION f.exec <command>"
    to specify a PUSH_ACTION for a Monitor_File CONTROL.

PUSH_ANIMATION	< animation name >
    Use this keyword to specify a PUSH_ANIMATION for a Monitor_File CONTROL.
    The PUSH_ANIMATION is displayed before the PUSH_ACTION is invoked.

PUSH_RECALL	< true | false >
    To create a single instance of CLIENT_NAME for a Monitor_File CONTROL,
    set this keyword to true.
    To create multiple instances of CLIENT_NAME for a Monitor_File CONTROL,
    set this keyword to false.

SUBPANEL	< subpanel name >
    Use this keyword to specify a SUBPANEL for a Monitor_File CONTROL.
    The Monitor_File CONTROL must be in a primary BOX.

TITLE		< title >
    Use this keyword to specify the Vuewm title for the CLIENT_NAME window
    of a Monitor_File CONTROL.
    The default is CLIENT_NAME.

TYPE		< monitor_file >
    Use "TYPE monitor_file" to specify a Monitor_File CONTROL.


Monitor_File CONTROL Resources
________________________________

Vuewm*<_control_name_>.monitorTime:	< milliseconds >
    Use this resource to specify how often to monitor the file.
    The default is 30000 (30 seconds).

Vuewm*<_control_name_>.height:		< height >
Vuewm*<_control_name_>.width:		< width >
    Use resources like these to set default sizes for Monitor_File CONTROLS.
    If setting height of Monitor_File CONTROL in a primary or secondary BOX,
    set LAYOUT_POLICY of BOX to as_needed.
    The default width of a Monitor_File CONTROL in a primary or secondary BOX
    is half the standard CONTROL width of the BOX.

For font and icon resources, see PANEL Resources.
See also pushButtonClickTime in PANEL Resources.


Monitor_File CONTROL Icons
________________________________

/usr/vue/icons/Vuewm/Color/trash.*.pm
/usr/vue/icons/Vuewm/Color/trashfl.*.pm
/usr/vue/icons/Vuewm/trash.*.bm
/usr/vue/icons/Vuewm/trashfl.*.bm
    These are IMAGE and ALTERNATE_IMAGE icons for a Monitor_File CONTROL
    in a primary or subpanel BOX (used for the standard Trash CONTROL).


Monitor_File CONTROL Examples
________________________________

For a Mail CONTROL with Monitor_File behavior
(always shows new mail if mail file is non-empty):
    Define MailMonitor CONTROL (must specify MONITOR_FILE):
	CONTROL MailMonitor
	{
	    TYPE             monitor_file
	    SUBPANEL         MailSubpanel
	    IMAGE            mail
	    TITLE            "Mail"
	    ALTERNATE_IMAGE  mail02
	    PUSH_ACTION      f.action MAILER
	    DROP_ACTION      f.action MAIL_A_FILE
	    PUSH_RECALL      true
	    CLIENT_NAME      Mail
	    MONITOR_FILE     /usr/mail/$LOGNAME
	}
    Replace Mail CONTROL with MailMonitor Control in Bottom BOX.



________________________________

ANIMATION CONFIGURATION
________________________________

Use an ANIMATION for a DROP_ANIMATION or a PUSH_ANIMATION of a CONTROL.

To minimize flashing, the background of ANIMATION icons
is set to background instead of transparent.


ANIMATION Attributes
________________________________

< image >	< milliseconds >
    Use <image> to specify an icon name in an ANIMATIION sequence.
    Use <milliseconds> to specify how long to show the image (optional).
    The default time is the previous time (or 200 milliseconds if none).


ANIMATION Resources
________________________________

For icon resources, see PANEL Resources.


ANIMATION Icons
________________________________

/usr/vue/icons/Vuewm/Color/ljet0*.*.pm
/usr/vue/icons/Vuewm/Color/ljet1*.*.pm
/usr/vue/icons/Vuewm/ljet0*.*.bm
/usr/vue/icons/Vuewm/ljet1*.*.bm
    These are ANIMATION icons for a primary or subpanel BOX
    (used for the PrinterDrop DROP_ANIMATION of the Printer CONTROL).

/usr/vue/icons/Vuewm/Color/trash0*.*.pm
/usr/vue/icons/Vuewm/trash0*.*.bm
    These are ANIMATION icons for a primary or subpanel BOX
    (used for the TrashDrop DROP_ANIMATION of the Printer CONTROL).


ANIMATION Examples
________________________________

To set TrashDrop as the PUSH_ANIMATION of the Trash CONTROL:
    Set PUSH_ANIMATION of Trash CONTROL.
	    PUSH_ANIMATION   TrashDrop



________________________________

ARROW CONFIGURATION
________________________________

ARROWs are used to post and unpost subpanels.
ARROWs are allocated automatically.


ARROW Icons
________________________________

/usr/vue/icons/Vuewm/Color/down.*.pm
/usr/vue/icons/Vuewm/down.*.bm
    These are the standard icons for an ARROW in a subpanel BOX.

/usr/vue/icons/Vuewm/Color/up.*.pm
/usr/vue/icons/Vuewm/up.*.bm
    These are the standard icons for an ARROW in a primary BOX.


ARROW Resources
________________________________

For icon resources, see PANEL Resources.



________________________________

VUE 2.0 to 3.0 PORTING NOTES
________________________________

Use vuefp2to3 to convert VUE 2.0 FRONT PANEL files to VUE 3.0 format.
See vuefp2to3(1X) manpage for details.


Conversion Hints
________________________________

Evaluate your porting needs:
    Your converted vuewmrc file will not have the VUE 3.0 
    subpanels. If you desire subpanels (or other new features), 
    then you are going to need to edit your vuewmrc file.
    You can either start with the 3.0 sys.vuewmrc file and 
    add in your customizations from your converted file, or 
    start with your converted file and add in features from 
    the 3.0 sys.vuewmrc.

Check name and type of Mail CONTROL:
    For correct behavior, Mail CONTROLs in the FRONT PANEL
    must be of type "mail," not "monitor_file."
    The FRONT PANEL converter may insert the wrong CONTROL TYPE
    when converting a custom VUE 2.0 FRONT PANEL if the 
    name of the CONTROL is not "Mail."


Obsolete FRONT PANEL Resources
________________________________

borderWidth
    This resource is not configurable in VUE 3.0.

controlSpacing
    This resource is not configurable in VUE 3.0.

geometry
    This resource is not directly configurable in VUE 3.0.
    Vuewm now preserves FRONT PANEL (and subpanel) geometry
    when restarting, and when saving and restoring sessions.
    To force default FRONT PANEL position, set useDefaultGeometry to true.

rowSpacing
    This resource is not configurable in VUE 3.0.

useBlinkingIndicator
    This resource is not configurable in VUE 3.0.
    For blinking resources see Busy CONTROL Resources.


Obsolete ROW (BOX) Resources
________________________________

colorSetId (int)
    This resource is not configurable in VUE 3.0.
    Use COLOR_SET in BOX definition.

rowBackgroundPixmap (String)
    This resource is not configurable in VUE 3.0.
    Use BACKGROUND_TILE in BOX definition.


Obsolete SWITCH Resources
________________________________

numberOfSwitchRows
    This resource is not configurable in VUE 3.0.
    Use NUMBER_OF_ROWS in SWITCH definition.

wsButtonSpacing
    This resource is not configurable in VUE 3.0.

wsButtonShadowThickness
    This resource is not configurable in VUE 3.0.

wsButtonBorder
    This resource is not configurable in VUE 3.0.


Obsolete Date CONTROL Resources
________________________________

fontList
fontList1
fontList2
fontList3
fontList4
fontList5
    These resources are not configurable in VUE 3.0.
    For font resources see PANEL Resources.
Newsgroups: comp.sys.hp