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.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Membagi satu gambar menjadi petak-petak grid berdasarkan baris dan kolom atau berdasarkan ukuran piksel, dikembalikan sebagai arsip ZIP.	838f5fa791b0	human	8fcbdb41456e

Bagi Gambar

Membagi satu gambar menjadi petak-petak grid berdasarkan jumlah kolom/baris atau berdasarkan dimensi piksel tertentu. Mengembalikan arsip ZIP yang berisi semua petak.

API Endpoint

POST /api/v1/tools/image/split

Parameters

Parameter	Type	Required	Default	Description
columns	integer	No	3	Jumlah kolom untuk membagi (1 hingga 100)
rows	integer	No	3	Jumlah baris untuk membagi (1 hingga 100)
tileWidth	integer	No	-	Lebar petak dalam piksel (min 10). Menggantikan `columns` ketika `tileWidth` dan `tileHeight` keduanya diatur.
tileHeight	integer	No	-	Tinggi petak dalam piksel (min 10). Menggantikan `rows` ketika `tileWidth` dan `tileHeight` keduanya diatur.
outputFormat	string	No	`"original"`	Format keluaran untuk petak: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	No	90	Kualitas keluaran untuk format lossy (1 hingga 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

Responsnya dialirkan langsung sebagai file ZIP dengan Content-Type: application/zip. Nama file mengikuti pola split-<jobId>.zip.

Setiap petak di dalam ZIP diberi nama <originalBaseName>_r<row>_c<col>.<ext> (mis. photo_r1_c1.png, photo_r2_c3.webp).

Notes

Menerima satu file gambar.
Mendukung format masukan HEIC, RAW, PSD, dan SVG (otomatis didekode).
Ketika tileWidth dan tileHeight keduanya diberikan, keduanya diprioritaskan di atas columns/rows. Dimensi grid dihitung sebagai ceil(imageWidth / tileWidth) dan ceil(imageHeight / tileHeight).
Petak tepi (kolom paling kanan, baris bawah) mungkin lebih kecil dari ukuran petak yang ditentukan jika dimensi gambar tidak habis dibagi rata.
Ukuran grid maksimum dibatasi hingga 100x100 (10.000 petak).
Responsnya mengalirkan ZIP secara langsung, sehingga tidak ada body respons JSON. Gunakan --output dengan curl untuk menyimpan file.

2.5 KiB Raw Blame History