mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
93 lines
4.5 KiB
Markdown
93 lines
4.5 KiB
Markdown
---
|
|
description: "Kombiniert mehrere Bilder zu Rastercollagen mit über 25 Vorlagen, einstellbaren Abständen und Ecken sowie Schwenken und Zoomen pro Zelle."
|
|
i18n_source_hash: 96f2055717df
|
|
i18n_provenance: human
|
|
i18n_output_hash: 480169ab7be2
|
|
---
|
|
|
|
# Collage / Raster {#collage-grid}
|
|
|
|
Kombiniert mehrere Bilder zu ansprechenden Rastercollagen mit über 25 Vorlagen. Unterstützt Layouts für 2 bis 9 Bilder mit anpassbarem Abstand, Eckenradius, Hintergrundfarbe sowie Schwenk-/Zoom-Steuerung pro Zelle.
|
|
|
|
## API-Endpunkt {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/collage`
|
|
|
|
## Parameter {#parameters}
|
|
|
|
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
|
|-----------|------|----------|---------|-------------|
|
|
| templateId | string | Ja | - | ID des Vorlagenlayouts (z. B. `2-h-equal`, `3-left-large`, `4-grid`, `9-grid`) |
|
|
| cells | array | Nein | - | Array mit Einstellungen pro Zelle mit `imageIndex`, `panX`, `panY`, `zoom`, `objectFit` |
|
|
| cells[].imageIndex | integer | Ja | - | Index des Bildes, das in diese Zelle platziert wird (0-basiert) |
|
|
| cells[].panX | number | Nein | 0 | Horizontaler Schwenkversatz (-100 bis 100) |
|
|
| cells[].panY | number | Nein | 0 | Vertikaler Schwenkversatz (-100 bis 100) |
|
|
| cells[].zoom | number | Nein | 1 | Zoomstufe (1 bis 10) |
|
|
| cells[].objectFit | string | Nein | `"cover"` | Wie das Bild die Zelle ausfüllt: `cover` oder `contain` |
|
|
| gap | number | Nein | 8 | Abstand zwischen den Zellen in Pixeln (0 bis 500) |
|
|
| cornerRadius | number | Nein | 0 | Eckenradius jeder Zelle in Pixeln (0 bis 500) |
|
|
| backgroundColor | string | Nein | `"#FFFFFF"` | Hintergrundfarbe als Hex-Wert oder `"transparent"` |
|
|
| aspectRatio | string | Nein | `"free"` | Seitenverhältnis der Leinwand: `free`, `1:1`, `4:3`, `3:2`, `16:9`, `9:16`, `4:5` |
|
|
| outputFormat | string | Nein | `"png"` | Ausgabeformat: `png`, `jpeg`, `webp`, `avif`, `jxl` |
|
|
| quality | number | Nein | 90 | Ausgabequalität (1 bis 100) |
|
|
|
|
## Verfügbare Vorlagen {#available-templates}
|
|
|
|
| Vorlagen-ID | Bilder | Layout |
|
|
|-------------|--------|--------|
|
|
| `2-h-equal` | 2 | Zwei gleich große Spalten |
|
|
| `2-v-equal` | 2 | Zwei gleich große Zeilen |
|
|
| `2-h-left-large` | 2 | Links 2/3, rechts 1/3 |
|
|
| `2-h-right-large` | 2 | Links 1/3, rechts 2/3 |
|
|
| `3-left-large` | 3 | Groß links, zwei gestapelt rechts |
|
|
| `3-right-large` | 3 | Zwei gestapelt links, groß rechts |
|
|
| `3-top-large` | 3 | Groß oben, zwei Spalten unten |
|
|
| `3-h-equal` | 3 | Drei gleich große Spalten |
|
|
| `3-v-equal` | 3 | Drei gleich große Zeilen |
|
|
| `4-grid` | 4 | 2x2-Raster |
|
|
| `4-left-large` | 4 | Groß links, drei gestapelt rechts |
|
|
| `4-top-large` | 4 | Groß oben, drei Spalten unten |
|
|
| `4-bottom-large` | 4 | Drei Spalten oben, groß unten |
|
|
| `5-top2-bottom3` | 5 | Zwei oben, drei unten |
|
|
| `5-top3-bottom2` | 5 | Drei oben, zwei unten |
|
|
| `5-left-large` | 5 | Groß links, vier gestapelt rechts |
|
|
| `5-center-large` | 5 | Groß in der Mitte, vier Ecken |
|
|
| `6-grid-2x3` | 6 | 2 Spalten x 3 Zeilen |
|
|
| `6-grid-3x2` | 6 | 3 Spalten x 2 Zeilen |
|
|
| `6-top-large` | 6 | Groß oben, fünf Spalten unten |
|
|
| `7-mosaic` | 7 | Mosaiklayout |
|
|
| `8-mosaic` | 8 | Mosaiklayout |
|
|
| `9-grid` | 9 | 3x3-Raster |
|
|
|
|
## Beispielanfrage {#example-request}
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/collage \
|
|
-F "file=@photo1.jpg" \
|
|
-F "file=@photo2.jpg" \
|
|
-F "file=@photo3.jpg" \
|
|
-F "file=@photo4.jpg" \
|
|
-F 'settings={"templateId":"4-grid","gap":12,"cornerRadius":8,"backgroundColor":"#F5F5F5","outputFormat":"png","quality":90}'
|
|
```
|
|
|
|
## Beispielantwort {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/collage.png",
|
|
"originalSize": 2456789,
|
|
"processedSize": 1823456
|
|
}
|
|
```
|
|
|
|
## Hinweise {#notes}
|
|
|
|
- Laden Sie mehrere Bilddateien in der Multipart-Anfrage hoch. Die Bilder werden den Vorlagenzellen in der Reihenfolge des Hochladens zugewiesen.
|
|
- Werden mehr Bilder hochgeladen, als die Vorlage unterstützt, werden die überzähligen Bilder ignoriert.
|
|
- Unterstützt HEIC-, RAW-, PSD- und SVG-Eingabeformate (werden automatisch dekodiert).
|
|
- Die Basisgröße der Leinwand beträgt 2400 px an der längsten Seite und wird anhand des gewählten Seitenverhältnisses skaliert.
|
|
- Wenn `aspectRatio` `"free"` ist, verwendet die Leinwand standardmäßig 4:3 (2400x1800).
|
|
- Die Werte `panX`/`panY` pro Zelle verschieben das Zuschneidefenster innerhalb der Zelle. Ein Wert von 100 verschiebt vollständig zu einer Kante, -100 zur anderen.
|
|
- Die Hintergrundfarbe `"transparent"` bleibt nur bei den Ausgabeformaten `png`, `webp` oder `avif` erhalten.
|