PEXGetTableInfo(3) — Subroutines

Name

PEXGetTableInfo - Get Lookup Table Information

Synopsis

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

Arguments

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

drawableThe resource identifier of a drawable.

table_typeThe type of lookup table (see the Description).

info_returnReturns the lookup table information.

Returns

Zero if unsuccessful, non-zero otherwise.

Description

This function returns information about the specified type of lookup table. The type of lookup table must be one of the following:

PEXLUTColorApprox
PEXLUTColor
PEXLUTDepthCue
PEXLUTEdgeBundle
PEXLUTInteriorBundle
PEXLUTLight
PEXLUTLineBundle
PEXLUTMarkerBundle
PEXLUTPattern
PEXLUTTextBundle
PEXLUTTextFont
PEXLUTView

The returned information is based on the assumption that the lookup table would be used on drawables with the same root and depth as 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).

Data Structures

typedef struct {
    unsigned short      definable_entries;
    unsigned short      predefined_count;
    unsigned short      predefined_min;
    unsigned short      predefined_max;
} PEXTableInfo;

Errors

BadDrawableThe specified drawable resource identifier is invalid.

BadMatchThe specified drawable is unsupported.

BadPEXLookupTable
The specified table type is unsupported.

BadValueThe specified table type is invalid.

Museum