harp font resources

@在這裡/豎琴 - 五式資源

此存儲庫已棄用，請改用fontcatalog。

該模塊包含一個字體目錄，可在harp.gl渲染器中使用。

有關編碼樣式或貢獻的信息，請參閱信息主項目harp.gl.

發展

先決條件

• node.js-請參閱Nodejs.org以獲取安裝說明
• 紗線- 請參閱Yarnpkg.com以獲取安裝說明。

下載依賴項

跑步：

yarn install

要下載並安裝所有必需的軟件包並設置紗線工作區。

在Node.js環境中運行單元測試

跑步：

yarn test

fontcatalog描述

要生成自己的fontcatalog資產以與harp.gl一起使用，您需要提供包含fontcatalog描述的JSON文件。該文件由以下對介紹者組成：

• 名稱：fontcatalog的名稱（默認值：默認值）。
• 大小：fontcatalog的字形像素大小（默認值： 32 ）。
• 距離：Fontcatalog的字形像素距離（默認值： 8 ）。
• 類型：Fontcatalog的字形類型，可以是常規的SDF或MSDF （默認： SDF ）。
• fontsdir ：目錄的相對路徑，該目錄存儲了此fontcatalog的所有.TTF字體文件。
• 字體：包含此fontcatalog中包含的所有字體的數組。每個字體輸入都由：
  • 名稱：字體的名稱。
  • 粗體：字體的粗體變體（可選）。
  • 斜體：字體的斜體變體（可選）。
  • Bolditalic ：字體的Bolditalic變體（可選）。
  • 塊：包含該字體的特定Unicode塊的數組，我們要生成字形（可選）。

大小，距離和類型參數會影響SDF字形的柵格化，因此會影響輸出fontcatalog的質量。要了解有關字體SDF柵格化的更多信息，請訪問MSDFGEN存儲庫。

fontcatalog生成

跑步：

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

哪個將在以下目錄結構中輸出資產：

 ├── <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

要將這些資產與您的harp.gl主題文件一起使用，請將所有資產複製到您的resources文件夾，並以相對路徑的方式從主題中引用它們：

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

執照

版權（c）2018-2019這里歐洲BV

有關許可詳細信息，請參見本項目根部的許可證文件。

請注意，單個字體在不同的許可下：Resources-dev/fonts/readme.md