hbf2gf - Dalam Talian di Awan

JADUAL:

NAMA

hbf2gf - tukar fon bitmap CJK kepada subfon yang boleh digunakan oleh TeX dan Omega.

SINOPSIS

hbf2gf [-q] fail konfigurasi[.cfg]
hbf2gf [-q] [-p] [-g] [-n] nama subfon resolusi x [skala y | resolusi-y]
hbf2gf -t [-q] nama subfon
hbf2gf --versi | - membantu

DESCRIPTION

Fon peta bit CJK tidak boleh digunakan secara langsung dengan TeX kerana bilangan aksara sedemikian
fon melebihi 256, had fon TeX. Oleh itu, adalah perlu untuk memisahkan fon ini
ke dalam subfon, dan inilah sebenarnya hbf2gf tidak.

Seperti namanya, hbf2gf menggunakan fon CJK dalam format tertentu yang dipanggil Hanzi Bitmap
Fon (HBF) format. Ia hanya terdiri daripada fail peta bit CJK dan fail teks dalam a
format sangat serupa dengan format BDF Sistem Tetingkap X yang menerangkan peta bit
fail fon: pengekodan, saiz, dll. Fail GF yang dihasilkan kemudiannya boleh ditukar dengan
gftopk ke dalam fail PK standard.

hbf2gf boleh dipanggil dalam tiga mod:

hbf2gf [-q] fail konfigurasi[.cfg]

Panggilan ini biasanya mencipta satu set fail GF, satu fail PL dan satu fail kelompok yang
mesti dilaksanakan selepas hbf2gf telah selesai. Skrip ini kemudiannya akan memanggil gftopk kepada
menukar semua fail GF kepada fail PK, dan ia akan memanggil pltotf untuk menukar fail PL
ke dalam fail TFM. Akhirnya ia akan menyalin fail TFM supaya setiap fail PK mempunyai TFMnya
fail (yang semuanya sama).

If ofm_file ditetapkan kepada 'ya' dalam fail konfigurasi, fail OFM dan OVF akan menjadi
dicipta juga.

-q membuat hbf2gf senyap.

hbf2gf [-q] [-p] [-g] [-n] nama subfon resolusi x [skala y | resolusi-y]

Mod ini bertujuan untuk digunakan dengan mktexk dan terbitannya. Hanya satu fail GF
bersama-sama dengan fail PL untuk subfon yang diberikan akan dikira, mengambil mendatar
resolusi dan faktor penskalaan menegak (jika nilainya lebih kecil daripada 10) resp. yang
resolusi menegak (sebaliknya) dari baris arahan, mengabaikan nmb_fonts
parameter fail konfigurasi. Dua aksara terakhir (yang ditafsirkan
sebagai nombor subfon) dilucutkan untuk mendapatkan nama bagi fail konfigurasi (yang
mesti berakhir dengan '.cfg'). Tiada fail kerja akan dibuat. Jika pilihan -p ditetapkan, tiada fail PL
dicipta. Jika -g ditetapkan, tiada fail GF dibuat. Sambungan boleh dikawal
bersama -n; jika ditetapkan, sambungannya ialah '.gf', jika tidak '.resolusi>gf'. -q membuat
hbf2gf senyap.

hbf2gf -t [-q] nama subfon

Mod ini bertujuan untuk digunakan dengan skrip seperti mktexk; ia menguji sama ada
nama subfon yang ditentukan membawa kepada a hbf2gf fail konfigurasi. Ia kembali 0 pada
kejayaan dan mencetak nama fail konfigurasi itu (dengan syarat -q bertukar
tidak ditetapkan). Ujian ini bukanlah ujian yang menyeluruh; ia hanya mengalih keluar dua aksara terakhir
dan menyemak sama ada fail konfigurasi dengan nama itu wujud.

Lihat bahagian seterusnya untuk mendapatkan butiran lanjut tentang fail konfigurasi.

Menentukan pilihan --versi mengembalikan versi semasa hbf2gf dan fail yang digunakan
perpustakaan carian (cth kpathsea). Maklumat penggunaan ditunjukkan dengan - membantu parameter.

CONFIGURATION FAIL

Di sini contoh fail konfigurasi (gsfs14.cfg) untuk fon Cina 56×56 dalam pengekodan GB;
ambil perhatian bahawa semua maklumat tentang fon ada dalam fail jfs56.hbf. Lihat FAIL MENCARI
bahagian bagaimana fon HBF dan hbf2gf fail konfigurasi ditemui. Lihat KETERSEDIAAN
bahagian tempat untuk mendapatkan fon CJK bersama-sama dengan fail HBFnya:

hbf_header jfs56.hbf
mag_x 1
ambang 128
komen jianti fansongti fon 56x56 piksel

reka bentuk_saiz 14.4

y_offset -13

nmb_files -1

nama_keluaran gsfs14

checksum 123456789

dpi_x 300

pk_files no
tfm_files ya

pengekodan skema pengekodan GuoBiao mengekodkan teks TeX

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

