GdipImageGetFrameDimensionsList()


Syntaxe
Resultat.i = GdipImageGetFrameDimensionsList(*image, *dimensionID.GUID, count.i)

Paramètres
*image

[in] Pointeur sur un objet image.

*dimensionID.GUID

[out] Tableau de variables GUID (globally unique identifier) qui recevra les identificateurs GUID des différentes dimensions de l'image.

count.i

[in] Nombre d'éléments du tableau *dimensionID.GUID. Utilisez la fonction GdipImageGetFrameDimensionsCount() pour retrouver ce nombre.

Description
Cette fonction permet de retrouver la liste des dimensions contenue dans une image (pour Les images supportant cette propriété).
Cette liste est stockée dans un tableau d'éléments GUID (paramètre *dimensionID.GUID).
Cette fonction retourne des informations pour les images comportant plusieurs images (multiple-frame) provenant de deux types : multi-page et multi-résolution. Les dimensions sont dites FrameDimensionPage et FrameDimensionResolution. Une image multi-page est une image qui contient plus d'une image. Chaque page contient une image simple (ou frame). Ces pages (ou images, ou frames) sont typiquement affichées l'une derrière l'autre pour produire une séquence animée tel que dans un fichier GIF animé. Une image multi-résolution est une image qui contient plusieurs copies de la même image à différentes résolutions. Microsoft Windows® GDI+ supporte un nombre arbitraire de pages (ou images, ou frame), ainsi qu'un nombre arbitraire de résolutions.
Parmi tous les formats d'image actuellement supportés par GDI+, seul les formats GIF et TIFF utilisent les images multiples (multiple-frame).
La dimension FrameDimensionTime est à utiliser avec les images GIF.
La dimension FrameDimensionPage est à utiliser avec les images TIFF.

Gdi+ 1.0 ne supporte pas les gif à séquence d'images (images multiples).

L'exemple charge une image TIFF puis retrouve le nombre de dimensions, le type de dimension et le nombre d'images (le nombre de frame) contenu dans cette image TIFF. Avec un timer, on affiche successivement chaque frame sur le graphique, en boucle. Les informations sont affichées en dessous de l'image.

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