Pixor 매뉴얼

Pixor는 3D 아트를 픽셀 아트로 바꿉니다. 결과는 손으로 찍은 픽셀처럼 보이고, 결정적이며(같은 프로젝트는 매번 같은 픽셀을 내고, 다른 컴퓨터에서도 거의 언제나 같습니다: 자주 묻는 질문 참고), 생성형 AI를 쓰지 않습니다.

앱은 왼쪽에서 오른쪽으로 네 단계입니다: 장면(3D 오브젝트 준비), 액션(액션을 노드로 만들고 3D에서 매끄럽게 재생), 스타일(픽셀을 만드는 방식 선택), 에셋(액션을 스프라이트 프레임으로 자르고 시트와 파일로 묶기). 간단한 작업은 이 순서대로 진행하고, 큰 작업은 필요한 만큼 오갑니다. 작업 공간 탭 옆의 헤더에 있는 카메라, 액션, 스타일, 에셋 선택이 모든 단계에 표시될 것을 정합니다. 가져오기 옆의 내보내기는 에셋 파이프라인을 폴더에 쓰는 창을 엽니다.

각 단계의 작업 공간에는 그 단계의 패널만 있습니다. 아웃라이너, 3D 뷰, 장면 그래프는 장면에 속합니다. 액션 목록, 3D 뷰, 액션 그래프, 재생하고 키를 넣는 타임라인, 클립 편집기는 액션에 속합니다. 스타일 목록, 2D 뷰, 스타일 그래프(왼쪽에 노드 라이브러리)는 스타일에 속합니다. 에셋 목록, 2D 뷰, 액션을 스프라이트 목록으로 잘라 파일로 묶는 에셋 그래프(그 뒤에 손으로 프레임을 고르는 타임라인)는 에셋에 속합니다. 인스펙터와 기록은 네 단계 모두에 있으며, 인스펙터는 그 단계와 관련된 것을 보여 줍니다. 패널 메뉴로 그 단계에 쓰이는 패널을 추가할 수 있고, 어떤 패널이든 원하는 곳으로 끌어 놓을 수 있습니다. 패널 초기화로 원래대로 되돌립니다.

이 매뉴얼은 현재 빌드된 Pixor를 설명합니다. 계획은 docs/roadmap.md에 있으며, 매뉴얼은 계획이 아니라 앱을 따릅니다.

• 빠른 시작: 5분 만에 모델에서 스프라이트 시트까지.
• 장면: 네 단계와 그 작업 공간, 3D에서 둘러보기, 카메라, 조명, 도형, 액션과 키, 실행 취소 기록.
• 장면 그래프와 블루프린트: 군중과 배열을 그래프로, 장면의 모든 것을 노드로, 그리고 어떤 모델에든 실행할 수 있는 레시피.
• 이미지와 글자: 장면 속 이미지와 텍스트, 3D 글자, 이미지에서 가져온 팔레트.
• 볼륨: .vdb 파일 또는 내장된 연기, 불, 액체.
• 월드: 지형, 풀, 잎, 물, 구름, 바람, 빛줄기, 시간대, 청크로 나눈 큰 맵.
• 설정: 인스펙터의 모든 설정을 전후 이미지와 함께.
• 스타일 그래프: 카메라의 렌더에서 프레임까지, 모든 단계가 노드여서 다시 연결하고, 마스크하고, 섞을 수 있습니다.
• 에셋 그래프: 액션을 프레임으로, 프레임을 파일로 자르는 Sprites 노드를 그래프로. 렌더 하나로 여러 시트, 색 옆에 선, 템플릿으로 만든 텍스트 파일.
• 엔진으로 내보내기: Godot, Unity, GameMaker, Aseprite, 그리고 JSON이 딸린 일반 시트.
• 명령줄: pxr render, pxr batch, 프로젝트, 골든 테스트.
• FAQ: 깜빡임, 아주 작은 스프라이트, 팔레트, FBX의 특이점.

프로젝트 일부를 파일 하나로 공유합니다. 어느 그래프의 그룹이든, 스타일, 프리셋, 에셋 파이프라인 모두 키트(.pixorkit)로 옮겨지며, 파일에 무엇인지 적혀 있습니다. 제공되는 곳마다 키트 저장…으로 키트를 쓰고 키트 사용…으로 사용합니다. pxr kit show FILE.pixorkit는 키트에 무엇이 들었는지 알려 줍니다.

이 매뉴얼의 이미지는 scripts/docs_images.sh가 렌더링합니다. 설정 이미지는 테스트용 기사로, 앱 화면은 라이브러리의 고블린으로 만들므로 항상 현재 버전의 결과를 보여 줍니다.