리소스와 함께 이동하는 Blender 씬.

Pli 프로젝트: 범위가 명확한 씬 레시피

Pli는 이 연습을 위해 고안된 가상의 플라스크입니다. 부드러운 모서리의 보라색 몸체, 새틴 마감의 주황색 칼라, 셰브론 라벨, 점토 받침대로 구성됩니다. 생성기는 스튜디오 조명과 왼쪽에 여백을 둔 구도를 설정합니다. 오브젝트와 재질을 만들며, 유일한 외부 이미지는 512 × 512픽셀의 원본 PNG 패턴으로, 이를 재현하는 프로그램도 함께 제공됩니다. 모델, HDRI, 폰트, 클라이언트 파일은 필요하지 않습니다.

대상은 Cycles를 사용하는 Blender 4.5.x LTS입니다. 이 폴더는 시뮬레이션이나 확장 기능이 없는 정지 이미지용입니다. 이 선택이 명확히 유지되도록 생성기는 다른 Blender 브랜치를 거부합니다. 파일 검증에는 Python 3.10 이상이면 충분하지만, 씬을 구성하려면 Blender에 내장된 Python이 필요합니다.

Pli는 Blender 4.5.x LTS로 실행할 생성기를 제공합니다. 파일과 오류 사례는 Python 3.14.6에서 검증되었으며, 씬 생성, 열기 및 렌더링은 Blender에서 테스트가 남아 있습니다. .blend 파일이나 렌더링은 제공되지 않습니다.

복사 전에, 프로젝트가 재현해야 할 것을 정하기

먼저 결과물을 파악하세요: 정지 이미지, 애니메이션 또는 변형 시리즈. 소프트웨어와 버전, 엔진, 활성 카메라, 씬, 크기 및 품질 설정을 기록하세요. 애니메이션의 경우 프레임 레이트와 양 끝 프레임을 포함하세요. 씬이 열린다고 해서 같은 텍스처, 같은 캐시, 올바른 구도가 반드시 재현되는 것은 아닙니다.

고정된 버전에서 작업하고 원본을 보관하세요. 사용된 리소스와 포기한 탐색을 분리하세요. 이름이 거의 같은 두 텍스처가 재질 차이를 설명할 수 있습니다. 모델, 이미지 및 라이브러리의 전송 권한도 확인하세요. Pli 팩은 자체 스크립트, 문서, 패턴 및 설명된 지오메트리에 MIT 라이선스를 제공합니다. 여러분의 추가 사항에는 다른 조건이 적용될 수 있습니다.

Pli에서 scene.json은 출발 기록의 역할을 합니다: 대상 버전, 열 개 오브젝트 목록, 그래픽 종속 항목, 엔진, 이미지 1 및 출력 대상. 또한 이 프로젝트에 존재하지 않는 것도 명시합니다: 연결된 라이브러리, 폰트, 캐시 및 애니메이션. 선언된 부재는 빈 폴더를 잊힌 리소스로 착각하는 것을 방지합니다.

각 파일에 역할이 있는 디렉터리 구조

버전이 지정된 루트, 여기서는 blender-v1을 유지하고, 작업 전에 아카이브를 추출하세요. 아래의 분리는 이미지의 출처, 편집 가능한 프로젝트 및 납품할 결과물을 찾을 수 있게 합니다. 보편적인 규칙을 강제하지는 않습니다. 무엇보다 여러분의 메시지 기록 없이도 폴더를 이어받는 사람이 이해할 수 있는 이름을 사용하세요.

배포되는 소스는 manifest.sha256.json에 크기와 해시와 함께 기재됩니다. 매니페스트는 순환 참조를 피하기 위해 자기 자신을 제외합니다. 향후 생성될 .blend, PNG 및 보고서는 출력물입니다: 검증 후 여러분 자신의 납품 목록에 포함해야 합니다.

Blender를 실행하기 전에 추출된 ZIP을 확인하세요

압축을 푼 폴더의 루트에서 독립적인 Python으로 검증기를 실행하세요. 검증기는 13개 파일을 매니페스트와 대조하고, 레시피·경로·PNG를 확인한 뒤 4개 스크립트의 구문을 분석합니다. 온전한 팩에서 기대되는 결과는 ok: true와 종료 코드 0입니다. 이 점검은 bpy를 불러오지 않으며 어떤 3D 이미지도 생성하지 않습니다.

저희 테스트는 다른 위치에 압축을 푼 ZIP에서 시작합니다. 검증 과정은 이 복사본과 사용된 Python 디렉터리에서만 읽기를 허용하며, 원본 레시피에 접근하려는 시도는 명시적으로 거부됩니다. 따라서 성공 여부는 제작 폴더에서 조용히 되찾은 텍스처에 의존하지 않습니다.

코드 1이 나오면 오류 목록을 읽어야 합니다. 경고를 없애기 위해 지문을 다시 쓰지 마세요. 온전한 아카이브를 다시 받거나, 장면을 수정하려면 별도의 작업 버전을 만드세요. 동일한 지문은 매니페스트 대비 파일의 무결성을 증명할 뿐, 시각적 품질이나 작성자의 신원을 증명하지는 않습니다.

python validate_pack.py --root . --json

플라스크 재구성 및 소규모 CPU 렌더링 요청

다음 명령은 Blender 4.5.x LTS가 설치된 워크스테이션에서 실행할 절차입니다. 이 문서를 준비하는 과정에서는 실행하지 않았습니다. 별도의 프로세스에서 실행하세요. 이 스크립트는 빈 씬에서 시작합니다. Windows에서 blender가 PATH에 없다면 실행 파일의 전체 경로를 사용하세요. PowerShell에서는 이 경로를 따옴표로 감싼 뒤 앞에 &를 붙이세요.

이 생성기는 먼저 팩을 검사하고, 오브젝트를 만들고, 복사본에서 텍스처를 불러와 적용한 뒤 02_projet/renderparcel_pli_v1.blend를 저장합니다. 저장되는 파일은 Cycles CPU, 1,200 × 750 픽셀, 64 샘플 및 이미지 1을 사용하도록 설정됩니다. 이어서 --render-preview 옵션은 디노이징 없이 480 × 300 픽셀, 16 샘플의 PNG를 요청합니다. 이 수치들은 설정값일 뿐 성능 측정치가 아닙니다.

reconstruction.json 보고서는 작업이 성공한 뒤에 작성되며 렌더가 실제로 실행되었는지 명시합니다. .blend만 만들려면 -- --render-preview를 제거하세요. 이 스크립트는 기존 출력을 덮어쓰지 않습니다. 두 번째 시도는 새로 추출한 폴더에서 이루어집니다. --python-exit-code 1 옵션을 사용하면 프로세스의 종료 코드로 스크립트 예외를 확인할 수 있습니다.

blender --background --factory-startup --python-exit-code 1 --python generate_scene.py -- --render-preview

상대 경로: 복사를 잊지 않고 위치 설명하기

Blender에서 //로 시작하는 경로는 .blend 파일의 위치를 기준으로 합니다. Pli 프로젝트는 02_projet에 있게 되므로, 텍스처는 //../03_ressources/pli-chevron.png로 지정할 수 있습니다. 리소스 폴더는 프로젝트와 함께 이동합니다. 그럼에도 생성기는 복사본에서 확인된 절대 경로로 시작해 이미지를 포함시킨 뒤, 저장 전에 상대 경로를 기록합니다.

기존 프로젝트의 경우, 먼저 .blend 파일을 전송 폴더에 저장하세요. File → External Data에서 Make Paths Relative는 참조를 변환하지만, 리소스를 복사하지는 않습니다. Report Missing Files는 끊어진 링크를 찾는 데 도움이 됩니다. Find Missing Files는 선택한 폴더에서 파일을 검색하고 참조를 절대 경로로 복구할 수 있으니, 전송 전에 다시 확인하세요.

