PEXFillArea2D - 2D Fill Area Primitive (5.0)


Note: This function has been superseded by the PEXOCCFillArea function, but is maintained here for backwards compatibility with PEXlib 5.1

Synopsis

 
     void PEXFillArea2D(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          int shape_hint,
          int ignore_edges,
          unsigned int count,
          PEXCoord2D *points
      )
 

Arguments

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

resource_id
The resource identifier of the renderer or structure.

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

shape_hint
The shape of the fill area (PEXShapeComplex, PEXShapeNonConvex, PEXShapeConvex or PEXShapeUnknown).

ignore_edges
A flag that determines if surface edges are rendered (True or False).

count
The number of points.

points
An array of vertices defining the fill area.

Returns

None.

Description

Invoke PEXFillArea2D to create a two-dimensional fill area output primitive.

This primitive is similar to the PEXFillArea primitive, except that you only need to specify the x- and y-components. The z-component is always assumed to be zero. This primitive is two-dimensional only in that the z-components are implied. The implementation still carries out geometry transformations in three dimensions.

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, see Output Command Functions.