Compartir a través de


Método IDCompositionVisual2::SetBackFaceVisibility (dcomp.h)

Especifica si las superficies que tienen transformaciones 3D aplicadas deben mostrarse al alejarse del observador.

Sintaxis

HRESULT SetBackFaceVisibility(
  DCOMPOSITION_BACKFACE_VISIBILITY visibility
);

Parámetros

visibility

[in]

Visibilidad de la cara trasera que se va a usar al componer superficies en el subárbol de este objeto visual en la pantalla.

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

La propiedad de visibilidad de la cara trasera afecta a cómo se representan las superficies que tienen transformaciones 3D aplicadas.

De forma predeterminada, un objeto visual hereda la propiedad de visibilidad de la cara posterior de su objeto visual primario, que puede heredar la propiedad de visibilidad de la cara posterior de su objeto visual primario, etc. Un objeto visual usa el modo DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE si nunca se llama a este método para el objeto visual o si se llama a este método con DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT. Si ningún objeto visual establece la propiedad de visibilidad de la cara posterior, el valor predeterminado para todo el árbol visual es DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE.

Si el parámetro de visibilidad es distinto de DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT, las superficies de este objeto visual se componen con el modo de visibilidad especificado. Además, este modo de visibilidad se convierte en el nuevo valor predeterminado para los elementos secundarios del objeto visual actual. Es decir, si el modo de visibilidad de los elementos secundarios de este objeto visual no cambia o se establece explícitamente en DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT, las superficies que los objetos visuales secundarios se componen mediante el modo de visibilidad de este objeto visual.

Requisitos

   
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dcomp.h
Library Dcomp.lib
Archivo DLL Dcomp.dll

Consulte también

DirectComposition Backface y procesamiento por lotes D2D

IDCompositionEffectGroup::SetTransform3D

IDCompositionVisual2