Device.UpdateTexture, méthode

Article
09/04/2008

Mise à jour : novembre 2007

Met à jour les parties modifiées d'une texture.

Espace de noms : Microsoft.WindowsMobile.DirectX.Direct3D
Assembly : Microsoft.WindowsMobile.DirectX (dans Microsoft.WindowsMobile.DirectX.dll)

Syntaxe

'Déclaration
Public Sub UpdateTexture ( _
    sourceTexture As BaseTexture, _
    destinationTexture As BaseTexture _
)
'Utilisation
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
)

public function UpdateTexture(
    sourceTexture : BaseTexture, 
    destinationTexture : BaseTexture
)

Paramètres

sourceTexture
Type : Microsoft.WindowsMobile.DirectX.Direct3D.BaseTexture

Objet BaseTexture qui représente la texture source qui doit être en mémoire système. Pour plus d'informations, consultez SystemMemory.

destinationTexture
Type : Microsoft.WindowsMobile.DirectX.Direct3D.BaseTexture

Objet BaseTexture qui représente la texture source.

Exceptions

Exception	Condition
InvalidCallException	L'appel de méthode n'est pas valide. Par exemple, un paramètre peut contenir une valeur non valide.

Notes

Pour modifier une partie d'une texture, verrouillez-la ou appelez AddDirtyRectangle.

UpdateTexture récupère les parties modifiées de la texture en calculant les éléments accumulés depuis la dernière opération de mise à jour.

Pour des raisons de performance, les régions modifiées sont enregistrées uniquement pour le niveau 0 d'une texture. Pour les sous-niveaux, il est supposé que le rectangle ou la zone correspondant (mis à l'échelle) fait également l'objet d'une modification. Les régions modifiées sont enregistrées automatiquement si LockRectangle est appelé sans NoDirtyUpdate ou ReadOnly. En outre, la surface de destination de UpdateTexture est marquée modifié.

Cette méthode échoue si les textures sont de types différents, si leurs mémoires tampons inférieures sont de tailles différentes, ou si leurs niveaux de correspondance ne correspondent pas. Par exemple, considérons une texture source à six niveaux avec les dimensions suivantes :

32x16, 16x8, 8x4, 4x2, 2x1, 1x1

Cette texture source à six niveaux peut être la source de la destination de niveau unique suivante :

1x1

pour la destination à deux niveaux suivante :

2x1, 1x1

ou pour la destination à trois niveaux suivante :

4x2, 2x1, 1x1

De plus, cette méthode échoue si les textures ont des formats différents. Si la texture de destination a moins de niveaux que la source, seuls les niveaux correspondants sont copiés. Si la texture source a moins de niveaux que la destination, la méthode échoue.

Si la texture source contient des régions modifiées, l'opération de copie peut être optimisée en la limitant à ces régions. Il n'est pas garanti que seuls les octets marqués comme modifiés seront copiés.

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Plateformes

Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Compact Framework

Pris en charge dans : 3.5, 2.0

Voir aussi

Référence

Device, classe

Membres Device

Microsoft.WindowsMobile.DirectX.Direct3D, espace de noms

Partager via