Files
SnapOtter/apps/docs/nl/tools/image/vignette.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

2.3 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Een vignet-effect toevoegen met aanpasbare sterkte, kleur en positie. 0b9795fea2eb human ea25d8e3b2af

Vignet

Voeg een vignet-effect toe dat de randen van een afbeelding donkerder maakt of tint. Ondersteunt aanpasbare sterkte, kleur, radius, zachtheid, rondheid en middenpunt.

API Endpoint

POST /api/v1/tools/image/vignette

Accepteert multipart form data met een afbeeldingsbestand en een JSON-veld settings.

Parameters

Parameter Type Vereist Standaard Beschrijving
strength number Nee 0.5 Dekking van het vignet (0.1-1)
color string Nee "#000000" Hex-kleur van het vignet
radius integer Nee 70 Buitenradius als percentage van de halve diagonaal (0-100)
softness integer Nee 50 Verzachting van de rand (0-100); hogere waarden geven een geleidelijkere overgang
roundness integer Nee 100 Vorm: 100 = cirkel, 0 = ellips die overeenkomt met de beeldverhouding
centerX integer Nee 50 Horizontale middenpositie als percentage (0-100)
centerY integer Nee 50 Verticale middenpositie als percentage (0-100)

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/vignette \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"strength": 0.7, "radius": 60, "softness": 70}'

Voorbeeldrespons

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

Opmerkingen

  • Een kleinere radius maakt meer van de afbeelding donkerder; een grotere radius beperkt het vignet tot de uiterste randen.
  • Gebruik een niet-zwarte color (bijv. witte of sepiatinten) voor creatieve vignet-effecten.
  • Door centerX en centerY aan te passen, kun je het heldere gebied buiten het midden plaatsen, wat handig is om de aandacht te vestigen op een onderwerp dat niet in het midden van het beeld staat.
  • Het uitvoerformaat komt overeen met het invoerformaat. HEIC-, RAW-, PSD- en SVG-invoer wordt automatisch gedecodeerd vóór verwerking.