xerif

h1. Bilder

{{toc}}

h2. Grundsätzliches

Folgende Bildformate können von TeX nicht verstanden werden und sollten in einem extra Schritt nach PDF oder PNG gewandelt werden:

* @.tif@, @.tiff@

* @.svg@

Folgende Bildformate werden von TeX verstanden:

* @.jpg@, @.jpeg@

* @.pdf@

* @.png@

* @.eps@

h2. Bilder im *transpect-tex Common Framework* ("transpect-floats.dtx":https://gitlab.le-tex.de/transpect-tex/transpect-tex/-/blob/master/src/transpect-floats.dtx)

h3. Einzelbilder

h4. Einspaltiger Satz

<pre><code class="text">

\begin{tpFigure}[<options>]

  \tpCaption{<caption>}

  \tpSource{<Quelle>}

  \tpLegend{<Legende>}

  \tpNumber{<Nummer>}

  \tpFig{\includegraphics[<optionen>]{<pfad>}}

\end{tpFigure}

</code></pre>

* @<options>@ Attribute, kommaseparierte KeyVal-Syntax @<attribut>=<value>@ bzw. @<attribut>={<value>}@, wenn @<value>@ "=" oder "," enthalten (optional):

** @float-pos@

*** fehlt das oder ist @<value>@ leer, wird das Bild fix (d.h. nicht-gleitend) platziert. Ggf. wird dabei (viel) vertikaler Weißraum erzeugt.

*** t top

*** b bottom

*** h falls Bild noch auf Seite passt: nichtgleitend, sonst: top auf nächster Seite

*** p Bild allein auf nächster Seite. 

** @class@

*** Layout-Klasse des Gleitobjektes

** @nolist@

*** Wenn "@nolist@" gesetzt ist, wird die Abbildung nicht in das Abbildungsverzeichnis übernommen (\listoffigures)

* @\tpCaption{}@ Bildunterschrift

* @\tpSource{}@ Quellenangabe

* @\tpLegend{}@ Legende

* @\tpNumber{}@ Abbildungszähler samt Präfix, z.B. "Abb. 10", "Fig. 1.2", "Abbildung 22", etc.

* @\tpFig{}@ Hiermit wird die Bilddatei eingebunden, beinhaltet i.d.R. @\includegraphics[<optionen>]{<pfad>}@

h4. zweispaltiger Satz

Soll ein Gleitobjekt im zweispaltigen Satz über beide spalten gehen, wird dem Umgebungsnamen ein @*@ am Ende angefügt. Auch ist dann das @float-pos@-Attribut zwingend anzugeben (und darf nicht leer sein), da zweispaltige Objekte in TeX zwangsweise immer gleiten.

Ein seitenbreites Bild wäre demnach

<pre><code class="text">

\begin{tpFigure*}[<options>]

  …

\end{tpFigure*}

</code></pre>

Ohne die * wird das Bild in einer einzelnen Spalte platziert.

Die übrigen Parameter sind dieselben wie im einspaltigen Satz, oben.

h3. komplexe Abbildungen

h4. Mehrere Bilder unter einer Caption

<pre><code class="text">

\begin{tpFigure}

  \tpCaption{<caption>}

  \tpLegend{<Legende>}

  \tpSource{<source>}

  \tpNumber{<Counter>}

  \begin{tpSubFloat}

    \tpFig{\includegraphics[<optionen>]{<pfad>}}

  \end{tpSubFloat}

  \begin{tpSubFloat}

    \tpFig{\includegraphics[<optionen>]{<pfad>}}

  \end{tpSubFloat}

\end{tpFigure}

</code></pre>

h4. Mehrere Bilder mit separaten Captions

<pre><code class="text">

\begin{tpFigure}

  \begin{tpSubFloat}

    \tpCaption{<caption>}

    \tpLegend{<Legende>}

    \tpSource{<source>}

    \tpNumber{<Counter>}

    \tpFig{\includegraphics[<optionen>]{<pfad>}}

  \end{tpSubFloat}

  \begin{tpSubFloat}

    \tpCaption{<caption>}

    \tpLegend{<Legende>}

    \tpSource{<source>}

    \tpNumber{<Counter>}

    \tpFig{\includegraphics[<optionen>]{<pfad>}}

  \end{tpSubFloat}

\end{tpFigure}

</code></pre>

h3. Bildbreiten

Im optionalen Argument von @\includegraphics@ kann bei Bedarf die Breite des Bildes überdefiniert werden:

Bild auf Satzspiegelbreite skalieren:<pre>\includegraphics[width=\textwidth]{…}</pre>_Achtung:_ wenn für das Bild weniger Platz reserviert ist als Satzspiegelbreite (z.B. durch Bild-Klassen oder durch nebeneinander platzierte Sub-Figures), wird das Bild eine Leerzeile erzeugen, was für zu große Abstände zu caption-bottom bzw. zum Fließtext sorgen wird! Auch kann es bei Sub-Figures passieren, dass die Bilder einander teilweise überlappen.

Um ein Bild auf 100% des _verfügbaren Platzes_ zu skalieren, bitte<pre>\includegraphics[width=\hsize]{…}</pre>verwenden.

Qua default skaliert das transpect-floats-Paket Grafiken ohnehin immer auf die maximal verfügbare Breite, daher ist das @width@-Attribut in aller Regel redundant. Die Verwendung des width-Attribut macht nur dort Sinn, wo ein Bild eine fixe Breite erhalten soll, die vom berechneten Wert abweicht, etwa "70% Satzspiegelbreite" (@width=0.7\textwidth@), ein fester Wert (@width=30mm@), oder ein Wert relativ zur berechneten Breite ("50% vom verfügbaren Platz": @width=0.5\hsize@).

In jedem Fall hat eine Angabe im optionalen Argument von @\includegraphics@ Priorität über die vom Paket berechneten Werte.