Enables users to customize X applications.
custom [ -h | -e Browser | [ -s ResourceFile ] [ Application ] ]
The custom command starts the customizing tool, which is used to customize various aspects of applications.
The customizing tool can change the look of an application. It provides a user-friendly way to add resource values to your .Xdefaults file. Resources are customizable items such as colors, fonts, and other attributes that allow you to customize resources of a client application. Each application has its own set of unique resources, which are listed in an app-custom file. The customizing tool describes the resources available for modification for an application and the possible resource values you can select.
|-h||Provides command line help.|
|-e Browser||Calls one of the standalone browsers. Valid values for Browser are color, font, cursor, and picture.|
|-s ResourceFile||Specifies the resource file from which to load and save resource settings. If the -s flag is not specified, the default is to load the values from the resource database stored in the RESOURCE_MANAGER property on the X server. If this database does not exist, then $HOME/.Xdefaults is loaded.|
Most standard X Toolkit command-line options are understood by the custom command. See the following table that lists the standard command-line options:
|-bg||*background||Next argument||Background color|
|-background||*background||Next argument||Background color|
|-bd (1)||*borderColor||Next argument||Border color|
|-bordercolor (1)||*borderColor||Next argument||Color of border|
|-bw||.borderWidth||Next argument||Width of border in pixels|
|-borderWidth||.borderWidth||Next argument||Width of border in pixels|
|-display||.display||Next argument||Server to use|
|-fn (2)||*font||Next argument||Font name|
|-font (2)||*font||Next argument||Font name|
|-fg||*foreground||Next argument||Foreground color|
|-foreground||*foreground||Next argument||Foreground color|
|-geometry||.geometry||Next argument||Size and position|
|-iconic||.iconic||On||Start as an icon|
|-name||.name||Next argument||Name of application|
|+rv||*reverseVideo||Off||No Reverse video|
|-selection- Timeout||.selection- Timeout||Next argument||Selection timeout|
|-synchronous||*synchronous||On||Synchronous debug mode|
|+synchronous||*synchronous||Off||Synchronous debug mode|
|-title||.title||Next argument||Title of application|
|-xrm||value of argument||Next argument||Depends on argument|
1 These options often have no visible effect on AIXwindows applications if the AIXwindows Window Manager (mwm) is running.
2 Motif applications do not generally respond to these options.
Note: Resources beginning with an* (asterisk) set the resource of every widget in the application to the same value. Resources that begin with a . (period) set the resources of only the application's top-level Shell widget.
|Application||Specifies the name or class of the application to customize.|
custom -s /usr/lib/X11/app-defaults/XCalc xcalc
The customizing tool has the following application resources:
|listOfApps||This resource is used to display the application names on the starting dialog. The application name and corresponding app-custom file must be listed in pairs with the following syntax:|
|colorEditor*rgbtxtPath||This resource specifies the full path name of the rgb.txt file that the X server uses to define named colors. The default value is /usr/lib/X11/rgb.txt, which is correct for an X server running on a display that is directly attached to your system unless you are using an Xstation with AIX Xstation Manager/6000 Version 1.3, then you need to set the value of this resource to /usr/lpp/x_st_mgr/bin/rgb.txt.|
|windowSearchDepth||The customizing tool must determine the top-level shell window of the application. It starts with the root window and conducts a recursive search to a depth of three windows by default. This default can be changed using the windowSearchDepth resource.|
|timeout||The Instant Changes button is grayed out until communication with the application is established. The amount of time to wait for the application to contact the customizing tool is controlled by the Custom*timeout resource.|
|resourceFile||The resource file is where your resource changes are saved. The default is $HOME/.Xdefaults. The -s flag allows the user to override this value.|
|appCustomPath|| This resource specifies where the customizing tool is to look
for the app-custom file. The appCustomPath string consists
of a series of possible file names separated by colons. Within each name,
the following values can be substituted:
|topEditHighlight, bottomEditHighlight, foregroundEditHighlight, backgroundEditHighlight|
|The Browser button is highlighted when a browser is called and unhighlighted when a browser is canceled. These resources set the highlight color for the top shadow, bottom shadow, foreground, and background of the Browser button.|
|pictureEditor*editor|| You can edit the bitmap or pixmap by pressing the Edit Picture
button on the Pictures browser
window. The editor is a separate application that exists on your system.
It is called on your behalf. The Custom*pictureEditor*editor
resource determines which editor commands to choose from. This resource
accepts a list of commands separated by \n's (backslash 'n's). The first
command that identifies an existing program that the user has permission
to execute is used. The file name in the Chosen Picture text field is
passed as a parameter to the editor when it is invoked. The default
setting for this resource is:
Note: The default editor, /usr/dt/bin/dticon only exists if the Common Desktop Environment (CDE) is installed. It edits both bitmaps (monochrome images) and pixmaps (color images). The dticon command accepts bitmaps stored in either the X Pixmap Version 2 Enhanced (XPM2) format which was used by the X Desktop (xdt) application shipped in AIXwindows Version 1.2.5, or X Pixmap Version 3 (XPM3) - a new XPG3 compliant format used by CDE. However, it requires pixmap images be stored in the XPM3 format. CDE has documented tools that can convert pixmaps from the XPM2 to the XPM3 format.
The /usr/bin/X11/bitmap command is an unsupported sample program that accepts bitmaps in either the XPM2 or XPM3 formats. It does not support pixmap editing. Be sure that the Bitmap app-defaults file has been installed in the /usr/lib/X11/app-defaults directory before invoking the bitmap command. If not, issue the following command in the /usr/lpp/X11/Xamples/programs/bitmap directory:
custom (Custom) startupDialog_popup (XmDialogShell) startupDialog (XmSelectionBox) helpDialog_popup (XmDialogShell) helpDialog (XmForm) saveDialog_popup (XmDialogShell) saveDialog (XmSelectionBox) colorEditor_popup (XmDialogShell) colorEditor (XibmColorEditor) fontEditor_popup (XmDialogShell) fontEditor (XibmFontEditor) pictureEditor_popup (XmDialogShell) pictureEditor (XibmPictureEditor) cursorEditor_popup (XmDialogShell) cursorEditor (XibmCursorEditor) selectmanyEditor_popup (XmDialogShell) selectmanyEditor (XibmSelectManyEditor) filenameEditor_popup (XmDialogShell) filenameEditor (XmFileSelectionBox) mainWindow (XmMainWindow) menubar (XmRowColumn) form (XmForm) appClassLabel (XmLabel) appClass (XmLabel) groupMenuLabel (XmLabel) groupMenu (XmRowColumn) scrolledGroup (XmScrolledWindow) scrolledGroupForm (XmForm) (XmLabelGadget) TypeField (XmTextField) TypeButton (XmPushButton)
This command returns the following exit values:
|0||Indicates successful completion.|
|>0||Indicates an error occurred.|
|/usr/bin/X11||Is the path from which you run the custom command once the custom package is installed.|
|/usr/lib/X11/app-custom||Contains information about resources for individual applications.|
|/usr/lib/X11/locale/app-custom||Contains information about resources for individual applications that is translated for specific locales.|
|/usr/lib/X11/app-defaults/Custom||Contains default settings for the Customizing Tool.|
|/usr/lib/X11/locale/app-defaults/Custom||Contains default settings for the Customizing Tool in locales that require special settings.|
How to Start the Customizing Tool in AIX Version 4.3 AIXwindows Programming Guide.