«이 컴퓨터에서 찾음»과 «폴더에 있음»을 혼동하지 마세요. 다운로드 폴더에서 여전히 접근 가능한 텍스처는 누락을 숨길 수 있습니다. 복사 후에는, 독립적인 백업을 유지한 채, 이전 위치가 더 이상 링크를 충족할 수 없는 환경에서 프로젝트를 열어 보세요.

포함 가능한 리소스는 포함하고 나머지는 목록화하기

Pack Resources를 사용하면 적격한 리소스를 .blend에 포함할 수 있으며, 저장하면 이 작업이 전송되는 파일에 실제로 반영됩니다. 이것이 모든 종속성을 하나로 모으는 것은 아닙니다. 동영상이 문서화된 반례입니다. 링크된 라이브러리에는 별도의 포함 명령이 있습니다. 따라서 무엇이 포함되고 무엇이 프로젝트 옆에 남아 있어야 하는지 목록을 작성하세요.

Pli의 경우, 외부 PNG를 유지하면 수정이 쉬운 반면, 포함하면 저장된 파일에서 패턴을 다시 찾을 수 있어야 합니다. 텍스처를 수정한 후에는 실제로 사용되는 리소스를 업데이트한 다음 올바른 버전을 저장해야 합니다. 인접한 PNG를 단순히 교체하는 것만으로는 .blend가 새로운 픽셀을 사용한다는 것을 입증하지 못합니다.

두 번째 프로세스에서 다시 열고 실제 수령 확인서 작성

재구성이 성공하면 inspect_scene.py가 내부 스크립트 실행을 비활성화한 상태로 두 번째 Blender 프로세스에서 .blend를 엽니다. 이 스크립트는 인벤토리, 카메라, 출력 설정, AgX 변환, 포함된 텍스처와 그 상대 경로를 점검합니다. 보고서는 열기와 데이터를 설명할 뿐, 렌더 품질을 입증하지는 않습니다.

생성된 PNG를 이미지 뷰어에서 여세요. 병이 프레임 안에 완전히 들어 있는지, 라벨에 크림색, 보라색, 주황색 패턴이 보이는지, 받침대와의 접촉면이 읽히는지, 자홍색 텍스처가 나타나지 않는지 확인하세요. 이 기준들은 수령 의도일 뿐이며, 우리는 이 팩을 위해 계산된 Blender 참조 이미지를 게시하지 않습니다.

06_livraison/modele-reception.csv를 06_livraison/reception-executee.csv로 복사한 다음 이 새 문서를 작성하세요. 템플릿은 그대로 두세요. 템플릿은 매니페스트에 속합니다. 검증기는 소스의 지문을 변경하지 않고 작성된 사본을 허용하며, 우리의 수령 테스트에서 이를 확인했습니다. 그런 다음 이 문서와 승인된 출력물을 배송 아카이브에 목록화하세요.

blender --background --factory-startup --python-exit-code 1 --python inspect_scene.py

누락된 종속성은 검사를 중단시켜야 합니다

팩의 부정 테스트는 소스를 건드리지 않고 시험용 사본에서 pli-chevron.png를 제거합니다. 그러면 검증기는 코드 1을 반환하고 인벤토리에서 누락된 파일과 레시피의 누락된 종속성을 모두 식별합니다. 생성기도 이 동일한 검사로 시작합니다. 즉, 불완전한 사본으로는 계속 진행을 거부해야 합니다.

또 다른 시험은 PNG의 첫 번째 바이트를 변조합니다. 검사는 다른 지문과 유효하지 않은 이미지 시그니처를 감지합니다. 세 번째는 경로를 폴더 밖을 가리키는 참조로 바꾸며, 이 역시 거부됩니다. 이 시험들은 전송의 구체적인 결함을 검증합니다. Blender 열기나 애니메이션 내 캐시 소실을 시뮬레이션하지는 않습니다.

