hbf2gf - En ligne dans le Cloud

PROGRAMME:

Nom

hbf2gf - convertit une police bitmap CJK en sous-fontes utilisables par TeX et Omega.

SYNOPSIS

hbf2gf [-q] fichier de configuration[.cfg]
hbf2gf [-q] [-p] [-g] [-n] nom-sous-fonte x-résolution [échelle des y | y-résolution]
hbf2gf -t [-q] nom-sous-fonte
hbf2gf --version | --Aidez-moi

DESCRIPTION

Les polices bitmap CJK ne peuvent pas être utilisées directement avec TeX car le nombre de caractères dans ces
fonts dépasse 256, la limite d'une police TeX. Il est donc nécessaire de diviser ces polices
dans les sous-fontes, et c'est exactement ce que hbf2gf t.

Comme son nom l'indique, hbf2gf utilise des polices CJK dans un certain format appelé Hanzi Bitmap
Fonte (HBF) format. Il se compose simplement du ou des fichiers bitmap CJK et d'un fichier texte dans un
format très similaire au format BDF du système X Window qui décrit le bitmap
fichiers de polices : l'encodage, la taille, etc. Les fichiers GF produits peuvent ensuite être convertis avec
gftopk dans des fichiers PK standard.

hbf2gf peut être appelé dans trois modes :

hbf2gf [-q] fichier de configuration[.cfg]

Cet appel crée normalement un ensemble de fichiers GF, un fichier PL et un fichier batch qui
doit être exécuté après hbf2gf avoir fini. Ce script appellera alors gftopk à
convertir tous les fichiers GF en fichiers PK, et il appellera ptotf pour convertir le fichier PL
dans un fichier TFM. Enfin il copiera le fichier TFM pour que chaque fichier PK ait son TFM
fichier (qui sont tous identiques).

If ofm_file est défini sur « oui » dans le fichier de configuration, les fichiers OFM et OVF seront
créé aussi.

-q fait hbf2gf silencieux.

hbf2gf [-q] [-p] [-g] [-n] nom-sous-fonte x-résolution [échelle des y | y-résolution]

Ce mode est destiné à être utilisé avec mkexpk et ses dérivés. Un seul fichier GF
avec un fichier PL pour la sous-fonte donnée sera calculé, en prenant l'horizontale
résolution et un facteur d'échelle verticale (si la valeur est inférieure à 10) resp. les
résolution verticale (autrement) à partir de la ligne de commande, en ignorant le nmb_fonts
paramètre du fichier de configuration. Les deux derniers caractères (qui sont interprétés
comme numéro de sous-police) sont supprimés pour obtenir le nom du fichier de configuration (qui
doit se terminer par '.cfg'). Aucun fichier de tâche ne sera créé. Si option -p est défini, aucun fichier PL
est créé. Si -g est défini, aucun fichier GF n'est créé. L'extension peut être contrôlée
avec -n; si elle est définie, l'extension est '.gf', sinon '.résolution> gf'. -q fait
hbf2gf silencieux.

hbf2gf -t [-q] nom-sous-fonte

