Laden von Web-Open-Font-Dateien (WOFF) | .NET

Laden von Web-Open-Font-Dateien (WOFF) mit Aspose.Font für .NET

Was Sie brauchen

Artikel	Beschreibung	Bezugsquelle
Aspose.Font für .NET	Kernbibliothek zum Lesen, Schreiben und Konvertieren von Schriftdateien (einschließlich WOFF/WOFF2).	Installation mit dotnet add package Aspose.Font oder über die NuGet-Benutzeroberfläche (https://www.nuget.org/packages/Aspose.Font).
Zielframework	.NETFramework 4.x / .NETCore 3.x / .NET 5/6/7 – jede von Aspose.Font unterstützte Plattform.	Keine zusätzliche Laufzeitumgebung erforderlich.
Namespace-Importe	csharp\nusing Aspose.Font;\nusing Aspose.Font.Sources;\nusing System.IO;\n

Tip: All API docs are at https://reference.aspose.com/font/net/.

Laden einer WOFF-Datei aus dem Dateisystem

Schritt für Schritt

1. Suchen Sie die Schriftartdatei (z. B. „C:\Fonts\MyWebFont.woff“).
2. Erstellen Sie eine „FileSystemStreamSource“, die der Bibliothek einen Stream zu dieser Datei bereitstellt.
3. Verpacken Sie die Stream-Quelle in eine „FontFileDefinition“ – geben Sie die Erweiterung „woff“ an (die Bibliothek verwendet diese, um den richtigen Parser auszuwählen).
4. Erstellen Sie eine „FontDefinition“ – übergeben Sie den entsprechenden „FontType“ („Woff“) und die „FontFileDefinition“.
5. Öffnen Sie die Schriftart über „Font.Open()“ – Sie erhalten ein von „Aspose.Font.Font“ abgeleitetes Objekt (z. B. „WoffFont“).

using System;
using System.IO;
using Aspose.Font;
using Aspose.Font.Sources;

class LoadWoffExample
{
    static void Main()
    {
        // Path to the .woff file
        string woffPath = @"C:\Fonts\MyWebFont.woff";

        // Stream source that reads directly from the file system
        FileSystemStreamSource streamSrc = new FileSystemStreamSource(woffPath);

        // FontFileDefinition – we tell Aspose it is a “woff” file
        FontFileDefinition fileDef = new FontFileDefinition("woff", streamSrc);

        // FontDefinition – specify the font type (Woff)
        FontDefinition fontDef = new FontDefinition(FontType.WOFF, fileDef);

        // Load the font
        Font woffFont = Font.Open(fontDef);

        // woffFont now gives you access to glyphs, metrics, encoding, etc.
        Console.WriteLine($"Loaded font: {woffFont.GetType().Name}");
    }
}

Ergebnis: woffFont ist eine Instanz von Aspose.Font.Woff.WoffFont. Sie können nun Text rendern, Glyphenmetriken überprüfen oder ihn in ein anderes Format (TTF, SVG usw.) konvertieren.

Alternative Möglichkeiten zum Laden von WOFF-Schriftarten

Laden aus einem Byte-Array (z. B. wenn die Schriftart in eine Ressource eingebettet oder über HTTP heruntergeladen wird)

byte[] woffBytes = File.ReadAllBytes(@"C:\Fonts\MyWebFont.woff");

// ByteContentStreamSource wraps the byte[] as a readable stream
ByteContentStreamSource byteSrc = new ByteContentStreamSource(woffBytes);

// Create definition – note we still supply "woff" as extension
FontDefinition fd = new FontDefinition(FontType.WOFF,
                                      "woff",
                                      byteSrc);

Font woffFont = Font.Open(fd);

Direktes Laden aus einem Stream ohne zwischengeschaltete FileDefinition

Wenn Sie bereits einen geöffneten „FileStream“ haben:

using (FileStream fs = File.OpenRead(@"C:\Fonts\MyWebFont.woff"))
{
    // Wrap the live FileStream in FileSystemStreamSource
    var streamSrc = new FileSystemStreamSource(fs);

    // Directly pass stream source + extension into FontDefinition
    var fd = new FontDefinition(FontType.WOFF, "woff", streamSrc);
    var woffFont = Font.Open(fd);
}

Beide Ansätze verwenden die gleichen zugrunde liegenden Klassen, nur die Quelle der Bytes ändert sich (Festplattendatei vs. Speicher vs. benutzerdefinierter Stream).

Nach dem Laden – was kann man tun?

• Text rendern – Verwenden Sie das Subsystem „Aspose.Font.Rendering“ oder exportieren Sie Glyphenumrisse.
• Font-Metriken lesen – z.B. ((WoffFont)woffFont).Metrics.
• In ein anderes Format konvertieren – rufen Sie „font.Save(“output.ttf”);` auf, nachdem Sie es in die entsprechende Unterklasse umgewandelt oder die generische API verwendet haben.
• Teilmenge / Zusammenführung – mehrere Schriftarten in einer Sammlung kombinieren.
• Lizenzinformationen extrahieren – falls im WOFF-Header vorhanden.

All dies wird im offiziellen Beispiel-Repository demonstriert:

📂 https://github.com/aspose-font/Aspose.Font-Documentation/tree/master/net-examples

Schnelle Checkliste (für Dokumentationsseiten)

• ✅ NuGet-Abzeichen hinzufügen: „ “.
• ✅ Fügen Sie einen Beispielcodeblock (wie oben gezeigt) mit der richtigen Syntaxhervorhebung hinzu.
• ✅ Erwähnen Sie die Tabelle der unterstützten Erweiterungen (Kopie aus Abschnitt 2 oben).
• ✅ Link zur API-Referenz für:
  • Aspose.Font.Font.Open
  • Aspose.Font.Sources.FileSystemStreamSource
  • Aspose.Font.Sources.ByteContentStreamSource
  • Aspose.Font.FontFileDefinition
  • Aspose.Font.FontDefinition
• ✅ Stellen Sie Links zum Thema „Weiterführende Literatur“ bereit:
  • Getting started: https://docs.aspose.com/font/net/getting-started/
  • Full API reference: https://reference.aspose.com/font/net/
  • Free online demo: https://products.aspose.app/font/conversion
• ✅ Tipp zur Fehlerbehebung hinzufügen: Wenn Sie „Nicht unterstütztes Schriftformat“ erhalten, überprüfen Sie, ob Sie sowohl „FontType.WOFF“ als auch eine „woff“-Erweiterung übergeben haben.