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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Ajoute des bordures, des marges, des coins arrondis et des ombres portées aux images dans un ordre prévisible et contrôlable.	8845150736a9	human	ac03317786ec

Bordure et cadre

Ajoute des bordures, des marges, des coins arrondis et des ombres portées aux images. L'outil applique les effets dans l'ordre suivant : marge, bordure, rayon des coins, puis ombre.

Point de terminaison de l'API

POST /api/v1/tools/image/border

Paramètres

Paramètre	Type	Requis	Par défaut	Description
borderWidth	nombre	Non	10	Épaisseur de la bordure en pixels (0 à 2000)
borderColor	chaîne	Non	`"#000000"`	Couleur de la bordure en hex (par exemple `#FF0000`)
padding	nombre	Non	0	Marge intérieure entre l'image et la bordure en pixels (0 à 200)
paddingColor	chaîne	Non	`"#FFFFFF"`	Couleur de remplissage de la marge en hex
cornerRadius	nombre	Non	0	Rayon des coins en pixels (0 à 2000)
shadow	booléen	Non	`false`	Indique s'il faut ajouter une ombre portée
shadowBlur	nombre	Non	15	Rayon de flou de l'ombre (1 à 200)
shadowOffsetX	nombre	Non	0	Décalage horizontal de l'ombre (-50 à 50)
shadowOffsetY	nombre	Non	5	Décalage vertical de l'ombre (-50 à 50)
shadowColor	chaîne	Non	`"#000000"`	Couleur de l'ombre en hex
shadowOpacity	nombre	Non	40	Pourcentage d'opacité de l'ombre (0 à 100)

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/image/border \
  -F "file=@photo.jpg" \
  -F 'settings={"borderWidth":20,"borderColor":"#333333","cornerRadius":16,"shadow":true,"shadowBlur":25,"shadowOpacity":50}'

Exemple de réponse

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.png",
  "originalSize": 456789,
  "processedSize": 523456
}

Remarques

Utilise la fabrique standard createToolRoute. Accepte un seul fichier image via un téléversement multipart.
Prend en charge les formats d'entrée HEIC, RAW, PSD et SVG (décodés automatiquement).
Ordre de traitement : la marge est ajoutée en premier, puis la bordure l'entoure, puis le rayon des coins est appliqué, puis l'ombre est composée.
Lorsque cornerRadius ou shadow est activé, la sortie est forcée en PNG (quel que soit le format d'entrée) afin de préserver la transparence. Les formats prenant en charge la couche alpha (PNG, WebP, AVIF) conservent leur format d'origine.
L'ombre tient compte de la forme : elle suit les coins arrondis au lieu de créer une ombre rectangulaire.
Régler borderWidth sur 0 en n'utilisant que cornerRadius + shadow crée un effet d'ombre arrondie sans cadre.

2.9 KiB Raw Blame History