GdipEnumerateMetafileSrcRectDestPointI()



Syntaxe
Resultat.i = GdipEnumerateMetafileSrcRectDestPointI(*graphics, *metafile, @destPoint.Point, @srcRect.Rect, srcUnit.i, @callback(), *callbackData, *imageAttributes)

Paramètres

*graphics

[in] Pointeur sur un objet Graphics.

*metafile

[in] Pointeur sur un objet metafile existant.

destPoint.Point

[in] Coordonnées d'un point (nombres entiers) qui représentent le coin supérieur gauche ou sera affiché la zone du métafichier définie par le paramètre srcRect.Rect (ou certains de ses enregistrements) avec la fonction GdipPlayMetafileRecord().

srcRect.Rect

[in] Coordonnées d'un rectangle (nombres entiers qui spécifie la zone du métafichier qui sera affichée (ou certains de ses enregistrements) avec la fonction GdipPlayMetafileRecord().

srcUnit.i

[in] Elément de l'énumération Unit qui indique l'unité de mesure du rectangle source.

@callback()

[in] Adresse d'une procédure Callback permettant l'énumération du métafichier. Le prototype de cette Callback est défini dans le fichier Gdiplustypes.h.

*callbackData

[in] Pointeur sur un bloc de données qui sera passé à la Callback. Si ce paramètre n'est pas utilisé, il doit être mis à 0.

*imageAttributes

[in] Pointeur sur un objet ImageAttributes qui spécifie les attributs de l'image. Ce paramètre peut être mis à 0 s'il n'est pas utilisé.

Description

Cette fonction est classé par Micosoft dans les fonctions Graphics mais je l'ai classée dans les métafiles.

Cette fonction permet d'énumérer les enregistrements du métafichier identifié par le paramètre *metafile et associé à un graphique (paramètre *graphics).

destPoint.Point défini un point à partir duquel un ou plusieurs des enregistrements du métafichier seront affichés. Ce paramètre n'est utilisé que par la fonction GdipPlayMetafileRecord() dans la callback. L'origine du graphique est toujours à x= 0 et y = 0. Ce paramètre permet d'introduire un décalage de l'origine en x/y.
Ce point est exprimé en nombre entiers, c'est ce qui différencie cette fonction de la fonction GdipEnumerateMetafileSrcRectDestPointI() qui a ce paramètre exprimé en nombres flottants, idem pour le paramètre srcRect.Rect.
srcRect.Rect défini un rectangle qui spécifie la zone du métafichier qui sera affichée (ou certains de ses enregistrements) avec la fonction GdipPlayMetafileRecord() aux coordonnées définies par le paramètre destPoint.Point pour le graphique défini par le paramètre *graphics.
*callbackData permet de passer un bloc de données à la callback, ces données pourront être utilisées dans la callback. Ce paramètre permet de passer par exemple l'identifiant du métafichier.
Les paramètres de la callback sont définis comme ceci :
recordType : WMF, EMF, EMF+
flags : (toujours 0 pour les enregistrements WMF/EMF)
dataSize : taille des données de l'enregistrement (en octets) ou 0 si pas de données.
data : Pointeur de données sur les données de l'enregistrement, ou #NULL si pas de données.
callbackData : Pointeur sur le bloc de données, s'il existe.
La callback peut ensuite appeler la fonction GdipPlayMetafileRecord() pour afficher les enregistrements (partiellement ou complètement) qui viennent juste d'être énumérés. Si cette fonction retourne #False, l'énumération se termine, sinon elle continue.
*imageAttributes peut être créé à partir d'une fonction comme GdipCreateimageAttributes() ou GdipCloneImageAttributes() pour obtenir un objet ImageAttributes. Les attributs d'image pourront ensuite être modifiés par une des commandes ImageAttributes.
L'exemple permet de choisir une zone rectangulaire de 100x100 pixels sur l'image de gauche (métafichier) et d'afficher cette zone à droite. La callback d'énumération ne sert qu'à afficher le métafichier dans cet exemple. Pour les différents types d'enregistrements possibles, reportez-vous à l'exemple de la fonction GdipEnumerateMetafileDestPointI().
Je n'obtiens pas le même résultat sous XP que sous Vista. Les résultats diffèrent aussi en fonction du fichier (problème de résolution ?)
Le comportement de cette fonction est identique à la fonction
GdipEnumerateMetafileSrcRectDestPoint().
Aperçu du résultat :
Ci-dessus sous VISTA, la zone de l'image définie par le rectangle blanc à gauche n'est pas redessinée dans la zone correspondante (même taille) de l'imageGadget de droite. Il y a réduction de l'image. La zone en vert manque.
Ci-dessous sous XP, cela semble identique pour un cadre source rectangulaire de 100x100. J'ai pensé aux unités du graphique mais même en les forçant, rien ne change. J'ai pensé aussi à un problème de résolution de l'image dont les API windows utiliseraient différemment mais je n'ai pas trouvé de solution.

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