hbf2gf - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

hbf2gf - chuyển đổi phông chữ bitmap CJK thành phông chữ con có thể sử dụng được bởi TeX và Omega.

SYNOPSIS

hbf2gf [-q] tập tin cấu hình[.cfg]
hbf2gf [-q] [-p] [-g] [-n] tên con độ phân giải x [quy mô y | độ phân giải y]
hbf2gf -t [-q] tên con
hbf2gf --phiên bản | --Cứu giúp

MÔ TẢ

Phông chữ bitmap CJK không thể được sử dụng trực tiếp với TeX vì số lượng ký tự trong đó
phông chữ vượt quá 256, giới hạn của phông chữ TeX. Vì vậy, cần phải chia nhỏ các phông chữ này
thành subfonts và đây chính xác là những gì hbf2gf không.

Như tên đã nói, hbf2gf sử dụng phông chữ CJK ở một định dạng nhất định được gọi là Hán tử Bitmap
Font (HBF) định dạng. Nó chỉ bao gồm (các) tệp bitmap CJK và một tệp văn bản trong
định dạng rất giống với định dạng BDF của Hệ thống cửa sổ X mô tả bitmap
tệp phông chữ: mã hóa, kích thước, v.v. Các tệp GF được tạo sau đó có thể được chuyển đổi bằng
gftopk thành các tệp PK tiêu chuẩn.

hbf2gf có thể được gọi trong ba chế độ:

hbf2gf [-q] tập tin cấu hình[.cfg]

Lệnh gọi này thường tạo một tập hợp các tệp GF, một tệp PL và một tệp loạt
phải được thực hiện sau hbf2gf Đã hoàn thành xong. Tập lệnh này sau đó sẽ gọi gftopk đến
chuyển đổi tất cả các tệp GF thành tệp PK và nó sẽ gọi pltotf để chuyển đổi tệp PL
vào một tệp TFM. Cuối cùng, nó sẽ sao chép tệp TFM để mỗi tệp PK có TFM của nó
tệp (tất cả đều giống nhau).

If ofm_file được đặt thành 'có' trong tệp cấu hình, các tệp OFM và OVF sẽ là
cũng được tạo ra.

-q làm cho hbf2gf Yên tĩnh.

hbf2gf [-q] [-p] [-g] [-n] tên con độ phân giải x [quy mô y | độ phân giải y]

Chế độ này được thiết kế để sử dụng với mktextk và dẫn xuất của nó. Chỉ một tệp GF
cùng với một tệp PL cho subfont đã cho sẽ được tính toán, lấy theo chiều ngang
độ phân giải và hệ số tỷ lệ dọc (nếu giá trị nhỏ hơn 10) tương ứng. NS
độ phân giải dọc (nếu không) từ dòng lệnh, bỏ qua nmb_fonts
tham số của tệp cấu hình. Hai ký tự cuối cùng (được diễn giải
như số subfont) được loại bỏ để lấy tên cho tệp cấu hình (mà
phải kết thúc bằng '.cfg'). Không có tệp công việc nào sẽ được tạo. Nếu tùy chọn -p được thiết lập, không có tệp PL
được tạo ra. Nếu như -g được đặt, không có tệp GF nào được tạo. Phần mở rộng có thể được kiểm soát
với -n; nếu được đặt, phần mở rộng là '.gf', ngược lại là '.độ phân giải> gf '. -q làm cho
hbf2gf Yên tĩnh.

hbf2gf -t [-q] tên con

Chế độ này được thiết kế để sử dụng với các tập lệnh như mktextk; nó kiểm tra xem
tên thành phần con được chỉ định dẫn đến một hbf2gf tập tin cấu hình. Nó trả về 0 trên
thành công và in ra tên của tệp cấu hình đó (miễn là -q chuyển đổi
không được thiết lập). Bài kiểm tra này không phải là một bài kiểm tra kỹ lưỡng; nó chỉ xóa hai ký tự cuối cùng
và kiểm tra xem tệp cấu hình có tên đó có tồn tại hay không.

