Class CandlestickRenderer
- All Implemented Interfaces:
Serializable,Cloneable,EventListener,AnnotationChangeListener,LegendItemSource,XYItemRenderer,PublicCloneable
XYPlot (requires a
OHLCDataset). The example shown here is generated
by the CandlestickChartDemo1.java program included in the
JFreeChart demo collection:
This renderer does not include code to calculate the crosshair point for the plot.
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate doubleThe number (generally between 0.0 and 1.0) by which the available space automatically calculated for the candles will be multiplied to determine the actual width to use.private doubleThe minimum gap between one candle and the nextprivate intThe method of automatically calculating the candle width.private doubleThe candle width.private PaintThe paint used to fill the candle when the price moved down from open to close.private booleanA flag controlling whether or not volume bars are drawn on the chart.private doubleTemporary storage for the maximum candle width.private doubleThe maximum candlewidth in milliseconds.private doubleTemporary storage for the maximum volume.private static final longFor serialization.private PaintThe paint used to fill the candle when the price moved up from open to close.private booleanA flag that controls whether or not the renderer's outline paint is used to draw the outline of the candlestick.private PaintThe paint used to fill the volume bars (if they are visible).static final intThe average width method.static final intThe interval data method.static final intThe smallest width method.Fields inherited from class org.jfree.chart.renderer.AbstractRenderer
DEFAULT_ITEM_LABEL_INSETS, DEFAULT_OUTLINE_PAINT, DEFAULT_OUTLINE_STROKE, DEFAULT_PAINT, DEFAULT_SHAPE, DEFAULT_STROKE, DEFAULT_VALUE_LABEL_FONT, DEFAULT_VALUE_LABEL_PAINT, ZERO -
Constructor Summary
ConstructorsConstructorDescriptionCreates a new renderer for candlestick charts.CandlestickRenderer(double candleWidth) Creates a new renderer for candlestick charts.CandlestickRenderer(double candleWidth, boolean drawVolume, XYToolTipGenerator toolTipGenerator) Creates a new renderer for candlestick charts. -
Method Summary
Modifier and TypeMethodDescriptionclone()Returns a clone of the renderer.voiddrawItem(Graphics2D g2, XYItemRendererState state, Rectangle2D dataArea, PlotRenderingInfo info, XYPlot plot, ValueAxis domainAxis, ValueAxis rangeAxis, XYDataset dataset, int series, int item, CrosshairState crosshairState, int pass) Draws the visual representation of a single data item.booleanTests this renderer for equality with another object.findRangeBounds(XYDataset dataset) Returns the range of values the renderer requires to display all the items from the specified dataset.doubleReturns the factor by which the available space automatically calculated for the candles will be multiplied to determine the actual width to use.doubleReturns the amount of space to leave on the left and right of each candle when automatically calculating widths.intReturns the method of automatically calculating the candle width.doubleReturns the width of each candle.Returns the paint used to fill candles when the price moves down from open to close.booleanReturns a flag indicating whether or not volume bars are drawn on the chart.doubleReturns the maximum width (in milliseconds) of each candle.Returns the paint used to fill candles when the price moves up from open to close.booleanReturns the flag that controls whether or not the renderer's outline paint is used to draw the candlestick outline.Returns the paint that is used to fill the volume bars if they are visible.initialise(Graphics2D g2, Rectangle2D dataArea, XYPlot plot, XYDataset dataset, PlotRenderingInfo info) Initialises the renderer then returns the number of 'passes' through the data that the renderer will require (usually just one).private voidreadObject(ObjectInputStream stream) Provides serialization support.voidsetAutoWidthFactor(double autoWidthFactor) Sets the factor by which the available space automatically calculated for the candles will be multiplied to determine the actual width to use.voidsetAutoWidthGap(double autoWidthGap) Sets the amount of space to leave on the left and right of each candle when automatically calculating widths and sends aRendererChangeEventto all registered listeners.voidsetAutoWidthMethod(int autoWidthMethod) Sets the method of automatically calculating the candle width and sends aRendererChangeEventto all registered listeners.voidsetCandleWidth(double width) Sets the candle width and sends aRendererChangeEventto all registered listeners.voidsetDownPaint(Paint paint) Sets the paint used to fill candles when the price moves down from open to close and sends aRendererChangeEventto all registered listeners.voidsetDrawVolume(boolean flag) Sets a flag that controls whether or not volume bars are drawn in the background and sends aRendererChangeEventto all registered listeners.voidsetMaxCandleWidthInMilliseconds(double millis) Sets the maximum candle width (in milliseconds) and sends aRendererChangeEventto all registered listeners.voidsetUpPaint(Paint paint) Sets the paint used to fill candles when the price moves up from open to close and sends aRendererChangeEventto all registered listeners.voidsetUseOutlinePaint(boolean use) Sets the flag that controls whether or not the renderer's outline paint is used to draw the candlestick outline, and sends aRendererChangeEventto all registered listeners.voidsetVolumePaint(Paint paint) Sets the paint used to fill the volume bars, and sends aRendererChangeEventto all registered listeners.private voidwriteObject(ObjectOutputStream stream) Provides serialization support.Methods inherited from class org.jfree.chart.renderer.xy.AbstractXYItemRenderer
addAnnotation, addAnnotation, addEntity, annotationChanged, beginElementGroup, calculateDomainMarkerTextAnchorPoint, drawAnnotations, drawDomainLine, drawDomainMarker, drawItemLabel, drawRangeLine, drawRangeMarker, fillDomainGridBand, fillRangeGridBand, findDomainBounds, findDomainBounds, findRangeBounds, getAnnotations, getDefaultItemLabelGenerator, getDefaultToolTipGenerator, getDrawingSupplier, getItemLabelGenerator, getLegendItem, getLegendItemLabelGenerator, getLegendItems, getLegendItemToolTipGenerator, getLegendItemURLGenerator, getPassCount, getPlot, getSeriesItemLabelGenerator, getSeriesToolTipGenerator, getToolTipGenerator, getURLGenerator, hashCode, lineTo, moveTo, removeAnnotation, removeAnnotations, setDefaultItemLabelGenerator, setDefaultToolTipGenerator, setLegendItemLabelGenerator, setLegendItemToolTipGenerator, setLegendItemURLGenerator, setPlot, setSeriesItemLabelGenerator, setSeriesToolTipGenerator, setURLGenerator, updateCrosshairValuesMethods inherited from class org.jfree.chart.renderer.AbstractRenderer
addChangeListener, beginElementGroup, calculateLabelAnchorPoint, clearSeriesPaints, clearSeriesStrokes, endElementGroup, fireChangeEvent, getAutoPopulateSeriesFillPaint, getAutoPopulateSeriesOutlinePaint, getAutoPopulateSeriesOutlineStroke, getAutoPopulateSeriesPaint, getAutoPopulateSeriesShape, getAutoPopulateSeriesStroke, getDataBoundsIncludesVisibleSeriesOnly, getDefaultCreateEntities, getDefaultEntityRadius, getDefaultFillPaint, getDefaultItemLabelFont, getDefaultItemLabelPaint, getDefaultItemLabelsVisible, getDefaultLegendShape, getDefaultLegendTextFont, getDefaultLegendTextPaint, getDefaultNegativeItemLabelPosition, getDefaultOutlinePaint, getDefaultOutlineStroke, getDefaultPaint, getDefaultPositiveItemLabelPosition, getDefaultSeriesVisible, getDefaultSeriesVisibleInLegend, getDefaultShape, getDefaultStroke, getItemCreateEntity, getItemFillPaint, getItemLabelAnchorOffset, getItemLabelFont, getItemLabelInsets, getItemLabelPaint, getItemOutlinePaint, getItemOutlineStroke, getItemPaint, getItemShape, getItemStroke, getItemVisible, getLegendShape, getLegendTextFont, getLegendTextPaint, getNegativeItemLabelPosition, getPositiveItemLabelPosition, getSeriesCreateEntities, getSeriesFillPaint, getSeriesItemLabelFont, getSeriesItemLabelPaint, getSeriesNegativeItemLabelPosition, getSeriesOutlinePaint, getSeriesOutlineStroke, getSeriesPaint, getSeriesPositiveItemLabelPosition, getSeriesShape, getSeriesStroke, getSeriesVisible, getSeriesVisibleInLegend, getTreatLegendShapeAsLine, hasListener, isComputeItemLabelContrastColor, isItemLabelVisible, isSeriesItemLabelsVisible, isSeriesVisible, isSeriesVisibleInLegend, lookupLegendShape, lookupLegendTextFont, lookupLegendTextPaint, lookupSeriesFillPaint, lookupSeriesOutlinePaint, lookupSeriesOutlineStroke, lookupSeriesPaint, lookupSeriesShape, lookupSeriesStroke, notifyListeners, removeChangeListener, setAutoPopulateSeriesFillPaint, setAutoPopulateSeriesOutlinePaint, setAutoPopulateSeriesOutlineStroke, setAutoPopulateSeriesPaint, setAutoPopulateSeriesShape, setAutoPopulateSeriesStroke, setComputeItemLabelContrastColor, setDataBoundsIncludesVisibleSeriesOnly, setDefaultCreateEntities, setDefaultCreateEntities, setDefaultEntityRadius, setDefaultFillPaint, setDefaultFillPaint, setDefaultItemLabelFont, setDefaultItemLabelFont, setDefaultItemLabelPaint, setDefaultItemLabelPaint, setDefaultItemLabelsVisible, setDefaultItemLabelsVisible, setDefaultLegendShape, setDefaultLegendTextFont, setDefaultLegendTextPaint, setDefaultNegativeItemLabelPosition, setDefaultNegativeItemLabelPosition, setDefaultOutlinePaint, setDefaultOutlinePaint, setDefaultOutlineStroke, setDefaultOutlineStroke, setDefaultPaint, setDefaultPaint, setDefaultPositiveItemLabelPosition, setDefaultPositiveItemLabelPosition, setDefaultSeriesVisible, setDefaultSeriesVisible, setDefaultSeriesVisibleInLegend, setDefaultSeriesVisibleInLegend, setDefaultShape, setDefaultShape, setDefaultStroke, setDefaultStroke, setItemLabelAnchorOffset, setItemLabelInsets, setLegendShape, setLegendTextFont, setLegendTextPaint, setSeriesCreateEntities, setSeriesCreateEntities, setSeriesFillPaint, setSeriesFillPaint, setSeriesItemLabelFont, setSeriesItemLabelFont, setSeriesItemLabelPaint, setSeriesItemLabelPaint, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesNegativeItemLabelPosition, setSeriesNegativeItemLabelPosition, setSeriesOutlinePaint, setSeriesOutlinePaint, setSeriesOutlineStroke, setSeriesOutlineStroke, setSeriesPaint, setSeriesPaint, setSeriesPositiveItemLabelPosition, setSeriesPositiveItemLabelPosition, setSeriesShape, setSeriesShape, setSeriesStroke, setSeriesStroke, setSeriesVisible, setSeriesVisible, setSeriesVisibleInLegend, setSeriesVisibleInLegend, setTreatLegendShapeAsLineMethods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.jfree.chart.LegendItemSource
getLegendItemsMethods inherited from interface org.jfree.chart.renderer.xy.XYItemRenderer
addAnnotation, addAnnotation, addChangeListener, drawAnnotations, drawDomainLine, drawDomainMarker, drawRangeLine, drawRangeMarker, fillDomainGridBand, fillRangeGridBand, findDomainBounds, getDefaultCreateEntities, getDefaultFillPaint, getDefaultItemLabelFont, getDefaultItemLabelGenerator, getDefaultItemLabelPaint, getDefaultItemLabelsVisible, getDefaultNegativeItemLabelPosition, getDefaultOutlinePaint, getDefaultOutlineStroke, getDefaultPaint, getDefaultPositiveItemLabelPosition, getDefaultSeriesVisible, getDefaultSeriesVisibleInLegend, getDefaultShape, getDefaultStroke, getDefaultToolTipGenerator, getItemCreateEntity, getItemFillPaint, getItemLabelFont, getItemLabelGenerator, getItemLabelPaint, getItemOutlinePaint, getItemOutlineStroke, getItemPaint, getItemShape, getItemStroke, getItemVisible, getLegendItem, getLegendItemLabelGenerator, getNegativeItemLabelPosition, getPassCount, getPlot, getPositiveItemLabelPosition, getSeriesCreateEntities, getSeriesFillPaint, getSeriesItemLabelFont, getSeriesItemLabelGenerator, getSeriesItemLabelPaint, getSeriesNegativeItemLabelPosition, getSeriesOutlinePaint, getSeriesOutlineStroke, getSeriesPaint, getSeriesPositiveItemLabelPosition, getSeriesShape, getSeriesStroke, getSeriesToolTipGenerator, getSeriesVisible, getSeriesVisibleInLegend, getToolTipGenerator, getURLGenerator, isItemLabelVisible, isSeriesItemLabelsVisible, isSeriesVisible, isSeriesVisibleInLegend, removeAnnotation, removeAnnotations, removeChangeListener, setDefaultCreateEntities, setDefaultCreateEntities, setDefaultFillPaint, setDefaultFillPaint, setDefaultItemLabelFont, setDefaultItemLabelGenerator, setDefaultItemLabelPaint, setDefaultItemLabelsVisible, setDefaultItemLabelsVisible, setDefaultNegativeItemLabelPosition, setDefaultNegativeItemLabelPosition, setDefaultOutlinePaint, setDefaultOutlinePaint, setDefaultOutlineStroke, setDefaultOutlineStroke, setDefaultPaint, setDefaultPaint, setDefaultPositiveItemLabelPosition, setDefaultPositiveItemLabelPosition, setDefaultSeriesVisible, setDefaultSeriesVisible, setDefaultSeriesVisibleInLegend, setDefaultSeriesVisibleInLegend, setDefaultShape, setDefaultShape, setDefaultStroke, setDefaultStroke, setDefaultToolTipGenerator, setLegendItemLabelGenerator, setPlot, setSeriesCreateEntities, setSeriesCreateEntities, setSeriesFillPaint, setSeriesFillPaint, setSeriesItemLabelFont, setSeriesItemLabelGenerator, setSeriesItemLabelPaint, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesNegativeItemLabelPosition, setSeriesNegativeItemLabelPosition, setSeriesOutlinePaint, setSeriesOutlinePaint, setSeriesOutlineStroke, setSeriesOutlineStroke, setSeriesPaint, setSeriesPaint, setSeriesPositiveItemLabelPosition, setSeriesPositiveItemLabelPosition, setSeriesShape, setSeriesShape, setSeriesStroke, setSeriesStroke, setSeriesToolTipGenerator, setSeriesVisible, setSeriesVisible, setSeriesVisibleInLegend, setSeriesVisibleInLegend, setURLGenerator
-
Field Details
-
serialVersionUID
private static final long serialVersionUIDFor serialization.- See Also:
-
WIDTHMETHOD_AVERAGE
public static final int WIDTHMETHOD_AVERAGEThe average width method.- See Also:
-
WIDTHMETHOD_SMALLEST
public static final int WIDTHMETHOD_SMALLESTThe smallest width method.- See Also:
-
WIDTHMETHOD_INTERVALDATA
public static final int WIDTHMETHOD_INTERVALDATAThe interval data method.- See Also:
-
autoWidthMethod
private int autoWidthMethodThe method of automatically calculating the candle width. -
autoWidthFactor
private double autoWidthFactorThe number (generally between 0.0 and 1.0) by which the available space automatically calculated for the candles will be multiplied to determine the actual width to use. -
autoWidthGap
private double autoWidthGapThe minimum gap between one candle and the next -
candleWidth
private double candleWidthThe candle width. -
maxCandleWidthInMilliseconds
private double maxCandleWidthInMillisecondsThe maximum candlewidth in milliseconds. -
maxCandleWidth
private double maxCandleWidthTemporary storage for the maximum candle width. -
upPaint
The paint used to fill the candle when the price moved up from open to close. -
downPaint
The paint used to fill the candle when the price moved down from open to close. -
drawVolume
private boolean drawVolumeA flag controlling whether or not volume bars are drawn on the chart. -
volumePaint
The paint used to fill the volume bars (if they are visible). Once initialised, this field should never be set tonull. -
maxVolume
private transient double maxVolumeTemporary storage for the maximum volume. -
useOutlinePaint
private boolean useOutlinePaintA flag that controls whether or not the renderer's outline paint is used to draw the outline of the candlestick. The default value isfalseto avoid a change of behaviour for existing code.
-
-
Constructor Details
-
CandlestickRenderer
public CandlestickRenderer()Creates a new renderer for candlestick charts. -
CandlestickRenderer
public CandlestickRenderer(double candleWidth) Creates a new renderer for candlestick charts.Use -1 for the candle width if you prefer the width to be calculated automatically.
- Parameters:
candleWidth- The candle width.
-
CandlestickRenderer
public CandlestickRenderer(double candleWidth, boolean drawVolume, XYToolTipGenerator toolTipGenerator) Creates a new renderer for candlestick charts.Use -1 for the candle width if you prefer the width to be calculated automatically.
- Parameters:
candleWidth- the candle width.drawVolume- a flag indicating whether or not volume bars should be drawn.toolTipGenerator- the tool tip generator.nullis none.
-
-
Method Details
-
getCandleWidth
public double getCandleWidth()Returns the width of each candle.- Returns:
- The candle width.
- See Also:
-
setCandleWidth
public void setCandleWidth(double width) Sets the candle width and sends aRendererChangeEventto all registered listeners.If you set the width to a negative value, the renderer will calculate the candle width automatically based on the space available on the chart.
- Parameters:
width- The width.- See Also:
-
getMaxCandleWidthInMilliseconds
public double getMaxCandleWidthInMilliseconds()Returns the maximum width (in milliseconds) of each candle.- Returns:
- The maximum candle width in milliseconds.
- See Also:
-
setMaxCandleWidthInMilliseconds
public void setMaxCandleWidthInMilliseconds(double millis) Sets the maximum candle width (in milliseconds) and sends aRendererChangeEventto all registered listeners.- Parameters:
millis- The maximum width.- See Also:
-
getAutoWidthMethod
public int getAutoWidthMethod()Returns the method of automatically calculating the candle width.- Returns:
- The method of automatically calculating the candle width.
- See Also:
-
setAutoWidthMethod
public void setAutoWidthMethod(int autoWidthMethod) Sets the method of automatically calculating the candle width and sends aRendererChangeEventto all registered listeners.WIDTHMETHOD_AVERAGE: Divides the entire display (ignoring scale factor) by the number of items, and uses this as the available width.
WIDTHMETHOD_SMALLEST: Checks the interval between each item, and uses the smallest as the available width.
WIDTHMETHOD_INTERVALDATA: Assumes that the dataset supports the IntervalXYDataset interface, and uses the startXValue - endXValue as the available width.- Parameters:
autoWidthMethod- The method of automatically calculating the candle width.- See Also:
-
getAutoWidthFactor
public double getAutoWidthFactor()Returns the factor by which the available space automatically calculated for the candles will be multiplied to determine the actual width to use.- Returns:
- The width factor (generally between 0.0 and 1.0).
- See Also:
-
setAutoWidthFactor
public void setAutoWidthFactor(double autoWidthFactor) Sets the factor by which the available space automatically calculated for the candles will be multiplied to determine the actual width to use.- Parameters:
autoWidthFactor- The width factor (generally between 0.0 and 1.0).- See Also:
-
getAutoWidthGap
public double getAutoWidthGap()Returns the amount of space to leave on the left and right of each candle when automatically calculating widths.- Returns:
- The gap.
- See Also:
-
setAutoWidthGap
public void setAutoWidthGap(double autoWidthGap) Sets the amount of space to leave on the left and right of each candle when automatically calculating widths and sends aRendererChangeEventto all registered listeners.- Parameters:
autoWidthGap- The gap.- See Also:
-
getUpPaint
Returns the paint used to fill candles when the price moves up from open to close.- Returns:
- The paint (possibly
null). - See Also:
-
setUpPaint
Sets the paint used to fill candles when the price moves up from open to close and sends aRendererChangeEventto all registered listeners.- Parameters:
paint- the paint (nullpermitted).- See Also:
-
getDownPaint
Returns the paint used to fill candles when the price moves down from open to close.- Returns:
- The paint (possibly
null). - See Also:
-
setDownPaint
Sets the paint used to fill candles when the price moves down from open to close and sends aRendererChangeEventto all registered listeners.- Parameters:
paint- The paint (nullpermitted).
-
getDrawVolume
public boolean getDrawVolume()Returns a flag indicating whether or not volume bars are drawn on the chart.- Returns:
- A boolean.
- See Also:
-
setDrawVolume
public void setDrawVolume(boolean flag) Sets a flag that controls whether or not volume bars are drawn in the background and sends aRendererChangeEventto all registered listeners.- Parameters:
flag- the flag.- See Also:
-
getVolumePaint
Returns the paint that is used to fill the volume bars if they are visible.- Returns:
- The paint (never
null). - See Also:
-
setVolumePaint
Sets the paint used to fill the volume bars, and sends aRendererChangeEventto all registered listeners.- Parameters:
paint- the paint (nullnot permitted).- See Also:
-
getUseOutlinePaint
public boolean getUseOutlinePaint()Returns the flag that controls whether or not the renderer's outline paint is used to draw the candlestick outline. The default value isfalse.- Returns:
- A boolean.
- See Also:
-
setUseOutlinePaint
public void setUseOutlinePaint(boolean use) Sets the flag that controls whether or not the renderer's outline paint is used to draw the candlestick outline, and sends aRendererChangeEventto all registered listeners.- Parameters:
use- the new flag value.- See Also:
-
findRangeBounds
Returns the range of values the renderer requires to display all the items from the specified dataset.- Specified by:
findRangeBoundsin interfaceXYItemRenderer- Overrides:
findRangeBoundsin classAbstractXYItemRenderer- Parameters:
dataset- the dataset (nullpermitted).- Returns:
- The range (
nullif the dataset isnullor empty). - See Also:
-
initialise
public XYItemRendererState initialise(Graphics2D g2, Rectangle2D dataArea, XYPlot plot, XYDataset dataset, PlotRenderingInfo info) Initialises the renderer then returns the number of 'passes' through the data that the renderer will require (usually just one). This method will be called before the first item is rendered, giving the renderer an opportunity to initialise any state information it wants to maintain. The renderer can do nothing if it chooses.- Specified by:
initialisein interfaceXYItemRenderer- Overrides:
initialisein classAbstractXYItemRenderer- Parameters:
g2- the graphics device.dataArea- the area inside the axes.plot- the plot.dataset- the data.info- an optional info collection object to return data back to the caller.- Returns:
- The number of passes the renderer requires.
-
drawItem
public void drawItem(Graphics2D g2, XYItemRendererState state, Rectangle2D dataArea, PlotRenderingInfo info, XYPlot plot, ValueAxis domainAxis, ValueAxis rangeAxis, XYDataset dataset, int series, int item, CrosshairState crosshairState, int pass) Draws the visual representation of a single data item.- Specified by:
drawItemin interfaceXYItemRenderer- Parameters:
g2- the graphics device.state- the renderer state.dataArea- the area within which the plot is being drawn.info- collects info about the drawing.plot- the plot (can be used to obtain standard color information etc).domainAxis- the domain axis.rangeAxis- the range axis.dataset- the dataset.series- the series index (zero-based).item- the item index (zero-based).crosshairState- crosshair information for the plot (nullpermitted).pass- the pass index.
-
equals
Tests this renderer for equality with another object.- Overrides:
equalsin classAbstractXYItemRenderer- Parameters:
obj- the object (nullpermitted).- Returns:
trueorfalse.
-
clone
Returns a clone of the renderer.- Specified by:
clonein interfacePublicCloneable- Overrides:
clonein classAbstractXYItemRenderer- Returns:
- A clone.
- Throws:
CloneNotSupportedException- if the renderer cannot be cloned.
-
writeObject
Provides serialization support.- Parameters:
stream- the output stream.- Throws:
IOException- if there is an I/O error.
-
readObject
Provides serialization support.- Parameters:
stream- the input stream.- Throws:
IOException- if there is an I/O error.ClassNotFoundException- if there is a classpath problem.
-