GdipRotateWorldTransform()



Syntaxe
Resultat.i = GdipRotateWorldTransform(*graphics, angle.f, order.i)
Paramètres
*graphics

[in] Pointeur sur un objet Graphics existant.

angle.f

[in] Paramètre de type flottant indiquant la rotation en degrés. Si l'angle est positif, la rotation se fait dans le sens des aiguilles d'une montre, sinon dans le sens contraire.

order.i

[in] Élément de l'énumération MatrixOrder qui indique l'ordre de la multiplication des matrices. MatrixOrderPrepend indique que la multiplication se fait de gauche à droite et MatrixOrderAppend indique que la multiplication se fait de droite à gauche. La valeur par défaut est MatrixOrderPrepend. Ces valeurs déterminent l'ordre d'application des transformations tel que défini par l'énumération MatrixOrder.

Description

Cette fonction permet de faire le produit de la matrice de transformation universelle (world transformation) du graphique avec la matrice de rotation de la fonction. La matrice de transformation universelle du graphique est mis à jour avec le résultat de ce produit.

La fonction permet de faire une rotation angulaire du graphique.

Le paramètre order est important. Il défini l'ordre de la multiplication des matrices.
La multiplication des matrices n'est pas commutative. La multiplication de *matrix1 par *matrix2 est différente de la multiplication de *matrix2 par *matrix1.

Reportez-vous à la fonction GdipMultiplyWorldTransform() pour des explications sur le paramètre order définissant l'ordre des opérations.

Le peremier 'exemple crée un graphique, dessine un rectangle en noir (pas de rotation), ensuite applique une rotation au graphique de 30° puis dessine un rectangle en bleu avec les mêmes coordonnées.
L'origine du graphique est toujours le point X = 0 et Y = 0.

Le second exemple est un exemple de Flype modifié. On dessine une image (un chien) en boucle sur le graphique auquel on applique une rotation anglulaire de 0,4 degré à chaque boucle. On appalique aussi une translation en X et Y au graophique pour afficher l'image au centre. L'affichage s'arrête et le fichier se ferme lorsque l'angle atteint la valeur de 2000.

Résultat de la fonction
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.
PB - OS

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