Hunyuan3D 2.1がGLBを返しても、テクスチャ処理の失敗を確認する
Hunyuan3D 2.1の公式ワーカープロセスは、テクスチャ生成に失敗すると、テクスチャのないメッシュにフォールバックします。形状、テクスチャ、使用先シーンへのインポートを別々に検収することで、「ファイルがある」ことを納品可能なアセットと取り違えずに済みます。
チームが1枚の参考画像からデモ用シーンに配置する静的な小道具を作る場合、Tencent Hunyuan 3Dは初期メッシュとテクスチャの生成を担えます。ただし、ワークフローに組み込む際の完了基準は、GLBファイルをダウンロードできたことではなく、使用先のシーンでの実際のアセットに置くべきです。本稿では、公式のオープンソース版Hunyuan3D 2.1のコードを基に検収手順を設計しています。生成テストは実行しておらず、このバージョンの動作をすべてのホスティング型サービスに当てはめるものでもありません。
公式のmodel_worker.pyには、見落としやすい分岐があります。まずテクスチャのないメッシュをエクスポートし、その後テクスチャ生成と形式変換を試みます。テクスチャ処理で例外が発生すると、最初のテクスチャなしメッシュを最終パスとして返します。そのため、後続処理がファイルを受け取れても、期待したテクスチャ付きの完成品が得られているとは限りません。自動化に組み込む際は、タスクのログと各段階の結果を保存し、「ジオメトリ生成成功」と「テクスチャ生成成功」を別々に記録すべきです。
テクスチャ処理に進む前に形状を確認する
デモ用の卓上オブジェを作る場合を例にすると、まず使用する権利のある参考画像を用意し、必ず残すべき輪郭の特徴を書き出します。公式のdemo.pyは2段階の処理を示しています。形状パイプラインがメッシュを生成してdemo.glbを出力し、その後テクスチャパイプラインがメッシュのパスと参考画像を受け取り、demo_textured.glbを出力します。これにより各段階を分けて確認できますが、サンプル自体がそのアセットの使用先シーンへの適合性を証明するわけではありません。
まずテクスチャなしの表示でモデルを回転させ、正面、側面、背面から、輪郭、薄い面、底部を確認することを勧めます。参考画像に写っていない部分は、特に人による判断が必要です。形状が要件を満たさない場合は、参考素材の見直しやモデル修正に戻ります。テクスチャを加えれば構造が修正されると期待してはいけません。形状が確認を通過してからマテリアルの処理に進み、手戻りの原因を特定しやすいように、両段階のファイルを別々に保存します。
ローカルで実行する前には、リソースも確認します。リポジトリのREADMEに記載されたGPUメモリ要件は、形状生成が10GB、テクスチャ生成が21GB、全工程では29GBです。これは公式の動作環境の説明であり、本稿で測定したピーク値ではありません。形状生成だけが実行できても、全工程を実行できるとは限りません。バッチ処理の生産能力を約束する前に、導入担当者が使用するバージョンと実機で一連の処理全体を検証する必要があります。
引き渡し時にはファイルだけでなくシーンを検証する
テクスチャ処理が終わったら、結果を開いてマテリアルが実際に存在することを確認します。ログにフォールバックが記録されている場合は、納品完了ではなく、テクスチャ追加待ちとしてタスクを扱います。次に、実際に使用するエディターやエンジンにアセットをインポートし、使用先の照明条件で見た目、スケール、向きを確認します。受け取る側にも、ポリゴン削減、コリジョン形状、その他の加工が必要かを確認してもらいます。これらは推奨する納品時の確認項目であり、コードが自動で行う検収ではありません。
静的な小道具の初稿をすばやく得たいチームにとって、このような段階別の手順は、失敗を適切な段階で止めるのに役立ちます。アニメーション用のリグを設定できるキャラクター、寸法が正確な部品、既存のトポロジー規約を満たすモデルをそのまま納品することが要件であれば、生成ファイルだけで合格とは判断できません。専用のモデリング工程と技術的な検収工程を残すべきです。本格的に使用する前には、使用するモデルのバージョンのライセンスと参考素材の権利も確認します。まず一つのアセットで生成、確認、インポート、受け取りまでの全工程を通してから、バッチタスクへ拡大するかを判断します。
内容説明:本記事は公開情報をもとに整理した、ツール選定の参考情報です。機能、料金、関連ポリシーは随時変更される場合があります。最新の公式情報をご確認ください。
元の出典:github.com