GdipSetImageAttributesOutputChannel()



Syntaxe
Resultat.i = GdipSetImageAttributesOutputChannel(*imageattr, type.i, enableFlag.i, channelFlags.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 le canal de sortie CMJN est défini.

enableFlag.i

[in] Valeur booléenne. Si enableFlag vaut #True, le canal de sortie CMJN est appliqué, sinon il ne l'est pas.

channelFlags.i

[in] Élément de l'énumération ColorChannelFlag qui spécifie le canal de sortie. Ces valeurs peuvent être combinés en utilisant l'opérateur OR ( | ).

Description

Cette fonction permet de définir le canal de sortie CMJN (cyan-magenta-jaune-noir) pour la catégorie donnée. L'abréviation anglaise de CMJN est CMYK (cyan-magenta-yellow-black). Elle est utilisée pour convertir une image en espace de couleurs CMJN et permet d'examiner les intensités de l'un des canaux de couleurs CMJN. Si on crée un objet ImageAttributes et que l'on défini son canal de sortie bitmap à #ColorChannelFlagsC et que l'on dessine l'image avec l'objet ImageAttributes, la composante cyan de chaque pixel est calculée et chaque pixel de l'image restituée est une nuance de gris qui indique l'intensité de son canal cyan. On peut faire la même chose pour les canaux magenta, jaune et noir.

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 et l'affiche 4 fois à gauche et en face de chaque image est affichée l'image avec le canal correspondant qui est inscrit entre les deux images.

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