.\" @(#)PEXCreateLookupTable.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCreateLookupTable 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCreateLookupTable \- Create Lookup Table
.SH SYNTAX
.LP
PEXLookupTable PEXCreateLookupTable\^(\^Display *\fIdisplay\fP\^, Drawable \fIdrawable\fP\^, int \fItable_type\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIdrawable\fP
The resource identifier of a drawable.
.TP
\fItable_type\fP
The type of lookup table to be created (see the \fIDescription\fP section).
.SH RETURNS
The resource identifier of the newly-created lookup table.
.SH DESCRIPTION
.\" indexing
.IX PEXCreateLookupTable
.IX "Lookup Table" PEXCreateLookupTable
.LP
This function creates a lookup table resource of the specified type and
returns the resource identifier of the
new lookup table.  The returned identifier is used to
refer to the created lookup table.  The type of
lookup table to be created must be one of the following:

.nf
.RS
.B PEXLUTColorApprox
.B PEXLUTColor
.B PEXLUTDepthCue
.B PEXLUTEdgeBundle
.B PEXLUTInteriorBundle
.B PEXLUTLight
.B PEXLUTLineBundle
.B PEXLUTMarkerBundle
.B PEXLUTPattern
.B PEXLUTTextBundle
.B PEXLUTTextFont
.B PEXLUTView
.RE
.fi
.LP
The newly-created lookup table can
only be used with drawables having the same depth and root as
the specified drawable.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID    PEXLookupTable;
.sp
.fi
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate the resource.
.TP
.SB BadDrawable
The specified drawable resource identifier is invalid.
.TP
.SB BadMatch
The specified drawable is unsupported.
.TP
.SB BadPEXLookupTable
The specified table type is unsupported.
.TP
.SB BadValue
The specified table type is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXFreeLookupTable (3)
.fi