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
흑백(potrace) 및 풀컬러 다중 레이어 벡터화로 래스터 이미지를 SVG로 변환합니다.	f3e4777188ad	human	f7908a58b9bc

Image to SVG

트레이싱 알고리즘을 사용해 래스터 이미지를 SVG로 벡터화합니다. 흑백 트레이싱(potrace)과 풀컬러 다중 레이어 벡터화를 지원합니다.

API Endpoint

POST /api/v1/tools/image/vectorize

Parameters

Parameter	Type	Required	Default	Description
colorMode	string	No	`"bw"`	트레이싱 모드: `bw`(흑백) 또는 `color`(다중 색상 레이어)
threshold	number	No	128	흑백 모드의 밝기 임계값 (0 ~ 255). 이 값 아래의 픽셀은 검정이 됩니다.
colorPrecision	number	No	6	컬러 모드의 색상 양자화 정밀도 (1 ~ 16). 값이 높을수록 더 뚜렷한 색상 레이어가 생성됩니다.
layerDifference	number	No	6	컬러 모드에서 레이어 간 최소 색상 차이 (1 ~ 128)
filterSpeckle	number	No	4	트레이싱된 도형의 최소 면적(픽셀) (1 ~ 256). 노이즈/얼룩을 제거합니다.
pathMode	string	No	`"spline"`	경로 스무딩: `none`(들쭉날쭉), `polygon`(직선 세그먼트), `spline`(부드러운 곡선)
cornerThreshold	number	No	60	컬러 모드의 모서리 감지 각도 임계값 (0 ~ 180도)
invert	boolean	No	`false`	트레이싱 전에 이미지 반전(흑백 교환)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/vectorize \
  -F "file=@logo.png" \
  -F 'settings={"colorMode":"bw","threshold":128,"filterSpeckle":4,"pathMode":"spline"}'

Color Vectorization

curl -X POST http://localhost:1349/api/v1/tools/image/vectorize \
  -F "file=@illustration.png" \
  -F 'settings={"colorMode":"color","colorPrecision":8,"layerDifference":6,"filterSpeckle":4}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/logo.svg",
  "originalSize": 45678,
  "processedSize": 12345
}

Notes

입력 형식에 관계없이 출력은 항상 SVG 파일입니다.
HEIC, RAW, PSD, SVG 입력 형식을 지원합니다(트레이싱 전에 자동으로 래스터로 디코딩됨).
흑백 모드는 potrace 알고리즘을 사용합니다. 이미지는 먼저 그레이스케일로 변환된 다음 트레이싱 전에 순수 흑백으로 임계값 처리됩니다.
컬러 모드는 다중 레이어 접근 방식을 사용합니다: 이미지가 색상 레이어로 양자화되고, 각 레이어가 개별적으로 트레이싱되어 SVG 출력에 쌓입니다.
filterSpeckle 값이 낮을수록 더 많은 디테일을 보존하지만 경로가 더 많은 큰 SVG 파일이 생성됩니다.
pathMode 설정은 파일 크기에 큰 영향을 미칩니다: none는 가장 많은 경로를, spline는 가장 부드러운(그리고 대개 가장 작은) 출력을 생성합니다.
로고와 아이콘에 최적의 결과를 얻으려면 깨끗한 고대비 입력으로 흑백 모드를 사용하세요. 사진이나 일러스트레이션에는 더 높은 colorPrecision와 함께 컬러 모드를 사용하세요.

3.4 KiB Raw Blame History