Direct3DRMFrame3メソッドA〜M

この項は、Direct3DRMFrame3インターフェイスのメソッドのうち、メソッド名がAからMのものをとりあげるリファレンスページである。

Direct3DRMFrame3.AddChild

Direct3DRMFrame3

子フレームをフレーム階層に追加する。

構文

object.AddChild(child As Direct3DRMFrame3)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
child
子として追加するDirect3DRMFrame3オブジェクト。

エラー値

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

注意

子として追加するフレームに、既に親フレームが存在する場合には、このメソッドは、そのフレームを現在の親から削除した後に新しい親に追加する。

オブジェクトの変換を保存するためには、Direct3DRMFrame3.GetTransformメソッドを使ってAddChildメソッドを使う前にオブジェクトの変換を取得する。その後、フレームが追加された後でその変換を再適用する。

Direct3DRMFrame3.AddLight

Direct3DRMFrame3

照明をフレームに追加する。

構文

object.AddLight(val As Direct3DRMLight)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
val
フレームに追加するDirect3DRMLightオブジェクトを表す変数。

エラー値

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

Direct3DRMFrame3.AddMoveCallback

Direct3DRMFrame3

特殊な運動の処理用にコールバックを追加する。フレームの移動時または更新時に、このコールバックが呼び出される。

構文

object.AddMoveCallback(frameMoveImplementation As Direct3DRMFrameCallback3
  userArgument As object,
  flags As CONST_D3DRMCALLBACKORDERFLAGS)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
frameMoveImplementation
アプリケーションによって実装されるDirect3DRMFrameCallback3インターフェイス。
userArgument
コールバックに渡されるアプリケーション定義のデータ。
flags
CONST_D3DRMCALLBACKORDERFLAGS列挙型からの1つ以上の値。

エラー値

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

注意

このメソッドは、Direct3DRMFrame2.AddMoveCallback2を置換する。個々のフレームに対する複数のコールバックは、コールバックの作成順に呼び出される。

参照

Direct3DRMFrame3.DeleteMoveCallback

Direct3DRMFrame3.AddRotation

Direct3DRMFrame3

特定の座標についての回転を指定されたラジアンで追加する。

構文

