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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Bir görseli, köşeleri saydam olacak şekilde ortalanmış bir daireye kırpın.	06c50ccd96b2	human	c9ea430aab8c

Daire Kırpma

Bir görseli, köşeleri saydam olacak şekilde ortalanmış bir daireye kırpın. Ayarlanabilir yakınlaştırma, konum kayması, kenarlık ve çıktı boyutunu destekler.

API Uç Noktası

POST /api/v1/tools/image/circle-crop

Bir görsel dosyası ve bir JSON settings alanı içeren multipart form verisi kabul eder.

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
zoom	sayı	Hayır	`1`	Yakınlaştırma faktörü (1-5); daha yüksek değerler daha sıkı kırpar
offsetX	sayı	Hayır	`0.5`	Yatay merkez konumu (0-1)
offsetY	sayı	Hayır	`0.5`	Dikey merkez konumu (0-1)
borderWidth	tam sayı	Hayır	`0`	Piksel cinsinden kenarlık genişliği (0-200)
borderColor	dize	Hayır	`"#ffffff"`	Onaltılık kenarlık rengi
background	dize	Hayır	`"transparent"`	Köşe doldurma: `"transparent"` veya bir onaltılık renk
outputSize	tam sayı	Hayır	-	Piksel cinsinden nihai kare boyutu (16-4096)

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/circle-crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"zoom": 1.2, "borderWidth": 4, "borderColor": "#333333"}'

Örnek Yanıt

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

Notlar

Saydam köşeleri korumak için çıktı her zaman PNG'dir (background düz bir renge ayarlanmadıkça).
Daire, görselin kısa kenarına yazılır. Daha sıkı kırpmak için zoom, görünür alanı kaydırmak için offsetX/offsetY kullanın.
outputSize sağlandığında, sonuç kırpmanın ardından bu kare boyutuna yeniden boyutlandırılır.
HEIC, RAW, PSD ve SVG girişleri işlenmeden önce otomatik olarak çözülür.

2.2 KiB Raw Blame History Unescape Escape