Communitygithub.com

리깅된 3D 렌더링

완전한 18관절 3D 골격 리깅 절차적 애니메이션, 순차적 프레임별 비디오 검사, 사용자의 정확한 폴더 기반 명령 워크플로에 따라 처음부터 오디오를 제작하는 스킬입니다.

리깅된 3D 렌더링란 무엇인가요?

이 스킬은 사용자가 제공한 참조 비디오와 음성 해설 오디오를 기반으로 1080×1920 해상도, 30fps의 완전한 3D 절차적 애니메이션 비디오를 처음부터 생성합니다. 핵심은 모든 프레임을 놓치지 않고 분석하는 순차적 프레임 검사와 18개의 관절로 구성된 3D 골격 리깅 캐릭터 시스템입니다. PyCairo, NumPy, FFmpeg를 사용하여 3D 폴리곤 깜빡임이나 왜곡 없이 안정적인 카메라 워크와 캐릭터 애니메이션을 구현하며, Sutherland-Hodgman 근평면 클리핑과 외적 법선 기반 후면 컬링을 필수적으로 적용합니다. 또한 사용자의 음성 해설과 동기화된 SFX와 배경 음악을 NumPy와 SciPy로 처음부터 합성하여 완전한 오디오 믹스를 제공하고, 최종 결과물로 자막 없는 여러 버전의 비디오와 분석 보고서를 생성합니다. Claude Code, Cursor 등 다양한 AI 에이전트 환경에서 사용할 수 있도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abdulahadofficial432-arch/Gemini_Argon_Video_Skills/tree/HEAD/Render%20Rigged%203D%20Videos%20Skill/Skills/Render%20Rigged%203D

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

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

미리보기

스킬 README에서

Train Video 3D Sheet 01 (0s–25s): Crouched Hacksaw on 3D Rail, Steam Locomotive Pass-By, Parallel Canyon Bridges, Union Station Gold Bullion & Purple-Faced Boss
Train Video 3D Sheet 02 (25s–50s): Side-Profile Macro 3D Rail Joint with Vernier Caliper, Welded Rival Track, Vandergold Parlor Car, Jolting Coach & Unobstructed Newspaper
Train Video 3D Sheet 03 (50s–76.67s): Silver Coin in May Gap, White Paper in July Gap, Crushing Rival Rails, Beach Umbrella Tycoon & Steel Arch Bridge Plunge
Japan Job Culture 3D Sheet 01: 3D Office Environments, Reclining Desk-Propped Poses & Articulated 18-Joint Walk Cycles
Japan Job Culture 3D Sheet 02: Dynamic 3D Camera Angles, Expressive Spherical Heads & Prop Interactions
Japan Job Culture 3D Sheet 03: Climax 3D Sequences & Zero-Caption Studio Finish

문서

Render Rigged 3D — 완전 스킬 및 사용자 명령 워크플로

1. 사용자가 명령을 내리는 방법 (사용자의 워크플로 방식)

사용자가 새로운 비디오 재창조 작업을 시작할 때마다 다음 정확한 워크플로를 따릅니다:

  1. 메인 작업 공간에 새 프로젝트 폴더 생성 (C:\Users\WayWe Work-Station\Downloads\Mate\<프로젝트 폴더>\) :
    • 사용자는 메인 작업 공간 폴더 안에 비디오 주제 이름으로 새 폴더를 만듭니다 (예: "Train Video", "Job Culture of japan", "Railroad Video", "The Window That Breaks Japan's Gambling Law", "80 Victories in a Plane Nobody Could See").
  2. 프로젝트 폴더 내 참조 비디오 + 음성 해설:
    • 해당 프로젝트 폴더 안에 사용자는 다음을 넣습니다:
      • 참조 비디오 (예: "Example video 1.mp4", "Jap vid.mp4", "My video 0.mp4", "My video 2.mp4").
      • 음성 해설 오디오 파일을 프로젝트 폴더에 직접 또는 음성 해설 하위 폴더 ("VoiceOver", "VoiceOver 01", "VoiceOver 02") 안에 넣고, 예를 들어 "Voiceover.mp3" 또는 "Audio.mp3"로 이름을 지정합니다.
  3. 사용자의 프롬프트 패턴:
    • 사용자는 당신에게 다음을 요청합니다:
      1. 참조 비디오를 프레임 단위로 (프레임 0부터 프레임 N-1까지) 엄격한 시간 순서대로 프레임을 건너뛰거나 샘플링하지 않고 읽고 분석하여, 모든 단일 프레임에서 다음을 확인합니다:
        • 정확한 프레임 번호 및 타임스탬프 (frame / fps)
        • 카메라 위치, 각도, 움직임 (dx, dy, 줌, 틸트, 롤) 및 샷 프레이밍
        • 보이는 모든 사람, 위치, 움직임, 표정, 신체 포즈, 손/손가락, 의류/액세서리
        • 물체, 차량, 배경/환경, 조명, 그림자, 텍스트/로고/간판, 시각 효과
        • 프레임 간 비교 (무엇이 바뀌었고, 무엇이 동일하게 유지되었는지, 움직임의 방향/크기, 새로 추가되거나 제거된 물체, 변형, 깜빡임 또는 생성 아티팩트)
      2. 정확히 동일한 비디오를 100% 처음부터 재창조하여 사용자의 음성 해설 파일을 사용하고, 정확한 시각 자료, 초집중형 관객 사로잡기 애니메이션, 캐릭터 리깅/움직임, 카메라 안무, 명확한 시각적 설명을 일치시킵니다 — 고정된 18관절 3D 골격 리깅 절차적 애니메이션 스타일로 자막 없이 100% 처음부터 만든 SFX 및 음악 스템으로 렌더링합니다.

