Skip to content

ChartComponent

ClassChartGuruChartGuru
[AddComponentMenu("ChartGuru/Chart")]
[ExecuteAlways]
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.

[Header("Chart Settings")]
[SerializeField]
protected ChartType chartType

No description is available for this member.

Returns

ChartGuru.ChartType — No return description is available.

[SerializeField]
protected ChartTheme theme

No description is available for this member.

Returns

ChartGuru.ChartTheme — No return description is available.

[Header("Compact Chart Options")]
[Tooltip("Padding inside the compact chart in pixels.")]
[SerializeField]
[Range(0, 20)]
protected float tinyPadding

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Stroke width for the sparkline or trend line.")]
[SerializeField]
[Range(0.1, 10)]
protected float tinyLineWidth

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Show markers at the minimum and maximum data values.")]
[SerializeField]
protected bool showMinMax

No description is available for this member.

Returns

System.Boolean — No return description is available.

[Tooltip("Highlight the most recent (last) data point.")]
[SerializeField]
protected bool showLastValue

No description is available for this member.

Returns

System.Boolean — No return description is available.

[Header("Mark Style")]
[Tooltip("Stacking method for multi-series bar and area charts.")]
[SerializeField]
protected MarkStackingMethod stackingMethod

No description is available for this member.

Returns

ChartGuru.MarkStackingMethod — No return description is available.

[Tooltip("Corner radius for bar and sector marks.")]
[SerializeField]
[Range(0, 50)]
protected float cornerRadius

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Line interpolation for line and area charts.")]
[SerializeField]
protected InterpolationMethod interpolation

No description is available for this member.

Returns

ChartGuru.InterpolationMethod — No return description is available.

[Tooltip("Line width for line and area charts.")]
[SerializeField]
[Range(0.1, 20)]
protected float lineWidth

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Show point symbols on line charts.")]
[SerializeField]
protected bool showSymbols

No description is available for this member.

Returns

System.Boolean — No return description is available.

[Tooltip("Symbol size for point-based charts.")]
[SerializeField]
[Range(1, 50)]
protected float symbolSize

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Symbol shape for point-based charts.")]
[SerializeField]
protected SymbolShape symbol

No description is available for this member.

Returns

ChartGuru.SymbolShape — No return description is available.

[Tooltip("Opacity applied to supported marks.")]
[SerializeField]
[Range(0, 1)]
protected float opacity

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Inner radius ratio for donut charts.")]
[SerializeField]
[Range(0, 0.9)]
protected float innerRadius

No description is available for this member.

Returns

System.Single — No return description is available.

[Tooltip("Angular inset between pie/donut slices in degrees.")]
[SerializeField]
[Range(0, 10)]
protected float angularInset

No description is available for this member.

Returns

System.Single — No return description is available.

[Header("Axis")]
[SerializeField]
protected AxisConfig xAxis

No description is available for this member.

Returns

ChartGuru.AxisConfig — No return description is available.

[SerializeField]
protected AxisConfig yAxis

No description is available for this member.

Returns

ChartGuru.AxisConfig — No return description is available.

[Tooltip("Z axis (depth) for 3D charts. Used by Chart3DComponent and ignored by pure 2D rendering.")]
[SerializeField]
protected AxisConfig zAxis

No description is available for this member.

Returns

ChartGuru.AxisConfig — No return description is available.

[Header("Legend")]
[SerializeField]
protected LegendPosition legendPosition

No description is available for this member.

Returns

ChartGuru.LegendPosition — No return description is available.

[SerializeField]
protected LegendAlignment legendAlignment

No description is available for this member.

Returns

ChartGuru.LegendAlignment — No return description is available.

[Header("Chart title")]
[SerializeField]
protected string _chartTitleText

No description is available for this member.

Returns

System.String — No return description is available.

[SerializeField]
protected string _chartSubtitleText

No description is available for this member.

Returns

System.String — No return description is available.

