ChartComponent

ClassChartGuruChartGuru

public class ChartComponent : MonoBehaviour, IChartHost

Hosts a Chart Guru chart on a GameObject for component-driven authoring and runtime updates. Use ChartGuru.ChartGraphic when the chart should render inside a uGUI Canvas.

Fields

chartType

protected ChartType chartType

Returns

ChartGuru.ChartType

theme

protected ChartTheme theme

Returns

ChartGuru.ChartTheme

tinyPadding

protected float tinyPadding

Returns

System.Single

tinyLineWidth

protected float tinyLineWidth

Returns

System.Single

showMinMax

protected bool showMinMax

Returns

System.Boolean

showLastValue

protected bool showLastValue

Returns

System.Boolean

stackingMethod

protected MarkStackingMethod stackingMethod

Returns

ChartGuru.MarkStackingMethod

cornerRadius

protected float cornerRadius

Returns

System.Single

interpolation

protected InterpolationMethod interpolation

Returns

ChartGuru.InterpolationMethod

lineWidth

protected float lineWidth

Returns

System.Single

showSymbols

protected bool showSymbols

Returns

System.Boolean

symbolSize

protected float symbolSize

Returns

System.Single

symbol

protected SymbolShape symbol

Returns

ChartGuru.SymbolShape

opacity

protected float opacity

Returns

System.Single

innerRadius

protected float innerRadius

Returns

System.Single

angularInset

protected float angularInset

Returns

System.Single

xAxis

protected AxisConfig xAxis

Returns

ChartGuru.AxisConfig

yAxis

protected AxisConfig yAxis

Returns

ChartGuru.AxisConfig

zAxis

protected AxisConfig zAxis

Returns

ChartGuru.AxisConfig

legendPosition

protected LegendPosition legendPosition

Returns

ChartGuru.LegendPosition

legendAlignment

protected LegendAlignment legendAlignment

Returns

ChartGuru.LegendAlignment

_chartTitleText

protected string _chartTitleText

Returns

System.String

_chartSubtitleText

protected string _chartSubtitleText

Returns

System.String

_chartTitlePosition

protected ChartTitlePosition _chartTitlePosition

Returns

ChartGuru.ChartTitlePosition

showAxisLabels

protected bool showAxisLabels

Returns

System.Boolean

showAxisTitles

protected bool showAxisTitles

Returns

System.Boolean

showDataLabels

protected bool showDataLabels

Returns

System.Boolean

dataLabelFormat

protected string dataLabelFormat

Returns

System.String

pieLabelMode

protected PieLabelMode pieLabelMode

Returns

ChartGuru.PieLabelMode

animation

protected AnimationField animation

Returns

ChartGuru.AnimationField

timing

protected FrameTimingSettings timing

Returns

ImpossibleRobert.Common.Timing.FrameTimingSettings

_chart

protected Chart _chart

Runtime chart model — never serialized on the component so it cannot collide with Chart3DComponent’s persisted chart field (formerly named _chart in YAML).

Returns

ChartGuru.Chart

_proxy

protected ChartProxy _proxy

Returns

ChartGuru.ChartProxy

_initialized

protected bool _initialized

Returns

System.Boolean

Methods

IsTinyChartType(ChartType)

protected static bool IsTinyChartType(ChartType type)

Reports whether the chart type is a compact sparkline or mini-chart variant intended for reduced inline presentation.

Parameters

Name	Type
type	ChartGuru.ChartType

Returns

System.Boolean

Initialize()

protected virtual void Initialize()

Creates renderer state, applies serialized configuration, and prepares the component for chart updates.

BuildRuntimeChart()

protected virtual Chart BuildRuntimeChart()

Creates the runtime ChartGuru.ChartComponent.Chart from serialized fields. Chart3DComponent overrides this to build 3D charts and restore serialized chart models without duplicating _chart.

Returns

ChartGuru.Chart

ApplyAxisConfig(AxisBuilder, AxisConfig)

protected void ApplyAxisConfig(AxisBuilder builder, AxisConfig config)

Applies axis config to the target chart while preserving unrelated data and presentation settings.

Parameters

Name	Type
builder	ChartGuru.AxisBuilder
config	ChartGuru.AxisConfig

ApplyTextAndLabelConfig(Chart)

protected void ApplyTextAndLabelConfig(Chart chart)

Applies text and label config to the target chart while preserving unrelated data and presentation settings.

