1. 3D パッケージのフォーマット

3D パッケージの初期化

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

3D zip パッケージには、MTL 形式 (マテリアル テンプレート ライブラリ) ファイル、OBJ 形式 (オブジェクト) ジオメトリ定義ファイル、およびテクスチャ ファイル (画像) が含まれます。

テクスチャは、3D アセットの表面にマッピングされた画像です。 テクスチャ ファイルは、MTL ファイルおよび OBJ ファイルと同じフォルダーに配置します。 テクスチャが正しく参照されている場合、3D アセットは自動的にレンダリングされます。

つまり、3D zip パッケージには次のものが含まれている必要があります。

  • マテリアル ファイル (MTL)
  • モデルファイル (OBJ)
  • テクスチャファイル (JPG、PNG、TIFF、TGAなど)

例:

サンプルの fruitful 3D can zip パッケージをダウンロードして開いてください。

パッケージに次のファイルが含まれていることがわかります。

  • canTut14a.mtl: マテリアル ファイル
  • canTut14a.obj: モデル ファイル
  • a_fruitful_uv_map.jpg: テクスチャ ファイル
  • aluminum.jpg: テクスチャ ファイル
  • can_ring_pull_end_centre.png: テクスチャ ファイル

[!警告] 3D レンダリングにはサブファイルが含まれません。すべてのファイルを zip パッケージの最初のレベルに配置してください。

[!警告] OBJ ファイルだけをアップロードすることはできません。MTL ファイルが必須です。

MTL ファイル

MTL ファイルは、Adobe Photoshop や Autodesk Maya などの 3D オブジェクト編集アプリケーションで使用されるマテリアル設定ファイルです。 これは OBJ ファイルと一緒に保存され、プログラムがオブジェクトにテクスチャを適用する方法を示します。 MTL ファイルには、テクスチャ ビットマップ ファイルの名前と、それらをオブジェクトに適用するために必要な 3D 座標が含まれています。

単一の .mtl ファイルは複数のマテリアルを定義することができます。 このファイルは、次の newmtl コマンドで始まる各マテリアルを一つずつ定義します。

# cube.mtl
# Material Count: 1
newmtl Cube
Ns 500
Ka 0.8 0.8 0.8
Kd 0.8 0.8 0.8
Ks 0.8 0.8 0.8
d 1
illum 2
map_Kd aluminum.jpg

[!警告] テクスチャ ファイルにマッピングしても、このファイルを 3D zip パッケージに含めない場合、3D アセットはレンダリングされません。

OBJ ファイル

OBJ ファイル形式は、3D ジオメトリを表す単純なデータ形式です。

オブジェクト ファイルは ASCII 形式 (.obj) である必要があります。

[!警告] Sitecore Content Hub™ はバイナリ形式 (.mod) でのオブジェクト ファイルをサポートしていません。

次のデータ型を .obj ファイルに含めることができます。

  • 幾何学的頂点 (v)
  • テクスチャの頂点 (vt)
  • 頂点法線 (vn)
  • パラメーター空間の頂点 (vp)
  • 自由形式の曲線/サーフェス属性
  • 曲線またはサーフェス タイプの以下の有理または非有理フォーム。
    • 基底行列
    • ベジエ
    • B スプライン
    • カーディナル、テーラー (cstype)
  • 角度 (deg)*
  • 基底行列 (bmat)*
  • ステップ サイズ (step)*
  • ポイント (p)
  • (l)
  • (f)
  • 曲線 (curv)
  • 2D 曲線 (curv2)
  • サーフェス (surf)
  • パラメーター値 (parm)
  • 外側のトリミング ループ (trim)
  • 内側のトリミング ループ (hole)
  • 特殊曲線 (scrv)
  • 特殊ポイント (sp)
  • End ステートメント (end)
  • 接続 (con)
  • グループ名 (g)
  • スムーシング グループ (s)
  • マージ グループ (mg) - オブジェクト名 (o)
  • ベベル補間
  • 色の補間 (c_interp)
  • ディゾルブ補間 (d_interp)
  • 詳細レベル (lod)
  • マテリアル名 (usemtl)
  • マテリアル ライブラリ (mtllib)
  • シャドウ キャスト (shadow_obj)
  • レイ トレーシング (trace_obj)
  • 曲線近似法 (ctech)
  • 表面近似法 (stech)

次の例で、.obj ファイルは cube.mtl ファイルを参照しています。

# cube.obj 
#referencing cube.mtl
mtllib cube.mtl
o 3D_model_of_a_Cube
v 0.000000 0.000000 -30.000000
v 0.000000 30.000000 0.000000
v 0.000000 30.000000 -30.000000
v 0.000000 0.000000 0.000000
v 30.000000 30.000000 0.000000
v 30.000000 0.000000 -30.000000
v 30.000000 30.000000 -30.000000
v 30.000000 0.000000 0.000000
vn -1.0000 0.0000 0.0000
vn 1.0000 0.0000 0.0000
vn 0.0000 0.0000 1.0000
vn 0.0000 0.0000 -1.0000
vn 0.0000 -1.0000 0.0000
vn 0.0000 1.0000 0.0000
g 3D_model_of_a_Cube_3D_model_of_a_Cube_None
usemtl Cube
s off
f 1//1 2//1 3//1
f 4//1 2//1 1//1
f 5//2 6//2 7//2
f 5//2 8//2 6//2
f 8//3 5//3 4//3
f 4//3 5//3 2//3
f 7//4 6//4 1//4
f 7//4 1//4 3//4
f 1//5 6//5 4//5
f 4//5 6//5 8//5
f 7//6 3//6 2//6
f 7//6 2//6 5//6

[!警告] Sitecore Content Hub™ は、3D アセットへのマルチマテリアルのマッピングをサポートしていません。 たとえば、6 つの面を持つ 3D 立方体があり、.mtl ファイルに 6 つのマテリアル (各面に 1 つのマッピング) が含まれている場合、立方体は正常にレンダリングされます。 ただし、.mtl ファイルに 12 個のマテリアル (各面に 2 つのマッピング) が含まれている場合、立方体は透明にレンダリングされます。いずれのマテリアルも 3D アセットを埋めるために使用されません。

マルチマテリアル マッピングを使用した 3D モデルSitecore Content HubTM での 3D アセット レンダリング
この記事を改善するための提案がある場合は、 お知らせください!