.\" @(#)PEXChangeSearchContext.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXChangeSearchContext 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXChangeSearchContext \- Change Search Context
.SH SYNTAX
.HP
void PEXChangeSearchContext\^(\^Display *\fIdisplay\fP\^, PEXSearchContext \fIcontext\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
\fIcontext\fP
The resource identifier of the search context.
.TP
\fIvalue_mask\fP
A mask indicating the search context attributes to be changed.
.TP
\fIvalues\fP
A pointer to new values for the specified search context attributes.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXChangeSearchContext
.IX "Search Context" PEXChangeSearchContext
.LP
This function modifies the attributes of the specified search
.I context
resource.
The value mask indicates which
.I values
are specified.
The value mask is constructed by OR'ing together the following constants:

.nf
.RS
.B PEXSCPosition
.B PEXSCDistance
.B PEXSCCeiling
.B PEXSCModelClipFlag
.B PEXSCStartPath
.B PEXSCNormalList
.B PEXSCInvertedList
.RE
.fi
.SH DATA STRUCTURES
.LP
.nf
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;
.bp
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 BadPEXNameSet
The specified name set resource identifier is invalid.
.TP
.SB BadPEXPath
The specified path is invalid.
.TP
.SB BadPEXSearchContext
The specified search context resource identifier 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 PEXCreateSearchContext (3)
.BR PEXGetSearchContext (3)
.fi