GdipSetPenLineJoin()

Resultat.i = GdipSetPenLineJoin(*pen, lineJoin.il)

*pen

[in] Pointeur sur un objet Pen.

lineJoin.i

[in] Elément de l'énumération Linejoin qui définit le type de jonction utilisé par le pen.

Cette fonction permet de définir le type de jonction utilisé par le pen lorsqu'une de ses lignes rencontre une autre de ses lignes.

Ce type peut être :

#LineJoinMiter
Définit une jonction à onglet qui dessine un angle aigu ou un coin découpé, selon que la longueur de l'onglet dépasse ou non celle de la limite de l'onglet.

La longueur de la jonction est la distance à partir de l'intersection du bord intérieur de la jonction jusqu'à l'intersection du bord extérieur de la jonction (lettre A sur le croquis). La longueur de la jonction peut être grande lorsque l'angle de rencontre entre deux lignes est petit.

La limite de l'onglet est le rapport maximum autorisé entre la longueur de l'onglet et la largeur du pen. La valeur par défaut est de 10.0.

Si le rapport réel dépasse la limite, le coin est coupée perpendiculairement à l'onglet à une distance du coin intérieur qui est le produit de la limite de l'onglet par la largeur du pen.

LineJoinMiter - les bords des traits sont prolongés au niveau de la jonction jusqu'à leur intersection. Si la prolongation des traits est trop grande relativement à la valeur maximale définie à l'aide de la commande SetMiterLimit, la jonction passe en mode #LineJoinBevel.

#LineJoinBevel
Définit une jonction biseautée (tronquée) qui dessine un coin en diagonale.

#LineJoinRound
Définit une jonction circulaire qui dessine un arc circulaire et lisse entre les lignes.

#LineJoinMiterClipped
Définit une jonction à onglet qui dessine un coin biseauté ou un angle aigu, selon que la longueur de l'onglet dépasse ou non celle de la limite de l'onglet.

La valeur de la limite par défaut est de 10.0

Si la limite est dépassée, la jonction est dessinée comme si son type étaient #LineJoinBevel, c'est-à-dire lorsque les bords intérieurs de la jonction se rencontrent, une ligne est dessinée pour réunir les bords extérieurs de la jointure.

 

Aperçu des effets :

 

Le fichier d'exemple crée un pen de 20 pixels de large, dessine deux rectangles avec les paramètres #LineJoinBevel et #LineJoinRound ainsi que 5 triangles avec les paramètres suivants :

#LineJoinBevel (tous les angles sont tronqués)

#LineJoinMiter avec limite à 10 (pas de modification du coin)
#LineJoinMiter avec limite à 2 (1 coin modifié)

#LineJoinMiterClipped avec limite à 10 (pas de modification du coin)
#LineJoinMiterClipped avec limite à 1.5 (2 angles modifiés avec style #LineJoinBevel)

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium