NEW · 2026.01.30 업데이트
SSB 파이프라인 튜토리얼
SSB Tools의 기본 워크플로우를 빠르게 익히기 위한 웹 튜토리얼 페이지입니다.
단계별로 Maya, Unreal, Blender 연동과 미디어 처리 프로세스를 학습할 수 있도록 구성했습니다.
빠른 시작
핵심 폴더 구조와 실행 배치 파일을 확인하고 5분 안에 환경을 준비합니다.
추천: run_in_venv.bat로 파이썬 환경 실행
GUI 워크플로우
PySide6 기반 UI 사용법과 드래그&드롭 처리, 상태 로그 확인 방법을 안내합니다.
미디어 파이프라인
ffmpeg 변환 큐, 진행률 파싱, 오류 메시지 처리 흐름을 이해합니다.
Unreal 연동
unreal 모듈 초기화와 메시지 박스 기반 에러 핸들링 패턴을 다룹니다.
학습 트랙
1. 프로젝트 구조 이해
Prism2, scripts, maya, unreal 폴더 구성 파악
2. 필수 환경 세팅
ssb_setEnv.bat, run_in_venv.bat, 의존성 설치
3. 툴 실행 & 로그 확인
GUI 런처 실행, 상태 로그와 에러 다이얼로그 확인
4. 배치 처리 실습
MediaConverter/Process Pin 툴로 대량 작업 흐름 학습
환경 설정 체크리스트
- J: 드라이브 연결 및 권한 확인
- scripts/requirements.txt 설치
- qdarktheme 테마 로딩 확인
- MAYA_MODULE_PATH, PYTHONPATH 설정
Python
3.11 이상 권장
GUI
PySide6, WindowsVista 스타일
Media
ffmpeg/bin 경로 확인
자주 묻는 질문
Q. 실행 시 검은 창에서 바로 종료됩니다.
A. run_in_venv.bat로 실행하고 경로 권한을 확인하세요.
Q. 드래그&드롭이 동작하지 않습니다.
A. setAcceptDrops(True)와 이벤트 오버라이드 여부를 점검하세요.
Q. ffmpeg 진행률이 표시되지 않습니다.
A. stderr 로그에서 time= 패턴을 파싱 중인지 확인하세요.