GdipImageGetFrameDimensionsCount()

Resultat.i = GdipImageGetFrameDimensionsCount(*image, @count.i)

*image

[in] Pointeur sur un objet image.

count.i

[out] count recevra le nombre de dimensions de l'image.

Cette fonction permet de retrouver le nombre de dimensions contenue dans une image (pour les images supportant cette propriété).

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.

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.