Platform SDK: DirectX |
DirectDrawSurface7.Blt メソッドは、ビット ブリットを実行する。このメソッドは、ブリット処理中に Z バッファまたはアルファ ブレンディング (アルファ チャネルを参照) をサポートしない。
object.Blt( _ destRect As RECT, _ ddS As DirectDrawSurface7, _ srcRect As RECT, _ flags As CONST_DDBLTFLAGS) As Long
失敗すれば、次のいずれかのエラー コードを返す。
このメソッドは、同期または非同期のブリット (後者は、デフォルト動作) を、ディスプレイ メモリからディスプレイ メモリへ、ディスプレイ メモリからシステム メモリへ、システム メモリからディスプレイ メモリへ、システム メモリからシステム メモリへのいずれかで実行する能力がある。ブリットは、転送元カラー キーおよび転送先カラー キーを使って実行される。転送元および転送先矩形が同じサイズではない場合、任意の伸縮や収縮が行われる。
通常、ブリットがビジーの場合、またはブリットをセット アップできなかった場合、DirectDrawSurface7.Blt はエラーと共に即座に返る。同期ブリットを要求するには、DDBLT_WAIT フラグを指定する。DDBLT_WAIT フラグを指定すると、ブリットがセット アップされるか、メソッドが返る前に別のエラーが発生するまで、このメソッドは待機する。
right および bottom メンバは排他なので、dstRect と srcRect パラメータを定義することに注意する。したがって、right から left を引くと矩形の幅と等しくなる。これは、矩形の幅から 1 を引いた値ではない。
このメソッドはしばしばエラーを引き起こすので、エラー オブジェクトにエラーを設定する代わりに、エラー コードを返す。