chws_tool下载chws_tool源代码下载

chws_tool

字体下载

v1.4.2

下载

chws_tool

当缺少这些功能时，该工具将Opentype chws ， vchw ， halt和vhal功能添加到Opentype/Truetype字体中。有关这些功能的详细信息，请参阅东亚洲间距。

该工具将东亚洲间距软件包用作其核心引擎，并且具有以下优点：

更简单的API和命令行选项。
在fonts.google.com上支持CJK字体，以其内置配置。

要将新字体添加到受支持的字体列表中，请参阅下面的添加字体部分。

安装

pip install chws-tool

如果您想在开发软件包中克隆并以可编辑模式安装：

git clone https://github.com/googlefonts/chws_tool.git
cd chws_tool
pip install -e ' .[dev] '

命令行的用法

以下示例将功能添加到input.otf中，并将其保存到build目录中。如果参数是目录，则该工具将其递归地将其扩展到目录中的所有字体。

add-chws input.otf

使用-o选项更改输出目录或 - 完整选项列表的--help选项。

add-chws input_dir -o output_dir

API

如果功能适用，则以下示例会创建字体，并具有“ build ”目录中的功能：

 import chws_tool

def main ():
    output_path = chws_tool . add_chws ( "fonts/input.otf" , "build" )
    if output_path :
        print ( f"Success! saved to { output_path } " )
    else :
        print ( "Skipped" )

如果您希望覆盖现有字体，则可以省略输出目录。

 import chws_tool

def main ():
    chws_tool . add_chws ( "fonts/input.otf" )

如果您的程序使用Asyncio：

 import asyncio
import chws_tool

async def main_async ():
    output_path = await chws_tool . add_chws_async ( "fonts/input.otf" , "build" )
    if output_path :
        print ( f"Success! saved to { output_path } " )
    else :
        print ( "Skipped" )

asyncio . run ( main_async ())

添加字体

该软件包在其配置中具有内置支持字体的内置列表。

未在已知列表中的字体仍使用默认配置处理，但此软件包显示了警告消息。

在已知字体列表中添加新字体时，建议使用以下过程：

找到字体名称。使用--print-name选项运行add-chws可以打印它们。
将它们添加到配置中。
（可选）构建字体并运行视觉测试。此步骤是可选的，因为此软件包可以通过计算字形概述来自动避免字形碰撞。
（可选）根据需要调整配置。

视觉测试

此过程的主要目的是发现kernings造成的太紧的间距或字形碰撞。

该工具具有启发式规则，可以使用字形指标来确定间距的适用性，但假设全宽标点字形具有根据语言＃50或Clreq中的语言惯例具有足够的内部间距。不幸的是，并非所有字体都遵循大会。

进行视觉测试：

将测试字体添加到tests/test.html的顶部<script>块中的字体列表中。
在您的浏览器中打开它。
检查“ FullWidth”，“直立”和“隐藏相同的尺寸”复选框。

这是检查清单和提示：

在功能打开时查找字形太紧或碰撞的位置，但没有功能而看起来不错。
- 引号可能会经常发生碰撞，尤其是在垂直流中，但有时也会在水平流动中。
- 与其他对相比，“打开+打开”和“关闭+关闭”更可能发生碰撞。
- 选择字形以检查墨水覆盖的尺寸。
通过翻转“垂直”复选框来测试水平和垂直流。

测试中的其他控件不是强制性的，但在以下情况下可能很有用。

取消选中“隐藏相同的大小”，以查看内置规则未应用Kernings的情况。他们通常很好。在大多数情况下，它们是因为缺少字形，不是全宽，或者对不应申请字体的脚本。所有东亚脚本的测试文件CONTAISN代码POITNS，但并非所有代码点都应适用所有脚本的间距。
在大多数情况下，“语言”列表并不重要，除非字体支持多个语言环境，例如noto cjk。
“ FullWidth”功能可以更改字形，但是在大多数情况下，如果字形对该功能看起来还不错，则应关闭该功能。
“直立”功能仅在垂直流中有效。您可以出于与“ FullWidth”功能相同的原因进行检查。
“字符”输入字段可以更改测试用例。除非有特定的需求，否则您不必更改它们。