Device.UpdateTexture-Methode
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Aktualisiert die veralteten Teile einer Textur.
Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Syntax
'Declaration
Public Sub UpdateTexture ( _
sourceTexture As BaseTexture, _
destinationTexture As BaseTexture _
)
'Usage
Dim instance As Device
Dim sourceTexture As BaseTexture
Dim destinationTexture As BaseTexture
instance.UpdateTexture(sourceTexture, _
destinationTexture)
public void UpdateTexture(
BaseTexture sourceTexture,
BaseTexture destinationTexture
)
public:
void UpdateTexture(
BaseTexture^ sourceTexture,
BaseTexture^ destinationTexture
)
member UpdateTexture :
sourceTexture:BaseTexture *
destinationTexture:BaseTexture -> unit
Parameter
- sourceTexture
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.BaseTexture
Ein BaseTexture-Objekt, das die Quelltextur darstellt, die im Systemspeicher sein muss.Weitere Informationen finden Sie unter SystemMemory.
- destinationTexture
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.BaseTexture
Ein BaseTexture Objekt, das die Quelltextur darstellt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidCallException | Der Methodenaufruf ist ungültig.Beispielsweise kann ein Parameter einen ungültigen Wert enthalten. |
Hinweise
Dirty einen Teil einer Textur Sperren oder AddDirtyRectangle aufrufen.
UpdateTexture ruft die veralteten Teile der Textur ab, indem Berechnung was kumulierten wurde seit der letzten Vorgang aktualisiert.
Aus Gründen der Leistung werden geänderte Bereiche nur für die Ebene 0 einer Textur aufgezeichnet.Für Unterebenen wird davon ausgegangen, dass die entsprechende () Rechteck oder Feld skalierte auch verschmutzt ist.Fehlerhafte Bereiche werden automatisch aufgezeichnet, wenn ohne LockRectangle oder NoDirtyUpdateReadOnly aufgerufen wird.Darüber hinaus wird die Zieloberfläche UpdateTexture geändert gekennzeichnet.
Diese Methode schlägt fehl, wenn die Texturen unterschiedlicher Typen sind, wenn die unterste Ebene Puffer verschiedener Größen sind oder wenn Ihre entsprechenden Ebenen nicht übereinstimmen.Betrachten Sie beispielsweise eine Quelltextur mit sechs Ebenen mit den folgenden Dimensionen:
32x16, 16x8, 8x4, 4x2, 2x1, 1x1
Diese Quelltextur mit sechs Ebenen kann die Quelle für das folgende Ziel eine Ebenen sein:
1x1
für die folgende Ziel mit zwei Ebenen:
2x1, 1x1
oder für das folgende Ziel mit drei Ebenen:
4x2, 2x1, 1x1
Darüber hinaus schlägt diese Methode fehl, wenn die Texturen unterschiedliche Formate aufweisen.Wenn die Ziel-Struktur weniger Ebenen als die Quelle hat, werden nur die übereinstimmenden Ebenen kopiert.Wenn die Quelltextur weniger Ebenen als das Ziel hat, schlägt die Methode fehl.
Die Quelltextur veraltete Bereiche enthält, kann der Kopiervorgang optimiert werden, indem Sie auf die Bereiche nur einschränken.Es ist nicht garantiert, dass nur diese fehlerhaft gekennzeichnet Bytes kopiert werden.
.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