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

3.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Superposez des images avec position, opacité et modes de fusion pour la composition.	c5d09eb13fde	human	922e2da126f7

Composition d'images

Superposez une image de recouvrement au-dessus d'une image de base avec une position, une opacité et un mode de fusion configurables. Utile pour composer des logos, des graphiques ou combiner plusieurs images.

API Endpoint

POST /api/v1/tools/image/compose

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

Parameters

Paramètre	Type	Requis	Défaut	Description
x	number	Non	`0`	Décalage horizontal du recouvrement par rapport au coin supérieur gauche en pixels (min 0)
y	number	Non	`0`	Décalage vertical du recouvrement par rapport au coin supérieur gauche en pixels (min 0)
opacity	number	Non	`100`	Pourcentage d'opacité du recouvrement (0 à 100)
blendMode	string	Non	`"over"`	Mode de fusion de composition

Blend Modes

Valeur	Description
`over`	Recouvrement normal (par défaut)
`multiply`	Assombrit en multipliant les valeurs des pixels
`screen`	Éclaircit en inversant, multipliant, puis inversant à nouveau
`overlay`	Combine multiply et screen selon la luminosité de la base
`darken`	Conserve le pixel le plus sombre de chaque calque
`lighten`	Conserve le pixel le plus clair de chaque calque
`hard-light`	Recouvrement à fort contraste
`soft-light`	Recouvrement à contraste subtil
`difference`	Différence absolue entre les calques
`exclusion`	Similaire à difference mais avec un contraste plus faible

File Fields

Nom du champ	Requis	Description
file	Oui	L'image de base/d'arrière-plan
overlay	Oui	L'image de recouvrement/de premier plan

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/compose \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@background.jpg" \
  -F "overlay=@graphic.png" \
  -F 'settings={"x": 100, "y": 50, "opacity": 80, "blendMode": "over"}'

Avec le mode de fusion multiply :

curl -X POST http://localhost:1349/api/v1/tools/image/compose \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F "overlay=@texture.jpg" \
  -F 'settings={"x": 0, "y": 0, "opacity": 50, "blendMode": "multiply"}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/background.jpg",
  "originalSize": 3200000,
  "processedSize": 3450000
}

Notes

Les deux images sont validées et décodées (HEIC, RAW, PSD, SVG pris en charge) avant la composition.
Le recouvrement est placé aux coordonnées exactes en pixels spécifiées par x et y. Il n'est pas redimensionné pour s'ajuster.
Si l'opacité est inférieure à 100, un masque alpha est appliqué au recouvrement avant la fusion.
Le recouvrement peut dépasser les limites de l'image de base (il sera rogné).
L'orientation EXIF est appliquée automatiquement sur les deux images avant le traitement.
Les dimensions de sortie correspondent aux dimensions de l'image de base.

3.5 KiB Raw Blame History