.\" @(#)PEXChangePipelineContext.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXChangePipelineContext 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXChangePipelineContext \- Change Pipeline Context
.SH SYNTAX
.HP
void PEXChangePipelineContext\^(\^Display *\fIdisplay\fP\^, PEXPipelineContext \fIcontext\fP\^, unsigned long *\fIvalue_mask\fP\^, PEXPCAttributes *\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 pipeline context.
.TP
\fIvalue_mask\fP
A pointer to an array of three unsigned long.
.TP
\fIvalues\fP
A pointer to new values for attributes in the pipeline context.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXChangePipelineContext
.IX "Pipeline Context" PEXChangePipelineContext
.LP
This function changes components of the specified pipeline
.I context
to the
.I values
specified.  The value mask indicates which attribute values are
specified.
.BR PEXSetPCAttributeMask (3)
and
.BR PEXSetPCAttributeMaskAll (3)
can be called to setup the value mask.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXPipelineContext;
.fi
.sp .5
See also
.B PEXlib.h.
.SH ERRORS
.TP
.SB BadPEXColorType
The specified color type is invalid or unsupported.
.TP
.SB BadPEXNameSet
The specified name set resource identifier is invalid.
.TP
.SB BadPEXPipelineContext
The specified pipeline
.I 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 PEXCreatePipelineContext (3)
.BR PEXGetPipelineContext (3)
.BR PEXSetPCAttributeMask (3)
.fi