2. 시각적 참조 및 렌더링된 3D 연락처 시트 (screenshots/)

A. 기차 비디오 — 18관절 3D 리깅 재창조 및 거시 열 물리학 (train_rigged_3d_sheet_01..03.jpg)

Train Video 3D Sheet 01 (0s–25s): Crouched Hacksaw on 3D Rail, Steam Locomotive Pass-By, Parallel Canyon Bridges, Union Station Gold Bullion & Purple-Faced Boss

Train Video 3D Sheet 02 (25s–50s): Side-Profile Macro 3D Rail Joint with Vernier Caliper, Welded Rival Track, Vandergold Parlor Car, Jolting Coach & Unobstructed Newspaper

Train Video 3D Sheet 03 (50s–76.67s): Silver Coin in May Gap, White Paper in July Gap, Crushing Rival Rails, Beach Umbrella Tycoon & Steel Arch Bridge Plunge

B. 일본의 직장 문화 — 18관절 3D 리깅 기업 애니메이션 (japan_rigged_3d_sheet_01..03.jpg)

Japan Job Culture 3D Sheet 01: 3D Office Environments, Reclining Desk-Propped Poses & Articulated 18-Joint Walk Cycles

Japan Job Culture 3D Sheet 02: Dynamic 3D Camera Angles, Expressive Spherical Heads & Prop Interactions

Japan Job Culture 3D Sheet 03: Climax 3D Sequences & Zero-Caption Studio Finish


3. 고정된 18관절 3D 골격 리깅 애니메이션 아키텍처

Render Rigged 3D로 생성된 모든 비디오는 100% 처음부터 만든 3D 절차적 엔진(PyCairo + NumPy + FFmpeg, 1080×1920, 30.00 fps) 을 사용해야 하며, 2D 막대기 인물 바로가기나 폴리곤 결함이 없어야 합니다:

A. 결함 없는 3D 카메라 및 폴리곤 파이프라인 (Camera3D, clip_and_project_poly, draw_box_3d)

  1. 진정한 3D 원근 카메라 (Camera3D) :
    • 월드 공간 pos = (x, y, z), target = (tx, ty, tz), fov, 더치 앵글 roll, 유기적인 핸드헬드 흔들림 (math.sin(t * 2.5) * 4.0), 빠른 돌리 푸시 인, 휩 팬, 크레인 틸트, 고주파 충격 흔들림을 지원합니다.
  2. Sutherland-Hodgman 3D 근평면 폴리곤 클리핑 (NEAR_Z = 45.0) :
    • 필수 안티-결함 규칙: z_cam을 단순히 클램핑하여 카메라 뒤로 교차하는 3D 정점을 절대 투영하지 마십시오. 원근 분할 전에 항상 모든 3D 폴리곤(clip_and_project_poly)을 카메라 근평면 z_cam >= 45.0에 대해 클리핑하여 긴 레일, 바닥, 벽, 다리가 화면을 가로질러 접히거나 뒤틀리지 않도록 하십시오.
  3. 결정적 3D 외적 법선 기반 후면 컬링:
    • 필수 안티-깜빡임 규칙: draw_box_3d에서 상자 면을 평균 정점 깊이로 정렬하지 마십시오 (이렇게 하면 인접한 면이 깊이 순서를 바꾸어 카메라가 움직일 때 깜빡입니다). 항상 외적 법선 기반 후면 컬링(np.dot(face_normal, cam.pos - face_center) > 0)을 사용하고 긴 지오메트리(예: 철도 레일 및 침목)를 뒤에서 앞쪽 세그먼트로 세분화하십시오.

