Communitygithub.com

라이트닝 엠페러: CG-플레이트 합성

실사 촬영(블루/그린 스크린 포함)에 CG를 합성하기 위한 워크플로우와 도구들. 카메라 매칭, 조명 매칭, 키잉, 트래킹, 섀도우, 그레인, 선형 조명 합성을 다룹니다.

라이트닝 엠페러: CG-플레이트 합성란 무엇인가요?

라이트닝 엠페러는 실사 촬영본(plate)에 CG를 합성하는 전문 워크플로우와 도구 모음입니다. MCP 서버, CLI, 블렌더 애드온 세 가지 형태로 제공되며, 주로 그린/블루 스크린을 대체하거나 CG 배경을 배우 뒤에 배치하는 VFX 작업에 사용됩니다. 이 도구는 촬영본에서 카메라 렌즈, 센서, 노출, 화이트 밸런스를 자동으로 측정하고, 실제 거리 측정(알려진 객체 크기와 렌즈 초점 거리)을 통해 CG의 절대 스케일을 정확하게 맞춥니다. 또한 키잉, 디스필, 마커 트래킹, 실제 조명 방향 및 색상 매칭, 배우 그림자 계산, 그레인 매칭, 선형 조명 합성까지 전체 파이프라인을 지원합니다. 모든 단계에서 정량적 측정(숫자 기반)을 강조하며, 사용자에게 판단이 필요한 부분은 명확히 알리고, 오류 발생 시 원인과 해결책을 제시하는 실용적인 접근법을 따릅니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LucidMach/LightningEmperor/tree/HEAD/skill/lightning-emperor

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

라이트닝 엠페러: CG-플레이트 합성은(는) 무엇을 하나요?

실사 배우 뒤나 주변에 CG를 배치하기 위한 워크플로우와 도구들. 이 도구는 세 가지 방식으로 제공되며 모두 동일한 코드를 실행합니다: MCP 서버 (lightning-emperor-mcp), CLI (lightning-emperor ...), 그리고 블렌더 애드온. 연결된 경우 MCP 도구를 선호하고, 그렇지 않으면 CLI를 사용하세요. 이 파일은 판단 기준입니다: 무엇을 측정할지, 무엇이 잘못될 수 있는지, 자신의 작업을 어떻게 확인할지.

값비싼 실수를 방지하는 규칙

  1. 무엇이든 결정하기 전에 플레이트를 측정하세요. 렌즈, 센서, 노출, 화이트 밸런스, 스크린 색상과 강도, 노이즈, 빛의 방향. 10초 측정이 1시간의 추측보다 낫습니다.
  2. 절대 스케일을 먼저 정확히 맞추고, 두 가지 방법으로 확인하세요. CG 스케일은 배우에 대해 카메라와 피사체 간 거리에 직접적으로 의존합니다. 알려진 객체의 픽셀 크기(머리는 왕관에서 턱까지 약 0.24m) 그리고 카메라 파일의 렌즈 초점 거리를 이용하여 측정하세요. 일치하지 않으면 멈추고 해결하세요. 잘못 측정된 거리는 모든 프레임에서 CG 세트의 크기를 틀리게 만듭니다. 스케일 오류를 숨기기 위해 임의 조정 계수를 추가하지 마세요.
  3. 키 라이트를 브리핑이나 세트 사진이 아닌 배우에서 찾으세요. 선형 조명에서 얼굴의 양면을 비교하세요. 세트 사진은 어떤 조명이 있는지 보여주고, 플레이트는 어느 것이 지배적인지 보여줍니다.
  4. 선형 조명으로 합성하고 플레이트가 무엇인지 명시하세요. 디스플레이 참조 비디오: 선형화, 혼합, 재인코딩. 이미지가 평평해 보인다고 로그라고 가정하지 마세요.
  5. 전체 크기와 크롭으로 이미지를 보세요. 썸네일은 스필, 구멍, 프린지를 숨깁니다. 도구가 작성한 미리보기를 신뢰하기 전에 항상 여세요.
  6. 수정이 버그보다 더 나쁠 수 있습니다. 각 수정 후 전체 프레임을 다시 보고 보호하려던 것을 다시 측정하세요.
  7. 비디오를 시청할 수 없습니다. 움직임을 숫자(스텝 크기, 지터)로 측정하고 사용자의 눈만 판단할 수 있는 것을 명확히 말하세요.
  8. 원본을 덮어쓰지 마세요. 긴 렌더 전에 입력 크기/지속 시간을 확인하고 소스 파일을 그대로 두세요.
  9. 한계에 대해 솔직하세요. 사용자가 무언가 잘못되었다고 말할 때 거의 항상 옳습니다: 조사하고, 숫자를 보고하고, 무엇을 잘못했는지 말하세요.

워크플로우

