hbf2gf - Online in de cloud

PROGRAMMA:

NAAM

hbf2gf - converteer een CJK-bitmaplettertype naar sublettertypen die bruikbaar zijn voor TeX en Omega.

KORTE INHOUD

hbf2gf [-q] configuratiebestand[.cfg]
hbf2gf [-q] [-p] [-g] [-n] sublettertypenaam x-resolutie [y-schaal | y-resolutie]
hbf2gf -t [-q] sublettertypenaam
hbf2gf --versie | --help

PRODUCTBESCHRIJVING

CJK-bitmaplettertypen kunnen niet rechtstreeks met TeX worden gebruikt vanwege het aantal tekens daarin
lettertypen overschrijdt 256, de limiet van een TeX-lettertype. Het is dus noodzakelijk om deze lettertypen te splitsen
in subfonts, en dit is precies wat hbf2gf doet.

Zoals de naam al zegt, hbf2gf gebruikt CJK-lettertypen in een bepaald formaat dat wordt genoemd Hanzi Bitmap
doopvont (HBF) formaat. Het bestaat eenvoudigweg uit de CJK-bitmapbestanden en een tekstbestand in een
formaat dat sterk lijkt op het BDF-formaat van het X Window-systeem dat de bitmap beschrijft
fontbestanden: de codering, de grootte, enz. De geproduceerde GF-bestanden kunnen vervolgens worden geconverteerd
gftopk in standaard PK-bestanden.

hbf2gf kan in drie modi worden opgeroepen:

hbf2gf [-q] configuratiebestand[.cfg]

Deze aanroep creëert normaal gesproken een set GF-bestanden, één PL-bestand en een batchbestand dat
moet daarna worden uitgevoerd hbf2gf is afgelopen. Dit script zal dan aanroepen gftopk naar
converteer alle GF-bestanden naar PK-bestanden en het zal bellen pltotf om het PL-bestand te converteren
naar een TFM-bestand. Ten slotte kopieert het het TFM-bestand zodat elk PK-bestand zijn eigen TFM heeft
bestand (die allemaal identiek zijn).

If ofm_bestand is ingesteld op 'ja' in het configuratiebestand, zullen OFM- en OVF-bestanden dat zijn
ook gecreëerd.

-q merken hbf2gf stil.

hbf2gf [-q] [-p] [-g] [-n] sublettertypenaam x-resolutie [y-schaal | y-resolutie]

Deze modus is bedoeld voor gebruik met mktexpk en zijn derivaten. Slechts één GF-bestand
samen met een PL-bestand voor het gegeven sublettertype wordt het horizontale lettertype berekend
resolutie en een verticale schaalfactor (als de waarde kleiner is dan 10) resp. de
verticale resolutie (anders) vanaf de opdrachtregel, waarbij u de nmb_lettertypen
parameter van het configuratiebestand. De laatste twee tekens (die worden geïnterpreteerd
als het sublettertypenummer) worden verwijderd om de naam voor het configuratiebestand (welke
moet eindigen op '.cfg'). Er wordt geen taakbestand aangemaakt. Indien optie -p is ingesteld, geen PL-bestand
is gecreëerd. Als -g is ingesteld, wordt er geen GF-bestand gemaakt. De extensie kan worden gecontroleerd
Met -n; Indien ingesteld, is de extensie '.gf', anders '.resolutie> gf'. -q merken
hbf2gf stil.

hbf2gf -t [-q] sublettertypenaam

Deze modus is bedoeld voor gebruik met scripts zoals mktexpk; er wordt getest of de
opgegeven sublettertypenaam leidt naar een hbf2gf configuratiebestand. Het retourneert 0 aan
succes en drukt de naam van dat configuratiebestand af (op voorwaarde dat de -q schakelaar
is niet ingesteld). Deze test is niet grondig; het verwijdert alleen de laatste twee tekens
en controleert of er een configuratiebestand met die naam bestaat.

Zie de volgende sectie voor meer details over configuratiebestanden.

Het specificeren van de optie --versie retourneert de huidige versie van hbf2gf en het gebruikte bestand
zoekbibliotheek (bijv kpadzee). Gebruiksinformatie wordt weergegeven met de --help parameter.

CONFIGURATIE FILE

Hier een voorbeeldconfiguratiebestand (gsfs14.cfg) voor een 56×56 Chinees lettertype in GB-codering;
merk op dat alle informatie over het lettertype in het bestand jfs56.hbf staat. Zie de FILE ZOEKEN
sectie hoe HBF-lettertypen en hbf2gf configuratiebestanden worden gevonden. Zie de BESCHIKBAARHEID
sectie waar u CJK-lettertypen samen met de HBF-bestanden kunt verkrijgen:

hbf_header jfs56.hbf
mag_x 1
drempel 128
commentaar jianti fansongti 56x56 pixel lettertype

ontwerp_grootte 14.4

y_offset -13

nmb_bestanden -1

uitvoer_naam gsfs14

controlesom 123456789

dpi_x 300

pk_files nr
tfm_files ja

