GdipSetPixelOffsetMode()

Resultat.i = GdipSetPixelOffsetMode(*graphics, pixelOffsetMode.i)

*graphics

[in] Pointeur sur un objet Graphics existant.

pixelOffsetMode.i

[in] Elément de l'énumération PixelOffsetMode qui spécifie le mode de décalage des pixels.

Cette fonction permet de spécifier la façon dont les pixels doivent être décalés lors du rendu du graphique.

Le décalage des pixels permet d'améliorer la qualité du rendu mais réduit néanmoins la vitesse de l'opération.

Considérez par exemple le pixel dans le coin supérieur gauche d'une image à l'adresse (0, 0). Avec #PixelOffsetModeNone, le pixel couvre la zone entre -0.5 et 0.5 dans les directions x et y; c'est-à-dire que le centre du pixel est à (0, 0). Avec #PixelOffsetModeHalf, le pixel couvre la zone entre 0 et 1 dans les directions x et y; c'est-à-dire que le centre du pixel est à (0.5, 0.5).

Exemple :
Dessine une fenêtre.
Affiche l'image d'origine (une rose) avec sa taille d'origine en haut à gauche de la fenêtre
Applique le décalage des pixels #PixelOffsetModeHalf au graphique
Affiche en bas à gauche une réduction de l'image (45%) avec cette qualité
Applique le décalage des pixels #PixelOffsetModeNone au graphique
Affiche en bas à droite une réduction de l'image (45%) avec cette qualité

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.