Xem phần tiếp theo để biết thêm chi tiết về các tệp cấu hình.

Chỉ định tùy chọn --phiên bản trả về phiên bản hiện tại của hbf2gf và tệp đã sử dụng
thư viện tìm kiếm (ví dụ: kpathsea). Thông tin sử dụng được hiển thị với --Cứu giúp tham số.

CẤU HÌNH FILE

Đây là một tệp cấu hình mẫu (gsfs14.cfg) cho một phông chữ Trung Quốc 56 × 56 ở bảng mã GB;
lưu ý rằng tất cả thông tin về phông chữ đều có trong tệp jfs56.hbf. Xem FILE ĐANG TÌM KIẾM
phần cách các phông chữ HBF và hbf2gf các tập tin cấu hình được tìm thấy. Xem KHẢ DỤNG
phần nơi lấy phông chữ CJK cùng với các tệp HBF của nó:

hbf_header jfs56.hbf
mag_x 1
ngưỡng 128
bình luận jianti fansongti phông chữ 56x56 pixel

thiết kế_kích thước 14.4

y_offset -13

nmb_files -1

tên_đầu ra gsfs14

tổng kiểm tra 123456789

dpi_x 300

pk_files không
tfm_files vâng

coding codingscheme GuoBiao văn bản được mã hóa TeX

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

Tệp cấu hình là một tệp văn bản thuần túy bao gồm các từ khóa và các đối số của nó. MỘT
từ khóa phải bắt đầu một dòng, nếu không toàn bộ dòng sẽ bị bỏ qua. Nếu từ bắt đầu
một dòng không phải là từ khóa, dòng đó cũng sẽ bị bỏ qua. Các dòng trống cũng sẽ bị bỏ qua.
Tìm kiếm từ khóa không phân biệt chữ hoa chữ thường; ngược lại, các đối số sẽ được lấy
chính xác như đã cho (ngoại trừ 'có' và 'không' có thể được viết bằng chữ hoa hoặc chữ thường
bức thư). Mỗi từ khóa có một đối số phải được phân tách bằng khoảng trắng (khoảng trống hoặc
tab) từ từ khóa và phải nằm trên cùng một dòng. Mỗi dòng không được dài hơn
256 ký tự.

Bạn có thể sử dụng các biến môi trường trong tệp cấu hình. Nhân vật trốn thoát
bắt đầu một biến môi trường trong tệp cấu hình luôn là '$', ngay cả đối với
hệ điều hành như DOS có các quy ước khác. hbf2gf chỉ nhận ra
tên biến môi trường bắt đầu bằng chữ cái hoặc dấu gạch dưới, theo sau là
ký tự chữ và số hoặc dấu gạch dưới. Bạn có thể bao quanh biến bằng dấu ngoặc nhọn để
cho biết vị trí kết thúc của tên biến, ví dụ: $ {FOO}. Để có được một ký đô la, bạn phải
viết '$$'. Việc mở rộng các biến môi trường trong chính hbf2gf (mà không cần sự trợ giúp của
quy trình tìm kiếm kpathsea, emtexdir hoặc MiKTeX) rất hạn chế; tính năng này có
được chuyển từ các phiên bản trước. Nó không thể mở rộng các biến được đặt trong texmf.cnf; nó
cũng không thể xử lý nhiều hơn một thư mục làm giá trị của biến. Đừng sử dụng it ngoại trừ
cho các 'pk_directory' và 'tfm_directory' thông số!

Đây là danh sách tất cả các từ khóa cần thiết:

hbf_header
Tên tệp tiêu đề HBF của (các) phông chữ đầu vào. hbf2gf sử dụng tìm kiếm nhất định
cơ chế (kpathsea, emtexdir hoặc MiKTeX) để định vị tệp này.

tên_đầu ra
Tên gốc của các tệp đầu ra. Một số thập phân có hai chữ số đang chạy bắt đầu
với '01' sẽ được thêm vào. Đối với phông chữ Unicode, hãy xem từ khóa unicode phía dưới. Cái này
giá trị trong hầu hết các trường hợp giống với tên của tệp cấu hình.

