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

2.7 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Chia một ảnh thành các ô lưới theo hàng và cột hoặc theo kích thước pixel, trả về dưới dạng kho lưu trữ ZIP.	57a2e11e7cce	human	b767a4ac891e

Chia ảnh

Chia một ảnh đơn thành các ô lưới theo số cột/hàng hoặc theo kích thước pixel cụ thể. Trả về một kho lưu trữ ZIP chứa tất cả các ô.

API Endpoint

POST /api/v1/tools/image/split

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
columns	integer	Không	3	Số cột để chia (1 đến 100)
rows	integer	Không	3	Số hàng để chia (1 đến 100)
tileWidth	integer	Không	-	Chiều rộng ô tính bằng pixel (tối thiểu 10). Ghi đè `columns` khi cả `tileWidth` và `tileHeight` đều được đặt.
tileHeight	integer	Không	-	Chiều cao ô tính bằng pixel (tối thiểu 10). Ghi đè `rows` khi cả `tileWidth` và `tileHeight` đều được đặt.
outputFormat	string	Không	`"original"`	Định dạng đầu ra cho các ô: `original`, `png`, `jpg`, `webp`, `avif`, `jxl`
quality	number	Không	90	Chất lượng đầu ra cho các định dạng có mất dữ liệu (1 đến 100)

Ví dụ Request

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

Ví dụ Response

Response được truyền trực tiếp dưới dạng tệp ZIP với Content-Type: application/zip. Tên tệp theo mẫu split-<jobId>.zip.

Mỗi ô bên trong ZIP được đặt tên <originalBaseName>_r<row>_c<col>.<ext> (ví dụ photo_r1_c1.png, photo_r2_c3.webp).

Ghi chú

Chấp nhận một tệp ảnh đơn.
Hỗ trợ các định dạng đầu vào HEIC, RAW, PSD, và SVG (tự động giải mã).
Khi cả tileWidth và tileHeight đều được cung cấp, chúng được ưu tiên hơn columns/rows. Kích thước lưới được tính là ceil(imageWidth / tileWidth) và ceil(imageHeight / tileHeight).
Các ô ở cạnh (cột ngoài cùng bên phải, hàng dưới cùng) có thể nhỏ hơn kích thước ô được chỉ định nếu kích thước ảnh không chia hết.
Kích thước lưới tối đa được giới hạn ở 100x100 (10.000 ô).
Response truyền trực tiếp tệp ZIP nên không có thân JSON. Dùng --output với curl để lưu tệp.

2.7 KiB Raw Blame History