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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Ajoute un effet de vignettage avec une force, une couleur et une position réglables.	0b9795fea2eb	human	1b6d502016c9

Vignettage

Ajoute un effet de vignettage qui assombrit ou teinte les bords d'une image. Prend en charge une force, une couleur, un rayon, une douceur, une rondeur et une position centrale réglables.

Point d'accès de l'API

POST /api/v1/tools/image/vignette

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

Paramètres

Paramètre	Type	Requis	Défaut	Description
strength	number	Non	`0.5`	Opacité du vignettage (0,1-1)
color	string	Non	`"#000000"`	Couleur hexadécimale du vignettage
radius	integer	Non	`70`	Rayon extérieur en pourcentage de la demi-diagonale (0-100)
softness	integer	Non	`50`	Douceur du dégradé (0-100) ; des valeurs plus élevées produisent un fondu plus progressif
roundness	integer	Non	`100`	Forme : 100 = cercle, 0 = ellipse correspondant au rapport d'aspect de l'image
centerX	integer	Non	`50`	Position horizontale du centre en pourcentage (0-100)
centerY	integer	Non	`50`	Position verticale du centre en pourcentage (0-100)

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/vignette \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"strength": 0.7, "radius": 60, "softness": 70}'

Exemple de réponse

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

Remarques

Un radius plus petit assombrit une plus grande partie de l'image ; un rayon plus grand confine le vignettage aux bords extrêmes.
Utilisez une color non noire (par exemple des tons blancs ou sépia) pour des effets de vignettage créatifs.
Ajuster centerX et centerY permet de positionner la zone claire hors du centre, ce qui est utile pour attirer l'attention sur un sujet qui ne se trouve pas au milieu du cadre.
Le format de sortie correspond au format d'entrée. Les entrées HEIC, RAW, PSD et SVG sont automatiquement décodées avant le traitement.

2.4 KiB Raw Blame History