codering coderingsschema GuoBiao gecodeerde TeX-tekst

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

Een configuratiebestand is een tekstbestand dat bestaat uit trefwoorden en de bijbehorende argumenten. A
trefwoord moet een regel beginnen, anders wordt de hele regel genegeerd. Als het woord begint
een regel is geen trefwoord, de regel wordt ook genegeerd. Lege regels worden ook overgeslagen.
Het zoeken naar trefwoorden is hoofdlettergevoelig; de argumenten zullen daarentegen worden overgenomen
precies zoals gegeven (behalve 'ja' en 'nee' die met hoofdletters of kleine letters kunnen worden geschreven
brieven). Elk trefwoord heeft één argument dat moet worden gescheiden door spaties (spaties of
tabs) van het trefwoord en moeten op dezelfde regel staan. Elke regel mag niet langer zijn dan
256-tekens.

U kunt omgevingsvariabelen gebruiken in het configuratiebestand. Het ontsnappingskarakter
het starten van een omgevingsvariabele in het configuratiebestand is altijd '$', zelfs voor
besturingssystemen zoals DOS, dat andere conventies heeft. hbf2gf herkent alleen
namen van omgevingsvariabelen die beginnen met een letter of een onderstrepingsteken, gevolgd door
alfanumerieke tekens of onderstrepingstekens. U kunt de variabele omsluiten met accolades
geef aan waar de naam van de variabele eindigt, bijvoorbeeld ${FOO}. Om een ​​dollarteken te krijgen, moet je dat doen
schrijf '$$'. De uitbreiding van omgevingsvariabelen in hbf2gf zelf (zonder de hulp van
de zoekroutines kpathsea, emtexdir of MiKTeX) zijn zeer beperkt; deze functie heeft
overgenomen uit eerdere versies. Het kan geen variabelen uitbreiden die zijn ingesteld in texmf.cnf; Het
kan ook niet meer dan één map als waarde van de variabele verwerken. Niet . it behalve
For de 'pk_map' en 'tfm_map' parameters!

Dit is de lijst met alle benodigde trefwoorden:

hbf_header
De HBF-headerbestandsnaam van de invoerlettertypen. hbf2gf maakt gebruik van de opgegeven zoekopdracht
mechanisme (kpathsea, emtexdir of MiKTeX) om dit bestand te lokaliseren.

uitgang_naam
De naamstam van de uitvoerbestanden. Een doorlopend decimaal getal van twee cijfers dat begint
met '01' wordt toegevoegd. Voor Unicode-lettertypen zie het trefwoord unicode onderstaand. Dit
waarde is in vrijwel alle gevallen identiek aan de naam van het configuratiebestand.

En nu alle optionele trefwoorden:

x_verschuiving
Vergroot de tekenbreedte. Wordt aan beide zijden aangebracht; standaard voor niet-
geroteerde glyphs is de waarde die wordt gegeven in de HBF-header (HBF_BITMAP_BOUNDING_BOX)
geschaald naar ontwerp_maat (in pixels).

y_offset
Verschuift alle tekens omhoog of omlaag; standaard voor niet-geroteerde glyphs is de opgegeven waarde
in de HBF-header (HBF_BITMAP_BOUNDING_BOX) geschaald naar ontwerp_maat (in pixels).

ontwerp_maat
De ontwerpgrootte (in punten) van het lettertype. x_verschuiving en y_offset zie deze maat.
Standaard is 10.0.

schuin De helling van het lettertype (aangegeven als Delta_x / Delta_y). Alleen waarden in het bereik
0 schuin ≤ 1 zijn toegestaan. De standaardwaarde is 0.0.

omwenteling
Indien ingesteld op 'ja', worden alle glyphs 90 graden tegen de klok in gedraaid. De
standaard offsets zoals opgegeven in de HBF-header worden genegeerd (en ingesteld op 0). Standaard
is niet'.

mag_x
mag_y Schaalwaarden van de tekens om de ontwerpgrootte te bereiken. Als er maar één vergroting is
gegeven is, wordt aangenomen dat de x- en y-waarden gelijk zijn. Standaard is mag_x = mag_y = 1.0.

drempel
Een waarde tussen 1 en 254 die een drempel definieert voor het converteren van de interne grijskaart
in de uitvoerbitmap; lagere waarden snijden meer pixels. De standaardwaarde is 128.

commentaar
Een opmerking die het lettertype beschrijft; standaard is geen.

nmb_lettertypen
Het aantal sublettertypen dat moet worden gemaakt. De standaardwaarde is -1 voor het maken van alle lettertypen.

unicode
Indien 'ja', wordt vanaf het begin een tweecijferig hexadecimaal getal als volgnummer gebruikt
met de waarde van de eerste byte van het eerste codebereik. Standaard is 'nee'.

min_char
De minimumwaarde van de codering. U moet deze waarde instellen om correct te worden
subbestandsverschuivingen als deze niet identiek is aan de laagste tekencode in de HBF
bestand.

dpi_x
dpi_j De horizontale en verticale resolutie (in dpi) van de printer. Als er maar één is
resolutie wordt gegeven, wordt aangenomen dat de x- en y-waarden gelijk zijn. Standaard is 300.

