lt.monarch.chart.chart3D.series
Class Line3DSeries

java.lang.Object
  lt.monarch.chart.engine.AbstractChartObject<Tags>
      lt.monarch.chart.AbstractChartSeries<Tags,ChartProjector>
          lt.monarch.chart.chart3D.series.MarkerDecorableSeries3D<SeriesPaintTags,Projector3D>
              lt.monarch.chart.chart3D.series.Line3DSeries

All Implemented Interfaces:

java.io.Serializable, AbstractMarkerSeries, ChartEntity, ChartObject, ChartSeries, StyleEditorEntity

public class Line3DSeries
extends MarkerDecorableSeries3D<SeriesPaintTags,Projector3D>

Line series 3D. This series renders line, scatter and spline (a.k.a. ribbon) series in 3D space.

See Also:

Serialized Form

Field Summary

Modifier and Type	Field and Description
protected static java.util.Hashtable<AxisMapper,java.lang.Float>	lineSpacings Hashtable that maps axis mapper to bar spacing
protected PlaneMapper3D	mapper the plane mapper
protected static java.util.Hashtable<AxisMapper,java.lang.Float>	seriesSpacings Hashtable that maps axis mapper to bar spacing

Fields inherited from class lt.monarch.chart.chart3D.series.MarkerDecorableSeries3D

baseValue, colorMapper, markerPainter, markers, model, pseudoModel

Fields inherited from class lt.monarch.chart.AbstractChartSeries

metaModel, modelValidator, seriesName, seriesTransform, showLegend, showNullValues, symbol, xMapper, yMapper, zMapper

Fields inherited from class lt.monarch.chart.engine.AbstractChartObject

AXIS_SORT_POSITION, BREAK_LINE_POSITION, DEFAULT_SORT_POSITION, GRID_SORT_POSITION, MARKER_SERIES_SORT_POSITION, MARKERS_SORT_POSITION, paintStyle, SERIES_SORT_POSITION, sortPosition, style

Constructor and Description

Line3DSeries(ArrayDataModel model, AxisMapper xMapper, AxisMapper yMapper, AxisMapper zMapper)
Line series constructor without a meta data model and default plane mapper is for Cartesian coordinates.

Line3DSeries(ArrayDataModel model, MetaDataModel metaModel, AxisMapper xMapper, AxisMapper yMapper, AxisMapper zMapper)
Constructs a new Line series.

Line3DSeries(ArrayDataModel model, MetaDataModel metaModel, PlaneMapper3D mapper, AxisMapper xMapper, AxisMapper yMapper, AxisMapper zMapper)
Constructs a new line series

Line3DSeries(ArrayDataModel model, PlaneMapper3D mapper, AxisMapper xMapper, AxisMapper yMapper, AxisMapper zMapper)
Line series constructor without a meta data model

Method Summary

Modifier and Type	Method and Description
void	draw(AbstractGraphics g) Renders chart object on the Graphics context.
static float	getLineSpacing(AxisMapper mapper) Returns line spacings.
MarkerConstraints[]	getMarkerConstraints() Returns series marker constraints.
java.lang.Object	getMaxValue(DataColumnType valType) Note: internal use only! Gets maximum value that is used by series to fit into the chart
java.lang.Object	getMinValue(DataColumnType valType) Note: internal use only! Gets minimum value that is used by series to fit into the chart
static float	getSeriesSpacing(AxisMapper mapper) Returns spacing between different line series.
AbstractLine3DStrategy	getStrategy() Gets line drawing strategy.
protected void	initLegendSymbol() Initializes a new Line3DSeries legend symbol used for representing line series in legend.
static void	removeLineSpacing(AxisMapper mapper) Removes line spacing from the hashtable according to the specified axis mapper
static void	removeSeriesSpacing(AxisMapper mapper) Removes series spacing from the hashtable according to the specified axis mapper
static void	setLineSpacing(AxisMapper mapper, float space) Sets the space the line width occupies.
static void	setSeriesSpacing(AxisMapper mapper, float space) Sets spacing between different line series.
void	setStrategy(Line3DStrategies strategy) Sets line drawing strategy.

Methods inherited from class lt.monarch.chart.chart3D.series.MarkerDecorableSeries3D

addMarker, addMarker, addMarker, drawMarkers, drawMarkers, getBaseValue, getColorMapper, getKeyType, getPaintMode, getSortPosition, setBaseValue, setColorMapper, setPaintMode

Methods inherited from class lt.monarch.chart.AbstractChartSeries

activate, checkDataModelRequirements, createLegendEntries, createLegendEntry, createLegendSymbol, deactivate, fillEntitySheet, getChartObjectBounds, getDataModel, getDescription, getMetaDataModel, getModelValidator, getName, getNearestChildEntity, getParentEntity, getProjector, getSeriesColor, getShortDescription, getShowNullValues, getXMapper, getYMapper, getZMapper, handleDataModelChangeEvent, setLegendSymbol, setName, setShowNullValues, setValidateData, showLegend, updateClippingToProjector

Methods inherited from class lt.monarch.chart.engine.AbstractChartObject

chart, copy, dispose, finalize, getChart, getPaintStyle, getParent, getStyle, getStyle, invalidate, isVisible, layout, repaint, repaint, setChart, setVisible

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface lt.monarch.chart.engine.ChartObject

dispose, getChart, getStyle, getStyle, invalidate, isVisible, layout, repaint, repaint, setChart

