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
Añade marcas de agua de texto con posición, opacidad, rotación y mosaico configurables.	b80f12f410e4	human	8e4c47f60543

Marca de agua de texto

Añade una superposición de marca de agua de texto a las imágenes. Admite una única colocación en las esquinas/centro o una repetición en mosaico por toda la imagen, con tamaño de fuente, color, opacidad y rotación configurables.

API Endpoint

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

Acepta datos de formulario multipart con un archivo de imagen y un campo settings en JSON.

Parámetros

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
text	string	Sí	-	Texto de la marca de agua (1 a 500 caracteres)
fontSize	number	No	`48`	Tamaño de fuente en píxeles (8 a 1000)
color	string	No	`"#000000"`	Color del texto en formato hexadecimal (`#RRGGBB`)
opacity	number	No	`50`	Porcentaje de opacidad del texto (0 a 100)
position	string	No	`"center"`	Ubicación: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`, `tiled`
rotation	number	No	`0`	Ángulo de rotación del texto en grados (-360 a 360)

Ejemplo de solicitud

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

Marca de agua en mosaico por toda la imagen:

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

Ejemplo de respuesta

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

Notas

La marca de agua se renderiza como texto SVG y se compone sobre la imagen, conservando la calidad de salida.
El modo en mosaico espacia los elementos de texto según el tamaño de fuente (6x de espaciado horizontal, 4x de espaciado vertical), con un límite máximo de 500 elementos.
Para las posiciones en las esquinas, el relleno desde el borde es igual al tamaño de fuente.
La fuente utilizada es la fuente sans-serif predeterminada del sistema.
Los caracteres especiales de XML en el texto (&, <, >, ", ') se escapan de forma segura.
El formato de salida coincide con el formato de entrada. Las entradas HEIC, RAW, PSD y SVG se decodifican automáticamente antes del procesamiento.

2.9 KiB Raw Blame History