GdipTranslateWorldTransform()


Syntaxe
Resultat.i = GdipTranslateWorldTransform(*graphics, dx.f, dy.f, order.i)

Paramètres
*graphics

[in] Pointeur sur un objet Graphics existant.

dx.f

[in] Nombre flottant qui spécifie la valeur de translation sur l'axe x.

dy.f

[in] Nombre flottant qui spécifie la valeur de translation sur l'axe y.

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 met à jour la matrice de transformation courante du graphique (world transfomation matrix) avec le résultat du produit d'elle même et d'une matrice de translation dont les valeurs sont contenues dans les paramètres dx.f et dy.f.
En conséquence, le graphique subit une translation en fonction des valeurs passées par dx.f et dy.f en suivant l'ordre définit par order.l.
Cette fonction effectue un déplacement des origines du graphique selon les valeurs spécifiées. La translation s'applique à tous les objets du graphique.
L'exemple utilise un graphique à partir du Hdc de la fenêtre. Une première ellipse est dessinée en rouge à la position x=0 et y = 0. Ensuite, on applique au graphique une translation en x de 100 et y de 80. Une seconde ellipse est dessinée en noir à la position x=0 et y = 0. Cette ellipse est réellement positionnée en x = 100 et y = 80 du fait de la translation.
Vous pouvez voir aussi l'exemple de la fonction GdipScaleWorldTransform() qui utilise les propriétés du paramètre order.

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