PEXOCCSetRenderingColorModel - Set Rendering Color Model (5.0)

Synopsis 

 
   void PEXOCCSetRenderingColorModel(
        PEXOCC context,
        int model
   )
 


 
   void PEXSetRenderingColorModel(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        int model
   )

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

display (OCC)
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

model
The rendering color model (PEXRenderingColorModelImpDep, PEXRenderingColorModelRGB, PEXRenderingColorModelCIE, PEXRenderingColorModelHSV, PEXRenderingColorModelHLS, or PEXRenderingColorModelYIQ).

Returns

None.

Description

Invoke PEXOCCSetRenderingColorModel to create an attribute output command which sets the rendering color model attribute in the renderer's pipeline state according to the value specified by model.

The rendering color model defines the color model actually used for the rendering calculations. You can define color values in color models other than rendering color model; PEXlib converts them to the rendering color model before using them.

PEXlib defines the following color models (model):

PEXRenderingColorModelImpDep -
specifies an implementation-dependent color space. (5.0)

PEXRenderingColorModelRGB -
specifies a red, green, blue color model. (5.0)

PEXRenderingColorModelCIE -
specifies a CIELUV diagram u, v coordinates plus luminance color model. (5.0)

PEXRenderingColorModelHSV -
specifies a hue, saturation, value color model. (5.0)

PEXRenderingColorModelHLS -
specifies a hue, lightness, saturation color model. (5.0)

PEXRenderingColorModelYIQ -
specifies a (NTSC) luminance (Y), inphase (wideband orange- cyan), and quadrature (narrowband magenta-green) color model. (5.0)

If the implementation does not support the specified color model, then model defaults to PEXRenderingColorModelImpDep (model 0). Inquire the supported values for the rendering color model by invoking the PEXGetEnumTypeInfo function.

This function is a member of the global attribute set.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview and for a list of all output attribute functions, see Output Attribute Functions.