Skip to content
ChartForgeX

API Reference

Class

VisualTheme

Namespace ChartForgeX.Themes
Assembly ChartForgeX
Modifiers sealed

A paired immutable theme shared by charts, diagrams and future composition packages.

Inheritance

  • Object
  • VisualTheme

Usage

Explore 81 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Accepted by parameters 36

Constructors

public VisualTheme(VisualDesignTokens light, VisualDesignTokens dark, VisualTypography? typography = null, Double spacing = 12, Double seriesStrokeWidth = 2, Double markerRadius = 3, Double areaOpacity = 0.18, Double barRadius = 3, Double gridStrokeWidth = 1, Double axisStrokeWidth = 1, Double cardRadius = 3, Double cardShadowOpacity = 0, ChartColor? cardShadowColor = null, Double gaugeStrokeWidth = 14, Double gaugeBandWidth = 4, Double plotRadius = 3) #

Creates a paired theme from independent token snapshots and geometry settings.

Parameters

light ChartForgeX.Themes.VisualDesignTokens requiredposition: 0
dark ChartForgeX.Themes.VisualDesignTokens requiredposition: 1
typography ChartForgeX.Themes.VisualTypography? = null optionalposition: 2
spacing System.Double = 12 optionalposition: 3
seriesStrokeWidth System.Double = 2 optionalposition: 4
markerRadius System.Double = 3 optionalposition: 5
areaOpacity System.Double = 0.18 optionalposition: 6
barRadius System.Double = 3 optionalposition: 7
gridStrokeWidth System.Double = 1 optionalposition: 8
axisStrokeWidth System.Double = 1 optionalposition: 9
cardRadius System.Double = 3 optionalposition: 10
cardShadowOpacity System.Double = 0 optionalposition: 11
cardShadowColor ChartForgeX.Primitives.ChartColor? = null optionalposition: 12
gaugeStrokeWidth System.Double = 14 optionalposition: 13
gaugeBandWidth System.Double = 4 optionalposition: 14
plotRadius System.Double = 3 optionalposition: 15

Methods

public static VisualTheme Accessible() #
Returns: VisualTheme

Creates a framed report palette with distinct colors for colorblind readers.

public static VisualTheme Aurora() #
Returns: VisualTheme

Creates a vibrant dark palette for product and status dashboards.

public static VisualTheme Candy() #
Returns: VisualTheme

Creates a soft light palette with rounded typography and surfaces.

public static VisualTheme Colorblind() #
Returns: VisualTheme

Creates a light report palette with distinct colors for colorblind readers.

public VisualTheme Configure(Action<VisualThemeBuilder> configure) #
Returns: VisualTheme

Creates a new immutable theme by configuring an independent builder.

Parameters

configure System.Action<ChartForgeX.Themes.VisualThemeBuilder> requiredposition: 0
public static VisualTheme Dashboard() #
Returns: VisualTheme

Creates a bright operational dashboard palette for KPIs and utilization panels.

public static VisualTheme Editorial() #
Returns: VisualTheme

Creates a warm publication palette with serif typography.

public static VisualTheme Executive() #
Returns: VisualTheme

Creates a restrained executive report palette with framed surfaces.

public static VisualTheme FromJson(String json) #
Returns: VisualTheme

Loads a version 1 paired theme, including canonical palettes, typography and geometry.

Parameters

json System.String requiredposition: 0
The case-sensitive versioned theme document, at most one MiB of characters.

Returns

An immutable theme snapshot.

Exceptions

  • ArgumentException – The document is malformed, unsupported, incomplete or outside input limits.
public static VisualTheme FromPaletteJson(String json, VisualTypography? typography = null) #
Returns: VisualTheme

Creates a theme from generated HtmlForgeX color palettes without changing geometry.

Parameters

json System.String requiredposition: 0
typography ChartForgeX.Themes.VisualTypography? = null optionalposition: 1
public static VisualTheme Graphite() #
Returns: VisualTheme

Gets the Graphite layout preset with the canonical HtmlForgeX light/dark colors.

public static VisualTheme Minimal() #
Returns: VisualTheme

Creates a crisp light palette for dense business dashboards.

public static VisualTheme PeopleInfographic() #
Returns: VisualTheme

Creates a cyan and magenta palette for demographic and survey graphics.

public static VisualTheme Product() #
Returns: VisualTheme

Creates a vivid product dashboard palette with floating surfaces.

public static VisualTheme Report() #
Returns: VisualTheme

Creates a paired light and dark theme for reports and generated HTML.

public VisualThemeColors Resolve(VisualThemeMode mode) #
Returns: VisualThemeColors

Resolves the selected immutable color snapshot.

Parameters

mode ChartForgeX.Themes.VisualThemeMode requiredposition: 0
public static VisualTheme RestaurantDashboard() #
Returns: VisualTheme

Creates a soft light dashboard palette for restaurant operations panels.

public static VisualTheme SaasDashboard() #
Returns: VisualTheme

Creates a light dashboard palette for revenue trends, targets and driver cards.

public static VisualTheme Terminal() #
Returns: VisualTheme

Creates a compact green technical palette with monospace typography.

public String ToJson() #
Returns: String

Exports the complete paired color, typography and geometry theme using schemaVersion 1.

Returns

A deterministic JSON document suitable for VisualTheme.FromJson.

public static VisualTheme TransparentOverlay() #
Returns: VisualTheme

Creates a transparent dark overlay palette for imagery and wallpapers.

public VisualTheme WithFontFamily(String family) #
Returns: VisualTheme

Creates a theme with the supplied family and all other typography preserved.

Parameters

family System.String requiredposition: 0
WithPalette 2 overloads
public VisualTheme WithPalette(VisualThemeMode mode, params ChartColor[] colors) #
Returns: VisualTheme

Creates a theme with a categorical palette for one explicit mode.

Parameters

mode ChartForgeX.Themes.VisualThemeMode requiredposition: 0
colors ChartForgeX.Primitives.ChartColor[] requiredposition: 1
public VisualTheme WithPalette(params ChartColor[] colors) #
Returns: VisualTheme

Creates a theme with the supplied categorical palette in both modes.

Parameters

colors ChartForgeX.Primitives.ChartColor[] requiredposition: 0
public VisualTheme WithTypography(VisualTypography typography) #
Returns: VisualTheme

Creates an independent paired theme with the supplied typography and the same colors, geometry and effects.

Parameters

typography ChartForgeX.Themes.VisualTypography requiredposition: 0
The complete font scale to use for the new theme.

Properties

public VisualTypography Typography { get; } #

Gets the typography scale.

public Double Spacing { get; } #

Gets the standard layout gap.

public Double SeriesStrokeWidth { get; } #

Gets the default data-line width.

public Double MarkerRadius { get; } #

Gets the default point radius.

public Double AreaOpacity { get; } #

Gets the area fill opacity.

public Double BarRadius { get; } #

Gets the bar corner radius.

public Double CardRadius { get; } #

Gets the shared outer card corner radius, independent of plot and data mark radii.

public Double PlotRadius { get; } #

Gets the plot surface corner radius, independent of card and mark radii.

public Double CardShadowOpacity { get; } #

Gets the shared card shadow opacity. Zero keeps the default flat surface.

public ChartColor CardShadowColor { get; } #

Gets the shared card shadow color, including its authored alpha.

public Double GridStrokeWidth { get; } #

Gets the guide width.

public Double AxisStrokeWidth { get; } #

Gets the axis width.

public Double GaugeStrokeWidth { get; } #

Gets the gauge track and value stroke width.

public Double GaugeBandWidth { get; } #

Gets the gauge threshold band width.