User's Guide - Appendix D. User Interface Configuration

## Appendix D. User Interface Configuration

Data Explorer provides its own set of resources for customizing the user interface in addition to the standard X-window and Motif resources. These resources (see table) can be specified in the `.Xdefaults` resource file, and a majority can be invoked as command line switches or options. For example:

    DX*noImagePrinting: true
    DX*restrictionLevel: maximum

are valid resource-file entries. The corresponding command line format is:

    dx -image -noImagePrinting -restrictionLevel maximum

The command line switch for a Boolean resource (e.g., `-noImagePrinting`) toggles the default value.

Table 7. Resource Configuration Table

Resource Name | Command Line Option (if available) | Type | Default
--- | --- | --- | ---
DX*autoLayoutGroupSpacing | -autoLayoutGroupSpacing | int | 30
DX*autoLayoutHeight | -autoLayoutHeight | int | 90
DX*autoLayoutNodeSpacing | -autoLayoutNodeSpacing | int | 15
DX*errorEnabled | N/A | Boolean | true
DX*errorOpensMessage | N/A | Boolean | true
DX*fontList | N/A | String | *helvetica*bold-r*14*75-75*=bold, *helvetica*medium-r*14*75-75*=normal, *helvetica*medium-o*14*75-75*=oblique
DX*infoEnabled | N/A | Boolean | true
DX*infoOpensMessage | N/A | Boolean | true
DX*limitImageOptions | -limitImageOptions | Boolean | false
DX*metric | -metric | Boolean | false
DX*noConfirmedQuit | -noConfirmedQuit | Boolean | false
DX*noCMapOpenMap | -noCMapOpenMap | Boolean | false
DX*noCMapSaveMap | -noCMapSaveMap | Boolean | false
DX*noCMapSetNameOption | -noCMapSetNameOption | Boolean | false
DX*noDXHelp | -noDXHelp | Boolean | false
DX*noEditorAccess | -noEditorAccess | Boolean | false
DX*noEditorOnError | -noEditorOnError | Boolean | false
DX*noImageLoad | -noImageLoad | Boolean | false
DX*noImageMenus | -noImageMenus | Boolean | false
DX*noImagePrinting | -noImagePrinting | Boolean | false
DX*noImageRWNetFile | -noImageRWNetFile | Boolean | false
DX*noImageSaving | -noImageSaving | Boolean | false
DX*noInteractorAttribute | -noInteractorAttribute | Boolean | false
DX*noInteractorEdits | -noInteractorEdits | Boolean | false
DX*noInteractorMovement | -noInteractorMovement | Boolean | false
DX*noMessageInfoOption | -noMessageInfoOption | Boolean | false
DX*noMessageWarningOption | -noMessageWarningOption | Boolean | false
DX*noOpenAllPanels | -noOpenAllPanels | Boolean | false
DX*noPGroupAssignment | -noPGroupAssignment | Boolean | false
DX*noPanelAccess | -noPanelAccess | Boolean | false
DX*noPanelEdit | -noPanelEdit | Boolean | false
DX*noPanelRWConfig | -noPanelRWConfig | Boolean | false
DX*noScriptCommand |
    -noScriptCommand
| Boolean | false
DX*printImageCommand | N/A | String | "lpr"
DX*printImageFormat | N/A | String | "PSCOLOR"
DX*printImagePageSize | N/A | String | NULL
DX*printImageResolution | N/A | int | 0
DX*printImageSize | N/A | String | NULL
DX*restrictionLevel | -restrictionlevel | String | NULL
DX*saveImageFormat | N/A | String | "PSCOLOR"
DX*saveImagePageSize | N/A | String | NULL
DX*saveImageResolution | N/A | int | 0
DX*saveImageSize | N/A | String | NULL
DX*vpeCanvas.lineThickness | N/A | int | 1
DX*warningEnabled | N/A | Boolean | true
DX*warningOpensMessage | N/A | Boolean | true

    DX*errorEnabled
