Device.UpdateTexture (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Actualiza las partes desfasadas de una textura.

Espacio de nombres: Microsoft.WindowsMobile.DirectX.Direct3D
Ensamblado: Microsoft.WindowsMobile.DirectX (en Microsoft.WindowsMobile.DirectX.dll)

Sintaxis

'Declaración
Public Sub UpdateTexture ( _
    sourceTexture As BaseTexture, _
    destinationTexture As BaseTexture _
)
'Uso
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
)

Parámetros

sourceTexture
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.BaseTexture
Objeto BaseTexture que representa la textura de origen que debe estar en la memoria del sistema. Para obtener más información, vea SystemMemory.

destinationTexture
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.BaseTexture
Objeto BaseTexture que representa la textura de origen.

Excepciones

Excepción	Condición
InvalidCallException	La llamada al método no es válida. Por ejemplo, puede que un parámetro contenga un valor que no es válido.

Comentarios

Para desfasar una parte de una textura, bloquéela o llame a AddDirtyRectangle.

UpdateTexture recupera las partes desfasadas de la textura calculando lo acumulado desde la última operación de actualización.

Por motivos de rendimiento, las regiones desfasadas sólo se registran para el nivel 0 de una textura. En los subniveles, se asume que el rectángulo o cuadro correspondiente (con ajuste de escala) también está desfasado. Las regiones desfasadas se registran automáticamente cuando se llama a LockRectangle sin NoDirtyUpdate o ReadOnly. Asimismo, la superficie de destino de UpdateTexture se marca como desfasada.

Este método genera un error si las texturas son de tipos diferentes, si sus búferes de nivel inferior tienen tamaños diferentes o si sus niveles de coincidencia no concuerdan. Por ejemplo, considere una textura de origen de seis niveles con las dimensiones siguientes:

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

Esta textura de origen de seis niveles podría ser el origen para el siguiente destino de un nivel:

1x1

para el siguiente destino de dos niveles:

2x1, 1x1

o para el siguiente destino de tres niveles:

4x2, 2x1, 1x1

Además, este método genera un error si las texturas tienen formatos diferentes. Si la textura de destino tiene menos niveles que la de origen, sólo se copian los niveles coincidentes. Si la textura de origen tiene menos niveles que la de destino, el método genera un error.

Si la textura de origen contiene regiones desfasadas, la operación de copia puede optimizarse si se limita únicamente a esas regiones. No se garantiza que sólo se copien los bytes marcados como desfasados.

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Plataformas

Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Compact Framework

Compatible con: 3.5, 2.0

Vea también

Referencia

Device (Clase)

Device (Miembros)

Microsoft.WindowsMobile.DirectX.Direct3D (Espacio de nombres)

Share via