Class ChartSeriesRenderer

Base class for all renderers. Each renderer is responsible for rendering one data series (please refer to ChartSeries) inside of the chart area. ChartSeriesRenderer provides the basic plumbing that is needed by all renderers. It is not an abstract class. It is used as the renderer for the scatter plot since the scatter plot needs only basic point rendering at the correct position.

You can derive from ChartSeriesRenderer to create your own renderers.

Inheritance

System.Object

ChartSeriesRenderer

Inherited Members

System.Object.ToString()

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

Namespace: Syncfusion.Windows.Forms.Chart

Assembly: Syncfusion.Chart.Base.dll

Syntax

public class ChartSeriesRenderer

Constructors

ChartSeriesRenderer(ChartSeries)

Initializes a new instance of the ChartSeriesRenderer class.

Declaration

public ChartSeriesRenderer(ChartSeries series)

Parameters

Type	Name	Description
ChartSeries	series	ChartSeries that will be rendered by this renderer instance.

Fields

m_segments

Internal member.

Declaration

protected ChartSegment[] m_segments

Field Value

Type	Description
ChartSegment[]

m_series

The owner series.

Declaration

protected ChartSeries m_series

Field Value

Type	Description
ChartSeries

m_serStyle

The series style.

Declaration

protected ChartStyleInfo m_serStyle

Field Value

Type	Description
ChartStyleInfo

POLYGON_SECTORS

The number of polygons of cylinder

Declaration

protected int POLYGON_SECTORS

Field Value

Type	Description
System.Int32

SPLINE_DIGITIZATION

The number of polygons of spline

Declaration

protected int SPLINE_DIGITIZATION

Field Value

Type	Description
System.Int32

Properties

Bounds

Returns the bounds that this renderer operates in.

Declaration

protected RectangleF Bounds { get; }

Property Value

Type	Description
System.Drawing.RectangleF

Center

Gets the center of Bounds.

Declaration

protected PointF Center { get; }

Property Value

Type	Description
System.Drawing.PointF	The center.

Chart

Reference to the IChartAreaHost instance that uses this instance.

Declaration

protected IChartAreaHost Chart { get; }

Property Value

Type	Description
IChartAreaHost

ChartArea

Reference to the ChartArea instance that uses this instance.

Declaration

protected IChartArea ChartArea { get; }

Property Value

Type	Description
IChartArea

CustomOriginX

Returns the X coordinate of the origin. This property will return the correct coordinate even if the X axis has a custom origin.

Declaration

protected virtual float CustomOriginX { get; }

Property Value

Type	Description
System.Single

CustomOriginY

Returns the Y coordinate of the origin. This property will return the correct coordinate even if the Y axis has a custom origin.

Declaration

protected virtual float CustomOriginY { get; }

Property Value

Type	Description
System.Single

DividedIntervalSpace

Calculates and returns the number of display units that are used per logical(value) unit.

Declaration

public SizeF DividedIntervalSpace { get; }

Property Value

Type	Description
System.Drawing.SizeF

EnableStyles

Duplicates the EnableStyles property.

Declaration

protected bool EnableStyles { get; }

Property Value

Type	Description
System.Boolean

FillSpaceType

Indicates how much space this type will use.

Declaration

public virtual ChartUsedSpaceType FillSpaceType { get; }

Property Value

Type	Description
ChartUsedSpaceType

IgnoreSeriesInversion

This setting allows chart types that are normally not rendered inverted to be combined with those that are normally rendered inverted. For example Bar charts are rendered inverted. The Bubble chart can be combined with Bar charts because it sets IgnoreSeriesInversion to true. When this property is set to true the renderer will ignore the inversion setting on the series being rendered.

Declaration

protected virtual bool IgnoreSeriesInversion { get; }

Property Value

Type	Description
System.Boolean

IntervalSpace

Computes and returns the space occupied by each interval on the series being rendered.

Declaration

public virtual SizeF IntervalSpace { get; }

Property Value

Type	Description
System.Drawing.SizeF

IsInvertedAxes

True if axes is inverted.

Declaration

protected virtual bool IsInvertedAxes { get; }

Property Value

Type	Description
System.Boolean

IsRadial

True if series using the radial axes.

Declaration

protected virtual bool IsRadial { get; }

Property Value

Type	Description
System.Boolean

OriginLocation

The location of the origin as used for rendering.

Declaration

protected virtual PointF OriginLocation { get; }

Property Value

Type	Description
System.Drawing.PointF

Place

Number of layer for specified series.

Declaration

public int Place { get; set; }

Property Value

Type	Description
System.Int32

PlaceSize

Count of the chart layers.

Declaration

public int PlaceSize { get; set; }

Property Value

Type	Description
System.Int32

RegionDescription

Get description of regions.

Declaration

protected virtual string RegionDescription { get; }

Property Value

Type	Description
System.String

RequireYValuesCount

Gets count of require Y values of the points.

Declaration

protected virtual int RequireYValuesCount { get; }

Property Value

Type	Description
System.Int32

ShouldSort

Gets a value indicating whether points should be sort.

Declaration

protected virtual bool ShouldSort { get; }

Property Value

Type	Description
System.Boolean	true if points should be sorted; otherwise, false.

StyledPoints

Retruns all Styled Point Collection.

Declaration

protected ChartSeriesRenderer.ChartStyledPoint[] StyledPoints { get; set; }

Property Value

Type	Description
ChartSeriesRenderer.ChartStyledPoint[]

UnEmptyRanges

Computes the array of IndexRange, using for indicating unempty points.

Declaration

protected IndexRange[] UnEmptyRanges { get; }

Property Value

Type	Description
IndexRange[]

XAxis

Returns the X axis object that the current renderer is tied to. ChartAxis

Declaration

protected ChartAxis XAxis { get; }

Property Value

Type	Description
ChartAxis

YAxis

Returns the Y axis object that the current renderer is tied to. ChartAxis

Declaration

protected ChartAxis YAxis { get; }

Property Value

