Projekt

Allgemein

Profil

Bilder » Historie » Revision 15

Revision 14 (Patrick Schulz, 28.06.2022 10:47) → Revision 15/17 (Patrick Schulz, 28.06.2022 10:48)

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. bzbw. zum Fließtext sorgen wird! Auch kann es bei Sub-Figures subfigures 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@) oder ein fester Wert (@width=30mm@). 

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