B. 18관절 3D 관절 캐릭터 리그 (draw_rigged_character_3d)

모든 캐릭터는 18관절 골격 계층 구조를 사용하여 3D 월드 공간에서 애니메이션됩니다:

  • 몸통 및 머리 체인 (5개 관절): pelvis -> spine -> chest -> neck -> head
  • 왼쪽 및 오른쪽 팔 체인 (8개 관절): clavicle_L/R -> shoulder_L/R -> elbow_L/R -> wrist_L/R -> hand_L/R
  • 왼쪽 및 오른쪽 다리 체인 (6개 관절): hip_L/R -> knee_L/R -> ankle_L/R -> toe_L/R
  • 곡선 3D 관절 팔다리 (draw_curved_limb_3d) :
    • (어깨, 팔꿈치, 손목) 및 (엉덩이, 무릎, 발목)을 통한 부드러운 입방 베지어 관절 팔다리로 음영 처리된 3D 구형 손과 3D 신발이 포함됩니다.
  • 3D 구형 머리, 모자 및 얼굴 리그:
    • 방사형 그라데이션 3D 음영 처리된 구형 머리와 원근 단축된 눈, 동공, 눈썹, 입 표정 (neutral, grin, angry, rage, panic, worried, squint, closed_smile)이 (head_yaw, head_pitch, head_roll)에 따라 3D 구 표면을 회전합니다.
    • 주기적인 눈 깜빡임, 가슴 호흡 (math.sin(t * 4.5)), 땀방울, 역할별 3D 모자/조끼/정장 (engineer, boss, tycoon, foreman, veteran, worker), 특수 시각 상태(예: purple_anger는 머리를 보라색으로 전환하고 양쪽 귀에서 3D 흰색 증기 퍼프가 분출됨)를 포함합니다.
  • 가림 없는 전면 소품 레이어링 규칙:
    • 캐릭터가 읽을 수 있는 전면 소품(예: 신문, 간판, 문서)을 들고 있을 때마다 3D 상/하부 팔을 먼저 그리고(자연스럽게 소품 뒤에 위치하도록), 소품을 두 번째로 가슴 앞에 그리고, 흰색 3D 구형 손을 세 번째로 왼쪽 및 오른쪽 바깥 가장자리를 잡도록 그려 팔 선이 텍스트나 일러스트레이션을 가로지르지 않도록 합니다.

C. 크리스탈 클리어 비주얼 스토리텔링 및 거시 물리학 뷰

  • 음성 해설에 설명된 모든 개념은 명확한 3D 연출, 소품 및 전용 매크로 샷을 통해 화면에 시각적으로 설명되어야 합니다:
    • 매크로 3D 컷어웨이 및 게이지: 측정, 물리학 또는 메커니즘(예: 열 레일 팽창)을 설명할 때 전용 측면 프로필 3D 매크로 뷰(draw_macro_rail_joint_side_3d)를 구축하여 3D I-빔 프로파일, 볼트로 고정된 피쉬플레이트, 정확한 간격을 조이는 슬라이딩 금속 버니어 캘리퍼스, 상승하는 수은 온도계, 넘어가는 달력 (MAY -> JUNE -> JULY), 간격에 떨어지는 물리적 비교 물체 (은화 vs. 얇은 종이 한 장), 힘/응력 화살표 (==><==) 를 포함합니다.
    • 다중 서브 샷 시각적 페이싱: 더 긴 내러티브 문장을 별개의 시각적 서브 샷으로 나눕니다 (예: 서브 샷 A는 매크로 메커니즘을 보여주고 -> 서브 샷 B는 캐릭터가 반응하는 모습을 보여줍니다; 또는 서브 샷 A는 신문 헤드라인을 보여주고 -> 서브 샷 B는 승객들이 'ALL ABOARD!'를 향해 걷는 모습을 보여줍니다) 그래서 시각적 페이싱이 초집중적이고 매력적으로 유지됩니다.

3. 단계별 실행 프로토콜

새 프로젝트 폴더에서 트리거될 때마다:

1단계: 완전 순차적 프레임별 검사 (프레임 0부터 프레임 N-1까지)

  1. 참조 .mp4 비디오에서 analyze_every_frame.py를 실행하여 프레임 0부터 프레임 N-1까지 모든 단일 프레임을 프레임을 건너뛰지 않고 시간 순서대로 검사합니다.
  2. 완전한 순차적 프레임별 보고서를 <프로젝트 폴더>\Frame_By_Frame_Complete_Analysis_<N>_Frames.md에 저장합니다.
  3. 6×4 연락처 시트 .jpg 그리드 (초당 1프레임)와 48kbps .mp3 오디오 미리보기를 scratch/에 추출하고, read_file을 사용하여 모든 연락처 시트와 오디오 파일을 검사합니다 (원시 .mp4에 대해 read_file을 호출하지 마십시오).

2단계: 사용자의 음성 해설과 동기화된 100% 처음부터 만든 오디오 스템 합성

  1. 사용자의 음성 해설 파일(Voiceover.mp3 / Audio.mp3)의 정확한 지속 시간(VO_DURATION)을 측정하고 <프로젝트 폴더>\에 44.1 kHz 16비트 스테레오 Voiceover.wav 및 Voiceover.mp3로 변환합니다.
  2. NumPy + SciPy (scipy.signal.butter)를 사용하여 build_<프로젝트>_audio_stems.py를 작성하고 실행하여 다음을 합성합니다:
    • SFX.wav 및 SFX.mp3: 모든 시각적 동작과 동기화된 100% 처음부터 만든 물리 모델링 폴리 (예: 쇠톱질, 증기 기적, 휘슬 도플러, 금속성 쨍그랑, 동전/종이 떨어짐, 열적 신음, 충돌, 폭발).
    • Music.wav 및 Music.mp3: 감정적 호에 맞춘 100% 처음부터 만든 다중 막 영화/분위기 악보.
    • Full_Mixed_Audio.wav 및 Full_Mixed_Audio.mp3: Voiceover + SFX + Music을 결합한 최종 믹스로, 음성 해설이 선명하게 유지되도록 자동 엔벨로프 덕킹이 적용됩니다.

3단계: 18관절 3D 리깅 렌더 스크립트 빌드 및 미리보기 확인

  1. render_<프로젝트>_rigged_3d_from_scratch.py를 작성하여 모든 참조 샷과 시각적 설명을 정확한 VO_DURATION (TOTAL_FRAMES = int(math.ceil(VO_DURATION * 30)))에 매핑합니다.
  2. 필수 사전 렌더 시각적 확인 (preview 모드) :
    • python render_<프로젝트>_rigged_3d_from_scratch.py preview를 실행하여 3개의 연락처 시트(sheet_01.jpg, sheet_02.jpg, sheet_03.jpg, 0.0s .. VO_DURATION을 균등하게 포함하는 72개 타일)를 생성합니다.
    • read_file을 통해 3개의 연락처 시트를 모두 검사하여 다음을 확인합니다:
      • 3D 폴리곤 뒤틀림 또는 상자 면 깜빡임 없음
      • 소품/팔다리 겹침 없음 (신문/간판의 바깥 가장자리에 손, 모자/우산이 적절하게 레이어링됨)
      • 모든 스토리 비트와 물리적 메커니즘이 시각적으로 명확함
      • 음성 해설 자막 없음

4단계: 전체 30FPS 1080×1920 비디오 렌더링 및 전달물 확인

  1. python render_<프로젝트>_rigged_3d_from_scratch.py를 실행하여 모든 TOTAL_FRAMES 프레임을 1080×1920 (30.00 fps)으로 렌더링하고 Full_Mixed_Audio.wav와 먹싱합니다.
  2. <프로젝트 폴더>\에 필요한 모든 전달물이 포함되어 있는지 확인합니다:
    • Final_Video_No_Captions.mp4 (전체 혼합 오디오, 자막 없음)
    • Pure_3D_Procedural_From_Scratch_No_Captions.mp4 (순수 3D 리깅 렌더 복사본)
    • Video_Only_No_Captions_Muted.mp4 (깨끗한 음소거 비디오 마스터)
    • Frame_By_Frame_Complete_Analysis_<N>_Frames.md
    • Voiceover.wav 및 Voiceover.mp3
    • SFX.wav 및 SFX.mp3
    • Music.wav 및 Music.mp3
    • Full_Mixed_Audio.wav 및 Full_Mixed_Audio.mp3
    • scripts/ 전체 Python 생성기 스크립트 포함.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