ChartGuruElement
public class ChartGuruElement : VisualElement, IChartHostShallow UI Toolkit adapter on top of the existing ChartGuru.ChartGuruElement.Chart +
ChartGuru.ChartRenderer + ChartGuru.ChartProxy engine. Owns the UI Toolkit
lifecycle (geometry invalidation, visual content emission, pointer events,
animation ticking) and delegates everything else to the shared helpers:
ChartGuru.ChartInteractionController, ChartGuru.ChartAuthoringBinder,
pooled UI Toolkit labels, and ChartGuru.UITKMeshDrawSink.
V1 rendering strategy: the existing GL pipeline renders into a
`UnityEngine.RenderTexture` sized to contentRect.size * scaledPixelsPerPoint,
and a single textured quad is emitted through
`UnityEngine.UIElements.MeshGenerationContext.Allocate(System.Int32%2cSystem.Int32%2cUnityEngine.Texture)`. Once the
`ChartGuru.ChartRenderer` primitive sites have been migrated to emit through
[ChartGuru.IChartDrawSink](/tools/chartguru/api/chartguru-ichartdrawsink/), the same element swaps the RT step for native
geometry emission via [ChartGuru.UITKMeshDrawSink](/tools/chartguru/api/chartguru-uitkmeshdrawsink/) - no API changes required.
Constructors
Section titled “Constructors”
ChartGuruElement()
Section titled “ChartGuruElement()”public ChartGuruElement()Methods
Section titled “Methods”
SetData(IReadOnlyList)
Section titled “SetData(IReadOnlyList)”public void SetData(IReadOnlyList<float> values)Replace the chart marks with a single series of values.
Parameters
| Name | Type |
|---|---|
values |
System.Collections.Generic.IReadOnlyList{System.Single} |
SetChartData(Chart)
Section titled “SetChartData(Chart)”public void SetChartData(Chart src)Swap in a pre-built chart model. Use this for richer multi-series scenarios.
Parameters
| Name | Type |
|---|---|
src |
ChartGuru.Chart |
MorphTo(ChartType, MorphOptions)
Section titled “MorphTo(ChartType, MorphOptions)”public void MorphTo(ChartType type, MorphOptions options = null)Morph to a new chart type with animation, matching ChartGraphic.MorphTo.
Parameters
| Name | Type |
|---|---|
type |
ChartGuru.ChartType |
options |
ChartGuru.MorphOptions |
ReplayEntryAnimation(Animation?)
Section titled “ReplayEntryAnimation(Animation?)”public void ReplayEntryAnimation(Animation? animation = null)Replay the configured entry animation without recreating the element.
Parameters
| Name | Type |
|---|---|
animation |
System.Nullable{ChartGuru.Animation} |
RebuildChart()
Section titled “RebuildChart()”public void RebuildChart()Re-applies the ChartGuru.ChartAuthoringState to the chart/renderer and
requests a repaint. Idempotent.
SetDirty()
Section titled “SetDirty()”public void SetDirty()ChartGuru.IChartHost.SetDirty — triggers a full rebuild and repaint.
BuildStyleOptions()
Section titled “BuildStyleOptions()”public ChartAuthoringStyleOptions BuildStyleOptions()Builds a ChartGuru.ChartAuthoringStyleOptions snapshot from the current
ChartGuru.ChartAuthoringState. Used by ChartGuru.IChartGuruElementDataSource
implementations so marks are shaped consistently with the element’s authoring.
Returns
ChartGuru.ChartAuthoringStyleOptions
ResetViewport()
Section titled “ResetViewport()”public void ResetViewport()Restores both axes to their configured visible domains and requests a repaint.
Properties
Section titled “Properties”
ChartType
Section titled “ChartType”public ChartType ChartType { get; set; }Returns
ChartGuru.ChartType
public ChartTheme Theme { get; set; }Returns
ChartGuru.ChartTheme
AnimateOnStart
Section titled “AnimateOnStart”public bool AnimateOnStart { get; set; }Returns
System.Boolean
ShowAxisLabels
Section titled “ShowAxisLabels”public bool ShowAxisLabels { get; set; }Returns
System.Boolean
ShowAxisTitles
Section titled “ShowAxisTitles”public bool ShowAxisTitles { get; set; }Returns
System.Boolean
ShowDataLabels
Section titled “ShowDataLabels”public bool ShowDataLabels { get; set; }Returns
System.Boolean
LegendAlignment
Section titled “LegendAlignment”public LegendAlignment LegendAlignment { get; set; }Returns
ChartGuru.LegendAlignment
StackingMethod
Section titled “StackingMethod”public MarkStackingMethod StackingMethod { get; set; }Returns
ChartGuru.MarkStackingMethod
Interpolation
Section titled “Interpolation”public InterpolationMethod Interpolation { get; set; }Returns
ChartGuru.InterpolationMethod
LineWidth
Section titled “LineWidth”public float LineWidth { get; set; }Returns
System.Single
CornerRadius
Section titled “CornerRadius”public float CornerRadius { get; set; }Returns
System.Single
InnerRadius
Section titled “InnerRadius”public float InnerRadius { get; set; }Returns
System.Single
XAxisType
Section titled “XAxisType”public AxisScaleType XAxisType { get; set; }Returns
ChartGuru.AxisScaleType
XAxisTimeUnit
Section titled “XAxisTimeUnit”public TimeUnit XAxisTimeUnit { get; set; }Returns
ChartGuru.TimeUnit
XAxisTimeFormat
Section titled “XAxisTimeFormat”public string XAxisTimeFormat { get; set; }Returns
System.String
YAxisType
Section titled “YAxisType”public AxisScaleType YAxisType { get; set; }Returns
ChartGuru.AxisScaleType
YAxisTimeUnit
Section titled “YAxisTimeUnit”public TimeUnit YAxisTimeUnit { get; set; }Returns
ChartGuru.TimeUnit
YAxisTimeFormat
Section titled “YAxisTimeFormat”public string YAxisTimeFormat { get; set; }Returns
System.String
DataSourceAsset
Section titled “DataSourceAsset”public ChartDataSourceAsset DataSourceAsset { get; set; }Asset-typed UXML attribute for project-authored data (Unity 2023.2+).
Setting this assigns ChartGuru.ChartGuruElement.DataSource to the asset; reading it
returns the previously-assigned asset (or null when an MB or
custom source is in use).
Returns
ChartGuru.ChartDataSourceAsset
DataSource
Section titled “DataSource”public IChartGuruElementDataSource DataSource { get; set; }Active data source. May be a ChartGuru.ChartDataSourceAsset, a ChartGuru.ChartDataSourceBase MonoBehaviour, a ViewModel, or any custom ChartGuru.IChartGuruElementDataSource implementation.
Assigning a new source automatically subscribes to its
`ChartGuru.IChartGuruElementDataSource.DataChanged` event and pulls the
initial data set into the chart. Set to null to detach.
Returns
ChartGuru.IChartGuruElementDataSource
public IReadOnlyList<float> Data { get; set; }Live single-series data buffer for runtime / ViewModel binding (Unity 6+
CreateProperty). Setting the property replaces the chart’s
current marks with one mark per value, shaped for the current
ChartGuru.ChartGuruElement.ChartType. Bypasses ChartGuru.ChartGuruElement.DataSource — assignment
makes the element act as its own data feed.
Returns
System.Collections.Generic.IReadOnlyList{System.Single}
public Chart Chart { get; }Underlying chart instance. Exposed for programmatic data manipulation.
Returns
ChartGuru.Chart
public ChartProxy Proxy { get; }Underlying proxy for position/domain queries.
Returns
ChartGuru.ChartProxy
LegendPosition
Section titled “LegendPosition”public LegendPosition LegendPosition { get; set; }Returns
ChartGuru.LegendPosition
ChartTitle
Section titled “ChartTitle”public string ChartTitle { get; set; }Returns
System.String
ChartSubtitle
Section titled “ChartSubtitle”public string ChartSubtitle { get; set; }Returns
System.String
ChartTitlePosition
Section titled “ChartTitlePosition”public ChartTitlePosition ChartTitlePosition { get; set; }Returns
ChartGuru.ChartTitlePosition
ShowXAxis
Section titled “ShowXAxis”public bool ShowXAxis { get; set; }Returns
System.Boolean
ShowYAxis
Section titled “ShowYAxis”public bool ShowYAxis { get; set; }Returns
System.Boolean
XAxisLabel
Section titled “XAxisLabel”public string XAxisLabel { get; set; }Returns
System.String
YAxisLabel
Section titled “YAxisLabel”public string YAxisLabel { get; set; }Returns
System.String
ShowXGridLines
Section titled “ShowXGridLines”public bool ShowXGridLines { get; set; }Returns
System.Boolean
ShowYGridLines
Section titled “ShowYGridLines”public bool ShowYGridLines { get; set; }Returns
System.Boolean
XAxisTickCount
Section titled “XAxisTickCount”public int XAxisTickCount { get; set; }Returns
System.Int32
YAxisTickCount
Section titled “YAxisTickCount”public int YAxisTickCount { get; set; }Returns
System.Int32
XAxisTickFormat
Section titled “XAxisTickFormat”public string XAxisTickFormat { get; set; }Returns
System.String
YAxisTickFormat
Section titled “YAxisTickFormat”public string YAxisTickFormat { get; set; }Returns
System.String
XAxisAutoDomain
Section titled “XAxisAutoDomain”public bool XAxisAutoDomain { get; set; }Returns
System.Boolean
YAxisAutoDomain
Section titled “YAxisAutoDomain”public bool YAxisAutoDomain { get; set; }Returns
System.Boolean
XAxisDomainMin
Section titled “XAxisDomainMin”public float XAxisDomainMin { get; set; }Returns
System.Single
XAxisDomainMax
Section titled “XAxisDomainMax”public float XAxisDomainMax { get; set; }Returns
System.Single
YAxisDomainMin
Section titled “YAxisDomainMin”public float YAxisDomainMin { get; set; }Returns
System.Single
YAxisDomainMax
Section titled “YAxisDomainMax”public float YAxisDomainMax { get; set; }Returns
System.Single
YAxisOnRight
Section titled “YAxisOnRight”public bool YAxisOnRight { get; set; }Returns
System.Boolean
XAxisLabelPreset
Section titled “XAxisLabelPreset”public AxisMarkPreset XAxisLabelPreset { get; set; }Returns
ChartGuru.AxisMarkPreset
YAxisLabelPreset
Section titled “YAxisLabelPreset”public AxisMarkPreset YAxisLabelPreset { get; set; }Returns
ChartGuru.AxisMarkPreset
ShowSymbols
Section titled “ShowSymbols”public bool ShowSymbols { get; set; }Returns
System.Boolean
SymbolSize
Section titled “SymbolSize”public float SymbolSize { get; set; }Returns
System.Single
Symbol
Section titled “Symbol”public SymbolShape Symbol { get; set; }Returns
ChartGuru.SymbolShape
Opacity
Section titled “Opacity”public float Opacity { get; set; }Returns
System.Single
ShowAreaLine
Section titled “ShowAreaLine”public bool ShowAreaLine { get; set; }Returns
System.Boolean
AngularInset
Section titled “AngularInset”public float AngularInset { get; set; }Returns
System.Single
AutoContrastText
Section titled “AutoContrastText”public bool AutoContrastText { get; set; }Returns
System.Boolean
EnableSelection
Section titled “EnableSelection”public bool EnableSelection { get; set; }Returns
System.Boolean
EnableHoverHighlight
Section titled “EnableHoverHighlight”public bool EnableHoverHighlight { get; set; }Returns
System.Boolean
EnableDragSelection
Section titled “EnableDragSelection”public bool EnableDragSelection { get; set; }Returns
System.Boolean
EnableViewportDrag
Section titled “EnableViewportDrag”public bool EnableViewportDrag { get; set; }Returns
System.Boolean
EnableViewportZoom
Section titled “EnableViewportZoom”public bool EnableViewportZoom { get; set; }Returns
System.Boolean
ViewportZoomSensitivity
Section titled “ViewportZoomSensitivity”public float ViewportZoomSensitivity { get; set; }Returns
System.Single
SelectionIndicatorStyle
Section titled “SelectionIndicatorStyle”public SelectionIndicatorStyle SelectionIndicatorStyle { get; set; }Returns
ChartGuru.SelectionIndicatorStyle
BarOrientation
Section titled “BarOrientation”public BarLayout BarOrientation { get; set; }Returns
ChartGuru.BarLayout
MorphStyle
Section titled “MorphStyle”public ChartMorphStyle MorphStyle { get; set; }Returns
ChartGuru.ChartMorphStyle
BackgroundColor
Section titled “BackgroundColor”public Color BackgroundColor { get; set; }Returns
UnityEngine.Color
PlotAreaBorderWidth
Section titled “PlotAreaBorderWidth”public float PlotAreaBorderWidth { get; set; }Returns
System.Single
PlotAreaCornerRadius
Section titled “PlotAreaCornerRadius”public float PlotAreaCornerRadius { get; set; }Returns
System.Single
PlotAreaBorderColor
Section titled “PlotAreaBorderColor”public Color PlotAreaBorderColor { get; set; }Returns
UnityEngine.Color
PlotAreaPaddingLeft
Section titled “PlotAreaPaddingLeft”public float PlotAreaPaddingLeft { get; set; }Returns
System.Single
PlotAreaPaddingRight
Section titled “PlotAreaPaddingRight”public float PlotAreaPaddingRight { get; set; }Returns
System.Single
PlotAreaPaddingTop
Section titled “PlotAreaPaddingTop”public float PlotAreaPaddingTop { get; set; }Returns
System.Single
PlotAreaPaddingBottom
Section titled “PlotAreaPaddingBottom”public float PlotAreaPaddingBottom { get; set; }Returns
System.Single
ChartBorderWidth
Section titled “ChartBorderWidth”public float ChartBorderWidth { get; set; }Returns
System.Single
ChartBorderCornerRadius
Section titled “ChartBorderCornerRadius”public float ChartBorderCornerRadius { get; set; }Returns
System.Single
ChartBorderColor
Section titled “ChartBorderColor”public Color ChartBorderColor { get; set; }Returns
UnityEngine.Color
UseForegroundGradient
Section titled “UseForegroundGradient”public bool UseForegroundGradient { get; set; }Returns
System.Boolean
ForegroundGradient
Section titled “ForegroundGradient”public Gradient ForegroundGradient { get; set; }Returns
UnityEngine.Gradient
ForegroundGradientStartPoint
Section titled “ForegroundGradientStartPoint”public UnitPoint ForegroundGradientStartPoint { get; set; }Returns
ChartGuru.UnitPoint
ForegroundGradientEndPoint
Section titled “ForegroundGradientEndPoint”public UnitPoint ForegroundGradientEndPoint { get; set; }Returns
ChartGuru.UnitPoint
DataLabelFormat
Section titled “DataLabelFormat”public string DataLabelFormat { get; set; }Returns
System.String
PieLabelMode
Section titled “PieLabelMode”public PieLabelMode PieLabelMode { get; set; }Returns
ChartGuru.PieLabelMode
OverrideDataLabelColor
Section titled “OverrideDataLabelColor”public bool OverrideDataLabelColor { get; set; }Returns
System.Boolean
DataLabelColor
Section titled “DataLabelColor”public Color DataLabelColor { get; set; }Returns
UnityEngine.Color
OverrideAxisLabelColor
Section titled “OverrideAxisLabelColor”public bool OverrideAxisLabelColor { get; set; }Returns
System.Boolean
AxisLabelColor
Section titled “AxisLabelColor”public Color AxisLabelColor { get; set; }Returns
UnityEngine.Color
XAxisIncludeZeroInDomain
Section titled “XAxisIncludeZeroInDomain”public bool XAxisIncludeZeroInDomain { get; set; }Returns
System.Boolean
YAxisIncludeZeroInDomain
Section titled “YAxisIncludeZeroInDomain”public bool YAxisIncludeZeroInDomain { get; set; }Returns
System.Boolean
HeatMapColorScalePreset
Section titled “HeatMapColorScalePreset”public int HeatMapColorScalePreset { get; set; }Returns
System.Int32
RadarRingStyle
Section titled “RadarRingStyle”public RadarRingStyle RadarRingStyle { get; set; }Returns
ChartGuru.RadarRingStyle
AnimationDuration
Section titled “AnimationDuration”public float AnimationDuration { get; set; }Returns
System.Single
AnimationEasing
Section titled “AnimationEasing”public Easing AnimationEasing { get; set; }Returns
ChartGuru.Easing
ScrollableAxes
Section titled “ScrollableAxes”public ScrollableAxes ScrollableAxes { get; set; }Returns
ChartGuru.ScrollableAxes
XVisibleDomainLength
Section titled “XVisibleDomainLength”public float XVisibleDomainLength { get; set; }Returns
System.Single
YVisibleDomainLength
Section titled “YVisibleDomainLength”public float YVisibleDomainLength { get; set; }Returns
System.Single
SelectedIndex
Section titled “SelectedIndex”public int SelectedIndex { get; }Returns
System.Int32
HoveredIndex
Section titled “HoveredIndex”public int HoveredIndex { get; }Returns
System.Int32
Events
Section titled “Events”
DataPointClicked
Section titled “DataPointClicked”public event Action<int, DataPoint> DataPointClickedRaised when the user selects a mark.
Returns
System.Action{System.Int32,ChartGuru.DataPoint}
DataPointHovered
Section titled “DataPointHovered”public event Action<int, DataPoint> DataPointHoveredRaised when the user hovers a mark.
Returns
System.Action{System.Int32,ChartGuru.DataPoint}
OnSelectionChanged
Section titled “OnSelectionChanged”public event Action<int> OnSelectionChangedRaised with the selected mark index after pointer or programmatic selection changes.
Returns
System.Action{System.Int32}
OnHoverChanged
Section titled “OnHoverChanged”public event Action<int> OnHoverChangedRaised with the hovered mark index, or -1 after the pointer leaves all marks.
Returns
System.Action{System.Int32}
OnMorphComplete
Section titled “OnMorphComplete”public event Action<ChartType> OnMorphCompleteRaised with the new chart type after an animated morph reaches its target.
Returns
System.Action{ChartGuru.ChartType}