chws_tool

chws_tool

Esta ferramenta adiciona os recursos do OpenType chws , vchw , halt e vhal para fontes OpenType/TrueType quando algum desses recursos estiver ausente. Por favor, consulte o espaçamento entre o Oriente para os detalhes desses recursos.

Esta ferramenta usa o pacote de espaçamento entre asiáticos leste como seu principal mecanismo e tem as seguintes vantagens:

• API mais simples e opções de linha de comando.
• Suporta fontes CJK em fonts.google.com em sua configuração embutida.

Para adicionar novas fontes à lista de fontes suportadas, consulte a seção Adicionando fontes abaixo.

Instalar

pip install chws-tool

Se você deseja clonar e instalar no modo editável com os pacotes de desenvolvimento:

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

Uso da linha de comando

O exemplo a seguir adiciona os recursos ao input.otf e o salva ao diretório build . Se o argumento for um diretório, a ferramenta o expande para todas as fontes no diretório recursivamente.

add-chws input.otf

Use a opção -o para alterar o diretório de saída ou a opção --help para a lista completa de opções.

add-chws input_dir -o output_dir

API

O exemplo a seguir cria uma fonte com os recursos no diretório " build " se os recursos forem aplicáveis:

 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" )

Se você preferir substituir as fontes existentes, pode omitir o diretório de saída.

 import chws_tool

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

Se o seu programa usar o 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 ())

Adicionando fontes

Este pacote possui uma lista interna de fontes suportadas em sua configuração.

As fontes não na lista conhecida ainda são processadas com a configuração padrão, mas este pacote mostra uma mensagem de aviso.

Ao adicionar novas fontes à lista de fontes conhecida, o processo a seguir é recomendado:

1. Encontre os nomes das fontes. Executar o add-chws com a opção --print-name pode imprimi-los.
2. Adicione -os à configuração.
3. (Opcional) Crie a fonte e execute o teste visual. Esta etapa é opcional porque este pacote evita automaticamente as colisões de glifos computando esboços de glifos.
4. (Opcional) Ajuste a configuração, se necessário.

Teste visual

O objetivo principal desse processo é encontrar espaçamentos muito apertados ou colisões de glifos causadas pelos kernings.

Essa ferramenta possui regras heurísticas para determinar a aplicabilidade dos espaçamentos usando as métricas de glifos, mas assume que os glifos de pontuação de largura total têm espaçamentos internos suficientes de acordo com convenções lingüísticas, como no UAX#50 ou no clreq. Infelizmente, nem todas as fontes seguem as convenções.

Para executar o teste visual:

1. Adicione a fonte de teste à lista de fontes no bloco superior <script> de tests/test.html .
2. Abra -o no seu navegador.
3. Verifique as caixas de seleção "FullWidth", "Tretict" e "oculam o mesmo tamanho".

Aqui está a lista de verificação e as dicas:

• Encontre onde os glifos estão muito apertados ou colidem quando o recurso estiver ligado, mas pareça bem sem o recurso.
  • As aspas podem colidir com mais frequência, especialmente no fluxo vertical, mas às vezes também no fluxo horizontal.
  • "Open+Open" e "Close+Close" têm maior probabilidade de colidir do que outros pares.
  • Selecione os glifos para verificar a quantidade de tintas que transborcem das métricas de glifos.
• Teste os fluxos horizontais e verticais lançando a caixa de seleção "vertical".

Outros controles no teste não são obrigatórios, mas podem ser úteis nos seguintes casos.

• Desmarque "ocultar o mesmo tamanho" para ver casos em que os kernings não são aplicados pelas regras internas. Eles geralmente estão bem. Na maioria dos casos, eles são porque os glifos estão ausentes, não são largura total ou o par não deve se candidatar ao script da fonte. O arquivo de teste contém o código Poitns para todos os scripts do leste asiático, mas nem todos os pontos de código devem aplicar espaçamentos para todo o script.
• A lista de "idiomas" não importa na maioria dos casos, exceto quando a fonte suporta vários locais, como o Noto CJK.
• O recurso "FullWidth" pode alterar os glifos, mas na maioria dos casos, se os glifos parecerem bem com o recurso, eles devem estar bem com o recurso off.
• O recurso "vertical" é válido apenas no fluxo vertical. Você pode apenas verificar, pelo mesmo motivo que o recurso "FullWidth".
• Os campos de entrada "caracteres" podem alterar os casos de teste. Você não precisa alterá -los a menos que tenha necessidades específicas.

Liberação

Consulte https://googlefonts.github.io/python#make-alease.