Direct3DRMPickArray

アプリケーションは、Direct3DRMPickArrayインターフェイスのメソッドを使用して、ピックオブジェクトをグループ化する。ピック配列は、0が基準になっている (0〜N-1)。

ピッキングは、ビューポート中で2D座標またはフレーム中でベクトルが与えられたときに、シーン上のビジュアルを検索するプロセスである。光線ピックについては、「Direct3DRMPick2Array」を参照すること。

Direct3DRMViewport2.Pickメソッドを使用して、Direct3DRMPickArrayオブジェクトを取得する。次に、Direct3DRMPickArray.GetPickFrameメソッドを呼び出して、Direct3DRMFrameArrayインターフェイスとビジュアルオブジェクトを取得することができる。フレームの配列は、階層を経てビジュアルオブジェクトに通じるパスである。これは、つまり、階層中の最上部の親が配列の最初にくるビジュアルオブジェクトの親フレームの階層リストである。

Direct3DRMPickArrayインターフェイスは、次のメソッドをサポートする。

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

Direct3DRMPickArray.GetPickFrame

Direct3DRMPickArray

指定されたピックによって交差するDirect3DRMFrameArrayオブジェクトを取得する。

構文

object.GetPickFrame(index As Long,
  pickDesc As D3DRMPICKDESC) As Direct3DRMFrameArray

要素

object
Direct3DRMPickArrayオブジェクトを表すオブジェクト式。
index
情報を取得するピックを識別する、ピック配列へのインデックス。
pickDesc
ピックの位置、面、取得するオブジェクトのグループ識別子を指定するD3DRMPICKDESC型。

戻り値

指定されたピックに関連付けられたDirect3DRMFrameArrayオブジェクトを返す。

エラー値

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

参照

Direct3DRMViewport2.Pick

Direct3DRMPickArray.GetPickVisual

Direct3DRMPickArray

指定されたピックによって交差するDirect3DRMVisualオブジェクトを返す。

構文

object.GetPickVisual(index As Long,
  pickDesc As D3DRMPICKDESC) As Direct3DRMVisual

要素

object
Direct3DRMPickArrayオブジェクトを表すオブジェクト式。
index
情報を取得するピックを識別する、ピック配列へのインデックス。
pickDesc
ピックの位置、面、取得するオブジェクトのグループ識別子を指定するD3DRMPICKDESC型。

戻り値

指定されたピックに関連付けられたDirect3DRMVisualオブジェクトを返す。

エラー値

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

参照

Direct3DRMViewport2.Pick

Direct3DRMPickArray.GetSize

Direct3DRMPickArray

Direct3DRMPickArrayオブジェクトに含まれている要素数を取得する。

構文

object.GetSize( ) As Long

要素

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

戻り値

要素数を返す。

エラー値

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


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