Método ID3D11DeviceContext1::ClearView (d3d11_1.h)

  • Artículo

Establece todos los elementos de una vista de recursos en un valor.

Sintaxis

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

Parámetros

[in] pView

Puntero a la interfaz ID3D11View que representa la vista de recursos que se va a borrar.

[in] Color

Matriz de 4 componentes que representa el color que se va a usar para borrar la vista de recursos.

[in, optional] pRect

Matriz de estructuras de D3D11_RECT para los rectángulos en la vista de recursos que se va a borrar. Si es NULL, ClearView borra toda la superficie.

NumRects

Número de rectángulos de la matriz que especifica el parámetro pRect .

Valor devuelto

None

Observaciones

ClearView solo funciona en vistas de destino de representación (RTV), vistas de profundidad/galería de símbolos (DSV) en recursos de solo profundidad (recursos sin componente de galería de símbolos), vistas de acceso desordenado (UAV) o cualquier vista de vídeo de una superficie Texture2D . El tiempo de ejecución quita llamadas no válidas. Los rectángulos vacíos de la matriz pRect son sin operación. Un rectángulo está vacío si el valor superior es igual al valor inferior o el valor izquierdo es igual al valor derecho.

ClearView no admite texturas 3D.

ClearView aplica el mismo valor de color a todos los segmentos de matriz de una vista; todos los rectángulos de la matriz pRect corresponden a cada segmento de matriz. La matriz pRect de rectángulos es un conjunto de áreas que se borrarán en una sola superficie. Si la vista es una matriz, ClearView borra todos los rectángulos de cada segmento de matriz individualmente.

Cuando aplique rectángulos a búferes, establezca el valor superior en 0 y el valor inferior en 1 y establezca el valor izquierdo y el valor derecho para describir la extensión dentro del búfer. Cuando el valor superior es igual al valor inferior o el valor izquierdo es igual al valor derecho, el rectángulo está vacío y se logra una operación sin operación.

El controlador convierte y sujeta los valores de color al formato de destino según corresponda según las reglas de conversión de Direct3D. Por ejemplo, si el formato de la vista es DXGI_FORMAT_R8G8B8A8_UNORM, el controlador sujeta las entradas a 0,0f a 1,0f (+INF -> 1.0f (0XFF)/NaN -> 0,0f).

Si el formato es entero, como DXGI_FORMAT_R8G8B8A8_UINT, el tiempo de ejecución interpreta las entradas como valores flotantes enteros. Por lo tanto, 235.0f se asigna a 235 (redondea a cero, fuera de la abrazadera de valores de intervalo/INF al intervalo de destino y NaN a 0).

Estas son las asignaciones de colores:

  • Color[0]: R (o Y para vídeo)
  • Color[1]: G (o U/Cb para vídeo)
  • Color[2]: B (o V/Cr para vídeo)
  • Color[3]: A
En el caso de las vistas de vídeo con formatos YUV o YCbBr, ClearView no convierte los valores de color. En situaciones en las que el nombre de formato no indica _UNORM, _UINT, etc., ClearView asume _UINT. Por lo tanto, 235.0f se asigna a 235 (redondea a cero, fuera de la abrazadera de valores de intervalo/INF al intervalo de destino y NaN a 0).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d3d11_1.h
Library D3D11.lib

Consulte también

ID3D11DeviceContext1