Swift Charts to Unity C#: API cheat sheet

Chart Guru follows the vocabulary of Apple’s Swift Charts: marks, plottable values, modifiers, scales and the chart proxy. If you know Swift Charts, this page shows where each concept lives in Unity C#. If you have never written Swift, read it as a map of a small, consistent vocabulary with proven defaults; you do not need Swift to use any of it.

How names translate from Swift to C#

Every public Chart Guru member uses PascalCase, including fluent builders, mark modifiers, extension methods and generated code. Swift’s .chartXAxis becomes .ChartXAxis, .foregroundStyle becomes .ForegroundStyle and .value becomes PlottableValue.Value. There are deliberately no lower camel case aliases, so C# code stays idiomatic. The importer still reads real Swift casing and generates PascalCase C#.

A few more rules cover most of the remaining differences:

• Result builders become builder chains. Chart { ... } becomes Chart.Create(), one .Add(...) per mark, chart modifiers, then .Build(). Show the result on a host with SetChart: a ChartGraphic on a Canvas or a ChartGuruElement in UI Toolkit.
• Argument labels become positions and enum members. BarMark(x: .value(...), y: .value(...)) becomes new BarMark(PlottableValue.Value(...), PlottableValue.Value(...)), and .bottom becomes LegendPosition.Bottom.
• Bindings become callbacks. Where Swift writes $selection, C# passes an Action that receives the selected value.
• Symbol sizes are diameters. Swift sizes symbols by area, Chart Guru by diameter. The importer converts numeric sizes, so do not copy them by hand.

Here is one chart in both languages. The Swift version:

Chart(sales) { sale in
    BarMark(
        x: .value("Quarter", sale.quarter),
        y: .value("Revenue", sale.revenue)
    )
    .foregroundStyle(by: .value("Region", sale.region))
}
.chartYAxisLabel("Revenue")
.chartLegend(position: .bottom)

The Chart Guru version in Unity:

Chart chart = Chart.Create(sales, sale => new BarMark(
        PlottableValue.Value("Quarter", sale.Quarter),
        PlottableValue.Value("Revenue", sale.Revenue))
        .ForegroundStyle(PlottableValue.Value("Region", sale.Region)))
    .ChartYAxis(axis => axis.Label("Revenue"))
    .ChartLegend(LegendPosition.Bottom)
    .Build();
host.SetChart(chart);

Coverage at a glance

Chart Guru ships a parity inventory that rates 237 Swift Charts concepts: 212 Full, 22 Partial, 1 Missing and 2 N/A. Full means an equivalent API covers the concept and its behavior within the documented host limits. It does not mean verified pixel parity with native Swift Charts renders. Features Chart Guru adds on top, such as compact charts and chart-type morphs, are listed separately as extras. The tables below follow the inventory as of version 1.4 and name every Partial, Missing and N/A row they include, with the reason.

Container and builder

Marks

Chart Guru also has marks Swift Charts leaves to you: CandleStickMark for OHLC data and the HeatMap(values, colorScale) builder helper.

Mark modifiers

Axes

Scales

As in Swift Charts, only the first scale modifier for an axis applies, so combine domain, range and type in that call.

Legend

There is no overlay position. Left and Right place the legend inside the plot, a Chart Guru extension that the Swift export writes as .leading or .trailing and reports. A legend with LegendConfig.Interactive hides a series on click, which Swift Charts does not do on its own.

Plot area

Titles and annotations

Selection and interaction

Tooltips (ChartTooltip) and linked selection across charts (ChartSelectionLink) are built in, where a Swift app would compose them from overlays.

Scrolling and zooming

Animation

Morphs between chart types (MorphTo) and replayed entry animations are Chart Guru additions.

Data and live updates

Accessibility

The accessible charts article covers these in practice.

3D with Chart3D

Swift Charts 3D adds a Z value to its marks, and Chart Guru does the same with the same builder shape:

Chart3D {
    PointMark(
        x: .value("Flipper (mm)", 190),
        y: .value("Mass (g)", 3700),
        z: .value("Bill (mm)", 38.8)
    )
    .symbol(.sphere)
}
.chart3DPose(.default)

Chart chart = Chart3D.Create()
    .Add(new PointMark3D(PlottableValue.Value("Flipper (mm)", 190f), PlottableValue.Value("Mass (g)", 3700f), PlottableValue.Value("Bill (mm)", 38.8f))
        .Symbol(Symbol3D.Sphere))
    .Chart3DPose(Chart3DPose.Default)
    .Build();
chart3D.SetChart(chart);

Beyond Apple’s set, Chart Guru adds Bar3DMark, Line3DMark, Area3DMark, Sector3DMark, Donut3DMark and Radar3DMark, lifts 2D marks into depth with .Z(z), and animates compatible charts from 2D into 3D. The Chart Guru 3D page covers the 3D module.

Let the importer write the first draft

You rarely need to translate by hand. Paste supported Swift Chart or Chart3D code into the Chart Designer or a chart Inspector and Chart Guru reads the marks, literal data, loops, modifiers, axes, scales, legends, annotations and scrolling, then generates PascalCase C#. It reports unsupported or partial constructs by name, and data the source computes with app code it cannot run is reported instead of replaced with invented values. Arbitrary Swift app code does not convert; chart-focused code does. Going the other way, Copy Swift writes a chart back as Swift Charts code and lists the Chart Guru extensions it cannot carry.

The examples include 41 Swift Charts samples with their native renders, used by the Swift Import lesson, so you can compare an import with the original. Samples 27 to 44 are adapted from Jordi Bruin’s Swift Charts Examples under the MIT license. The paste Swift Charts code use case walks through the workflow, and the API quick reference lists the main types.

Sources: SwiftChartsFeatureParity.md in the Chart Guru 1.4 package and the Chart Guru API reference, checked 2026-11-11. Chart Guru is available on the Unity Asset Store.