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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Dodaj efekt winiety z regulowaną siłą, kolorem i pozycją.	0b9795fea2eb	human	94c41fb69c7e

Winieta

Dodaj efekt winiety, który przyciemnia lub zabarwia krawędzie obrazu. Obsługuje regulowaną siłę, kolor, promień, miękkość, zaokrąglenie i pozycję środka.

Punkt końcowy API

POST /api/v1/tools/image/vignette

Przyjmuje dane formularza multipart z plikiem obrazu i polem JSON settings.

Parametry

Parametr	Typ	Wymagany	Domyślny	Opis
strength	number	Nie	`0.5`	Nieprzezroczystość winiety (0.1-1)
color	string	Nie	`"#000000"`	Kolor winiety w formacie hex
radius	integer	Nie	`70`	Promień zewnętrzny jako procent połowy przekątnej (0-100)
softness	integer	Nie	`50`	Miękkość wtapiania (0-100); wyższe wartości dają bardziej stopniowe przejście
roundness	integer	Nie	`100`	Kształt: 100 = koło, 0 = elipsa dopasowana do proporcji obrazu
centerX	integer	Nie	`50`	Pozioma pozycja środka jako procent (0-100)
centerY	integer	Nie	`50`	Pionowa pozycja środka jako procent (0-100)

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Uwagi

Mniejszy radius przyciemnia większą część obrazu; większy promień ogranicza winietę do skrajnych krawędzi.
Użyj koloru color innego niż czarny (np. białego lub w tonach sepii) dla kreatywnych efektów winiety.
Regulacja centerX i centerY pozwala umieścić czysty obszar poza środkiem, co jest przydatne do skierowania uwagi na obiekt, który nie znajduje się na środku kadru.
Format wyjściowy odpowiada formatowi wejściowemu. Dane wejściowe HEIC, RAW, PSD i SVG są automatycznie dekodowane przed przetwarzaniem.

2.3 KiB Raw Blame History