この項は、Direct3DRMFrame3インターフェイスのメソッドのうち、メソッド名がAからMのものをとりあげるリファレンスページである。
子フレームをフレーム階層に追加する。
構文
object.AddChild(child As Direct3DRMFrame3)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- child
- 子として追加するDirect3DRMFrame3オブジェクト。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
子として追加するフレームに、既に親フレームが存在する場合には、このメソッドは、そのフレームを現在の親から削除した後に新しい親に追加する。
オブジェクトの変換を保存するためには、Direct3DRMFrame3.GetTransformメソッドを使ってAddChildメソッドを使う前にオブジェクトの変換を取得する。その後、フレームが追加された後でその変換を再適用する。
照明をフレームに追加する。
構文
object.AddLight(val As Direct3DRMLight)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- val
- フレームに追加するDirect3DRMLightオブジェクトを表す変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
特殊な運動の処理用にコールバックを追加する。フレームの移動時または更新時に、このコールバックが呼び出される。
構文
object.AddMoveCallback(frameMoveImplementation As Direct3DRMFrameCallback3 userArgument As object, flags As CONST_D3DRMCALLBACKORDERFLAGS)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- frameMoveImplementation
- アプリケーションによって実装されるDirect3DRMFrameCallback3インターフェイス。
- userArgument
- コールバックに渡されるアプリケーション定義のデータ。
- flags
- CONST_D3DRMCALLBACKORDERFLAGS列挙型からの1つ以上の値。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
このメソッドは、Direct3DRMFrame2.AddMoveCallback2を置換する。個々のフレームに対する複数のコールバックは、コールバックの作成順に呼び出される。
参照
特定の座標についての回転を指定されたラジアンで追加する。
構文
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とは異なりフレームを一度しか変更しない。
フレームのローカル変換を特定の座標でスケーリングする。
構文
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インターフェイスが識別するフレームに対する行列だけを変更する。
指定されたアフィン変換でフレームのローカル座標を変換する。
構文
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インターフェイスが識別するフレームに対する行列だけを変更する。
フレームのローカル座標系に特定の位置変更による平行移動を追加する。
構文
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インターフェイスが識別するフレームに対する行列だけを変更する。
ビジュアルオブジェクトをフレームに追加する。
構文
object.AddVisual(v As Direct3DRMVisual)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- v
- フレームに追加するDirect3DRMVisualオブジェクトを表す変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
ビジュアルオブジェクトには、メッシュ、プログレッシブメッシュ、テクスチャ、影、ユーザビジュアル、および 3-D Microsoft® DirectX® 変換オブジェクトが含まれる。ビジュアルオブジェクトがフレームに追加されると、ビジュアルオブジェクトは、フレームがビュー中にある場合に可視状態になる。フレームはビジュアルオブジェクトを参照する。
階層からフレームを削除する。そのフレームが参照されていなければ、子フレーム、照明、およびメッシュのすべてが共に破棄される。
構文
object.DeleteChild(c As Direct3DRMFrame3)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- c
- 階層から削除されるDirect3DRMFrame3オブジェクト。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
フレームから照明を削除し、フレームが参照されることがなければ破棄する。照明がフレームから削除されると、そのフレームがあったシーンの中のメッシュに以降影響することはない。
構文
object.DeleteLight(l As Direct3DRMLight)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- l
- 削除するDirect3DRMLightオブジェクトを表す変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
AddMoveCallbackによって追加されたフレーム移動コールバックを削除する。
構文
object.DeleteMoveCallback(frameMoveImplementation As Direct3DRMFrameCallback3, userArgument As object)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- frameMoveImplementation
- アプリケーションによって実装されるDirect3DRMFrameCallback3インターフェイス。
- userArgument
- コールバックに渡されたアプリケーション定義のデータ。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
ビジュアルオブジェクトをフレームから削除し、以降参照されない場合には破棄する。
構文
object.DeleteVisual(v As Direct3DRMVisual)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- v
- 削除するDirect3DRMVisualオブジェクトを表す変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
ビジュアルオブジェクトには、メッシュ、プログレッシブメッシュ、テクスチャ、影、ユーザビジュアル、および3D DirectX変換オブジェクトが含まれる。ビジュアルオブジェクトがフレームに追加されると、ビジュアルオブジェクトは、フレームがビュー中にある場合に可視状態になる。フレームはビジュアルオブジェクトを参照する。
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.GetInheritAxes、Direct3DRMFrame3.SetInheritAxes、 D3DVECTOR
Direct3DRMFrame3オブジェクトを含む境界ボックスを取得する。境界ボックスは、各次元での最小および最大のモデル座標を与える。
構文
object.GetBox(box As D3DRMBOX)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- box
- 境界ボックス座標を取得するD3DRMBOX型。
エラー値
有効な境界ボックスが既にフレームにセットされていない限り、D3DRMERR_BOXNOTSETを返す。エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
このメソッドは、階層的選別に対するフレーム上の境界ボックスをサポートする。有効な境界ボックスは、Direct3DRMFrame3.SetBoxメソッドでフレーム上に設定する必要がある。境界ボックスを有効にするには、Direct3DRMFrame3.SetBoxEnableメソッドを使ってイネーブルフラグをD_TRUEにする必要がある。デフォルトで、ボックスイネーブルフラグはFALSEである。デフォルトの境界ボックスはない。
参照
境界ボックスがこのDirect3DRMFrame3オブジェクトに対して、イネーブルになっているかどうかを判別するフラグを取得する。
構文
object.GetBoxEnable( ) As CONST_DBOOLFLAGS
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
境界ボックスがイネーブルであれば1、イネーブルでなければ0を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
境界ボックスをイネーブルにするには、Direct3DRMFrame3.SetBoxEnableメソッドを使ってイネーブルフラグをD_TRUEにする必要がある。デフォルトでは、ボックスイネーブルフラグはD_FALSEである。
参照
Direct3DRMFrameArrayオブジェクトの形式で、子フレームのリストを取得する。
構文
object.GetChildren( ) As Direct3DRMFrameArray
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMFrameArrayオブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
フレームの色を取得する。
構文
object.GetColor( ) As Long
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMFrame3オブジェクトの色を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
このDirect3DRMFrame3オブジェクトをルートとする階層中のすべての幾何図形を含む境界ボックスを計算する。
構文
object.GetHierarchyBox(box As D3DRMBOX)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- box
- 境界ボックスの座標を取得するD3DRMBOX型。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
Direct3DRMFrame3.GetBox、Direct3DRMFrame3.SetBox、Direct3DRMFrame3.SetBoxEnable、Direct3DRMFrame3.GetBoxEnable
フレームの軸が親フレームから継承したものであるかどうかを示すフラグを取得する。
構文
object.GetInheritAxes( ) As CONST_DBOOLFLAGS
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
フレームが軸を継承すると1を返し (デフォルト)、継承しないと0を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
デフォルトでは、軸は親から継承したものである。フレームに親からの継承と設定されていて、親が存在しなければ、フレームはデフォルト軸(方向=(0,0,1)アップ=(0,1,0))を持つ親から継承したように動作する。
このメソッドおよびDirect3DRMFrame3.SetInheritAxesメソッドは、階層のルートで設定される軸の単一の方針を許す。
参照
Direct3DRMLightArrayオブジェクトの形式でフレーム中の照明のリストを取得する。
構文
object.GetLights( ) As Direct3DRMLightArray
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMLightArrayオブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Direct3DRMFrame3オブジェクトのマテリアルを取得する。
構文
object.GetMaterial(ret As Direct3DRMMaterial2)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- ret
- フレームに適用されるDirect3DRMMaterial2オブジェクト。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
フレームのマテリアルモードを取得する。
構文
object.GetMaterialMode( ) As CONST_D3DRMMATERIALMODE
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
現在のマテリアルモードを指定するCONST_D3DRMMATERIALMODE列挙型のメンバを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
マテリアル属性に対する現在の属性ごとのオーバーライド設定を取得する。
構文
object.GetMaterialOverride(override As D3DRMMATERIALOVERRIDE)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- override
- オーバーライド情報を持つD3DRMMATERIALOVERRIDE型。
エラー値
メソッドが失敗した場合は、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
オーバーライドテクスチャを取得する。
構文
object.GetMaterialOverrideTexture( ) As Direct3DRMTexture3
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
オーバーライドテクスチャがある場合は、Direct3DRMTexture3オブジェクトを返す。そうでなければ、NOTHINGを返す。
エラー値
メソッドが失敗した場合、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。.
参照
指定の参照フレームを基準とするフレームの方向を取得する。
構文
object.GetOrientation(ref As Direct3DRMFrame3, dir As D3DVECTOR, up As D3DVECTOR)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- ref
- 参照に使用されるDirect3DRMFrame3オブジェクトを表す変数。
- dir, up
- それぞれフレームのz軸およびy軸の正規化された方向が設定されたD3DVECTOR型。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
現在のフレームの親フレームを取得する。
構文
object.GetParent( ) As Direct3DRMFrame3
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMFrame3オブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
指定の参照フレームを基準とするフレームの位置を取得する。つまり、参照フレームからのフレームの距離を取得する。距離は、直線的な値ではなく、ベクトルとしてpositionパラメータに格納される。
構文
object.GetPosition(ref As Direct3DRMFrame3, position As D3DVECTOR)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- ref
- 参照として使用されるDirect3DRMFrameオブジェクトを表す変数。
- position
- フレームの位置がセットされるD3DVECTOR型。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
指定の参照フレームを基準とするフレームの回転を取得する。
構文
object.GetRotation(ref As Direct3DRMFrame3, axis As D3DVECTOR, theta As Single)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- ref
- 参照として使用されるDirect3DRMFrame3オブジェクトを表す変数。
- axis
- フレームの回転軸がセットされるD3DVECTOR型。
- theta
- ラジアン単位のフレームの回転となる変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
指定のフレームを含む階層のルートフレームを取得する。
構文
object.GetScene( ) As Direct3DRMFrame3
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMFrame3オブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
シーンの背景色を取得する。
構文
object.GetSceneBackground( ) As Long
要素
戻り値
色を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
シーンの現在の背景深度バッファを取得する。
構文
object.GetSceneBackgroundDepth( ) As DirectDrawSurface4
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
DirectDrawSurface4オブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
シーンのフォグ色を取得する。
object.GetSceneFogColor( ) As Long
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
フォグ色を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
現在このシーンに対してフォグがイネーブルされているかどうかを取得する。
構文
object.GetSceneFogEnable( ) As CONST_DBOOLFLAGS
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
フォグがイネーブルされていれば1、イネーブルされていなければ0を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
現在のフォグメソッドを取得する。
構文
object.GetSceneFogMethod( ) As CONST_D3DRMFOGMETHOD
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
CONST_D3DRMFOGMETHOD列挙型から値を1つ返す。
エラー値
エラーが発生した場合は、次の値のうちの1つを返す。
このシーンに対する現在のフォグモードを返す。
構文
object.GetSceneFogMode( ) As CONST_D3DRMFOGMODE
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
現在のフォグモードを指定するCONST_D3DRMFOGMODE列挙型のメンバを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
このシーンに対する現在のフォグパラメータを取得する。
構文
object.GetSceneFogParams(start As Single, end As Single, density As Single)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- start, end, density
- フォグ開始、終了および密度値となる変数。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
子フレームを処理するのに使用されるソートモードを取得する。
構文
object.GetSortMode( ) As CONST_D3DRMSORTMODE
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
ソートモードを指定するCONST_D3DRMSORTMODE列挙型のメンバを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
指定フレームのテクスチャを取得する。
構文
object.GetTexture( ) As Direct3DRMTexture3
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMTexture3オブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
フレームのローカル変換を4×4アフィン行列として取得する。
構文
object.GetTransform(referenceFrame As Direct3DRMFrame3 val() As Single)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- referenceFrame
- 参照フレームとして使用されるDirect3DRMFrame3オブジェクト。
- val
- 4×4行列を表す列順の配列。
エラー値
エラーが発生した場合は、DDERR_INVALIDOBJECTまたはDDERR_INVALIDPARAMSを返す。
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
現在のフレームの横断状態を取得する。
構文
object.GetTraversalOptions( ) As CONST_D3DRMTRAVERALFLAGS
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
CONST_D3DRMTRAVERALFLAGS列挙型から値を1つ返す。
エラー値
エラーが発生した場合は、次の値のうちの1つを返す。
指定の参照フレームを基準とするフレームの速度を取得する。速度は、ティック当たりの単位で指定される。詳細については、「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保持モードのエラー値」を参照すること。
参照
フレーム中のビジュアルを1つ取得する。
構文
object.GetVisual(index As Long) As Direct3DRMVisual
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- index
- 取得する単一のDirect3DRMVisualオブジェクトのインデックスを示す変数。サイズNの配列に対して指定できる値の範囲は、0〜Nである。
戻り値
Direct3DRMVisualオブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
フレーム中のビジュアルの数を取得する。
構文
object.GetVisualCount( ) As Long
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
フレームに含まれるビジュアル数を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
フレーム中のビジュアルのリストを取得する。
構文
object.GetVisuals( ) As Direct3DRMVisualArray
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
Direct3DRMVisualArrayオブジェクトを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
Zバッファモードを取得する。つまり、Zバッファリングがイネーブルまたはディセーブルであるかどうかを確認する。
構文
object.GetZbufferMode( ) As CONST_D3DRMZBUFFERMODE
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
戻り値
CONST_D3DRMZBUFFERMODE列挙型のメンバの1つを返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
ワールド座標の指定ベクトルをモデル座標に変換して、その結果を返す。
構文
object.InverseTransform(d As D3DVECTOR, s As D3DVECTOR)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- d
- 変換の結果がセットされるD3DVECTOR型。
- s
- 変換のソースであるD3DVECTOR型。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
ベクトルの配列をワールド座標からモデル座標に変換する。
構文
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を返す。
参照
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フラグをセットしたときと同じ効果を得ることができる。ローダは、同一のオブジェクトが存在しても、各名前なしオブジェクトを新しいオブジェクトとして作成する。
指定の参照フレームを基準として、指定の制約によって回転をロックした状態でフレームを対象のフレームに直面させる。
構文
object.LookAt(tgt As Direct3DRMFrame3, reference As Direct3DRMFrame3, contraint As CONST_D3DRMFRAMECONSTRAINT)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- tgt, reference
- それぞれ、対象および参照として使用されるDirect3DRMFrame3オブジェクトを表す変数。
- contraint
- 制約する軸回転を指定するCONST_D3DRMFRAMECONSTRAINT列挙型。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
直線と回転の速度を指定の階層のすべてのフレームに適用する。
構文
object.Move(delta As Single)
要素
- object
- Direct3DRMFrame3オブジェクトを表すオブジェクト式。
- delta
- 直線と回転速度に対する変化量。各要素における変更は、その要素の速度× deltaに等しい。これらの一方または両方の速度は、任意のフレームを起点として設定することができるが、システムは、自動的にデルタ時間を適用するので、親フレームを起点とした速度に変換する。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
トップに戻る
© 1999 Microsoft and/or its suppliers. All rights reserved. Terms of Use.