GdipGetImageEncoders()

Resultat.i = GdipGetImageEncoders(numEncoders.i, size.i, *encoders.ImageCodecInfo)

numEncoders.i

[in] Nombre entier qui spécifie le nombre d'encodeurs d'image disponibles. Utilisez la fonction GdipGetImageEncodersSize() pour déterminer ce nombre.

size.i

[in] Nombre entier qui spécifie la taille globale en octets du tableau de structures ImageCodecInfo. Utilisez la fonction GdipGetImageEncodersSize() pour déterminer ce nombre.

*encoders.ImageCodecInfo

[out] Pointeur sur une zone mémoire (buffer) qui recevra le tableau de structures ImageCodecInfo. Vous devez allouer de la mémoire pour ce tableau. Utilisez la fonction GdipGetImageEncodersSize() pour déterminer sa taille.

Cette fonction permet de retrouver le tableau de structures ImageCodecInfo qui contient les informations sur les encodeurs d'images disponibles.

Cette fonction est à utiliser après l'appel de la fonction GdipGetImageEncodersSize() qui permet de retrouver les valeurs des paramètres numEncoders et size.

GDI+ utilise des encodeurs intégrés pour sauvegarder certains type d'images.

L'exemple est le même que celui de la fonction GdipGetImageEncodersSize(). Il permet d'afficher l'ensemble des décodeurs présents (chaîne MimeType qui est un élément de la structure ImageCodecInfo).

La fonction GdipGetImageEncodersSIze() est également utilisée dans l'exemple de la fonction GdipSaveImageToFile() qui permet d'enregistrer une image PNG dans un des format BMP, GIF, JPEG ou TIFF, format sans compression. C'est la procédure GetEncoderClsid(format.s, *Clsid.CLSID) qui utilise cette fonction, elle permet de retrouver tous les éléments de l'encodeur voulu et est définie dans le fichier gdiplus.pbi.

La fonction GdipGetImageEncoders() est également utilisée dans l'exemple de la fonction GdipGetEncoderParameterList() qui permet de lister les paramètres supportés par chaque encodeur d'image disponible.

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.

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium