# composite — Bilder mit ImageMagick überlagern und zusammensetzen

> Bilder mit ImageMagick composite überlagern: Wasserzeichen, Overlays, Masken, Blendmodi und gestapelte Ebenen direkt auf der Kommandozeile.

Source: https://www.jpkc.com/db/cheatsheets/images-media/composite/

<!-- PROSE:intro -->
`composite` aus dem ImageMagick-Werkzeugkasten legt ein Bild über ein anderes – ideal für Wasserzeichen, Logo-Overlays, Masken und kreative Blendmodi. Über `-gravity` und `-geometry` positionierst du das Overlay pixelgenau, mit `-dissolve` und `-compose` steuerst du Transparenz und Mischverhalten. In ImageMagick 7 ist das eigenständige `composite` weitgehend durch `magick composite` bzw. `magick … -composite` abgelöst, bleibt aber kompatibel. Bedenke, dass jeder Aufruf eine Ausgabedatei schreibt: Wähle den Zielpfad bewusst, sonst überschreibst du womöglich ein vorhandenes Bild.
<!-- PROSE:intro:end -->

## Grundlegendes Überlagern

`composite <overlay> <background> <output>` — Legt das Overlay-Bild über das Hintergrundbild.

```bash
composite logo.png photo.jpg result.jpg
```

`composite -gravity <position> <overlay> <background> <output>` — Positioniert das Overlay über die Schwerkraft (center, north, southeast usw.).

```bash
composite -gravity southeast logo.png photo.jpg watermarked.jpg
```

`composite -geometry +<x>+<y> <overlay> <background> <output>` — Platziert das Overlay an einem exakten Pixel-Offset.

```bash
composite -geometry +50+100 logo.png photo.jpg result.jpg
```

`composite -gravity center -geometry +0+<y> <overlay> <background> <output>` — Zentriert horizontal mit vertikalem Versatz.

```bash
composite -gravity center -geometry +0+50 banner.png photo.jpg result.jpg
```

## Wasserzeichen

`composite -dissolve <percent> <overlay> <background> <output>` — Overlay mit Transparenz (0–100 %).

```bash
composite -dissolve 30 watermark.png photo.jpg watermarked.jpg
```

`composite -dissolve <percent> -gravity southeast -geometry +10+10 <overlay> <background> <output>` — Halbtransparentes Wasserzeichen in der unteren rechten Ecke.

```bash
composite -dissolve 25 -gravity southeast -geometry +10+10 logo.png photo.jpg watermarked.jpg
```

`composite -tile <overlay> <background> <output>` — Kachelt das Overlay über den gesamten Hintergrund.

```bash
composite -tile watermark.png photo.jpg tiled-watermark.jpg
```

`composite -dissolve 20 -tile <overlay> <background> <output>` — Kachelt ein halbtransparentes Wasserzeichen über das ganze Bild.

```bash
composite -dissolve 20 -tile watermark.png photo.jpg tiled.jpg
```

## Blendmodi

`composite -compose Multiply <overlay> <background> <output>` — Multiplizieren-Modus (verdunkelt das Bild, ideal für Texturen).

```bash
composite -compose Multiply texture.png photo.jpg multiplied.jpg
```

`composite -compose Screen <overlay> <background> <output>` — Negativ-multiplizieren-Modus (hellt das Bild auf).

```bash
composite -compose Screen light-leak.png photo.jpg screened.jpg
```

`composite -compose Overlay <overlay> <background> <output>` — Ineinanderkopieren-Modus (kombiniert Multiply und Screen).

```bash
composite -compose Overlay texture.png photo.jpg blended.jpg
```

`composite -compose Difference <overlay> <background> <output>` — Differenz-Modus (hebt Unterschiede zwischen den Bildern hervor).

```bash
composite -compose Difference image-a.jpg image-b.jpg diff.jpg
```

`composite -compose Dissolve -define compose:args=<percent> <overlay> <background> <output>` — Auflösen-Modus mit präziser Steuerung.

```bash
composite -compose Dissolve -define compose:args=50 overlay.png base.jpg result.jpg
```

`composite -compose SoftLight <overlay> <background> <output>` — Weiches-Licht-Modus (dezenter Lichteffekt).

```bash
composite -compose SoftLight light.png photo.jpg softlit.jpg
```

`composite -compose ColorBurn <overlay> <background> <output>` — Farbig-nachbelichten-Modus (verstärkt dunkle Bereiche).

```bash
composite -compose ColorBurn texture.png photo.jpg burned.jpg
```

## Masken

`composite <overlay> <background> <mask> <output>` — Nutzt ein drittes Bild als Maske (Weiß = sichtbar, Schwarz = verborgen).

```bash
composite overlay.png background.jpg mask.png result.jpg
```

`composite -compose CopyOpacity <mask> <input> <output>` — Wendet eine Graustufenmaske als Alphakanal an.

```bash
composite -compose CopyOpacity mask.png photo.png masked.png
```

`composite -compose DstIn <mask> <input> <output>` — Beschneidet das Bild mit der Maskenform (Destination-in-Compositing).

```bash
composite -compose DstIn circle-mask.png photo.png clipped.png
```

## Overlay skalieren

`composite -resize <width>x<height> <overlay> <background> <output>` — Skaliert das Overlay vor dem Zusammensetzen.

```bash
composite -resize 200x200 logo.png photo.jpg result.jpg
```

`composite -geometry <width>x<height>+<x>+<y> <overlay> <background> <output>` — Skaliert und positioniert das Overlay in einem Schritt.

```bash
composite -geometry 100x100+20+20 icon.png photo.jpg result.jpg
```

## Typische Muster

`for f in *.jpg; do composite -dissolve 25 -gravity southeast watermark.png "$f" "watermarked-$f"; done` — Versieht alle JPEGs eines Verzeichnisses stapelweise mit einem Wasserzeichen.

```bash
for f in *.jpg; do composite -dissolve 25 -gravity southeast watermark.png "$f" "watermarked-$f"; done
```

`composite -gravity center \( overlay.png -resize 50% \) background.jpg result.jpg` — Skaliert das Overlay auf 50 % und zentriert es (mit Klammern).

```bash
composite -gravity center \( logo.png -resize 50% \) photo.jpg result.jpg
```

`convert background.jpg overlay.png -gravity center -compose Over -composite result.jpg` — Alternative Schreibweise mit convert und dem -composite-Operator.

```bash
convert photo.jpg logo.png -gravity southeast -geometry +10+10 -compose Over -composite result.jpg
```

<!-- PROSE:outro -->
## Fazit

`composite` ist das schnellste Mittel, um zwei Bilder zu vereinen – vom dezenten Eck-Wasserzeichen über gekachelte Logos bis zu maskierten Freistellern und Blendmodi wie Multiply oder Screen. Die wichtigsten Stellschrauben sind `-gravity` und `-geometry` für die Position, `-dissolve` für die Deckkraft und `-compose` für das Mischverhalten. Achte auf die Reihenfolge der Argumente (Overlay zuerst, Hintergrund danach) und darauf, dass die Ausgabedatei stets neu geschrieben wird – ein versehentlich gleicher Zielname überschreibt dein Original ohne Nachfrage. Unter ImageMagick 7 ist `magick composite` bzw. `magick … -composite` die empfohlene Form; für Pipelines mit mehreren Schritten ist der `-composite`-Operator von `convert`/`magick` oft die flexiblere Wahl.

## Weiterführende Links

- [ImageMagick: composite](https://imagemagick.org/script/composite.php) – offizielle Referenz zu allen Optionen des composite-Kommandos
- [ImageMagick: Compositing-Operatoren](https://imagemagick.org/Usage/compose/) – ausführliche Beispielsammlung zu `-compose`-Blendmodi und Masken
<!-- PROSE:outro:end -->

## Verwandte Kommandos

- [convert](https://www.jpkc.com/db/cheatsheets/images-media/convert/) – das Schweizer Taschenmesser von ImageMagick zum Umwandeln und Bearbeiten
- [montage](https://www.jpkc.com/db/cheatsheets/images-media/montage/) – mehrere Bilder zu Kontaktabzügen und Rastern anordnen
- [mogrify](https://www.jpkc.com/db/cheatsheets/images-media/mogrify/) – Bilder stapelweise direkt am Original bearbeiten

