mpictures(5) mpictures(5)
NAME
mpictures - Makros für die Eingliederung von Abbildungen
SYNTAX
troff -mpictures [options] file ...
BESCHREIBUNG
Makropaket, das für die Eingliederung von PostScript-Abbildungen in
troff-Dokumente verwendet wird. Das Paket ist mit vielen bestehenden
troff-Makropaketen kompatibel und enthält die folgenden drei Makros:
.BP file height width position offset flags label
Stellt die Abbildung file in den Bereich, der durch die Angaben
height, width, position und offset definiert wurde. Diese Angaben
geben den Rahmen der Abbildung sowie dessen Position an. Folgende
Makroargumente werden verwendet:
file Pfadname einer Datei mit einer PostScript-Abbildung. Durch
das Anhängen von (n) an die Datei file wird die Seitennum-
mer n einer Datei mit einer mehrseitigen Abbildung ausge-
wählt. Standardmäßig wird die erste Seite der Datei ausge-
wählt.
height
Vertikales Ausmaß des Rahmens. Der Standardwert ist 3,0
Zoll.
width Horizontales Ausmaß des Rahmens. Der Standardwert ist die
aktuelle Länge einer Textzeile.
position
Eine der Angaben l, c oder r, mit der die linke oder rechte
Seite oder die Mitte des Rahmens an der entsprechenden
Position der aktuellen Textzeile ausgerichtet wird. Der
Standardwert ist l.
offset
Schiebt den Rahmen von der angegebenen Position position
aus nach rechts (positiver Wert) oder links (negativer)
Wert. Der Standardwert ist 0 Zoll.
flags Eine Zeichenkette, die aus einer oder mehr der folgenden
Angaben besteht:
a[d] Die Abbildung im Uhrzeigersinn um d Grad drehen. Wird
d nicht angegeben, werden dem aktuellen Winkel 90 Grad
hinzugefügt. Dieser beginnt bei 0.
o Die Abbildung mit einem Kasten umrahmen.
s Beide Ausrichtungen der Abbildung frei skalieren.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
mpictures(5) mpictures(5)
w Den Bereich, in dem die Abbildung positioniert werden
soll, weiß darstellen.
l Abbildung links vom Rahmen anfügen.
r Abbildung rechts vom Rahmen anfügen.
t Abbildung oben vom Rahmen anfügen.
b Abbildung unten vom Rahmen anfügen.
label Die Bildunterschrift label 1,5 vertikale Einheiten unter-
halb des Rahmens plazieren.
Ist um den Rahmen herum noch Platz vorhanden, füllt .BP diesen
mit Text. Alles, was an den beiden Seiten des Rahmens angezeigt
werden soll, wird abgeworfen und erscheint erst wieder, nachdem
der angehäufte Text über die von .BP gesetzte Signalfalle läuft
oder der Abwurf durch das Makro .EP (siehe unten) explizit
geschlossen wird.
Leere Argumente, dargestellt durch "", werden durch die oben
genannten Standardwerte ersetzt.
.PI file height,width,yoffset,xoffset flags
Ein von .BP. verwendetes Makro einer niedrigeren Ebene. Dieses
Makro kann nützlich sein, wenn Sie Schritte durchführen wollen,
die .BP nicht zuläßt oder nicht ordnungsgemäß durchführt. Zusätz-
lich zu den oben genannten Argumenten sind die folgenden zwei
Argumente zulässig:
xoffset
Den Rahmen nach rechts (positiver Wert) oder links (negati-
ver Wert) vom linken Rand verschieben. Der Standardwert ist
0 Zoll.
yoffset
Den Rahmen nach unten (positiver Wert) oder oben (negati-
ver) Wert von der aktuellen Grundlinie verschieben. Der
Standardwert ist 0 Zoll.
Das zweite Argument ist eine Liste mit vier, durch Kommas
getrennten Zahlen. Es wird empfohlen, alle vier Zahlen anzugeben,
auch wenn Standardwerte verfügbar sind.
.EP Abbildung, die von .BP gestartet wurde, beenden. Ein expliziter
Aufruf von .EP ist nicht sehr häufig erforderlich. .EP wird in
der Regel durch Überspringen der Signalfalle ausgerufen, die von
.BP am Ende jedes Rahmens gesetzt wird.
Ein Großteil der durchzuführenden Aktionen hängt von den Kommentaren
zur Dateistrukturierung ab, wie sie in der Regel in PostScript-Dateien
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
mpictures(5) mpictures(5)
vorhanden sind. Fehlen die Kommentare, die für die Isolierung einer
bestimmten Seite erforderlich sind, wird die gesamte Datei file einge-
gliedert. Fehlt der Kommentar %%BoundingBox, wird angenommen, daß die
Abbildung eine Seite mit der Größe 8,5x11 Zoll ausfüllt. Eine Abbil-
dungsdatei, die während des Ausführung des troff-Postprozessors nicht
gelesen werden kann, wird durch einen weißen Bereich ersetzt. Die
Angaben für .BP oder .PI sind keine Garantie dafür, daß die Abbildung
nicht außerhalb der Seite plaziert wurde. Alle Angaben sollten in Zoll
gemacht werden.
HINWEISE
Eine Abbildung und der dazugehörende Text können verschwinden, wenn
die von .BP gesetzte Signalfalle für den Abwurf nicht erreicht wird.
Durch das Hinzufügen eines Aufrufs von .EP am Ende des Blattes sollten
die Elemente wiederhergestellt werden können, die scheinbar verschwun-
den sind.
Die Makros in anderen Paketen modifizieren gelegentlich die Änderungen
der Zeilenlänge und der Einrückung, die beim Plazieren von Text um die
Abbildung herum vorgenommen wurden.
Füllt eine Abbildung den ihr zugewiesenen Raum nicht korrekt aus, so
ist dies häufig auf einen fehlenden oder fehlerhaften Kommentar
%%BoundingBox zurückzuführen.
DATEIEN
/usr/lib/tmac/tmac.pictures
SIEHE AUCH
dpost(1M), picpack(1M), troff(1M).
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98