void PEXOCCTriangles(
PEXOCC context,
unsigned int num_facets,
PEXPointer facet_data,
PEXPointer vertices
)
None.
Invoke PEXOCCTriangles to create a list of independent triangles primitive output command (PEXOCTriangleSetWithData).
This primitive independently renders each triangle in the list. A triangle list is a collection of triangles defined by the modeling coordinates vertex list. Every three vertices in the vertex list define one independent triangle. This function is a more concise way of defining a list of independent triangles than using the PEXOCCIndexedTriangles function with the all_independent flag.
If you define facet and/or vertex colors, then they are of the type specified by color_type. Otherwise the implementation ignores color_type.
Facet and vertex normals are assumed to be unit length vectors. If you specify a normal that is not unit length, then the result is implementation-dependent.
If you set the PEXGAFloatData bit of the facet attributes and/or vertex attributes, then you must supply extended floating-point data with each facet and/or vertex, respectively. If you set the PEXGAFloatData facet attribute bit, then facet_fp_count indicates the number of floating-point values for each facet. If you set the PEXGAFloatData vertex attribute bit, then surface_vertex_fp_data_count indicates the number of floating-point values for each vertex. If you set only one floating-point data attribute bit, then the implementation ignores the count corresponding to the other floating-point data attribute bit. If neither floating-point data attribute bit is set, then the implementation ignores both facet_fp_data_count and surface_vertex_fp_data_count.
If you indicate that facet data is present with the facet attributes, you must supply facet data for each facet (triangle).
If you set the PEXGA2D vertex attribute bit, then the vertex coordinates are of type COORD_2D instead of type COORD_3D.
If you set the PEXGAEdges bit of the vertex attributes, then two surface edge flags are specified with each vertex. This edge data is used if the pipeline state's surface edge flag is PEXOn. For each triangle in the list, both of the edge flags in the triangle's first vertex are ignored. The first edge flag in the second vertex indicates whether to draw the edge between the first and second vertices. The second edge flag in the second vertex is ignored. The first edge flag in the third vertex indicates whether to draw the edge between the second and third vertices. The second edge flag in the third vertex indicates whether to draw the edge between the first and third vertices. If the edges vertex attribute is not set, then all the edges are drawn if the pipeline state's surface edge flag is PEXOn.
Clipping is similar to Fill Area 3D. See Surfaces - General Attributes.
The basic surface, styled and shaded surface, edge, and data mapping attribute sets are applied to this primitive.
All other aspects of this primitive are the same as PEXOCCFillArea.
For primitives similar to this one, see:
There are no PEXlib 5.1 compatibility primitives similar to this one.
For attributes that affect this primitive, see
For an overview, see Output Command Functions.