# 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 |