Type	Description
ChartAxis

Methods

AddExtremumPoints(ChartPointWithIndex[], Double[], out ChartPointWithIndex[], out Double[])

Adds all extremum points to new arrays. This method is needed to imitate 3D Spline strip.

Declaration

protected void AddExtremumPoints(ChartPointWithIndex[] points, double[] y2, out ChartPointWithIndex[] pointsNew, out double[] y2New)

Parameters

Type	Name	Description
ChartPointWithIndex[]	points
System.Double[]	y2
ChartPointWithIndex[]	pointsNew
System.Double[]	y2New

AddSymbolRegion(ChartSeriesRenderer.ChartStyledPoint)

Adds the symbol region by the specified point index.

Declaration

protected virtual void AddSymbolRegion(ChartSeriesRenderer.ChartStyledPoint styledPoint)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint	styledPoint	The associated point.

BezierPointsFromSpline(ChartPointWithIndex, ChartPointWithIndex, Double, Double, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex)

Gets bezier curve points from cubic spline curve defined by two points and two second derivative y2 at this points.

Declaration

protected void BezierPointsFromSpline(ChartPointWithIndex point1, ChartPointWithIndex point2, double y2_1, double y2_2, out ChartPointWithIndex p0, out ChartPointWithIndex p1, out ChartPointWithIndex p2, out ChartPointWithIndex p3)

Parameters

Type	Name	Description
ChartPointWithIndex	point1	Start of spline curve
ChartPointWithIndex	point2	End of spline curve
System.Double	y2_1	Second y derivative x at start point
System.Double	y2_2	Second y derivative x at end point
ChartPointWithIndex	p0	First Bezier curve point
ChartPointWithIndex	p1	Second Bezier curve point
ChartPointWithIndex	p2	Third Bezier curve point
ChartPointWithIndex	p3	Fourth Bezier curve point

BezierPointsFromSpline(PointF, PointF, Single, Single, out PointF, out PointF, out PointF, out PointF)

Gets bezier curve points from cubic spline curve defined by two points and two second derivative y2 at this points.

Declaration

protected void BezierPointsFromSpline(PointF point1, PointF point2, float y2_1, float y2_2, out PointF p0, out PointF p1, out PointF p2, out PointF p3)

Parameters

Type	Name	Description
System.Drawing.PointF	point1	Start of spline curve
System.Drawing.PointF	point2	End of spline curve
System.Single	y2_1	Second y derivative x at start point
System.Single	y2_2	Second y derivative x at end point
System.Drawing.PointF	p0	First Bezier curve point
System.Drawing.PointF	p1	Second Bezier curve point
System.Drawing.PointF	p2	Third Bezier curve point
System.Drawing.PointF	p3	Fourth Bezier curve point

CalCachePoints()

calculates the points to draw when huge data source binded to chart for improving the performance.

Declaration

public List<int> CalCachePoints()

Returns

Type	Description
System.Collections.Generic.List<System.Int32>

CalculateStepPointsForSeries3D(ref PointF[])

Overloaded. Calculates step point's offsets in derived classes to draw correctly series with close or same values. This method is needed only in cases when series are rendered in 3D mode. It fixes problems with overlapped series.

Declaration

protected virtual void CalculateStepPointsForSeries3D(ref PointF[] stepPoints)

Parameters

Type	Name	Description
System.Drawing.PointF[]	stepPoints

CalculateStepPointsForSeries3D(ref PointF[], SizeF)

Calculates step point's offsets in derived classes to draw correctly series with close or same values. This method is needed only in cases when series are rendered in 3D mode. It fixes problems with overlapped series.

Declaration

protected virtual void CalculateStepPointsForSeries3D(ref PointF[] stepPoints, SizeF offset)

Parameters

Type	Name	Description
System.Drawing.PointF[]	stepPoints
System.Drawing.SizeF	offset

CalculateUnEmptyRanges(IndexRange)

Computes the array of IndexRange, using for indicating unempty points.

Declaration

protected IndexRange[] CalculateUnEmptyRanges(IndexRange vrange)

Parameters

Type	Name	Description
IndexRange	vrange	The visible range of points.

Returns

Type	Description
IndexRange[]

CalculateVisibleRange()

Calculate the visible indices of points for rendering.

Declaration

protected IndexRange CalculateVisibleRange()

Returns

Type	Description
IndexRange

canonicalSpline(ChartPointWithIndex[], Double, Boolean, out ChartPointWithIndex[], out ChartPointWithIndex[])

Given the array of points. The procedure will fit the canonical spline curve to pass through all the points. Note: The curve will not be "function" line. There can be few Y values for one X value;

Declaration

protected void canonicalSpline(ChartPointWithIndex[] points, double tension, bool addextremumpoints, out ChartPointWithIndex[] bpoints, out ChartPointWithIndex[] bextrpoints)

Parameters

Type	Name	Description
ChartPointWithIndex[]	points
System.Double	tension	Canonical spline tension
System.Boolean	addextremumpoints
ChartPointWithIndex[]	bpoints	Bezier points array. The length of this array is 4n, where n is number of intervals (number of points - 1)
ChartPointWithIndex[]	bextrpoints

CanRender()

Checks the count of values for rendering.

Declaration

public virtual bool CanRender()

Returns

Type	Description
System.Boolean	True if renderer can to render the series.

CreateBoundsPolygon(Single)

Creates the space separator.

Declaration

protected Polygon CreateBoundsPolygon(float z)

Parameters

Type	Name	Description
System.Single	z	The Z coordinate.

Returns

Type	Description
Polygon

CreateBox(RectangleF, Boolean)

Creates System.Drawing.Drawing2D.GraphicsPath that represent box.

Declaration

protected virtual GraphicsPath CreateBox(RectangleF rect, bool is3D)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the box.
System.Boolean	is3D	The value indicates that box is in 3D.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath	System.Drawing.Drawing2D.GraphicsPath that represent box.

CreateBoxRight(RectangleF, Boolean)

Creates System.Drawing.Drawing2D.GraphicsPath that represent box.

Declaration

protected virtual GraphicsPath CreateBoxRight(RectangleF rect, bool is3D)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the box.
System.Boolean	is3D	The value indicates that box is in 3D.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath	System.Drawing.Drawing2D.GraphicsPath that represent box.

CreateBoxTop(RectangleF, Boolean)

Creates System.Drawing.Drawing2D.GraphicsPath that represent box.

Declaration

protected virtual GraphicsPath CreateBoxTop(RectangleF rect, bool is3D)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the box.
System.Boolean	is3D	The value indicates that box is in 3D.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath	System.Drawing.Drawing2D.GraphicsPath that represent box.

CreateHorizintalCylinder3D(RectangleF, SizeF)

Creates the horizontal cylinder 3D geometry.

Declaration

protected GraphicsPath CreateHorizintalCylinder3D(RectangleF rect, SizeF offset)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the cylinder.
System.Drawing.SizeF	offset	The offset.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath	System.Drawing.Drawing2D.GraphicsPath that represent cylinder.

CreateHorizintalCylinder3DTop(RectangleF, SizeF)

Creates the horizontal cylinder 3D top geometry.

Declaration

protected GraphicsPath CreateHorizintalCylinder3DTop(RectangleF rect, SizeF offset)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the cylinder.
System.Drawing.SizeF	offset	The offset.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath	System.Drawing.Drawing2D.GraphicsPath that represent cylinder.

CreateStyledPoint(Int32)

Creates the styled point.

Declaration

protected ChartSeriesRenderer.ChartStyledPoint CreateStyledPoint(int index)

Parameters

Type	Name	Description
System.Int32	index	The index.

Returns

Type	Description
ChartSeriesRenderer.ChartStyledPoint

CreateVerticalCylinder3D(RectangleF, SizeF)

Creates the vertical cylinder 3D geometry.

Declaration

protected GraphicsPath CreateVerticalCylinder3D(RectangleF rect, SizeF offset)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the cylinder.
System.Drawing.SizeF	offset	The offset.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath

CreateVerticalCylinder3DTop(RectangleF, SizeF)

Creates the vertical cylinder 3D top geometry.

Declaration

protected GraphicsPath CreateVerticalCylinder3DTop(RectangleF rect, SizeF offset)

Parameters

Type	Name	Description
System.Drawing.RectangleF	rect	The bounds of the cylinder.
System.Drawing.SizeF	offset	The offset.

Returns

Type	Description
System.Drawing.Drawing2D.GraphicsPath

Draw(ChartGraph, GraphicsPath, BrushInfo, Pen)

Draw for given Graphical path.

Declaration

public void Draw(ChartGraph cg, GraphicsPath gp, BrushInfo br, Pen p)

Parameters

Type	Name	Description
ChartGraph	cg	Chart Graph.
System.Drawing.Drawing2D.GraphicsPath	gp	Graphical Path.
BrushInfo	br
System.Drawing.Pen	p	Pen.

Draw3DBeziers(Graphics, PointF[], PointF[], SizeF, BrushInfo, Pen)

Draws beziers curve.

Declaration

protected virtual ArrayList Draw3DBeziers(Graphics g, PointF[] drawpoints, PointF[] fillpoints, SizeF offset, BrushInfo brush, Pen pen)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The System.Drawing.Graphics to render curve.
System.Drawing.PointF[]	drawpoints	The array of System.Drawing.PointF to render curve.
System.Drawing.PointF[]	fillpoints	The array of System.Drawing.PointF to fill.
System.Drawing.SizeF	offset	The curve offset.
BrushInfo	brush	The BrushInfo to fill curve body.
System.Drawing.Pen	pen	The System.Drawing.Pen to render curve border.

Returns

Type	Description
System.Collections.ArrayList	System.Drawing.Region that represent curve.

Draw3DLines(Graphics, PointF[], SizeF, BrushInfo, Pen)

Draw 3D lines.

Declaration

protected virtual Region Draw3DLines(Graphics g, PointF[] points, SizeF offset, BrushInfo brush, Pen pen)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The System.Drawing.Graphics to render lines.
System.Drawing.PointF[]	points	The lines' points.
System.Drawing.SizeF	offset	The offset.
BrushInfo	brush	The BrushInfo to fill lines body.
System.Drawing.Pen	pen	The System.Drawing.Pen to render lines border.

Returns

Type	Description
System.Drawing.Region	System.Drawing.Drawing2D.GraphicsPath that represent lines.

Draw3DLines(Graphics, PointF[], SizeF, BrushInfo, Pen, Color[])

Draw 3D lines.

Declaration

protected virtual Region Draw3DLines(Graphics g, PointF[] points, SizeF offset, BrushInfo brush, Pen pen, Color[] colors)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The System.Drawing.Graphics to render lines.
System.Drawing.PointF[]	points	The lines' points.
System.Drawing.SizeF	offset	The offset.
BrushInfo	brush	The BrushInfo to fill lines body.
System.Drawing.Pen	pen	The System.Drawing.Pen to render lines border.
System.Drawing.Color[]	colors	The array of System.Drawing.Color to draw lines.

Returns

Type	Description
System.Drawing.Region	System.Drawing.Drawing2D.GraphicsPath that represent lines.

Draw3DRectangle(Graphics, RectangleF, SizeF, BrushInfo, Pen)

Helper method to render a 3D rectangle.

Declaration

protected virtual Region Draw3DRectangle(Graphics g, RectangleF rc, SizeF offset, BrushInfo brush, Pen pen)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The graphics object that is to be used for rendering.
System.Drawing.RectangleF	rc	The rectangle that is to be drawn.
System.Drawing.SizeF	offset	The Offset in 3D.
BrushInfo	brush	The brush that is to be used for filling the rectangle sides.
System.Drawing.Pen	pen	The pen that is to be used for drawing the rectangle sides.

Returns

Type	Description
System.Drawing.Region

Draw3DSpline(Graphics, ChartPointWithIndex[], Double[], SizeF, BrushInfo, Pen)

Draws 3D Spline from points array and additionally second derivatives added in y2 array. Remember that second derivatives should be calculated in naturalSpline function and improper y2[] values can cause improper spline drawing.

Declaration

protected virtual Region Draw3DSpline(Graphics g, ChartPointWithIndex[] points, double[] y2, SizeF offset, BrushInfo brush, Pen pen)

Parameters

Type	Name	Description
System.Drawing.Graphics	g
ChartPointWithIndex[]	points
System.Double[]	y2
System.Drawing.SizeF	offset
BrushInfo	brush
System.Drawing.Pen	pen

Returns

Type	Description
System.Drawing.Region

DrawCalloutShapeText(Graphics, ChartSeriesRenderer.ChartStyledPoint, PointF)

Overloaded. Renders text. Performs positioning and delegates to the Syncfusion.Windows.Forms.Chart.RenderingHelper class.

Declaration

protected virtual void DrawCalloutShapeText(Graphics g, ChartSeriesRenderer.ChartStyledPoint styledPoint, PointF pointPos)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Renders text. Performs positioning and delegates to the Syncfusion.Windows.Forms.Chart.RenderingHelper class.
ChartSeriesRenderer.ChartStyledPoint	styledPoint	The associated point.
System.Drawing.PointF	pointPos	Point that is to be used as the anchor.

DrawChartPoint(Graphics, ChartPoint, ChartStyleInfo, Int32)

Draws the specified point in specified style

Declaration

public virtual void DrawChartPoint(Graphics g, ChartPoint point, ChartStyleInfo info, int pointIndex)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Graphics object
ChartPoint	point	Chart Point
ChartStyleInfo	info	Style of the point
System.Int32	pointIndex	index of the point

DrawIcon(Graphics, Rectangle, Boolean, Color)

Draws the icon on the legend.

Declaration

public virtual void DrawIcon(Graphics g, Rectangle bounds, bool isShadow, Color shadowColor)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Instance of System.Drawing.Graphics.
System.Drawing.Rectangle	bounds	Bounds of icon.
System.Boolean	isShadow	If is true method draws the shadow.
System.Drawing.Color	shadowColor	System.Drawing.Color of shadow.

DrawIcon(Int32, Graphics, Rectangle, Boolean, Color)

Draws the icon on the legend.

Declaration

public virtual void DrawIcon(int index, Graphics g, Rectangle bounds, bool isShadow, Color shadowColor)

Parameters

Type	Name	Description
System.Int32	index	Index of point.
System.Drawing.Graphics	g	Instance of System.Drawing.Graphics.
System.Drawing.Rectangle	bounds	Bounds of icon.
System.Boolean	isShadow	If is true method draws the shadow.
System.Drawing.Color	shadowColor	System.Drawing.Color of shadow.

DrawText(Graphics3D, ChartSeriesRenderer.ChartStyledPoint, Vector3D, Size)

Renders text. Performs positioning and delegates to the Syncfusion.Windows.Forms.Chart.RenderingHelper class.

Declaration

protected virtual void DrawText(Graphics3D g, ChartSeriesRenderer.ChartStyledPoint styledPoint, Vector3D p, Size sz)

Parameters

Type	Name	Description
Graphics3D	g	The graphics object that is to be used.
ChartSeriesRenderer.ChartStyledPoint	styledPoint	The associated point.
Vector3D	p	The point that is to be used as anchor.
System.Drawing.Size	sz	The display size of the string.

DrawText(Graphics, ChartSeriesRenderer.ChartStyledPoint, PointF)

Overloaded. Renders text. Performs positioning and delegates to the Syncfusion.Windows.Forms.Chart.RenderingHelper class.

Declaration

protected virtual void DrawText(Graphics g, ChartSeriesRenderer.ChartStyledPoint styledPoint, PointF p)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	Renders text. Performs positioning and delegates to the Syncfusion.Windows.Forms.Chart.RenderingHelper class.
ChartSeriesRenderer.ChartStyledPoint	styledPoint	The associated point.
System.Drawing.PointF	p	Point that is to be used as the anchor.

GetAngleValue(ChartPoint, ChartSeries)

Gets the angle value.

Declaration

protected virtual double GetAngleValue(ChartPoint cp, ChartSeries series)

Parameters

Type	Name	Description
ChartPoint	cp	The cp.
ChartSeries	series	The series.

Returns

Type	Description
System.Double

GetAngleValue(Int32, ChartPoint, ChartSeries)

Gets the angle by X value.

Declaration

protected virtual double GetAngleValue(int index, ChartPoint cp, ChartSeries series)

Parameters

Type	Name	Description
System.Int32	index	The index.
ChartPoint	cp	The cp.
ChartSeries	series	The series.

Returns

Type	Description
System.Double

GetBezierControlPoints(ChartSeriesRenderer.ChartStyledPoint, ChartSeriesRenderer.ChartStyledPoint, Double, Double, out ChartPoint, out ChartPoint, Int32)

Gets the bezier control points.

Declaration

protected void GetBezierControlPoints(ChartSeriesRenderer.ChartStyledPoint point1, ChartSeriesRenderer.ChartStyledPoint point2, double ys1, double ys2, out ChartPoint controlPoint1, out ChartPoint controlPoint2, int yIndex)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint	point1	The point1.
ChartSeriesRenderer.ChartStyledPoint	point2	The point2.
System.Double	ys1	The ys1.
System.Double	ys2	The ys2.
ChartPoint	controlPoint1	The control point1.
ChartPoint	controlPoint2	The control point2.
System.Int32	yIndex	Index of the y.

GetBrush()

Brush information is retrieved from the style associated with the index of the point to be rendered. It is then changed for special cases such as when automatic highlighting is enabled.

Declaration

protected virtual BrushInfo GetBrush()

Returns

Type	Description
BrushInfo	Brush information that is to be used for filling elements displayed at this index.

GetBrush(ChartStyleInfo)

