mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

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.

2026-07-15 21:55:51 +08:00

2.6 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Divide un'immagine in tessere a griglia per righe e colonne o per dimensione in pixel, restituite come archivio ZIP.	838f5fa791b0	human	1f01741aaff9

Dividi immagine

Divide una singola immagine in tessere a griglia per numero di colonne/righe o per dimensioni specifiche in pixel. Restituisce un archivio ZIP contenente tutte le tessere.

Endpoint API

POST /api/v1/tools/image/split

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
columns	integer	No	3	Numero di colonne in cui dividere (da 1 a 100)
rows	integer	No	3	Numero di righe in cui dividere (da 1 a 100)
tileWidth	integer	No	-	Larghezza della tessera in pixel (min 10). Sovrascrive `columns` quando sono impostati sia `tileWidth` sia `tileHeight`.
tileHeight	integer	No	-	Altezza della tessera in pixel (min 10). Sovrascrive `rows` quando sono impostati sia `tileWidth` sia `tileHeight`.
outputFormat	string	No	`"original"`	Formato di output per le tessere: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	No	90	Qualità dell'output per i formati con perdita (da 1 a 100)

Esempio di richiesta

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

Esempio di risposta

La risposta viene trasmessa direttamente come file ZIP con Content-Type: application/zip. Il nome del file segue lo schema split-<jobId>.zip.

Ogni tessera all'interno dello ZIP è denominata <originalBaseName>_r<row>_c<col>.<ext> (ad esempio photo_r1_c1.png, photo_r2_c3.webp).

Note

Accetta un singolo file immagine.
Supporta i formati di input HEIC, RAW, PSD e SVG (decodificati automaticamente).
Quando vengono forniti sia tileWidth sia tileHeight, hanno la priorità su columns/rows. Le dimensioni della griglia vengono calcolate come ceil(imageWidth / tileWidth) e ceil(imageHeight / tileHeight).
Le tessere di bordo (colonna più a destra, riga inferiore) possono essere più piccole della dimensione specificata se le dimensioni dell'immagine non sono divisibili in modo uniforme.
La dimensione massima della griglia è limitata a 100x100 (10.000 tessere).
La risposta trasmette lo ZIP direttamente, quindi non c'è un corpo di risposta JSON. Usa --output con curl per salvare il file.

2.6 KiB Raw Blame History