JMSL Chart Programmer's Guide
3D Drawing Elements >> Marker Attributes  Previous Page  Contents  Next Page

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. For clarity, these are drawn larger than normal.

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 contrasting color.
MARKER_TYPE_SIMPLE_TETRAHEDRON Solid colored tetrahedron without edge outlining.
MARKER_TYPE_PLUS 3D plus sign with its edges outlined in a contrasting 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 MarkerPulsingMinimumScale attribute times the value of the MarkerSize attribute.

Attribute MarkerPulsingMaximumScale

The maximum marker size during a pulse cycle is the value of the MarkerPulsingMaximumScale 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, Inc.  All rights reserved.  Previous Page  Contents  Next Page