Partager via

MÉTHODE ID2D1Geometry::Outline(constD2D1_MATRIX_3X2_F*,FLOAT,ID2D1SimplifiedGeometrySink*) (d2d1.h)

  • Article

Calcule le contour de la géométrie et écrit le résultat dans un ID2D1SimplifiedGeometrySink.

Syntaxe

HRESULT Outline(
  [in, optional] const D2D1_MATRIX_3X2_F     *worldTransform,
                 FLOAT                       flatteningTolerance,
  [in]           ID2D1SimplifiedGeometrySink *geometrySink
);

Paramètres

[in, optional] worldTransform

Type : const D2D1_MATRIX_3X2_F*

Transformation à appliquer au contour géométrique, ou NULL.

flatteningTolerance

Type : FLOAT

Erreur maximale autorisée lors de la construction d’une approximation polygonale de la géométrie. Aucun point dans la représentation polygonale ne diffère de la géométrie d’origine par plus que la tolérance d’aplatissement. Des valeurs plus faibles permettent de générer des résultats plus précis mais ralentissent l'exécution.

[in] geometrySink

Type : ID2D1SimplifiedGeometrySink*

ID2D1SimplifiedGeometrySink auquel le contour transformé de la géométrie est ajouté.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .

Remarques

La méthode Outline permet à l’appelant de produire une géométrie avec un remplissage équivalent à la géométrie d’entrée, avec les propriétés supplémentaires suivantes :

  • La géométrie de sortie ne contient aucune intersection transversale ; autrement dit, les segments peuvent toucher, mais ils ne se croisent jamais.
  • Les figures les plus extérieures de la géométrie de sortie sont toutes orientées dans le sens inverse des aiguilles d’une montre.
  • La géométrie de sortie est invariante en mode de remplissage ; autrement dit, le remplissage de la géométrie ne dépend pas du choix du mode de remplissage.

    Pour plus d’informations sur le mode de remplissage, consultez D2D1_FILL_MODE.

En outre, la méthode Outline peut être utile pour supprimer des parties redondantes de ces géométries afin de simplifier les géométries complexes. Il peut également être utile en combinaison avec ID2D1GeometryGroup pour créer des unions entre plusieurs géométries simultanément.

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 Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1Geometry