Bilduppdelning

Dela en enda bild i rutnätsplattor efter antal kolumner/rader eller efter specifika pixeldimensioner. Returnerar ett ZIP-arkiv som innehåller alla plattor.

API Endpoint

POST /api/v1/tools/image/split

Parameters

Parameter	Type	Required	Default	Description
columns	integer	No	3	Antal kolumner att dela upp i (1 till 100)
rows	integer	No	3	Antal rader att dela upp i (1 till 100)
tileWidth	integer	No	-	Plattbredd i pixlar (min 10). Åsidosätter columns när både tileWidth och tileHeight är angivna.
tileHeight	integer	No	-	Platthöjd i pixlar (min 10). Åsidosätter rows när både tileWidth och tileHeight är angivna.
outputFormat	string	No	"original"	Utdataformat för plattor: original, png, jpg, webp, avif, jxl
quality	number	No	90	Utdatakvalitet för destruktiva format (1 till 100)

Example Request

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

Example Response

Svaret strömmas direkt som en ZIP-fil med Content-Type: application/zip. Filnamnet följer mönstret split-<jobId>.zip.

Varje platta inuti ZIP-filen namnges <originalBaseName>_r<row>_c<col>.<ext> (t.ex. photo_r1_c1.png, photo_r2_c3.webp).

Notes

• Tar emot en enda bildfil.
• Stöder indataformaten HEIC, RAW, PSD och SVG (avkodas automatiskt).
• När både tileWidth och tileHeight anges har de företräde framför columns/rows. Rutnätsdimensionerna beräknas som ceil(imageWidth / tileWidth) och ceil(imageHeight / tileHeight).
• Kantplattor (kolumnen längst till höger, understa raden) kan vara mindre än den angivna plattstorleken om bildens dimensioner inte är jämnt delbara.
• Maximal rutnätsstorlek är begränsad till 100x100 (10 000 plattor).
• Svaret strömmar ZIP-filen direkt, så det finns ingen JSON-svarskropp. Använd --output med curl för att spara filen.