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”功能相同的原因進行檢查。
“字符”輸入字段可以更改測試用例。除非有特定的需求，否則您不必更改它們。