Parameters

Name	Type
chart	ChartGuru.Chart

CreateSerializedAuthoringStyle()

protected ChartAuthoringStyleOptions CreateSerializedAuthoringStyle()

Snapshots the component’s serialized mark-style fields into the options applied to newly built charts.

Returns

ChartGuru.ChartAuthoringStyleOptions

ApplyMarkStyleConfig(Chart)

protected virtual void ApplyMarkStyleConfig(Chart chart)

Applies mark style config to the target chart while preserving unrelated data and presentation settings.

Parameters

Name	Type
chart	ChartGuru.Chart

RefreshMarkStyle()

protected virtual void RefreshMarkStyle()

Reapplies serialized mark styling without replacing the component’s bound data.

Cleanup()

protected virtual void Cleanup()

Releases renderer state and detaches runtime callbacks owned by the chart component.

RebuildChart()

protected virtual void RebuildChart()

Rebuilds chart marks and layout from the component’s current serialized data and configuration.

SetDirty()

public virtual void SetDirty()

ChartGuru.IChartHost.SetDirty — requests a full rebuild on the next frame.

SyncAxesFromSerializedFields()

protected void SyncAxesFromSerializedFields()

Editor-only: pushes serialized X/Y/Z axis configs into the live chart so inspector tweaks apply without a full rebuild.

SyncChartPresentationFromSerializedFields()

protected void SyncChartPresentationFromSerializedFields()

Pushes the serialized theme, text, label, and mark-style settings into the live chart without replacing its data or rebuilding its mark collection.

SetData(IEnumerable, Func<T, float>, Func<T, float>)

public void SetData<T>(IEnumerable<T> data, Func<T, float> xSelector, Func<T, float> ySelector)

Replaces the Chart Component’s source data and refreshes its marks while preserving compatible chart configuration.

Parameters

Name	Type
data	System.Collections.Generic.IEnumerable{{T}}
xSelector	System.Func{{T},System.Single}
ySelector	System.Func{{T},System.Single}

SetData(float[])

public void SetData(float[] values)

Replaces the Chart Component’s source data and refreshes its marks while preserving compatible chart configuration.

Parameters

Name	Type
values	System.Single[]

SetData(float[], float[])

public void SetData(float[] xValues, float[] yValues)

Replaces the Chart Component’s source data and refreshes its marks while preserving compatible chart configuration.

Parameters

Name	Type
xValues	System.Single[]
yValues	System.Single[]

AddDataPoint(float, float)

public void AddDataPoint(float x, float y)

Appends one data point to the series and notifies attached charts that their rendered data changed.

Parameters

Name	Type
x	System.Single
y	System.Single

ClearData()

public void ClearData()

Removes all source values from the Chart Component and notifies attached charts to refresh.

SelectAtPosition(Vector2)

public bool SelectAtPosition(Vector2 localPosition)

Updates chart selection from a chart-local pointer position using rendered mark geometry.

Parameters

Name	Type
localPosition	UnityEngine.Vector2

Returns

System.Boolean

SelectAtX(float)

public bool SelectAtX(float localX)

Updates horizontal selection from the supplied data or chart coordinate.

Parameters

Name	Type
localX	System.Single

Returns

System.Boolean

SelectAngleAtPosition(Vector2)

public bool SelectAngleAtPosition(Vector2 localPosition)

Updates angular selection by hit-testing a chart-local point against rendered sectors.

Parameters

Name	Type
localPosition	UnityEngine.Vector2

Returns

System.Boolean

SelectXRange(float, float)

public ClosedRange<float>? SelectXRange(float startLocalX, float endLocalX)

Sets the selected horizontal data range and notifies registered selection listeners.

Parameters

Name	Type
startLocalX	System.Single
endLocalX	System.Single

Returns

System.Nullable{ChartGuru.ClosedRange{System.Single}}

SelectYRange(float, float)

public ClosedRange<float>? SelectYRange(float startLocalY, float endLocalY)

Sets the selected vertical data range and notifies registered selection listeners.

Parameters

Name	Type
startLocalY	System.Single
endLocalY	System.Single

Returns

System.Nullable{ChartGuru.ClosedRange{System.Single}}

ScrollXBy(float)

public void ScrollXBy(float delta)

Offsets the visible horizontal domain by the supplied data-space distance.

Parameters

Name	Type
delta	System.Single

ScrollYBy(float)

