PEXCreateSearchContext(3) — Subroutines

Name

PEXCreateSearchContext - Create Search Context

Synopsis

PEXSearchContext PEXCreateSearchContext(Display ∗display, unsigned long value_mask, PEXSCAttributes ∗values)

Arguments

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

value_maskA mask indicating the attributes specified.

valuesA pointer to values used to override default values in the new search context resource.

Returns

The resource identifier of the newly-created search context resource.

Description

This function creates a search context and returns the resource identifier of the created search context resource. The value mask indicates which values are specified to override the default values. The value mask is constructed by or’ing together the following constants:

PEXSCPosition
PEXSCDistance
PEXSCCeiling
PEXSCModelClipFlag
PEXSCStartPath
PEXSCNormalList
PEXSCInvertedList

Data Structures

typedef XID             PEXSearchContext;
typedef struct {
    PEXCoord            position;
    float               distance;
    unsigned short      ceiling;
    Bool                model_clip_flag;
    PEXStructurePath    start_path;
    PEXListOfNameSetPair normal;
    PEXListOfNameSetPair inverted;
} PEXSCAttributes;
typedef struct {
    float               x;
    float               y;
    float               z;
} PEXCoord;
typedef struct {
    unsigned long       count;
    PEXElementRef       ∗elements;
} PEXStructurePath;
typedef struct {
    PEXStructure        structure;
    unsigned long       offset;
} PEXElementRef;
typedef XID             PEXStructure;
typedef struct {
    unsigned short      count;
    PEXNameSetPair      ∗pairs;
} PEXListOfNameSetPair;
typedef struct {
    PEXNameSet          inclusion;
    PEXNameSet          exclusion;
} PEXNameSetPair;
typedef XID             PEXNameSet;

Errors

BadAllocThe server failed to allocate the resource.

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPathThe specified path is invalid.

BadValueA specified value is out of range, or an invalid bit is set in the value mask.

Museum