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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Tekstwatermerken toevoegen met configureerbare positie, dekking, rotatie en tegelpatroon.	b80f12f410e4	human	b67e778f2041

Tekstwatermerk

Voeg een tekstwatermerkoverlay toe aan afbeeldingen. Ondersteunt enkele plaatsing in de hoeken/het midden of een herhaald tegelpatroon over de hele afbeelding, met configureerbare lettergrootte, kleur, dekking en rotatie.

API Endpoint

POST /api/v1/tools/image/watermark-text

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

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
text	string	Ja	-	Watermerktekst (1 tot 500 tekens)
fontSize	number	Nee	`48`	Lettergrootte in pixels (8 tot 1000)
color	string	Nee	`"#000000"`	Tekstkleur in hex-formaat (`#RRGGBB`)
opacity	number	Nee	`50`	Dekkingspercentage van de tekst (0 tot 100)
position	string	Nee	`"center"`	Plaatsing: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`, `tiled`
rotation	number	Nee	`0`	Rotatiehoek van de tekst in graden (-360 tot 360)

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/watermark-text \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"text": "SAMPLE", "fontSize": 64, "opacity": 30, "position": "center", "rotation": -30}'

Tegelwatermerk over de hele afbeelding:

curl -X POST http://localhost:1349/api/v1/tools/image/watermark-text \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"text": "DRAFT", "fontSize": 36, "opacity": 20, "position": "tiled", "rotation": -45}'

Voorbeeldrespons

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

Opmerkingen

Het watermerk wordt gerenderd als SVG-tekst en op de afbeelding samengesteld, met behoud van de uitvoerkwaliteit.
De tegelmodus verdeelt tekstelementen op basis van de lettergrootte (6x horizontale, 4x verticale tussenruimte), met een maximum van 500 elementen.
Voor hoekposities is de opvulling vanaf de rand gelijk aan de lettergrootte.
Het gebruikte lettertype is het standaard schreefloze lettertype van het systeem.
XML-speciale tekens in de tekst (&, <, >, ", ') worden veilig geëscaped.
Het uitvoerformaat komt overeen met het invoerformaat. HEIC-, RAW-, PSD- en SVG-invoer wordt automatisch gedecodeerd vóór verwerking.

2.7 KiB Raw Blame History