public void ScrollYBy(float delta)

Offsets the visible vertical domain by the supplied data-space distance.

Parameters

Name	Type
delta	System.Single

ScrollToX(float)

public void ScrollToX(float value)

Moves the visible horizontal domain so the requested data value aligns according to the scroll-target behavior.

Parameters

Name	Type
value	System.Single

ScrollToY(float)

public void ScrollToY(float value)

Moves the visible vertical domain so the requested data value aligns according to the scroll-target behavior.

Parameters

Name	Type
value	System.Single

ZoomX(float, float)

public void ZoomX(float zoomFactor, float anchorLocalX)

Scales the visible horizontal domain around the supplied data-space anchor.

Parameters

Name	Type
zoomFactor	System.Single
anchorLocalX	System.Single

ZoomY(float, float)

public void ZoomY(float zoomFactor, float anchorLocalY)

Scales the visible vertical domain around the supplied data-space anchor.

Parameters

Name	Type
zoomFactor	System.Single
anchorLocalY	System.Single

Zoom(float, float, Vector2)

public void Zoom(float zoomFactorX, float zoomFactorY, Vector2 anchorLocalPosition)

Scales both visible axis domains around the supplied anchor point while respecting configured limits.

Parameters

Name	Type
zoomFactorX	System.Single
zoomFactorY	System.Single
anchorLocalPosition	UnityEngine.Vector2

PanViewportByPixels(Vector2)

public void PanViewportByPixels(Vector2 pixelDelta)

Converts a screen-space drag delta into data-space offsets and pans the visible chart domains.

Parameters

Name	Type
pixelDelta	UnityEngine.Vector2

ResetViewport()

public void ResetViewport()

Restores both axes to their configured visible domains and clears transient pan and zoom offsets.

ClearSelectionRanges()

public void ClearSelectionRanges()

Clears active range selections and notifies registered selection listeners.

PlayEntryAnimation()

public void PlayEntryAnimation()

Replays the entry Animation (zero -> current values) using the component’s configured animation. No-op if the animation is disabled.

MorphTo(ChartType, Animation?)

public void MorphTo(ChartType targetType, Animation? morphAnimation = null)

Morphs the chart to a new type. Driven end-to-end by the morpher: the request is handed to ChartGuru.Chart.MorphTo(ChartGuru.ChartType%2cChartGuru.MorphOptions), and the renderer kicks off the visual transition on its next tick.

Parameters

Name	Type
targetType	ChartGuru.ChartType
morphAnimation	System.Nullable{ChartGuru.Animation}

ConfigureXAxis(Action)

public ChartComponent ConfigureXAxis(Action<AxisBuilder> configure)

Applies a callback to the horizontal axis configuration and refreshes the chart.

Parameters

Name	Type
configure	System.Action{ChartGuru.AxisBuilder}

Returns

ChartGuru.ChartComponent

ConfigureYAxis(Action)

public ChartComponent ConfigureYAxis(Action<AxisBuilder> configure)

Applies a callback to the vertical axis configuration and refreshes the chart.

Parameters

Name	Type
configure	System.Action{ChartGuru.AxisBuilder}

Returns

ChartGuru.ChartComponent

ConfigureZAxis(Action)

public ChartComponent ConfigureZAxis(Action<AxisBuilder> configure)

Applies a callback to the depth axis configuration used by supported 3D chart hosts.

Parameters

Name	Type
configure	System.Action{ChartGuru.AxisBuilder}

Returns

ChartGuru.ChartComponent

ConfigureLegend(LegendPosition)

public ChartComponent ConfigureLegend(LegendPosition position)

Applies a callback or replacement snapshot to the legend configuration and refreshes the chart.

Parameters

Name	Type
position	ChartGuru.LegendPosition

Returns

ChartGuru.ChartComponent

ConfigureLegend(LegendPosition, LegendAlignment)

public ChartComponent ConfigureLegend(LegendPosition position, LegendAlignment alignment)

Applies a callback or replacement snapshot to the legend configuration and refreshes the chart.

Parameters

Name	Type
position	ChartGuru.LegendPosition
alignment	ChartGuru.LegendAlignment

Returns

ChartGuru.ChartComponent

ConfigureAnimation(Animation?)

public ChartComponent ConfigureAnimation(Animation? newAnimation)

Configures the animation used for data changes and entry animation. Pass null for instant (non-animated) updates.

