hbf2gf - Online na nuvem

PROGRAMA:

NOME

hbf2gf - converte uma fonte bitmap CJK em subfontes utilizáveis ​​por TeX e Omega.

SINOPSE

hbf2gf [-q] arquivo de configuração[.cfg]
hbf2gf [-q] [-p] [-g] [-n] subfonte resolução x [escala y | resolução y]
hbf2gf -t [-q] subfonte
hbf2gf --versão | --Socorro

DESCRIÇÃO

Fontes de bitmap CJK não podem ser usadas diretamente com TeX porque o número de caracteres em tais
fontes excede 256, o limite de uma fonte TeX. Portanto, é necessário dividir essas fontes
em subfontes, e isso é exatamente o que hbf2gf faz.

Como o nome diz, hbf2gf usa fontes CJK em um determinado formato que é chamado Hanzi Bitmap
fonte (HBF) formato. Ele simplesmente consiste nos arquivos de bitmap CJK e um arquivo de texto em um
formato muito semelhante ao formato BDF do X Window System que descreve o bitmap
arquivos de fonte: a codificação, o tamanho, etc. Os arquivos GF produzidos podem ser convertidos com
gftopk em arquivos PK padrão.

hbf2gf pode ser chamado de três modos:

hbf2gf [-q] arquivo de configuração[.cfg]

Esta chamada normalmente cria um conjunto de arquivos GF, um arquivo PL e um arquivo em lote que
deve ser executado após hbf2gf terminou. Este script irá então chamar gftopk para
converter todos os arquivos GF em arquivos PK, e chamará Pltotf para converter o arquivo PL
em um arquivo TFM. Por fim, ele copiará o arquivo TFM para que cada arquivo PK tenha seu TFM
arquivo (que são todos idênticos).

If arquivo_ofm está definido como 'sim' no arquivo de configuração, os arquivos OFM e OVF serão
criado também.

-q faz hbf2gf quieto.

hbf2gf [-q] [-p] [-g] [-n] subfonte resolução x [escala y | resolução y]

Este modo deve ser usado com mktexk e seus derivados. Apenas um arquivo GF
junto com um arquivo PL para a subfonte dada será calculado, tomando a horizontal
resolução e um fator de escala vertical (se o valor for menor que 10) resp. a
resolução vertical (caso contrário) a partir da linha de comando, ignorando o nmb_fonts
parâmetro do arquivo de configuração. Os dois últimos caracteres (que são interpretados
como o número da subfonte) são retirados para obter o nome do arquivo de configuração (que
deve terminar com '.cfg'). Nenhum arquivo de trabalho será criado. Se opção -p está definido, nenhum arquivo PL
é criado. Se -g é definido, nenhum arquivo GF é criado. A extensão pode ser controlada
com -n; se definido, a extensão é '.gf', caso contrário '.resolução> gf '. -q faz
hbf2gf quieto.

hbf2gf -t [-q] subfonte

Este modo deve ser usado com scripts como mktexk; testa se o
o nome da subfonte especificado leva a um hbf2gf arquivo de configuração. Retorna 0 em
sucesso e imprime o nome desse arquivo de configuração (desde que -q interruptor
não está definido). Este teste não é completo; remove apenas os dois últimos caracteres
e verifica se existe um arquivo de configuração com esse nome.

Consulte a próxima seção para obter mais detalhes sobre os arquivos de configuração.

Especificando a opção --versão retorna a versão atual de hbf2gf e o arquivo usado
biblioteca de pesquisa (por exemplo kpathsea) As informações de uso são mostradas com o --Socorro parâmetro.

CONFIGURAÇÃO ARQUIVO

Aqui está um exemplo de arquivo de configuração (gsfs14.cfg) para uma fonte chinesa de 56 × 56 na codificação GB;
observe que todas as informações sobre a fonte estão no arquivo jfs56.hbf. Veja o ARQUIVO PROCURANDO
seção como fontes HBF e hbf2gf arquivos de configuração são encontrados. Veja o DISPONIBILIDADE
seção onde obter fontes CJK junto com seus arquivos HBF:

hbf_header jfs56.hbf
mag_x 1
limite 128
comentário fonte jianti fansongti de 56x56 pixels

design_size 14.4

deslocamento_y -13

nmb_files -1

nome_saída gsfs14

soma de verificação 123456789

dpi_x 300

pk_files não
tfm_files sim

esquema de codificação de codificação Texto TeX codificado pelo GuoBiao

pk_directory $ HBF_TARGET / pk / modeless / gb2312 / gsfs14 /
tfm_directory $ HBF_TARGET / tfm / gb2312 / gsfs14 /

