Microsoft DirectX 8.0 (Visual Basic) |
あるサーフェスから別のサーフェスに、ピクセルの矩形サブセットをコピーする。
object.CopyRects( _ SourceSurface As Direct3DSurface8, _ FirstElementOfSourceRectsArray As Any, _ NumberOfRects As Long, _ DestinationSurface As Direct3DSurface8, _ FirstElementofDestPointArray As Any)
失敗した場合はエラーが発生し、Err.Number に D3DERR_INVALIDCALL が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
このメソッドは、伸縮、カラー キー、アルファ ブレンド、フォーマット変換、および転送元または転送先矩形のいずれかのクリッピングをサポートしていない。すべての転送元矩形および対応する転送先矩形が、それぞれ転送元および転送先サーフェス内に完全に含まれていない場合には、このメソッドが失敗することに注意する。2 つのサーフェスのフォーマットは一致していなければならないが、ディメンジョンは異なっていてもかまわない。
サーフェスのフォーマットが深度ステンシル フォーマットの場合、このメソッドは適用できない。
宛先サーフェスがテクスチャのレベルゼロなら、それはダーティーとマークされる。詳細については、「IDirect3DDevice8.UpdateTexture」および「IDirect3DTexture8.AddDirtyRect」を参照すること。