home *** CD-ROM | disk | FTP | other *** search
- Path: sparky!uunet!noc.near.net!hri.com!spool.mu.edu!uwm.edu!zaphod.mps.ohio-state.edu!saimiri.primate.wisc.edu!sdd.hp.com!hp-cv!hp-pcd!hpcvusn!hpcvusc!dana
- From: dana@hpcvusc (Dana Laursen )
- Newsgroups: comp.sys.hp
- Subject: Vue 3.0 Front Panel
- Summary: front panel configuration notes
- Message-ID: <1992Nov10.184704.26914@hpcvusn.cv.hp.com>
- Date: 10 Nov 92 18:47:04 GMT
- Sender: nobody@hpcvusn.cv.hp.com (Nobody - UID must be 99999)
- Organization: Hewlett-Packard Company, Corvallis, Oregon USA
- Lines: 1687
- Nntp-Posting-Host: hpcvusc.cv.hp.com
- 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.
-