IDCompositionVisual2::SetBackFaceVisibility, méthode (dcomp.h)

Spécifie si les surfaces auxquelles des transformations 3D sont appliquées doivent être affichées en face de l’observateur.

Syntaxe

HRESULT SetBackFaceVisibility(
  DCOMPOSITION_BACKFACE_VISIBILITY visibility
);

Paramètres

visibility

[in]

Visibilité face arrière à utiliser lors de la composition de surfaces dans la sous-arborescence de ce visuel à l’écran.

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Notes

La propriété de visibilité de face arrière affecte la façon dont les surfaces avec des transformations 3D appliquées sont rendues.

Par défaut, un visuel hérite de la propriété de visibilité face arrière de son visuel parent, qui peut hériter de la propriété de visibilité face arrière de son visuel parent, et ainsi de suite. Un visuel utilise le mode DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE si cette méthode n’est jamais appelée pour le visuel ou si cette méthode est appelée avec DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT. Si aucun visuel ne définit la propriété de visibilité face arrière, la valeur par défaut de l’arborescence visuelle entière est DCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE.

Si le paramètre de visibilité est autre que DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT, les surfaces de ce visuel sont composées avec le mode de visibilité spécifié. En outre, ce mode de visibilité devient la nouvelle valeur par défaut pour les enfants du visuel actuel. Autrement dit, si le mode de visibilité des enfants de ce visuel est inchangé ou explicitement défini sur DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT, les surfaces que les visuels enfants sont composés à l’aide du mode de visibilité de ce visuel.

Spécifications

Voir aussi

DirectComposition Backface et D2D Batching

IDCompositionEffectGroup::SetTransform3D

IDCompositionVisual2