mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +08:00

3.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Łącz obrazy obok siebie, jeden nad drugim lub w siatce, z kontrolą wyrównania, odstępów, obramowań i trybu skalowania.	670c5cc944b1	human	74ff73169fd0

Połącz obrazy

Łącz wiele obrazów obok siebie, ułożonych pionowo lub rozmieszczonych w siatce. Obsługuje wyrównanie, odstępy, obramowanie, zaokrąglenie narożników i wiele trybów skalowania.

Punkt końcowy API

POST /api/v1/tools/image/stitch

Parametry

Parametr	Typ	Wymagany	Domyślny	Opis
direction	string	Nie	`"horizontal"`	Kierunek układu: `horizontal`, `vertical`, `grid`
gridColumns	integer	Nie	2	Liczba kolumn, gdy kierunek to `grid` (2 do 100)
resizeMode	string	Nie	`"fit"`	Sposób skalowania obrazów: `fit`, `original`, `stretch`, `crop`
alignment	string	Nie	`"center"`	Wyrównanie w poprzek osi: `start`, `center`, `end`
gap	number	Nie	0	Odstęp między obrazami w pikselach (0 do 1000)
border	number	Nie	0	Szerokość zewnętrznego obramowania w pikselach (0 do 500)
cornerRadius	number	Nie	0	Zaokrąglenie narożników zastosowane do końcowego wyniku (0 do 500)
backgroundColor	string	Nie	`"#FFFFFF"`	Kolor tła/obramowania w formacie hex (np. `#FF0000`)
format	string	Nie	`"png"`	Format wyjściowy: `png`, `jpeg`, `webp`, `avif`, `jxl`
quality	number	Nie	90	Jakość wyjściowa (1 do 100)

Przykładowe żądanie

curl -X POST http://localhost:1349/api/v1/tools/image/stitch \
  -F "file=@image1.png" \
  -F "file=@image2.png" \
  -F "file=@image3.png" \
  -F 'settings={"direction":"horizontal","resizeMode":"fit","gap":10,"backgroundColor":"#FFFFFF","format":"png"}'

Przykładowa odpowiedź

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stitch.png",
  "originalSize": 1234567,
  "processedSize": 987654
}

Uwagi

Wymaga co najmniej 2 obrazów. Prześlij wiele plików obrazów w żądaniu multipart.
Obsługuje formaty wejściowe HEIC, RAW, PSD i SVG (automatycznie dekodowane).
Tryby skalowania:
- fit - Skaluje obrazy tak, aby dopasować się do najmniejszego wymiaru wzdłuż osi łączenia.
- original - Zachowuje oryginalne rozmiary (może dawać nierówne krawędzie).
- stretch - Wymusza dopasowanie obrazów do najmniejszego wymiaru bez zachowania proporcji.
- crop - Kadruje obrazy metodą cover, aby dopasować się do najmniejszego wymiaru.
W trybie grid komórki są skalowane do median wymiarów wszystkich obrazów.
cornerRadius jest stosowane do całego końcowego wyniku, a nie do poszczególnych obrazów.
Rozmiar płótna jest ograniczony konfiguracją serwera MAX_CANVAS_PIXELS, aby zapobiec wyczerpaniu pamięci.

3.0 KiB Raw Blame History