Declaration

protected virtual BrushInfo GetBrush(ChartStyleInfo style)

Parameters

Type	Name	Description
ChartStyleInfo	style

Returns

Type	Description
BrushInfo

GetBrush(Int32)

Brush information is retrieved from the style associated with the index of the point to be rendered. It is then changed for special cases such as when automatic highlighting is enabled.

Declaration

protected virtual BrushInfo GetBrush(int index)

Parameters

Type	Name	Description
System.Int32	index	Index value of the point for which the brush information is required.

Returns

Type	Description
BrushInfo	Brush information that is to be used for filling elements displayed at this index.

GetBrush(Int32, Color)

Brush information is retrieved from the style associated with the index of the point to be rendered. It is then changed for special cases such as when automatic highlighting, series highlighting, symbol highlighting are enabled.

Declaration

protected virtual BrushInfo GetBrush(int index, Color color)

Parameters

Type	Name	Description
System.Int32	index	Index value of the point for which the brush information is required.
System.Drawing.Color	color	The color.

Returns

Type	Description
BrushInfo	Brush information that is to be used for filling elements displayed at this index.

GetCharacterPoint(Int32)

Gets character point by index. Used for symbols and fancy tooltips.

Declaration

public virtual PointF GetCharacterPoint(int index)

Parameters

Type	Name	Description
System.Int32	index	Index of point.

Returns

Type	Description
System.Drawing.PointF

GetDownPriceInterior(BrushInfo)

Returns the down interior for financial chart types.

Declaration

protected virtual BrushInfo GetDownPriceInterior(BrushInfo original)

Parameters

Type	Name	Description
BrushInfo	original	The base interior of chart.

Returns

Type	Description
BrushInfo	The BrushInfo for the down price sectors.

GetFirstX(ChartPointIndexer)

Declaration

protected double GetFirstX(ChartPointIndexer points)

Parameters

Type	Name	Description
ChartPointIndexer	points

Returns

Type	Description
System.Double

GetFirstY(ChartPointIndexer)

Declaration

protected double GetFirstY(ChartPointIndexer points)

Parameters

Type	Name	Description
ChartPointIndexer	points

Returns

Type	Description
System.Double

GetHiLoSymbolCoordinates(Int32)

Gets the symbol coordinate for hilo series

Declaration

protected PointF GetHiLoSymbolCoordinates(int pointIndex)

Parameters

Type	Name	Description
System.Int32	pointIndex	Index of the point

Returns

Type	Description
System.Drawing.PointF	Location of the point at specified index

GetIndexValueFromX(Double)

This function transforms x vales of series points to index vales. Also it populates index hash table.

Declaration

protected virtual double GetIndexValueFromX(double x)

Parameters

Type	Name	Description
System.Double	x	The X value of ChartPoint.

Returns

Type	Description
System.Double

GetLowerAnchorPointValue(Int32)

Calculates the point that is considered to be the low anchor point of a series. This value is used when rendering text below chart point elements.

Declaration

protected virtual float GetLowerAnchorPointValue(int index)

Parameters

Type	Name	Description
System.Int32	index	Index value of the point for which the value is requested.

Returns

Type	Description
System.Single	Calculated value that is to be used as the base anchor point.

GetMinSize(Graphics)

Computes the size of necessary rectangle for the rendering.

Declaration

public virtual SizeF GetMinSize(Graphics g)

Parameters

Type	Name	Description
System.Drawing.Graphics	g

Returns

Type	Description
System.Drawing.SizeF	System.Drawing.SizeF of minimal rectangle.

GetOffsetPoints(PointF[], SizeF)

Clones the points and shifts by offset.

Declaration

protected PointF[] GetOffsetPoints(PointF[] points, SizeF offset)

Parameters

Type	Name	Description
System.Drawing.PointF[]	points
System.Drawing.SizeF	offset

Returns

Type	Description
System.Drawing.PointF[]

GetPath3DFromCircle(Vector3D, Single)

Gets the 3D circle.

Declaration

protected virtual Path3D GetPath3DFromCircle(Vector3D pt, float radius)

Parameters

Type	Name	Description
Vector3D	pt	The center of circle.
System.Single	radius	The radius.

Returns

Type	Description
Path3D

GetPhongInterior(BrushInfo, Color, Double, Double)

Gets the phong interior.

Declaration

protected BrushInfo GetPhongInterior(BrushInfo brushInfo, Color lightColor, double lightAlpha, double phongAlpha)

Parameters

Type	Name	Description
BrushInfo	brushInfo	The base brush info.
System.Drawing.Color	lightColor	Color of the light.
System.Double	lightAlpha	The light alpha.
System.Double	phongAlpha	The phong alpha.

Returns

Type	Description
BrushInfo

GetPlaceDepth()

Gets the depth offset of series.

Declaration

protected virtual float GetPlaceDepth()

Returns

Type	Description
System.Single

GetPointByValueForSeries(ChartPoint)

Gets the point by value for series.

Declaration

[Obsolete("This method isn't used anymore. Use GetCharacterPoint method.")]
public virtual PointF GetPointByValueForSeries(ChartPoint chpt)

Parameters

Type	Name	Description
ChartPoint	chpt	The ChartPoint.

Returns

Type	Description
System.Drawing.PointF	Returns Real Point for the Specified ChartPoint

GetPointFromIndex(Int32)

Given a point index, returns the point to be plotted on the chart.

Declaration

public PointF GetPointFromIndex(int i)

Parameters

Type	Name	Description
System.Int32	i	X index. Y Index is taken as 0.

Returns

Type	Description
System.Drawing.PointF	Point to be plotted.

GetPointFromIndex(Int32, Int32)

Overloaded. Given a point index, returns the point to be plotted on the chart.

Declaration

protected PointF GetPointFromIndex(int i, int j)

Parameters

Type	Name	Description
System.Int32	i	X Index value
System.Int32	j	Y Index value

Returns

Type	Description
System.Drawing.PointF	Point to be plotted

