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
Görselleri piksel, yüzde veya sığdırma modlarıyla yeniden boyutlandırın.	00d1bffa4d38	human	f5e1119e470e

Yeniden Boyutlandır

Görselleri tam piksel boyutları, bir yüzde ölçek katsayısı veya görselin hedef boyutlara nasıl uyum sağlayacağını denetleyen bir sığdırma modu belirterek yeniden boyutlandırın.

API Uç Noktası

POST /api/v1/tools/image/resize

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

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
width	integer	Hayır	-	Piksel cinsinden hedef genişlik (en fazla 16383)
height	integer	Hayır	-	Piksel cinsinden hedef yükseklik (en fazla 16383)
fit	string	Hayır	`"contain"`	Görselin boyutlara nasıl sığdığı: `contain`, `cover`, `fill`, `inside`, `outside`
withoutEnlargement	boolean	Hayır	`false`	Görsel hedeften küçükse büyütmeyi önle
percentage	number	Hayır	-	Yüzdeye göre ölçekle (örn. yarı boyut için 50)

width, height veya percentage değerlerinden en az biri sağlanmalıdır.

Sığdırma Modları

contain - En boy oranını koruyarak boyutlara sığacak şekilde yeniden boyutlandırır (boş alan bırakabilir)
cover - En boy oranını koruyarak boyutları kaplayacak şekilde yeniden boyutlandırır (kırpabilir)
fill - Boyutlara tam olarak eşleşecek şekilde uzatır (en boy oranını göz ardı eder)
inside - contain gibidir, ancak yalnızca küçültür, asla büyütmez
outside - cover gibidir, ancak yalnızca küçültür, asla büyütmez

Örnek İstek

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

Yüzdeye göre yeniden boyutlandır:

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"percentage": 50}'

Örnek Yanıt

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

Notlar

Her iki eksende de maksimum boyut 16383 pikseldir (Sharp/libvips sınırı).
Çıktı biçimi girdi biçimiyle eşleşir. HEIC, RAW, PSD ve SVG girdileri işlemden önce otomatik olarak çözülür.
Yeniden boyutlandırmadan önce EXIF yönlendirmesi otomatik olarak uygulanır.
withoutEnlargement bayrağı, bazı görsellerin zaten hedeften küçük olabileceği toplu işleme için kullanışlıdır.

2.9 KiB Raw Blame History Unescape Escape