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 grid worden cellen op de mediane afmetingen van alle afbeeldingen geschaald.
• De cornerRadius wordt toegepast op de gehele uiteindelijke uitvoer, niet op individuele afbeeldingen.
• De canvasgrootte wordt begrensd door de serverconfiguratie MAX_CANVAS_PIXELS om geheugenuitputting te voorkomen.