Afbeelding Opsplitsen

Splits één afbeelding op in rastertegels op basis van het aantal kolommen/rijen of specifieke pixelafmetingen. Retourneert een ZIP-archief met alle tegels.

API Endpoint

POST /api/v1/tools/image/split

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
columns	integer	Nee	3	Aantal kolommen om in op te splitsen (1 tot 100)
rows	integer	Nee	3	Aantal rijen om in op te splitsen (1 tot 100)
tileWidth	integer	Nee	-	Tegelbreedte in pixels (min. 10). Overschrijft columns wanneer zowel tileWidth als tileHeight zijn ingesteld.
tileHeight	integer	Nee	-	Tegelhoogte in pixels (min. 10). Overschrijft rows wanneer zowel tileWidth als tileHeight zijn ingesteld.
outputFormat	string	Nee	"original"	Uitvoerformaat voor tegels: original, png, jpg, webp, avif, jxl
quality	number	Nee	90	Uitvoerkwaliteit voor lossy formaten (1 tot 100)

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/split \
  -F "[email protected]" \
  -F 'settings={"columns":3,"rows":3,"outputFormat":"png"}' \
  --output split-tiles.zip

Voorbeeldrespons

De respons wordt rechtstreeks gestreamd als een ZIP-bestand met Content-Type: application/zip. De bestandsnaam volgt het patroon split-<jobId>.zip.

Elke tegel in de ZIP heet <originalBaseName>_r<row>_c<col>.<ext> (bijv. photo_r1_c1.png, photo_r2_c3.webp).

Opmerkingen

• Accepteert één afbeeldingsbestand.
• Ondersteunt HEIC-, RAW-, PSD- en SVG-invoerformaten (automatisch gedecodeerd).
• Wanneer zowel tileWidth als tileHeight zijn opgegeven, krijgen deze voorrang boven columns/rows. De rasterafmetingen worden berekend als ceil(imageWidth / tileWidth) en ceil(imageHeight / tileHeight).
• Randtegels (meest rechtse kolom, onderste rij) kunnen kleiner zijn dan de opgegeven tegelgrootte als de afbeeldingsafmetingen niet gelijkmatig deelbaar zijn.
• De maximale rastergrootte is begrensd op 100x100 (10.000 tegels).
• De respons streamt de ZIP rechtstreeks, dus er is geen JSON-responsbody. Gebruik --output met curl om het bestand op te slaan.