|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtRegisterColor(3) | FreeBSD Library Functions Manual | XmtRegisterColor(3) |
NAME
XmtRegisterColor(), XmtVaRegisterColors(), XmtRegisterColors(), XmtRegisterPixel(), XmtRegisterStandardColors() - define symbolic color names in a color table.SYNOPSIS
void XmtRegisterColor(XmtColorTable table, String symbolic_name, String color_name)
void XmtVaRegisterColors(XmtColorTable table, { String symbolic_name, String color_name, } NULL)
void XmtRegisterColors(XmtColorTable table, XmtColorPair *colors, Cardinal num)
void XmtRegisterPixel(XmtColorTable table, String symbolic_name, Display *display, Colormap colormap, Pixel pixel)
void XmtRegisterStandardColors(XmtColorTable table, Widget w, Pixel foreground, Pixel background)
typedef struct { String
symbolic_name;
String color_name; } XmtColorPair;
ARGUMENTS
INPUTS- table
- The XmtColorTable in which the color or colors are to be registered.
- symbolic_name
- The symbolic name of the color to be registered. For XmtVaRegisterColors(), this is part of a NULL terminated variable-length argument list and may be repeated any number of times.
- color_name
- The color name to be associated with the symbolic name. For XmtVaRegisterColors(), this is part of a NULL-terminated variable-length argument list and may be repeated any number of times.
- colors
- For XmtRegisterColors(), an array of XmtColorPair structures that define symbolic names and their associated color names.
- num
- For XmtRegisterColors(), the number of elements in the colors array.
- display
- For XmtRegisterPixel(), the X display on which pixel is defined.
- colormap
- For XmtRegisterPixel(), the colormap in which pixel is defined.
- pixel
- For XmtRegisterPixel(), the pixel value that is to be registered with symbolic_name.
- w
- For XmtRegisterStandardColors(), any widget in the application that specifies a display and colormap for which the foreground and background pixels are valid.
- foreground
- For XmtRegisterStandardColors(), a foreground color to be registered in table.
- background
- For XmtRegisterStandardColors(), a background color to be used to register the other ``standard'' colors in table.
DESCRIPTION
These functions all provide ways of defining symbolic names for actual color names in an XmtColorTable. XmtRegisterColor() is the simplest-it associates symbolic_name with color_name in table.XmtVaRegisterColors() is like XmtRegisterColor(), except that it uses a NULL-terminated variable-length argument list to associate any number of symbolic_name and color_name pairs in table.
XmtRegisterColors() is a variation on XmtVaRegisterColors() that uses a counted array of XmtColorPair structures instead of a variable-length argument list of symbolic_name/color_name pairs.
XmtRegisterPixel() defines a symbolic name for an already allocated pixel value. Note that it requires Display * and Colormap arguments to specify where the pixel is valid. The pixel value is registered by querying the RGB components of the color and converting these to a hexidecimal RGB color specification.
XmtRegisterStandardColors() registers a number of ``standard'' symbolic colors based on the specified foreground and background colors. These ``standard'' colors are the same ones that appear by default in the colorTable application resource. They are listed in the table.
| Symbolic name | Color Registered |
| foreground | the specified foreground color |
| background | the specified background color |
| top_shadow | a lighter shade of the background; for shadows |
| bottom_shadow | a darker shade of the background; for shadows |
| select | a slightly darker shade of the background; for armed buttons, etc. |
SEE ALSO
Chapter 4, Using Color,XmtColorTableGetParent(), XmtColorTableSetParent(), XmtCreateColorTable(), XmtDestroyColorTable(), XmtLookupColorName().
| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.