NAME

XmtCreateColorTable(), XmtDestroyColorTable(), XmtColorTableGetParent(), XmtColorTableSetParent() - create and manipulate color tables.

SYNOPSIS

#include <Xmt/Color.h> XmtColorTable XmtCreateColorTable(XmtColorTable parent)

void XmtDestroyColorTable(XmtColorTable table)

XmtColorTable XmtColorTableGetParent(XmtColorTable table)

void XmtColorTableSetParent(XmtColorTable table, XmtColorTable parent)

ARGUMENTS

INPUTS

table: The color table that is to be destroyed, or have its parent queried or set.
parent: The parent color table for the newly created color table or for the specified table.

RETURNS

XmtCreateColorTable() returns a newly created color table. XmtColorTableGetParent() returns the parent of the specified color table.

DESCRIPTION

XmtCreateColorTable() returns a newly created XmtColorTable with no entries. An XmtColorTable maps symbolic color names to actual color names. Symbolic colors can be defined in an XmtColorTable with XmtRegisterColor() and related functions, and can be looked up with XmtLookupColorName().

The parent argument specifies another XmtColorTable to which the newly created table is ``chained''. XmtLookupColorName() looks up symbolic color names by first searching the specified color table, and then by searching its parent, its parent's parent, and so on up the chain, until a color table with a NULL parent is encountered.

XmtDestroyColorTable() frees memory associated with the specified XmtColorTable. Once this function is called, the specified color table should no longer be used.

XmtColorTableGetParent() returns the parent color table of table.

XmtColorTableSetParent() sets the parent of table to parent, thereby ``chaining'' the two table for color lookups with XmtLookupColorName().

NAME

SYNOPSIS

ARGUMENTS

DESCRIPTION

SEE ALSO