chws_toolダウンロードchws_toolソースコードのダウンロード

chws_tool

フォントのダウンロード

v1.4.2

ダウンロード

chws_tool

このツールは、これらの機能のいずれかが欠落している場合、Opentype/TrueTypeフォントにOpentype chws 、 vchw 、 halt 、およびvhal機能を追加します。これらの機能の詳細については、東アジア間隔を参照してください。

このツールは、東アジア間隔パッケージをコアエンジンとして使用し、次の利点があります。

よりシンプルな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を実行すると印刷できます。
それらを構成に追加します。
（オプション）フォントを構築し、視覚テストを実行します。このパッケージは、Glyphのアウトラインを計算することにより、グリフの衝突を自動的に回避するため、このステップはオプションです。
（オプション）必要に応じて構成を調整します。

視覚テスト

このプロセスの主な目的は、Kerningsによって引き起こされたあまりにも厳しい間隔またはグリフの衝突を見つけることです。

このツールには、Glyphメトリックを使用して間隔の適用性を判断するためのヒューリスティックルールがありますが、全幅の句読点グリフには、UAX＃50またはCLREQのように言語規則に従って十分な内部間隔があると想定しています。残念ながら、すべてのフォントが慣習に従うわけではありません。

視覚テストを実行するには：

tests/test.htmlのトップ<script>ブロックのフォントリストにテストフォントを追加します。
ブラウザで開きます。
「FullWidth」、「直立」、「同じサイズの非表示」チェックボックスを確認してください。

これがチェックリストとヒントです：

機能がオンになっているときは、グリフがきつすぎる場所や衝突する場所を見つけますが、機能なしではうまく見えます。
- 引用符は、特に垂直の流れでは、ほとんどの場合、水平流でも衝突する可能性があります。
- 「Open+Open」および「Close+Close」は、他のペアよりも衝突する可能性が高くなります。
- グリフを選択して、グリフメトリックにオーバーフローするインクの量を確認します。
「垂直」チェックボックスを反転して、水平フローと垂直フローの両方をテストします。

テストの他のコントロールは必須ではありませんが、以下の場合に役立つ場合があります。

「同じサイズを非表示にする」というチェックを外して、カーニングが組み込みのルールによって適用されない場合を確認します。彼らは通常大丈夫です。ほとんどの場合、それらはグリフが欠落しているか、完全な幅ではないため、またはペアがフォントのスクリプトに適用されないためです。すべての東アジアのスクリプトのテストファイルcontaisnコードポイトンは、すべてのコードポイントがすべてのスクリプトに間隔を適用するわけではありません。
フォントがNoto CJKなどの複数のロケールをサポートする場合を除き、ほとんどの場合、「言語」リストは重要ではありません。
「FullWidth」機能はグリフを変更できますが、ほとんどの場合、グリフが機能をオンにして問題なく見える場合は、機能をオフにしても問題ありません。
「直立」機能は、垂直フローでのみ有効です。「FullWidth」機能と同じ理由で、それを確認できます。
「文字」入力フィールドは、テストケースを変更できます。特定のニーズがない限り、それらを変更する必要はありません。