afmtodit(1)

afmtodit

afmtodit anpassar Adobe Font Metrics-filer för groffs PostScript- och PDF-utdata.

Namn

afmtodit — anpassa Adobe Font Metrics-filer för groff PostScript- och PDF-utdata

Synopsis

afmtodit [-ckmnsx] [-a slant] [-d device-description-file]
         [-e encoding-file] [-f internal-name]
         [-i italic-correction-factor] [-o output-file]
         [-w space-width]
         afm-file map-file font-description-file

afmtodit --help
afmtodit -v
afmtodit --version

Beskrivning

afmtodit anpassar en Adobe Font Metric-fil, afm-file, för användning med utdataenheterna ps och pdf i troff(1).

Filen map-file kopplar ett vanligt eller särskilt groff-teckennamn till ett PostScript-glyfnamn.

Utdata skrivs i formatet groff_font(5) till font-description-file, en fil vars namn normalt motsvarar det tänkta groff-typsnittsnamnet.

Map-filen

map-file ska innehålla rader av formen:

ps-glyph groff-char

där:

• ps-glyph är PostScript-glyfens namn
• groff-char är ett vanligt groff-tecken (om det är ett tecken långt) eller ett specialtecken (om det är längre)

Regler:

• samma ps-glyph får förekomma flera gånger
• varje groff-char får förekomma högst en gång
• tomma rader och rader som börjar med # ignoreras

Om filen inte finns i aktuell katalog söks den i underkatalogen devps/generate under standardkatalogen för typsnitt.

Glyfer som inte finns i map-filen

Om en PostScript-glyf inte nämns i map-file, och inget motsvarande groff-namn kan härledas med hjälp av Adobe Glyph List (AGL, inbyggd i afmtodit), läggs glyfen in som en namnlös glyf i groff-fontbeskrivningen.

Den kan då endast nås via escape-sekvensen:

\N

Särskilt gäller detta glyfvarianter med namnformen:

foo.bar

Alla glyfnamn som innehåller en eller flera punkter mappas till namnlösa entiteter.

Kodning

Om inte flaggan -e används, används den kodning som definieras i AFM-filen, det vill säga poster med icke-negativa koder.

Glyfer som inte är kodade i AFM-filen (markerade med -1) blir ändå tillgängliga i groff. De får glyfindex större än 255, eller större än det högsta kodvärdet som används i AFM-filen om detta råkar vara större än 255.

Dessa okodade glyfer har ingen garanterad ordning och bör därför normalt endast användas via specialteckennamn.

Inbäddning av fonter

Om själva typsnittsfilen finns tillgänglig, inte bara dess måttdata, kan den listas i filerna:

/usr/local/share/groff/1.23.0/font/devps/download
/usr/local/share/groff/1.23.0/font/devpdf/download

Det gör att den kan bäddas in i utdata producerad av grops(1) respektive gropdf(1).

Kursiv korrigering

Om flaggan -i används genererar afmtodit automatiskt:

• italic correction
• left italic correction
• subscript correction

för varje glyf.

Dessa kan också anges per glyf genom att lägga till rader i afm-file av formen:

italicCorrection ps-glyph n
leftItalicCorrection ps-glyph n
subscriptCorrection ps-glyph n

där:

• ps-glyph är PostScript-glyfens namn
• n är värdet i tusendelar av en em

Sådana parametrar behövs normalt bara för kursiva eller snedställda typsnitt.

Specialfont

Flaggan -s ska användas om typsnittet är special, vilket betyder att groff ska söka i det när en glyf inte hittas i aktuell font.

I så fall bör font-description-file listas som argument till direktivet fonts i enhetens DESC-fil.

Om typsnittet inte är special behövs detta inte, eftersom troff(1) automatiskt monterar det första gången det används.

Alternativ

Allmänna alternativ

--help

Visa hjälpinformation och avsluta.

-v, --version

Visa versionsinformation och avsluta.

Formatering och metadata

