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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Tambahkan bingkai, padding, sudut membulat, dan bayangan jatuh ke gambar dalam urutan yang dapat diprediksi dan dikendalikan.	8845150736a9	human	5945278283d8

Bingkai & Frame

Tambahkan bingkai, padding, sudut membulat, dan bayangan jatuh ke gambar. Alat ini menerapkan efek dalam urutan: padding, bingkai, radius sudut, lalu bayangan.

API Endpoint

POST /api/v1/tools/image/border

Parameter

Parameter	Tipe	Wajib	Bawaan	Deskripsi
borderWidth	number	Tidak	10	Ketebalan bingkai dalam piksel (0 hingga 2000)
borderColor	string	Tidak	`"#000000"`	Warna bingkai sebagai hex (mis. `#FF0000`)
padding	number	Tidak	0	Padding dalam antara gambar dan bingkai dalam piksel (0 hingga 200)
paddingColor	string	Tidak	`"#FFFFFF"`	Warna isian padding sebagai hex
cornerRadius	number	Tidak	0	Radius sudut dalam piksel (0 hingga 2000)
shadow	boolean	Tidak	`false`	Apakah akan menambahkan bayangan jatuh
shadowBlur	number	Tidak	15	Radius blur bayangan (1 hingga 200)
shadowOffsetX	number	Tidak	0	Offset horizontal bayangan (-50 hingga 50)
shadowOffsetY	number	Tidak	5	Offset vertikal bayangan (-50 hingga 50)
shadowColor	string	Tidak	`"#000000"`	Warna bayangan sebagai hex
shadowOpacity	number	Tidak	40	Persentase opasitas bayangan (0 hingga 100)

Contoh Permintaan

curl -X POST http://localhost:1349/api/v1/tools/image/border \
  -F "file=@photo.jpg" \
  -F 'settings={"borderWidth":20,"borderColor":"#333333","cornerRadius":16,"shadow":true,"shadowBlur":25,"shadowOpacity":50}'

Contoh Respons

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.png",
  "originalSize": 456789,
  "processedSize": 523456
}

Catatan

Menggunakan factory createToolRoute standar. Menerima satu berkas gambar melalui unggahan multipart.
Mendukung format input HEIC, RAW, PSD, dan SVG (didekode secara otomatis).
Urutan pemrosesan: padding ditambahkan terlebih dahulu, lalu bingkai membungkus di sekelilingnya, lalu radius sudut diterapkan, lalu bayangan digabungkan.
Ketika cornerRadius atau shadow diaktifkan, keluaran dipaksa menjadi PNG (terlepas dari format input) untuk mempertahankan transparansi. Format yang mendukung alfa (PNG, WebP, AVIF) mempertahankan format aslinya.
Bayangan sadar bentuk: bayangan mengikuti sudut membulat alih-alih membuat bayangan persegi panjang.
Menetapkan borderWidth ke 0 dan hanya menggunakan cornerRadius + shadow menciptakan efek bayangan membulat tanpa bingkai.

2.8 KiB Raw Blame History