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