PEXOCCMarkers - 3D Markers Primitive (5.0)

Synopsis

 
     void PEXOCCMarkers(
          PEXOCC context,
          unsigned int count,
          PEXPointer occ_points
     )
 


 
     void PEXMarkers(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          unsigned int count,
          PEXCoord *points
     )

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

marker_vertex_attributes (OCC)
A mask indicating the vertex attributes provided (PEXGANone(5.0), PEXGAColor(5.2), PEXGA2D(5.0), or PEXGAFloatData(5.2)).

marker_vertex_fp_data_count (OCC)
The number of optional floating-point numbers for each vertex.

color_type (OCC)
The type of color data provided (PEXColorTypeIndexed, PEXColorTypeRGB, PEXColorTypeCIE, PEXColorTypeHSV, PEXColorTypeHLS, PEXColorTypeRGB8, PEXColorTypeRGB16, PEXColorTypeRGBA, PEXColorTypeRGBA8, or PEXColorTypeRGBA16).

count
The number of points.

occ_points
A pointer to vertex data specifying marker locations. See Facet / Vertex Data Formats.

points
An array of points specifying marker locations.

data_model (OCC)
Specifies the data model used to represent the geometric data.

data_model_specs (OCC)
Offset and size data for the PEXDataStride or PEXDataUnpacked data models.

Returns

None.

Description

Invoke PEXOCCMarkers to create a markers primitive output command. Depending on the attributes you supply, this function generates a PEXOCMarkers, PEXOCMarkers2D, or PEXOCMarkerWithData output command.

A marker is a geometric primitive with a position as its only geometric attribute. Specify the position in modeling coordinates.

With the OCC version of this primitive, you can provide color and floating-point data as additional data.

Rendering transforms the marker's position to a position in device coordinates. A marker has no geometric size, so geometric transformations do not affect the displayed size of the marker. Depth-cueing affects the marker's color and maps it to a device color.

If your application positions the marker within the clipping volume but renders it outside of the clipping volume, then the result is implementation-dependent.

Depending on the setting of the marker source flag, this primitive obtains the attributes: marker color, marker type, and marker scale either directly from the current marker attributes or from the marker bundle lookup table entry specified by the current marker bundle index attribute.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For PEXlib 5.1 compatibility primitives similar to this one see:

For attributes that affect this primitive, see Marker Attributes.

For an overview, see Output Command Functions.