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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Thêm viền, khoảng đệm, góc bo tròn và bóng đổ vào hình ảnh theo một thứ tự có thể dự đoán và kiểm soát được.	8845150736a9	human	61e787776e5d

Border & Frame

Thêm viền, khoảng đệm, góc bo tròn và bóng đổ vào hình ảnh. Công cụ áp dụng các hiệu ứng theo thứ tự: khoảng đệm, viền, bán kính bo góc, rồi bóng đổ.

API Endpoint

POST /api/v1/tools/image/border

Parameters

Parameter	Type	Required	Default	Description
borderWidth	number	No	10	Độ dày viền tính bằng pixel (0 đến 2000)
borderColor	string	No	`"#000000"`	Màu viền dạng hex (ví dụ `#FF0000`)
padding	number	No	0	Khoảng đệm bên trong giữa hình ảnh và viền tính bằng pixel (0 đến 200)
paddingColor	string	No	`"#FFFFFF"`	Màu lấp khoảng đệm dạng hex
cornerRadius	number	No	0	Bán kính bo góc tính bằng pixel (0 đến 2000)
shadow	boolean	No	`false`	Có thêm bóng đổ hay không
shadowBlur	number	No	15	Bán kính làm mờ bóng đổ (1 đến 200)
shadowOffsetX	number	No	0	Độ lệch ngang của bóng đổ (-50 đến 50)
shadowOffsetY	number	No	5	Độ lệch dọc của bóng đổ (-50 đến 50)
shadowColor	string	No	`"#000000"`	Màu bóng đổ dạng hex
shadowOpacity	number	No	40	Phần trăm độ mờ của bóng đổ (0 đến 100)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/border \
  -F "file=@photo.jpg" \
  -F 'settings={"borderWidth":20,"borderColor":"#333333","cornerRadius":16,"shadow":true,"shadowBlur":25,"shadowOpacity":50}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.png",
  "originalSize": 456789,
  "processedSize": 523456
}

Notes

Sử dụng factory createToolRoute tiêu chuẩn. Chấp nhận một tệp hình ảnh duy nhất qua tải lên multipart.
Hỗ trợ các định dạng đầu vào HEIC, RAW, PSD và SVG (được giải mã tự động).
Thứ tự xử lý: khoảng đệm được thêm trước, rồi viền bọc quanh, rồi bán kính bo góc được áp dụng, rồi bóng đổ được ghép vào.
Khi cornerRadius hoặc shadow được bật, đầu ra buộc phải là PNG (bất kể định dạng đầu vào) để giữ độ trong suốt. Các định dạng hỗ trợ kênh alpha (PNG, WebP, AVIF) giữ nguyên định dạng gốc.
Bóng đổ nhận biết hình dạng: nó bám theo các góc bo tròn thay vì tạo một bóng đổ hình chữ nhật.
Đặt borderWidth bằng 0 và chỉ dùng cornerRadius + shadow tạo hiệu ứng bóng đổ bo tròn không khung.

3.1 KiB Raw Blame History