リソースと一緒に旅する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ファイルもレンダリングも提供されません。

コピーの前に、プロジェクトが再現すべきものを決める

まずは成果物を特定しましょう。静止画、アニメーション、バリエーション展開のどれかを明確にします。使用ソフトウェアとそのバージョン、レンダリングエンジン、アクティブなカメラ、シーン、寸法、品質設定を記録してください。アニメーションの場合は、フレームレートと包含範囲の開始・終了フレームも加えます。開いたシーンが必ずしも同じテクスチャ、同じキャッシュ、正しいフレーミングを再現するとは限りません。

作業は固定したバージョンで行い、オリジナルは保管しておきましょう。実際に使用したアセットと、断念した試行錯誤のファイルは分けて管理します。名前がほとんど同じ2つのテクスチャが、マテリアルの差異の原因になっていることもあります。モデル、画像、ライブラリの転送権についても確認してください。Pliパックは、自身のスクリプト、ドキュメント、モチーフ、記述されたジオメトリにMITライセンスを提供していますが、あなたが追加したものには別の条件が適用される場合があります。

Pliでは、scene.jsonが出発点となる仕様書の役割を果たします。対象バージョン、10個のオブジェクトの一覧、グラフィック依存関係、エンジン、image 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 を外してください。スクリプトは既存の出力の上書きを拒否します。2回目の試行は新しい展開先で行います。--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 は .blend を 2 つ目の Blender プロセスで開きます。このとき内部スクリプトの実行は無効化されています。インベントリ、カメラ、出力設定、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 枚しかなく、キャッシュは不要です。煙、布、シミュレーションを追加する場合は、キャッシュの種類、計算バージョン、保存場所、および有効な全範囲を明記してください。事前計算の仕組みは物理システムによって異なるため、あるキャッシュの挙動を他のすべてに一般化しないでください。

コピーする前に結果を確定させてください。シーケンスの場合は、開始、終了、シーンやシミュレーションの切り替わりに加えて、各中間ファイルが存在するかどうかも確認してください。見た目が正しい 3 枚の画像があっても、1 から 96 までのアニメーションの 96 ファイルすべてが揃っている証拠にはなりません。キャッシュが納品されるのか、それとも再計算が必要なのか、どのパラメータとどの入力を使うのかを明確に示してください。

テクスチャ、ボリューム、サウンド、編集メディアのシーケンスにも同じ考え方を適用してください。ZIP 作成後に唯一のソースを削除しないでください。コピーを開き、出力を確認して復元できるようになるまで保管してください。

色、メモリ、時間：真のプロジェクトを測る

Pli パターンはベースカラー用で、sRGB として宣言されています。ノーマルやディスプレイスメントを記述するマップは役割が異なり、その解釈はデータと一致していなければなりません。出力を比較する際は、表示トランスフォームと露出も維持してください。色の違いは表示パイプラインに起因することがあり、計算能力とは無関係です。

ZIP のサイズは GPU メモリの必要量を示しません。評価されたジオメトリ、実際に読み込まれるテクスチャ、レンダリングの各ステップは、アーカイブ内のファイル数よりも重要です。小さな CPU プレビューでは、メモリのピークも GPU での最終レンダリング時間も予測できません。構成を選ぶ前に、最終解像度で代表的な完全出力を測定してください。

3D ワークショップは、この確認の枠組みづくりに役立ちます。次にGPU 構成を互換性と観測されたピークに基づいて比較し、プロジェクトに適した余裕を確保してください。コンフィギュレーターで 3日、7日、30日から選び、キックオフ、テスト、フィードバック、計算、リカバリをカバーしましょう。ただし、これらの期間のいずれか一つだけでレンダリング納期が保証されるわけではありません。エクスポートガイドは、納品ファイルまで作業を進めるのに役立ちます。

確認済みの点と、これから実行する点

以下の7つのチェックは、Windows上でPython 3.14.6を使用して実行されました。パックにはマニフェストを含む14個のファイルが含まれており、そのうち13個のファイルがそのハッシュ値でカバーされています。テクスチャはこの環境で再構築され、バイト単位で比較されました。このPNGの一致は、バージョン間またはハードウェア間での3Dレンダリングの同一性を証明するものではありません。

チェックの対象はファイル、その依存関係、および転送エラーです。.blendの生成、シーンの検査、CPUまたはGPUでのレンダリングはテストされていません。READMEには、Blender 4.5.x LTSでこれらを検証する手順が記載されています。