Direct3DRMClippedVisual

Direct3DRMClippedVisualインターフェイスによって、アプリケーションは、レンダリングの前にワールド空間で指定された任意のプレーンに対してビジュアルオブジェクトをクリップすることができる。別のビジュアルから影を作成するのとほとんど同じように、別のビジュアルからクリップビジュアルを作成する。たとえば、球体からクリップビジュアルを作成し、球体の真中から直線的にクリッピングプレーンを渡し、球体の半分だけをレンダリングさせることができる。Direct3DRM3.CreateClippedVisualメソッドを呼び出すことで、クリップビジュアルオブジェクトを作成する。次に、Direct3DRMFrame3.AddVisualメソッドを使用して、クリップビジュアルをシーンに追加する。

Direct3DRMClippedVisualは、その他のビジュアルインターフェイスと同様にDirect3DRMVisualを継承する。参照フレームが移動するとき、クリッピングプレーンは移動しない (詳細については、「AddPlaneメソッド」を参照すること)。

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

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

Direct3DRM3インターフェイスを使用して、Direct3DRMClippedVisualオブジェクトを作成することができる。

Direct3DRMClippedVisual.AddPlane

Direct3DRMClippedVisual

クリッピングプレーンを追加する。

構文

object.AddPlane(ref As Direct3DRMFrame3,
  point As D3DVECTOR,
  normal As D3DVECTOR) As Long

要素

object
Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
ref
ポイントと法線パラメータの参照フレーム。
point
参照フレームを起点とするプレーン上のポイント。
normal
参照フレームを起点とするプレーンに垂直なベクトル。

戻り値

呼び出しが成功した場合に、プレーンの一意なID番号を返す。

エラー値

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

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

注意

クリッピングプレーンは、ワールド座標として内部的に格納される。参照フレームが移動するとき、クリッピングプレーンは移動しない。必要に応じてクリッピングプレーンの位置と方向を更新するには、SetPlaneメソッドを使用する。

参照

D3DVECTOR

Direct3DRMClippedVisual.DeletePlane

Direct3DRMClippedVisual

クリッピングプレーンを削除する。

構文

object.DeletePlane(id As Long)

要素

object
Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
id
削除するプレーンのID番号。

エラー値

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

Direct3DRMClippedVisual.GetPlane

Direct3DRMClippedVisual

クリッピングプレーンに関する情報を取り出す。

構文

object.GetPlane(id As Long,
  ref As Direct3DRMFrame3,
  point As D3DVECTOR,
  normal As D3DVECTOR)

要素

object
Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
id
プレーンのID。
ref
この操作の参照Direct3DRMFrame3オブジェクト。
point
呼び出し成功時の参照フレームを起点とするプレーン上のポイント。
normal
呼び出し成功時の参照フレームを起点とするプレーンに垂直なベクトル。

エラー値

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

参照

D3DVECTOR

Direct3DRMClippedVisual.GetPlaneIds

Direct3DRMClippedVisual

IDの配列を取り出す。

構文

object.GetPlaneIds(count As Long,
  arrayOfIds() As Long)

要素

object
Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
count
arrayOfIds配列のバイト単位のサイズ。
arrayOfIds
すべてのプレーンID番号の配列。呼び出しが成功した場合、プレーンIDが入っている。

エラー値

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

Direct3DRMClippedVisual.GetPlaneIdsCount

Direct3DRMClippedVisual

プレーンの数を取り出す。

構文

object.GetPlaneIdsCount( ) As Long

要素

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

戻り値

プレーンの数を返す。

エラー値

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

Direct3DRMClippedVisual.SetPlane

Direct3DRMClippedVisual

既に追加されたクリッピングプレーンのパラメータを変更する。

構文

object.SetPlane(id As Long,
  ref As Direct3DRMFrame3,
  point As D3DVECTOR,
  normal As D3DVECTOR)

要素

object
Direct3DRMClippedVisualオブジェクトを表すオブジェクト式。
id
変更するプレーンのID番号。
ref
ポイントと法線パラメータの参照Direct3DRMFrame3オブジェクト。このパラメータがNOTHINGならば、pointnormalはワールド空間中にある。
point
参照フレームを起点とするプレーン上のポイント。
normal
参照フレームを起点とするプレーンに垂直なベクトル。

エラー値

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

参照

D3DVECTOR


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