Objet PngExtendedParams (interface IPngExtendedParams)

Cet objet permet de régler les paramètres d’enregistrement d’une image en noir et blanc au format PNG (format IFF_Png) à l’aide de la méthode IImage::WriteToFile. Un pointeur vers cet objet est transmis à la méthode IImage::WriteToFile en tant que paramètre d’entrée et influe ainsi sur les propriétés de l’image obtenue. Toutes les propriétés d’un objet nouvellement créé de ce type sont définies sur des valeurs par défaut appropriées. Consultez la description de chaque propriété pour connaître sa valeur par défaut.

L’objet PngExtendedParams est un objet persistant. Cela signifie que l’état actuel de l’objet peut être écrit dans un stockage persistant. Par la suite, l’objet peut être recréé en relisant son état à partir de ce stockage persistant. Les méthodes suivantes assurent la persistance de l’objet :

Linux : SaveToFile, et LoadFromFile

Windows SaveToFile, LoadFromFile, SaveToMemory, et LoadFromMemory.

​

Propriétés

Nom	Type	Description
Application	Engine, lecture seule	Retourne l’objet Engine.
TransparentColor	int	Définit la couleur à remplacer par des zones transparentes lors de l’enregistrement de l’image au format PNG. Seules les couleurs noire et blanche sont actuellement prises en charge. La valeur int est calculée à partir du triplet RVB à l’aide de la formule : ( valeur rouge ) + (256 x valeur verte ) + (65536 x valeur bleue ), où la valeur rouge est le premier composant du triplet, la valeur verte est le deuxième composant du triplet et la valeur bleue est le troisième composant du triplet. Par exemple, la valeur int de la couleur blanche est égale à 16777215. La valeur par défaut de cette propriété est -1, ce qui signifie qu’aucune couleur ne sera remplacée par la transparence.

​

Méthodes

Nom	Description
CopyFrom	Initialise les propriétés de l’objet courant avec les valeurs des propriétés correspondantes d’un autre objet.
LoadFromFile	Restaure le contenu de l’objet depuis un fichier sur le disque.
LoadFromMemory	Restaure le contenu de l’objet depuis la mémoire globale. Windows uniquement.
SaveToFile	Enregistre le contenu de l’objet dans un fichier sur le disque.
SaveToMemory	Enregistre le contenu de l’objet dans la mémoire globale. Windows uniquement.

​

Paramètre de sortie

Cet objet est le paramètre de sortie de la méthode CreatePngExtendedParams de l’objet Engine.

​

Paramètre d’entrée

Cet objet constitue le paramètre d’entrée de la méthode WriteToFile de l’objet Image.

​

Voir aussi

ImageFileFormatEnum

Utilisation des images

Utilisation des propriétés