이미지 도구
필름 네거티브 사진 변환
film-negative-to-photo
Film Negative to Photo 기능을 Zavilo SDK에서 사용하는 방법입니다. 아래에서 입력 제한, 파라미터, 출력 형식과 지원 모드를 확인할 수 있습니다.
H · HeadlessI · Interactive
빠른 이동
입력 파일 1출력 파일 1
입력
이 Tool이 허용하는 입력 형식과 파일 개수입니다.
| 입력 종류 | file |
|---|---|
| 파일 수 | 1 – 1 |
| 허용 MIME 형식 | image/jpeg, image/png, image/webp |
파라미터
아래 값은 request.options에 전달합니다.
| 파라미터 | 타입 | 필수 | 기본값 | 허용값 / 범위 | 설명 |
|---|---|---|---|---|---|
preset |
enum | 선택 | color |
color | bw | raw | 처리에 사용할 프리셋을 선택합니다. |
compensateBase |
boolean | 선택 | true |
— | Estimate and compensate film base color from image corners. |
autoLevels |
boolean | 선택 | true |
— | Automatically stretch channel levels. |
brightness |
number | 선택 | 0 |
-50 – 50 | 밝기를 조절합니다. |
contrast |
number | 선택 | 5 |
-50 – 50 | 대비를 조절합니다. |
gamma |
number | 선택 | 1.05 |
0.5 – 2 | 감마 값을 조절합니다. |
saturation |
number | 선택 | 105 |
0 – 160 | 채도를 조절합니다. |
red |
number | 선택 | 100 |
60 – 140 | 빨간색 채널의 균형을 조절합니다. |
green |
number | 선택 | 100 |
60 – 140 | 초록색 채널의 균형을 조절합니다. |
blue |
number | 선택 | 100 |
60 – 140 | 파란색 채널의 균형을 조절합니다. |
format |
enum | 선택 | jpg |
jpg | png | 출력 파일 형식을 설정합니다. |
quality |
number | 선택 | 0.92 |
0.5 – 1 | 출력 품질을 설정합니다. |
출력
처리가 완료되면 반환되는 결과 형식입니다.
| 출력 종류 | files |
|---|---|
| 파일 수 | 1 – 1 |
| 출력 MIME | image/jpeg, image/png |
| Metadata | width, height, inputBytes, outputBytes |
| ZIP 묶음 | 미지원 |
기본 사용 예제
지원되는 연동 모드를 확인하고 생성된 시작 코드를 바로 복사할 수 있습니다.
Headless
const result = await client.run("film-negative-to-photo", {
file,
options: { preset: "color", compensateBase: true, autoLevels: true, brightness: 0 }
});
console.log(result.files, result.data, result.metadata);
Interactive
await client.open({
tool: "film-negative-to-photo",
input: { file },
options: { preset: "color", compensateBase: true, autoLevels: true, brightness: 0 },
onComplete(result) { console.log(result.files, result.data, result.metadata); }
});
Embedded
await client.mount({ tool: "film-negative-to-photo", target: "#zavilo-tool", mode: "embedded" });
이 명세는 실제 SDK 런타임이 사용하는 Tool Definition을 기준으로 자동 생성됩니다.