object.AddRotation(combineType As CONST_D3DRMCOMBINETYPE,
  x As Single,
  y As Single,
  z As Single,
  theta As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
combineType
新しい回転を現在の任意のフレーム変換と結合する方法を指定するCONST_D3DRMCOMBINETYPE列挙型のメンバ。
x, y, z
回転軸。
theta
ラジアン単位の回転角。

エラー値

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

注意

指定の回転は、このDirect3DRMFrame3インターフェイスが識別するフレームに対する行列だけを変更する。このメソッドは、レンダリング毎に行列を変更するDirect3DRMFrame3.SetRotationとは異なりフレームを一度しか変更しない。

Direct3DRMFrame3.AddScale

Direct3DRMFrame3

フレームのローカル変換を特定の座標でスケーリングする。

構文

object.AddScale(combineType As CONST_D3DRMCOMBINETYPE,
  sx As Single,
  sy As Single,
  sz As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
combineType
新しいスケールを現在の任意のフレーム変換と結合する方法を指定するCONST_D3DRMCOMBINETYPE列挙型のメンバ。
sx, sy, sz
x、y、zの各方向のスケール係数。

エラー値

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

注意

指定の変換は、このDirect3DRMFrame3インターフェイスが識別するフレームに対する行列だけを変更する。

Direct3DRMFrame3.AddTransform

Direct3DRMFrame3

指定されたアフィン変換でフレームのローカル座標を変換する。

構文

object.AddTransform(t As CONST_D3DRMCOMBINETYPE,
  val() As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
t
新しい変換を現在の任意の変換と結合する方法を指定するCONST_D3DRMCOMBINETYPE列挙型のメンバ。
val
4×4行列を表す列順の配列。

エラー値

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

注意

4×4行列が与えられたが、変換がアフィン変換であるためには、最後の列は[0 0 0 1]の転調でなければならない。指定の変換は、このDirect3DRMFrame3インターフェイスが識別するフレームに対する行列だけを変更する。

Direct3DRMFrame3.AddTranslation

Direct3DRMFrame3

フレームのローカル座標系に特定の位置変更による平行移動を追加する。

構文

object.AddTranslation(t As CONST_D3DRMCOMBINETYPE,
  x As Single,
  y As Single,
  z As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
t
新しい変換を現在の任意の変換と結合する方法を指定するCONST_D3DRMCOMBINETYPE列挙型のメンバ。
x, y, z
x、y、zの各方向での位置変化を定義する。

エラー値

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

注意

指定の変換は、このDirect3DRMFrame3インターフェイスが識別するフレームに対する行列だけを変更する。

Direct3DRMFrame3.AddVisual

Direct3DRMFrame3

ビジュアルオブジェクトをフレームに追加する。

構文

object.AddVisual(v As Direct3DRMVisual)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
v
フレームに追加するDirect3DRMVisualオブジェクトを表す変数。

エラー値

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

注意

ビジュアルオブジェクトには、メッシュ、プログレッシブメッシュ、テクスチャ、影、ユーザビジュアル、および 3-D Microsoft® DirectX® 変換オブジェクトが含まれる。ビジュアルオブジェクトがフレームに追加されると、ビジュアルオブジェクトは、フレームがビュー中にある場合に可視状態になる。フレームはビジュアルオブジェクトを参照する。

Direct3DRMFrame3.DeleteChild

Direct3DRMFrame3

階層からフレームを削除する。そのフレームが参照されていなければ、子フレーム、照明、およびメッシュのすべてが共に破棄される。

構文

object.DeleteChild(c As Direct3DRMFrame3)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
c
階層から削除されるDirect3DRMFrame3オブジェクト。

エラー値

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

Direct3DRMFrame3.DeleteLight

Direct3DRMFrame3

フレームから照明を削除し、フレームが参照されることがなければ破棄する。照明がフレームから削除されると、そのフレームがあったシーンの中のメッシュに以降影響することはない。

構文

object.DeleteLight(l As Direct3DRMLight)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
l
削除するDirect3DRMLightオブジェクトを表す変数。

エラー値

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

Direct3DRMFrame3.DeleteMoveCallback

Direct3DRMFrame3

AddMoveCallbackによって追加されたフレーム移動コールバックを削除する。

構文

object.DeleteMoveCallback(frameMoveImplementation As Direct3DRMFrameCallback3,
  userArgument As object)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
frameMoveImplementation
アプリケーションによって実装されるDirect3DRMFrameCallback3インターフェイス。
userArgument
コールバックに渡されたアプリケーション定義のデータ。

エラー値

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

参照

Direct3DRMFrame3.Move

Direct3DRMFrame3.DeleteVisual

Direct3DRMFrame3

ビジュアルオブジェクトをフレームから削除し、以降参照されない場合には破棄する。

構文

object.DeleteVisual(v As Direct3DRMVisual)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
v
削除するDirect3DRMVisualオブジェクトを表す変数。

エラー値

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

注意

ビジュアルオブジェクトには、メッシュ、プログレッシブメッシュ、テクスチャ、影、ユーザビジュアル、および3D DirectX変換オブジェクトが含まれる。ビジュアルオブジェクトがフレームに追加されると、ビジュアルオブジェクトは、フレームがビュー中にある場合に可視状態になる。フレームはビジュアルオブジェクトを参照する。

Direct3DRMFrame3.GetAxes

Direct3DRMFrame3

Direct3DRMFrame3.SetOrientationメソッドに供給される方向ベクトル (dx, dy, dz) とアップベクトル (ux, uy, uz) と整列するベクトルを取得する。

構文

object.GetAxes(dir As D3DVECTOR,
  up As D3DVECTOR)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
dir
フレームのz軸。デフォルトは(0,0,1)である。
up
フレームのy軸。デフォルトは(0,1,0)である。

エラー値

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

注意

このメソッドは、Direct3DRMFrame3.SetAxesと共に働き、左手座標系と右手座標系の両方を支援する。SetAxesは、負のz軸がオブジェクトの前面を表すように指定することを可能にする。

参照

Direct3DRMFrame3.GetInheritAxesDirect3DRMFrame3.SetInheritAxesD3DVECTOR

Direct3DRMFrame3.GetBox

Direct3DRMFrame3

Direct3DRMFrame3オブジェクトを含む境界ボックスを取得する。境界ボックスは、各次元での最小および最大のモデル座標を与える。

構文

object.GetBox(box As D3DRMBOX)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
box
境界ボックス座標を取得するD3DRMBOX型。

エラー値

有効な境界ボックスが既にフレームにセットされていない限り、D3DRMERR_BOXNOTSETを返す。エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。

注意

このメソッドは、階層的選別に対するフレーム上の境界ボックスをサポートする。有効な境界ボックスは、Direct3DRMFrame3.SetBoxメソッドでフレーム上に設定する必要がある。境界ボックスを有効にするには、Direct3DRMFrame3.SetBoxEnableメソッドを使ってイネーブルフラグをD_TRUEにする必要がある。デフォルトで、ボックスイネーブルフラグはFALSEである。デフォルトの境界ボックスはない。

参照

Direct3DRMFrame3.GetBoxEnable

Direct3DRMFrame3.GetBoxEnable

Direct3DRMFrame3

境界ボックスがこのDirect3DRMFrame3オブジェクトに対して、イネーブルになっているかどうかを判別するフラグを取得する。

構文

object.GetBoxEnable( ) As CONST_DBOOLFLAGS

要素

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

戻り値

境界ボックスがイネーブルであれば–1、イネーブルでなければ0を返す。

エラー値

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

注意

境界ボックスをイネーブルにするには、Direct3DRMFrame3.SetBoxEnableメソッドを使ってイネーブルフラグをD_TRUEにする必要がある。デフォルトでは、ボックスイネーブルフラグはD_FALSEである。

参照

Direct3DRMFrame3.GetBox, Direct3DRMFrame3.SetBox

Direct3DRMFrame3.GetChildren

Direct3DRMFrame3

Direct3DRMFrameArrayオブジェクトの形式で、子フレームのリストを取得する。

構文

object.GetChildren( ) As Direct3DRMFrameArray

要素

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

戻り値

Direct3DRMFrameArrayオブジェクトを返す。

エラー値

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

Direct3DRMFrame3.GetColor

Direct3DRMFrame3

フレームの色を取得する。

構文

object.GetColor( ) As Long

要素

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

戻り値

Direct3DRMFrame3オブジェクトの色を返す。

エラー値

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

参照

Direct3DRMFrame3.SetColor

Direct3DRMFrame3.GetHierarchyBox

Direct3DRMFrame3

このDirect3DRMFrame3オブジェクトをルートとする階層中のすべての幾何図形を含む境界ボックスを計算する。

構文

object.GetHierarchyBox(box As D3DRMBOX)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
box
境界ボックスの座標を取得するD3DRMBOX型。

エラー値

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

参照

Direct3DRMFrame3.GetBoxDirect3DRMFrame3.SetBoxDirect3DRMFrame3.SetBoxEnableDirect3DRMFrame3.GetBoxEnable

Direct3DRMFrame3.GetInheritAxes

Direct3DRMFrame3

フレームの軸が親フレームから継承したものであるかどうかを示すフラグを取得する。

構文

object.GetInheritAxes( ) As CONST_DBOOLFLAGS

要素

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

戻り値

フレームが軸を継承すると–1を返し (デフォルト)、継承しないと0を返す。

エラー値

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

注意

デフォルトでは、軸は親から継承したものである。フレームに親からの継承と設定されていて、親が存在しなければ、フレームはデフォルト軸(方向=(0,0,1)アップ=(0,1,0))を持つ親から継承したように動作する。

このメソッドおよびDirect3DRMFrame3.SetInheritAxesメソッドは、階層のルートで設定される軸の単一の方針を許す。

参照

Direct3DRMFrame3.GetAxesDirect3DRMFrame3.SetAxes

Direct3DRMFrame3.GetLights

Direct3DRMFrame3

Direct3DRMLightArrayオブジェクトの形式でフレーム中の照明のリストを取得する。

構文

object.GetLights( ) As Direct3DRMLightArray

要素

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

戻り値

Direct3DRMLightArrayオブジェクトを返す。

エラー値

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

Direct3DRMFrame3.GetMaterial

Direct3DRMFrame3

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

構文

object.GetMaterial(ret As Direct3DRMMaterial2)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
ret
フレームに適用されるDirect3DRMMaterial2オブジェクト。

エラー値

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

参照

Direct3DRMFrame3.SetMaterial

Direct3DRMFrame3.GetMaterialMode

Direct3DRMFrame3

フレームのマテリアルモードを取得する。

構文

object.GetMaterialMode( ) As CONST_D3DRMMATERIALMODE

要素

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

戻り値

現在のマテリアルモードを指定するCONST_D3DRMMATERIALMODE列挙型のメンバを返す。

エラー値

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

参照

Direct3DRMFrame3.SetMaterialMode

Direct3DRMFrame3.GetMaterialOverride

Direct3DRMFrame3

マテリアル属性に対する現在の属性ごとのオーバーライド設定を取得する。

構文

object.GetMaterialOverride(override As D3DRMMATERIALOVERRIDE) 

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
override
オーバーライド情報を持つD3DRMMATERIALOVERRIDE型。

エラー値

メソッドが失敗した場合は、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。

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

参照

Direct3DRMFrame3.SetMaterialOverride

Direct3DRMFrame3.GetMaterialOverrideTexture

Direct3DRMFrame3

オーバーライドテクスチャを取得する。

構文

object.GetMaterialOverrideTexture( ) As Direct3DRMTexture3

要素

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

戻り値

オーバーライドテクスチャがある場合は、Direct3DRMTexture3オブジェクトを返す。そうでなければ、NOTHINGを返す。

エラー値

メソッドが失敗した場合、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。

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

参照

Direct3DRMFrame3.SetMaterialOverrideTexture

Direct3DRMFrame3.GetOrientation

Direct3DRMFrame3

指定の参照フレームを基準とするフレームの方向を取得する。

構文

object.GetOrientation(ref As Direct3DRMFrame3,
  dir As D3DVECTOR,
  up As D3DVECTOR)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
ref
参照に使用されるDirect3DRMFrame3オブジェクトを表す変数。
dir, up
それぞれフレームのz軸およびy軸の正規化された方向が設定されたD3DVECTOR型。

エラー値

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

参照

Direct3DRMFrame3.SetOrientation

Direct3DRMFrame3.GetParent

Direct3DRMFrame3

現在のフレームの親フレームを取得する。

構文

object.GetParent( ) As Direct3DRMFrame3

要素

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

戻り値

Direct3DRMFrame3オブジェクトを返す。

エラー値

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

Direct3DRMFrame3.GetPosition

Direct3DRMFrame3

指定の参照フレームを基準とするフレームの位置を取得する。つまり、参照フレームからのフレームの距離を取得する。距離は、直線的な値ではなく、ベクトルとしてpositionパラメータに格納される。

構文

object.GetPosition(ref As Direct3DRMFrame3,
  position As D3DVECTOR)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
ref
参照として使用されるDirect3DRMFrameオブジェクトを表す変数。
position
フレームの位置がセットされるD3DVECTOR型。

エラー値

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

参照

Direct3DRMFrame3.SetPosition

Direct3DRMFrame3.GetRotation

Direct3DRMFrame3

指定の参照フレームを基準とするフレームの回転を取得する。

構文

object.GetRotation(ref As Direct3DRMFrame3,
  axis As D3DVECTOR,
  theta As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
ref
参照として使用されるDirect3DRMFrame3オブジェクトを表す変数。
axis
フレームの回転軸がセットされるD3DVECTOR型。
theta
ラジアン単位のフレームの回転となる変数。

エラー値

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

参照

Direct3DRMFrame3.SetRotation

Direct3DRMFrame3.GetScene

Direct3DRMFrame3

指定のフレームを含む階層のルートフレームを取得する。

構文

object.GetScene( ) As Direct3DRMFrame3

要素

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

戻り値

Direct3DRMFrame3オブジェクトを返す。

エラー値

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

Direct3DRMFrame3.GetSceneBackground

Direct3DRMFrame3

シーンの背景色を取得する。

構文

object.GetSceneBackground( ) As Long

要素

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

戻り値

色を返す。

エラー値

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

Direct3DRMFrame3.GetSceneBackgroundDepth

Direct3DRMFrame3

シーンの現在の背景深度バッファを取得する。

構文

object.GetSceneBackgroundDepth( ) As DirectDrawSurface4

要素

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

戻り値

DirectDrawSurface4オブジェクトを返す。

エラー値

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

参照

Direct3DRMFrame3.SetSceneBackgroundDepth

Direct3DRMFrame3.GetSceneFogColor

Direct3DRMFrame3

シーンのフォグ色を取得する。

object.GetSceneFogColor( ) As Long

要素

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

戻り値

フォグ色を返す。

エラー値

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

Direct3DRMFrame3.GetSceneFogEnable

Direct3DRMFrame3

現在このシーンに対してフォグがイネーブルされているかどうかを取得する。

構文

object.GetSceneFogEnable( ) As CONST_DBOOLFLAGS

要素

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

戻り値

フォグがイネーブルされていれば–1、イネーブルされていなければ0を返す。

エラー値

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

Direct3DRMFrame3.GetSceneFogMethod

Direct3DRMFrame3

現在のフォグメソッドを取得する。

構文

object.GetSceneFogMethod( ) As CONST_D3DRMFOGMETHOD

要素

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

戻り値

CONST_D3DRMFOGMETHOD列挙型から値を1つ返す。

エラー値

エラーが発生した場合は、次の値のうちの1つを返す。

Direct3DRMFrame3.GetSceneFogMode

Direct3DRMFrame3

このシーンに対する現在のフォグモードを返す。

構文

object.GetSceneFogMode( ) As CONST_D3DRMFOGMODE

要素

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

戻り値

現在のフォグモードを指定するCONST_D3DRMFOGMODE列挙型のメンバを返す。

エラー値

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

Direct3DRMFrame3.GetSceneFogParams

Direct3DRMFrame3

このシーンに対する現在のフォグパラメータを取得する。

構文

object.GetSceneFogParams(start As Single,
  end As Single,
  density As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
start, end, density
フォグ開始、終了および密度値となる変数。

エラー値

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

Direct3DRMFrame3.GetSortMode

Direct3DRMFrame3

子フレームを処理するのに使用されるソートモードを取得する。

構文

object.GetSortMode( ) As CONST_D3DRMSORTMODE

要素

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

戻り値

ソートモードを指定するCONST_D3DRMSORTMODE列挙型のメンバを返す。

エラー値

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

参照

Direct3DRMFrame3.SetSortMode

Direct3DRMFrame3.GetTexture

Direct3DRMFrame3

指定フレームのテクスチャを取得する。

構文

object.GetTexture( ) As Direct3DRMTexture3

要素

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

戻り値

Direct3DRMTexture3オブジェクトを返す。

エラー値

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

参照

Direct3DRMFrame3.SetTexture

Direct3DRMFrame3.GetTransform

Direct3DRMFrame3

フレームのローカル変換を4×4アフィン行列として取得する。

構文

object.GetTransform(referenceFrame As Direct3DRMFrame3
  val() As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
referenceFrame
参照フレームとして使用されるDirect3DRMFrame3オブジェクト。
val
4×4行列を表す列順の配列。

エラー値

エラーが発生した場合は、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。

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

Direct3DRMFrame3.GetTraversalOptions

Direct3DRMFrame3

現在のフレームの横断状態を取得する。

構文

object.GetTraversalOptions( ) As CONST_D3DRMTRAVERALFLAGS

要素

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

戻り値

CONST_D3DRMTRAVERALFLAGS列挙型から値を1つ返す。

エラー値

エラーが発生した場合は、次の値のうちの1つを返す。

Direct3DRMFrame3.GetVelocity

Direct3DRMFrame3

指定の参照フレームを基準とするフレームの速度を取得する。速度は、ティック当たりの単位で指定される。詳細については、「IDirect3DRM3.Tick」を参照すること。

構文

object.GetVelocity(ref As Direct3DRMFrame3,
  vel As D3DVECTOR,
  includeRotationalVelocity As CONST_DBOOLFLAGS)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
ref
参照として使用されるDirect3DRMFrame3オブジェクトを表す変数。
vel
フレームの速度がセットされるD3DVECTOR型。
includeRotationalVelocity
D_FALSEまたはD_TRUE。D_TRUEの場合、オブジェクトの回転速度が計算に含まれる。

エラー値

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

参照

Direct3DRMFrame3.SetVelocity

Direct3DRMFrame3.GetVisual

Direct3DRMFrame3

フレーム中のビジュアルを1つ取得する。

構文

object.GetVisual(index As Long) As Direct3DRMVisual

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
index
取得する単一のDirect3DRMVisualオブジェクトのインデックスを示す変数。サイズNの配列に対して指定できる値の範囲は、0〜N­である。

戻り値

Direct3DRMVisualオブジェクトを返す。

エラー値

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

Direct3DRMFrame3.GetVisualCount

Direct3DRMFrame3

フレーム中のビジュアルの数を取得する。

構文

object.GetVisualCount( ) As Long

要素

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

戻り値

フレームに含まれるビジュアル数を返す。

エラー値

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

Direct3DRMFrame3.GetVisuals

Direct3DRMFrame3

フレーム中のビジュアルのリストを取得する。

構文

object.GetVisuals( ) As Direct3DRMVisualArray

要素

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

戻り値

Direct3DRMVisualArrayオブジェクトを返す。

エラー値

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

Direct3DRMFrame3.GetZbufferMode

Direct3DRMFrame3

Zバッファモードを取得する。つまり、Zバッファリングがイネーブルまたはディセーブルであるかどうかを確認する。

構文

object.GetZbufferMode( ) As CONST_D3DRMZBUFFERMODE

要素

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

戻り値

CONST_D3DRMZBUFFERMODE列挙型のメンバの1つを返す。

エラー値

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

参照

Direct3DRMFrame3.SetZbufferMode

Direct3DRMFrame3.InverseTransform

Direct3DRMFrame3

ワールド座標の指定ベクトルをモデル座標に変換して、その結果を返す。

構文

object.InverseTransform(d As D3DVECTOR,
  s As D3DVECTOR)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
d
変換の結果がセットされるD3DVECTOR型。
s
変換のソースであるD3DVECTOR型。

エラー値

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

参照

Direct3DRMFrame3.Transform

Direct3DRMFrame3.InverseTransformVectors

Direct3DRMFrame3

ベクトルの配列をワールド座標からモデル座標に変換する。

構文

object.GetVelocity(reference As Direct3DRMFrame3,
  num As Long,
  DstVectors() As D3DVECTOR,
  SrcVectors() As D3DVECTOR)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
reference
この呼び出しのためにシーンのルートとして使用されるフレーム。この引数がNOTHINGの場合、現在のルートフレーム (Direct3DRMFrame3.GetSceneが返すフレーム) が使用される。
num
座標を変換する必要があるベクトル数。
DstVectors()
変換の出力先。
SrcVectors()
変換するベクトルの配列。

エラー値

エラーが発生した場合は、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。

参照

D3DVECTOR

Direct3DRMFrame3.LoadFromFile

Direct3DRMFrame3

Direct3DRMFrame3オブジェクトをロードする。

構文

object.LoadFromFile(filename As String,
  id As String,
  options As CONST_D3DRMLOADFLAGS,
  loadTextureImplementation As Direct3DRMLoadTextureCallback3,
  userArgument As Object)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
filename
ロードするオブジェクトのソース。このソースは、flagsパラメータで指定されているソースフラグに従い、ファイル、リソース、メモリブロック、またはストリームのいずれかにできる。
id
ロードするオブジェクトの名前または位置。idが""の場合は、optionsパラメータをD3DRMLOAD_FIRSTに設定する。Microsoft Visual Basic® は、Stringデータ型が指定されている場合でも、ロードするアイテムの位置を示すidパラメータの中のIntegerを受け入れる。たとえば、idパラメータに1が設定されていると、1番目の位置のオブジェクトがロードされる。
options
ロードオプションを記述するCONST_D3DRMLOADFLAGS列挙型の1つ以上の値。
loadTextureImplementation
特殊なフォーマッティングを要求するオブジェクトによって使用される、任意のテクスチャをロードするために呼び出されるDirect3DRMLoadTextureCallback3インターフェイス。テクスチャは、2で割れる幅と長さでなければならない。このパラメータはNOTHINGにできる。
userArgument
コールバックに渡されるアプリケーション定義のデータ。

エラー値

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

注意

デフォルトでは、このメソッドは、filenameパラメータで指定されているファイル中の最初のフレーム階層をロードする。このメソッドを呼び出したフレームは、新しいフレーム階層の親として使用される。デフォルトでは、パースペクティブ補正がオンである。

インスタンスフラグは、パラメータの解釈方法には何も変更を加えない。D3DRMLOAD_INSTANCEBYREFERENCEフラグを用いると、新しいオブジェクトを作成することなく同じファイルを2回ロードすることができる。オブジェクトが名前を持っていない場合、D3DRMLOAD_INSTANCEBYREFERENCEフラグをセットすると、D3DRMLOAD_INSTANCEBYCOPYINGフラグをセットしたときと同じ効果を得ることができる。ローダは、同一のオブジェクトが存在しても、各名前なしオブジェクトを新しいオブジェクトとして作成する。

Direct3DRMFrame3.LookAt

Direct3DRMFrame3

指定の参照フレームを基準として、指定の制約によって回転をロックした状態でフレームを対象のフレームに直面させる。

構文

object.LookAt(tgt As Direct3DRMFrame3,
  reference As Direct3DRMFrame3,
  contraint As CONST_D3DRMFRAMECONSTRAINT)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
tgt, reference
それぞれ、対象および参照として使用されるDirect3DRMFrame3オブジェクトを表す変数。
contraint
制約する軸回転を指定するCONST_D3DRMFRAMECONSTRAINT列挙型。

エラー値

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

Direct3DRMFrame3.Move

Direct3DRMFrame3

直線と回転の速度を指定の階層のすべてのフレームに適用する。

構文

object.Move(delta As Single)

要素

object
Direct3DRMFrame3オブジェクトを表すオブジェクト式。
delta
直線と回転速度に対する変化量。各要素における変更は、その要素の速度× deltaに等しい。これらの一方または両方の速度は、任意のフレームを起点として設定することができるが、システムは、自動的にデルタ時間を適用するので、親フレームを起点とした速度に変換する。

エラー値

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


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