Project

ChartForgeX

Render deterministic charts, dashboards, topology, hierarchy, and report visuals directly from .NET.

Stars 47
Forks 2
NuGet downloads 75,067
Release ChartForgeX-v2.0.0
Language: HTML Updated: 2026-10-12

API Reference

Class

TopologyMotionOptions

Namespace ChartForgeX.Topology
Assembly ChartForgeX.Stories
Modifiers sealed

Defines deterministic, script-free topology motion for SVG and sampled raster exports.

Inheritance

  • Object
  • TopologyMotionOptions

Usage

Explore 26 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 15

Constructors

public TopologyMotionOptions() #

Methods

public TopologyMotionOptions AddEdges(params String[] edgeIds) #
Returns: TopologyMotionOptions

Adds explicit edge ids to the route motion source.

Parameters

edgeIds System.String[] requiredposition: 0
The edge ids to animate.

Returns

The current motion options.

public TopologyMotionOptions AtProgress(Double progress) #
Returns: TopologyMotionOptions

Sets the sampled progress used by static raster frame rendering.

Parameters

progress System.Double requiredposition: 0
Progress from 0.0 to 1.0.

Returns

The current motion options.

public static TopologyMotionOptions RoutePulse(String? scenarioId = null, params String[] edgeIds) #
Returns: TopologyMotionOptions

Creates a route-pulse motion preset for topology scenarios and map routes.

Parameters

scenarioId System.String? = null optionalposition: 0
Optional scenario id to animate.
edgeIds System.String[] requiredposition: 1
Optional explicit edge ids to animate without requiring a scenario.

Returns

Topology motion options.

public static TopologyMotionOptions RoutePulseForEdges(params String[] edgeIds) #
Returns: TopologyMotionOptions

Creates a route-pulse motion preset from explicit topology edge ids.

Parameters

edgeIds System.String[] requiredposition: 0
Explicit edge ids to animate without requiring a scenario.

Returns

Topology motion options.

public static TopologyMotionOptions RoutePulseForScenario(String scenarioId) #
Returns: TopologyMotionOptions

Creates a route-pulse motion preset from a topology scenario.

Parameters

scenarioId System.String requiredposition: 0
Scenario id to animate.

Returns

Topology motion options.

public TopologyMotionOptions WithDuration(Double seconds) #
Returns: TopologyMotionOptions

Sets the animation duration.

Parameters

seconds System.Double requiredposition: 0
The duration in seconds.

Returns

The current motion options.

public TopologyMotionOptions WithEndpointPulses(Boolean enabled = true) #
Returns: TopologyMotionOptions

Enables or disables endpoint node pulses for explicit-edge route motion.

Parameters

enabled System.Boolean = true optionalposition: 0
Whether endpoint nodes should pulse.

Returns

The current motion options.

public TopologyMotionOptions WithFrameLimit(Int32 maximumFrames) #
Returns: TopologyMotionOptions

Sets the maximum number of frames sampled by animated raster exports.

Parameters

maximumFrames System.Int32 requiredposition: 0
The maximum sampled frame count.

Returns

The current motion options.

public TopologyMotionOptions WithFrameRate(Double framesPerSecond) #
Returns: TopologyMotionOptions

Sets the sampled frame rate used by animated raster exports.

Parameters

framesPerSecond System.Double requiredposition: 0
The sampled frame rate.

Returns

The current motion options.

public TopologyMotionOptions WithMarker(Double radius, String? color = null) #
Returns: TopologyMotionOptions

Sets the moving route marker radius and optional color.

Parameters

radius System.Double requiredposition: 0
The marker radius.
color System.String? = null optionalposition: 1
Optional marker color.

Returns

The current motion options.

public TopologyMotionOptions WithMarkerColor(String? color) #
Returns: TopologyMotionOptions

Sets the optional moving route marker color.

Parameters

color System.String? requiredposition: 0
The marker color. Empty values clear the override.

Returns

The current motion options.

Properties

public String? ScenarioId { get; set; } #

Gets or sets the scenario id used as the route source. When unset, the active scenario or first scenario is used.

public List<String> EdgeIds { get; } #

Gets edge ids used as an explicit route source. When set, these edges are animated without requiring a scenario.

public Double DurationSeconds { get; set; } #

Gets or sets the animation duration in seconds.

public Double FramesPerSecond { get; set; } #

Gets or sets the sampled frame rate used by animated raster exports.

public Int32 MaximumRasterFrames { get; set; } #

Gets or sets the maximum number of frames sampled by animated raster exports.

public Boolean Loop { get; set; } #

Gets or sets whether the animation loops.

public Double Progress { get; set; } #

Gets or sets the sampled progress from 0.0 to 1.0 used by raster frame rendering.

public Double MarkerRadius { get; set; } #

Gets or sets the moving route marker radius.

public String? MarkerColor { get; set; } #

Gets or sets the optional moving route marker color. When unset, the scenario or edge color is used.

public Boolean PulseRouteEndpoints { get; set; } #

Gets or sets whether explicit edge motion should pulse source and target nodes.