EncDotNet.S100.Rendering.Scene 0.25.1

EncDotNet.S100.Rendering.Scene

EncDotNet.S100.Rendering.Scene holds the vector scene, the backend-neutral intermediate representation (IR) that sits between S-100 Part 9 portrayal and a rendering backend. It lowers a portrayal display list into an ordered list of fully resolved paint operations that any backend can draw. Reference it when you write your own rendering backend, or when you build or inspect scenes without depending on SkiaSharp, Mapsui or a UI framework. It depends only on EncDotNet.S100.Core and EncDotNet.S100.Portrayals.

To rasterise a scene, pair it with EncDotNet.S100.Renderers.Skia. For the end-to-end path without the EncDotNet.S100 facade, see Render images and map tiles.

Install

dotnet add package EncDotNet.S100.Rendering.Scene

Lower a display list to a scene

VectorSceneBuilder turns a DrawingInstruction display list and the matching feature geometry into a VectorScene. ResolveColor is required; the symbol, line-style and pattern resolvers are optional.

using EncDotNet.S100.Pipelines;
using EncDotNet.S100.Pipelines.Vector;
using EncDotNet.S100.Rendering.Scene;

static VectorScene Lower(
    IReadOnlyList<DrawingInstruction> instructions,
    IFeatureGeometryProvider geometryProvider,
    ColorPalette palette)
{
    var builder = new VectorSceneBuilder
    {
        ResolveColor = ColorResolver.Create(palette),
    };

    return builder.Build(instructions, geometryProvider);
}

Each op in scene.Ops is in S-100 Part 9 draw order. Coordinates are EPSG:3857 metres, sizes are logical display pixels (1 px = 0.32 mm), and colours are resolved to RgbaColor. The XML docs on PaintOp give the full unit contract.

Main types

Write a rendering backend

Every backend consumes the same VectorScene, so you can render S-100 portrayal through a backend other than Skia or Mapsui, such as a GPU, PDF or SVG renderer. Implement IVectorSceneRenderer<TSurface> when your backend can draw a scene to a surface on demand. Project op coordinates with WorldToScreen, and apply sizes such as stroke width and font size directly in display pixels.

The two shipped backends show both approaches:

• EncDotNet.S100.Renderers.Skia implements the interface: SkiaDisplayListRenderer is an IVectorSceneRenderer<SKCanvas>.
• EncDotNet.S100.Renderers.Mapsui binds a scene to a map layer and draws it on its own per-frame schedule. It consumes the IR without implementing the interface.

Because both backends draw the same scene, you can also compare backends on identical portrayal. For the guarantees the IR makes and a sample SVG backend, see the rendering-backend contract design note.

Stability and versioning

The supported surface of this package is VectorScene, the PaintOp hierarchy, VectorSceneBuilder, PatternPriorityClipper, PatternClipMemoizer, ColorResolver, ScaleVisibility and WebMercator. Internal and undocumented types can change at any time.

All EncDotNet.S100.* packages share one version, taken from the release git tag. Versioning follows Semantic Versioning: from 1.0.0 on, a breaking change to the supported surface comes only in a major version. Below 1.0.0, a minor version can include breaking changes, and the release notes list them.