0. 인테이크. 모든 파일을 조사하세요. 형식이 허용하면 카메라 메타데이터를 읽으세요(read_camera_metadata / lightning-emperor metadata): 초점 거리(줌 되었는지?), 초점 거리, ISO, 화이트 밸런스. 작업을 변경하는 것만 물어보세요: CG가 배우에 비해 어디에 위치하는지, 카메라 높이, 최종 출력 형식.

1. 카메라. 플레이트의 알려진 크기와 렌즈 초점에서 solve_camera_distance를 실행하고 agree: true를 요구하세요. 그런 다음 plan_camera(포즈, 오버스캔 크기, 픽셀당 미터 수)를 실행하세요. 오버스캔(약 1.25)으로 렌더링하여 트래킹된 움직임이 렌더 가장자리를 드러내지 않도록 하세요.

2. 조명. 얼굴에서 키 측면을 찾으세요. plan_lights는 시작 위치와 색상을 제공합니다(방위각 0 = 카메라 방향, +90 = 카메라 오른쪽, 켈빈 색상). CG 노출을 눈이 아닌 플레이트(피부 패치, 배경)의 측정값에 맞게 보정하세요. 깜빡이는 실제 조명기구: practical_states는 렌더링할 프레임(켜짐/꺼짐)을 제공합니다.

3. 키. key_frame을 실행하고 preview_on_grey.png를 여세요. 키는 스크린에 자동 보정되지만, 확인할 사항(어두운 옷의 구멍, 스필 색조, 섬으로 남은 마커)에 대해 references/keying.md를 읽으세요.

4. 트래킹 (카메라가 움직이고 배경이 교체되는 경우에만). track_markers는 마커 군집을 프레임당 호모그래피로 추적합니다. references/tracking.md를 읽으세요: 마커가 적은 프레임은 노이즈가 많고, 평평한 배경은 평면입니다(호모그래피가 올바른 모델), 보이는 마커가 없으면 고정 또는 보간 중입니다.

5. 그림자. shadow_offset는 조명 형상과 배우-벽 간격으로부터 배우의 그림자가 배경에 떨어지는 위치를 계산합니다. references/shadows-and-grain.md를 참조하세요.

6. 그레인. 평평한 스크린 영역에서 measure_grain을 실행하고 CG에 적용하여 붙여넣은 것처럼 보이지 않게 하세요. 최종 해상도에서 측정하세요.

7. 합성. 먼저 단일 프레임에서 composite_frame을 실행하세요. 배경 크기를 배우와 비교하고, 그림자 방향, 가장자리, 블랙 레벨을 확인한 후 확장하세요. 긴 작업은 덩어리로 렌더링하고 프레임 수를 확인하세요.

8. 인계. 특정 구간에서 트래킹을 신뢰할 수 없을 때, 아티스트에게 레이어드 패스와 정직한 프레임별 품질 플래그를 제공하고, 완성된 척하는 합성을 주지 마세요.

도구 맵

필요 사항MCP 도구CLI애드온
카메라 파일에서 렌즈/노출read_camera_metadatametadata플레이트 패널
내보내기를 카메라 파일과 정렬align_clipalign
피사체 거리solve_camera_distancedistance피사체 + 카메라
카메라 포즈, 렌더 크기plan_camera, build_shot_scene샷 카메라 생성
조명 리그plan_lights조명
실제 조명 켜짐/꺼짐 프레임practical_states깜빡임
CG 상태 렌더링render_statesCG 렌더링
매트 + 디스필key_framekey플레이트 도구
마커 트래킹track_markerstrack플레이트 도구
그림자 오프셋shadow_offsetshadow-offset
그레인measure_graingrain플레이트 도구
단일 프레임 합성composite_framecomp

도구 오류는 {"error": "..."}와 함께 원인을 반환합니다. 입력을 수정하고 재시도하세요. 블렌더는 헤드리스 작업으로 실행됩니다. 실행 중인 블렌더 창 내부에서 코드를 실행하는 소켓을 열려고 하지 마세요.

참고 자료 (해당 단계에서 읽으세요)

  • references/failure-modes.md - 무엇이 잘못되고, 왜, 그리고 해결책. 먼저 훑어보세요.
  • references/scale-and-distance.md - 카메라 거리 실수와 이를 방지하는 규칙.
  • references/lighting.md - 실제 키 라이트 찾기, 리그 구축 및 보정.
  • references/compositing.md - 매트, 네 가지 종류의 스필, 페데스탈, 부드러움, 라이트 랩, 확인 사항.
  • references/camera-metadata.md - 카메라 파일이 알려주는 것과 내보내기를 정렬하는 방법.
  • references/review.md - 자신을 속이지 않고 비평 에이전트를 사용하는 방법.
  • references/keying.md - 매트, 디스필, 가장자리 처리, 실제 푸티지가 가르쳐준 것.
  • references/tracking.md - 마커 트래킹, 안정화, 간격.
  • references/shadows-and-grain.md - 그림자 형상, 그레인 측정 및 매칭.
  • references/blender-notes.md - 헤드리스 작업을 위한 블렌더 4.2-5.x 스크립팅 노트.

관련 스킬