[SerializeField]
protected ChartTitlePosition _chartTitlePosition

No description is available for this member.

Returns

ChartGuru.ChartTitlePosition — No return description is available.

[Header("Text / Labels")]
[Tooltip("Show axis tick labels.")]
[SerializeField]
protected bool showAxisLabels

No description is available for this member.

Returns

System.Boolean — No return description is available.

[Tooltip("Show axis title labels.")]
[SerializeField]
protected bool showAxisTitles

No description is available for this member.

Returns

System.Boolean — No return description is available.

[Tooltip("Show data value labels on marks.")]
[SerializeField]
protected bool showDataLabels

No description is available for this member.

Returns

System.Boolean — No return description is available.

[Tooltip("Format string for data labels, e.g. {value}.")]
[SerializeField]
protected string dataLabelFormat

No description is available for this member.

Returns

System.String — No return description is available.

[Tooltip("Label positioning mode for pie/donut charts.")]
[SerializeField]
protected PieLabelMode pieLabelMode

No description is available for this member.

Returns

ChartGuru.PieLabelMode — No return description is available.

[Tooltip("Animation used for data changes and entry animation. Leave disabled for instant updates.")]
[SerializeField]
protected AnimationField animation

No description is available for this member.

Returns

ChartGuru.AnimationField — No return description is available.

[Header("Timing")]
[Tooltip("Clock source and update timing used by chart animations and edit-mode previews.")]
[SerializeField]
protected FrameTimingSettings timing

No description is available for this member.

Returns

ImpossibleRobert.Common.Timing.FrameTimingSettings — No return description is available.

[NonSerialized]
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 — No return description is available.

protected ChartRenderer _renderer

No description is available for this member.

Returns

ChartGuru.ChartRenderer — No return description is available.

protected ChartProxy _proxy

No description is available for this member.

Returns

ChartGuru.ChartProxy — No return description is available.

protected bool _initialized

No description is available for this member.

Returns

System.Boolean — No return description is available.

public event Action<int, DataPoint> OnDataPointClicked

No description is available for this member.

Returns

System.Action{System.Int32,ChartGuru.DataPoint} — No return description is available.

public event Action<int, DataPoint> OnDataPointHovered

No description is available for this member.

Returns

System.Action{System.Int32,ChartGuru.DataPoint} — No return description is available.

public event Action OnAnimationComplete

No description is available for this member.

Returns

System.Action — No return description is available.

public Chart Chart { get; }

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

Returns

ChartGuru.Chart — No return description is available.

public ChartRenderer Renderer { get; }

No description is available for this member.

Returns

ChartGuru.ChartRenderer — No return description is available.

public ChartProxy Proxy { get; }

No description is available for this member.

Returns

ChartGuru.ChartProxy — No return description is available.

public bool IsTinyChart { get; }

No description is available for this member.

Returns

System.Boolean — No return description is available.

public MarkStackingMethod StackingMethod { get; set; }

No description is available for this member.

Returns

ChartGuru.MarkStackingMethod — No return description is available.

public float CornerRadius { get; set; }

No description is available for this member.

Returns

System.Single — No return description is available.

public InterpolationMethod Interpolation { get; set; }

No description is available for this member.

Returns

ChartGuru.InterpolationMethod — No return description is available.

public float LineWidth { get; set; }

No description is available for this member.

Returns

System.Single — No return description is available.

public bool ShowSymbols { get; set; }

No description is available for this member.

Returns

System.Boolean — No return description is available.

public float SymbolSize { get; set; }

No description is available for this member.

Returns

System.Single — No return description is available.

public SymbolShape Symbol { get; set; }

No description is available for this member.

Returns

ChartGuru.SymbolShape — No return description is available.

public float Opacity { get; set; }

No description is available for this member.

Returns

System.Single — No return description is available.

public float InnerRadius { get; set; }

No description is available for this member.

Returns

System.Single — No return description is available.

public float AngularInset { get; set; }

