Bilder » Historie » Revision 16
Revision 15 (Patrick Schulz, 28.06.2022 10:48) → Revision 16/17 (Patrick Schulz, 28.06.2022 10:52)
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@), (@width=0.7\textwidth@) oder ein fester Wert (@width=30mm@), oder ein Wert relativ zur berechneten Breite ("50% vom verfügbaren Platz": @width=0.5\hsize@). (@width=30mm@).
In jedem Fall hat eine Angabe im optionalen Argument von @\includegraphics@ Priorität über die vom Paket berechneten Werte.