Parameters

Name	Type
newAnimation	System.Nullable{ChartGuru.Animation}

Returns

ChartGuru.ChartComponent

ConfigureCompactChart(float, float)

public ChartComponent ConfigureCompactChart(float padding = 2, float lineWidth = 1.5)

Configure compact chart settings. Use ChartType property to set the compact type (Sparkline, Trend, MiniBar, MiniPie, MiniDonut, Indicator).

Parameters

Name	Type
padding	System.Single
lineWidth	System.Single

Returns

ChartGuru.ChartComponent

RenderToTexture(int, int)

public RenderTexture RenderToTexture(int width, int height)

Renders the current chart into the supplied render target using the configured dimensions and theme.

Parameters

Name	Type
width	System.Int32
height	System.Int32

Returns

UnityEngine.RenderTexture

RenderToTexture2D(int, int)

public Texture2D RenderToTexture2D(int width, int height)

Renders the current chart and returns a new readable texture containing the resulting pixels.

Parameters

Name	Type
width	System.Int32
height	System.Int32

Returns

UnityEngine.Texture2D

Constructors

ChartComponent()

public ChartComponent()

Properties

Chart

public Chart Chart { get; }

The bound ChartGuru.IChartHost.Chart model, if any.

Returns

ChartGuru.Chart

Proxy

public ChartProxy Proxy { get; }

Returns

ChartGuru.ChartProxy

IsTinyChart

public bool IsTinyChart { get; }

Returns

System.Boolean

StackingMethod

public MarkStackingMethod StackingMethod { get; set; }

Returns

ChartGuru.MarkStackingMethod

CornerRadius

public float CornerRadius { get; set; }

Returns

System.Single

Interpolation

public InterpolationMethod Interpolation { get; set; }

Returns

ChartGuru.InterpolationMethod

LineWidth

public float LineWidth { get; set; }

Returns

System.Single

ShowSymbols

public bool ShowSymbols { get; set; }

Returns

System.Boolean

SymbolSize

public float SymbolSize { get; set; }

Returns

System.Single

Symbol

public SymbolShape Symbol { get; set; }

Returns

ChartGuru.SymbolShape

Opacity

public float Opacity { get; set; }

Returns

System.Single

InnerRadius

public float InnerRadius { get; set; }

Returns

System.Single

AngularInset

public float AngularInset { get; set; }

Returns

System.Single

ChartType

public ChartType ChartType { get; set; }

Returns

ChartGuru.ChartType

Theme

public ChartTheme Theme { get; set; }

Returns

ChartGuru.ChartTheme

Size

public Vector2 Size { get; set; }

Returns

UnityEngine.Vector2

UseBackgroundOverride

public bool UseBackgroundOverride { get; set; }

Enables or disables the background override (overrides theme).

Returns

System.Boolean

BackgroundOverrideMode

public ChartBackgroundMode BackgroundOverrideMode { get; set; }

Background rendering mode used when ChartGuru.ChartComponent.UseBackgroundOverride is true.

Returns

ChartGuru.ChartBackgroundMode

BackgroundOverrideColor

public Color BackgroundOverrideColor { get; set; }

Solid colour used when ChartGuru.ChartComponent.BackgroundOverrideMode is SolidColor.

Returns

UnityEngine.Color

BackgroundOverrideGradient

public LinearGradientStyle BackgroundOverrideGradient { get; set; }

Linear gradient used when ChartGuru.ChartComponent.BackgroundOverrideMode is LinearGradient.

Returns

ChartGuru.LinearGradientStyle

BackgroundOverrideFourCorner

public FourCornerGradient BackgroundOverrideFourCorner { get; set; }

Four-corner gradient used when ChartGuru.ChartComponent.BackgroundOverrideMode is FourCornerGradient.

Returns

ChartGuru.FourCornerGradient

Events

OnDataPointClicked

public event Action<int, DataPoint> OnDataPointClicked

Raised with the mark index and data point after a rendered point is clicked.

Returns

System.Action{System.Int32,ChartGuru.DataPoint}

OnDataPointHovered

public event Action<int, DataPoint> OnDataPointHovered

Raised with the mark index and data point when the hover target changes.

Returns

System.Action{System.Int32,ChartGuru.DataPoint}

OnAnimationComplete

public event Action OnAnimationComplete

Raised after the chart’s current data or presentation animation completes.

Returns

System.Action