No description is available for this member.

Returns

System.Single — No return description is available.

public ChartType ChartType { get; set; }

Available chart types. Aligned with Swift Charts mark-based approach. Includes compact/tiny chart variants for inline display.

Returns

ChartGuru.ChartType — No return description is available.

public ChartTheme Theme { get; set; }

No description is available for this member.

Returns

ChartGuru.ChartTheme — No return description is available.

public Vector2 Size { get; set; }

No description is available for this member.

Returns

UnityEngine.Vector2 — No return description is available.

public bool UseBackgroundOverride { get; set; }

Enables or disables the background override (overrides theme).

Returns

System.Boolean — No return description is available.

public ChartBackgroundMode BackgroundOverrideMode { get; set; }

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

Returns

ChartGuru.ChartBackgroundMode — No return description is available.

public Color BackgroundOverrideColor { get; set; }

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

Returns

UnityEngine.Color — No return description is available.

public LinearGradientStyle BackgroundOverrideGradient { get; set; }

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

Returns

ChartGuru.LinearGradientStyle — No return description is available.

public FourCornerGradient BackgroundOverrideFourCorner { get; set; }

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

Returns

ChartGuru.FourCornerGradient — No return description is available.

protected static bool IsTinyChartType(ChartType type)

No description is available for this member.

Parameters

Name Type Description
type ChartGuru.ChartType

Returns

System.Boolean — No return description is available.

protected virtual void OnEnable()

No description is available for this member.

protected virtual void OnDisable()

No description is available for this member.

protected virtual void Initialize()

No description is available for this member.

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 — No return description is available.

protected void ApplyAxisConfig(AxisBuilder builder, AxisConfig config)

No description is available for this member.

Parameters

Name Type Description
builder ChartGuru.AxisBuilder
config ChartGuru.AxisConfig
protected void ApplyTextAndLabelConfig(Chart chart)

No description is available for this member.

Parameters

Name Type Description
chart ChartGuru.Chart
protected ChartAuthoringStyleOptions CreateSerializedAuthoringStyle()

No description is available for this member.

Returns

ChartGuru.ChartAuthoringStyleOptions — No return description is available.

protected virtual void ApplyMarkStyleConfig(Chart chart)

No description is available for this member.

Parameters

Name Type Description
chart ChartGuru.Chart
protected virtual void RefreshMarkStyle()

No description is available for this member.

protected virtual void Cleanup()

No description is available for this member.

protected virtual void RebuildChart()

No description is available for this member.

public virtual void SetDirty()

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

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

Section titled “SetData(IEnumerable, Func<T, float>, Func<T, float>)”
public void SetData<T>(IEnumerable<T> data, Func<T, float> xSelector, Func<T, float> ySelector)

No description is available for this member.

Parameters

Name Type Description
data System.Collections.Generic.IEnumerable{{T}}
xSelector System.Func{{T},System.Single}
ySelector System.Func{{T},System.Single}
public void SetData(float[] values)

No description is available for this member.

Parameters

Name Type Description
values System.Single[]
public void SetData(float[] xValues, float[] yValues)

No description is available for this member.

Parameters

Name Type Description
xValues System.Single[]
yValues System.Single[]
public void AddDataPoint(float x, float y)

No description is available for this member.

Parameters

Name Type Description
x System.Single
y System.Single
public void ClearData()

No description is available for this member.

public bool SelectAtPosition(Vector2 localPosition)

No description is available for this member.

Parameters

Name Type Description
localPosition UnityEngine.Vector2

Returns

System.Boolean — No return description is available.

public bool SelectAtX(float localX)

No description is available for this member.

Parameters

Name Type Description
localX System.Single

Returns

System.Boolean — No return description is available.

public bool SelectAngleAtPosition(Vector2 localPosition)

No description is available for this member.

Parameters

Name Type Description
localPosition UnityEngine.Vector2

Returns

System.Boolean — No return description is available.

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

No description is available for this member.