테스트를 다시 하려면 추가로 추출한 사본에서만 작업하고 온전한 사본을 보관하세요. 수정은 올바른 리소스와 예상 위치를 되찾는 것입니다. 같은 이름을 가진 다른 텍스처는 무결성 검사를 통과하지 못합니다.

애니메이션을 추가하면 검사 범위가 바뀝니다

Pli 씬은 이미지가 하나뿐이라 캐시가 전혀 필요하지 않습니다. 여기에 연기, 천 또는 시뮬레이션을 추가한다면 캐시 유형, 계산 버전, 위치, 그리고 전체 유효 범위를 문서화하세요. 사전 계산 방식은 물리 시스템에 따라 달라지므로, 한 캐시의 동작을 다른 모든 캐시에 일반화하지 마세요.

복사하기 전에 결과를 고정하세요. 시퀀스의 경우 시작과 끝, 배경 또는 시뮬레이션의 변경 지점뿐 아니라 모든 중간 파일의 존재 여부까지 확인하세요. 시각적으로 올바른 세 장의 이미지가 1부터 96까지의 애니메이션에 포함된 96개 파일이 모두 준비되었음을 증명하지는 않습니다. 캐시가 함께 제공되는지 아니면 다시 계산해야 하는지, 그리고 어떤 파라미터와 입력으로 그렇게 해야 하는지 명확히 밝히세요.

텍스처, 볼륨, 사운드, 편집 미디어 시퀀스에도 같은 논리를 적용하세요. ZIP을 만든 뒤 유일한 원본을 삭제하지 마세요. 복사본을 열어 출력을 확인하고 복구할 때까지 원본을 보관하세요.

색상, 메모리, 시간: 실제 프로젝트를 측정하기

Pli 패턴은 기본 색상에 사용되며 sRGB로 선언되었습니다. 노멀이나 변위를 설명하는 맵은 역할이 다르므로, 그 해석이 데이터와 일치해야 합니다. 출력을 비교할 때는 디스플레이 변환과 노출도 유지하세요. 색상 차이는 계산 성능과 무관하게 디스플레이 체인에서 비롯될 수 있습니다.

ZIP의 용량은 GPU 메모리 요구량을 알려주지 않습니다. 평가된 지오메트리, 실제로 로드된 텍스처, 렌더링 단계가 아카이브의 파일 개수보다 더 중요합니다. 작은 CPU 미리보기로는 GPU 최종 렌더링의 메모리 피크도, 소요 시간도 예측할 수 없습니다. 구성을 선택하기 전에 최종 해상도에서 대표성 있는 전체 출력을 측정하세요.

3D 워크숍이 이 점검의 틀을 잡는 데 도움이 됩니다. 그다음 호환성과 관측된 피크를 기준으로 GPU 구성을 비교하되, 프로젝트에 맞는 여유를 두세요. 설정 도구에서 3일, 7일 또는 30일을 선택해 개봉, 테스트, 반품, 계산, 복구를 포괄하세요. 이 기간 중 어느 것도 그 자체로 렌더링 소요 시간을 보장하지는 않습니다. 내보내기 가이드가 납품 파일까지 작업을 이어줍니다.

무엇이 검증되었고, 무엇이 아직 실행되어야 하는가

아래 일곱 가지 점검은 Windows에서 Python 3.14.6으로 실행되었습니다. 팩에는 매니페스트를 포함해 열네 개의 파일이 들어 있으며, 그중 열세 개가 지문으로 검증됩니다. 텍스처는 이 환경에서 재구성되어 바이트 단위로 비교되었습니다. 이 PNG의 동일성이 버전이나 하드웨어 간 3D 렌더링의 동일성을 증명하지는 않습니다.

점검은 파일, 그 종속성, 전송 오류를 대상으로 합니다. .blend 생성, 씬 검사, CPU 또는 GPU 렌더링은 테스트되지 않았습니다. README에는 Blender 4.5.x LTS에서 이를 검증하는 절차가 나와 있습니다.