KernSmith.Rasterizers.StbTrueType 0.15.1

KernSmith.Rasterizers.StbTrueType

A pure C# rasterizer backend for KernSmith using StbTrueTypeSharp.

Overview

This package provides a cross-platform rasterizer with zero native dependencies. It supports SDF rendering and works on any .NET platform including Blazor WASM, iOS AOT, and serverless environments.

Platform: Cross-platform (net8.0, net10.0). No native libraries required.

Usage

Install the package and set the rasterizer backend:

dotnet add package KernSmith.Rasterizers.StbTrueType

var options = new FontGeneratorOptions
{
 Size = 32,
 RasterizerBackend = RasterizerBackend.StbTrueType
};

The rasterizer auto-registers via [ModuleInitializer], so referencing the package is sufficient.

Limitations

• No TrueType hinting (lower quality at small sizes < 16px)
• No color font support (COLR/CPAL)
• No variable font support
• TTF only (no OTF/CFF outlines)
• No system font loading

For these features, use the FreeType backend.

Blazor WASM

This is the recommended backend for Blazor WebAssembly — zero native dependencies, works with trimming and AOT compilation.

// Program.cs — prevent trimmer from stripping the assembly
RuntimeHelpers.RunClassConstructor(
 typeof(StbTrueTypeRasterizer).TypeHandle);

Enable AOT for production performance:

<RunAOTCompilation>true</RunAOTCompilation>

See the Blazor WASM sample for a complete working example.

Build

dotnet build src/KernSmith.Rasterizers.StbTrueType/KernSmith.Rasterizers.StbTrueType.csproj

See the KernSmith repository for full project documentation.

Third-Party Licenses

The synthetic-bold feature ports FreeType's FT_Outline_EmboldenXY algorithm, used under the FreeType License (FTL).

Portions of this software are copyright © 2023 The FreeType Project (www.freetype.org). All rights reserved.

See THIRD-PARTY-NOTICES.md (packaged at the package root) for the full license text.