3D アセット パッケージのコンテンツ

Current version: 4.2

3D アセットは、目的の 3D イメージをレンダリングするために必要な複数のファイルを含む ZIP パッケージです。これらのファイルは次のとおりです。

  • マテリアル テンプレート ライブラリ (MTL) 形式ファイル。
  • オブジェクト (OBJ) 形式のジオメトリ定義ファイル。
  • テクスチャファイル (JPGPNGTIFFTGA などの画像形式)。

3D サンプルパッケージをダウンロードして開くと、次のファイルが含まれていることがわかります。

  • 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 コマンドで始まる各マテリアルを一つずつ定義します。

RequestResponse

# 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 アセットに配置しない場合、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 ファイルを参照しています。

RequestResponse

# 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

3D アセットへのマルチマテリアルのマッピング

Content Hubは、3D アセットへのマルチマテリアルのマッピングをサポートしていません。たとえば、6 つの面を持つ 3D 立方体があり、.mtl ファイルに 6 つのマテリアル (各面に 1 つのマッピング) が含まれている場合、立方体は正常にレンダリングされます。ただし、.mtl ファイルは 12 個のマテリアル (各面に 2 つのマッピング) が含まれている場合、レンディションには、フィリング マテリアルのない透明な立方体が表示されます。

マルチマテリアル マッピングを使用した 3D モデルContent Hub での 3D アセット レンダリング
マルチマテリアル マッピングでレンダリングされた 3D モデル Content Hub でマルチマテリアル マッピングを使用して透明にレンダリングされた 3D モデル

テクスチャ ファイル

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

Do you have some feedback for us?

If you have suggestions for improving this article,