-a slant

Använd slant som lutningsparameter i fontbeskrivningsfilen. Den används av groff vid placering av accenter. Som standard används det negativa värdet av ItalicAngle från AFM-filen.

-c

Inkludera kommentarer i fontbeskrivningsfilen som identifierar PostScript-fonten.

-f internal-name

Sätt det interna namnet på groff-fonten till internal-name.

-o output-file

Skriv utdata till output-file i stället för till font-description-file.

-w space-width

Använd space-width som bredd för ordmellanrum.

Filer och kodning

-d device-description-file

Använd device-description-file i stället för standardfilen DESC. Om filen inte hittas i aktuell katalog söks den i devps under standardkatalogen för typsnitt.

-e encoding-file

Reenkoda PostScript-fonten enligt beskrivningen i encoding-file. Formatet beskrivs i grops(1). Om filen inte hittas i aktuell katalog söks den i devps-underkatalogen.

Korrigeringar och ligaturer

-i italic-correction-factor

Generera italic correction för varje glyf så att dess bredd plus kursiv korrigering blir lika med italic-correction-factor tusendelar av en em plus den del av glyfens bounding box som ligger till höger om ursprunget.

Generera också en subscript correction lika med tangenten för fontens lutning multiplicerad med fyra femtedelar av x-höjden.

Generera även en left italic correction för varje glyf.

Detta behövs normalt bara för kursiva eller snedställda fonter. De fonter som distribueras med groff skapades normalt med:

-i50

-k

Utelämna kerningdata från groff-fonten. Används endast för monospaced-fonter.

-m

Förhindra negativa värden för left italic correction.

-n

Skriv inte ut kommandot ligatures för denna font. Används med monospaced-fonter.

Specialbeteende

-s

Lägg till direktivet special i fontbeskrivningsfilen.

-x

Använd inte den inbyggda Adobe Glyph List.

Filer

/usr/local/share/groff/1.23.0/font/devps/DESC

Beskriver utdataenheten ps.

/usr/local/share/groff/1.23.0/font/devps/F

Beskriver fonten med namnet F på enheten ps.

/usr/local/share/groff/1.23.0/font/devps/download

Listar fonter som kan bäddas in i PostScript-dokumentet eller laddas ned till enheten.

/usr/local/share/groff/1.23.0/font/devps/generate/dingbats.map

/usr/local/share/groff/1.23.0/font/devps/generate/dingbats-reversed.map

/usr/local/share/groff/1.23.0/font/devps/generate/slanted-symbol.map

/usr/local/share/groff/1.23.0/font/devps/generate/symbol.map

/usr/local/share/groff/1.23.0/font/devps/generate/text.map

Mappar namn i Adobe Glyph List till särskilda groff-teckennamn för bland annat Zapf Dingbats, symbolfonter och textfonter.

Diagnostik

Följande meddelande kan förekomma:

AGL name 'x' already mapped to groff name 'y'; ignoring AGL name 'uniXXXX'

Detta kan normalt ignoreras om det är på formen ovan, där uniXXXX innehåller fyra hexadecimala siffror.

Bakgrunden är att AGL ibland har flera namn som skulle kunna motsvara samma groff-specialtecken. afmtodit kan hantera en-till-en eller många-till-en-mappningar, men inte en-till-många. Därför ignoreras överskottsmappningar.

Om du inte är nöjd med vilken mappning som ignoreras kan du skapa en alternativ map-file och köra afmtodit igen.

Se även

• groff(1)
• gropdf(1)
• grops(1)
• groff_font(5)

Huvudmanualen för groff är:

Groff: The GNU Implementation of troff

Särskilt avsnittet Using Symbols kan vara relevant.

Colophon

Denna manualsida tillhör projektet groff (GNU troff). Informationen hämtades från källpaketet groff-1.23.0.tar.gz, hämtat 2026-01-16.

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/afmtodit.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorservice som har sponsrat Linux.se med webbhotell.