GetPointFromValue(ChartPoint)

Gets the point from value.

Declaration

protected PointF GetPointFromValue(ChartPoint cpt)

Parameters

Type	Name	Description
ChartPoint	cpt	The CPT.

Returns

Type	Description
System.Drawing.PointF

GetPointFromValue(ChartPoint, Int32)

Gets the point from value.

Declaration

protected PointF GetPointFromValue(ChartPoint cpt, int j)

Parameters

Type	Name	Description
ChartPoint	cpt	The ChartPoint.
System.Int32	j	The index of Y value.

Returns

Type	Description
System.Drawing.PointF

GetPointFromValue(ChartSeriesRenderer.ChartStyledPoint)

Compute real point from specified ChartSeriesRenderer.ChartStyledPoint

Declaration

protected virtual PointF GetPointFromValue(ChartSeriesRenderer.ChartStyledPoint cpt)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint	cpt	The ChartSeriesRenderer.ChartStyledPoint.

Returns

Type	Description
System.Drawing.PointF

GetPointFromValue(Double, Double)

Compute real point from specified coordinates.

Declaration

protected virtual PointF GetPointFromValue(double x, double y)

Parameters

Type	Name	Description
System.Double	x	The x.
System.Double	y	The y.

Returns

Type	Description
System.Drawing.PointF

GetRectangle(ChartPoint, ChartPoint)

Calculates System.Drawing.RectangleF for given chart points.

Declaration

protected virtual RectangleF GetRectangle(ChartPoint firstPoint, ChartPoint secondPoint)

Parameters

Type	Name	Description
ChartPoint	firstPoint	The first chart point to calculate rectangle.
ChartPoint	secondPoint	The second chart point to calculate rectangle.

Returns

Type	Description
System.Drawing.RectangleF	Calculated rectangle.

GetRegionFromCircle(PointF, Single)

Called by several derived renderers to create a region from a 'Hit Test' circle. By overriding this method you can expand, contract or change this region.

Declaration

protected virtual Region GetRegionFromCircle(PointF center, float radius)

Parameters

Type	Name	Description
System.Drawing.PointF	center	The anchor point.
System.Single	radius	The radius of the circle that is to be used as the base for the region.

Returns

Type	Description
System.Drawing.Region	Region object that is commonly used for hit testing, for display of tooltips and the like.

GetSeriesDepth()

Gets the depth size of series.

Declaration

protected virtual float GetSeriesDepth()

Returns

Type	Description
System.Single

GetSeriesOffset()

Calculates depth offset.

Declaration

protected virtual SizeF GetSeriesOffset()

Returns

Type	Description
System.Drawing.SizeF	Series offset.

GetSideBySideInfo()

Gets the "side by side" info.

Declaration

protected DoubleRange GetSideBySideInfo()

Returns

Type	Description
DoubleRange

GetSideBySideRange()

Gets the side by side range.

Declaration

protected virtual DoubleRange GetSideBySideRange()

Returns

Type	Description
DoubleRange

GetStackInfo(Int32)

Overloaded. This method is used when series are rendered as stacked data. The value returned is a cumulative value of Y from all series that are below the series currently being rendered.

Declaration

protected virtual float GetStackInfo(int i)

Parameters

Type	Name	Description
System.Int32	i

Returns

Type	Description
System.Single	Value that gives the position from which this series should be rendered.

GetStackInfoValue(Int32)

Overloaded. This method is used when series are rendered as stacked data. The value returned is a cumulative value of Y from all series that are below the series currently being rendered.

Declaration

protected virtual double GetStackInfoValue(int i)

Parameters

Type	Name	Description
System.Int32	i	The index of point.

Returns

Type	Description
System.Double	Value that gives the position from which this series should be rendered.

GetStackInfoValue(Int32, Boolean)

Overloaded. This method is used when series are rendered as stacked data. The value returned is a cumulative value of Y from all series that are below the series currently being rendered.

Declaration

protected virtual double GetStackInfoValue(int i, bool isWithMe)

Parameters

Type	Name	Description
System.Int32	i	The index of point.
System.Boolean	isWithMe	if set to true the Y value of point will be added to result.

Returns

Type	Description
System.Double	Value that gives the position from which this series should be rendered.

GetStyleAt(Int32)

Delegates to GetOfflineStyle() to return the style associated with this index. You can use this override to specify additional style attributes on a renderer basis.

Declaration

protected virtual ChartStyleInfo GetStyleAt(int index)

Parameters

Type	Name	Description
System.Int32	index	Index value of the point for which the style is required.

Returns

Type	Description
ChartStyleInfo	Offline composed copy of the style associated with the index.

GetSymbolCoordinates(ChartSeriesRenderer.ChartStyledPoint)

Gets the symbol coordinates.

Declaration

protected virtual PointF GetSymbolCoordinates(ChartSeriesRenderer.ChartStyledPoint styledPoint)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint	styledPoint	The styled point.

Returns

Type	Description
System.Drawing.PointF

GetSymbolCoordinates(Int32)

Declaration

public virtual PointF GetSymbolCoordinates(int pointIndex)

Parameters

Type	Name	Description
System.Int32	pointIndex

Returns

Type	Description
System.Drawing.PointF

GetSymbolPoint(ChartSeriesRenderer.ChartStyledPoint)

Returns the anchor point at which the symbol associated with an index is to be displayed.

Declaration

protected PointF GetSymbolPoint(ChartSeriesRenderer.ChartStyledPoint point)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint	point	The point.

Returns

Type	Description
System.Drawing.PointF

GetSymbolVector(ChartSeriesRenderer.ChartStyledPoint)

Gets the symbol vector.

Declaration

protected Vector3D GetSymbolVector(ChartSeriesRenderer.ChartStyledPoint point)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint	point	The point.

Returns

Type	Description
Vector3D

GetThisOffset()

Gets the this series offset.

Declaration

protected virtual SizeF GetThisOffset()

Returns

Type	Description
System.Drawing.SizeF