Fail konfigurasi ialah fail teks biasa yang terdiri daripada kata kunci dan hujahnya. A
kata kunci mesti memulakan baris, jika tidak, keseluruhan baris akan diabaikan. Jika perkataan bermula
baris bukan kata kunci, baris itu akan diabaikan juga. Talian kosong juga akan dilangkau.
Carian untuk kata kunci adalah tidak peka huruf besar-besaran; sebaliknya, hujah akan diambil
tepat seperti yang diberikan (kecuali 'ya' dan 'tidak' yang boleh ditulis dengan huruf besar atau kecil
surat). Setiap kata kunci mempunyai satu hujah yang mesti dipisahkan dengan ruang putih (kosong atau
tab) daripada kata kunci dan mesti berada pada baris yang sama. Setiap baris tidak boleh lebih panjang daripada
256 watak.

Anda boleh menggunakan pembolehubah persekitaran dalam fail konfigurasi. Watak melarikan diri
memulakan pembolehubah persekitaran dalam fail konfigurasi sentiasa '$', walaupun untuk
sistem pengendalian seperti DOS yang mempunyai konvensyen lain. hbf2gf mengenali sahaja
nama pembolehubah persekitaran yang bermula dengan huruf atau garis bawah, diikuti dengan
aksara abjad angka atau garis bawah. Anda boleh mengelilingi pembolehubah dengan pendakap ke
nyatakan di mana nama pembolehubah berakhir, contohnya ${FOO}. Untuk mendapatkan tanda dolar anda mesti
tulis '$$'. Pengembangan pembolehubah persekitaran dalam hbf2gf itu sendiri (tanpa bantuan
sama ada kpathsea, emtexdir, atau rutin mencari MiKTeX) adalah sangat terhad; ciri ini mempunyai
telah dibawa dari versi sebelumnya. Ia tidak boleh mengembangkan pembolehubah yang ditetapkan dalam texmf.cnf; ia
juga tidak boleh mengendalikan lebih daripada satu direktori sebagai nilai pembolehubah. jangan penggunaan it kecuali
Untuk yang 'pk_directory' and 'tfm_directory' parameter!

Ini ialah senarai semua kata kunci yang diperlukan:

hbf_header
Nama fail pengepala HBF bagi fon input. hbf2gf menggunakan carian yang diberikan
mekanisme (kpathsea, emtexdir, atau MiKTeX) untuk mencari fail ini.

nama_keluaran
Nama batang fail output. Nombor perpuluhan dua digit berjalan bermula
dengan '01' akan dilampirkan. Untuk fon Unicode lihat kata kunci unicode di bawah. ini
nilai dalam hampir semua kes adalah sama dengan nama fail konfigurasi.

Dan kini semua kata kunci pilihan:

x_offset
Meningkatkan lebar aksara. Akan digunakan pada kedua-dua belah pihak; lalai untuk bukan
glyph diputar ialah nilai yang diberikan dalam pengepala HBF (HBF_BITMAP_BOUNDING_BOX)
skala kepada saiz_reka bentuk (dalam piksel).

y_offset
Mengalihkan semua aksara ke atas atau ke bawah; lalai untuk glyph tidak diputar ialah nilai yang diberikan
dalam tajuk HBF (HBF_BITMAP_BOUNDING_BOX) berskala kepada saiz_reka bentuk (dalam piksel).

saiz_reka bentuk
Saiz reka bentuk (dalam mata) fon. x_offset and y_offset rujuk saiz ini.
Lalai adalah 10.0.

senget Kecondongan fon (diberikan sebagai Delta_x / Delta_y). Hanya nilai dalam julat
0 ≤ senget ≤ 1 dibenarkan. Lalai ialah 0.0.

putaran
Jika ditetapkan kepada 'ya', semua glyph akan diputar 90 darjah melawan arah jam. The
offset lalai seperti yang diberikan dalam pengepala HBF akan diabaikan (dan ditetapkan kepada 0). lalai
adalah 'tidak'.

mag_x
mag_y Menskalakan nilai aksara untuk mencapai saiz reka bentuk. Jika hanya satu pembesaran
diberi, nilai x dan y diandaikan sama. Lalai ialah mag_x = mag_y = 1.0.

ambang
Nilai antara 1 dan 254 mentakrifkan ambang untuk menukar peta kelabu dalaman
ke dalam peta bit keluaran; nilai yang lebih rendah mengurangkan lebih banyak piksel. Nilai lalai ialah 128.

komen
Komen yang menerangkan fon; lalai adalah tiada.

nmb_fonts
Bilangan subfon untuk dibuat. Nilai lalai ialah -1 untuk mencipta semua fon.

unicode
Jika 'ya', nombor heksadesimal dua digit akan digunakan sebagai nombor larian, bermula
dengan nilai bait pertama julat kod pertama. Lalai ialah 'tidak'.

min_char
Nilai minimum pengekodan. Anda harus menetapkan nilai ini untuk menjadi betul
subfail mengimbangi jika ia tidak sama dengan kod aksara terendah dalam HBF
fail.

