Specifications

Athena Widget Set libXaw 1.0.7
2.5.1. Cursor Conversion
The value for the cursorName resource is specified in the resource database as a string, and is of
the following forms:
•Astandard X cursor name from <X11/cursorfont.h >.The names in cursorfont.h each
describe a specific cursor.The resource names for these cursors are exactly likethe names
in this file except the XC_ is not used. The cursor definition XC_gumby has a resource
name of gumby.
•Glyphs, as in FONT font-name glyph-index[[font-name ] glyph-index].The first font and
glyph specify the cursor source pixmap. The second font and glyph specify the cursor
mask pixmap. The mask font defaults to the source font, and the mask glyph indexdefaults
to the source glyph index.
•Arelative orabsolute file name. If a relative orabsolute file name is specified, that file is
used to create the source pixmap. Then the string "Mask" is appended to locate the cursor
mask pixmap. If the "Mask" file does not exist, the suffix "msk" is tried. If "msk" fails, no
cursor mask will be used. If the filename does not start with ’/’ or ’./’ the the bitmap file
path is used (see section 2.4.3).
2.5.2. Pixel Conversion
The string-to-pixel converter takes anyname that is acceptable to XParseColor (see Xlib — C
Language X Interface). In addition this routine understands the special toolkit symbols ‘XtDe-
faultForeground’ and ‘XtDefaultBackground’, described in XToolkit Intrinsics — C Language
Interface.Inshort the acceptable pixel names are:
•Any color name for the rgb.txt file (typically in the directory /usr/lib/X11 on POSIX sys-
tems).
•Anumeric specification of the form #<red><green><blue> where these numeric values are
hexadecimal digits (both upper and lower case).
•The special strings ‘XtDefaultForeground’ and ‘XtDefaultBackground’
2.5.3. Bitmap Conversion
The string-to-bitmap converter attempts to locate a file containing bitmap data whose name is
specified by the input string. If the file name is relative (i.e. does not begin with / or ./), the direc-
tories to be searched are specified in the bitmapFilePath resource--class BitmapFilePath.This
resource specifies a colon (:) separated list of directories that will be searched for the named bit-
map or cursor glyph (see section 2.4.1). The bitmapFilePath resource is global to the applica-
tion, and may not be specified differently for each widget that wishes to convert a cursor to bit-
map. In addition to the directories specified in the bitmapFilePath resource a default directory is
searched. When using POSIX the default directory is /usr/include/X11/bitmaps.
2.6. Realizing aWidget
The XtRealizeWidget function performs twotasks:
•Calculates the geometry constraints of all managed descendants of this widget. The actual
calculation is put offuntil realize time for performance reasons.
•Creates an X windowfor the widget and, if it is a composite widget, realizes each of its
managed children.
void XtRealizeWidget(w)
Widget w;
w Specifies the widget.
Forfurther information about this function, see the XToolkit Intrinsics — C Language Interface.
9