Và bây giờ tất cả các từ khóa tùy chọn:

x_offset
Tăng chiều rộng ký tự. Sẽ được áp dụng cho cả hai bên; mặc định cho không
glyph được xoay là giá trị được đưa ra trong tiêu đề HBF (HBF_BITMAP_BOUNDING_BOX)
mở rộng thành thiết kế_size (tính bằng pixel).

y_offset
Di chuyển tất cả các ký tự lên hoặc xuống; mặc định cho glyph không được xoay là giá trị đã cho
trong tiêu đề HBF (HBF_BITMAP_BOUNDING_BOX) được mở rộng thành thiết kế_size (tính bằng pixel).

thiết kế_size
Kích thước thiết kế (tính bằng điểm) của phông chữ. x_offset và y_offset tham khảo kích thước này.
Mặc định là 10.0.

xiên Độ nghiêng của phông chữ (được cho là Delta_x / Delta_y). Chỉ các giá trị trong phạm vi
0 ≤ xiên ≤ 1 được phép. Mặc định là 0.0.

luân chuyển
Nếu được đặt thành 'yes', tất cả glyph sẽ được xoay 90 độ ngược chiều kim đồng hồ. Các
các hiệu số mặc định như được đưa ra trong tiêu đề HBF sẽ bị bỏ qua (và được đặt thành 0). Vỡ nợ
là 'không'.

mag_x
mag_y Giá trị tỷ lệ của các ký tự để đạt đến kích thước thiết kế. Nếu chỉ phóng đại một lần
được cho trước, các giá trị x và y được giả sử là bằng nhau. Mặc định là mag_x = mag_y = 1.0.

ngưỡng
Giá trị từ 1 đến 254 xác định ngưỡng chuyển đổi bản đồ nội bộ
vào bitmap đầu ra; giá trị thấp hơn sẽ cắt nhiều pixel hơn. Giá trị mặc định là 128.

bình luận
Một nhận xét mô tả phông chữ; mặc định là không có.

nmb_fonts
Số lượng ký tự con cần tạo. Giá trị mặc định là -1 để tạo tất cả các phông chữ.

unicode
Nếu 'có', một số thập lục phân có hai chữ số sẽ được sử dụng làm số đang chạy, bắt đầu
với giá trị của byte đầu tiên của dải mã đầu tiên. Mặc định là 'không'.

min_char
Giá trị tối thiểu của bảng mã. Bạn nên đặt giá trị này để nhận được chính xác
bù đắp tiểu sử nếu nó không giống với mã ký tự thấp nhất trong HBF
tập tin.

dpi_x
dpi_y Độ phân giải ngang và dọc (tính bằng dpi) của máy in. Nếu chỉ một
độ phân giải được đưa ra, các giá trị x và y được giả định là bằng nhau. Mặc định là 300.

checksum
Tổng kiểm tra để xác định các tệp GF với các tệp TFM thích hợp. Mặc định
giá trị của số nguyên 32 bit không dấu này là 0.

mã hóa Một nhận xét mô tả sơ đồ mã hóa; mặc định là không có.

thư mục pk_
Thư mục đích của các tệp PK; mặc định: không có. Chú ý! Lô
tập tin sẽ không kiểm tra xem thư mục này có tồn tại hay không.

tfm_directory
Thư mục đích của các tệp TFM; mặc định: không có. Chú ý! Lô
tập tin sẽ không kiểm tra xem thư mục này có tồn tại hay không.

pk_files
Có tạo tệp PK hay không; mặc định là 'có'.

tfm_files
Có tạo tệp TFM hay không; mặc định là 'có'.

ofm_file
Có tạo tệp OPL hay không; mặc định là 'không'. Sau đó, tập tin hàng loạt sẽ
sử dụng ovp2ovf của phân phối Omega để chuyển đổi nó thành tệp OFM và tệp OVF.
Tệp OPL chỉ đơn giản ánh xạ tất cả các ký tự con trở lại một phông chữ Omega duy nhất.