| Specifies the default value of the `Error Messages` toggle button in the Message window's `Option` menu.
    DX*errorOpensMessage
| Specifies whether or not the Message window pops up when an error message is printed in the Message window.
    DX*infoEnabled
| Specifies the default value of the `Information Messages` toggle button in the Message window's `Option` menu.
    DX*infoOpensMessage
| Specifies whether or not the Message window pops up when an informational message is printed in the Message window.
    DX*limitImageOptions
| Removes the `Image Depth`, `Throttle`, `Change Image Name...`, and `Panel Access...` menu commands from the Image window's `Options` menu.
    DX*metric
| Specifies that Data Explorer use the metric system (centimeters) when set to "true". The default is the English system (inches). The `Print Image` and `Save Image` dialog boxes option menus are affected accordingly.
    DX*noConfirmedQuit
| Turns off the "Are you sure you want to quit Data Explorer?" message.
    DX*noCMapOpenMap
| Removes the `Open...` menu command from the Colormap Editor's `File` menu.
    DX*noCMapSaveMap
| Removes the `Save As...` menu command from the Colormap Editor's `File` menu.
    DX*noCMapSetNameOption
| Removes the `Set Colormap Name...` menu command from the Colormap Editor's `Options` menu.
    DX*noDXHelp
| Removes the `On Context`, `On Manual` and `On Help` menu commands from the Help menu of both the Control Panel and the Image window.
    DX*noEditorAccess
| Removes (1) the `Delete`, `Show Selected Interactor`, `Add Selected Interactor`, `Show Selected Tool`, and `Comment...` menu commands from the Control Panel's `Edit` menu; (2) the `Open Visual Program Editor` menu commands from the Image window's `Windows` menu.
`DX*noEditorOnError` | Turns off default behavior of popping up the VPE when an error occurs. Instead, a question dialog box is popped up, with the name of the visual program, which lets the user choose whether or not to open the VPE on the .net file.
`DX*noImageLoad` | Removes the `Load Macro...` and `Load Module Definition(s)...` menu commands from the Image window's `File` menu.
    DX*noImageMenus
| Removes the bar from all Image and Display windows.
    DX*noImagePrinting
| Removes the `Print Image...` menu command from the Image window's `File` menu.
    DX*noImageRWNetFile
| Removes the `Open`, `Save`, and `Save As...` menu commands from the Image window's `File` menu.
    DX*noImageSaving
| Removes the `Save Image...` menu command from the Image window's `File` menu.
    DX*noInteractorAttribute
| Removes the `Set Attributes...` menu command from the Control Panel's `Edit` menu.
    DX*noInteractorEdits
| Removes the `Set Style`, `Set Layout`, `Set Dimensionality`, and `Set Interactor Label...` menu commands from the Control Panel's `Edit` menu.
    DX*noInteractorMovement
| Restricts the ability to move interactor instances within a Control Panel.
    DX*noMessageInfoOption
| Removes the `Information Messages` toggle button from the Message window's `Options` menu.
    DX*noMessageWarningOption
| Removes the `Warning Messages` toggle button from the Message window's `Options` menu.
    DX*noOpenAllPanels
| Removes the `Open All Panels...` menu command from the `Panels` menu of the Control Panel and the `Windows` menu of the Image window.
    DX*noPGroupAssignment
| Removes the `Execution Group Assignment...` menu command from the Image window's `Connection` menu.
    DX*noPanelAccess
| Removes (1) the Control Panel's `Panels` menu and all its menu commands; (2) the `Open All Control Panels` and `Open Control Panel by Name` menu commands from the Image window's `Windows` menu.
    DX*noPanelEdit
| Removes the Control Panel's `Edit` menu and all its menu commands. This is equivalent to the following options:
    noInteractorEdits
    noInteractorAttribute
    noEditorAccess
    noInteractorMovement
By restricting the ability to highlight interactors with a mouse click, this option in effect also disables interactor movement.
    DX*noRWConfig
| Removes the `Open...` and `Save As...` menu commands from the `File` menu.
    DX*noScriptCommand
