hbf2gf - Online sa Cloud

PROGRAMA:

NAME

hbf2gf - i-convert ang isang CJK bitmap font sa mga subfont na magagamit ng TeX at Omega.

SINOPSIS

hbf2gf [-q] configuration-file[.cfg]
hbf2gf [-q] [-p] [-g] [-n] subfont-name x-resolution [y-scale | y-resolution]
hbf2gf -t [-q] subfont-name
hbf2gf --bersyon | - Tumulong

DESCRIPTION

Ang mga CJK bitmap font ay hindi maaaring direktang gamitin sa TeX dahil ang bilang ng mga character sa ganoon
ang mga font ay lumampas sa 256, ang limitasyon ng isang TeX na font. Kaya kinakailangan na hatiin ang mga font na ito
sa mga subfont, at ito ay eksakto kung ano hbf2gf ang.

Tulad ng sinabi ng pangalan, hbf2gf gumagamit ng mga CJK font sa isang tiyak na format na tinatawag Hanzi Bitmap
Font (HBF) format. Binubuo lamang ito ng (mga) CJK bitmap file at isang text file sa a
format na halos kapareho sa BDF na format ng X Window System na naglalarawan sa bitmap
font file: ang pag-encode, ang laki, atbp. Ang ginawang GF file ay maaaring ma-convert gamit ang
gftopk sa mga karaniwang PK file.

hbf2gf maaaring tawagan sa tatlong mga mode:

hbf2gf [-q] configuration-file[.cfg]

Ang tawag na ito ay karaniwang gumagawa ng isang set ng mga GF file, isang PL file, at isang batch file na
dapat isagawa pagkatapos hbf2gf ay tapos na. Ang script na ito ay tatawag gftopk sa
i-convert ang lahat ng GF file sa PK file, at tatawag ito pltotf upang i-convert ang PL file
sa isang TFM file. Sa wakas ay kokopyahin nito ang TFM file upang ang bawat PK file ay may TFM nito
file (na lahat ay magkapareho).

If ofm_file ay nakatakda sa 'oo' sa configuration file, magiging OFM at OVF file
nilikha din.

-q Ginagawang hbf2gf tahimik.

hbf2gf [-q] [-p] [-g] [-n] subfont-name x-resolution [y-scale | y-resolution]

Ang mode na ito ay inilaan para sa paggamit sa mktexk at mga derivate nito. Isang GF file lang
kasama ang isang PL file para sa ibinigay na subfont ay kukuwentahin, na kumukuha ng pahalang
resolution at isang vertical scaling factor (kung ang value ay mas maliit sa 10) resp. ang
vertical resolution (kung hindi man) mula sa command line, hindi pinapansin ang nmb_fonts
parameter ng configuration file. Ang huling dalawang karakter (na binibigyang-kahulugan
bilang subfont number) ay tinanggal upang makuha ang pangalan para sa configuration file (na
dapat magtapos sa '.cfg'). Walang gagawing file ng trabaho. Kung opsyon -p ay nakatakda, walang PL file
ay nilikha. Kung -g ay nakatakda, walang GF file na nalikha. Maaaring kontrolin ang extension
sa -n; kung itinakda, ang extension ay '.gf', kung hindi ay '.paglutas>gf'. -q Ginagawang
hbf2gf tahimik.

hbf2gf -t [-q] subfont-name

Ang mode na ito ay inilaan para sa paggamit sa mga script tulad ng mktexk; ito ay sumusubok kung ang
Ang tinukoy na pangalan ng subfont ay humahantong sa isang hbf2gf configuration file. Nagbabalik ito ng 0 sa
tagumpay at nai-print ang pangalan ng configuration file na iyon (ibinigay ang -q lumipat
ay hindi nakatakda). Ang pagsusulit na ito ay hindi isang masinsinang pagsubok; inaalis lang nito ang huling dalawang character
at sinusuri kung mayroong configuration file na may ganoong pangalan.

Tingnan ang susunod na seksyon para sa higit pang mga detalye tungkol sa mga configuration file.

