IDirect3DRMMeshBuilder3

アプリケーションは、IDirect3DRMMeshBuilder3インターフェイスのメソッドを使用してメッシュオブジェクトと会話する。メッシュの詳細については、「IDirect3DRMMesh」を参照すること。Microsoft® DirectX® version 6.0は、IDirect3DRMMeshBuilder3インターフェイスを導入している。Direct3D保持モードインターフェイスの履歴については、「インターフェイスの変更点」を参照すること。

IDirect3DRMMeshBuilder3::AddVertexAddFace、およびAddFacesメソッドを使用して、メッシュに対して個別に頂点と面を追加することができる。GetFaceメソッドによって個別の面を取得することができる。

法線 (単位ベクトルでなければならない) をセットするか、あるいは、GenerateNormalsメソッドを使用して、囲んでいる面の面法線を平均化して法線を計算することができる。

IDirect3DRMMeshBuilder3は、それが置換する旧のIDirect3DRMMeshBuilder2IDirect3DRMMeshBuilderのインターフェイスを拡張する。これは、これらのオブジェクトを削除するためにDeleteFaceDeleteNormals、およびDeleteVerticesメソッドを追加し、これらのオブジェクトを取得するためにGetNormalメソッドとGetVertexメソッドを追加する。また、IDirect3DRMMeshBuilder3EmptyメソッドとOptimizeメソッドも追加する。

他の新しいIDirect3DRMMeshBuilder3メソッドは、1つ以上の法線、法線の数、面、1つ以上の頂点、およびメッシュビルダの状態 (有効または無効) を取得する。このインターフェイスによって、頂点と法線のセット、メッシュビルダの新しいサブメッシュと親メッシュの作成と取り出しを行うことができる。また、IDirect3DRMMeshBuilder3では、アプリケーションが新しい三角形 (一般的なポリゴンと対立的な意味で) をIDirect3DRMMeshBuilder3オブジェクトに追加し、AddTrianglesメソッドを使用して、処理中に暗黙に新しい面を作成できる。

IDirect3DRMMeshBuilder3と旧のIDirect3DRMMeshBuilder2は、IDirect3DRMMeshBuilderの機能を含んだ上に、さらにGenerateNormalsメソッドを拡張して生成済みのメッシュ法線に対してより多くの制御ができるようしている。また、IDirect3DRMMeshBuilder3IDirect3DRMMeshBuilder2では、GetFaceによって単一のメッシュ面を取得することも可能になる。

DirectX 6.0以降では、IDirect3DRM3インターフェイスを使用してDirect3DRMMeshBuilder3オブジェクトを作成することができる。この場合、Direct3DRMMeshBuilder3オブジェクトは、そのインプリメンテーションのために直接モードのDrawPrimitiveインターフェイスを使用する。

IDirect3DRMMeshBuilder3インターフェイスのメソッドは、以下のグループにまとめることができる。
GetColorSource
SetColor
SetColorRGB
SetColorSource
生成 GetBox
AddFace
AddFaces
AddFacesIndexed
CreateFace
DeleteFace
GetFaceCount
GetFace
GetFaces
ロード Load
メッシュ AddMesh
CreateMesh
その他 AddFrame
AddMeshBuilder
AddTriangles
Empty
Enable
GetEnable
Optimize
ReserveSpace
Save
Scale
SetMaterial
Translate
法線 AddNormal
DeleteNormals
GenerateNormals
GetNormal
GetNormals
GetNormalCount
SetNormal
SetNormals
パースペクティブ GetPerspective
SetPerspective
レンダリングクオリティ GetQuality
SetQuality
サブメッシュ
CreateSubMesh
DeleteSubMesh
GetParentMesh
GetSubMeshes
テクスチャ GetTextureCoordinates
SetTexture
SetTextureCoordinates
SetTextureTopology
頂点 AddVertex
DeleteVertices
GetGeometry
GetVertex
GetVertexColor
GetVertexCount
GetVertices
SetVertex
SetVertices
SetVertexColor
SetVertexColorRGB

すべてのCOMインターフェイスと同様、IDirect3DRMMeshBuilder3インターフェイスはIUnknownインターフェイスメソッドを継承する。IUnknownインターフェイスは、以下の3つのメソッドをサポートする。
AddRef
QueryInterface
Release

さらに、IDirect3DRMMeshBuilder3インターフェイスは、IDirect3DRMObjectインターフェイスから以下のメソッドを継承する。
AddDestroyCallback
Clone
DeleteDestroyCallback
GetAppData
GetClassName
GetName
SetAppData
SetName

Direct3DRMMeshBuilder3オブジェクトは、IDirect3DRM3::CreateMeshBuilderメソッドを呼び出して取得される。


トップに戻る トップに戻る
© 1999 Microsoft and/or its suppliers. All rights reserved. Terms of Use.