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.
55 lines
2.5 KiB
Markdown
55 lines
2.5 KiB
Markdown
---
|
|
description: "Füllt ein Bild auf ein Zielseitenverhältnis mit einer Volltonfarbe, transparentem oder unscharfem Hintergrund auf."
|
|
i18n_source_hash: 796122da3dae
|
|
i18n_provenance: human
|
|
i18n_output_hash: b15bb1ba9e66
|
|
---
|
|
|
|
# Bild auffüllen {#image-pad}
|
|
|
|
Füllt ein Bild auf ein Zielseitenverhältnis auf, indem ein Hintergrund aus einer Volltonfarbe, transparent oder unscharf darum herum hinzugefügt wird. Nützlich, um Bilder ohne Zuschneiden in feste Seitenverhältnisse für soziale Medien oder den Druck einzupassen.
|
|
|
|
## API-Endpunkt {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/image-pad`
|
|
|
|
Akzeptiert Multipart-Formulardaten mit einer Bilddatei und einem JSON-Feld `settings`.
|
|
|
|
## Parameter {#parameters}
|
|
|
|
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
|
|-----------|------|----------|---------|-------------|
|
|
| target | string | Nein | `"1:1"` | Zielseitenverhältnis: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` oder `custom` |
|
|
| ratioW | integer | Nein | `1` | Benutzerdefinierte Verhältnisbreite (1-100, verwendet, wenn target `custom` ist) |
|
|
| ratioH | integer | Nein | `1` | Benutzerdefinierte Verhältnishöhe (1-100, verwendet, wenn target `custom` ist) |
|
|
| background | string | Nein | `"color"` | Hintergrundmodus: `color`, `transparent` oder `blur` |
|
|
| color | string | Nein | `"#ffffff"` | Hintergrund-Hexfarbe (wenn background `color` ist) |
|
|
| padding | integer | Nein | `0` | Zusätzlicher Innenabstand als Prozentsatz der Leinwand (0-50) |
|
|
|
|
## Beispielanfrage {#example-request}
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/image-pad \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg" \
|
|
-F 'settings={"target": "16:9", "background": "blur", "padding": 5}'
|
|
```
|
|
|
|
## Beispielantwort {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
|
|
"originalSize": 2450000,
|
|
"processedSize": 3100000
|
|
}
|
|
```
|
|
|
|
## Hinweise {#notes}
|
|
|
|
- Der Hintergrundmodus `blur` erzeugt eine unscharfe Kopie des Originalbilds als Füllung, was ein visuell stimmiges Ergebnis liefert.
|
|
- Bei Verwendung des Hintergrunds `transparent` wird die Ausgabe in PNG umgewandelt, um den Alphakanal zu erhalten.
|
|
- Das Ausgabeformat entspricht dem Eingabeformat, es sei denn, Transparenz ist beteiligt. HEIC-, RAW-, PSD- und SVG-Eingaben werden vor der Verarbeitung automatisch decodiert.
|
|
- Setzen Sie `target` auf `custom` und geben Sie `ratioW` und `ratioH` für beliebige Seitenverhältnisse an (z. B. `ratioW: 3, ratioH: 2` für 3:2).
|