Pagtukoy sa opsyon --bersyon ibinabalik ang kasalukuyang bersyon ng hbf2gf at ang ginamit na file
maghanap sa library (hal kpathsea). Ang impormasyon sa paggamit ay ipinapakita kasama ang - Tumulong parameter

Configuration FILE

Narito ang isang sample na configuration file (gsfs14.cfg) para sa isang 56×56 Chinese na font sa GB encoding;
tandaan na ang lahat ng impormasyon tungkol sa font ay nasa jfs56.hbf file. Tingnan ang FILE SEARCHING
seksyon kung paano ang mga font ng HBF at hbf2gf Natagpuan ang mga configuration file. Tingnan ang KAPANGYARIHAN
seksyon kung saan kukuha ng mga CJK font kasama ng mga HBF file nito:

hbf_header jfs56.hbf
mag_x 1
threshold 128
komento jianti fansongti 56x56 pixel font

disenyo_laki 14.4

y_offset -13

nmb_files -1

output_name gsfs14

checksum 123456789

dpi_x 300

pk_files no
tfm_files oo

coding codingscheme Na-encode ni GuoBiao ang TeX text

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

Ang configuration file ay isang plain text file na binubuo ng mga keyword at mga argumento nito. A
keyword ay dapat magsimula ng isang linya, kung hindi, ang buong linya ay hindi papansinin. Kung ang salitang nagsisimula
ang isang linya ay hindi isang keyword, ang linya ay hindi rin papansinin. Malalaktawan din ang mga walang laman na linya.
Ang paghahanap para sa mga keyword ay case insensitive; sa kaibahan, ang mga argumento ay kukunin
eksakto tulad ng ibinigay (maliban sa 'oo' at 'hindi' na maaaring isulat gamit ang uppercase o lowercase
mga titik). Ang bawat keyword ay may isang argumento na dapat paghiwalayin ng whitespace (mga blangko o
tab) mula sa keyword at dapat nasa parehong linya. Ang bawat linya ay hindi dapat mas mahaba kaysa sa
256 character.

Maaari mong gamitin ang mga variable ng kapaligiran sa configuration file. Ang karakter sa pagtakas
Ang pagsisimula ng environment variable sa configuration file ay palaging '$', kahit para sa
mga operating system tulad ng DOS na may iba pang mga convention. hbf2gf kinikilala lamang
environment variable na mga pangalan na nagsisimula sa isang titik o isang underscore, na sinusundan ng
mga alphanumeric na character o underscore. Maaari mong palibutan ang variable ng mga braces sa
ipahiwatig kung saan nagtatapos ang pangalan ng variable, halimbawa ${FOO}. Para makakuha ng dollar sign kailangan mo
isulat ang '$$'. Ang pagpapalawak ng mga variable ng kapaligiran sa hbf2gf mismo (nang walang tulong ng
alinman sa kpathsea, emtexdir, o MiKTeX na mga gawain sa paghahanap) ay napakalimitado; ang tampok na ito ay may
nadala mula sa mga nakaraang bersyon. Hindi nito mapalawak ang mga variable na itinakda sa texmf.cnf; ito
hindi rin maaaring pangasiwaan ang higit sa isang direktoryo bilang halaga ng variable. Huwag gamitin it maliban
para ang 'pk_directory' at 'tfm_directory' mga parameter!

Ito ang listahan ng lahat ng kinakailangang keyword:

hbf_header
Ang HBF header file name ng input font(s). hbf2gf gumagamit ng ibinigay na paghahanap
mekanismo (kpathsea, emtexdir, o MiKTeX) upang mahanap ang file na ito.

output_name
Ang stem ng pangalan ng mga output file. Isang tumatakbong dalawang digit na decimal na numero na nagsisimula
na may '01' ay idaragdag. Para sa mga Unicode font tingnan ang keyword unicode sa ibaba. Ito
Ang halaga ay halos lahat ng mga kaso ay magkapareho sa pangalan ng configuration file.

