<Image>.SauveBMP (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (historique)

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de dessin

Image présente dans un champ Web Caméra
Dessin en code navigateur
Dessin en PHP

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

<Image>.SauveBMP (Fonction)

En anglais : <Image>.SaveBMP

Sauve une image :

soit dans un fichier au format BMP.
soit en mémoire.

Cette image correspond à l'image contenue dans un champ Image.

Remarques :

Seule la partie visible du champ Image est sauvegardée.
Cette fonction permet uniquement de sauvegarder des images pour des résolutions d'écran allant jusqu'à 32 bits.
Cette fonction ne peut pas être utilisée avec les champs Image présents dans les états.

Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Dessiner en WINDEV, WEBDEV et WINDEV Mobile.

En code navigateur, cette fonction permet uniquement de sauvegarder une image en mémoire.

Exemple

// Sauve en mémoire l'image présente dans "IMG_ImageDessin"
ResSauvegarde = IMG_ImageDessin.SauveBMP(enMémoire)

// Sauve l'image présente dans "IMG_ImageDessin" sur "C:\Documents\Image.BMP"
ResSauvegarde = IMG_ImageDessin.SauveBMP("C:\Documents\Image.BMP")

Syntaxe

Sauvegarder une image dans un fichier au format BMP Masquer les détails

<Résultat> = <Champ Image>.SauveBMP(<Nom du fichier> [, <Nombre de couleurs>])

<Résultat> : Booléen

Vrai si l'image a été sauvegardée,
Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.

<Champ Image> : Nom de champ

Nom du champ Image à manipuler.

<Nom du fichier> : Chaîne de caractères

Nom et chemin complet (ou relatif) du fichier BMP à créer. Un chemin de type UNC peut être utilisé. L'extension du fichier n'est pas obligatoire.
Attention :
Pour que l'image soit sauvée, le répertoire de destination doit exister.
L'existence du fichier BMP n'est pas vérifiée. Si ce fichier existe, il est automatiquement écrasé.

<Nombre de couleurs> : Entier optionnel

Nombre de couleurs de l'image sauvegardée :
0 (par défaut) : nombre de couleurs défini dans la résolution d'écran
16 : 16 couleurs
Ce paramètre correspond au nombre de couleurs proposées dans la palette de couleurs lors de l'utilisation du fichier BMP.

Sauvegarder une image en mémoire Masquer les détails

<Résultat> = <Champ Image>.SauveBMP(<enMémoire> [, <Nombre de couleurs>])

<Résultat> : Buffer

Chaîne d'octets contenant l'image au format BMP. Cette chaîne d'octets peut être par la suite affectée à un champ Image, enregistrée dans un fichier (fonction fSauveTexte), envoyée à travers un réseau (grâce aux fonctions Socket), ...
Cette chaîne d'octets peut uniquement être affectée à une autre image en code navigateur (l'option "Localiser l'image dans répertoire _WEB en code navigateur" doit être décochée). Elle ne peut pas être sauvée dans un fichier pour construire un fichier image.

<Champ Image> : Nom de champ

Nom du champ Image à manipuler.

<enMémoire> : Constante

enMémoire : Constante permettant de sauvegarder une image en mémoire.

<Nombre de couleurs> : Entier optionnel

Nombre de couleurs de l'image sauvegardée :
0 (par défaut) : nombre de couleurs défini dans la résolution d'écran.
16 : 16 couleurs.
Ce paramètre correspond au nombre de couleurs proposées dans la palette de couleurs lors de l'utilisation du fichier BMP.

Remarques

Image présente dans un champ Web Caméra

Seule l'image affichée au moment de l'exécution de la fonction <Image>.SauveBMP est sauvegardée. Pour sauvegarder cette image, il est également possible d'utiliser :

la fonction <Caméra>.Capture : l'image sera sauvegardée au format BMP
la fonction <Image>.SauveGIF : l'image sera sauvegardée soit au format Gif, soit en mémoire
la fonction <Image>.SauveJPEG : l'image sera sauvegardée soit au format Jpeg, soit en mémoire
la fonction <Image>.SauvePNG : l'image sera sauvegardée soit au format PNG, soit en mémoire

Dessin en code navigateur

Il est possible d'affecter directement l'image sauvegardée en mémoire à un champ Image. Selon le navigateur utilisé, le résultat peut ne pas être celui attendu.

Par exemple, avec la version actuelle de FireFox (disponible au moment de la rédaction de cette documentation), les images au format BMP ne sont pas correctement affichées.

Ce fonctionnement peut s'améliorer lors des prochaines mises à jour de ce navigateur.

Dessin en PHP

En PHP, les fonctions de dessin s'appuient sur la librairie graphique GD. Cette librairie est très courante chez les hébergeurs PHP, et donc toujours activée. La version de la librairie GD devra être au moins 2.0.28. Cette librairie peut être téléchargée sur le site de PHP.

Pour activer si nécessaire cette librairie en local, les éléments nécessaires sont :

PHP installé.
le fichier PHP.INI présent dans le répertoire Windows doit avoir la ligne "extension=php_gd2.dll" et non pas ";extension=php_gd2.dll".
le fichier php_gd2.dll doit exister dans le répertoire des extensions PHP. Ce répertoire est défini dans le fichier PHP.INI par la variable "extension_dir".

Composante : wd300pnt.dll

Voir Aussi

Version minimum requise

Version 24

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/09/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale