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

TopologyRenderOptionsExtensions

Namespace ChartForgeX.Topology
Assembly ChartForgeX
Modifiers static

Provides reusable topology render-option presets.

Inheritance

  • Object
  • TopologyRenderOptionsExtensions

Methods

public static TopologyRenderOptions ApplyLayoutPreset(TopologyRenderOptions options, TopologyLayoutPreset preset) #
Returns: TopologyRenderOptions

Applies a reusable topology spacing and presentation profile.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
preset ChartForgeX.Topology.TopologyLayoutPreset requiredposition: 1
public static TopologyRenderOptions ApplyPreset(TopologyRenderOptions options, TopologyViewPreset preset) #
Returns: TopologyRenderOptions

Applies a preset to existing render options.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
preset ChartForgeX.Topology.TopologyViewPreset requiredposition: 1
The preset to apply.

Returns

The current render options.

public static TopologyRenderOptions WithActiveScenario(TopologyRenderOptions options, String scenarioId) #
Returns: TopologyRenderOptions

Activates an existing topology scenario for static highlighting and initial interactive HTML state.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
scenarioId System.String requiredposition: 1
The scenario id.

Returns

The current render options.

public static TopologyRenderOptions WithEdgeMetricLabels(TopologyRenderOptions options, String? primaryMetricKey, String? secondaryMetricKey = null, String? tertiaryMetricKey = null) #
Returns: TopologyRenderOptions

Uses edge metrics as stacked edge labels.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
primaryMetricKey System.String? requiredposition: 1
The metric key for the primary edge label.
secondaryMetricKey System.String? = null optionalposition: 2
The optional metric key for the secondary edge label.
tertiaryMetricKey System.String? = null optionalposition: 3
The optional metric key for the tertiary edge label.

Returns

The current render options.