Methods inherited from interface lt.monarch.chart.engine.StyleEditorEntity

getParent, getStyle

Field Detail

lineSpacings

protected static final java.util.Hashtable<AxisMapper,java.lang.Float> lineSpacings

Hashtable that maps axis mapper to bar spacing

seriesSpacings

protected static final java.util.Hashtable<AxisMapper,java.lang.Float> seriesSpacings

Hashtable that maps axis mapper to bar spacing

mapper

protected PlaneMapper3D mapper

the plane mapper

Constructor Detail

Line3DSeries

public Line3DSeries(ArrayDataModel model,
                    MetaDataModel metaModel,
                    PlaneMapper3D mapper,
                    AxisMapper xMapper,
                    AxisMapper yMapper,
                    AxisMapper zMapper)

Constructs a new line series

Parameters:

model - chart data model

metaModel - meta data model

mapper - mapper, used to map output to a plane in a n-dimensional space

xMapper - x axis mapper

yMapper - y axis mapper

zMapper - z axis mapper

Line3DSeries

public Line3DSeries(ArrayDataModel model,
                    PlaneMapper3D mapper,
                    AxisMapper xMapper,
                    AxisMapper yMapper,
                    AxisMapper zMapper)

Line series constructor without a meta data model

Parameters:

model - chart data model

mapper - mapper, used to map output to a plane in a n-dimensional space

xMapper - x axis mapper

yMapper - y axis mapper

zMapper - z axis mapper

Line3DSeries

public Line3DSeries(ArrayDataModel model,
                    AxisMapper xMapper,
                    AxisMapper yMapper,
                    AxisMapper zMapper)

Line series constructor without a meta data model and default plane mapper is for Cartesian coordinates.

Parameters:

model - chart data model

xMapper - x axis mapper

yMapper - y axis mapper

zMapper - z axis mapper

Line3DSeries

public Line3DSeries(ArrayDataModel model,
                    MetaDataModel metaModel,
                    AxisMapper xMapper,
                    AxisMapper yMapper,
                    AxisMapper zMapper)

Constructs a new Line series. The default plane mapper is used for Cartesian coordinate system.

Parameters:

model - chart data model

metaModel - meta data model

xMapper - x axis mapper

yMapper - y axis mapper

zMapper - z axis mapper

Method Detail

draw

public void draw(AbstractGraphics g)

Description copied from interface: ChartObject

Renders chart object on the Graphics context.

Specified by:

draw in interface ChartObject

Overrides:

draw in class MarkerDecorableSeries3D<SeriesPaintTags,Projector3D>

Parameters:

g - graphics context

initLegendSymbol

protected void initLegendSymbol()

Initializes a new Line3DSeries legend symbol used for representing line series in legend.

setLineSpacing

public static void setLineSpacing(AxisMapper mapper,
                                  float space)

Sets the space the line width occupies.

Parameters:

mapper - axis mapper for which bar spacing is specified.

space - space for line series width

getLineSpacing

public static float getLineSpacing(AxisMapper mapper)

Returns line spacings.

Parameters:

mapper - axis mapper for which line width spacing is specified.

Returns:

space the line width occupies.

getSeriesSpacing

public static float getSeriesSpacing(AxisMapper mapper)

Returns spacing between different line series.

Parameters:

mapper - Axis mapper for which line spacing is returned.

Returns:

space between different line series relative to default computed line width.

setSeriesSpacing

public static void setSeriesSpacing(AxisMapper mapper,
                                    float space)

Sets spacing between different line series.

Parameters:

mapper - axis mapper for which line spacing is specified.

space - space between different line series relative to line default width. Must be in interval [0.0 .. 1.0].

removeLineSpacing

public static void removeLineSpacing(AxisMapper mapper)

Removes line spacing from the hashtable according to the specified axis mapper

Parameters:

mapper - axis mapper, that specifies the line spacing

removeSeriesSpacing

public static void removeSeriesSpacing(AxisMapper mapper)

Removes series spacing from the hashtable according to the specified axis mapper

Parameters:

mapper - axis mapper, that specifies the series spacing

getMarkerConstraints

public MarkerConstraints[] getMarkerConstraints()

Description copied from class: MarkerDecorableSeries3D

Returns series marker constraints.

Specified by:

getMarkerConstraints in class MarkerDecorableSeries3D<SeriesPaintTags,Projector3D>

Returns:

Series marker constraints.

setStrategy

public void setStrategy(Line3DStrategies strategy)

Sets line drawing strategy. If you want to set your own custom strategy set it directly to the stylesheet, using tag "strategy", e.g. style.setObject("strategy", new MyStrategy());

Parameters:

strategy - drawing strategy

getStrategy

public AbstractLine3DStrategy getStrategy()

Gets line drawing strategy.

Returns:

line drawing strategy

getMaxValue

public java.lang.Object getMaxValue(DataColumnType valType)

Description copied from class: AbstractChartSeries

Note: internal use only! Gets maximum value that is used by series to fit into the chart

Specified by:

getMaxValue in class AbstractChartSeries<SeriesPaintTags,Projector3D>

Parameters:

valType - data value column

Returns:

maximum value needed

getMinValue

public java.lang.Object getMinValue(DataColumnType valType)

Description copied from class: AbstractChartSeries

Note: internal use only! Gets minimum value that is used by series to fit into the chart

Specified by:

getMinValue in class AbstractChartSeries<SeriesPaintTags,Projector3D>

Parameters:

valType - data value column

Returns:

minimum value needed