Inlinegraphicx mit LaTeX

1. inlinegraphicx

Das Paket inlinegraphicx (2024/11/06 0.1.0) bietet eine einfache Möglichkeit, Bilder direkt im Textfluss zu positionieren, wobei das Paket automatisch die Skalierung und die Platzierung anpasst.[1] Es basiert auf dem bekannten Befehl \includegraphics aus dem graphicx-Paket, geht jedoch darüber hinaus, indem es die Bildhöhe und Tiefe im Verhältnis zur aktuellen Schriftgröße berechnet, um das Bild präzise im Text auszurichten.

1.1 Paket einbinden

Das Paket wird mit \usepackage{inlinegraphicx} eingebunden und bindet seinerseits die Pakete graphicx, simplekv und calc ein. Da das Paket jetzt (10.11.2024) noch sehr neu ist, ist es möglich, dass es noch nicht überall verfügbar ist, aber es lässt sich auch direkt bei CTAN inlinegraphicx runterladen. Das Paket verfügt zur Zeit über keine Optionen.

1.2 Befehl

Der Hauptbefehl des Pakets ist:

\inlinegraphics(*)[scale=...,strut=...]{Bilddatei}

Sternversion (\inlinegraphics*): Entfernt die Tiefenanpassung, sodass das Bild ohne Rücksicht auf die Tiefenmaße der Schrift eingebunden wird.

Optionen

scale: Skaliert das Bild im Verhältnis zur errechneten Höhe (Standardwert: 1).
strut: Bestimmt die Zeichen, deren Höhe und Tiefe zur Ausrichtung verwendet werden (Standard: qH).

1.3 Anwendungen

Beispiel 1: Einfaches Einfügen einer Grafik
Der folgende Befehl fügt eine Grafik inline in den Text ein: \inlinegraphics{example-image-16x10}

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[a4paper,margin=1cm]{geometry}
\usepackage{inlinegraphicx} 
\begin{document}

In dieser Textzeile steht ein Bild \inlinegraphics{example-image-16x10}, hier im
 Beispiel ist es nur ein Beispielbild.

\end{document}

In diesem Fall wird die Grafik example-image-16x10 automatisch so skaliert, dass sie zur Schriftgröße des aktuellen Textes passt. Die Höhe der Grafik wird auf die Höhe des Zeichens „qH“ der aktuellen Schrift gesetzt. Das Paket berücksichtigt hierbei automatisch die Tiefe der Schrift, sodass das Bild korrekt in den Text integriert wird.
Bild in einer Textzeile in LaTeX

Beispiel 2: Skalierung der Grafik
Falls die Größe der Grafik angepasst werden soll, kann die Option scale verwendet werden:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[a4paper,margin=1cm]{geometry}
\usepackage{inlinegraphicx} 
\begin{document}

In dieser Textzeile steht ein Bild \inlinegraphics[scale=0.5]{example-image-16x10},
 hier im Beispiel ist es nur ein Beispielbild.

\end{document}

Hier wird die Grafik auf 50 % der automatisch berechneten Höhe skaliert. Das bedeutet, dass das Bild etwas kleiner erscheint, bleibt jedoch weiterhin auf die aktuelle Schriftgröße abgestimmt und integriert sich fließend in den Text.
Skaliertes Bild in einer Textzeile in LaTeX

Beispiel 3: Einfügen ohne Tiefenanpassung
In manchen Fällen ist es wünschenswert, die Tiefe der Grafik nicht an die aktuelle Schrift anzupassen, zum Beispiel, wenn die Grafik ohne Unterbrechung der Textlinie erscheinen soll. Dies kann mit der Stern-Version des Befehls erreicht werden:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[a4paper,margin=1cm]{geometry}
\usepackage{inlinegraphicx} 
\begin{document}

In dieser Textzeile steht ein Bild \inlinegraphics*{example-image-16x10}, hier 
im Beispiel ist es nur ein Beispielbild.

\end{document}

Durch den Stern (*) wird die Tiefenanpassung deaktiviert, und die Grafik wird lediglich an der Höhe des aktuellen Schriftzeichens ausgerichtet. Das Bild schwebt dadurch eher in der Textlinie, was nützlich ist, wenn keine vertikale Anpassung an die Tiefe der Schrift gewünscht ist.
Bild in einer Textzeile in LaTeX ohne Tiefenanpassung

Beispiel 4: Anpassung mit einem speziellen Zeichen für Höhe und Tiefe

Falls ein bestimmtes Zeichen zur Berechnung der Höhe und Tiefe verwendet werden soll, kann das strut-Attribut genutzt werden. Hierbei wird ein Zeichen angegeben, dessen vertikale Ausmaße für die Positionierung der Grafik verwendet werden. Dazu wird die Option strut verwendet.

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[a4paper,margin=1cm]{geometry}
\usepackage{inlinegraphicx} 
\begin{document}

In dieser Textzeile steht ein Bild \inlinegraphics[strut={(M)}]{example-image-16x10}, hier im Beispiel ist es nur ein Beispielbild.

\end{document}

Hier wird das Zeichen „M“ als Referenz für die Höhe und Tiefe der Grafik verwendet, sodass sich die Positionierung an den vertikalen Maßen dieses Zeichens orientiert.
Bild in einer Textzeile in LaTeX mit M als Größenreferenz.

Diese Einstellung wird zumeist nur im direkten Vergleich sichtbar:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[a4paper,margin=1cm]{geometry}
\usepackage{inlinegraphicx} 
\begin{document}
\noindent
\scalebox{4.5}{Bild É \inlinegraphics[strut={(É)}]{example-image-16x10} vs. Bild q \inlinegraphics[strut={(q)}]{example-image-16x10}}

\end{document}

In diesem Beispiel gibt es einen direkten Vergleich von den Auswirkungen die verschiedene Buchstaben auf die Positionierung des Bildes besitzen. Die \scalebox wurde wegen der Möglichkeit der Vergrößerung hier verwendet.
Auswirkungen von unterschiedlichen Referenzen auf die Positionierung des Bildes.

1.5 Zusammenfassung der Optionen

Diese Beispiele zeigen, wie inlinegraphicx es ermöglicht, Grafiken präzise in den Textfluss zu integrieren, ohne manuelle Anpassungen an Höhe und Tiefe vornehmen zu müssen. Das Paket ist besonders praktisch für das einfügen von Bildern in den Fließtext.

Literatur

[1]: inlinegraphicx Includegraphics, with an automatic inline positioning., Cédric Pierquet, 06/11/2024