mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
65 lines
3.3 KiB
Markdown
65 lines
3.3 KiB
Markdown
---
|
|
description: "Rasterafbeeldingen converteren naar SVG met zwart-wit (potrace) en volledige-kleur, meerlaagse vectorisatie."
|
|
i18n_source_hash: f3e4777188ad
|
|
i18n_provenance: human
|
|
i18n_output_hash: d0f566482ccd
|
|
---
|
|
|
|
# Afbeelding naar SVG {#image-to-svg}
|
|
|
|
Vectoriseer rasterafbeeldingen naar SVG met traceeralgoritmen. Ondersteunt zwart-wittracering (potrace) en volledige-kleur, meerlaagse vectorisatie.
|
|
|
|
## API Endpoint {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/vectorize`
|
|
|
|
## Parameters {#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 {#example-request}
|
|
|
|
```bash
|
|
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 {#color-vectorization}
|
|
|
|
```bash
|
|
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 {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/logo.svg",
|
|
"originalSize": 45678,
|
|
"processedSize": 12345
|
|
}
|
|
```
|
|
|
|
## Opmerkingen {#notes}
|
|
|
|
- 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`.
|