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

Files

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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Potong gambar dengan menentukan area menggunakan posisi dan dimensi.	aab38ccd7c53	human	9d19b11b1cf9

Potong

Potong gambar dengan mendefinisikan area persegi panjang menggunakan posisi dan ukuran. Mendukung satuan piksel dan persentase.

API Endpoint

POST /api/v1/tools/image/crop

Menerima data formulir multipart dengan file gambar dan field JSON settings.

Parameter

Parameter	Tipe	Wajib	Default	Deskripsi
left	number	Ya	-	Offset X area potong (dari tepi kiri)
top	number	Ya	-	Offset Y area potong (dari tepi atas)
width	number	Ya	-	Lebar area potong
height	number	Ya	-	Tinggi area potong
unit	string	Tidak	`"px"`	Satuan untuk nilai: `px` atau `percent`

Contoh Permintaan

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 100, "top": 50, "width": 800, "height": 600}'

Potong menggunakan nilai persentase:

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 10, "top": 10, "width": 80, "height": 80, "unit": "percent"}'

Contoh Respons

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 1200000
}

Catatan

Area potong harus berada di dalam batas gambar. Jika area melampaui gambar, permintaan akan gagal.
Saat menggunakan satuan percent, nilai merepresentasikan persentase dari dimensi gambar (mis. left: 10 berarti 10% dari tepi kiri).
Format output sesuai dengan format input.
Orientasi EXIF diterapkan otomatis sebelum pemotongan, sehingga koordinat sesuai dengan orientasi yang benar secara visual.

2.1 KiB Raw Blame History