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.
|Provides command line help.
|Calls one of the standalone browsers. Valid values for Browser are color, font, cursor, and picture.
|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:
|Color of border
|Width of border in pixels
|Width of border in pixels
|Server to use
|Size and position
|Start as an icon
|Name of application
|No Reverse video
|Synchronous debug mode
|Synchronous debug mode
|Title of application
|value of 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.
|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:
|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:
|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.
|The customizing tool must determine the top-level shell window of the application. It starts
|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.
|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.
|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:
$HOME/%L/%T/%N:\ $HOME/%T/%N:\ /usr/lib/X11/%L/%T/%N:\ /usr/lib/X11/%T/%N
|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.
|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:
Custom*pictureEditor*editor: /usr/dt/bin/dticon -f \n /usr/lib/X11/bitmap
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:
xmkmf; make install
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
|Indicates successful completion.
|Indicates an error occurred.
|Is the path from which you run the custom command once the custom package is installed.
|Contains information about resources for individual applications.
|Contains information about resources for individual applications that is translated for specific locales.
|Contains default settings for the Customizing Tool.
|Contains default settings for the Customizing Tool in locales that require special settings.
How to Start the Customizing Tool in AIX 5L Version 5.1 AIXwindows Programming Guide.