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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Superpose un logo ou une image comme filigrane avec une position, une opacité et une échelle configurables.	c73ab0ef8ab9	human	d1aa84c44012

Filigrane image

Superpose un logo ou une image secondaire comme filigrane sur une image de base. Le filigrane est mis à l'échelle par rapport à la largeur de l'image de base et positionné dans un coin ou au centre.

Point d'accès de l'API

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

Accepte des données de formulaire multipart avec deux fichiers image et un champ JSON settings.

Paramètres

Paramètre	Type	Requis	Défaut	Description
position	string	Non	`"bottom-right"`	Placement du filigrane : `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`
opacity	number	Non	`50`	Pourcentage d'opacité du filigrane (0 à 100)
scale	number	Non	`25`	Largeur du filigrane en pourcentage de la largeur de l'image principale (1 à 100)

Champs de fichier

Nom du champ	Requis	Description
file	Oui	L'image principale/de base
watermark	Oui	L'image du filigrane/logo

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/watermark-image \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F "watermark=@logo.png" \
  -F 'settings={"position": "bottom-right", "opacity": 60, "scale": 20}'

Exemple de réponse

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

Remarques

Les deux images sont validées et décodées (HEIC, RAW, PSD, SVG pris en charge).
Le filigrane est redimensionné proportionnellement afin que sa largeur soit égale à scale % de la largeur de l'image principale.
L'opacité est appliquée via un masque alpha composité avec un mélange dest-in.
Les positions dans les coins utilisent une marge de 20 px par rapport au bord de l'image.
Si l'image du filigrane comporte de la transparence (par exemple un logo PNG), celle-ci est préservée lors de la composition.
L'orientation EXIF est appliquée automatiquement sur les deux images avant le traitement.

2.5 KiB Raw Blame History