long_extension
Nếu 'có', tệp PK sẽ bao gồm độ phân giải trong phần mở rộng (ví dụ:
gsso1201.300pk). Điều này chỉ ảnh hưởng đến tệp loạt (mặc định là 'có').

rm_command
Lệnh shell để xóa tệp; mặc định: 'rm'.

cp_command
Lệnh shell để sao chép tệp; mặc định: 'cp'.

công_việc_mở rộng
Phần mở rộng của tệp loạt gọi gftopk và pltotf để chuyển đổi GF và
các tệp PL thành tệp PK và TFM tương ứng; mặc định là không có.

FILE ĐANG TÌM KIẾM

hbf2gf sử dụng một trong hai kpathsea, emtexdir, hoặc là MiKTeX thư viện để tìm kiếm tệp (emtexdir
sẽ chỉ hoạt động trên các hệ điều hành có nền MS-DOSish, tức là MS-DOS,
OS / 2, Windows; MiKTeX dành cho hệ thống Win32).

kpathsea
Phiên bản thực tế của kpathsea được hiển thị trên màn hình nếu bạn gọi hbf2gf --phiên bản.

Đây là bảng loại tệp và kpathsea biến.

.hbf CHỮ LỖI
.cfg HBF2GFINPUTS

Vui lòng tham khảo các tệp thông tin của kpathsea để biết chi tiết về các biến này. Quyết định
lược đồ đặt tên nào để sử dụng cho các biến sẽ được thực hiện trong quá trình biên dịch.

Bạn nên đặt biến TEXMFCNF vào thư mục chứa cấu hình texmf.cnf của bạn
tập tin cư trú.

Đây là lệnh thích hợp để tìm ra giá trị nào a kpathsea biến được đặt (chúng tôi sử dụng
MISCFONTS làm ví dụ). Điều này đặc biệt hữu ích nếu một biến không được đặt trong texmf.cnf
hoặc trong môi trường, do đó trỏ đến giá trị mặc định được mã hóa cứng thành
kpathsea thư viện.

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

Chúng tôi cũng chọn tên chương trình vì có thể chỉ định các biến
chỉ tìm kiếm một chương trình nhất định - trong ví dụ của chúng tôi, nó sẽ là MISCFONTS.hbf2gf.

Một phương pháp tương tự nhưng không giống nhau là nói

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

[Có thể lấy danh sách đầy đủ các loại định dạng bằng cách nói 'kpsewhich --help' trên lệnh
dòng nhắc.] Đây chính là cách hbf2gf tìm kiếm các tập tin; bất lợi là tất cả
các biến được mở rộng có thể gây ra chuỗi rất dài.

emtexdir
Đây là danh sách các hậu tố và các biến môi trường liên quan của nó sẽ được đặt trong autoexec.bat
(tương ứng trong config.sys cho OS / 2):

.hbf HBFONTS
.cfg HBFCFG

Nếu một trong các biến không được đặt, một thông báo cảnh báo sẽ được phát ra. Thư mục hiện tại
sẽ luôn được tìm kiếm. Như thường lệ, một dấu chấm than được thêm vào đường dẫn thư mục
khiến các thư mục con sâu một cấp được tìm kiếm, hai dấu chấm than gây ra tất cả
thư mục con cần tìm kiếm. Thí dụ:

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

Các cấu trúc như 'c: \ fonts !! \ hbf' không thể thực hiện được.

MikTeX
Vui lòng tham khảo các tệp tài liệu của MiKTeX để biết thêm chi tiết.

GIỚI HẠN

Kích thước đầu ra x và y không được vượt quá MAX_CHAR_SIZE, được xác định tại thời điểm biên dịch;
giá trị mặc định của nó là 1023 (pixel).

Sử dụng hbf2gf trực tuyến bằng các dịch vụ onworks.net