At ngayon lahat ng opsyonal na keyword:

x_offset
Pinapataas ang lapad ng character. Ilalapat sa magkabilang panig; default para sa hindi
ang mga rotated glyph ay ang value na ibinigay sa HBF header (HBF_BITMAP_BOUNDING_BOX)
naka-scale sa disenyo_laki (sa mga pixel).

y_offset
Inililipat ang lahat ng mga character pataas o pababa; Ang default para sa mga hindi na-rotate na glyph ay ang ibinigay na halaga
sa header ng HBF (HBF_BITMAP_BOUNDING_BOX) naka-scale sa disenyo_laki (sa mga pixel).

disenyo_laki
Ang laki ng disenyo (sa mga puntos) ng font. x_offset at y_offset sumangguni sa laki na ito.
Ang default ay 10.0.

pahilig Ang slant ng font (ibinigay bilang Delta_x / Delta_y). Mga value lang sa range
0 ≤ pahilig ≤ 1 ang pinapayagan. Ang default ay 0.0.

pag-ikot
Kung itatakda sa 'oo', ang lahat ng glyph ay iikot nang 90 degrees counter-clockwise. Ang
Ang mga default na offset gaya ng ibinigay sa header ng HBF ay hindi papansinin (at itatakda sa 0). Default
ay hindi'.

mag_x
mag_y Pag-scale ng mga halaga ng mga character upang maabot ang laki ng disenyo. Kung isa lang magnification
ay ibinigay, ang mga halaga ng x at y ay ipinapalagay na pantay. Default ay mag_x = mag_y = 1.0.

threshold
Isang halaga sa pagitan ng 1 at 254 na tumutukoy sa isang threshold para sa pag-convert ng panloob na graymap
sa output bitmap; ang mas mababang mga halaga ay nakakabawas ng higit pang mga pixel. Ang default na halaga ay 128.

puna
Isang komento na naglalarawan sa font; ang default ay wala.

nmb_fonts
Ang bilang ng mga subfont na gagawin. Ang default na halaga ay -1 para sa paglikha ng lahat ng mga font.

unicode
Kung 'oo', isang dalawang digit na hexadecimal na numero ang gagamitin bilang isang tumatakbong numero, simula
na may halaga ng unang byte ng unang hanay ng code. Default ay 'hindi'.

min_char
Ang pinakamababang halaga ng pag-encode. Dapat mong itakda ang halagang ito upang maging tama
nag-offset ang subfile kung hindi ito kapareho sa pinakamababang code ng character sa HBF
file.

dpi_x
dpi_y Ang pahalang at patayong resolution (sa dpi) ng printer. Kung isa lang
resolution ay ibinigay, x at y halaga ay ipinapalagay na pantay. Ang default ay 300.

checksum
Isang checksum upang matukoy ang mga GF file na may naaangkop na TFM file. Ang default
Ang halaga ng hindi nakapirmang 32bit na integer na ito ay 0.

pagkukudigo Isang komento na naglalarawan sa coding scheme; ang default ay wala.

pk_directory
Ang patutunguhang direktoryo ng mga PK file; default: wala. Pansin! Ang batch
hindi susuriin ng file kung umiiral ang direktoryo na ito.

tfm_directory
Ang patutunguhang direktoryo ng mga TFM file; default: wala. Pansin! Ang batch
hindi susuriin ng file kung umiiral ang direktoryo na ito.

pk_files
Kung lilikha ng mga PK file o hindi; default ay 'oo'.

tfm_files
Kung lilikha ng mga TFM file o hindi; default ay 'oo'.

ofm_file
Kung lilikha ng OPL file o hindi; default ay 'hindi'. Ang batch file ay pagkatapos
gamitin ovp2ovf ng pamamahagi ng Omega upang i-convert ito sa isang OFM at isang OVF file.
Ang OPL file ay nagmamapa lamang ng lahat ng mga subfont pabalik sa isang Omega font.

