4D Doc Center : ECRIRE FICHIER IMAGE

4D v14.3

ECRIRE FICHIER IMAGE


ECRIRE FICHIER IMAGE ( nomFichier ; image {; codec} )

Paramètre	Type	Description
nomFichier	Alpha	Nom ou chemin d’accès complet du fichier à écrire, ou chaîne vide
image	Image	Champ ou variable image à écrire
codec	Chaîne	Identifiant de codec d'image

Description

La commande ECRIRE FICHIER IMAGE vous permet de sauvegarder dans un fichier sur disque l’image passée dans le paramètre image, au format défini par codec.

Vous pouvez passer dans nomFichier le chemin d’accès complet du fichier à créer, ou uniquement le nom du fichier — auquel cas le fichier sera créé à côté du fichier de structure de la base. Vous devez également passer l’extension du fichier à créer.
Si vous passez une chaîne vide ("") dans nomFichier, la boîte de dialogue standard d’enregistrement de fichier apparaît, permettant à l’utilisateur de désigner le nom, l’emplacement et le format du fichier à créer. Si un nom par défaut a été associé au champ image, il est proposé dans la boîte de dialogue (cf. commande FIXER NOM FICHIER IMAGE).

Passez dans image la variable ou le champ image contenant l’image à stocker sur le disque.

Le paramètre optionnel codec vous permet de définir le format dans lequel l’image doit être sauvegardée. Un codec peut être une extension (par exemple “.gif”) ou un type Mime (par exemple “image/jpg”). Vous pouvez obtenir la liste des codecs disponibles via la commande LISTE CODECS IMAGES.

Si vous omettez le paramètre codec, la commande tentera de déterminer le codec sur la base de l’extension du nom de fichier passé dans le paramètre nomFichier. Par exemple, si vous passez l’instruction :

ECRIRE FICHIER IMAGE("c:\dossier\photo.jpg";maphoto)

... la commande utilisera le codec JPEG pour stocker l’image.
Si l’extension utilisée ne correspond à aucun codec disponible, le fichier n’est pas enregistré et la variable système OK prend la valeur 0. Si vous ne passez ni codec ni extension de fichier, le fichier image est enregistré au format PICT.

Note : Si le format d'écriture de l'image (indiqué via l'extension de nomFichier ou le paramètre codec) est égal à son type d'origine et si aucune opération de transformation ne lui a été appliquée, l'image est écrite telle quelle, sans aucune modification.

Si l’exécution de la commande est correcte, la variable système Document contient le chemin d’accès complet du fichier créé et la variable système OK prend la valeur 1. En cas d’échec, OK prend la valeur 0.