PEXOCCSetBFInteriorStyle - Set Back-Facing Surface Interior Style (5.0)


Synopsis

 
   void PEXOCCSetBFInteriorStyle(
          PEXOCC context,
          int style
      )
 

 
   void PEXSetBFInteriorStyle(
           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 back-facing surface interior style (PEXInteriorStyleHollow, PEXInteriorStyleSolid, PEXInteriorStylePattern, PEXInteriorStyleHatch or PEXInteriorStyleEmpty).

Returns

None.

Description

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

By setting the back-facing interior style attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's back-facing surface interior style entry to describe how to fill the interior of back-facing surfaces. When you set the back-facing interior style attribute's ASF to PEXBundled, the implementation uses the back-facing interior style value from the interior bundle table.

To apply the back-facing interior style to the back-facing surfaces of output primitives, you must set the facet distinguish flag to True (see PEXOCCSetFacetDistinguishFlag). If you set the flag to False, then the implementation uses the interior style when rendering back-facing surfaces (see PEXOCCSetInteriorStyle).

PEXlib defines the following interior styles (style):

PEXInteriorStyleHollow
draws the boundary of the back-facing surfaces of output primitives using the current back-facing surface color but does not fill the interior. (5.0)
PEXInteriorStyleSolid
fills the interior of back-facing surfaces of output primitives using the current back-facing surface color. (5.0)
PEXInteriorStylePattern
fills the interior of back-facing surfaces of output primitives using the pattern defined according to the entry of the renderer's pattern table specified by the back-facing interior style index. (5.0)
PEXInteriorStyleHatch
fills the interior of back-facing surfaces of output primitives using the current surface color and the hatch style specified by the back-facing interior style index. (5.0)
PEXInteriorStyleEmpty
does not draw the interiors of the back-facing surfaces of output primitives at all. (5.0)
PEXInteriorStyleTexture
textures the interior of the back-facing surfaces of output primitives using the texture maps specified by the back-facing active textures. (5.2)

If you do not specify an interior style that is supported by the implementation, then the style defaults to PEXInteriorStyleHollow. Inquire the supported values for the back-facing surface interior styles 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.