Platform SDK: DirectX

DirectDrawSurface7.Blt

DirectDrawSurface7.Blt メソッドは、ビット ブリットを実行する。このメソッドは、ブリット処理中に Z バッファまたはアルファ ブレンディング (アルファ チャネルを参照) をサポートしない。

object.Blt( _ 
    destRect As RECT, _ 
    ddS As DirectDrawSurface7, _
    srcRect As RECT, _ 
    flags As CONST_DDBLTFLAGS) As Long

パラメータ

object
DirectDrawSurface7 オブジェクトを表すオブジェクト式。
destRect
転送先サーフェス上にブリットする矩形の左上と右下の位置を定義する RECT 型。このパラメータが空の RECT 型の場合、転送先サーフェス全体を使用する。
ddS
ブリットの転送元である DirectDrawSurface オブジェクトに対する DirectDrawSurface7 オブジェクト。
srcRect
転送元サーフェス上からブリットする矩形の左上と右下の位置を定義する RECT 型。このパラメータが空の RECT の場合、転送元サーフェス全体を使用する。
flags
カラー キー情報を指定する、またはメソッドから特別な動作を要求する、関連付けられた DDBLTFX 型の有効メンバを決定する CONST_DDBLTFLAGS 列挙の定数の組み合わせ。

エラー コード

失敗すれば、次のいずれかのエラー コードを返す。

DDERR_GENERIC
DDERR_INVALIDCLIPLIST
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOALPHAHW
DDERR_NOBLTHW
DDERR_NOCLIPLIST
DDERR_NODDROPSHW
DDERR_NOMIRRORHW
DDERR_NORASTEROPHW
DDERR_NOROTATIONHW
DDERR_NOSTRETCHHW
DDERR_NOZBUFFERHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

注意

このメソッドは、同期または非同期のブリット (後者は、デフォルト動作) を、ディスプレイ メモリからディスプレイ メモリへ、ディスプレイ メモリからシステム メモリへ、システム メモリからディスプレイ メモリへ、システム メモリからシステム メモリへのいずれかで実行する能力がある。ブリットは、転送元カラー キーおよび転送先カラー キーを使って実行される。転送元および転送先矩形が同じサイズではない場合、任意の伸縮や収縮が行われる。

通常、ブリットがビジーの場合、またはブリットをセット アップできなかった場合、DirectDrawSurface7.Blt はエラーと共に即座に返る。同期ブリットを要求するには、DDBLT_WAIT フラグを指定する。DDBLT_WAIT フラグを指定すると、ブリットがセット アップされるか、メソッドが返る前に別のエラーが発生するまで、このメソッドは待機する。

right および bottom メンバは排他なので、dstRect srcRect パラメータを定義することに注意する。したがって、right から left を引くと矩形のと等しくなる。これは、矩形の幅から 1 を引いた値ではない。

このメソッドはしばしばエラーを引き起こすので、エラー オブジェクトにエラーを設定する代わりに、エラー コードを返す。