Metodo Device.UpdateTexture

Articolo
09/12/2008

Aggiornamento: novembre 2007

Aggiorna le porzioni dirty di una trama.

Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Sintassi

'Dichiarazione
Public Sub UpdateTexture ( _
    sourceTexture As BaseTexture, _
    destinationTexture As BaseTexture _
)
'Utilizzo
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
)

Parametri

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

Oggetto BaseTexture che rappresenta la trama di origine che deve trovarsi nella memoria di sistema. Per ulteriori informazioni, vedere SystemMemory.

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

Oggetto BaseTexture che rappresenta la trama di origine.

Eccezioni

Eccezione	Condizione
InvalidCallException	La chiamata al metodo non è valida. Un parametro potrebbe, ad esempio, contenere un valore non valido.

Note

Per rendere dirty una parte di una trama, bloccarla o chiamare il metodo AddDirtyRectangle.

Il metodo UpdateTexture recupera le parti dirty della trama calcolando quali elementi sono stati accumulati dall'ultima operazione di aggiornamento.

Per motivi legati alle prestazioni, le aree dirty vengono registrate solo per il livello 0 di una trama. Per i sottolivelli, si presume che anche il rettangolo o la casella corrispondente (in scala) siano dirty. Le aree dirty vengono automaticamente registrate quando viene chiamato il metodo LockRectangle senza NoDirtyUpdate o ReadOnly. Inoltre, la superficie di destinazione del metodo UpdateTexture viene contrassegnata come dirty.

Questo metodo ha esito negativo se le trame sono di tipi diversi, se i relativi buffer di livello inferiore sono di dimensioni diverse o se i relativi livelli corrispondenti non corrispondono. Ad esempio, considerare una trama di origine a sei livelli con le dimensioni riportate di seguito:

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

Questa trama di origine a sei livelli può essere l'origine per la destinazione a un livello riportata di seguito:

1x1

Per la destinazione a due livelli riportata di seguito:

2x1, 1x1

Oppure per la destinazione a tre livelli riportata di seguito:

4x2, 2x1, 1x1

Inoltre, questo metodo avrà esito negativo se le trame sono di formati diversi. Se la trama di destinazione presenta un numero inferiore di livelli rispetto all'origine, vengono copiati solo i livelli corrispondenti. Se la trama di origine presenta un numero inferiore di livelli rispetto alla destinazione, il metodo avrà esito negativo.

Se la trama di origine contiene aree dirty, l'operazione di copia può essere ottimizzata limitandola solo a tali aree. Non è possibile garantire che verranno copiati solo i byte contrassegnati come dirty.

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Piattaforme

Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Compact Framework

Supportato in: 3.5, 2.0

Vedere anche

Riferimenti

Device Classe

Membri Device

Spazio dei nomi Microsoft.WindowsMobile.DirectX.Direct3D

Condividi tramite