| Removes the `Execute Script Command...` menu command from the Message window's `Options` menu.
    DX*printImageCommand
| Specifies the default print image command to be used use in the `Print Image` dialog box available from the Image window.
    DX*printImageFormat
| Specifies the default file format to be used in the `Print Image` dialog box available in the Image window. The following values are recognized:
| PSCOLOR | Color PostScript
| PSGREY | Gray level PostScript
| EPSCOLOR | Encapsulated Color PostScript
| EPSGREY | Encapsulated Gray level PostScript
    DX*printImagePageSize
| Specifies the default page size that PostScript images should be centered on when printing images from the `Print Image` dialog box available from the Image window. Units are those indicated by the metric option.
    DX*printImageResolution
| Specifies the default resolution that PostScript images should be printed with when printing images from the `Print Image` dialog box available from the Image window. Resolution is in dots per inch unless the `DX*metric` resource is set, in which case dots per centimeter is used. This resource is overridden by the `printImageSize` resource. If this is set to zero (the default), then the `Print Image...` dialog box chooses the resolution.
    DX*printImageSize
| Specifies the default size of PostScript images printed from the `Print Image` dialog box available from the Image window. If specified this option overrides the `printImageResolution` option. The value is a string in the same format as that accepted by the dialog box (for example, "8", "8x", "x10", "8x10"). Units are those indicated by the metric option. The default value is determined by `printImageResolution` option.
    DX*restrictionLevel
| Combines options to make it easier to build applications on top of Data Explorer. The string value must be one of the following:
| minimum | Combines the restrictions implied by the following options:
    noEditorAccess
    noInteractorEdits
    noInteractorMovement
    limitImageOptions
    noScriptCommand
    noCMapSetNameOption
| intermediate | Combines the restrictions implied by `minimum` restriction level plus the following options:

    noImageRWNetFile
    noOpenAllPanels
    noImageLoad
    noPanelEdit
    noPanelOptions
    noPGroupAssignment
| maximum | Combines the restrictions implied by the `intermediate` restriction level plus the following options:
    noPanelRWConfig
    noImageSaving
    noPanelAccess
    noCMapOpenMap
    noCMapSaveMap
    DX*saveImageFormat
| Specifies the default file format to be used in the `Print Image` dialog box available in the Image window. The following values are recognized:
| PSCOLOR | Color PostScript
| PSGREY | Gray level PostScript
| EPSCOLOR | Encapsulated Color PostScript
| EPSGREY | Encapsulated Gray level PostScript
| RGB | "rgb" format
| R+G+B | "r+g+b" format
| TIFF | TIFF format
    DX*saveImagePageSize
| Specifies the default page size that PostScript images should be centered on when saving images from the `Save Image` dialog box available from the Image window. Units are those indicated by the metric option.
    DX*saveImageResolution
| Specifies the default resolution that PostScript images should be saved with when saving images from the `Save Image` dialog box available from the Image window. Resolution is in dots per inch unless the `DX*metric` resource is set, in which case dots per centimeter is used. This resource is overridden by the `saveImageSize` resource. If this is set to zero (the default), then the `Save Image` dialog box chooses the resolution, which may be specified inside the visual program.
    DX*saveImageSize
| Specifies the default size of PostScript images saved from the `Print Image` dialog box available from the Image window. If specified this option overrides the `saveImageResolution` option. The value is a string in the same format as that accepted by the dialog box (for example, "8", "8x", "x10", "8x10"). Units are those indicated by the metric option. The default value is determined by `saveImageResolution` option.
    DX*vpeCanvas.lineThickness
| Specifies the thickness of the lines that connect module outputs to module inputs in the VPE.
    DX*warningEnabled
| Specifies the default value of the `Warning Messages` toggle button in the Message window's `Option` menu.
    DX*warningOpensMessage
| Specifies whether or not the Message window pops up when a warning message is printed in the Message window.

[ OpenDX Home at IBM | OpenDX.org ]