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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Pengubahan ukuran seam-carving yang menambah atau menghapus piksel di sepanjang jalur berkepentingan rendah untuk mempertahankan konten kunci dan wajah.	f383b28ab62a	human	3f4e4fe5b1bb

Pengubahan Ukuran Sadar-Konten

Pengubahan ukuran seam carving yang secara cerdas menghapus atau menambahkan piksel di sepanjang jalur dengan kepentingan visual paling rendah, mempertahankan konten penting dan secara opsional melindungi wajah.

API Endpoint

POST /api/v1/tools/image/content-aware-resize

Pemrosesan: Sinkron (mengembalikan hasil secara langsung)

Model bundle: Tidak diperlukan untuk operasi dasar. Perlindungan wajah menggunakan bundle face-detection (200-300 MB) jika diaktifkan.

Parameter

Parameter	Tipe	Wajib	Default	Deskripsi
file	file	Ya	-	File gambar (multipart)
width	number	Tidak	-	Lebar target dalam piksel
height	number	Tidak	-	Tinggi target dalam piksel
protectFaces	boolean	Tidak	`false`	Deteksi dan lindungi wajah dari penghapusan seam
blurRadius	number	Tidak	`4`	Radius blur pra-pemrosesan untuk perhitungan energi (0-20)
sobelThreshold	number	Tidak	`2`	Ambang batas deteksi tepi Sobel (1-20). Nilai lebih tinggi membuat algoritma lebih agresif
square	boolean	Tidak	`false`	Ubah ukuran menjadi persegi (menggunakan dimensi yang lebih kecil)

Setidaknya salah satu dari width, height, atau square harus ditentukan.

Contoh Permintaan

curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
  -F "file=@landscape.jpg" \
  -F 'settings={"width":800,"protectFaces":true}'

Respons (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
  "originalSize": 450000,
  "processedSize": 380000,
  "width": 800,
  "height": 600
}

Catatan

Rute kustom ini saat ini mengembalikan respons 200 sinkron.
Menggunakan pustaka seam carving caire untuk pengubahan ukuran sadar-konten.
Hanya mengurangi dimensi (menghapus seam). Tidak dapat memperluas gambar melampaui ukuran aslinya.
Opsi protectFaces menggunakan deteksi wajah AI untuk menandai area wajah sebagai berenergi tinggi, mencegah seam melewati wajah.
blurRadius mengontrol penghalusan sebelum perhitungan peta energi. Nilai lebih tinggi membuat peta energi lebih seragam, yang dapat membantu pada gambar berderau.
sobelThreshold memengaruhi seberapa agresif tepi dideteksi. Nilai lebih rendah mempertahankan lebih banyak tepi halus.
Output selalu berformat PNG.
Mendukung format input HEIC/HEIF, RAW, TGA, PSD, EXR, dan HDR melalui dekode otomatis.

2.9 KiB Raw Blame History