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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Lägg till textvattenstämplar med konfigurerbar position, opacitet, rotation och plattläggning.	b80f12f410e4	human	55fc2bbf30bd

Textvattenstämpel

Lägg till ett textvattenstämpelöverlägg på bilder. Stöder enkel placering i hörn/mitt eller plattlagd upprepning över hela bilden, med konfigurerbar teckenstorlek, färg, opacitet och rotation.

API Endpoint

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

Tar emot multipart-formulärdata med en bildfil och ett JSON-fält settings.

Parameters

Parameter	Type	Required	Default	Description
text	string	Yes	-	Vattenstämpeltext (1 till 500 tecken)
fontSize	number	No	`48`	Teckenstorlek i pixlar (8 till 1000)
color	string	No	`"#000000"`	Textfärg i hex-format (`#RRGGBB`)
opacity	number	No	`50`	Textopacitet i procent (0 till 100)
position	string	No	`"center"`	Placering: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`, `tiled`
rotation	number	No	`0`	Textrotationsvinkel i grader (-360 till 360)

Example Request

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}'

Plattlagd vattenstämpel över hela bilden:

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}'

Example Response

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

Notes

Vattenstämpeln renderas som SVG-text och komponeras på bilden, vilket bevarar utdatakvaliteten.
Plattlagt läge fördelar textelement baserat på teckenstorlek (6x horisontellt, 4x vertikalt mellanrum), begränsat till maximalt 500 element.
För hörnpositioner är utfyllnaden från kanten lika med teckenstorleken.
Teckensnittet som används är systemets standardteckensnitt utan seriffer.
XML-specialtecken i texten (&, <, >, ", ') escapas säkert.
Utdataformatet matchar indataformatet. HEIC, RAW, PSD och SVG-indata avkodas automatiskt före bearbetning.

2.6 KiB Raw Blame History