dpi_x
dpi_y Resolusi mendatar dan menegak (dalam dpi) pencetak. Jika hanya satu
resolusi diberikan, nilai x dan y diandaikan sama. Lalai ialah 300.

checksum
Checksum untuk mengenal pasti fail GF dengan fail TFM yang sesuai. lalai
nilai integer 32bit yang tidak ditandatangani ini ialah 0.

pengekodan Komen yang menerangkan skema pengekodan; lalai adalah tiada.

pk_directory
Direktori destinasi fail PK; lalai: tiada. Perhatian! Kumpulan itu
fail tidak akan menyemak sama ada direktori ini wujud.

tfm_directory
Direktori destinasi fail TFM; lalai: tiada. Perhatian! Kumpulan itu
fail tidak akan menyemak sama ada direktori ini wujud.

pk_files
Sama ada untuk membuat fail PK atau tidak; lalai ialah 'ya'.

tfm_files
Sama ada untuk membuat fail TFM atau tidak; lalai ialah 'ya'.

ofm_file
Sama ada untuk membuat fail OPL atau tidak; lalai ialah 'tidak'. Fail kelompok kemudiannya
penggunaan ovp2ovf pengedaran Omega untuk menukarnya menjadi fail OFM dan OVF.
Fail OPL hanya memetakan semua subfon kembali kepada satu fon Omega.

panjang_sambungan
Jika 'ya', fail PK akan menyertakan resolusi dalam sambungan (cth
gsso1201.300pk). Ini memberi kesan kepada fail kelompok sahaja (lalai ialah 'ya').

rm_command
Perintah shell untuk mengalih keluar fail; lalai: 'rm'.

cp_command
Perintah shell untuk menyalin fail; lalai: 'cp'.

lanjutan_kerja
Sambungan fail kelompok yang memanggil gftopk and pltotf untuk menukar GF dan
fail PL ke dalam fail PK dan TFM masing-masing; lalai adalah tiada.

FAIL MENCARI

hbf2gf menggunakan sama ada kpathsea, emtexdir, Atau MiKTeX perpustakaan untuk mencari fail (emtexdir
hanya akan berfungsi pada sistem pengendalian yang mempunyai latar belakang MS-DOSish, iaitu, MS-DOS,
OS/2, Windows; MiKTeX adalah untuk sistem Win32).

kpathsea
Versi sebenar kpathsea dipaparkan pada skrin jika anda membuat panggilan hbf2gf --versi.

Berikut ialah jadual jenis fail dan yang sepadan kpathsea pembolehubah.

.hbf SALAH FON
.cfg HBF2GFINPUTS

Sila rujuk fail maklumat bagi kpathsea untuk butiran tentang pembolehubah ini. keputusannya
skema penamaan yang akan digunakan untuk pembolehubah akan dilakukan semasa penyusunan.

Anda harus menetapkan pembolehubah TEXMFCNF ke direktori tempat konfigurasi texmf.cnf anda
fail berada.

Berikut ialah arahan yang betul untuk mengetahui nilai a kpathsea pembolehubah ditetapkan (kami gunakan
SALAH FON sebagai contoh). Ini amat berguna jika pembolehubah tidak ditetapkan dalam texmf.cnf
atau dalam persekitaran, dengan itu menunjuk kepada nilai lalai yang dikodkan keras ke dalam
kpathsea perpustakaan.

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

Kami memilih nama program juga kerana ia adalah mungkin untuk menentukan pembolehubah yang
mencari hanya untuk program tertentu - dalam contoh kami ia akan menjadi MISCFONTS.hbf2gf.

Kaedah yang serupa tetapi tidak serupa adalah dengan mengatakan

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

[Senarai penuh jenis format boleh diperolehi dengan menyebut 'kpsewhich --help' pada arahan
line prompt.] Beginilah caranya hbf2gf mencari fail; kelemahannya ialah itu sahaja
pembolehubah diperluas yang boleh menyebabkan rentetan yang sangat panjang.

emtexdir
Di sini senarai akhiran dan pembolehubah persekitaran yang berkaitan untuk ditetapkan dalam autoexec.bat
(resp. dalam config.sys untuk OS/2):

.hbf HBFONTS
.cfg HBFCFG

Jika salah satu pembolehubah tidak ditetapkan, mesej amaran dikeluarkan. Direktori semasa
akan sentiasa dicari. Seperti biasa, satu tanda seru ditambahkan pada laluan direktori
menyebabkan subdirektori satu tahap dalam untuk dicari, dua tanda seru menyebabkan semua
subdirektori untuk dicari. Contoh:

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

Pembinaan seperti 'c:\fonts!!\hbf' tidak boleh dilakukan.

MikTeX
Sila rujuk fail dokumentasi bagi MiKTeX untuk maklumat lanjut.

HADAH

Saiz keluaran x dan y tidak boleh melebihi MAX_CHAR_SIZE, yang ditakrifkan pada masa penyusunan;
nilai lalainya ialah 1023 (piksel).

Gunakan hbf2gf dalam talian menggunakan perkhidmatan onworks.net