# OfficeFontFaceCollection

Scoped caller-supplied font faces used by drawing measurement, rasterization, and SVG export.

Class 

`OfficeIMO.Drawing`

**Namespace**

`OfficeIMO.Drawing`

**Assembly**

`OfficeIMO.Core`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[OfficeFontFaceCollection.cs:11](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L11)

**Modifiers**

sealed

Scoped caller-supplied font faces used by drawing measurement, rasterization, and SVG export. Direct TrueType/OpenType, WOFF 1, WOFF 2, CFF/CFF2, and variable-font containers are handled by the first-party engine. An optional provider can override program loading for specialized engines.

## Inheritance

- object
- OfficeFontFaceCollection

## Usage

Explore 18 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 13

- Property [OfficeDrawing.Fonts](/api/core/officeimo-drawing-officedrawing/#property-fonts)
- Method [OfficeFontFaceCollection.Add](/api/core/officeimo-drawing-officefontfacecollection/#method-add-string-byte-officeimo-drawing-officefontstyle)
- Method [OfficeFontFaceCollection.AddAlias](/api/core/officeimo-drawing-officefontfacecollection/#method-addalias-string-string)
- Method [OfficeFontFaceCollection.AddFallbackFamily](/api/core/officeimo-drawing-officefontfacecollection/#method-addfallbackfamily-string)
- Method [OfficeFontFaceCollection.AddRange](/api/core/officeimo-drawing-officefontfacecollection/#method-addrange-officeimo-drawing-officefontfacecollection)
- Method [OfficeFontFaceCollection.AddRangePreservingExisting](/api/core/officeimo-drawing-officefontfacecollection/#method-addrangepreservingexisting-officeimo-drawing-officefontfacecollection)
- Method [OfficeFontFaceCollection.Clone](/api/core/officeimo-drawing-officefontfacecollection/#method-clone)
- Property [OfficeFontFallbackPack.Fonts](/api/core/officeimo-drawing-officefontfallbackpack/#property-fonts)
- Property [OfficeImageExportOptions.Fonts](/api/core/officeimo-drawing-officeimageexportoptions/#property-fonts)
- Property [OfficeMathRenderOptions.Fonts](/api/core/officeimo-drawing-officemathrenderoptions/#property-fonts)
- Property [OfficeRasterTextOptions.Fonts](/api/core/officeimo-drawing-officerastertextoptions/#property-fonts)
- Property [OfficeRenderingProfile.Fonts](/api/core/officeimo-drawing-officerenderingprofile/#property-fonts)
- Property [OfficeSvgDrawingReaderOptions.Fonts](/api/core/officeimo-drawing-officesvgdrawingreaderoptions/#property-fonts)

### Accepted by parameters 5

- Method [OfficeFontFaceCollection.AddRange](/api/core/officeimo-drawing-officefontfacecollection/#method-addrange-officeimo-drawing-officefontfacecollection) parameter `fonts`
- Method [OfficeFontFaceCollection.AddRangePreservingExisting](/api/core/officeimo-drawing-officefontfacecollection/#method-addrangepreservingexisting-officeimo-drawing-officefontfacecollection) parameter `fonts`
- Constructor [OfficeFontFallbackPack.OfficeFontFallbackPack](/api/core/officeimo-drawing-officefontfallbackpack/#constructor-ctor-string-string-officeimo-drawing-officefontfacecollection) parameter `fonts`
- Constructor [OfficeRasterCanvas.OfficeRasterCanvas](/api/core/officeimo-drawing-officerastercanvas/#constructor-ctor-officeimo-drawing-officerasterimage-officeimo-drawing-officetruetypefont-officeimo-drawing-officefontfacecollection) parameter `fonts`
- Constructor [OfficeRenderingProfile.OfficeRenderingProfile](/api/core/officeimo-drawing-officerenderingprofile/#constructor-ctor-string-officeimo-drawing-officefontfacecollection-officeimo-drawing-iofficetextshapingprovider-string-officeimo-drawing-iofficerasterimagecodec-officeimo-drawing-officeimageexportpolicy) parameter `fonts`

Filter members 

Show inherited

## Constructors

`public OfficeFontFaceCollection()` [#](#constructor-ctor)

[OfficeFontFaceCollection.cs:11](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L11)

Creates an empty scoped font collection.

## Methods

Add 4 overloads

`public OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontStyle style = Regular)` [#](#method-add-string-byte-officeimo-drawing-officefontstyle)

[OfficeFontFaceCollection.cs:44](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L44)

Adds or replaces one family/style face. Invalid or unsupported font bytes throw.

Parameters

**familyName string required**

**data byte[] required**

**style OfficeIMO.Drawing.OfficeFontStyle = Regular optional**

Returns

`OfficeFontFaceCollection`

`public OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontFaceDescriptor descriptor)` [#](#method-add-string-byte-officeimo-drawing-officefontfacedescriptor)

[OfficeFontFaceCollection.cs:53](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L53)

Adds or replaces one numerically described family face. Invalid or unsupported font bytes throw.

Parameters

**familyName string required**

**data byte[] required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

Returns

`OfficeFontFaceCollection`

`public OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontStyle style, OfficeFontUnicodeRangeSet unicodeRanges)` [#](#method-add-string-byte-officeimo-drawing-officefontstyle-officeimo-drawing-officefontunicoderangeset)

[OfficeFontFaceCollection.cs:79](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L79)

Adds or replaces one unicode-range-constrained family/style face. A deterministic internal resource family is assigned when the range does not cover all Unicode scalars.

Parameters

**familyName string required**

**data byte[] required**

**style OfficeIMO.Drawing.OfficeFontStyle required**

**unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet required**

Returns

`OfficeFontFaceCollection`

`public OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontFaceDescriptor descriptor, OfficeFontUnicodeRangeSet unicodeRanges)` [#](#method-add-string-byte-officeimo-drawing-officefontfacedescriptor-officeimo-drawing-officefontunicoderangeset)

[OfficeFontFaceCollection.cs:92](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L92)

Adds or replaces one unicode-range-constrained, numerically described family face.

Parameters

**familyName string required**

**data byte[] required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

**unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet required**

Returns

`OfficeFontFaceCollection`

`public OfficeFontFaceCollection AddAlias(string aliasFamilyName, string sourceFamilyName)` [#](#method-addalias-string-string)

[OfficeFontFaceCollection.cs:107](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L107)

Adds another family name for all faces already registered under an existing family. The alias reuses the immutable decoded font programs without decoding or copying them again.

Parameters

**aliasFamilyName string required**

Additional family name accepted by measurement and export.

**sourceFamilyName string required**

Existing family whose faces and unicode ranges are reused.

Returns

`OfficeFontFaceCollection` This collection for fluent configuration.

`public OfficeFontFaceCollection AddFallbackFamily(string familyName)` [#](#method-addfallbackfamily-string)

[OfficeFontFaceCollection.cs:149](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L149)

Appends one registered family to the fallback chain used when requested faces do not cover a text element.

Parameters

**familyName string required**

Registered family or resource family name to append.

Returns

`OfficeFontFaceCollection` This collection for fluent configuration.

`public OfficeFontFaceCollection AddRange(OfficeFontFaceCollection? fonts)` [#](#method-addrange-officeimo-drawing-officefontfacecollection)

[OfficeFontFaceCollection.cs:279](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L279)

Adds independent copies of all faces from another collection.

Parameters

**fonts OfficeIMO.Drawing.OfficeFontFaceCollection? required**

Returns

`OfficeFontFaceCollection`

`public OfficeFontFaceCollection AddRangePreservingExisting(OfficeFontFaceCollection? fonts)` [#](#method-addrangepreservingexisting-officeimo-drawing-officefontfacecollection)

[OfficeFontFaceCollection.cs:321](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L321)

Adds independent copies of faces from another collection without replacing faces already registered under the same family, resource family, and style. Added faces are considered before existing fallback families, while existing document-scoped faces retain precedence.

Parameters

**fonts OfficeIMO.Drawing.OfficeFontFaceCollection? required**

Returns

`OfficeFontFaceCollection`

`public OfficeFontFaceCollection Clone()` [#](#method-clone)

[OfficeFontFaceCollection.cs:349](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L349)

Creates an independent collection snapshot.

Returns

`OfficeFontFaceCollection`

PlanFallbackRuns 2 overloads

`public IReadOnlyList<OfficeFontFallbackRun> PlanFallbackRuns(string? text, string? familyNames, OfficeFontStyle style = Regular)` [#](#method-planfallbackruns-string-string-officeimo-drawing-officefontstyle)

[OfficeFontFaceCollection.cs:410](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L410)

Splits text into grapheme-safe runs using the first scoped family whose selected face covers each text element. Unresolved elements retain the original family list for platform or adapter fallback.

Parameters

**text string? required**

**familyNames string? required**

**style OfficeIMO.Drawing.OfficeFontStyle = Regular optional**

Returns

`IReadOnlyList<OfficeFontFallbackRun>`

`public IReadOnlyList<OfficeFontFallbackRun> PlanFallbackRuns(string? text, string? familyNames, OfficeFontFaceDescriptor descriptor)` [#](#method-planfallbackruns-string-string-officeimo-drawing-officefontfacedescriptor)

[OfficeFontFaceCollection.cs:419](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L419)

Splits text into grapheme-safe runs after matching numeric weight, stretch, and slant for each family.

Parameters

**text string? required**

**familyNames string? required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

Returns

`IReadOnlyList<OfficeFontFallbackRun>`

TryAdd 4 overloads

`public bool TryAdd(string? familyName, byte[]? data, OfficeFontStyle style = Regular)` [#](#method-tryadd-string-byte-officeimo-drawing-officefontstyle)

[OfficeFontFaceCollection.cs:62](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L62)

Attempts to add or replace one family/style face without throwing for unsupported font data.

Parameters

**familyName string? required**

**data byte[]? required**

**style OfficeIMO.Drawing.OfficeFontStyle = Regular optional**

Returns

`bool`

`public bool TryAdd(string? familyName, byte[]? data, OfficeFontFaceDescriptor descriptor)` [#](#method-tryadd-string-byte-officeimo-drawing-officefontfacedescriptor)

[OfficeFontFaceCollection.cs:67](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L67)

Attempts to add or replace one numerically described family face.

Parameters

**familyName string? required**

**data byte[]? required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

Returns

`bool`

`public bool TryAdd(string? familyName, byte[]? data, OfficeFontStyle style, OfficeFontUnicodeRangeSet? unicodeRanges)` [#](#method-tryadd-string-byte-officeimo-drawing-officefontstyle-officeimo-drawing-officefontunicoderangeset)

[OfficeFontFaceCollection.cs:183](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L183)

Attempts to add or replace one unicode-range-constrained family/style face. A deterministic internal resource family is assigned when the range does not cover all Unicode scalars.

Parameters

**familyName string? required**

**data byte[]? required**

**style OfficeIMO.Drawing.OfficeFontStyle required**

**unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet? required**

Returns

`bool`

`public bool TryAdd(string? familyName, byte[]? data, OfficeFontFaceDescriptor descriptor, OfficeFontUnicodeRangeSet? unicodeRanges)` [#](#method-tryadd-string-byte-officeimo-drawing-officefontfacedescriptor-officeimo-drawing-officefontunicoderangeset)

[OfficeFontFaceCollection.cs:205](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L205)

Attempts to add or replace one unicode-range-constrained, numerically described family face.

Parameters

**familyName string? required**

**data byte[]? required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

**unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet? required**

Returns

`bool`

`public bool TryMeasureText(string? text, double fontSize, string? familyNames, OfficeFontStyle style, out double width)` [#](#method-trymeasuretext-string-double-string-officeimo-drawing-officefontstyle-double)

[OfficeFontFaceCollection.cs:363](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L363)

Attempts to measure text with a matching scoped face.

Parameters

**text string? required**

**fontSize double required**

**familyNames string? required**

**style OfficeIMO.Drawing.OfficeFontStyle required**

**width double required**

Returns

`bool`

TryResolveFaceForText 4 overloads

`public bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontStyle style, out OfficeFontFace? face)` [#](#method-tryresolvefacefortext-string-string-officeimo-drawing-officefontstyle-officeimo-drawing-officefontface)

[OfficeFontFaceCollection.cs:503](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L503)

Resolves the scoped face that covers the supplied text for the requested CSS/Office family list and style. This uses the same unicode-range and fallback rules as measurement and rendering, requesting weight 400 for regular text or 700 for bold text with the corresponding upright or italic slant.

Parameters

**text string? required**

**familyNames string? required**

**style OfficeIMO.Drawing.OfficeFontStyle required**

**face OfficeIMO.Drawing.OfficeFontFace? required**

Returns

`bool`

`public bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontStyle style, double fontSize, out OfficeFontFace? face)` [#](#method-tryresolvefacefortext-string-string-officeimo-drawing-officefontstyle-double-officeimo-drawing-officefontface)

[OfficeFontFaceCollection.cs:512](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L512)

Resolves a face at the authored text size, selecting a built-in TrueType optical axis automatically unless the variation resolver explicitly supplied opsz. Provider-owned programs retain their provider-selected axes.

Parameters

**text string? required**

**familyNames string? required**

**style OfficeIMO.Drawing.OfficeFontStyle required**

**fontSize double required**

**face OfficeIMO.Drawing.OfficeFontFace? required**

Returns

`bool`

`public bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontFaceDescriptor descriptor, double fontSize, out OfficeFontFace? face)` [#](#method-tryresolvefacefortext-string-string-officeimo-drawing-officefontfacedescriptor-double-officeimo-drawing-officefontface)

[OfficeFontFaceCollection.cs:521](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L521)

Resolves numeric weight, stretch, and slant with automatic built-in TrueType optical sizing.

Parameters

**text string? required**

**familyNames string? required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

**fontSize double required**

**face OfficeIMO.Drawing.OfficeFontFace? required**

Returns

`bool`

`public bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontFaceDescriptor descriptor, out OfficeFontFace? face)` [#](#method-tryresolvefacefortext-string-string-officeimo-drawing-officefontfacedescriptor-officeimo-drawing-officefontface)

[OfficeFontFaceCollection.cs:538](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L538)

Resolves a scoped face using numeric weight, stretch, and slant matching.

Parameters

**text string? required**

**familyNames string? required**

**descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor required**

**face OfficeIMO.Drawing.OfficeFontFace? required**

Returns

`bool`

## Inherited Methods

`public virtual bool Equals(object? obj)` [#](#method-equals-object)

Inherited from object

Parameters

**obj object? required**

Returns

`bool`

`public virtual int GetHashCode()` [#](#method-gethashcode)

Inherited from object

Returns

`int`

`public Type GetType()` [#](#method-gettype)

Inherited from object

Returns

`Type`

`public virtual string? ToString()` [#](#method-tostring)

Inherited from object

Returns

`string?`

## Properties

`public IOfficeFontProgramProvider? FontProgramProvider { get; set; }` [#](#property-fontprogramprovider)

[OfficeFontFaceCollection.cs:26](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L26)

Optional decoder and outline engine for formats outside the dependency-free core. The provider reference is retained by collection clones; decoded face programs are immutable.

`public Func<OfficeFontProgramLoadRequest, IReadOnlyDictionary<string, float>?>? FontVariationResolver { get; set; }` [#](#property-fontvariationresolver)

[OfficeFontFaceCollection.cs:32](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L32)

Optional variable-font axis resolver invoked for each accepted face. Values are clamped to the font-defined axis range; unknown axes and non-finite values fail closed.

`public IReadOnlyList<OfficeFontFace> Faces { get; }` [#](#property-faces)

[OfficeFontFaceCollection.cs:35](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L35)

Registered faces in registration order.

`public IReadOnlyList<string> FallbackFamilies { get; }` [#](#property-fallbackfamilies)

[OfficeFontFaceCollection.cs:40](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeFontFaceCollection.cs#L40)

Registered fallback families considered after the families requested by a text run.

<!-- PowerForge markdown artifact sha256:D4B040692FD43309E6F2CF4AE604B6B5FCA52A2236EBA9F43F253B2E6C8A68E0 -->
