mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
|
---
|
||
|
|
description: "Dela en bild i rutnätsplattor efter rader och kolumner eller efter pixelstorlek, returnerat som ett ZIP-arkiv."
|
||
|
|
i18n_source_hash: 57a2e11e7cce
|
||
|
|
i18n_provenance: human
|
||
|
|
i18n_output_hash: 59d8521bc5bc
|
||
|
|
---
|
||
|
|
|
||
|
|
# Bilduppdelning {#image-splitting}
|
||
|
|
|
||
|
|
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 {#api-endpoint}
|
||
|
|
|
||
|
|
`POST /api/v1/tools/image/split`
|
||
|
|
|
||
|
|
## Parameters {#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 {#example-request}
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/split \
|
||
|
|
-F "file=@large-image.png" \
|
||
|
|
-F 'settings={"columns":3,"rows":3,"outputFormat":"png"}' \
|
||
|
|
--output split-tiles.zip
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example Response {#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 {#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.
|