Device.StretchRectangle-Methode

Artikel
11/08/2009

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Kopiert den Inhalt des Quellrechtecks in das Zielrechteck.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Sub StretchRectangle ( _
    sourceSurface As Surface, _
    sourceRectangle As Rectangle, _
    destSurface As Surface, _
    destRectangle As Rectangle, _
    filter As TextureFilter _
)
'Usage
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
)

member StretchRectangle : 
        sourceSurface:Surface * 
        sourceRectangle:Rectangle * 
        destSurface:Surface * 
        destRectangle:Rectangle * 
        filter:TextureFilter -> unit

Parameter

sourceSurface
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Ein Surface Objekt, das die Quelloberfläche darstellt.

sourceRectangle
Typ: System.Drawing.Rectangle
Ein Rectangle-Objekt, das Quellrechteck darstellt.Wenn nullNULL-Verweis (Nothing in Visual Basic), die gesamte Quelloberfläche verwendet wird.

destSurface
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Ein Surface Objekt, das die Zieloberfläche darstellt.

destRectangle
Typ: System.Drawing.Rectangle
Ein Rectangle-Objekt, das Zielrechteck darstellt.Wenn nullNULL-Verweis (Nothing in Visual Basic), die gesamte Zieloberfläche verwendet wird.

filter
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.TextureFilter
Filtertyp.Die zulässigen Werte sind Point oder Linear.Weitere Informationen finden Sie unter TextureFilter.

Hinweise

Das Quellrechteck kann gestreckt und durch die Kopie gefiltert werden.Diese Methode wird häufig verwendet, um das Seitenverhältnis des einen Videostream zu ändern.

Wenn der Vorgang führt in Streckung oder Verkleinerung, sind nicht alle Oberfläche Kombinationen für StretchRectangle gültig.Andere Faktoren gehören die Typen der beteiligten Oberflächen und Ihre Formate.

Die folgende Tabelle zeigt gültige Oberfläche Ziel Format Kombinationen aus:

Quellformat	Textur	RT-Textur	RT	Nur Offscreen-
Textur	Nein	ja	ja	Nein
RT-Textur	Nein	ja	ja	Nein
RT	Nein	ja	ja	Nein
Nur Offscreen-	Nein	ja	ja	Ja, aber nur mit Nein Strecken

Filterung angegeben ist, schlägt, wenn der Treiber legt StretchRectangleStretchRectangleFilterCaps fehl.Wenn None angegeben ist, wählt der Treiber einen Filtern Algorithmus.

Können Sie Tiefe Schablone Oberflächen in StretchRectangle Aufrufe, zur Verfügung gestellt ist keine Streckung oder Verkleinerung im Aufruf auftritt.Folgenden gelten die Beschränkungen auch DepthStencil Oberflächen Wenn mit einem Aufruf von StretchRectangle kopiert werden:

Beide Oberflächen müssen dasselbe Format mit keine Formatkonvertierung aufweisen.
Keine Streckung oder Verkleinerung ist zulässig.
Nur die gesamte Oberfläche kann kopiert werden.Sub-Rectangle Kopien sind nicht zulässig.

Anwendungen sollten CopyRects oder UpdateTexture anstatt StretchRectangle verwenden, um Textur Zuordnungen zu laden, da Sie interne Informationen und Schmutz Rechteck Tabellen entwickelt wurden.

Streckung zwischen Rechtecken auf derselben Oberfläche wird nicht unterstützt.Zum Testen der Hardware für Farbkonvertierung verwenden Sie die CheckDeviceFormatConversion -Methode des ein Manager, weil die Softwareemulation für die Konvertierung nicht unterstützt wird.Diese Methode gibt außerdem an, ob eine Streckung zwischen Oberflächen desselben Formats unterstützt wird.Streckung oder Verkleinerung wird nicht unterstützt, wenn beiden Oberflächen ein DXTn komprimiert hat Format.Die Quelloberfläche darf nicht Multisampling sein.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Plattformen

Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

Die .NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET framework.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 3.5, 2.0

Siehe auch

Referenz

Device Klasse

Member Device

Microsoft.WindowsMobile.DirectX.Direct3D-Namespace

Freigeben über