checksum
Een controlesom om de GF-bestanden te identificeren met de juiste TFM-bestanden. De standaard
De waarde van dit 32-bits geheel getal zonder teken is 0.

codering Een opmerking die het coderingsschema beschrijft; standaard is geen.

pk_map
De doelmap van de PK-bestanden; standaard: geen. Aandacht! De partij
bestand controleert niet of deze map bestaat.

tfm_map
De doelmap van de TFM-bestanden; standaard: geen. Aandacht! De partij
bestand controleert niet of deze map bestaat.

pk_bestanden
Of PK-bestanden moeten worden gemaakt of niet; standaard is 'ja'.

tfm_bestanden
Of u TFM-bestanden wilt maken of niet; standaard is 'ja'.

ofm_bestand
Of u nu een OPL-bestand wilt maken of niet; standaard is 'nee'. Het batchbestand wordt dan
. ovp2ovf van de Omega-distributie om deze te converteren naar een OFM- en een OVF-bestand.
Het OPL-bestand wijst eenvoudigweg alle sublettertypen terug naar één enkel Omega-lettertype.

lange_extensie
Indien 'ja', zullen PK-bestanden de resolutie in de extensie opnemen (bijv
gsso1201.300pk). Dit heeft alleen invloed op het batchbestand (standaard is 'ja').

rm_opdracht
Het shell-commando om bestanden te verwijderen; standaard: 'rm'.

cp_opdracht
Het shell-commando om bestanden te kopiëren; standaard: 'cp'.

taak_extensie
De extensie van het batchbestand dat aanroept gftopk en pltotf om de GF om te zetten en
de PL-bestanden naar respectievelijk PK- en TFM-bestanden; standaard is geen.

FILE ZOEKEN

hbf2gf gebruikt ofwel de kpadzee, emtexdirof MiKTeX bibliotheek voor het zoeken naar bestanden (emtexdir
werkt alleen op besturingssystemen die een MS-DOS-achtige achtergrond hebben, dat wil zeggen MS-DOS,
OS/2, Vensters; MiKTeX is voor Win32-systemen).

kpadzee
Als u belt, wordt de daadwerkelijke versie van kpathsea op het scherm weergegeven hbf2gf --versie.

Hier is een tabel met het bestandstype en de bijbehorende kpadzee variabelen.

.hbf MISCFONTS
.cfg HBF2GFINPUTS

Raadpleeg de infobestanden van kpadzee voor meer informatie over deze variabelen. De beslissing
welk naamgevingsschema voor variabelen moet worden gebruikt, wordt tijdens de compilatie uitgevoerd.

U moet de TEXMFCNF-variabele instellen op de map waar uw texmf.cnf-configuratie
bestand verblijft.

Hier is het juiste commando om erachter te komen tot welke waarde a kpadzee variabele is ingesteld (we gebruiken
MISCFONTS als voorbeeld). Dit is vooral handig als er geen variabele is ingesteld in texmf.cnf
of in de omgeving, en verwijst dus naar de standaardwaarde die hardgecodeerd is in het
kpadzee bibliotheek.

kpse Which -progname=hbf2gf -expand-var='$MISCFONTS'

We selecteren ook de programmanaam omdat het mogelijk is om variabelen te specificeren die zijn
alleen naar een bepaald programma gezocht – in ons voorbeeld zou dit MISCFONTS.hbf2gf zijn.

Een vergelijkbare maar niet identieke methode is te zeggen

kpse Which -progname=hbf2gf -show-path='diverse lettertypen'

[Een volledige lijst met formattypes kan worden verkregen door 'kpse Which --help' te zeggen bij het commando
regelprompt.] Dit is precies hoe hbf2gf zoekt naar bestanden; het nadeel is dat alles
variabelen worden uitgebreid, wat zeer lange tekenreeksen kan veroorzaken.

emtexdir
Hier vindt u de lijst met achtervoegsels en de bijbehorende omgevingsvariabelen die moeten worden ingesteld in autoexec.bat
(resp. in config.sys voor OS/2):

.hbf HBFONTS
.cfg HBFCFG

Als een van de variabelen niet is ingesteld, wordt er een waarschuwingsbericht weergegeven. De huidige map
zal altijd gezocht worden. Zoals gewoonlijk wordt één uitroepteken toegevoegd aan een mappad
zorgt ervoor dat submappen één niveau diep worden doorzocht, twee uitroeptekens zorgen ervoor dat alles wordt doorzocht
submappen die moeten worden doorzocht. Voorbeeld:

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

Constructies als 'c:\fonts!!\hbf' zijn niet mogelijk.

MikTeX
Raadpleeg de documentatiebestanden van MiKTeX voor meer details.

Beperkingen

De x- en y-uitvoergrootte mag niet groter zijn dan MAX_CHAR_SIZE, die wordt gedefinieerd tijdens het compileren;
de standaardwaarde is 1023 (pixels).

Gebruik hbf2gf online met behulp van onworks.net-services