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.4 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	3971aad4def1

Разбиение изображения

Разбейте одно изображение на плитки сетки по количеству столбцов/строк или по конкретным размерам в пикселях. Возвращает 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.4 KiB Raw Blame History