Device.StretchRectangle メソッド
アセンブリ: Microsoft.WindowsMobile.DirectX (microsoft.windowsmobile.directx.dll 内)

Public Sub StretchRectangle ( _ sourceSurface As Surface, _ sourceRectangle As Rectangle, _ destSurface As Surface, _ destRectangle As Rectangle, _ filter As TextureFilter _ )
Dim instance As Device Dim sourceSurface As Surface Dim sourceRectangle As Rectangle Dim destSurface As Surface Dim destRectangle As Rectangle Dim filter As TextureFilter instance.StretchRectangle(sourceSurface, sourceRectangle, destSurface, destRectangle, filter)
public void StretchRectangle ( Surface sourceSurface, Rectangle sourceRectangle, Surface destSurface, Rectangle destRectangle, TextureFilter filter )
public: void StretchRectangle ( Surface^ sourceSurface, Rectangle sourceRectangle, Surface^ destSurface, Rectangle destRectangle, TextureFilter filter )
public void StretchRectangle ( Surface sourceSurface, Rectangle sourceRectangle, Surface destSurface, Rectangle destRectangle, TextureFilter filter )
public function StretchRectangle ( sourceSurface : Surface, sourceRectangle : Rectangle, destSurface : Surface, destRectangle : Rectangle, filter : TextureFilter )

転送元の四角形は、コピーによって拡大およびフィルタ処理できます。このメソッドは、ビデオ ストリームの縦横比を変更する場合などに使用されます。
処理によって拡大または縮小が行われる場合、StretchRectangle では、すべてのサーフェイスの組み合わせが有効なわけではありません。その他の要因としては、サーフェイスの種類や形式などがあります。
有効なサーフェイスの転送先形式の組み合わせを次の表に示します。
× | ○ | ○ | × | |
× | ○ | ○ | × | |
× | ○ | ○ | × | |
× | ○ | ○ |
フィルタ処理を指定した場合、StretchRectangle は、ドライバが StretchRectangleFilterCaps を設定しない限り失敗します。None を指定した場合、ドライバはフィルタ処理アルゴリズムを選択します。
StretchRectangle の呼び出しで拡大および縮小が行われない場合には、呼び出しに深度ステンシル サーフェイスを使用できます。StretchRectangle の呼び出しによって DepthStencil サーフェイスをコピーする場合は、サーフェイスに次の制限が適用されます。
アプリケーションでテクスチャ マップを読み込む場合は、StretchRectangle ではなく CopyRects または UpdateTexture を使用する必要があります。これは、これらのメソッドが内部情報とダーティな四角形のテーブルを使用するようにデザインされているためです。
同じサーフェイス上の四角形間での拡大はサポートされていません。変換のソフトウェア エミュレーションはサポートされないため、ハードウェアの色変換をテストするには Manager の CheckDeviceFormatConversion メソッドを使用します。このメソッドは、同じ形式のサーフェイス間の拡大がサポートされているかどうかも示します。拡大と縮小は、いずれかのサーフェイスが DXTn 圧縮形式である場合にはサポートされません。転送元のサーフェイスは、マルチサンプル処理しないでください。


Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- Device.StretchRectangle メソッドのページへのリンク