NAME

DoPolymarker − Create a polymarker primitive object

SYNOPSIS

C:

DtObject DoPolymarker(markercount, markerpositions)
DtInt markercount;
DtPoint3 markerpositions[];

FORTRAN:

INTEGER∗4 DOPM(MKRCNT, MKRPOS)
INTEGER∗4 MKRCNT
REAL∗8 MKRPOS(3,MKRCNT)

DESCRIPTION

DoPolymarker creates a polymarker primitive object.  A polymarker primitive object is a set of markers, each having its own location.  The markers are rendered in a plane in frame space that is parallel to the XY-plane of the device space.  The marker positions are individually transformed into world coordinates using the current transformation matrix.  Then they are mapped into frame space using the current camera projection matrix. 

The locations of the markers are specified by an array of points.  The parameter markercount specifies the number of points in the array markerpositions.  The parameter markerpositions is the two-dimensional array of marker data.  The array will contain 3 real numbers for each marker. 

A marker has no geometric size, so transformations will not affect the displayed size of a marker.  A marker is drawn using a glyph that can be specified using DoMarkerGlyph <DOMG> from a font that can be specified by DoMarkerFont <DOMF>.  The glyph can be scaled by a factor that can be set by DoMarkerScale <DOMS>. 

SEE ALSO

DoMarkerFont(3D), DoMarkerGlyph(3D), DoMarkerScale(3D)

September 02, 1992