Direct3DRMFace2

アプリケーションは、面と互いにやり取りするためにDirect3DRMFace2インターフェイスのメソッドを使用する。 面は、メッシュ上の1つのポリゴンである。アプリケーションは、Direct3DRMFace2.SetColorDirect3DRMFace2.SetColorRGBDirect3DRMFace2.SetTexture、およびDirect3DRMFace2.SetMaterialメソッドを使用して、面の色、テクスチャ、マテリアルをセットすることができる。

面は、Direct3DRMFace2.AddVertexDirect3DRMFace2.AddVertexAndNormalIndexedメソッドを使用して頂点から構築する。アプリケーションは、Direct3DRMFace2.GetVerticesDirect3DRMFace2.GetVertexメソッドを使用して面の頂点を読み込むことができる。

Direct3DRMFace2では、SetTextureメソッドは、その幅と高さが2の累乗でないテクスチャを指定することができる。

Direct3DRMFace2インターフェイスのメソッドは、以下のグループにまとめることができる。

GetColor
SetColor
SetColorRGB
マテリアル GetMaterial
SetMaterial
テクスチャ GetTexture
GetTextureCoordinateIndex
GetTextureCoordinates
GetTextureTopology
SetTexture
SetTextureCoordinates
SetTextureTopology
頂点と法線 AddVertex
AddVertexAndNormalIndexed
GetNormal
GetVertex
GetVertexCount
GetVertexIndex
GetVertices

Direct3DRMFace2インターフェイスは、Direct3DRMObjectインターフェイスから次のメソッドを継承する。

Direct3DRMFace2オブジェクトは、Direct3DRM3.CreateFaceメソッドの呼び出しによって取得される。

Direct3DRMFace2.AddVertex

Direct3DRMFace2

Direct3DRMFace2オブジェクトに頂点を追加する。

構文

object.AddVertex(x As Single,
  y As Single,
  z As Single)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
x, y, z
新しい頂点位置のx、y、z座標。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.AddVertexAndNormalIndexed

Direct3DRMFace2

頂点と法線をDirect3DRMFace2オブジェクトに追加する。このとき、メッシュビルダに含まれる頂点のインデックスと法線のインデックスを使用する。面、頂点、法線は、Direct3DRMMeshBuilder3オブジェクトの一部でなくてはならない。

構文

object.AddVertexAndNormalIndexed(vertexIndex As Long,
  normalIndex As Long)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
vertexIndex, normal
追加する頂点と法線のインデックス。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetColor

Direct3DRMFace2

Direct3DRMFace2オブジェクトの色を取得する。

構文

object.GetColor( ) As Long

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。

戻り値

色を返す。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

参照

Direct3DRMFace2.SetColor

Direct3DRMFace2.GetMaterial

Direct3DRMFace2

Direct3DRMFace2オブジェクトのマテリアルを取得する。

構文

object.GetMaterial( ) As Direct3DRMMaterial2

要素

object
Object expression that resolves to a Direct3DRMFace2 object.

戻り値

面に適用されているDirect3DRMMaterialオブジェクトを返す。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

参照

Direct3DRMFace2.SetMaterial

Direct3DRMFace2.GetNormal

Direct3DRMFace2

Direct3DRMFace2オブジェクトの法線ベクトルを取得する。

構文

object.GetNormal(val As D3DVECTOR) 

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
val
面の法線ベクトルを受け取るD3DVECTORタイプ。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetTexture

Direct3DRMFace2

Direct3DRMFace2オブジェクトに適用されたDirect3DRMTexture3を取得する。

構文

object.GetTexture( ) As Direct3DRMTexture3

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。

戻り値

Direct3DRMTexture3オブジェクトを返す。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

参照

Direct3DRMFace2.SetTexture

Direct3DRMFace2.GetTextureCoordinateIndex

Direct3DRMFace2

面のメッシュにある頂点のインデックスをテクスチャ座標で取得する。

構文

object.GetTextureCoordinateIndex(which As Long) As Long

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
which
対応するメッシュ頂点インデックスを取り出し中の頂点の面内のインデックス。

戻り値

面のメッシュを起点とする頂点インデックスを返す。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetTextureCoordinates

Direct3DRMFace2

Direct3DRMFace2オブジェクト中の頂点のテクスチャ座標を取得する。

構文

object.GetTextureCoordinates(Vertex As Long,
  u As Single,
  v As Single)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
Vertex
頂点のインデックス。
u, v
点のテクスチャ座標を受け取る変数。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetTextureTopology

Direct3DRMFace2

Direct3DRMFace2オブジェクトのテクスチャ位相を取得する。

構文

object.GetTextureTopology(u As Long,
  v As Long)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
u, v
テクスチャ座標を受け取る変数。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetVertex

Direct3DRMFace2

Direct3DRMFace2オブジェクト中の頂点の位置と法線を取得する。

構文

object.GetVertex(idx As Long,
  vert As D3DVECTOR,
  norm As D3DVECTOR)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
idx
頂点のインデックス。
vert, norm
それぞれ、頂点の位置と法線を受け取るD3DVECTORタイプ。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetVertexCount

Direct3DRMFace2

Direct3DRMFace2オブジェクトの頂点の数を取得する。

構文

object.GetVertexCount( ) As Long

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。

戻り値

頂点の数を返す。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetVertexIndex

Direct3DRMFace2

面のメッシュにある頂点のインデックスを取得する。

構文

object.GetVertexIndex(which As Long) As Long

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
which
対応するメッシュ頂点インデックスを取り出し中の頂点の面内のインデックス。

戻り値

メッシュを起点とする頂点インデックスを返す。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.GetVertices

Direct3DRMFace2

Direct3DRMFace2 オブジェクト中のそれぞれの頂点について、位置と法線ベクトルを取得する。

構文

object.GetVertices(vertexCount As Long,
  coord() As D3DVECTOR,
  normals() As D3DVECTOR)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
vertexCount
頂点の数を受け取る変数。このパラメータにNOTHINGを指定することはできない。
coord, normals
それぞれ、頂点の位置と法線ベクトルを受け取るD3DVECTORタイプの配列。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

注意

vertexCountを決定し、coordnormalsにそのサイズを設定するには、GetVertexCountを使用する。

Direct3DRMFace2.SetColor

Direct3DRMFace2

Direct3DRMFace2オブジェクトの色を設定する。

構文

object.SetColor(c As Long)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
c
設定する色。赤、緑、青の色要素だけでなく、アルファ要素も必ずセットする。そうしないと、オブジェクトが可視にならないことがある。色は4バイトのLongで表される。高バイトはアルファ要素であり、後続のバイトが赤、緑、青を定義する。より簡単に色を構築するにはDirectX7オブジェクトのCreateColorRGBAを使い、フルアルファを希望しているだけの場合はSetColorRGBを使う。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

参照

Direct3DRMFace2.GetColor

Direct3DRMFace2.SetColorRGB

Direct3DRMFace2

Direct3DRMFace2オブジェクトの赤、緑、青の色要素を設定する。

構文

object.SetColorRGB(r As Single,
  g As Single,
  b As Single)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
r, g, b
赤、緑、青の色要素。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.SetMaterial

Direct3DRMFace2

Direct3DRMFace2オブジェクトのマテリアルを設定する。

構文

object.SetMaterial(ref As Direct3DRMMaterial2)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
ref
マテリアルとして使用するDirect3DRMMaterialオブジェクト。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

参照

Direct3DRMFace2.GetMaterial

Direct3DRMFace2.SetTexture

Direct3DRMFace2

Direct3DRMFace2オブジェクトのテクスチャを設定する。

構文

object.SetTexture(ref As Direct3DRMTexture3)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
ref
テクスチャとして使用するDirect3DRMTexture3オブジェクト。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

注意

まず、DirectX Foundation 6については、テクスチャの幅と高さが2の累乗である必要はない。

参照

Direct3DRMFace2.GetTexture

Direct3DRMFace2.SetTextureCoordinates

Direct3DRMFace2

Direct3DRMFace2オブジェクト中の頂点のテクスチャ座標を設定する。

構文

object.SetTextureCoordinates(Vertex As Long,
  u As Single,
  v As Single)

要素

object
Direct3DRMFace2オブジェクトを表すオブジェクト式。
Vertex
設定する頂点のインデックス。たとえば、面が三角形のとき、頂点は0、1、2となる。
u, v
指定された頂点に割り当てるテクスチャ座標。

エラー値

エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

Direct3DRMFace2.SetTextureTopology

Direct3DRMFace2

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_uwrap_vパラメータの目的に関する詳細については、「Direct3DRMeshBuilder3.SetTextureTopology」を参照すること。


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