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