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.
2.4 KiB
2.4 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Dela en bild i rutnätsplattor efter rader och kolumner eller efter pixelstorlek, returnerat som ett ZIP-arkiv. | 838f5fa791b0 | human | 59d8521bc5bc |
Dela bild
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 "file=@large-image.png" \
-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
tileWidthochtileHeightanges har de företräde framförcolumns/rows. Rutnätsdimensionerna beräknas somceil(imageWidth / tileWidth)ochceil(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
--outputmed curl för att spara filen.