Direct3DRMClippedVisualインターフェイスによって、アプリケーションは、レンダリングの前にワールド空間で指定された任意のプレーンに対してビジュアルオブジェクトをクリップすることができる。別のビジュアルから影を作成するのとほとんど同じように、別のビジュアルからクリップビジュアルを作成する。たとえば、球体からクリップビジュアルを作成し、球体の真中から直線的にクリッピングプレーンを渡し、球体の半分だけをレンダリングさせることができる。Direct3DRM3.CreateClippedVisualメソッドを呼び出すことで、クリップビジュアルオブジェクトを作成する。次に、Direct3DRMFrame3.AddVisualメソッドを使用して、クリップビジュアルをシーンに追加する。
Direct3DRMClippedVisualは、その他のビジュアルインターフェイスと同様にDirect3DRMVisualを継承する。参照フレームが移動するとき、クリッピングプレーンは移動しない (詳細については、「AddPlaneメソッド」を参照すること)。
Direct3DRMClippedVisualインターフェイスは、以下のメソッドをサポートする。
Direct3DRMClippedVisualインターフェイスは、Direct3DRMObjectインターフェイスから次のメソッドを継承する。
Direct3DRM3インターフェイスを使用して、Direct3DRMClippedVisualオブジェクトを作成することができる。
クリッピングプレーンを追加する。
構文
object.AddPlane(ref As Direct3DRMFrame3, point As D3DVECTOR, normal As D3DVECTOR) As Long
要素
- object
- Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
- ref
- ポイントと法線パラメータの参照フレーム。
- point
- 参照フレームを起点とするプレーン上のポイント。
- normal
- 参照フレームを起点とするプレーンに垂直なベクトル。
戻り値
呼び出しが成功した場合に、プレーンの一意なID番号を返す。
エラー値
エラーが発生した場合は、DDERR_INVALIDPARAMSを返す。
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
注意
クリッピングプレーンは、ワールド座標として内部的に格納される。参照フレームが移動するとき、クリッピングプレーンは移動しない。必要に応じてクリッピングプレーンの位置と方向を更新するには、SetPlaneメソッドを使用する。
参照
クリッピングプレーンを削除する。
構文
object.DeletePlane(id As Long)
要素
- object
- Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
- id
- 削除するプレーンのID番号。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
クリッピングプレーンに関する情報を取り出す。
構文
object.GetPlane(id As Long, ref As Direct3DRMFrame3, point As D3DVECTOR, normal As D3DVECTOR)
要素
- object
- Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
- id
- プレーンのID。
- ref
- この操作の参照Direct3DRMFrame3オブジェクト。
- point
- 呼び出し成功時の参照フレームを起点とするプレーン上のポイント。
- normal
- 呼び出し成功時の参照フレームを起点とするプレーンに垂直なベクトル。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
IDの配列を取り出す。
構文
object.GetPlaneIds(count As Long, arrayOfIds() As Long)
要素
- object
- Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
- count
- arrayOfIds配列のバイト単位のサイズ。
- arrayOfIds
- すべてのプレーンID番号の配列。呼び出しが成功した場合、プレーンIDが入っている。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
プレーンの数を取り出す。
構文
object.GetPlaneIdsCount( ) As Long
要素
- object
- Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
戻り値
プレーンの数を返す。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
既に追加されたクリッピングプレーンのパラメータを変更する。
構文
object.SetPlane(id As Long, ref As Direct3DRMFrame3, point As D3DVECTOR, normal As D3DVECTOR)
要素
- object
- Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
- id
- 変更するプレーンのID番号。
- ref
- ポイントと法線パラメータの参照Direct3DRMFrame3オブジェクト。このパラメータがNOTHINGならば、pointとnormalはワールド空間中にある。
- point
- 参照フレームを起点とするプレーン上のポイント。
- normal
- 参照フレームを起点とするプレーンに垂直なベクトル。
エラー値
エラーのリストについては、「Direct3D保持モードのエラー値」を参照すること。
参照
トップに戻る
© 1999 Microsoft and/or its suppliers. All rights reserved. Terms of Use.