# WorkShop Visual Configuration

WorkShop Visual provides a number of features which allow you to configure the tool.

Configuring the Widget Palette

The Widget Palette contains a set of icons which represent the objects which can be added to your design. Each icon can be a full XPM Color icon, or a monochrome bitmap. WorkShop Visual searches the application resources to determine the icon to use for each widget represented on the Palette, or uses a built-in icon if no resource can be found. The WorkShop Visual resource file (normally ${VISUROOT}/lib/locale/$LANG/app-defaults/visu) has a full list of icon files for the OSF/Motif widget set. For example, the resource for the Arrow Button is:

        visu.arrowButtonPixmap: arrow.xpm

WorkShop Visual uses the same search path as XmGetPixmap(3X) to find the icon file. This open definition of icons allows you to override the default pixmaps and provide your own local images, by replacing the name of the icon file, by putting an icon of the right name in, say, ${HOME}/bitmaps/visu, in order to circumvent the search algorithm, or by providing an explicit path for your image:

        visu.arrowButtonPixmap:

        /my/path/to/my/images/my_arrow.xpm

You can also specify that some objects are not to appear in the Palette through the WorkShop Visual stopList resource. Any widgets listed for the resource will not appear in the Palette. For example, if you do not want Arrow Buttons and Paned Windows in your Palette, set the following resource:

        visu.stopList: XmPanedWindow, XmArrowButton

The Palette menu provides an option to allow you to separate the Palette from the WorkShop Visual main display. You can specify this as the default behavior as follows:

        visu*.pm_separate.set: true

Configuring the Toolbar

Buttons in the Toolbar have an exact correspondence with buttons in the main menus, and with the only exception of the generate buttons, behave in identical fashion. Buttons in the toolbar have the same widget names as menu equivalents. By default, they are configured to share the same label. For example, the resource file contains:

        visu*gm_c.labelString: C...

You can change the toolbar label for this item by specifying as follows:

        visu*toolbar.gm_c.labelString: My Generate C Label...

You can also provide your own icons in exactly the same way as configuring the Palette:

        visu*toolbar.gm_c.toolbarPixmap: my_pixmap_file.xpm

To configure menu items into the toolbar, there is the toolbarDescription resource. This is simply a comma separated list of main menu button names. The reserved word "separator" can be inserted in order to add extra space between toolbar items. For example:

        visu.toolbarDescription:

        separator,em_cut,em_copy,em_paste,separator,wm_prim,wm_layout,separator

This specification would give you a toolbar with cut, copy, paste, core resources, and layout editor buttons.

See also:

- Widget Palette
- Palette Menu
- About WorkShop Visual