Documentation VISION (VAPI) : Configuration Interface

		Documentation VISION (VAPI)		Dernière mise à jour : 02/12/20
Télécharger la doc		IMAGE INTERFACE

Summary
Préfixe de l'interface	Im
Nombre de fonctions	7
Description	Ensemble de fonctions permettant de manipuler des images

Prototype	long cdecl ImGetInf(char* filename, void* ldv_img)
Paramètres	filename: nom du fichier ldv_img: pointeur sur une structure de type LDV_IMAGE
Retour	LDV_STATUS
Description	Récupère les informations image dans le fichier et remplit la structure LDV_IMAGE en conséquence, ne charge pas l'image (fonction suivante) mais renseigne ses caractéristiques comme sa largeur, hauteur, nombre de plans...
Remarques	Appeler ImFree pour libérer les resources associées
Version VAPI	1.09 ou supérieure

Prototype	long cdecl ImLoad(void* ldv_img)
Paramètres	ldv_img: structure remplie précédemment par ImGetInf
Retour	LDV_STATUS
Description	Charge en mémoire l'image depuis le fichier
Remarques	La lecture des données image est effectuée lors de cet appel..
Version VAPI	1.09 ou supérieure

Prototype	void cdecl ImFree(void* ldv_img)
Paramètres	ldv_img: structure remplie précédemment par ImGetInf
Retour	Aucun
Description	Libère les resources allouées par ImGetInf et ImLoad
Remarques	.
Version VAPI	1.09 ou supérieure

Prototype	long cdecl ImSave(char* filename, void* ldv_img, char* save_options) ;
Paramètres	filename: nom du fichier de sauvegarde ldv_img: structure LDV_IMAGE définissant l'image à sauvegarder save_options: options standard, séparées par ';', pour la sauvegarde (option=<valeur>): fmt = <extension du fichier en 3 lettres> quality=<qualite 0...100> (JPEG) flipflop=<0 ou 2> (0: pas d'inversion, 2: inversion Y) (TGA) compression=<none or lzw> (TIF) byteorder=<motorola ou intel> (TIF)
Retour	LDV_STATUS
Description	Sauvegarde une image en mémoire vers un fichier
Remarques	Exemple d'appel: status = Vapi->ImSave( "h:\\test.tif", ldv_img, "fmt=TIF;compression=LZW;byteorder=motorola" ) ; Certaines options sont relatives au format, elles seront simplement ignorées par le driver de sauvergarde. Voyez le script opnsav.vcs pour un exemple de ces options
Version VAPI	1.09 ou supérieure

Prototype	long cdecl ImDither(long method, long param, void* ldv_img_in, void* ldv_img_out)
Paramètres	method: méthode à utiliser pour le tramage: 0: Automatique, laisser VISION décider 1: matrice monochrome 2: niveaux de gris 3: 216 couleurs 4: bichromie ldv_img_in: structure généralement fournie par VISION ldv_img_out: structure LDV_IMAGE contenant l'image tramée
Retour	LDV_STATUS
Description	Demande à VISION de tramer l'image source selon la méthode choisie. Le nombre de plans en sortie doit être précisé avant l'appel par la variable out->Raster.fd_nplanes (1,4,8,16 ou32)
Remarques
Version VAPI	1.09 ou supérieure

Prototype	long cdecl ImGetStdData(void* ldv_img, char* query, char* out_data, long out_data_size) ;
Paramètres	ldv_img: structure remplie précédemment par ImGetInf query: chaine de caractères standard pour demander la valeur d'un des attributs suivants: filename: nom du fichier chargé par ImGetInf out_data: chaine contenant la valeur de l'attribut demandé out_data_size: taille du buffer passé en paramètre
Retour	LDV_STATUS
Description	Récupère des données 'standard' sur l'image
Remarques	Voyez l'exemple optimg.ldv
Version VAPI	1.09 ou supérieure

Prototype	long cdecl ImComputeHistogram(void* ldv_img, HISTO *histo) ;
Paramètres	ldv_img: structure LDV_IMAGE définissant l'image sur laquelle calculer les histogrammes histo: pointeur sur la structure de type HISTO contenant le résultat du calcul
Retour	LDV_STATUS
Description	Demande à VISION de calculer les histogrammes sur une image
Remarques	.histo->norm doit être initialisé pour indiquer à VISION quelle est la valeur maximale pour la plus haute fréquence de répétition Voyez l'exemple optimg.ldv
Version VAPI	1.09 ou supérieure

		Documentation VISION (VAPI)
Télécharger la doc		IMAGE INTERFACE