FreeBSD Manual Pages
XmtLookupColorName(3) Library Functions Manual XmtLookupColorName(3) NAME XmtLookupColorName() - lookup the actual color name associated with a symbolic color name in an XmtColor Table. SYNOPSIS #include <Xmt/Color.h> String XmtLookupColorName(XmtColorTable table, String symbol) ARGUMENTS INPUTS table The XmtColorTable to be searched. symbol The symbolic color name to be looked up. RETURNS The actual color name associated with the symbol in table, or NULL, if none is found. DESCRIPTION XmtLookupColorName() returns the name of the color registered with sym- bolic name symbol in XmtColorTable table. If symbol is not found in table, then the parent of the specified color table is searched, and then the parent's parent is search, and so on until a definition of the symbolic color is found, or until a color table with no parent is is encountered. If the symbolic color is not found, XmtLookupColorName() returns NULL. This chain of color tables provides a ``scoping'' mecha- nism for symbolic color names like that used for variable names in C programming. The returned value is not guaranteed to be a legal color name; it is simply whatever name was registered with XmtRegisterColor() or a related function. Generally though, the color name returned by Xmt- LookupColorName() is suitable for allocation with XmtAllocColor() or a related function. SEE ALSO Chapter 4, Using Color, XmtAllocColor(), XmtColorTableGetParent(), XmtColorTableSetParent(), XmtCreateColorTable(), XmtDestroyColorTable(), XmtRegisterColor(), XmtRegisterColors(), XmtRegisterPixel(), XmtRegisterStandardColors(), XmtVaRegisterColors(). Xmt Motif Tools XmtLookupColorName(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtLookupColorName&sektion=3&manpath=FreeBSD+Ports+15.0>
