GdipSetImageAttributesToIdentity()



Syntaxe
Resultat.i = GdipSetImageAttributesToIdentity(*imageattr, type.i)
Paramètres
*imageattr

[in] Pointeur sur un objet ImageAttributes.

type.i

[in] Elément de l'énumération ColorAdjustType qui indique la catégorie pour laquelle la matrice d'identité est appliquée à la matrice de réglage des couleurs.

Description

Cette fonction permet d'appliquer la matrice d'identité à la matrice de réglage des couleurs pour la catégorie indiquée.

La matrice d'identité représente une transformation sans mise à l'échelle, ni translation, ni rotation et ni conversion; elle représente une transformation qui ne fait rien.

Un objet ImageAttributes conserve les paramètres de réglage des couleurs et des nuances de gris pour cinq catégories de réglages : par défaut, bitmap, brush, pen et text.

Les paramètres de réglage des couleurs et des nuances de gris par défaut s'appliquent à toutes les catégories qui n'ont pas de paramètres de réglage propres. Par exemple, si vous ne spécifiez jamais de paramètres de réglage pour la catégorie pen, les paramètres par défaut s'appliquent à cette catégorie. Dès que vous spécifiez un paramètre de réglage des couleurs ou des nuances de gris pour une catégorie donnée, les paramètres de réglage par défaut ne s'appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez un ensemble de paramètres de réglage pour la catégorie par défaut. Si vous définissez le seuil (plage de transparence) de la catégorie pen en passant #ColorAdjustTypePen à la fonction GdipSetImageAttributesThreshold(), aucun des paramètres de réglage par défaut ne s'appliquera aux pen.
Vous pouvez rétablir les réglages par défaut pour cette catégorie en utilisant la fonction GdipResetImageAttributes().

L'exemple charge une image bmp et l'affiche deux fois. L'image de gauche est l'image d'origine qui ne changera pas. L'image de droite va subir un inclinaison des couleurs (ajout au vert de 60% de la valeur de la couche alpha et ajout au rouge les 100% de la valeur du vert). En cliquant sur le bouton, on peut applique la matrice d'identité à l'image de droite et on la redessine. Le résultat est que la modification des couleurs est annulée du fait que l'on applique à l'image d'origine une matrice d'identité qui ne fait rien.

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