mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

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.2 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Snijd een afbeelding bij tot een gecentreerde cirkel met transparante hoeken.	06c50ccd96b2	human	96e61f0578d1

Cirkelvormig bijsnijden

Snijd een afbeelding bij tot een gecentreerde cirkel met transparante hoeken. Ondersteunt instelbare zoom, verschuiving, rand en uitvoergrootte.

API-endpoint

POST /api/v1/tools/image/circle-crop

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

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
zoom	number	Nee	`1`	Zoomfactor (1-5); hogere waarden snijden strakker bij
offsetX	number	Nee	`0.5`	Horizontale middenpositie (0-1)
offsetY	number	Nee	`0.5`	Verticale middenpositie (0-1)
borderWidth	integer	Nee	`0`	Randbreedte in pixels (0-200)
borderColor	string	Nee	`"#ffffff"`	Hex-kleur van de rand
background	string	Nee	`"transparent"`	Hoekopvulling: `"transparent"` of een hex-kleur
outputSize	integer	Nee	-	Uiteindelijke vierkante afmeting in pixels (16-4096)

Voorbeeldaanvraag

curl -X POST http://localhost:1349/api/v1/tools/image/circle-crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"zoom": 1.2, "borderWidth": 4, "borderColor": "#333333"}'

Voorbeeldantwoord

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

Opmerkingen

De uitvoer is altijd PNG om de transparante hoeken te behouden (tenzij background is ingesteld op een effen kleur).
De cirkel wordt ingeschreven binnen de kortste afmeting van de afbeelding. Gebruik zoom om strakker bij te snijden en offsetX/offsetY om het zichtbare gebied te verschuiven.
Wanneer outputSize is opgegeven, wordt het resultaat na het bijsnijden naar die vierkante afmeting geschaald.
HEIC-, RAW-, PSD- en SVG-invoer wordt automatisch gedecodeerd vóór de verwerking.

2.2 KiB Raw Blame History