Files
SnapOtter/apps/docs/id/tools/image/split.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.5 KiB

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. 57a2e11e7cce human 8fcbdb41456e

Image Splitting

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.