Note: This function has been superseded by the PEXOCCFillAreaSet function, but is maintained here for backwards compatibility with PEXlib 5.1
void PEXFillAreaSetWithData(
Display *display,
XID resource_id,
PEXOCRequestType req_type,
int shape_hint,
int ignore_edges,
int contour_hint,
unsigned int facet_attributes,
unsigned int vertex_attributes,
int color_type,
unsigned int count,
PEXFacetData *facet_data,
PEXListOfVertex *vertex_lists
)
None.
Invoke PEXFillAreaSetWithData to create a fill area set output primitive.
This primitive is similar to the PEXFillAreaSet primitive, except that you can specify additional information for each fill area and for each vertex. It is similar to PEXFillAreaWithData but enables you to create areas with "islands" or "holes". Color values passed must be of the specified color type.
The facet attributes indicate the content of the facet data. Use the constants PEXGANone, PEXGAColor, PEXGANormal and PEXGAFloatData to construct a mask indicating the data provided. Use the PEXlib-supplied packed format data structures to map the facet data if using the packed data interface to maintain the order of color, normal, float_data.
If specified, the facet color takes precedence over the surface color. If specified, the facet normal is used to determine whether the fill area is back-facing.
The vertex attributes indicate the content of each fill area vertex. Use the constants PEXGANone, PEXGAColor, PEXGANormal, PEXGAEdges, PEXGAFloatData and PEXGA2D to construct a mask indicating the data provided. Use the PEXlib-supplied packed format data structures to map the vertex data if using the packed data interface to maintain the order of color, normal, edges, float_data.
If specified, vertex colors override facet color or the current surface color. If specified, vertex normals are taken to be normals at the vertices of the fill area.
The reflection model and the surface interpolation affect how the implementation uses additional data in rendering the surface. Specify edge controls to indicate which edges the implementation should render when the surface edges are enabled. The edge control for vertex i indicates whether or not to render the edge between vertex i and vertex i+1. Surface edges are always rendered with the surface edge color and are not affected by the facet or vertex colors.
Normals are assumed to be unit length vectors. If you specify a normal that is not unit length, then the result is implementation-dependent.
All other aspects of this primitive are the same as PEXFillAreaSet.
For an overview, see Output Command Functions.