Ce mode est destiné à être utilisé avec des scripts tels que mkexpk; il teste si le
le nom de sous-fonte spécifié mène à un hbf2gf fichier de configuration. Il renvoie 0 sur
succès et imprime le nom de ce fichier de configuration (à condition que le -q interrupteur
n'est pas défini). Ce test n'est pas approfondi; il ne supprime que les deux derniers caractères
et vérifie s'il existe un fichier de configuration portant ce nom.

Voir la section suivante pour plus de détails sur les fichiers de configuration.

Spécification de l'option --version renvoie la version actuelle de hbf2gf et le fichier utilisé
bibliothèque de recherche (par exemple kpathsea). Les informations d'utilisation sont affichées avec le --Aidez-moi paramètre.

CONFIGURATION DOSSIER

Voici un exemple de fichier de configuration (gsfs14.cfg) pour une police chinoise 56×56 en codage GB ;
notez que toutes les informations sur la police se trouvent dans le fichier jfs56.hbf. Voir le DOSSIER RECHERCHE
section comment les polices HBF et hbf2gf les fichiers de configuration sont trouvés. Voir le DISPONIBILITÉ
section où obtenir les polices CJK avec ses fichiers HBF :

en-tête_hbf jfs56.hbf
mag_x 1
seuil 128
commentaire jianti fansongti police 56x56 pixels

conception_taille 14.4

décalage_y -13

nmb_files -1

nom_sortie gsfs14

somme de contrôle 123456789

ppp_x 300

pk_files non
tfm_files oui

codage schéma de codage GuoBiao texte TeX encodé

pk_directory $HBF_TARGET/pk/modeless/gb2312/gsfs14/
répertoire_tfm $HBF_TARGET/tfm/gb2312/gsfs14/

Un fichier de configuration est un fichier texte brut composé de mots-clés et de ses arguments. UNE
mot-clé doit commencer une ligne, sinon la ligne entière sera ignorée. Si le mot commençant
une ligne n'est pas un mot-clé, la ligne sera également ignorée. Les lignes vides seront également ignorées.
La recherche de mots-clés est insensible à la casse ; en revanche, les arguments seront pris
exactement comme indiqué (sauf 'oui' et 'non' qui peuvent être écrits avec des majuscules ou des minuscules
des lettres). Chaque mot-clé a un argument qui doit être séparé par des espaces (espaces ou
tabs) à partir du mot-clé et doivent se trouver sur la même ligne. Chaque ligne ne doit pas dépasser
256 caractères.

Vous pouvez utiliser des variables d'environnement dans le fichier de configuration. Le personnage d'évasion
le démarrage d'une variable d'environnement dans le fichier de configuration est toujours '$', même pour
systèmes d'exploitation comme DOS qui a d'autres conventions. hbf2gf reconnaît seulement
les noms de variables d'environnement qui commencent par une lettre ou un trait de soulignement, suivis de
caractères alphanumériques ou traits de soulignement. Vous pouvez entourer la variable d'accolades pour
indiquez où se termine le nom de la variable, par exemple ${FOO}. Pour obtenir un signe dollar, vous devez
écrivez '$$'. L'expansion des variables d'environnement dans hbf2gf lui-même (sans l'aide de
les routines de recherche kpathsea, emtexdir ou MiKTeX) est très limitée ; cette fonctionnalité a
été repris des versions précédentes. Il ne peut pas développer les variables définies dans texmf.cnf ; ce
ne peut pas non plus gérer plus d'un répertoire comme valeur de la variable. Ne pas utilisé it sauf
en le 'répertoire_pk' ainsi que 'tfm_directory' paramètres!

Voici la liste de tous les mots-clés nécessaires :

hbf_header
Le nom de fichier d'en-tête HBF de la ou des polices d'entrée. hbf2gf utilise la recherche donnée
mécanisme (kpathsea, emtexdir ou MiKTeX) pour localiser ce fichier.

nom_sortie
La racine du nom des fichiers de sortie. Un nombre décimal à deux chiffres commençant
avec '01' sera ajouté. Pour les polices Unicode, voir le mot-clé unicode au dessous de. Cette
value est dans presque tous les cas identique au nom du fichier de configuration.

Et maintenant tous les mots-clés facultatifs :

décalage_x
Augmente la largeur des caractères. Sera appliqué des deux côtés; par défaut pour les non-
glyphes tournés est la valeur donnée dans l'en-tête HBF (HBF_BITMAP_BOUNDING_BOX)
à l'échelle conception_taille (en pixels).

décalage_y
Déplace tous les caractères vers le haut ou vers le bas ; la valeur par défaut pour les glyphes non pivotés est la valeur donnée
dans l'en-tête HBF (HBF_BITMAP_BOUNDING_BOX) à l'échelle conception_taille (en pixels).

conception_taille
La taille de conception (en points) de la police. décalage_x ainsi que décalage_y se référer à cette taille.
La valeur par défaut est 10.0.

incliner L'inclinaison de la police (donnée comme Delta_x / Delta_y). Seules les valeurs de la plage
0 ≤ incliner ≤ 1 sont autorisés. La valeur par défaut est 0.0.

rotation
S'il est défini sur « oui », tous les glyphes seront pivotés de 90 degrés dans le sens inverse des aiguilles d'une montre. Les
les décalages par défaut indiqués dans l'en-tête HBF seront ignorés (et mis à 0). Défaut
est 'non'.

mag_x
mag_y Mise à l'échelle des valeurs des caractères pour atteindre la taille de conception. Si un seul grossissement
est donnée, les valeurs x et y sont supposées égales. La valeur par défaut est mag_x = mag_y = 1.0.

порог
Une valeur comprise entre 1 et 254 définissant un seuil de conversion de la graymap interne
dans le bitmap de sortie ; des valeurs plus faibles coupent plus de pixels. La valeur par défaut est 128.

commentaire
Un commentaire décrivant la police ; la valeur par défaut est aucun.

nmb_fonts
Le nombre de sous-fontes à créer. La valeur par défaut est -1 pour créer toutes les polices.

unicode
Si « oui », un nombre hexadécimal à deux chiffres sera utilisé comme nombre courant, en commençant
avec la valeur du premier octet de la première plage de codes. La valeur par défaut est « non ».

min_char
La valeur minimale de l'encodage. Vous devez définir cette valeur pour obtenir la bonne
décalages de sous-fichier s'il n'est pas identique au code de caractère le plus bas du HBF
fichier.

dpi_x
dpi_y La résolution horizontale et verticale (en dpi) de l'imprimante. Si un seul
la résolution est donnée, les valeurs x et y sont supposées égales. La valeur par défaut est 300.

somme de contrôle
Une somme de contrôle pour identifier les fichiers GF avec les fichiers TFM appropriés. Le défaut
la valeur de cet entier 32 bits non signé est 0.

Coding Un commentaire décrivant le schéma de codage ; la valeur par défaut est aucun.

pk_répertoire
Le répertoire de destination des fichiers PK ; par défaut : aucun. Attention! Le lot
ne vérifiera pas si ce répertoire existe.

répertoire_tfm
Le répertoire de destination des fichiers TFM ; par défaut : aucun. Attention! Le lot
ne vérifiera pas si ce répertoire existe.

fichiers_pk
Que ce soit pour créer des fichiers PK ou non ; la valeur par défaut est « oui ».

fichiers_tfm
Que ce soit pour créer des fichiers TFM ou non ; la valeur par défaut est « oui ».

ofm_file
Que ce soit pour créer un fichier OPL ou non ; la valeur par défaut est « non ». Le fichier batch sera alors
utilisé ovp2ovf de la distribution Omega pour le convertir en un fichier OFM et un fichier OVF.
Le fichier OPL mappe simplement toutes les sous-fontes à une seule police Omega.

longue_extension
Si « oui », les fichiers PK incluront la résolution dans l'extension (par exemple
gsso1201.300pk). Cela affecte uniquement le fichier batch (la valeur par défaut est « oui »).

