mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
3.0 KiB
3.0 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Afbeeldingen naast elkaar, gestapeld of in een raster samenvoegen, met controle over uitlijning, tussenruimtes, randen en schaalmodus. | 670c5cc944b1 | human | 20f87ea80878 |
Afbeeldingen samenvoegen
Voeg meerdere afbeeldingen naast elkaar, verticaal gestapeld of gerangschikt in een raster samen. Ondersteunt uitlijning, tussenruimte, rand, hoekradius en meerdere schaalmodi.
API Endpoint
POST /api/v1/tools/image/stitch
Parameters
| Parameter | Type | Vereist | Standaard | Beschrijving |
|---|---|---|---|---|
| direction | string | Nee | "horizontal" |
Lay-outrichting: horizontal, vertical, grid |
| gridColumns | integer | Nee | 2 | Aantal kolommen wanneer de richting grid is (2 tot 100) |
| resizeMode | string | Nee | "fit" |
Hoe afbeeldingen worden geschaald: fit, original, stretch, crop |
| alignment | string | Nee | "center" |
Uitlijning op de dwarsas: start, center, end |
| gap | number | Nee | 0 | Tussenruimte tussen afbeeldingen in pixels (0 tot 1000) |
| border | number | Nee | 0 | Breedte van de buitenrand in pixels (0 tot 500) |
| cornerRadius | number | Nee | 0 | Hoekradius toegepast op de uiteindelijke uitvoer (0 tot 500) |
| backgroundColor | string | Nee | "#FFFFFF" |
Achtergrond-/randkleur als hex (bijv. #FF0000) |
| format | string | Nee | "png" |
Uitvoerformaat: png, jpeg, webp, avif, jxl |
| quality | number | Nee | 90 | Uitvoerkwaliteit (1 tot 100) |
Voorbeeldverzoek
curl -X POST http://localhost:1349/api/v1/tools/image/stitch \
-F "file=@image1.png" \
-F "file=@image2.png" \
-F "file=@image3.png" \
-F 'settings={"direction":"horizontal","resizeMode":"fit","gap":10,"backgroundColor":"#FFFFFF","format":"png"}'
Voorbeeldrespons
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stitch.png",
"originalSize": 1234567,
"processedSize": 987654
}
Opmerkingen
- Vereist ten minste 2 afbeeldingen. Upload meerdere afbeeldingsbestanden in het multipart-verzoek.
- Ondersteunt HEIC-, RAW-, PSD- en SVG-invoerformaten (automatisch gedecodeerd).
- Schaalmodi:
fit- Schaal afbeeldingen zodat ze overeenkomen met de kleinste afmeting langs de samenvoegas.original- Behoud de oorspronkelijke afmetingen (kan ongelijke randen opleveren).stretch- Dwing afbeeldingen om overeen te komen met de kleinste afmeting zonder de beeldverhouding te behouden.crop- Snijd afbeeldingen dekkend bij om overeen te komen met de kleinste afmeting.
- In de modus
gridworden cellen op de mediane afmetingen van alle afbeeldingen geschaald. - De
cornerRadiuswordt toegepast op de gehele uiteindelijke uitvoer, niet op individuele afbeeldingen. - De canvasgrootte wordt begrensd door de serverconfiguratie
MAX_CANVAS_PIXELSom geheugenuitputting te voorkomen.