Beeinflussen der Grafikgröße

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

Eine Quelle häufiger Frustrationen ist das korrekte Anwenden der Attributwerte für Höhe und Breite von Grafiken sowie dessen Zusammenspiel mit den anderen Attributen.

Das Element imagedata besitzt verschiedene Attribute die das Zusammenspiel verschiedener Rechtecke bestimmen:

Darstellungsbereich (engl. viewport area)

Dieses Rechteck definiert den verfügbaren Bereich, indem die Grafik platziert wird. Wird ein Darstellungsbereich von 5 cm × 6 cm definiert, dann wird auch diese Größe für die Grafik reserviert, unabhängig von anderen Größen.

Inhaltsbereich (engl. content area)

Dieses Rechteck definiert die aktuelle Dimension der dargestellten Grafik, unabhängig von der eigentlichen Grafikgröße. DocBook besitzt drei gegenseitig ausschließende Methoden, um den Inhaltsbereich anzugeben: er kann direkt spezifiziert werden, durch einen Skalierungsfaktor oder der Inhaltsbereich soll die selbe Größe wie der Darstellungsbereich einnehmen.

Implizite Grafikgröße (engl. intrinsic size)

Die wirkliche, aktuelle Dimension der Grafik

Ist ein Inhaltsbereich größer als der Darstellungsbereich, ist das Ergebnis abhängig vom Publishing-System. DocBook definiert keinen Mechanismus für diesen Fall. Das bedeutet, dass ein Publishing-System die Grafik beschneiden kann, es erlauben kann die Grafik überlaufen zu lassen eine Fehlermeldung auszugeben oder eine Kombination aus diesen Optionen zu erzeugen.

Tabelle: Attribute für Grafiken

Bereich Attribute
Darstellungsbereichdepth und width
Inhaltsbereich contentdepth und contentwidth
Skalierungscale oder über scalefit
Ausrichtung Horizontale und vertikale Ausrichtung des Inhaltsbereichs innerhalb des Darstellungsbereichs;
align und valign

In den folgenden Beispielen wird nur das Element imagedata betrachtet. Für die Beispiele benötigen Sie mindestens DocBook Version 4.2. Bei der Bilddatei test.png wird eine Dimension von 2 cm × 2 cm angenommen.

Tabelle: Darstellungs- und Inhaltsbereich einer Grafik (2 cm × 2 cm)

GrafikErklärung

Darstellungs- und Inhaltsbereich einer Grafik (2 cm × 2 cm)

Wenn nichts spezifiziert wurde, besitzt der Inhaltsbereich dieselbe Größe wie das Bild. Die Größe des Darstellungsbereich ist implementationsabhängig. Der Wert des Attribut scalefit ist in diesem Fall irrelevant:

<imagedata fileref="test.png"/>

Darstellungs- und Inhaltsbereich einer Grafik (2 cm × 2 cm)

Erzeugt ein Bild mit einer Breite von 4 cm. Die Höhe des Bildes wird entsprechend skaliert (der Wert von scalefit beträgt in diesem Fall standardmäßig 1):

<imagedata fileref="test.png" width="4cm"/>

Darstellungs- und Inhaltsbereich einer Grafik (2 cm × 2 cm)

Erzeugt einen Inhaltsbereich, der genauso groß ist wie die Grafikdimensionen. Jedoch wird durch das Attribut scalefit mit dem Wert 0 das Bild in seiner ursprünglichen Dimension beibehalten.Durch die Attribute align und valign lässt sich die Grafik innerhalb des Darstellungsbereiches horizontal und vertikal ausrichten. Wenn nichts angegeben wurde, ist die Ausrichtung implementationsabhängig. Für gewöhnlich wird die linke obere Ecke gewählt.

<imagedata fileref="test.png" width="4cm" scalefit="0"/>

Darstellungs- und Inhaltsbereich einer Grafik (2 cm × 2 cm)

Wird ein Skalierungsfaktor angegeben, wird die implizite Grafikgröße gleichmäßig um einen Betrag skaliert, damit die Grafik in einen Inhaltsbereich passt. Die Größe des Darstellungsbereich ist implementationsabhängig.

<imagedata fileref="test.png" scale="200" />

Darstellungs- und Inhaltsbereich einer Grafik (2 cm × 2 cm)

Wurde sowohl Darstellungs- als auch Inhaltsbereich angegeben, wird die Grafik auf den Inhaltsbereich skaliert (möglicherweise uneinheitlich). Der Inhaltsbereich wird im spezifizierten Darstellungsbereich dargestellt:

<imagedata fileref="test.png" width="4cm" depth="4cm" content-width="3cm" />

Je nach Zielformat sind manche Darstellungen schwierig umzusetzen. In (X)HTML müssen oft Kompromisse eingegangen werden, und teilweise benötigen Sie bei manchen Attributkombinationen die Erweiterungsfunktionen Ihres XSLT-Prozessors.

  

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de