アプリケーションは、面と互いにやり取りするためにDirect3DRMFace2インターフェイスのメソッドを使用する。 面は、メッシュ上の1つのポリゴンである。アプリケーションは、Direct3DRMFace2.SetColor、Direct3DRMFace2.SetColorRGB、Direct3DRMFace2.SetTexture、およびDirect3DRMFace2.SetMaterialメソッドを使用して、面の色、テクスチャ、マテリアルをセットすることができる。
面は、Direct3DRMFace2.AddVertexとDirect3DRMFace2.AddVertexAndNormalIndexedメソッドを使用して頂点から構築する。アプリケーションは、Direct3DRMFace2.GetVerticesとDirect3DRMFace2.GetVertexメソッドを使用して面の頂点を読み込むことができる。
Direct3DRMFace2では、SetTextureメソッドは、その幅と高さが2の累乗でないテクスチャを指定することができる。
Direct3DRMFace2インターフェイスのメソッドは、以下のグループにまとめることができる。
Direct3DRMFace2インターフェイスは、Direct3DRMObjectインターフェイスから次のメソッドを継承する。
Direct3DRMFace2オブジェクトは、Direct3DRM3.CreateFaceメソッドの呼び出しによって取得される。
Direct3DRMFace2オブジェクトに頂点を追加する。
構文
object.AddVertex(x As Single, y As Single, z As Single)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- x, y, z
- 新しい頂点位置のx、y、z座標。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
頂点と法線をDirect3DRMFace2オブジェクトに追加する。このとき、メッシュビルダに含まれる頂点のインデックスと法線のインデックスを使用する。面、頂点、法線は、Direct3DRMMeshBuilder3オブジェクトの一部でなくてはならない。
構文
object.AddVertexAndNormalIndexed(vertexIndex As Long, normalIndex As Long)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- vertexIndex, normal
- 追加する頂点と法線のインデックス。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクトの色を取得する。
構文
object.GetColor( ) As Long
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
戻り値
色を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
Direct3DRMFace2オブジェクトのマテリアルを取得する。
構文
object.GetMaterial( ) As Direct3DRMMaterial2
要素
- object
- Object expression that resolves to a Direct3DRMFace2 object.
戻り値
面に適用されているDirect3DRMMaterialオブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
Direct3DRMFace2オブジェクトの法線ベクトルを取得する。
構文
object.GetNormal(val As D3DVECTOR)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- val
- 面の法線ベクトルを受け取るD3DVECTORタイプ。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクトに適用されたDirect3DRMTexture3を取得する。
構文
object.GetTexture( ) As Direct3DRMTexture3
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMTexture3オブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
面のメッシュにある頂点のインデックスをテクスチャ座標で取得する。
構文
object.GetTextureCoordinateIndex(which As Long) As Long
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- which
- 対応するメッシュ頂点インデックスを取り出し中の頂点の面内のインデックス。
戻り値
面のメッシュを起点とする頂点インデックスを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクト中の頂点のテクスチャ座標を取得する。
構文
object.GetTextureCoordinates(Vertex As Long, u As Single, v As Single)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- Vertex
- 頂点のインデックス。
- u, v
- 点のテクスチャ座標を受け取る変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクトのテクスチャ位相を取得する。
構文
object.GetTextureTopology(u As Long, v As Long)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- u, v
- テクスチャ座標を受け取る変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクト中の頂点の位置と法線を取得する。
構文
object.GetVertex(idx As Long, vert As D3DVECTOR, norm As D3DVECTOR)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- idx
- 頂点のインデックス。
- vert, norm
- それぞれ、頂点の位置と法線を受け取るD3DVECTORタイプ。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクトの頂点の数を取得する。
構文
object.GetVertexCount( ) As Long
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
戻り値
頂点の数を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
面のメッシュにある頂点のインデックスを取得する。
構文
object.GetVertexIndex(which As Long) As Long
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- which
- 対応するメッシュ頂点インデックスを取り出し中の頂点の面内のインデックス。
戻り値
メッシュを起点とする頂点インデックスを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2 オブジェクト中のそれぞれの頂点について、位置と法線ベクトルを取得する。
構文
object.GetVertices(vertexCount As Long, coord() As D3DVECTOR, normals() As D3DVECTOR)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- vertexCount
- 頂点の数を受け取る変数。このパラメータにNOTHINGを指定することはできない。
- coord, normals
- それぞれ、頂点の位置と法線ベクトルを受け取るD3DVECTORタイプの配列。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
vertexCountを決定し、coordとnormalsにそのサイズを設定するには、GetVertexCountを使用する。
Direct3DRMFace2オブジェクトの色を設定する。
構文
object.SetColor(c As Long)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- c
- 設定する色。赤、緑、青の色要素だけでなく、アルファ要素も必ずセットする。そうしないと、オブジェクトが可視にならないことがある。色は4バイトのLongで表される。高バイトはアルファ要素であり、後続のバイトが赤、緑、青を定義する。より簡単に色を構築するにはDirectX7オブジェクトのCreateColorRGBAを使い、フルアルファを希望しているだけの場合はSetColorRGBを使う。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
Direct3DRMFace2オブジェクトの赤、緑、青の色要素を設定する。
構文
object.SetColorRGB(r As Single, g As Single, b As Single)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- r, g, b
- 赤、緑、青の色要素。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクトのマテリアルを設定する。
構文
object.SetMaterial(ref As Direct3DRMMaterial2)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- ref
- マテリアルとして使用するDirect3DRMMaterialオブジェクト。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
Direct3DRMFace2オブジェクトのテクスチャを設定する。
構文
object.SetTexture(ref As Direct3DRMTexture3)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- ref
- テクスチャとして使用するDirect3DRMTexture3オブジェクト。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
まず、DirectX Foundation 6については、テクスチャの幅と高さが2の累乗である必要はない。
参照
Direct3DRMFace2オブジェクト中の頂点のテクスチャ座標を設定する。
構文
object.SetTextureCoordinates(Vertex As Long, u As Single, v As Single)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- Vertex
- 設定する頂点のインデックス。たとえば、面が三角形のとき、頂点は0、1、2となる。
- u, v
- 指定された頂点に割り当てるテクスチャ座標。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFace2オブジェクトにテクスチャ位相を設定する。
構文
object.SetTextureTopology(wrap_u As CONST_DBOOLFLAGS, wrap_v As CONST_DBOOLFLAGS)
要素
- object
- Direct3DRMFace2オブジェクトを表すオブジェクト式。
- wrap_u, wrap_v
- テクスチャの位相をuとvの次元で円柱にしたい場合は、これらのパラメータのいずれか、または両方にD_TRUEを指定する。そうでなければ、D_FALSEを指定する。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
いくつかのインターフェイスでSetTextureTopologyメソッドが提供される。SetTextureTopologyメソッドとの関係の詳細、およびwrap_uとwrap_vパラメータの目的に関する詳細については、「Direct3DRMeshBuilder3.SetTextureTopology」を参照すること。
トップに戻る
© 1999 Microsoft and/or its suppliers. All rights reserved. Terms of Use.