commande_rm
La commande shell pour supprimer des fichiers ; par défaut : « rm ».

cp_commande
La commande shell pour copier des fichiers ; par défaut : 'cp'.

extension_travail
L'extension du fichier batch qui appelle gftopk ainsi que ptotf pour convertir le GF et
les fichiers PL en fichiers PK et TFM respectivement ; la valeur par défaut est aucun.

DOSSIER RECHERCHE

hbf2gf utilise soit le kpathsea, emtexdirou MiKTeX bibliothèque pour rechercher des fichiers (emtexdir
fonctionnera uniquement sur les systèmes d'exploitation qui ont un arrière-plan MS-DOSish, c'est-à-dire MS-DOS,
OS/2, Windows ; MiKTeX est pour les systèmes Win32).

kpathsea
La version actuelle de kpathsea s'affiche à l'écran si vous appelez hbf2gf --version.

Voici un tableau du type de fichier et le correspondant kpathsea variables.

.hbf MISCFONTES
.cfg HBF2GFINPUTS

Veuillez consulter les fichiers d'informations de kpathsea pour plus de détails sur ces variables. La décision
le schéma de nommage à utiliser pour les variables sera fait lors de la compilation.

Vous devez définir la variable TEXMFCNF dans le répertoire où votre configuration texmf.cnf
le fichier réside.

Voici la commande appropriée pour savoir à quelle valeur un kpathsea variable est définie (nous utilisons
MISCFONTS comme exemple). Ceci est particulièrement utile si une variable n'est pas définie dans texmf.cnf
ou dans l'environnement, pointant ainsi vers la valeur par défaut qui est codée en dur dans le
kpathsea bibliothèque.

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

Nous sélectionnons également le nom du programme car il est possible de spécifier des variables qui sont
recherché uniquement pour un certain programme - dans notre exemple, ce serait MICFONTS.hbf2gf.

Une méthode similaire mais pas identique consiste à dire

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

[Une liste complète des types de format peut être obtenue en disant 'kpsewhich --help' sur la commande
invite de ligne.] C'est exactement comment hbf2gf recherche de fichiers ; l'inconvénient est que tout
les variables sont étendues, ce qui peut entraîner de très longues chaînes.

emtexdir
Voici la liste des suffixes et leurs variables d'environnement associées à définir dans autoexec.bat
(resp. dans config.sys pour OS/2):

.hbf FONTES HBF
.cfg HBFCFG

Si l'une des variables n'est pas définie, un message d'avertissement est émis. Le répertoire courant
sera toujours recherché. Comme d'habitude, un point d'exclamation ajouté à un chemin de répertoire
provoque la recherche dans les sous-répertoires d'un niveau de profondeur, deux points d'exclamation provoquent tous
sous-répertoires à rechercher. Exemple:

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

Les constructions comme 'c:\fonts!!\hbf' ne sont pas possibles.

MikTeXName
Veuillez consulter les fichiers de documentation de MiKTeX pour plus de détails.

LIMITATIONS

La taille de sortie x et y ne doit pas dépasser MAX_CHAR_SIZE, qui est défini au moment de la compilation ;
sa valeur par défaut est 1023 (pixel).

Utilisez hbf2gf en ligne en utilisant les services onworks.net