Files
SnapOtter/apps/docs/tr/tools/image/vectorize.md
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

3.4 KiB
Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Raster görüntüleri siyah-beyaz (potrace) ve tam renkli çok katmanlı vektörleştirme ile SVG'ye dönüştürün. f3e4777188ad human de604f654255

Görüntüden SVG'ye

İzleme algoritmaları kullanarak raster görüntüleri SVG'ye vektörleştirin. Siyah-beyaz izlemeyi (potrace) ve tam renkli çok katmanlı vektörleştirmeyi destekler.

API Uç Noktası

POST /api/v1/tools/image/vectorize

Parametreler

Parametre Tür Zorunlu Varsayılan Açıklama
colorMode string Hayır "bw" İzleme modu: bw (siyah ve beyaz) veya color (çok renkli katmanlar)
threshold number Hayır 128 S&B modu için parlaklık eşiği (0 ile 255 arası). Altındaki pikseller siyah olur.
colorPrecision number Hayır 6 Renk modu için renk niceleme hassasiyeti (1 ile 16 arası). Daha yüksek değerler daha belirgin renk katmanları üretir.
layerDifference number Hayır 6 Renk modunda katmanlar arası minimum renk farkı (1 ile 128 arası)
filterSpeckle number Hayır 4 Piksel cinsinden izlenen şekiller için minimum alan (1 ile 256 arası). Gürültü/lekeleri kaldırır.
pathMode string Hayır "spline" Yol yumuşatma: none (pürüzlü), polygon (düz segmentler), spline (yumuşak eğriler)
cornerThreshold number Hayır 60 Renk modunda köşe algılama için açı eşiği (0 ile 180 derece arası)
invert boolean Hayır false İzlemeden önce görüntüyü tersine çevir (siyah/beyazı değiştir)

Örnek İstek

curl -X POST http://localhost:1349/api/v1/tools/image/vectorize \
  -F "file=@logo.png" \
  -F 'settings={"colorMode":"bw","threshold":128,"filterSpeckle":4,"pathMode":"spline"}'

Renkli Vektörleştirme

curl -X POST http://localhost:1349/api/v1/tools/image/vectorize \
  -F "file=@illustration.png" \
  -F 'settings={"colorMode":"color","colorPrecision":8,"layerDifference":6,"filterSpeckle":4}'

Örnek Yanıt

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/logo.svg",
  "originalSize": 45678,
  "processedSize": 12345
}

Notlar

  • Giriş biçiminden bağımsız olarak çıktı her zaman bir SVG dosyasıdır.
  • HEIC, RAW, PSD ve SVG giriş biçimlerini destekler (izlemeden önce otomatik olarak raster'a çözülür).
  • S&B modu potrace algoritmasını kullanır. Görüntü önce gri tonlamaya dönüştürülür, ardından izlemeden önce saf siyah/beyaza eşiklenir.
  • Renk modu çok katmanlı bir yaklaşım kullanır: görüntü renk katmanlarına nicelenir, her biri ayrı ayrı izlenir ve SVG çıktısında üst üste yığılır.
  • Daha düşük filterSpeckle değerleri daha fazla ayrıntıyı korur ancak daha fazla yollu daha büyük SVG dosyaları üretir.
  • pathMode ayarı dosya boyutunu önemli ölçüde etkiler: none en fazla yolu üretir, spline en yumuşak (ve genellikle en küçük) çıktıyı üretir.
  • Logolar ve simgeler için en iyi sonuçlar için, temiz ve yüksek kontrastlı bir girdiyle S&B modunu kullanın. Fotoğraflar veya illüstrasyonlar için daha yüksek colorPrecision ile renk modunu kullanın.