.\" @(#)PEXCreateSearchContext.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCreateSearchContext 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCreateSearchContext \- Create Search Context
.SH SYNTAX
.HP
PEXSearchContext PEXCreateSearchContext\^(\^Display *\fIdisplay\fP\^, unsigned long \fIvalue_mask\fP\^, PEXSCAttributes *\fIvalues\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIvalue_mask\fP
A mask indicating the attributes specified.
.TP
\fIvalues\fP
A pointer to values used to override default values in the new search
context resource.
.SH RETURNS
The resource identifier of the newly-created search context resource.
.SH DESCRIPTION
.\" indexing
.IX PEXCreateSearchContext
.IX "Search Context" PEXCreateSearchContext
.LP
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.
.\"@
.\" start equation_nroff_version
.if t .ig xx
.sp
.nf
PEXSCPosition           <0.0, 0.0, 0.0>
PEXSCDistance	        0.0
PEXSCCeiling            1
PEXSCModelClipFlag      False
PEXSCStartPath          NULL
PEXSCNormalList         NULL
PEXSCInvertedList       NULL
.fi
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.sp
.TS H
center, box;
lfB lfB
l l.
Attribute Name	Default Value
_
.TH
PEXSCPosition	<0.0, 0.0, 0.0>
PEXSCDistance	0.0
PEXSCCeiling	1
PEXSCModelClipFlag	False
PEXSCStartPath	NULL
PEXSCNormalList	NULL
PEXSCInvertedList	NULL
.TE
.yy
.LP
.SH DATA STRUCTURES
.LP
.nf
typedef  XID    PEXRenderer;
.sp
typedef  XID    PEXSearchContext;
.sp
typedef struct {
        PEXCoord		position;
        float			distance;
        unsigned short		ceiling;
        Bool			model_clip_flag;
        PEXStructurePath	start_path;
        PEXListOfNameSetPair	normal;
        PEXListOfNameSetPair	inverted;
.br
} PEXSCAttributes;
.sp
typedef struct {
        float	x;
        float	y;
        float	z;
.br
} PEXCoord;
.sp
typedef struct {
        unsigned long             count;         /* number of elements */
        PEXElementRef           *elements;
.br
} PEXStructurePath;
.sp
typedef struct {
        PEXStructure            structure;
        unsigned long           offset;
.br
} PEXElementRef;
.sp
typedef  XID	PEXStructure;
.sp
typedef struct {
        unsigned short             count;        /* number of pairs */
        PEXNameSetPair          *pairs;
.br
} PEXListOfNameSetPair;
.sp
typedef struct {
        PEXNameSet              inclusion;
        PEXNameSet              exclusion;
.br
} PEXNameSetPair;
.sp  
typedef  XID	PEXNameSet;
.fi
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate the resource.
.TP
.SB BadPEXNameSet
The specified name set resource identifier is invalid.
.TP
.SB BadPEXPath
The specified path is invalid.
.TP
.SB BadValue
A specified value is out of range, or an invalid bit is set in the value mask.
.SH SEE ALSO
.LP
.nf
.BR PEXFreeSearchContext (3)
.fi