Parameters

Name Type Description
startLocalX System.Single
endLocalX System.Single

Returns

System.Nullable{ChartGuru.ClosedRange{System.Single}} — No return description is available.

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

No description is available for this member.

Parameters

Name Type Description
startLocalY System.Single
endLocalY System.Single

Returns

System.Nullable{ChartGuru.ClosedRange{System.Single}} — No return description is available.

public void ScrollXBy(float delta)

No description is available for this member.

Parameters

Name Type Description
delta System.Single
public void ScrollYBy(float delta)

No description is available for this member.

Parameters

Name Type Description
delta System.Single
public void ScrollToX(float value)

No description is available for this member.

Parameters

Name Type Description
value System.Single
public void ScrollToY(float value)

No description is available for this member.

Parameters

Name Type Description
value System.Single
public void ZoomX(float zoomFactor, float anchorLocalX)

No description is available for this member.

Parameters

Name Type Description
zoomFactor System.Single
anchorLocalX System.Single
public void ZoomY(float zoomFactor, float anchorLocalY)

No description is available for this member.

Parameters

Name Type Description
zoomFactor System.Single
anchorLocalY System.Single
public void Zoom(float zoomFactorX, float zoomFactorY, Vector2 anchorLocalPosition)

No description is available for this member.

Parameters

Name Type Description
zoomFactorX System.Single
zoomFactorY System.Single
anchorLocalPosition UnityEngine.Vector2
public void PanViewportByPixels(Vector2 pixelDelta)

No description is available for this member.

Parameters

Name Type Description
pixelDelta UnityEngine.Vector2
public void ResetViewport()

No description is available for this member.

public void ClearSelectionRanges()

No description is available for this member.

public void PlayEntryAnimation()

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

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 Description
targetType ChartGuru.ChartType
morphAnimation System.Nullable{ChartGuru.Animation}
public ChartComponent ConfigureXAxis(Action<AxisBuilder> configure)

No description is available for this member.

Parameters

Name Type Description
configure System.Action{ChartGuru.AxisBuilder}

Returns

ChartGuru.ChartComponent — No return description is available.

public ChartComponent ConfigureYAxis(Action<AxisBuilder> configure)

No description is available for this member.

Parameters

Name Type Description
configure System.Action{ChartGuru.AxisBuilder}

Returns

ChartGuru.ChartComponent — No return description is available.

public ChartComponent ConfigureZAxis(Action<AxisBuilder> configure)

No description is available for this member.

Parameters

Name Type Description
configure System.Action{ChartGuru.AxisBuilder}

Returns

ChartGuru.ChartComponent — No return description is available.

public ChartComponent ConfigureLegend(LegendPosition position)

No description is available for this member.

Parameters

Name Type Description
position ChartGuru.LegendPosition

Returns

ChartGuru.ChartComponent — No return description is available.

ConfigureLegend(LegendPosition, LegendAlignment)

Section titled “ConfigureLegend(LegendPosition, LegendAlignment)”
public ChartComponent ConfigureLegend(LegendPosition position, LegendAlignment alignment)

No description is available for this member.

Parameters

Name Type Description
position ChartGuru.LegendPosition
alignment ChartGuru.LegendAlignment

Returns

ChartGuru.ChartComponent — No return description is available.

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 Description
newAnimation System.Nullable{ChartGuru.Animation}

Returns

ChartGuru.ChartComponent — No return description is available.

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 Description
padding System.Single
lineWidth System.Single

Returns

ChartGuru.ChartComponent — No return description is available.

public RenderTexture RenderToTexture(int width, int height)

No description is available for this member.

Parameters

Name Type Description
width System.Int32
height System.Int32

Returns

UnityEngine.RenderTexture — No return description is available.

public Texture2D RenderToTexture2D(int width, int height)

No description is available for this member.

Parameters

Name Type Description
width System.Int32
height System.Int32

Returns

UnityEngine.Texture2D — No return description is available.