Um arquivo de configuração é um arquivo de texto simples que consiste em palavras-chave e seus argumentos. UMA
a palavra-chave deve iniciar uma linha, caso contrário, toda a linha será ignorada. Se a palavra começando
uma linha não é uma palavra-chave, a linha também será ignorada. Linhas vazias também serão ignoradas.
A busca por palavras-chave não diferencia maiúsculas de minúsculas; em contraste, os argumentos serão considerados
exatamente como fornecido (exceto 'sim' e 'não' que podem ser escritos em maiúsculas ou minúsculas
cartas). Cada palavra-chave possui um argumento que deve ser separado por espaços em branco (espaços em branco ou
guias) da palavra-chave e devem estar na mesma linha. Cada linha não deve ser maior que
Caracteres 256.

Você pode usar variáveis ​​de ambiente no arquivo de configuração. O personagem de escape
iniciar uma variável de ambiente no arquivo de configuração é sempre '$', mesmo para
sistemas operacionais como o DOS, que possui outras convenções. hbf2gf reconhece apenas
nomes de variáveis ​​de ambiente que começam com uma letra ou um sublinhado, seguidos por
caracteres alfanuméricos ou sublinhados. Você pode cercar a variável com colchetes para
indique onde termina o nome da variável, por exemplo $ {FOO}. Para obter um cifrão você deve
escreva '$$'. A expansão das variáveis ​​de ambiente no próprio hbf2gf (sem a ajuda de
as rotinas de pesquisa kpathsea, emtexdir ou MiKTeX) são muito limitadas; este recurso tem
transitado de versões anteriores. Ele não pode expandir variáveis ​​definidas em texmf.cnf; isto
também não pode lidar com mais de um diretório como o valor da variável. não usar it exceto
para que o 'pk_directory' e 'tfm_directory' parâmetros!

Esta é a lista de todas as palavras-chave necessárias:

hbf_header
O nome do arquivo de cabeçalho HBF das fontes de entrada. hbf2gf usa a pesquisa dada
(kpathsea, emtexdir ou MiKTeX) para localizar esse arquivo.

nome_saída
A raiz do nome dos arquivos de saída. Um número decimal em execução de dois dígitos começando
com '01' será acrescentado. Para fontes Unicode, consulte a palavra-chave unicode abaixo. Esse
o valor é em quase todos os casos idêntico ao nome do arquivo de configuração.

E agora todas as palavras-chave opcionais:

x_offset
Aumenta a largura do caractere. Será aplicado em ambos os lados; padrão para não
glifos girados é o valor dado no cabeçalho HBF (HBF_BITMAP_BOUNDING_BOX)
dimensionado para tamanho_de_design (em pixels).

deslocamento_y
Muda todos os caracteres para cima ou para baixo; padrão para glifos não girados é o valor dado
no cabeçalho HBF (HBF_BITMAP_BOUNDING_BOX) dimensionado para tamanho_de_design (em pixels).

tamanho_de_design
O tamanho do desenho (em pontos) da fonte. x_offset e deslocamento_y referem-se a este tamanho.
O padrão é 10.0.

inclinação A inclinação da fonte (fornecida como Delta_x / Delta_y). Somente valores no intervalo
0 ≤ inclinação ≤ 1 são permitidos. O padrão é 0.0.

rotação
Se definido como 'sim', todos os glifos serão girados 90 graus no sentido anti-horário. o
os deslocamentos padrão conforme fornecidos no cabeçalho HBF serão ignorados (e definidos como 0). Predefinição
é não'.

mag_x
mag_y Valores de escala dos personagens para atingir o tamanho do desenho. Se apenas uma ampliação
é fornecido, os valores xey são considerados iguais. O padrão é mag_x = mag_y = 1.0.

limiar
Um valor entre 1 e 254 que define um limite para converter o graymap interno
no bitmap de saída; valores mais baixos cortam mais pixels. O valor padrão é 128.

comentar
Um comentário que descreve a fonte; o padrão é nenhum.

nmb_fonts
O número de subfonts a serem criadas. O valor padrão é -1 para criar todas as fontes.

unicode
Se 'sim', um número hexadecimal de dois dígitos será usado como um número corrido, começando
com o valor do primeiro byte do primeiro intervalo de código. O padrão é 'não'.

min_char
O valor mínimo da codificação. Você deve definir este valor para obter o correto
deslocamentos de subarquivo se não for idêntico ao código de caractere mais baixo no HBF
arquivo.

dpi_x
dpi_y A resolução horizontal e vertical (em dpi) da impressora. Se apenas um
a resolução é fornecida, os valores de x e y são considerados iguais. O padrão é 300.

