Files
SnapOtter/apps/docs/nl/tools/image/content-aware-resize.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.9 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Formaatwijziging met seam carving die pixels toevoegt of verwijdert langs paden van laag belang om belangrijke inhoud en gezichten te behouden. f383b28ab62a human 30825642af92

Inhoudsbewuste formaatwijziging

Formaatwijziging met seam carving die op intelligente wijze pixels verwijdert of toevoegt langs paden met het minste visuele belang, waarbij belangrijke inhoud behouden blijft en gezichten optioneel worden beschermd.

API-eindpunt

POST /api/v1/tools/image/content-aware-resize

Verwerking: Synchroon (geeft het resultaat direct terug)

Modelbundel: Geen vereist voor de basisbewerking. Gezichtsbescherming gebruikt de bundel face-detection (200-300 MB) indien ingeschakeld.

Parameters

Parameter Type Vereist Standaard Beschrijving
file file Ja - Afbeeldingsbestand (multipart)
width number Nee - Doelbreedte in pixels
height number Nee - Doelhoogte in pixels
protectFaces boolean Nee false Detecteer en bescherm gezichten tegen seam-verwijdering
blurRadius number Nee 4 Voorverwerkings-vervagingsstraal voor de energieberekening (0-20)
sobelThreshold number Nee 2 Drempelwaarde voor Sobel-randdetectie (1-20). Hogere waarden maken het algoritme agressiever
square boolean Nee false Wijzig het formaat naar een vierkant (gebruikt de kleinste dimensie)

Er moet ten minste een van width, height of square worden opgegeven.

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
  -F "file=@landscape.jpg" \
  -F 'settings={"width":800,"protectFaces":true}'

Antwoord (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
  "originalSize": 450000,
  "processedSize": 380000,
  "width": 800,
  "height": 600
}

Opmerkingen

  • Deze aangepaste route geeft momenteel een synchroon 200-antwoord terug.
  • Gebruikt de seam-carving-bibliotheek caire voor inhoudsbewuste formaatwijziging.
  • Verkleint alleen afmetingen (verwijdert seams). Kan een afbeelding niet vergroten boven de oorspronkelijke grootte.
  • De optie protectFaces gebruikt AI-gezichtsdetectie om gezichtsgebieden als hoog-energetisch te markeren, zodat er geen seams door gezichten lopen.
  • blurRadius regelt de gladstrijking vóór de berekening van de energiekaart. Hogere waarden maken de energiekaart uniformer, wat kan helpen bij ruisrijke afbeeldingen.
  • sobelThreshold bepaalt hoe agressief randen worden gedetecteerd. Lagere waarden behouden meer subtiele randen.
  • De uitvoer is altijd in PNG-formaat.
  • Ondersteunt de invoerformaten HEIC/HEIF, RAW, TGA, PSD, EXR en HDR via automatische decodering.