GdipImageGetFrameCount()

Resultat.i = GdipImageGetFrameCount(*image, *dimensionID.GUID, @count.i)

*image

[in] Pointeur sur un objet image.

*dimensionID.GUID

[in] Pointeur sur une variable GUID (globally unique identifier) qui spécifie la dimension.

count.i

[out] count recevra le nombre d'images (Frame) de la dimension indiquée de l'image. La dimension est définie par le paramètre *dimensionID.GUID.

Cette fonction permet de retrouver le nombre d'images de la dimension spécifiée contenue dans l'image.

Les formats graphiques GIF et TIFF permettent de stocker plusieurs images dans un fichier d'image. Les différentes images d'un fichier GIF sont utilisées pour l'animation, ainsi les images sont dites images de dimension temporelle. Les différentes images d'un fichier TIFF sont utilisées typiquement en tant que pages séparées, ainsi les images sont dites images de dimension paginée.

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 d'images (le nombre de frames) contenu dans cette image TIFF. Avec un timer, on affiche successivement chaque frame sur le graphique, en boucle.

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.