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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Додавання ефекту віньєтки з регульованою силою, кольором та положенням.	0b9795fea2eb	human	be0b7728c13c

Віньєтка

Додайте ефект віньєтки, що затемнює або тонує краї зображення. Підтримує регульовані силу, колір, радіус, м’якість, округлість та положення центру.

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

POST /api/v1/tools/image/vignette

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

Параметри

Параметр	Тип	Обов’язковий	За замовчуванням	Опис
strength	number	Ні	`0.5`	Непрозорість віньєтки (0.1-1)
color	string	Ні	`"#000000"`	Шістнадцятковий колір віньєтки
radius	integer	Ні	`70`	Зовнішній радіус як відсоток половини діагоналі (0-100)
softness	integer	Ні	`50`	М’якість розтушовування (0-100); вищі значення дають більш поступове згасання
roundness	integer	Ні	`100`	Форма: 100 = коло, 0 = еліпс відповідно до співвідношення сторін зображення
centerX	integer	Ні	`50`	Горизонтальне положення центру у відсотках (0-100)
centerY	integer	Ні	`50`	Вертикальне положення центру у відсотках (0-100)

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

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

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

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

Примітки

Менший radius затемнює більшу частину зображення; більший радіус обмежує віньєтку крайніми краями.
Використовуйте нечорний color (напр., білий або сепію) для творчих ефектів віньєтки.
Регулювання centerX та centerY дозволяє розмістити чисту ділянку зі зміщенням від центру, що корисно для привернення уваги до об’єкта, який не в центрі кадру.
Формат виводу відповідає формату вводу. Вхідні файли HEIC, RAW, PSD та SVG автоматично декодуються перед обробкою.

3.2 KiB Raw Blame History