LaTeX Extra > LaTeX Pakete > graphicx LaTeX Paket


Mit dem graphicx Paket können Grafiken beziehungsweise Bilder in LaTeX eingebunden werden. Das Paket ist neben vielen anderen auch Teil des 'graphics' bundle von D.P. Carlisle. In der aktuellen Version ist bereits die Funktionalität des grffile Paketes integriert, was es ermöglicht, auch Bilder einzubinden, in deren Dateinamen Leerzeichen vorkommen.

includegraphics rotatebox reflectbox scalebox resizebox

Einbinden des Paketes

Das Paket selbst wird mit \usepackage{graphicx} eingebunden. Wichtig ist hierbei, darauf zu achten, dass die Variante mit x gewählt wird und nicht die Variante mit s am Ende. Insbesondere wenn ein Programm mit automatischer Ergänzung verwendet wird, kann es vorkommen, dass die Variante mit s am Ende zuerst vorgeschlagen beziehungsweise automatisch übernommen wird.

Verwendung von Optionen

Beim Einbinden können auch noch zusätzliche Optionen gesetzt werden. Im Folgenden wird auf die wichtigsten davon näher eingegangen.

draft (Entwurf) Option
\documentclass{article}
%...
\usepackage[draft]{graphicx}
%...
\begin{document}
%...
\includegraphics{matrix_geschweift}
%...
\end{document}

Bei der Verwendung von draft wird anstelle des Bildes nur der Rahmen und der Name der Datei dargestellt. Dies wird unter anderem aus dem Grund verwendetet, dass das Kompilieren auf diese Weise schneller geht, aber dennoch sieht man, wie die Bilder das Dokument beeinflussen. Diese Option des Paketes hat damit die gleiche Wirkung wie die Dokumentenklassen Option draft.

final Option
\documentclass[draft]{article}
%...
\usepackage[final]{graphicx}
%...
\begin{document}
%...
\includegraphics{matrix_geschweift}
%...
\end{document}

Die Option final hebt die Dokumentenklassen Option draft auf, das heißt das Bild wird angezeigt.

demo Option
\documentclass{article}
%...
\usepackage[demo]{graphicx}
%...
\begin{document}
%...
\includegraphics{matrix_geschweift}
%...
\end{document}

Die Option demo fügt an jeder Stelle, an der der Befehl \includegraphics{BildName} verwendet wird ein Rechteck mit 150pt auf 100pt ein.

Die Optionen hidescale und hiderotate werden nur benötigt, wenn Programm zur Betrachtung der Vorschau des Dokumentes benützt werden, die mit skaliertem beziehungsweise rotiertem Text nicht umgehen können verwendet werden.

Bild Formate

Je nachdem ob latex oder pdflatex zum Kompilieren benützt werden, sind unterschiedliche Datei Formate für die Bilder zulässig. Wird latex genutzt sind dies ps und eps. Bei pdflatex können jpg, pdf oder png Format verwendet werden. Liegen die Bilder in anderen Formaten vor, lassen sich diese zum Teil recht einfach in das gewünschte Format konvertieren. Eine kurze Auswahl an Möglichkeiten.

AusgangsformatZielformatProgramm
epspdfepstopdf
tiffpstiff2ps
tiffpdftiff2pdf
Die Programme epstopdf, tiff2ps und tiff2pdf sollten auf einer Linux Installation vorhanden beziehungsweise installierbar sein.
Bilder im svg Format benötigen das svg Paket.

Befehle

Das graphicx Paket stellt die folgenden Befehle zur Verfügung...

includegraphics

Das Kommando \includegraphics[Option(en)]{Dateiname} bindet das gewünschte Bild ein. Der Befehl selbst verfügt über mehrere Optionen.

scaleDie Option scale wird verwendet, um das Bild zu skalieren. Dazu wird eine Skalierung in der Form scale=0.5 (halb so groß) vergegeben. Wichtiger Hinweis: Die Zahlen sind Punktzahlen und keine Kommazahlen. Wird eine Kommazahl verwendet, erhält das Bild die Skalierung 0 und die 5 ist im besten Fall eine unbekannte Option.
draftDamit wird das Bild als Entwurf beziehungsweise im Entwurfsmodus eingefügt.
angleMit der angle Option wird das Bild um einen bestimmten Winkel (gegen den Uhrzeigersinn) gedreht. Diese Option kann insbesondere beim Einbinden von selbst gescannten Abbildung praktisch sein.
widthDie Breite kann über die Option width als absolute Größe, zum Beispiel width=6cm, oder relative Größe, zum Beispiel width=0.2\paperwidth, festgelegt werden.
heightDie Höhe kann über die Option height als absolute Größe, zum Beispiel height=6cm, oder relative Größe, zum Beispiel height=0.2\paperheight, festgelegt werden. Werden die zwei Optionen height und width zur gleichen Zeit verwendet, kann dies zu einer Veränderung des Aspektverhältnis (aspect ratio) führen, was sich in einem verzerrten Bild darstellt.

Beispiele für die Verwendung der Optionen bei \includegraphics
%...
\includegraphics[scale=0.5,angle=30]{matrix_geschweift}
%...

%...
\includegraphics[width=0.2\paperwidth, height=0.1\paperheight]{matrix_geschweift}
%...

rotatebox

Mit dem Befehl \rotatebox[Ursprung]{Winkel}{Element} können Element gedreht werden. Beim Ursprung können bis zu zwei der folgenden Werte gesetzt werden: l(links), r(rechts), c(zentriert), t(oben), b(unten) und B(baseline). Dadurch wird der Punkt, um den gedreht wird, festgelegt.

%...
\rotatebox[origin=l]{30}{\textcolor{blue}{TESXXEST}}
%...
%...
\rotatebox[origin=c]{30}{\textcolor{blue}{TESXXEST}}
%...
%...
\rotatebox[origin=r]{30}{\textcolor{blue}{TESXXEST}}
%...

reflectbox

Der Befehl \reflectbox{Element} ermöglicht das Spiegeln von Elementen.

%...
\reflectbox{gespiegelt}
%...

scalebox

Der Befehl \scalebox{Faktor} ermöglicht das Skalieren, also das Vergrößern beziehungsweise verkleinern von Elementen.

%...
\scalebox{2.5}{Test} vs. Test
%...

resizebox

Der Befehl \resizebox{Horizontale Länge}{vertikale Länge}{Element} ermöglicht die Anpassung von Elementen an vorgegebenen Größen.

In diesem Beispiel ist die Grafik einen 3 cm breit und wird vertikal um den gleichen Faktor skaliert, damit sie nicht verzerrt wird. Um dies zu erreichen, wird anstelle der vertikalen Länge ein Ausrufezeichen (!) dort gesetzt.

%...
\resizebox{3cm}{!}{Test} vs. Test
%...

Wird zum Beispiel bei der Größenanpassung von Tabellen verwendet.

Literatur

The graphicx package, D.P. Carlisle und S. P. Q. Rahtz, 09.09.2020. Abgerufen unter: graphicx -- Enhanced support for graphics am 25.04.2021