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
Ein Bild nach Zeilen und Spalten oder nach Pixelgröße in Rasterkacheln aufteilen, ausgegeben als ZIP-Archiv.	838f5fa791b0	human	b8740b8935b1

Bild aufteilen

Teilt ein einzelnes Bild nach Spalten-/Zeilenanzahl oder nach bestimmten Pixelmaßen in Rasterkacheln auf. Gibt ein ZIP-Archiv mit allen Kacheln zurück.

API-Endpunkt

POST /api/v1/tools/image/split

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
columns	integer	Nein	3	Anzahl der Spalten, in die aufgeteilt wird (1 bis 100)
rows	integer	Nein	3	Anzahl der Zeilen, in die aufgeteilt wird (1 bis 100)
tileWidth	integer	Nein	-	Kachelbreite in Pixeln (min. 10). Überschreibt `columns`, wenn sowohl `tileWidth` als auch `tileHeight` gesetzt sind.
tileHeight	integer	Nein	-	Kachelhöhe in Pixeln (min. 10). Überschreibt `rows`, wenn sowohl `tileWidth` als auch `tileHeight` gesetzt sind.
outputFormat	string	Nein	`"original"`	Ausgabeformat für Kacheln: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	Nein	90	Ausgabequalität für verlustbehaftete Formate (1 bis 100)

Beispielanfrage

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

Beispielantwort

Die Antwort wird direkt als ZIP-Datei mit Content-Type: application/zip gestreamt. Der Dateiname folgt dem Muster split-<jobId>.zip.

Jede Kachel innerhalb des ZIP-Archivs wird nach dem Schema <originalBaseName>_r<row>_c<col>.<ext> benannt (z. B. photo_r1_c1.png, photo_r2_c3.webp).

Hinweise

Nimmt eine einzelne Bilddatei entgegen.
Unterstützt HEIC-, RAW-, PSD- und SVG-Eingabeformate (automatisch dekodiert).
Wenn sowohl tileWidth als auch tileHeight angegeben sind, haben sie Vorrang vor columns/rows. Die Rasterabmessungen werden als ceil(imageWidth / tileWidth) und ceil(imageHeight / tileHeight) berechnet.
Randkacheln (rechte Spalte, untere Zeile) können kleiner als die angegebene Kachelgröße sein, wenn die Bildabmessungen nicht gleichmäßig teilbar sind.
Die maximale Rastergröße ist auf 100x100 (10.000 Kacheln) begrenzt.
Die Antwort streamt das ZIP direkt, es gibt also keinen JSON-Antworttext. Verwenden Sie --output mit curl, um die Datei zu speichern.

2.6 KiB Raw Blame History