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

4.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Toplu destekle SVG dosyalarını özel çözünürlük ve DPI'da PNG, JPEG, WebP, AVIF, TIFF, GIF, HEIF veya JXL'ye dönüştürün.	cf36830f8797	human	e2a4a485f4b4

SVG'den Raster'a

SVG dosyalarını özel çözünürlük ve DPI'da raster görüntü biçimlerine (PNG, JPEG, WebP, AVIF, TIFF, GIF, HEIF veya JXL) dönüştürün. Ayrıca birden fazla SVG'nin toplu dönüştürülmesini de destekler.

API Uç Noktası

POST /api/v1/tools/image/svg-to-raster

Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
width	integer	Hayır	-	Piksel cinsinden hedef genişlik (1 ile 65536 arası). Yalnızca bir boyut ayarlanırsa en-boy oranını korur.
height	integer	Hayır	-	Piksel cinsinden hedef yükseklik (1 ile 65536 arası). Yalnızca bir boyut ayarlanırsa en-boy oranını korur.
dpi	integer	Hayır	300	Render DPI'ı, temel rasterleştirme yoğunluğunu denetler (36 ile 2400 arası)
quality	number	Hayır	90	Kayıplı biçimler için çıktı kalitesi (1 ile 100 arası)
backgroundColor	string	Hayır	`"#00000000"`	Hex olarak arka plan rengi (6 veya 8 karakter, 8 karakter alfa içerir)
outputFormat	string	Hayır	`"png"`	Çıktı biçimi: `png`, `jpg`, `webp`, `avif`, `tiff`, `gif`, `heif`, `jxl`

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/svg-to-raster \
  -F "file=@logo.svg" \
  -F 'settings={"width":1024,"dpi":300,"outputFormat":"png","backgroundColor":"#FFFFFF"}'

Örnek Yanıt

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/logo.png",
  "previewUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/preview.webp",
  "originalSize": 12345,
  "processedSize": 67890
}

Toplu Uç Nokta

POST /api/v1/tools/image/svg-to-raster/batch

Tek bir istekte birden fazla SVG dosyasını dönüştürün. Bir ZIP arşivi döndürür.

Ek Toplu Parametreler

Parametre	Tür	Zorunlu	Varsayılan	Açıklama
clientJobId	string	Hayır	-	İlerleme takibi için isteğe bağlı istemci tarafından sağlanan iş kimliği (maks 128 karakter)

Toplu Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/svg-to-raster/batch \
  -F "file=@icon1.svg" \
  -F "file=@icon2.svg" \
  -F "file=@icon3.svg" \
  -F 'settings={"width":512,"outputFormat":"png","dpi":150}'

Toplu Yanıt

Toplu uç nokta, bir ZIP dosyasını doğrudan şu başlıklarla aktarır:

Content-Type: application/zip
X-Job-Id: <jobId>
X-File-Results: <url-encoded JSON mapping of index to filename>

Notlar

Yalnızca SVG ve SVGZ dosyalarını kabul eder (yalnızca uzantıyı değil içeriği doğrular). SVGZ otomatik olarak açılır.
SVG içeriği, XSS ve harici kaynak yüklemeyi önlemek için render edilmeden önce temizlenir.
dpi ayarı, SVG'nin rasterleştirildiği yoğunluğu denetler. Daha yüksek DPI, aynı SVG görüntüleme alanından daha büyük piksel boyutları üretir.
Hem width hem height sağlandığında, görüntü fit: inside kullanılarak yeniden boyutlandırılır (sınırlar içinde en-boy oranını korur).
Tarayıcıların yerel olarak görüntüleyemediği biçimler (TIFF, HEIF) için yanıta bir previewUrl dahil edilir. Önizleme, 1200px WebP küçük resmidir.
Varsayılan arka plan #00000000 tamamen saydamdır. Beyaz arka plan için #FFFFFF olarak ayarlayın (saydamlığı desteklemeyen JPEG çıktısıyla kullanışlıdır).
Toplu işleme, MAX_BATCH_SIZE sunucu yapılandırmasına uyar ve performans için eşzamanlı işçiler kullanır.
Toplu işlemlerin ilerlemesi, /api/v1/jobs/:jobId/progress üzerinde SSE aracılığıyla takip edilebilir.

4.1 KiB Raw Blame History Unescape Escape