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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Розділення одного зображення на плитки сітки за рядками та стовпцями або за розміром у пікселях, повертається як архів ZIP.	57a2e11e7cce	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