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

Interface

IVisualBlock

Namespace ChartForgeX.VisualBlocks
Assembly ChartForgeX
Modifiers abstract

Common contract for renderable non-chart visual blocks.

Usage

Explore 56 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.

Returned or exposed by 1

Accepted by parameters 55

Properties

public abstract String Title { get; } #

Gets the block title.

public abstract String Subtitle { get; } #

Gets the block subtitle.

public abstract VisualBlockOptions Options { get; } #

Gets shared rendering options.

public abstract String AccessibleName { get; } #

Gets a concise accessibility label.

Extension Methods

public static Void Save(IVisualBlock block, String path, RasterImageOptions? rasterOptions = null) #
Returns: Void

Saves a visual block using the output path extension to choose SVG, HTML, PNG, or another raster image format.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
rasterOptions ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
public static Void SaveBmp(IVisualBlock block, String path, RasterImageOptions? options = null) #
Returns: Void

Saves a visual block as a BMP file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
public static Void SaveHtml(IVisualBlock block, String path) #
Returns: Void

Saves a visual block as a complete HTML file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
public static Void SavePng(IVisualBlock block, String path) #
Returns: Void

Saves a visual block as a PNG file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
public static Void SavePpm(IVisualBlock block, String path, RasterImageOptions? options = null) #
Returns: Void

Saves a visual block as a PPM file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
SaveRasterImage 2 overloads
public static Void SaveRasterImage(IVisualBlock block, String path, RasterImageFormat format, RasterImageOptions? options = null) #
Returns: Void

Saves a visual block as an opaque raster image file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
format ChartForgeX.Core.RasterImageFormat requiredposition: 2
The raster image format.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 3
Optional raster export options.
public static Void SaveRasterImage(IVisualBlock block, String path, RasterImageOptions? options = null) #
Returns: Void

Saves a visual block as an opaque raster image file using the output path extension to choose the format.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
public static Void SaveSvg(IVisualBlock block, String path) #
Returns: Void

Saves a visual block as an SVG file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
public static Void SaveTiff(IVisualBlock block, String path, RasterImageOptions? options = null) #
Returns: Void

Saves a visual block as a TIFF file.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
path System.String requiredposition: 1
The output file path.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
public static Byte[] ToBmp(IVisualBlock block, RasterImageOptions? options = null) #
Returns: Byte[]

Renders a visual block to BMP bytes.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 1
Optional raster export options.

Returns

A BMP image.

ToHtmlFragment 2 overloads
public static String ToHtmlFragment(IVisualBlock block) #
Returns: String

Renders a visual block to a standalone HTML fragment containing inline SVG.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.

Returns

An HTML fragment.

public static String ToHtmlFragment(IVisualBlock block, String idScope) #
Returns: String

Renders a visual block to an HTML fragment with an additional deterministic ID scope.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
idScope System.String requiredposition: 1
A caller-provided scope used to keep IDs unique when embedding equivalent fragments together.

Returns

An HTML fragment.

public static String ToHtmlPage(IVisualBlock block) #
Returns: String

Renders a visual block to a complete HTML document.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.

Returns

An HTML page.

public static Byte[] ToPng(IVisualBlock block) #
Returns: Byte[]

Renders a visual block to PNG bytes.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.

Returns

A PNG image.

public static Byte[] ToPpm(IVisualBlock block, RasterImageOptions? options = null) #
Returns: Byte[]

Renders a visual block to PPM bytes.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 1
Optional raster export options.

Returns

A PPM image.

public static Byte[] ToRasterImage(IVisualBlock block, RasterImageFormat format, RasterImageOptions? options = null) #
Returns: Byte[]

Renders a visual block to opaque raster image bytes.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
format ChartForgeX.Core.RasterImageFormat requiredposition: 1
The raster image format.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.

Returns

Encoded raster image bytes.

public static RgbaImage ToRgbaImage(IVisualBlock block) #
Returns: RgbaImage

Renders a visual block directly to an in-memory RGBA image without encoding it.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.

Returns

The rendered RGBA image.

ToSvg 2 overloads
public static String ToSvg(IVisualBlock block) #
Returns: String

Renders a visual block to SVG markup.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.

Returns

SVG markup.

public static String ToSvg(IVisualBlock block, String idScope) #
Returns: String

Renders a visual block to SVG markup with an additional deterministic ID scope.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
idScope System.String requiredposition: 1
A caller-provided scope used to keep SVG element IDs unique when embedding multiple SVGs in one document.

Returns

SVG markup.

public static Byte[] ToTiff(IVisualBlock block, RasterImageOptions? options = null) #
Returns: Byte[]

Renders a visual block to TIFF bytes.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 1
Optional raster export options.

Returns

A TIFF image.

public static VisualArtifact ToVisualArtifact(IVisualBlock block, String? id = null, VisualArtifactSourceLanguage sourceLanguage = Native) #
Returns: VisualArtifact

Wraps a non-chart visual block in a reusable visual artifact.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
id System.String? = null optionalposition: 1
sourceLanguage ChartForgeX.VisualArtifacts.VisualArtifactSourceLanguage = Native optionalposition: 2
public static Void WriteBmp(IVisualBlock block, Stream stream, RasterImageOptions? options = null) #
Returns: Void

Writes a visual block to a BMP stream.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
stream System.IO.Stream requiredposition: 1
The destination stream.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
public static Void WritePpm(IVisualBlock block, Stream stream, RasterImageOptions? options = null) #
Returns: Void

Writes a visual block to a PPM stream.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
stream System.IO.Stream requiredposition: 1
The destination stream.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.
public static Void WriteRasterImage(IVisualBlock block, Stream stream, RasterImageFormat format, RasterImageOptions? options = null) #
Returns: Void

Writes a visual block to an opaque raster image stream.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
stream System.IO.Stream requiredposition: 1
The destination stream.
format ChartForgeX.Core.RasterImageFormat requiredposition: 2
The raster image format.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 3
Optional raster export options.
public static Void WriteTiff(IVisualBlock block, Stream stream, RasterImageOptions? options = null) #
Returns: Void

Writes a visual block to a TIFF stream.

Parameters

block ChartForgeX.VisualBlocks.IVisualBlock requiredposition: 0
The visual block to render.
stream System.IO.Stream requiredposition: 1
The destination stream.
options ChartForgeX.Core.RasterImageOptions? = null optionalposition: 2
Optional raster export options.