checksum
Uma soma de verificação para identificar os arquivos GF com os arquivos TFM apropriados. O padrão
o valor deste inteiro de 32 bits sem sinal é 0.

codificação Um comentário que descreve o esquema de codificação; o padrão é nenhum.

diretório_pk
O diretório de destino dos arquivos PK; padrão: nenhum. Atenção! O lote
arquivo não verificará se este diretório existe.

diretório_tfm
O diretório de destino dos arquivos TFM; padrão: nenhum. Atenção! O lote
arquivo não verificará se este diretório existe.

pk_files
Se deve criar arquivos PK ou não; o padrão é 'sim'.

tfm_files
Se deve criar arquivos TFM ou não; o padrão é 'sim'.

arquivo_ofm
Se deve criar um arquivo OPL ou não; o padrão é 'não'. O arquivo em lote irá então
usar ovp2ovf da distribuição Omega para convertê-lo em um arquivo OFM e OVF.
O arquivo OPL simplesmente mapeia todas as subfonts de volta para uma única fonte Omega.

extensão_longa
Se 'sim', os arquivos PK incluirão a resolução na extensão (por exemplo
gsso1201.300pk). Isso afeta apenas o arquivo em lote (o padrão é 'sim').

comando_rm
O comando shell para remover arquivos; padrão: 'rm'.

cp_command
O comando shell para copiar arquivos; padrão: 'cp'.

extensão_de_trabalho
A extensão do arquivo em lote que chama gftopk e Pltotf para converter o GF e
os arquivos PL em arquivos PK e TFM respectivamente; o padrão é nenhum.

ARQUIVO PROCURANDO

hbf2gf usa o kpathsea, emtexdirou MiKTeX biblioteca para pesquisar arquivos (emtexdir
funcionará apenas em sistemas operacionais com experiência em MS-DOS, ou seja, MS-DOS,
OS / 2, Windows; MiKTeX é para sistemas Win32).

kpathsea
A versão real do kpathsea é exibida na tela se você chamar hbf2gf --versão.

Aqui está uma tabela do tipo de arquivo e o correspondente kpathsea variáveis.

.hbf DESCONHECIDOS
.cfg HBF2GFINPUTS

Por favor, consulte os arquivos de informação de kpathsea para obter detalhes sobre essas variáveis. A decisão
qual esquema de nomenclatura usar para as variáveis ​​será feito durante a compilação.

Você deve definir a variável TEXMFCNF para o diretório onde sua configuração texmf.cnf
arquivo reside.

Aqui está o comando adequado para descobrir para qual valor um kpathsea variável está definida (nós usamos
MISCFONTS como exemplo). Isso é especialmente útil se uma variável não for definida em texmf.cnf
ou no ambiente, apontando assim para o valor padrão que está embutido no
kpathsea biblioteca.

kpsewhich -progname = hbf2gf -expand-var = '$ MISCFONTS'

Selecionamos o nome do programa também, uma vez que é possível especificar variáveis ​​que são
procurou apenas por um determinado programa - em nosso exemplo, seria MISCFONTS.hbf2gf.

Um método semelhante, mas não idêntico, é dizer

kpsewhich -progname = hbf2gf -show-path = 'fontes diversas'

[Uma lista completa de tipos de formato pode ser obtida dizendo 'kpsewhich --help' no comando
prompt de linha.] É exatamente assim que hbf2gf procura por arquivos; a desvantagem é que tudo
as variáveis ​​são expandidas, o que pode causar strings muito longas.

emtexdir
Aqui, a lista de sufixos e suas variáveis ​​de ambiente relacionadas a serem definidas em autoexec.bat
(resp. em config.sys para OS / 2):

.hbf HBFONTES
.cfg HBFCFG

Se uma das variáveis ​​não for definida, uma mensagem de aviso é emitida. O diretório atual
sempre será pesquisado. Como de costume, um ponto de exclamação anexado a um caminho de diretório
faz com que os subdiretórios com um nível de profundidade sejam pesquisados, dois pontos de exclamação fazem com que todos
subdiretórios a serem pesquisados. Exemplo:

HBFONTS = c: \ fonts \ hbf !!; d: \ myfonts \ hbf!

Construções como 'c: \ fonts !! \ hbf' não são possíveis.

MikTeXGenericName
Consulte os arquivos de documentação de MiKTeX para mais detalhes.

LIMITAÇÕES

O tamanho de saída xey não deve exceder MAX_CHAR_SIZE, que é definido em tempo de compilação;
seu valor padrão é 1023 (pixel).

Use hbf2gf online usando serviços onworks.net