GdipSaveImageToStream

Le premier exemple crée un stream, charge 4 images de format différent, retrouve le CLSID de l'encodeur TIFF; enregistre les 4 images en suivant dans le stream sous la forme d'une image TIFF (séquence d'images), détruit les images ayant servies à l'enregistrement dans le stream, crée un nouvelle image à partir de l'image enregistrée dans le stream et finalement affiche une réduction de chaque images en utilisant des ImageGadget PureBasic.
Les étapes pour sauvegarder une séquence d'images (TIFF) dans un stream sont les mêmes que celles décrites à la fonction GdipSaveAddImage().

Le deuxième exemple crée un stream, charge une image format PNG, retrouve le CLSID de l'encodeur JPEG; enregistre l'image dans le stream au format JPEG sans compression, détruit l'image ayant servie à l'enregistrement dans le stream, crée un nouvelle image à partir de l'image enregistrée dans le stream et finalement affiche l'image en utilisant une ImageGadget PureBasic, l'image a les côtés divisés par 4 (la fenêtre est redimensionnée pour afficher l'image).
Pour la sauvegarde de l'image JPEG sans compression, les étapes sont les suivantes :

Le premier paramètre (*image) de la fonction est l'identifiant GDI+ de l'image ayant servi à créer le fichier (fonction GdipSaveImageToFile()) ou le stream (GdipSaveImageToStream())

Le second paramètre (*newImage) de la fonction est l'identifiant GDI+ de l'image à ajouter à la séquence d'images.

Le dernier paramètre (encoderParams.EncoderParameters) est une variable de type EncoderParameters (ce n'est pas un pointeur).

Ce dernier paramètre possède deux éléments :

Le paramètre Count.l indique le nombre d'éléments du tableau Parameter.EncoderParameter qui est le deuxième élément de la structure EncoderParameters.

Le paramètre Parameter.EncoderParameter[1] est un tableau de structures EncoderParameter. Comme le nombre d'éléments de ce tableau n'est pas connu à l'avance, il est déclaré dans la structure avec un seul élément EncoderParameter. Si le nombre d'éléments est supérieur à 1, on utilisera un code similaire à celui donné après la définition de la structure EncoderParameters.

Le paramètre Parameter.EncoderParameter[1] permet de définir les valeurs requises par l'encodeur d'image utilisées pour l'opération de sauvegarde de l'image ajoutée à la séquence. L'encodeur sera également utilisé pour sauvegarder la première page, pour chaque ajout d'une page et également pour la fermeture du fichier qui est réalisée avec la fonction GdipSaveAdd().

Voici les différentes étapes à respecter pour sauvegarder une image au format Jpeg sans compression :

1. Retrouver un identifiant CLSID pour l'encodeur voulu.
La procédure GetEncoderClsid(format.s, *Clsid.CLSID) de l'exemple permet de retrouver cet identifiant

2. Charger l'image

3. Remplir le tableau d'encoder (variable de type EncoderParameters) qui pour le cas de la sauvegarde d'une image Jpeg sans compression, n'a qu'un seul élément.
    Le premier élément de la structure EncoderParameters vaut 1 car il n'y a qu'un seul élément de type EncoderParameter.
    Le tableau EncoderParameter sera rempli comme ceci :
    L'élément Guid sera rempli avec a valeur de l'identifiant EncoderTransformation (la valeur est définie dans le fichier PB des GUID mais aussi en data pour l'exemple).
    Ce paramètre est rempli avec la commande PB CopyMemory().
    L'élément EncoderParameter\NumberOfValues est mis à 1car il indique le nombre d'éléments pointé par le membre *value de la structure qui est ici de 1.
    L'élément EncoderParameter\Type vaut #EncoderparameterValueTypeLong car le type de l'élément pointé par le membre *value de la structure est un mot de 32 bits.
    L'élément EncoderParameter\Value (pointeur) est l'adresse d'une variable de type long dont la valeur sera fixée à #EncoderValueCompressionNone (pas de compression).

4. Sauvegarde de l'image avec la fonction GdipSaveImageToStream().