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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Накладення логотипа чи зображення як водяного знака з налаштовуваним положенням, непрозорістю та масштабом.	c73ab0ef8ab9	human	c977242e2b89

Водяний знак зображенням

Накладіть логотип чи вторинне зображення як водяний знак на базове зображення. Водяний знак масштабується відносно ширини базового зображення та розміщується в кутку або центрі.

Кінцева точка API

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

Приймає багаточастинні дані форми з двома файлами зображень та полем JSON settings.

Параметри

Параметр	Тип	Обов’язковий	За замовчуванням	Опис
position	string	Ні	`"bottom-right"`	Розміщення водяного знака: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`
opacity	number	Ні	`50`	Відсоток непрозорості водяного знака (від 0 до 100)
scale	number	Ні	`25`	Ширина водяного знака як відсоток ширини основного зображення (від 1 до 100)

Поля файлів

Ім’я поля	Обов’язкове	Опис
file	Так	Основне/базове зображення
watermark	Так	Зображення водяного знака/логотипа

Приклад запиту

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

Приклад відповіді

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

Примітки

Обидва зображення перевіряються та декодуються (підтримуються HEIC, RAW, PSD, SVG).
Водяний знак масштабується пропорційно, тож його ширина дорівнює scale% ширини основного зображення.
Непрозорість застосовується через альфа-маску, скомпоновану зі змішуванням dest-in.
Кутові положення використовують відступ 20px від краю зображення.
Якщо зображення водяного знака має прозорість (напр., PNG-логотип), вона зберігається під час компонування.
Орієнтація EXIF автоматично застосовується до обох зображень перед обробкою.

3.4 KiB Raw Blame History