Partager via

ID2D1PathGeometry1 ::ComputePointAndSegmentAtLength(FLOAT,UINT32,constD2D1_MATRIX_3X2_F&,FLOAT,D2D1_POINT_DESCRIPTION*) (d2d1_1.h)

  • Article

Calcule le point qui existe à une distance donnée le long de la géométrie de chemin avec l’index du segment sur lequel se trouve le point et le vecteur directionnel à ce point.

Syntaxe

HRESULT ComputePointAndSegmentAtLength(
        FLOAT                     length,
        UINT32                    startSegment,
  [ref] const D2D1_MATRIX_3X2_F & worldTransform,
        FLOAT                     flatteningTolerance,
  [out] D2D1_POINT_DESCRIPTION    *pointDescription
);

Paramètres

length

Type : FLOAT

La distance à parcourir le long du chemin.

startSegment

Type : UINT32

Index du segment auquel commencer la marche. Remarque : cet index est global pour l’ensemble du chemin d’accès, pas seulement pour une figure particulière.

[ref] worldTransform

Type : const D2D1_MATRIX_3X2_F

Transformation à appliquer au chemin avant la marche.

flatteningTolerance

Type : FLOAT

Tolérance d’aplatissement à utiliser lors de la marche le long d’un arc ou d’un segment de Béziers. La tolérance d’aplatissement est l’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.

[out] pointDescription

Type : D2D1_POINT_DESCRIPTION*

Lorsque cette méthode retourne, contient une description du point qui se trouve à l’emplacement donné.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT Description
S_OK Aucune erreur ne s'est produite.
E_OUTOFMEMORY Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.
E_INVALIDARG L’une des entrées était dans une plage non valide.

Configuration requise

   
Plateforme cible Windows
En-tête d2d1_1.h (include D2d1_1.h)
Bibliothèque D2d1_3.lib
DLL D2d1_3.dll

Voir aussi

ID2D1PathGeometry1