mahabang_extension
Kung 'oo', isasama ng mga PK file ang resolution sa extension (hal
gsso1201.300pk). Nakakaapekto lamang ito sa batch file (default ay 'oo').

rm_command
Ang shell command upang alisin ang mga file; default: 'rm'.

cp_command
Ang shell command upang kopyahin ang mga file; default: 'cp'.

job_extension
Ang extension ng batch file na tumatawag gftopk at pltotf para ma-convert ang GF at
ang mga PL file sa PK at TFM file ayon sa pagkakabanggit; ang default ay wala.

FILE SEARCHING

hbf2gf gumagamit ng alinman sa kpathsea, emtexdir, O MiKTeX library para sa paghahanap ng mga file (emtexdir
gagana lamang sa mga operating system na mayroong MS-DOSish na background, ibig sabihin, MS-DOS,
OS/2, Windows; MiKTeX ay para sa Win32 system).

kpathsea
Ang aktwal na bersyon ng kpathsea ay ipinapakita sa screen kung tatawag ka hbf2gf --bersyon.

Narito ang isang talahanayan ng uri ng file at ang katumbas kpathsea mga variable.

.hbf MGA MALI
.cfg HBF2GFINPUTS

Mangyaring kumonsulta sa mga file ng impormasyon ng kpathsea para sa mga detalye sa mga variable na ito. Ang desisyon
kung aling scheme ng pagbibigay ng pangalan ang gagamitin para sa mga variable ay gagawin sa panahon ng compilation.

Dapat mong itakda ang TEXMFCNF variable sa direktoryo kung saan ang iyong texmf.cnf configuration
naninirahan ang file.

Narito ang wastong utos upang malaman kung aling halaga ang a kpathsea variable ay nakatakda (ginagamit namin
MISCFONTS bilang isang halimbawa). Ito ay lalong kapaki-pakinabang kung ang isang variable ay hindi nakatakda sa texmf.cnf
o sa kapaligiran, kaya itinuturo ang default na halaga na naka-hard-code sa
kpathsea library.

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

Pinipili din namin ang pangalan ng programa dahil posible na tukuyin ang mga variable na
naghanap lamang para sa isang partikular na programa – sa aming halimbawa ito ay magiging MISCFONTS.hbf2gf.

Ang isang katulad ngunit hindi magkatulad na paraan ay ang sabihin

kpsewhich -progname=hbf2gf -show-path='misc fonts'

[Ang isang buong listahan ng mga uri ng format ay maaaring makuha sa pamamagitan ng pagsasabi ng 'kpsewhich --help' sa command
line prompt.] Ganito talaga hbf2gf paghahanap ng mga file; ang disadvantage lang yan
ang mga variable ay pinalawak na maaaring magdulot ng napakahabang mga string.

emtexdir
Narito ang listahan ng mga suffix at ang mga nauugnay na variable ng kapaligiran nito na itatakda sa autoexec.bat
(resp. sa config.sys para sa OS/2):

.hbf HBFONTS
.cfg HBFCFG

Kung hindi nakatakda ang isa sa mga variable, may ilalabas na mensahe ng babala. Ang kasalukuyang direktoryo
ay laging hahanapin. Gaya ng dati, isang tandang padamdam ang nakadugtong sa isang path ng direktoryo
nagiging sanhi ng paghahanap ng mga subdirectory sa isang antas, dalawang tandang padamdam ang sanhi ng lahat
mga subdirectory na hahanapin. Halimbawa:

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

Ang mga konstruksyon tulad ng 'c:\fonts!!\hbf' ay hindi posible.

MikTeX
Mangyaring kumonsulta sa mga file ng dokumentasyon ng MiKTeX para sa karagdagang detalye.

LIMITASYON

Ang laki ng output ng x at y ay hindi dapat lumampas MAX_CHAR_SIZE, na tinukoy sa oras ng pag-compile;
ang default na halaga nito ay 1023 (pixel).

Gamitin ang hbf2gf online gamit ang mga serbisyo ng onworks.net