Version dev

# `LoadFontfile`

Der Befehl LoadFontfile weist einer physikalischen Schriftdatei einen internen Namen zu. Wird ein Zeichen in der Schriftart nicht gefunden, erzeugt das Programm eine Fehlermeldung, die mit `Options` ausgeschaltet werden kann. Alternativ dazu können auch Ersatzschriftarten (mit `Fallback`) angegeben werden, die nach den fehlenden Zeichen abgesucht werden.

Type-1-Schriften (.pfb) sind veraltet: sie werden immer mit dem alten fontforge-Fonthandler geladen, der mit Version 6.0 entfernt werden soll. Bitte Type-1-Schriften nach OpenType konvertieren.

## Kindelemente

`Axis`, `Fallback`

## Elternelemente

`AtPageCreation`, `AtPageShipout`, `Case`, `Contents`, `ForAll`, `Include`, `Layout`, `Loop`, `Otherwise`, `Record`, `SavePages`, `Section`, `Until`, `While`

## Attribute

`features` (Text, optional, seit Version 3.9.29)
  Eine kommaseparierte Liste von OpenType features, z.B. `+liga,-kern`
`filename` (Text)
  Der Dateiname mit Endung, ohne Pfad.
`marginprotrusion` (0 bis 100, optional)
  Angabe in Prozent, um wie viel die Zeichen -, . und , über den Rand herausragen. Voreinstellung ist 0. Der Wert wird mit 0,001em der aktuellen Schrift multipliziert, eine Einstellung von 200 erlaubt also, dass diese Zeichen 0,2em über den Rand hinausragen.
`mode` (optional, seit Version 3.9.29, veraltet)
  Setzt den Fonthandler. Voreinstellung ist `harfbuzz`. Das Attribut ist veraltet: es wird nur benötigt, um den alten fontforge-Fonthandler auszuwählen, der mit Version 6.0 entfernt werden soll.
  - `fontforge`: Der alte Fonthandler. Funktioniert mit westlichen Schreibsystemen, nicht aber mit rechts-nach-links oder anderen komplizierten Schreibsystemen. Veraltet: dieser Fonthandler soll mit Version 6.0 entfernt werden. Type-1-Schriften (.pfb) werden unabhängig von dieser Einstellung immer mit diesem Fonthandler geladen.
  - `harfbuzz`: Der Fonthandler, der Arabisch und andere komplexen Schreibsysteme verarbeiten kann (Voreinstellung).
`name` (Text)
  Der interne Name, unter dem die Schriftart im Element `DefineFontfamily` angesprochen wird.
`oldstylefigures` (optional)
  Schalter, ob auf Mediävalziffern umgeschaltet wird (OpenType Feature »onum«).
  - `yes`: Mediävalziffern benutzen.
  - `no`: Normale Ziffern benutzen.
`shrink` (Zahl, optional, seit Version 4.19.17)
  Setze den maximalen Stauchfaktor der Schriftart. Voreinstellung ist ausgeschaltet. Wert geteilt durch 10 = Prozent. Beispiel: 20 bedeutet eine maximale Stauchung von 2%.
`smallcaps` (optional)
  Schalter, ob die Schriftart als Kapitälchen dargestellt werden soll.
  - `yes`: Kapitälchen benutzen.
  - `no`: Nicht auf Kapitälchen umschalten (Voreinstellung).
`space` (0 bis 100, optional)
  Natürliche Breite des Leerraums zwischen zwei Wörtern. Dieser darf um 30% gestreckt und um 10% gestaucht werden. Die Voreinstellung ist 25. Der Wert ist die Prozentangabe der Schriftgröße.
`step` (Zahl, optional, seit Version 4.19.17)
  Setze die Schritte für stauchen und dehnen. Wert geteilt durch 10 = Prozent. Beispiel: 20 erhöht/verringert die Schriftgröße bei Bedarf um 2%. Voreinstellung: 10
`stretch` (Zahl, optional, seit Version 4.19.17)
  Setze den maximalen Dehnungsfaktor der Schriftart. Voreinstellung ist ausgeschaltet. Wert geteilt durch 10 = Prozent. Beispiel: 20 bedeutet eine maximale Dehnung von 2%.
`weight` (Zahl, optional, seit Version 5.5.12)
  Setzt die Gewichtsachse (wght) einer variablen Schriftart. Dies ist eine Abkürzung für das Kind-Element `Axis` mit `name="wght"`. Gängige Werte sind 100 (Thin), 400 (Regular), 700 (Bold), 900 (Black).
`width` (Zahl, optional, seit Version 5.5.12)
  Setzt die Breitenachse (wdth) einer variablen Schriftart. Dies ist eine Abkürzung für das Kind-Element `Axis` mit `name="wdth"`. Ein Wert von 100 ist die normale Breite, niedrigere Werte sind schmaler, höhere Werte sind breiter.

## Beispiel

    <LoadFontfile name="Helvetica" filename="texgyreheros-regular.otf" />
    <LoadFontfile name="Helvetica Fett" filename="texgyreheros-bold.otf" />
    <LoadFontfile name="Helvetica Kursiv" filename="texgyreheros-italic.otf" />
    <LoadFontfile name="Helvetica Fett Kursiv" filename="texgyreheros-bolditalic.otf" />

    <!-- Variable Font mit Gewichts-Abkürzung -->
    <LoadFontfile name="MeineSchrift Regular" filename="MeineSchrift-Variable.ttf" weight="400" />
    <LoadFontfile name="MeineSchrift Fett" filename="MeineSchrift-Variable.ttf" weight="700" />

    <!-- Variable Font mit generischen Achsen -->
    <LoadFontfile name="MeineSchrift Spezial" filename="MeineSchrift-Variable.ttf">
      <Axis name="wght" value="600" />
      <Axis name="wdth" value="75" />
    </LoadFontfile>

## Hinweis

Die Schriftdateien werden aus dem lokalen Suchpfad geladen. Unter Windows wird der Pfad `%WINDIR%\Fonts` (normalerweise `C:\Windows\Fonts`) und auf Mac OS X die Pfade `/Library/Fonts` und `/System/Library/Fonts` können als Ergänzung des lokalen Suchpfads dienen. Das kann mit der Option `fontpath` in der Konfigurationsdatei gesetzt werden.

#### Inhalt