PEXOCCSetInteriorStyle - Set Surface Interior Style (5.0)

Synopsis 

 
   void PEXOCCSetInteriorStyle(
        PEXOCC context,
        int style
   )
 

 
   void PEXSetInteriorStyle(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        int style
   )

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).

style
The interior style (PEXInteriorStyleHollow, PEXInteriorStyleSolid, PEXInteriorStylePattern, PEXInteriorStyleHatch, PEXInteriorStyleEmpty or PEXInteriorStyleTexture).

Returns

None.

Description

Invoke PEXOCCSetInteriorStyle to create an attribute output command which sets the surface interior style attribute in the renderer's pipeline state according to the value specified by style.

By setting the interior style attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use pipeline state's interior style entry to describe how to fill the interior of surfaces. When you set the interior style attribute's ASF to PEXBundled, the implementation uses the interior style value from the interior bundle table If you do not set the facet distinguish flag to True (see PEXOCCSetFacetDistinguishFlag), then the implementation applies this interior style to back-facing as well as front-facing surface interiors. Otherwise the implementation uses the back-facing surface interior style (see PEXOCCSetBFInteriorStyle).

PEXlib defines the following interior styles (style):

PEXInteriorStyleHollow -
draws the boundary of the surface primitives using the current surface color but does not fill the interior. (5.0)

PEXInteriorStyleSolid -
fills the interior of surface primitives using the current surface color. (5.0)

PEXInteriorStylePattern -
fills the interior of surface primitives using the pattern defined according to the entry of the renderer's pattern table specified by the interior style index. (5.0)

PEXInteriorStyleHatch -
fills the interior of surface primitives using the current surface color and the hatch style specified by the interior style index. (5.0)

PEXInteriorStyleEmpty -
does not draw the interiors of the surface primitives at all. (5.0)

PEXInteriorStyleTexture -
textures the interior of the surface primitives using the texture maps specified by the active textures. (5.2)

If you specify an undefined interior style, then the implementation issues a BadPEXOutputCommand error. If the implementation does not support the defined interior style you specify, then the style defaults to PEXInteriorStyleHollow. Inquire the supported values for the surface interior style by invoking the PEXGetEnumTypeInfo function.

This function is a member of the styled and shaded surface attribute set.

Errors

BadPEXOutputCommand
The output command contains an invalid value.

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 output attribute functions, see Output Attribute Functions.