GetToolTip(Int32)

Gets the tooltip by the specified index.

Declaration

protected string GetToolTip(int index)

Parameters

Type	Name	Description
System.Int32	index	The index.

Returns

Type	Description
System.String

GetUpPriceInterior(BrushInfo)

Returns the up interior for financial chart types.

Declaration

protected virtual BrushInfo GetUpPriceInterior(BrushInfo original)

Parameters

Type	Name	Description
BrushInfo	original	The base interior of chart.

Returns

Type	Description
BrushInfo	The BrushInfo for the up price sectors.

GetVisiblePoints(ChartPointIndexer)

Returns an array of visible chart points

Declaration

protected ChartPoint[] GetVisiblePoints(ChartPointIndexer list)

Parameters

Type	Name	Description
ChartPointIndexer	list	Chart point indexer collection

Returns

Type	Description
ChartPoint[]	Array of visible points

GetVisiblePoints(ChartPointWithIndex[])

Returns an array of visible chart points

Declaration

protected ChartPointWithIndex[] GetVisiblePoints(ChartPointWithIndex[] list)

Parameters

Type	Name	Description
ChartPointWithIndex[]	list	Array of points

Returns

Type	Description
ChartPointWithIndex[]	Array of visible points

GetVisiblePoints(ChartSeriesRenderer.ChartStyledPoint[])

Returns an array of visible points from the styled point collection

Declaration

protected ChartSeriesRenderer.ChartStyledPoint[] GetVisiblePoints(ChartSeriesRenderer.ChartStyledPoint[] list)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint[]	list	Array of styled points

Returns

Type	Description
ChartSeriesRenderer.ChartStyledPoint[]	Array of visible styled points

GetXDataMeasure()

Measures the X range.

Declaration

public virtual DoubleRange GetXDataMeasure()

Returns

Type	Description
DoubleRange

GetXFromCoordinate(Double)

Given an X coordinate value, returns the display value.

Declaration

protected virtual float GetXFromCoordinate(double value)

Parameters

Type	Name	Description
System.Double	value	Coordinate on the axis.

Returns

Type	Description
System.Single	Display value.

GetXFromIndex(Int32, Int32)

Given a point index, returns the X value to be plotted on the chart.

Declaration

protected virtual float GetXFromIndex(int i, int j)

Parameters

Type	Name	Description
System.Int32	i	X index
System.Int32	j	Y index

Returns

Type	Description
System.Single	X value to be plotted.

GetXFromValue(ChartPoint, Int32)

Given a point and y value, returns the X value to be plotted on the chart.

Declaration

protected virtual float GetXFromValue(ChartPoint cp, int j)

Parameters

Type	Name	Description
ChartPoint	cp	The chart point
System.Int32	j	The Y index

Returns

Type	Description
System.Single	X value to be plotted.

GetYDataMeasure()

Measures the X range.

Declaration

public virtual DoubleRange GetYDataMeasure()

Returns

Type	Description
DoubleRange

GetYFromCoordinate(Double)

Given a Y coordinate value, returns the display value.

Declaration

protected virtual float GetYFromCoordinate(double y)

Parameters

Type	Name	Description
System.Double	y

Returns

Type	Description
System.Single	Display value.

GetYFromIndex(Int32, Int32)

Given the point indices, returns the Y value to be plotted on the chart.

Declaration

protected virtual float GetYFromIndex(int i, int j)

Parameters

Type	Name	Description
System.Int32	i	X index
System.Int32	j	Y index

Returns

Type	Description
System.Single	Y value to be plotted

GetYFromValue(ChartPoint, Int32)

Given a point and y value, returns the Y value to be plotted on the chart.

Declaration

protected virtual float GetYFromValue(ChartPoint cp, int j)

Parameters

Type	Name	Description
ChartPoint	cp	The chart point value.
System.Int32	j	The Y index

Returns

Type	Description
System.Single	Y value to be plotted

IsVisiblePoint(ChartPoint)

Determines whether the specified point is visible.

Declaration

protected bool IsVisiblePoint(ChartPoint cpt)

Parameters

Type	Name	Description
ChartPoint	cpt	The ChartPoint instance.

Returns

Type	Description
System.Boolean	true if the specified point is visible; otherwise, false.

NaturalSpline(ChartPointWithIndex[], out Double[])

Given the array of chart points. The procedure returns array of second derivatives of cubic splines at this points. Then we can get bezier curve coordinates from the second derivatives and points array.

Declaration

protected void NaturalSpline(ChartPointWithIndex[] points, out double[] ys2)

Parameters

Type	Name	Description
ChartPointWithIndex[]	points	The points.
System.Double[]	ys2	The ys2.

NaturalSpline(ChartSeriesRenderer.ChartStyledPoint[], out Double[])

Given the array of chart points. The procedure returns array of second derivatives of cubic splines at this points. Then we can get bezier curve coordinates from the second derivatives and points array.

Declaration

protected void NaturalSpline(ChartSeriesRenderer.ChartStyledPoint[] points, out double[] ys2)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint[]	points	The points.
System.Double[]	ys2	The ys2.

PrepearePoints()

Generates the array of points with specified style.

Declaration

protected ChartSeriesRenderer.ChartStyledPoint[] PrepearePoints()

Returns

Type	Description
ChartSeriesRenderer.ChartStyledPoint[]

RemoveDuplicates(PointF[])

Remove duplicate values in the array

Declaration

protected PointF[] RemoveDuplicates(PointF[] points)

Parameters

Type	Name	Description
System.Drawing.PointF[]	points	Array of points

Returns

Type	Description
System.Drawing.PointF[]	Array of points without any duplicate values

Render(ChartRenderArgs2D)

Renders chart by the specified args.

Declaration

public virtual void Render(ChartRenderArgs2D args)

Parameters

Type	Name	Description
ChartRenderArgs2D	args	The args.

Render(ChartRenderArgs3D)

Renders chart by the specified args.

Declaration

public virtual void Render(ChartRenderArgs3D args)

