ID2D1RenderTarget ::P ushAxisAlignedClip(constD2D1_RECT_F&,D2D1_ANTIALIAS_MODE) (d2d1.h)
Spécifie un rectangle dans lequel toutes les opérations de dessin suivantes sont clippées.
Syntaxe
void PushAxisAlignedClip(
const D2D1_RECT_F & clipRect,
D2D1_ANTIALIAS_MODE antialiasMode
);
Paramètres
clipRect
Type : [in] const D2D1_RECT_F &
Taille et position de la zone de découpage, en pixels indépendants de l’appareil.
antialiasMode
Type : [in] D2D1_ANTIALIAS_MODE
Mode anti-attirail utilisé pour dessiner les bords des séquences d’éléments qui ont des limites subpixel et pour mélanger le clip avec le contenu de la scène. Le mélange est effectué une seule fois lorsque la méthode PopAxisAlignedClip est appelée et ne s’applique pas à chaque primitive au sein de la couche.
Valeur de retour
None
Remarques
Le clipRect est transformé par le jeu de transformation du monde actuel sur la cible de rendu. Une fois la transformation appliquée au clipRect transmis, le cadre englobant aligné sur l’axe du clipRect est calculé. Pour plus d’efficacité, le contenu est coupé dans ce cadre englobant aligné sur l’axe et non dans le clipRect d’origine transmis.
Les diagrammes suivants montrent comment une transformation de rotation est appliquée à la cible de rendu, au clipRect résultant et à un cadre englobant aligné sur un axe calculé.
- Supposons que le rectangle de l’illustration suivante est une cible de rendu alignée sur les pixels de l’écran.
- Appliquez une transformation de rotation à la cible de rendu. Dans l’illustration suivante, le rectangle noir représente la cible de rendu d’origine et le rectangle en pointillés rouges représente la cible de rendu transformée.
- Après avoir appelé PushAxisAlignedClip, la transformation de rotation est appliquée au clipRect. Dans l’illustration suivante, le rectangle bleu représente le clipRect transformé.
- Le cadre englobant aligné sur l’axe est calculé. Le rectangle vert en pointillés représente le cadre englobant de l’illustration suivante. Tout le contenu est coupé dans ce cadre englobant aligné sur l’axe.
Une paire PushAxisAlignedClip et PopAxisAlignedClip peut se produire autour ou au sein d’un PushLayer et d’un PopLayer, mais ne peut pas se chevaucher. Par exemple, la séquence de PushAxisAlignedClip, PushLayer, PopLayer, PopAxisAlignedClip est valide, mais la séquence de PushAxisAlignedClip, PushLayer, PopAxisAlignedClip, PopLayer n’est pas valide.
Cette méthode ne retourne pas de code d’erreur en cas d’échec. Pour déterminer si une opération de dessin (telle que PushAxisAlignedClip) a échoué, case activée le résultat retourné par les méthodes ID2D1RenderTarget ::EndDraw ou ID2D1RenderTarget ::Flush.
Configuration requise
Client minimal pris en charge | Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | d2d1.h |
Bibliothèque | D2d1.lib |
DLL | D2d1.dll |