Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.CopyRects

あるサーフェスから別のサーフェスに、ピクセルの矩形サブセットをコピーする。

object.CopyRects( _ 
    SourceSurface As Direct3DSurface8, _ 
    FirstElementOfSourceRectsArray As Any, _ 
    NumberOfRects As Long, _ 
    DestinationSurface As Direct3DSurface8, _ 
    FirstElementofDestPointArray As Any)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
SourceSurface
コピー元のサーフェスを表す Direct3DSurface8 オブジェクト。このパラメータでは、DestinationSurface と異なるサーフェス オブジェクトを指定しなければならない。
FirstElementOfSourceRectsArray
転送される矩形を表す配列の最初の要素、またはサーフェス全体のコピーを指定する ByVal 0。各矩形はコピー先のサーフェスに転送されて、矩形の左上隅は FirstElementofDestPointArray の対応する要素で示されている位置になる。
NumberOfRects
FirstElementOfSourceRectsArray に含まれる矩形の数。
DestinationSurface
コピー先のサーフェスを表す Direct3DSurface8 オブジェクト。このパラメータでは、SourceSurface と異なるサーフェス オブジェクトを指定しなければならない。
FirstElementofDestPointArray
一連のポイントを定義している配列の先頭の要素。FirstElementOfSourceRectsArray に格納されている各矩形の左上隅の位置を示す。このパラメータが ByVal 0 の場合、矩形はコピー元の矩形と同じオフセット (左上隅の位置が同じ) にコピーされる。

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

このメソッドは、伸縮、カラー キー、アルファ ブレンド、フォーマット変換、および転送元または転送先矩形のいずれかのクリッピングをサポートしていない。すべての転送元矩形および対応する転送先矩形が、それぞれ転送元および転送先サーフェス内に完全に含まれていない場合には、このメソッドが失敗することに注意する。2 つのサーフェスのフォーマットは一致していなければならないが、ディメンジョンは異なっていてもかまわない。

サーフェスのフォーマットが深度ステンシル フォーマットの場合、このメソッドは適用できない。

宛先サーフェスがテクスチャのレベルゼロなら、それはダーティーとマークされる。詳細については、「IDirect3DDevice8.UpdateTexture」および「IDirect3DTexture8.AddDirtyRect」を参照すること。