PEXGetTableInfo - Get Lookup Table Information (5.0)


Synopsis

 
   Status PEXGetTableInfo(
          Display *display,
          Drawable drawable,
          int table_type,
          PEXTableInfo *info_return
   )
 

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

drawable
The resource identifier of a drawable.

table_type
The type of lookup table (see Table Types, Availability, and Definitions).

info_return
Returns the lookup table information.

Returns

Zero if unsuccessful; non-zero otherwise.

Description

Invoke PEXGetTableInfo to obtain information about the specified type of lookup table. The type of lookup table must be one of the types described in Table Types, Availability, and Definitions.

This function assumes that you will use the lookup table on drawables with the same root and depth as the specified drawable. The returned information includes the number of predefined table entries, the number of definable table entries, and the indices of the predefined minimum and maximum entries. Predefined entries are contiguous. The number of definable table entries includes the number of predefined entries since predefined table entries can be redefined by the application. All entries between the predefined minimum and maximum values are guaranteed to be defined initially (i.e., predefined entries have contiguous indices).

Errors

BadDrawable
The specified drawable resource identifier is invalid.

BadMatch
The specified drawable is unsupported.

BadPEXLookupTable
The specified table type is unsupported.

BadValue
The specified table type is invalid.

See Also

For an overview, see Lookup Tables.