Files
SnapOtter/apps/docs/nl/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.3 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Rasterafbeeldingen converteren naar SVG met zwart-wit (potrace) en volledige-kleur, meerlaagse vectorisatie. f3e4777188ad human d0f566482ccd

Afbeelding naar SVG

Vectoriseer rasterafbeeldingen naar SVG met traceeralgoritmen. Ondersteunt zwart-wittracering (potrace) en volledige-kleur, meerlaagse vectorisatie.

API Endpoint

POST /api/v1/tools/image/vectorize

Parameters

Parameter Type Vereist Standaard Beschrijving
colorMode string Nee "bw" Traceermodus: bw (zwart-wit) of color (meerkleurige lagen)
threshold number Nee 128 Helderheidsdrempel voor de zwart-witmodus (0 tot 255). Pixels daaronder worden zwart.
colorPrecision number Nee 6 Precisie van kleurkwantisatie voor de kleurmodus (1 tot 16). Hogere waarden produceren meer onderscheidende kleurlagen.
layerDifference number Nee 6 Minimaal kleurverschil tussen lagen in de kleurmodus (1 tot 128)
filterSpeckle number Nee 4 Minimale oppervlakte voor getraceerde vormen in pixels (1 tot 256). Verwijdert ruis/spikkels.
pathMode string Nee "spline" Padvergladding: none (gekarteld), polygon (rechte segmenten), spline (vloeiende curves)
cornerThreshold number Nee 60 Hoekdrempel voor hoekdetectie in de kleurmodus (0 tot 180 graden)
invert boolean Nee false De afbeelding vóór het traceren inverteren (zwart/wit omwisselen)

Voorbeeldverzoek

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"}'

Kleurvectorisatie

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}'

Voorbeeldrespons

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

Opmerkingen

  • De uitvoer is altijd een SVG-bestand, ongeacht het invoerformaat.
  • Ondersteunt HEIC-, RAW-, PSD- en SVG-invoerformaten (automatisch gedecodeerd naar raster vóór het traceren).
  • De zwart-witmodus gebruikt het potrace-algoritme. De afbeelding wordt eerst omgezet naar grijswaarden en vervolgens met een drempel gezet naar puur zwart/wit voordat er wordt getraceerd.
  • De kleurmodus gebruikt een meerlaagse aanpak: de afbeelding wordt gekwantiseerd in kleurlagen, elk apart getraceerd en gestapeld in de SVG-uitvoer.
  • Lagere filterSpeckle-waarden behouden meer detail, maar produceren grotere SVG-bestanden met meer paden.
  • De instelling pathMode heeft een aanzienlijke invloed op de bestandsgrootte: none produceert de meeste paden, spline produceert de vloeiendste (en meestal kleinste) uitvoer.
  • Gebruik voor de beste resultaten met logo's en pictogrammen de zwart-witmodus met een schone invoer met hoog contrast. Gebruik voor foto's of illustraties de kleurmodus met een hogere colorPrecision.