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 "[email protected]" \
  -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.