l2dnjsrud-ComfyUI-OpenToonzLineTools/docs/parameter_guide.ko.md

노드와 파라미터 가이드

이 문서는 ComfyUI에 보이는 쉬운 표시 이름 기준입니다. workflow 호환을 위해 내부 node id는 그대로 유지합니다.

• OTBlueLineCleanup -> Blue Sketch Cleaner
• OTLineAutoClose -> Line Gap Closer
• OTRegionPaletteMap -> Color Region Finder

추천 흐름:

패널 crop
  -> Blue Sketch Cleaner
  -> Line Gap Closer
  -> Color Region Finder
  -> 채색 / 색 보정

전체 페이지에는 먼저 패널 검출과 crop을 거친 뒤 쓰는 것이 좋습니다. MC/MS 전체 페이지는 gap closing과 region map의 기본 입력으로는 너무 복잡합니다.

Blue Sketch Cleaner

첫 번째로 쓰는 노드입니다. 파란 러프 연필선을 검출해서 흰 배경의 검은 line art로 바꿉니다.

출력:

• clean_line: 흰 배경 위 검은 line art.
• line_overlay: 원본 위에 검출된 파란 stroke를 빨간색으로 표시.
• transparent_line_preview: line-only preview를 흰 배경에서 확인.
• settings_json: 설정값과 이미지별 line 통계.

파라미터:

Parameter	Default	사용법
hue_low	90	OpenCV HSV 기준 파란색 hue 하한입니다. 범위는 0-179. 청록 계열 선이 빠지면 낮춥니다.
hue_high	145	파란색 hue 상한입니다. 보라빛 파란 선이 빠지면 올립니다.
saturation_min	28	색의 진함 최소값입니다. 배경 잡음이 잡히면 올리고, 흐린 파란 연필선이 빠지면 낮춥니다.
value_min	20	밝기 최소값입니다. 어두운 파란 선이 빠지면 낮추고, 그림자/노이즈가 잡히면 올립니다.
include_dark_lines	false	검은색/어두운 선도 같이 포함합니다. 파란 선과 검은 선이 섞인 패널에 유용하지만 글자, 컷선, 그림자도 같이 잡힐 수 있습니다.
despeckle_px	8	이 픽셀 면적보다 작은 점 노이즈를 제거합니다. 먼지 제거는 올리고, 작은 의도된 선이 사라지면 낮춥니다.
close_px	1	작은 틈을 붙이는 morphology closing 반경입니다. 올리면 미세한 끊김은 줄지만 선이 두꺼워지거나 붙을 수 있습니다.

시작값:

• 파란 러프만 있는 경우: 기본값.
• 파란 선이 너무 흐림: saturation_min 15-25, value_min 10-20.
• 배경이 너무 많이 잡힘: saturation_min 45-70, despeckle_px 16-64.
• 파란 선과 검은 선이 섞임: include_dark_lines true, overlay를 꼭 확인.

Line Gap Closer

Blue Sketch Cleaner 뒤에 쓰는 노드입니다. line art를 skeleton으로 줄이고, endpoint를 찾은 뒤 방향과 거리가 맞는 짧은 gap을 닫습니다.

출력:

• closed_line: gap closing 후 line art.
• closure_overlay: 원래 선은 검정, 새로 닫은 gap은 빨강.
• segments_json: 이미지별 닫은 segment 좌표와 skip 이유.

파라미터:

Parameter	Default	사용법
threshold	180	이 값보다 어두운 픽셀을 선으로 봅니다. 검은 선만 엄격히 잡으려면 낮추고, 회색 선이 빠지면 올립니다.
closing_distance	18	endpoint끼리 연결할 최대 거리입니다. 큰 gap을 닫으려면 올리고, 엉뚱한 선끼리 붙으면 낮춥니다.
spot_angle	75	방향 허용 각도입니다. 낮추면 엄격해지고, 높이면 더 많은 애매한 gap을 닫습니다.
line_width	1	새로 그리는 closure stroke 두께입니다. line art에는 보통 1-2가 적당합니다.
max_endpoints	600	안전 제한입니다. endpoint가 너무 많으면 무리하게 닫지 않고 skip합니다. 전체 페이지는 자주 이 제한을 넘습니다.

시작값:

• 패널 crop: 기본값.
• 아주 작은 끊김만 닫기: closing_distance 8-12, spot_angle 45-60.
• 러프한 큰 gap도 닫기: closing_distance 20-32, spot_angle 75-100.
• 전체 페이지: 기본적으로 피하세요. 실험용으로만 overlay를 보면서 max_endpoints를 올립니다.

Color Region Finder

gap closing 뒤에 쓰는 노드입니다. 검은 line art로 둘러싸인 흰 영역을 찾아 채색 가능한 region preview를 만듭니다.

출력:

• region_preview: 검출 region을 색으로 표시하고 line art는 검정으로 표시.
• regions_json: 각 region의 bbox, area, centroid, style id.

파라미터:

Parameter	Default	사용법
threshold	180	이 값보다 어두운 픽셀을 region 경계선으로 봅니다. Line Gap Closer와 맞춰 쓰는 것이 좋습니다.
min_area	32	이 픽셀 면적보다 작은 region을 무시합니다. 노이즈가 많으면 올리고, 눈/장식 같은 작은 영역이 빠지면 낮춥니다.
max_regions	128	이미지당 반환할 최대 region 수입니다. 복잡한 패널은 올릴 수 있지만, 항상 cap에 걸리면 입력이 너무 큽니다.
ignore_border_regions	true	이미지 경계에 닿은 열린 region을 무시합니다. 패널 crop에는 true 권장, 페이지/레이아웃 디버깅에는 false도 가능.

시작값:

• 패널 crop: 기본값.
• 작은 색 조각이 너무 많음: min_area 128-512.
• 눈/소품/장식이 빠짐: min_area 8-24.
• 전체 페이지 디버그: max_regions 512+, 대신 매우 noisy할 수 있습니다.

빠른 판정법

• Blue Sketch Cleaner overlay가 맞으면 hue/saturation 설정은 대체로 맞습니다.
• Line Gap Closer가 endpoint_count_exceeded를 내면 더 작게 crop한 뒤 쓰세요.
• Color Region Finder가 항상 max_regions와 같은 region 수를 내면 이미지가 너무 복잡하거나 열린 선이 많다는 뜻입니다.