harp font resources

@hier/Harp-Font-Ressourcen

Dieses Repo ist veraltet . Verwenden Sie stattdessen Fontcatalog.

Dieses Modul enthält einen Schriftkatalog, der im harp.gl -Renderer verwendet werden soll.

Informationen zum Codierungsstil oder zum Beitrag zum Codierungsstil finden Sie unter dem Informations -Hauptprojekt Harp.gl.

Entwicklung

Voraussetzungen

• Node.js - Siehe Nodejs.org für Installationsanweisungen
• Garn - Weitere Installationsanweisungen finden Sie unter arnpkg.com.

Abhängigkeiten herunterladen

Laufen:

yarn install

So herunterladen und installieren Sie alle erforderlichen Pakete und richten Sie den Garn -Arbeitsbereich ein.

Führen Sie Unit -Tests in der node.js -Umgebung aus

Laufen:

yarn test

Beschreibung von Fontcatalog

Um Ihre eigenen Fontcatalog -Assets mit Harp.gl zu generieren, müssen Sie eine JSON -Datei mit Ihrer Beschreibung der Fontcatalog angeben. Diese Datei besteht aus den folgenden Paremetern:

• Name : Fontcatalogs Name (Standard: Standard ).
• Größe : Fontcatalogs Glyphe -Pixelgröße (Standard: 32 ).
• Entfernung : Fontcatalogs Glyphe -Pixel -Abstand (Standard: 8 ).
• Typ : Fontcatalogs Glyphentyp, bei dem es sich um reguläre SDF oder MSDF handelt (Standard: SDF ).
• FONTSDIR : Relativer Weg zum Verzeichnis, in dem alle .ttf -Font -Dateien für diesen Fontcatalog gespeichert werden.
• Schriftarten : Array mit allen Schriftarten, die in diesen Fontcatalog aufgenommen werden sollen. Jeder Schriftart der Schrift besteht aus:
  • Name : Name der Schriftart.
  • fett : fettes Variante der Schriftart ( optional ).
  • ITALISCH : FONT ITALISCHE VARATION ( optional ).
  • Bolditalic : Font's Bolditalic Variante ( optional ).
  • Blöcke : Array mit den spezifischen Unicode -Blöcken dieser Schriftart, für die wir Glyphen erzeugen möchten ( optional ).

Die Größe , die Entfernung und die Typparameter beeinflussen, wie SDF -Glyphen rasterisiert werden und die Qualität des Ausgangsfontcatalogs beeinflussen können. Um mehr über die Rasterisierung von Schriftarten zu erfahren, besuchen Sie das MSDFGen -Repository.

Fontcatalog -Erzeugung

Laufen:

yarn create-font-catalog -- -i < PATH_TO_DESCRIPTION > -o < OUTPUT_PATH >

Dies gibt Vermögenswerte in der folgenden Verzeichnisstruktur aus:

 ├── <NAME>_Assets
│   ├── Extra
│   │   ├── Specials.json
│   │   └── Specials.png
│   ├── FontA
│   │   ├── Basic_Latin.json
│   │   ├── Basic_Latin.png
│   │   └── ...
│   ├── FontB
│   │   ├── Basic_Latin.json
│   │   ├── Basic_Latin.png
│   │   └── ...
│   └── ...
├── <NAME>_BoldAssets (if any)
│   └── ...
├── <NAME>_ItalicAssets (if any)
│   └── ...
├── <NAME>_BoldItalicAssets (if any)
│   └── ...
└── <NAME>_FontCatalog.json

Um diese Assets mit Ihren Harp.gl -Themendateien zu verwenden, kopieren Sie alle in Ihren resources und verweisen Sie sie mit einem relativen Pfad aus dem Thema:

 "fontCatalogs" : [
    {
        "name" : " <NAME> " ,
        "url" : " ./<NAME>_FontCatalog.json "
    }
]

Lizenz

Copyright (C) 2018-2019 Hier Europa BV

In der Lizenzdatei im Stamm dieses Projekts finden Sie Lizenzdetails.

Bitte beachten Sie, dass die einzelnen Schriftarten unter verschiedenen Lizenzen stehen: Ressourcen-dev/Schriftarten/Readme.md