Krita 라인아트 재구성 스킬
래스터 참조 일러스트레이션으로부터 검증되고 프로덕션 준비가 완료된 1x 기본 Krita 라인아트 재구성 파이프라인을 패키징하고 실행합니다.
이 스킬은 에이전트 독립적입니다: 수학적 궤도 합성, 위상학적 스켈레톤 추적, 보정 및 검증은 scripts/krita_adapter.py를 통해 Krita RPC/MCP/CLI 실행과 엄격히 분리됩니다.
엄격한 프로덕션 범위 경계
- 기본
1x해상도 전용:2x슈퍼샘플링 또는2x + 적응형확장을 활성화하지 마십시오.adaptive_subdivision.py와stroke_planner.py모두resolution_scale != 1/supersample_factor != 1을 거부합니다. - 라인아트 전용: 전용
Lineart페인트 레이어(RGBA U8,300 dpi,sRGB-elle-V2-srgbtrc.icc)에 선명한#000000잉크를 출력합니다. 평면 채색, 음영, 그라데이션, 앰비언트 오클루전, 조명 스택 또는 렌더링을 수행하지 않습니다. - 네이티브 Krita 브러시 전용: 래스터화된 오버레이를 가져오는 대신 보정된 브러시 프리셋(
d) Ink-3 Gpen및 넓은 그래픽 채움용b) Basic-5 Size)을 통해서만 스트로크를 합성합니다.
핵심 파이프라인 워크플로
-
참조 분석 및 잉크 추출 (
scripts/ink_analysis.py):- 2단계 임계값 처리는 단단한 어두운 잉크(
inv > 42.0)와 섬세한 저대비 릿지(가우시안sigma = 4.0기준local_dark > 14.0 & inv > 18.0)를 캡처하며, 홍채 동심원 고리와 같은 밀집된 좁은 간격을 위한 선택적 경계 상자 미세 재정의(region_overrides)를 포함합니다. - 유클리드 거리 변환(
edt >= 2.8 px, 면적>= 20 px)을 통해 굵은 그래픽 검정색 코어를 감지하고 등거리 스윕 윤곽선(1.35 .. 16.20 px)을 추출합니다. - 남은 잉크를 해골화하고, 짧은 양자화 스퍼(
<= 4반복)를 정리하고, 차수>= 3접합부(cos <= -0.68)에서 동일 선상 궤적을 접합하고, 중심선을 서브픽셀 정밀도(refine_ridge_subpixel)로 개선하고, 날카로운 모서리(> 72 deg) 또는 최대540 px범위에서 분할합니다.
- 2단계 임계값 처리는 단단한 어두운 잉크(
-
스플라인 피팅 및 검증된 적응형 정점 밀도 (
scripts/bezier_core.py,scripts/adaptive_subdivision.py):- 최소 제곱 최적 접선 핸들을 사용하여 G1 연속 조각별 3차 베지어 세그먼트를 피팅합니다.
우선순위 큐 재귀적 3차 베지어 세분화(
1x에서 실험 2로 검증됨)로 코드 샘플링을 개선하고, 스트로크당 정점 수를 Krita의 하드 제한인128포인트로 제한하면서 코드 새짓, 접선 각도 편향, 곡률-호 곱, 압력 테이퍼 충실도 및 직선 코드 길이에 대한 엄격한 공차를 유지합니다.
- 최소 제곱 최적 접선 핸들을 사용하여 G1 연속 조각별 3차 베지어 세그먼트를 피팅합니다.
우선순위 큐 재귀적 3차 베지어 세분화(
-
Krita 6.0.4 브러시 및 좌표 보정 (
scripts/pressure_calibration.py,scripts/stroke_planner.py):- 국소 법선을 따라 광학 선 폭을 통합하고 골짜기 중단(
max_half = 4.8 px)을 적용하여 인접 가닥 팽창을 방지합니다. configs/pressure_tables_krita604.json에 정의된 이중 모드 경험적d) Ink-3 Gpen압력 곡선(brush_size <= 4.5 px일 때GPEN_THIN,brush_size > 4.5 px일 때GPEN_STD) 또는b) Basic-5 Size테이블을 선택합니다.- 정점 샘플과 베지어 제어점을
+0.58 px(PIXEL_CENTER_SHIFT)만큼 이동시켜 스트로크 닷을 Krita 픽셀 중앙에 정렬하고, 스트로크를 1~6단계(그래픽 코어 -> 외부 실루엣 -> 초점 영역 -> 내부 구조 -> 미세 실금)에 걸쳐 정렬합니다.
- 국소 법선을 따라 광학 선 폭을 통합하고 골짜기 중단(
-
실행 및 폐루프 시각적 피드백 (
scripts/reconstruct_lineart.py,scripts/refinement.py):dry_run(휴대용 JSON 배치 내보내기),http_bridge(POST /rpc), 또는krita_mcp_cli(krita-mcp --call) 모드에서KritaAdapter를 통해<= 32스트로크(draw_brush호출당 엄격히<= 64) 배치로 실행합니다.- 렌더링된 캔버스 그레이스케일을 내보내고 선택적으로
--feedback-canvas <png>(7단계)를 실행하여 참조 스트로크가 누락(dist >= 1.35 px)되거나 너무 어두운 곳에 대상 미세 스트로크를 합성합니다.
-
검증 및 인계 (
scripts/validate_lineart.py):- 매니페스트 스키마 제한을 확인하고, 전체 캔버스 및 영역별
SSIM,PSNR_dB,Contour_F1(1.5 px),Exact_Pixel_F1(0.5 px),Fine_Detail_Recall,Narrow_Gap_Preservation을 계산하고 빨간색/파란색/진한 회색 정렬 차이 PNG를 생성합니다. - 라인아트가 검증을 통과하면
krita-flat-colouring으로 인계합니다.
- 매니페스트 스키마 제한을 확인하고, 전체 캔버스 및 영역별
빠른 CLI 호출
스트로크를 오프라인으로 계획하고, 매니페스트 범위를 검증하며, 휴대용 Krita MCP 배치 JSON을 내보냅니다:
python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
--input path/to/reference.png \
--preset skills/krita-lineart-reconstruction/examples/sample_region_preset.json \
--output-manifest out/lineart_manifest.json \
--batch-dir out/batches \
--mode dry_run
활성 Krita 6.0.4 세션에 대해 라이브로 실행합니다:
python3 skills/krita-lineart-reconstruction/scripts/reconstruct_lineart.py \
--input path/to/reference.png \
--output-manifest out/lineart_manifest.json \
--mode http_bridge \
--doc-name Character_Lineart
참조 가이드 및 구성
references/architecture.md— 모듈 레이아웃 및 에이전트 독립적 격리 경계.references/bezier-and-sampling.md— G1 3차 베지어 피팅, 우선순위 큐 재귀적 세분화와 레거시 샘플러 비교, 슈퍼샘플링이 제외된 이유.references/calibration.md—+0.58 px좌표 보정 및 이중 모드Ink-3 Gpen/Basic-5 Size테이블.references/krita-interface.md— Krita 6.0.4 네이티브 브리지 프로토콜, 하드 스키마 제한 및 오류 처리.references/validation.md— 충실도 메트릭, 폐루프 잔여 피드백 및 합격 기준.references/troubleshooting.md— 누락된 세부 정보, 정점 클리핑 및 브리지 오류 진단.configs/default_config.json및configs/pressure_tables_krita604.jsonexamples/workflow_example.md