mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
3.0 KiB
3.0 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| Önemli içeriği ve yüzleri korumak için düşük önem taşıyan yollar boyunca piksel ekleyen veya kaldıran dikiş oyma yeniden boyutlandırma. | f383b28ab62a | human | e9a902a6bd97 |
İçerik Duyarlı Yeniden Boyutlandırma
En az görsel öneme sahip yollar boyunca pikselleri akıllıca kaldıran veya ekleyen, önemli içeriği koruyan ve isteğe bağlı olarak yüzleri koruyan dikiş oyma yeniden boyutlandırma.
API Uç Noktası
POST /api/v1/tools/image/content-aware-resize
İşleme: Eşzamanlı (sonucu doğrudan döndürür)
Model paketi: Temel işlem için gerekmez. Yüz koruması, etkinleştirilirse face-detection paketini (200-300 MB) kullanır.
Parametreler
| Parametre | Tür | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|---|
| file | file | Evet | - | Görüntü dosyası (çok parçalı) |
| width | number | Hayır | - | Piksel cinsinden hedef genişlik |
| height | number | Hayır | - | Piksel cinsinden hedef yükseklik |
| protectFaces | boolean | Hayır | false |
Yüzleri algıla ve dikiş kaldırmadan koru |
| blurRadius | number | Hayır | 4 |
Enerji hesaplaması için ön işleme bulanıklık yarıçapı (0-20) |
| sobelThreshold | number | Hayır | 2 |
Sobel kenar algılama eşiği (1-20). Daha yüksek değerler algoritmayı daha agresif yapar |
| square | boolean | Hayır | false |
Kareye yeniden boyutlandır (daha küçük boyutu kullanır) |
width, height veya square değerlerinden en az biri belirtilmelidir.
Örnek İstek
curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
-F "file=@landscape.jpg" \
-F 'settings={"width":800,"protectFaces":true}'
Yanıt (200 OK)
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
"originalSize": 450000,
"processedSize": 380000,
"width": 800,
"height": 600
}
Notlar
- Bu özel rota şu anda eşzamanlı bir 200 yanıtı döndürür.
- İçerik duyarlı yeniden boyutlandırma için
cairedikiş oyma kitaplığını kullanır. - Yalnızca boyutları küçültür (dikişleri kaldırır). Bir görüntüyü orijinal boyutunun ötesine genişletemez.
protectFacesseçeneği, yüz bölgelerini yüksek enerjili olarak işaretlemek için AI yüz algılamasını kullanır ve dikişlerin yüzlerden geçmesini önler.blurRadius, enerji haritası hesaplamasından önce düzeltmeyi denetler. Daha yüksek değerler enerji haritasını daha eşit hale getirir, bu da gürültülü görüntülere yardımcı olabilir.sobelThreshold, kenarların ne kadar agresif algılandığını etkiler. Daha düşük değerler daha ince kenarları korur.- Çıktı her zaman PNG biçimindedir.
- Otomatik çözme yoluyla HEIC/HEIF, RAW, TGA, PSD, EXR ve HDR giriş biçimlerini destekler.