Parameters

Type	Name	Description
ChartRenderArgs3D	args	The args.

Render(Graphics3D)

In the base ChartSeriesRenderer it does not do anything. In derived classes this function does the rendering.

Declaration

public virtual void Render(Graphics3D g)

Parameters

Type	Name	Description
Graphics3D	g	The graphics object that is to be used for rendering.

Render(Graphics)

In the base ChartSeriesRenderer it does not do anything. In derived classes this function does the rendering.

Declaration

public virtual void Render(Graphics g)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The graphics object that is to be used for rendering.

RenderAdornment(Graphics, ChartSeriesRenderer.ChartStyledPoint)

Renders the adornment.

Declaration

protected virtual void RenderAdornment(Graphics g, ChartSeriesRenderer.ChartStyledPoint point)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The g.
ChartSeriesRenderer.ChartStyledPoint	point	The point.

RenderAdornments(Graphics3D)

Renders elements such as Text and Point Symbols.

Declaration

protected virtual void RenderAdornments(Graphics3D g)

Parameters

Type	Name	Description
Graphics3D	g	The graphics object that is to be used.

RenderAdornments(Graphics)

Overloaded. Renders elements such as Text and Point Symbols.

Declaration

protected virtual void RenderAdornments(Graphics g)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The graphics object that is to be used.

RenderSeriesNameInDepth(Graphics3D)

Renders series name in the minimal position of all axes.

Declaration

public virtual void RenderSeriesNameInDepth(Graphics3D g)

Parameters

Type	Name	Description
Graphics3D	g	The graphics object that is to be used for rendering.

RenderSeriesNameInDepth(Graphics)

Renders series name in the minimal position of all axes.

Declaration

public virtual void RenderSeriesNameInDepth(Graphics g)

Parameters

Type	Name	Description
System.Drawing.Graphics	g	The graphics object that is to be used for rendering.

SetChart(IChartAreaHost)

Sets the chart to representation.

Declaration

public void SetChart(IChartAreaHost chart)

Parameters

Type	Name	Description
IChartAreaHost	chart	The chart.

SplitBezierCurve(ChartPointWithIndex, ChartPointWithIndex, ChartPointWithIndex, ChartPointWithIndex, Double, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex, out ChartPointWithIndex)

Splits the bezier curve.

Declaration

protected void SplitBezierCurve(ChartPointWithIndex p0, ChartPointWithIndex p1, ChartPointWithIndex p2, ChartPointWithIndex p3, double t0, out ChartPointWithIndex pb0, out ChartPointWithIndex pb1, out ChartPointWithIndex pb2, out ChartPointWithIndex pb3, out ChartPointWithIndex pe0, out ChartPointWithIndex pe1, out ChartPointWithIndex pe2, out ChartPointWithIndex pe3)

Parameters

Type	Name	Description
ChartPointWithIndex	p0	The p0.
ChartPointWithIndex	p1	The p1.
ChartPointWithIndex	p2	The p2.
ChartPointWithIndex	p3	The p3.
System.Double	t0	The t0.
ChartPointWithIndex	pb0	The PB0.
ChartPointWithIndex	pb1	The PB1.
ChartPointWithIndex	pb2	The PB2.
ChartPointWithIndex	pb3	The PB3.
ChartPointWithIndex	pe0	The pe0.
ChartPointWithIndex	pe1	The pe1.
ChartPointWithIndex	pe2	The pe2.
ChartPointWithIndex	pe3	The pe3.

StackSorting()

Sort the stacking sereies Y values.

Declaration

public virtual void StackSorting()

VisibleChartPoint(ChartSeriesRenderer.ChartStyledPoint[], Int32, out Int32, Boolean)

Returns the next or previous visible chart styled point

Declaration

protected ChartSeriesRenderer.ChartStyledPoint VisibleChartPoint(ChartSeriesRenderer.ChartStyledPoint[] points, int index, out int n, bool first)

Parameters

Type	Name	Description
ChartSeriesRenderer.ChartStyledPoint[]	points	Collection of points
System.Int32	index	Index of the current point in collection
System.Int32	n	Index of the next or previous visible point
System.Boolean	first	A boolean value specifiying whether the function should find next or previous visible point from index

Returns

Type	Description
ChartSeriesRenderer.ChartStyledPoint	Returns a point representing the next or previous visible chart styled point

VisibleChartPoint(IList, Int32, out Int32, Boolean)

Returns the next or previous visible chart point

Declaration

protected ChartPoint VisibleChartPoint(IList points, int index, out int n, bool first)

Parameters

Type	Name	Description
System.Collections.IList	points	Collection of points
System.Int32	index	Index of the current point in collection
System.Int32	n	Index of the next or previous visible point
System.Boolean	first	A boolean value specifiying whether the function should find next or previous visible point from index

Returns

Type	Description
ChartPoint	Returns a point representing the next or previous visible chart point

VisiblePoint(IList, Int32, out Int32, Boolean)

Returns the next or previous visible point

Declaration

protected PointF VisiblePoint(IList points, int index, out int n, bool first)

Parameters

Type	Name	Description
System.Collections.IList	points	Collection of points
System.Int32	index	Index of the current point in collection
System.Int32	n	Index of the next or previous visible point
System.Boolean	first	A boolean value specifiying whether the function should find next or previous visible point from index

Returns

Type	Description
System.Drawing.PointF	Returns a point representing the screen co-ordinate of the next or previous visible chart point

VisiblePointIndex(IList, Int32, Boolean)

Returns the next or previous visible point index

Declaration

protected int VisiblePointIndex(IList points, int index, bool first)

Parameters

Type	Name	Description
System.Collections.IList	points	Collection of points
System.Int32	index	Index of the current point in collection
System.Boolean	first	A boolean value specifiying whether the function should find next or previous visible point from index

Returns

Type	Description
System.Int32	An integer representing the index of next or previous visible point

Extension Methods

Extension.In<T>(T, T[])

DateTimeExtension.ToDateTime(Object)