Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Imported fonts, neutral shaping values, text service contracts and the runtime script facade.

This project supplies backend-neutral text shaping and glyph rasterization. Its public values contain fonts, glyphs, metrics and coverage; they contain no Scene, GPU or RmlUi objects. Start with shape text and rasterize glyphs.

FontAsset preserves recoverable asset identity and imported runtime metadata. Metadata describes the encoded source length and face count; an unloaded payload yields null metadata. FontMetadataCodec validates the exact compact payload size and marker rather than accepting arbitrary serialized data.

TextStyle validates finite positive size, nonnegative face index, weight from 1 through 1000, a known slant and finite letter spacing. Construct it explicitly or use defaultValue; the zero-initialized struct does not represent a valid positive font size. TextShapingOptions validates direction and normalizes blank language/script hints to null. Backend capability determines how these requests are implemented.

TextLayout captures glyph values and metrics. GlyphBitmap copies exactly width * height coverage bytes and rejects invalid dimensions or nonfinite horizontal advance. Treat their exposed buffers and collections as read-only. They do not retain a font backend or grant permission to reuse a glyph ID with another face.

The static Text facade borrows the current ITextService. TextExecutionContext.EnterScope returns a caller-owned, strictly last-in-first-out binding scope; disposing it restores context and does not dispose the service. Normal sessions bind this scope for a complete frame.

The real Runtime script projection exports the facade, font and text value types under InnoEngine.Text. ITextService, ITextBackend, execution scopes, metadata codec and native face handles remain host-side contracts. Do not infer script availability from the source CLR reference.

ITextBackend.LoadFont returns a backend-local face handle. Its owner releases the face before backend disposal and never serializes that handle. Backend extensions explain creation and release responsibilities.

Browse text types and exact members. Runtime ownership and font importing describe the cooperating projects.

The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.

Project: Inno.Text
Source: src/services/text/Inno.Text/Inno.Text.csproj

Type API Description
FontAsset engine Represents one imported OpenType font file or collection.
FontMetadata engine Describes immutable metadata for an imported OpenType font source.
FontMetadataCodec engine Encodes the compact runtime payload shared by the font importer and text runtime.
GlyphBitmap engine Contains one rasterized glyph as tightly packed 8-bit coverage.
ITextBackend engine Defines the replaceable native shaping and glyph-rasterization boundary.
ITextService engine Provides backend-neutral Unicode shaping and glyph rasterization for imported fonts.
Text engine Provides script-friendly access to Unicode shaping and glyph rasterization.
TextDirection engine Selects the logical direction used by the shaping engine.
TextExecutionContext engine Binds one text service to the current asynchronous execution context.
TextFontHandle engine Identifies one font face loaded into a text backend generation.
TextFontStyle engine Selects the typographic slant requested from a font face.
TextGlyph engine Describes one positioned glyph emitted by Unicode shaping.
TextLayout engine Contains immutable positioned glyphs and aggregate bounds for one shaped string.
TextMetrics engine Describes scalable metrics for one font face and logical size.
TextShapingOptions engine Defines language and script hints for one shaping operation.
TextStyle engine Defines immutable font selection and sizing for one shaping operation.
FontAsset Runtime Represents one imported OpenType font file or collection.
FontMetadata Runtime Describes immutable metadata for an imported OpenType font source.
GlyphBitmap Runtime Contains one rasterized glyph as tightly packed 8-bit coverage.
Text Runtime Provides script-friendly access to Unicode shaping and glyph rasterization.
TextDirection Runtime Selects the logical direction used by the shaping engine.
TextFontStyle Runtime Selects the typographic slant requested from a font face.
TextGlyph Runtime Describes one positioned glyph emitted by Unicode shaping.
TextLayout Runtime Contains immutable positioned glyphs and aggregate bounds for one shaped string.
TextMetrics Runtime Describes scalable metrics for one font face and logical size.
TextShapingOptions Runtime Defines language and script hints for one shaping operation.
TextStyle Runtime Defines immutable font selection and sizing for one shaping operation.