public static TopologyRenderOptions WithFitContentToViewport(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Keeps topology output at the requested viewport size by scaling dense rendered content down when needed.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithForceGraphStyle(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Applies a readable force-graph treatment for relationship-heavy topology clouds.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithForceLayout(TopologyRenderOptions options, TopologyForceLayoutProfile profile, Int32? iterations = null) #
Returns: TopologyRenderOptions

Selects a deterministic force-directed solver profile.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
profile ChartForgeX.Topology.TopologyForceLayoutProfile requiredposition: 1
The force layout profile.
iterations System.Int32? = null optionalposition: 2
Optional solver iteration override.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlControlPlacement(TopologyRenderOptions options, TopologyHtmlControlPlacement placement) #
Returns: TopologyRenderOptions

Places viewport, fullscreen, and export controls inside the interactive HTML topology viewport.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
placement ChartForgeX.Topology.TopologyHtmlControlPlacement requiredposition: 1
The control placement.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlForceGraphControls(TopologyRenderOptions options, Boolean enabled = true) #
Returns: TopologyRenderOptions

Enables or disables force-directed graph exploration controls in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
enabled System.Boolean = true optionalposition: 1
Whether interactive HTML should render graph exploration controls.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlFullscreenControl(TopologyRenderOptions options, Boolean enabled = true) #
Returns: TopologyRenderOptions

Enables or disables the fullscreen viewport control in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
enabled System.Boolean = true optionalposition: 1
Whether interactive HTML should render a fullscreen control.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlScenarioCheckboxes(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Renders topology scenarios as independent route checkboxes.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlScenarioControlMode(TopologyRenderOptions options, TopologyHtmlScenarioControlMode mode) #
Returns: TopologyRenderOptions

Chooses how topology scenario controls are rendered in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
mode ChartForgeX.Topology.TopologyHtmlScenarioControlMode requiredposition: 1
The scenario control mode.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlScenarioControls(TopologyRenderOptions options, Boolean enabled = true) #
Returns: TopologyRenderOptions

Enables or disables topology scenario picker controls in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
enabled System.Boolean = true optionalposition: 1
Whether interactive HTML should render scenario picker controls.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlScenarioPanel(TopologyRenderOptions options, Boolean enabled = true) #
Returns: TopologyRenderOptions

Enables or disables the compact topology scenario detail panel in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
enabled System.Boolean = true optionalposition: 1
Whether interactive HTML should render the scenario detail panel.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlScenarioUrlState(TopologyRenderOptions options, Boolean enabled = true) #
Returns: TopologyRenderOptions

Enables or disables query-string scenario state in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
enabled System.Boolean = true optionalposition: 1
Whether interactive HTML should read and update scenario state from the page query string.

Returns

The current render options.

public static TopologyRenderOptions WithHtmlSelectionPanel(TopologyRenderOptions options, Boolean enabled = true) #
Returns: TopologyRenderOptions

Enables or disables the built-in selected-record panel in interactive HTML output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
enabled System.Boolean = true optionalposition: 1
Whether interactive HTML should render the selected-record panel.

Returns

The current render options.

public static TopologyRenderOptions WithLuminousTopologyEdges(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Uses a stronger luminous topology edge style for dark dashboards and deliberate emphasis.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithMindMapStyle(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Applies a clean informational treatment for centered mind maps.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithMonitoringDashboardStyle(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Applies the reusable monitoring-dashboard visual treatment used for dense topology and geographic monitoring views.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithMultilineNodeLabels(TopologyRenderOptions options, Boolean wrap = true, Int32 maxLabelLines = 2, Int32 maxSubtitleLines = 2) #
Returns: TopologyRenderOptions

Enables reusable multi-line node labels and optional word wrapping for dense relationship diagrams.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
wrap System.Boolean = true optionalposition: 1
Whether text should wrap at word boundaries when it exceeds the available width.
maxLabelLines System.Int32 = 2 optionalposition: 2
The maximum title rows.
maxSubtitleLines System.Int32 = 2 optionalposition: 3
The maximum subtitle rows.

Returns

The current render options.

public static TopologyRenderOptions WithNeutralGroupSurfaces(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Renders group containers as neutral cards while preserving status/identity borders and labels.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithoutActiveScenario(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Clears the active topology scenario.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithPlainTopologyEdges(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Uses a plain single-stroke topology edge style without halo or highlight layers.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithRelationshipOverviewStyle(TopologyRenderOptions options) #
Returns: TopologyRenderOptions

Applies a reusable relationship-overview treatment for entity maps, dependency overviews, and evidence correlation diagrams.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.

Returns

The current render options.

public static TopologyRenderOptions WithRelationshipRadialFocus(TopologyRenderOptions options, String nodeId, Int32 maxDepth = 2, Int32 maxFanout = 18) #
Returns: TopologyRenderOptions

Selects the root and caps used by relationship-radial ego layouts.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
nodeId System.String requiredposition: 1
The root node id.
maxDepth System.Int32 = 2 optionalposition: 2
The maximum number of relationship hops to expand.
maxFanout System.Int32 = 18 optionalposition: 3
The maximum neighbor count expanded per node.

Returns

The current render options.

public static TopologyRenderOptions WithRequiredIcons(TopologyRenderOptions options, Boolean required = true) #
Returns: TopologyRenderOptions

Requires all topology icon ids to resolve in the active icon catalog before rendering.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
required System.Boolean = true optionalposition: 1
Whether unresolved icon ids should fail validation.

Returns

The current render options.

public static TopologyRenderOptions WithSelectedEdge(TopologyRenderOptions options, String edgeId) #
Returns: TopologyRenderOptions

Marks a topology edge as selected without filtering or dimming the chart.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
edgeId System.String requiredposition: 1
The edge id.

Returns

The current render options.

public static TopologyRenderOptions WithSelectedGroup(TopologyRenderOptions options, String groupId) #
Returns: TopologyRenderOptions

Marks a topology group as selected without filtering or dimming the chart.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
groupId System.String requiredposition: 1
The group id.

Returns

The current render options.

public static TopologyRenderOptions WithSelectedNode(TopologyRenderOptions options, String nodeId) #
Returns: TopologyRenderOptions

Marks a topology node as selected without filtering or dimming the chart.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
nodeId System.String requiredposition: 1
The node id.

Returns

The current render options.

public static TopologyRenderOptions WithStateColorsPinnedInForcedColors(TopologyRenderOptions options, Boolean pin = true) #
Returns: TopologyRenderOptions

Keeps status marks in their colours in forced-colours mode (see TopologyRenderOptions.PinStateColorsInForcedColors).

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
pin System.Boolean = true optionalposition: 1
True to pin the status colours; false (the default) lets forced colours apply.

Returns

The current render options.

public static TopologyRenderOptions WithTopologyEdgeVisualStyle(TopologyRenderOptions options, ChartLineVisualStyle? style) #
Returns: TopologyRenderOptions

Uses a caller supplied visual style for topology edge strokes across SVG and PNG output.

Parameters

options ChartForgeX.Topology.TopologyRenderOptions requiredposition: 0
The render options.
style ChartForgeX.Core.ChartLineVisualStyle? requiredposition: 1
The edge stroke visual style. Pass null to return to the topology default.

Returns

The current render options.