JMSL Chart Guide: Marker Attributes

JMSL Chart Programmer's Guide

3D Drawing Elements >> Marker Attributes

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.

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.