mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
50 lines
2.3 KiB
Markdown
50 lines
2.3 KiB
Markdown
---
|
||
description: "按行列数或像素尺寸将一张图像分割为网格图块，以 ZIP 压缩包形式返回。"
|
||
i18n_source_hash: 57a2e11e7cce
|
||
i18n_provenance: human
|
||
i18n_output_hash: 49ea1a52dd18
|
||
---
|
||
|
||
# 图像分割 {#image-splitting}
|
||
|
||
按列/行数或指定的像素尺寸将单张图像分割为网格图块。返回包含所有图块的 ZIP 压缩包。
|
||
|
||
## API 端点 {#api-endpoint}
|
||
|
||
`POST /api/v1/tools/image/split`
|
||
|
||
## 参数 {#parameters}
|
||
|
||
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|
||
|-----------|------|----------|---------|-------------|
|
||
| columns | integer | 否 | 3 | 分割的列数（1 到 100） |
|
||
| rows | integer | 否 | 3 | 分割的行数（1 到 100） |
|
||
| tileWidth | integer | 否 | - | 图块宽度（像素，最小 10）。当同时设置 `tileWidth` 和 `tileHeight` 时，覆盖 `columns`。 |
|
||
| tileHeight | integer | 否 | - | 图块高度（像素，最小 10）。当同时设置 `tileWidth` 和 `tileHeight` 时，覆盖 `rows`。 |
|
||
| outputFormat | string | 否 | `"original"` | 图块的输出格式：`original`、`png`、`jpg`、`webp`、`avif`、`jxl` |
|
||
| quality | number | 否 | 90 | 有损格式的输出质量（1 到 100） |
|
||
|
||
## 示例请求 {#example-request}
|
||
|
||
```bash
|
||
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
|
||
```
|
||
|
||
## 示例响应 {#example-response}
|
||
|
||
响应以 ZIP 文件形式直接流式返回，附带 `Content-Type: application/zip`。文件名遵循 `split-<jobId>.zip` 的模式。
|
||
|
||
ZIP 内的每个图块命名为 `<originalBaseName>_r<row>_c<col>.<ext>`（例如 `photo_r1_c1.png`、`photo_r2_c3.webp`）。
|
||
|
||
## 说明 {#notes}
|
||
|
||
- 接受单个图像文件。
|
||
- 支持 HEIC、RAW、PSD 和 SVG 输入格式（自动解码）。
|
||
- 当同时提供 `tileWidth` 和 `tileHeight` 时，它们优先于 `columns`/`rows`。网格尺寸按 `ceil(imageWidth / tileWidth)` 和 `ceil(imageHeight / tileHeight)` 计算。
|
||
- 如果图像尺寸无法被整除，边缘图块（最右列、最底行）可能小于指定的图块尺寸。
|
||
- 网格尺寸最大限制为 100x100（10,000 个图块）。
|
||
- 响应直接流式返回 ZIP，因此没有 JSON 响应体。搭配 curl 使用 `--output` 来保存文件。
|