Marker Attributes

Markers are drawn when a Data node is rendered with its DataType attribute having its DATA_TYPE_MARKER bit set. Drawing of markers is affected by the attributes described in this section. Note that when markers are drawn using lines, the line attributes do not apply to markers.

An alternative to markers are images, which can be used to draw arbitrary symbols instead of markers.

Attribute MarkerType

MarkerType is an integer-valued attribute that determines which marker will be drawn. There are constants defined in ChartNode3d for the marker types. The default value is MARKER_TYPE_CUBE. The following table defines marker types.

 

Marker Type

Description

MARKER_TYPE_CUBE

Cube with its edges outlined in a contrasting color.

MARKER_TYPE_SIMPLE_CUBE

Solid colored cube without edge outlining.

MARKER_TYPE_SPHERE

Shaded sphere

MARKER_TYPE_TETRAHEDRON

Tetrahedron with its edges outlined in a con­trasting color.

MARKER_TYPE_SIMPLE_TETRAHEDRON

Solid colored tetrahedron without edge out­lining.

MARKER_TYPE_PLUS

3D plus sign with its edges outlined in a con­trasting color.

MARKER_TYPE_SIMPLE_PLUS

Solid 3D plus sign without edge outlining

MARKER_TYPE_CUSTOM

Marker defined by the user set using the attribute CustomMarkerFactory.

 

Attribute MarkerColor

MarkerColor is a Color-valued attribute that determines the color of the marker. Its default value is Color.black.

Attribute MarkerSize

MarkerSize is a double-valued attribute that determines the size of the marker. The default value is 1.0.

Attribute MarkerPulsingCycle

Cycle time, in seconds, for pulsing the marker. If this time is less than or equal to zero the marker is not pulsed. The default value is zero.

Attribute MarkerPulsingCycleOffset

Offset time, in seconds, from the time rendering begins to when the marker begins pulsing. This attribute allows different markers to pulse with different phases.

Attribute MarkerPulsingMinimumScale

The minimum marker size during a pulse cycle is the value of the MarkerPuls­ingMinimumScale attribute times the value of the MarkerSize attribute.

Attribute MarkerPulsingMaximumScale

The maximum marker size during a pulse cycle is the value of the MarkerPuls­ingMaximumScale attribute times the value of the MarkerSize attribute.

Attribute MarkerRotatingCycle

Cycle time, in seconds, for rotating the marker. If this time is less than or equal to zero the marker is not rotated. The default value is zero.

Attribute MarkerRotatingCycleOffset

Offset time, in seconds, from the time rendering begins to when the marker begins rotating. This attribute allows different markers to rotate with different phases.

Attribute MarkerRotatingAxis

A double[3] array containing the axis of rotation. The default is (0,0,1), the z-axis.



Visual Numerics - Developers of IMSL and PV-WAVE
http://www.vni.com/
PHONE: 713.784.3131
FAX:713.781.9260