xerif

h1. Bilder

{{toc}}

h2. Grundsätzliches

Folgende Bildformate werden von TeX *nicht unterstützt* und müssen in einem Extraschritt in ein unterstütztes Format konvertiert werden:

* @.tif@, @.tiff@

* @.svg@

Folgende Bildformate werden von TeX verstanden:

* @.jpg@, @.jpeg@

* @.pdf@

* @.png@

* @.eps@

h2. Bilder im *xerif-Framework* ("coco-floats.sty":https://gitlab.le-tex.de/transpect-tex/transpect-tex/-/blob/oop/projects/common/coco-floats.sty)

h3. Einzelbilder

h4. Einspaltiger Satz

<pre><code class="text">

\begin{tpFigure}[<Optionen>]

  \tpCaption{…}

  \tpSource{…}

  \tpLegend{…}

  \tpNumber{…}

  \tpFig{\includegraphics[…]{…}}

\end{tpFigure}

</code></pre>

* @<Optionen>@: Attribute, kommaseparierte Key-Value-Syntax (@<key>=<value>@ bzw. @<key>={<value>}@; Letzteres, wenn @<value>@ Gleichheitszeichen oder Kommata enthält):

** @float-pos@

*** fehlt diese Angabe ist @<value>@ leer (@float-pos=@), wird das Bild fix (d. h. nichtgleitend) platziert; Dies erzeugt ggf. (viel) vertikalen Weißraum

*** @t@ (top): oberste Satzspiegelkante

*** @b@ (bottom): unterste Satzspiegelkante

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

*** @p@: Bild allein auf nächster Seite 

** @class@

*** Layoutklasse des Gleitobjektes

** @nolist@

*** wird "@nolist@" gesetzt, erfolgt keine Aufnahme des Bildes ins Abbildungsverzeichnis (@\listoffigures@)

* @\tpCaption{…}@: Bildunterschrift

* @\tpSource{…}@: Quellenangabe

* @\tpLegend{…}@: Legende

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

* @\tpFig{…}@: Einbindung der Bilddatei; beinhaltet i. d. R. @\includegraphics[<Optionen>]{<Bildpfad>}@

h4. Zweispaltiger Satz

Soll ein Gleitobjekt im zweispaltigen Satz über beide Spalten laufen, wird dem Umgebungsnamen ein Asterisk (@*@) am Ende angefügt. Auch ist dann das @float-pos@-Attribut zwingend anzugeben und darf überdies nicht leer sein, da zweispaltige Objekte in TeX grundsätzlich gleiten.

Ein seitenbreites Bild wird durch

<pre><code class="text">

\begin{tpFigure*}[<options>]

  …

\end{tpFigure*}

</code></pre>

gesetzt. Ohne den Asterisken wird das Bild in einer einzelnen Spalte platziert. Die übrigen Parameter sind dieselben wie im "einspaltigen Satz":https://redmine.le-tex.de/projects/transpect-typesetter/wiki/Bilder#Einspaltiger-Satz.

h3. Komplexe Abbildungen

h4. Mehrere Bilder unter einer Bildunterschrift

<pre><code class="text">

\begin{tpFigure}

  \tpCaption{…}

  \tpLegend{…}

  \tpSource{…}

  \tpNumber{…}

  \begin{tpSubFloat}

    \tpFig{\includegraphics[<Optionen>]{<Bildpfad>}}

  \end{tpSubFloat}

  \begin{tpSubFloat}

    \tpFig{\includegraphics[<Optionen>]{<Bildpfad>}}

  \end{tpSubFloat}

\end{tpFigure}

</code></pre>

h4. Mehrere Bilder mit separaten Bildunterschriften

<pre><code class="text">

\begin{tpFigure}

  \begin{tpSubFloat}

    \tpCaption{…}

    \tpLegend{…}

    \tpSource{…}

    \tpNumber{…}

    \tpFig{\includegraphics[<Optionen>]{<Bildpfad>}}

  \end{tpSubFloat}

  \begin{tpSubFloat}

    \tpCaption{…}

    \tpLegend{…}

    \tpSource{…}

    \tpNumber{…}

    \tpFig{\includegraphics[<Optionen>]{<Bildpfad>}}

  \end{tpSubFloat}

\end{tpFigure}

</code></pre>

h3. Bildbreiten

Im optionalen Argument des @\includegraphics@-Makros 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 Bildklassen oder durch nebeneinander platzierte Teilabbildungen), 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 Teilabbildungen 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.

Per Standard skaliert das coco-floats-Paket Graphiken stets auf die maximal verfügbare Breite, weshalb das @width@-Attribut in aller Regel redundant ist. Die Verwendung des @width@-Attributs ist nur dort sinnvoll, wo ein Bild eine prozentuale Breite, die vom berechneten Wert abweicht, etwa 70 % Satzspiegelbreite (@width=0.7\textwidth@), einen festen Wert (@width=30mm@) oder einen Wert relativ zur berechneten Breite (50 % des verfügbaren Platzes,  @width=0.5\hsize@) erhalten soll. In jedem Fall hat eine Angabe im optionalen Argument von @\includegraphics@ Priorität über die vom Paket berechneten Werte.