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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
조절 가능한 강도, 색상, 위치로 비네트 효과를 추가합니다.	0b9795fea2eb	human	670117aa7e1d

Vignette

이미지 가장자리를 어둡게 하거나 색조를 입히는 비네트 효과를 추가합니다. 조절 가능한 강도, 색상, 반경, 부드러움, 둥글기, 중심 위치를 지원합니다.

API Endpoint

POST /api/v1/tools/image/vignette

이미지 파일과 JSON settings 필드를 담은 multipart form data를 받습니다.

Parameters

Parameter	Type	Required	Default	Description
strength	number	No	`0.5`	비네트 불투명도 (0.1-1)
color	string	No	`"#000000"`	비네트 hex 색상
radius	integer	No	`70`	반대각선 절반에 대한 백분율 외곽 반경 (0-100)
softness	integer	No	`50`	페더 부드러움 (0-100); 값이 높을수록 더 점진적인 페이드가 생성됨
roundness	integer	No	`100`	형태: 100 = 원, 0 = 이미지 종횡비에 맞는 타원
centerX	integer	No	`50`	수평 중심 위치 백분율 (0-100)
centerY	integer	No	`50`	수직 중심 위치 백분율 (0-100)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/vignette \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"strength": 0.7, "radius": 60, "softness": 70}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2410000
}

Notes

radius이 작을수록 이미지가 더 많이 어두워지고, 반경이 클수록 비네트가 극단적인 가장자리로 국한됩니다.
창의적인 비네트 효과를 위해 검정이 아닌 color(예: 흰색이나 세피아 톤)을 사용하세요.
centerX와 centerY를 조절하면 선명한 영역을 중심에서 벗어나게 배치할 수 있어, 프레임 중앙에 있지 않은 피사체에 시선을 끌어들이는 데 유용합니다.
출력 형식은 입력 형식과 일치합니다. HEIC, RAW, PSD, SVG 입력은 처리 전에 자동으로 디코딩됩니다.

2.4 KiB Raw Blame History