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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Розділення одного зображення на плитки сітки за рядками та стовпцями або за розміром у пікселях, повертається як архів ZIP.	838f5fa791b0	human	428b04bfeb55

Розділення зображення

Розділіть одне зображення на плитки сітки за кількістю стовпців/рядків або за конкретними розмірами у пікселях. Повертає архів ZIP, що містить усі плитки.

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

POST /api/v1/tools/image/split

Параметри

Параметр	Тип	Обов’язковий	За замовчуванням	Опис
columns	integer	Ні	3	Кількість стовпців для розділення (від 1 до 100)
rows	integer	Ні	3	Кількість рядків для розділення (від 1 до 100)
tileWidth	integer	Ні	-	Ширина плитки у пікселях (мін. 10). Перевизначає `columns`, коли встановлено обидва `tileWidth` та `tileHeight`.
tileHeight	integer	Ні	-	Висота плитки у пікселях (мін. 10). Перевизначає `rows`, коли встановлено обидва `tileWidth` та `tileHeight`.
outputFormat	string	Ні	`"original"`	Формат виводу для плиток: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	Ні	90	Якість виводу для форматів зі втратами (від 1 до 100)

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

curl -X POST http://localhost:1349/api/v1/tools/image/split \
  -F "file=@large-image.png" \
  -F 'settings={"columns":3,"rows":3,"outputFormat":"png"}' \
  --output split-tiles.zip

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

Відповідь передається безпосередньо як файл ZIP із Content-Type: application/zip. Ім’я файлу відповідає шаблону split-<jobId>.zip.

Кожна плитка всередині ZIP має ім’я <originalBaseName>_r<row>_c<col>.<ext> (напр. photo_r1_c1.png, photo_r2_c3.webp).

Примітки

Приймає один файл зображення.
Підтримує вхідні формати HEIC, RAW, PSD та SVG (автоматично декодуються).
Коли надано обидва tileWidth та tileHeight, вони мають пріоритет над columns/rows. Розміри сітки обчислюються як ceil(imageWidth / tileWidth) та ceil(imageHeight / tileHeight).
Крайові плитки (крайній правий стовпець, нижній рядок) можуть бути меншими за вказаний розмір плитки, якщо розміри зображення не діляться націло.
Максимальний розмір сітки обмежено 100x100 (10 000 плиток).
Відповідь передає ZIP безпосередньо, тому тіла відповіді JSON немає. Використовуйте --output з curl, щоб зберегти файл.

3.5 KiB Raw Blame History