DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Périphériques Twain
  • Document provenant du périphérique Twain
  • Gestion du type d'image
  • Scanneur recto-verso
  • Scanneur multipages avec chargeur
  • Fonctionnement dans des applications 64 bits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet :
  • soit d'enregistrer directement le document provenant du périphérique Twain dans un fichier GIF.
  • soit de visualiser le document provenant du périphérique Twain dans l'interface utilisateur du périphérique. L'utilisateur pourra effectuer une des actions proposées par cette interface (par exemple : enregistrement du document, modification des paramètres par défaut du périphérique). Les différentes actions proposées dépendent du périphérique utilisé.
  • soit d'enregistrer directement en mémoire au format GIF (dans un buffer) le document provenant du périphérique Twain.
Exemple
// Enregistre la 1ère photographie sauvegardée dans l'appareil photographique numérique
// dans le fichier "MaPhoto.GIF"
// La photographie sera enregistrée en noir et blanc
SI TwainVersGIF("C:\Temp\MaPhoto.GIF", 256, Faux, TwainNoirBlanc) = Vrai ALORS
Info("La photographie a été enregistrée")
SINON
Erreur("La photographie n'a pas pu être enregistrée")
FIN
// Enregistre le document présent dans le scanneur en mémoire
// Le document sera enregistré en noir et blanc
IMG_MonImage = TwainVersGIF(enMémoire, Faux, TwainNoirBlanc)
Syntaxe

Enregistrer et visualiser le document provenant du périphérique Twain dans un fichier GIF Masquer les détails

<Résultat> = TwainVersGIF([<Fichier GIF> [, <Nombre de couleurs de l'image> [, <Interface utilisateur> [, <Type d'image> [, <Nombre de bits par pixel> [, <Résolution de l'image> [, <Contraste de l'image> [, <Brillance de l'image> [, <Mode recto-verso> [, <Chargement automatique>]]]]]]]]]])
<Résultat> : Booléen
  • Vrai si le document a été enregistré ou visualisé,
  • Faux si le document n'a pas été enregistré. Le message d'erreur correspondant peut être connu avec la fonction ErreurInfo.
<Fichier GIF> : Chaîne de caractères optionnelle
Nom et chemin complet (ou relatif) du fichier (260 caractères maximum). L'extension du fichier n'est pas obligatoire. Un chemin de type UNC peut être utilisé.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'utilisateur devra saisir le nom complet du fichier GIF dans un sélecteur de fichiers.
<Nombre de couleurs de l'image> : Entier optionnel
Nombre de couleurs proposées dans la palette de couleurs lors de l'utilisation du fichier GIF (valeur comprise entre 16 et 256).
Si ce paramètre n'est pas précisé, le nombre de couleurs proposées sera égal à 256.
<Interface utilisateur> : Booléen optionnel
  • Vrai (valeur par défaut) si l'interface utilisateur du périphérique Twain utilisé doit être affichée. Lors de l'enregistrement du document, le <Fichier GIF> sera proposé par défaut.
  • Faux si l'interface utilisateur du périphérique Twain ne doit pas être affichée.
<Type d'image> : Constante ou combinaison de constantes de type entier (optionnelle)
Type d'image utilisé pour enregistrer le document (classé par ordre de gestion des couleurs) :
Ordre de gestion des couleurs
0 (Valeur par défaut)Image par défaut du périphérique.
1TwainPaletteImage à couleurs issues d'une palette.
2TwainRVBImage RVB.
3TwainNiveauGrisImage en niveau de gris.
4TwainNoirBlancImage en noir et blanc.
-TwainToutTypeImage de n'importe quel type.

Si ces constantes sont combinées, le meilleur type d'image supporté par le périphérique sera sélectionné (selon l'ordre de gestion des couleurs). Pour plus de détails, consultez les remarques.
Le type d'image par défaut du périphérique sera utilisé :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si le type d'image spécifié n'est pas supporté par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Nombre de bits par pixel> : Entier optionnel
Quantité d'informations sur les couleurs (pour afficher ou imprimer chaque pixel dans une image). Plus le nombre de bits (d'informations) par pixel est important, plus la représentation des couleurs sera précise.
Les valeurs possibles de ce paramètre dépendent du type d'image utilisé :
Type de l'imageValeurs possibles
Image à couleurs issues d'une palette (constante TwainPalette).1, 4 ou 8
Image RVB (constante TwainRVB).8, 10 ou 16
Image en niveau de gris (constante TwainNiveauGris).8 ou 16
Image en noir et blanc (constante TwainNoirBlanc).1

Si ce paramètre n'est pas précisé, le nombre de bits par pixel par défaut du périphérique sera utilisé.
<Résolution de l'image> : Réel optionnel
Nombre de pixels par pouce (valeurs possibles selon le périphérique utilisé).
La résolution de l'image par défaut du périphérique sera utilisée :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si la résolution spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Contraste de l'image> : Réel optionnel
Contraste de l'image (valeur comprise entre -1000 et 1000).
Le contraste de l'image par défaut du périphérique sera utilisé :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si le contraste spécifié n'est pas supporté par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Brillance de l'image> : Réel optionnel
Brillance de l'image (valeur comprise entre -1000 et 1000).
La brillance de l'image par défaut du périphérique sera utilisée :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si la brillance spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Mode recto-verso> : Booléen optionnel
  • Vrai pour scanner un document en mode recto-verso,
  • Faux (par défaut) pour scanner le document d'un seul côté.
<Chargement automatique> : Booléen optionnel
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.

Enregistrer en mémoire au format GIF le document provenant du périphérique Twain Masquer les détails

<Résultat> = TwainVersGIF(<EnMémoire> [, <Nombre de couleurs de l'image> [, <Interface utilisateur> [, <Type d'image> [, <Nombre de bits par pixel> [, <Résolution de l'image> [, <Contraste de l'image> [, <Brillance de l'image> [, <Mode recto-verso> [, <Chargement automatique>]]]]]]]]])
<Résultat> : Buffer
Chaîne d'octets contenant le document au format GIF.
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), ...
<EnMémoire> : Constante
enMémoireSauvegarde le document provenant du périphérique Twain en mémoire.
<Nombre de couleurs de l'image> : Entier optionnel
Nombre de couleurs proposées dans la palette de couleurs lors de l'utilisation du fichier GIF (valeur comprise entre 16 et 256).
Si ce paramètre n'est pas précisé, le nombre de couleurs proposées sera égal à 256.
<Interface utilisateur> : Booléen optionnel
  • Vrai (valeur par défaut) si l'interface utilisateur du périphérique Twain utilisé doit être affichée.
  • Faux si l'interface utilisateur du périphérique Twain ne doit pas être affichée.
<Type d'image> : Constante ou combinaison de constantes de type entier (optionnelle)
Type d'image utilisé pour enregistrer le document (classé par ordre de gestion des couleurs) :
Ordre de gestion des couleurs
0 (Valeur par défaut)Image par défaut du périphérique.
1TwainPaletteImage à couleurs issues d'une palette.
2TwainRVBImage RVB.
3TwainNiveauGrisImage en niveau de gris.
4TwainNoirBlancImage en noir et blanc.
-TwainToutTypeImage de n'importe quel type.

Si ces constantes sont combinées, le meilleur type d'image supporté par le périphérique sera sélectionné (selon l'ordre de gestion des couleurs). Pour plus de détails, consultez les remarques.
Le type d'image par défaut du périphérique sera utilisé :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si le type d'image spécifié n'est pas supporté par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Nombre de bits par pixel> : Entier optionnel
Quantité d'informations sur les couleurs (pour afficher ou imprimer chaque pixel dans une image). Plus le nombre de bits (d'informations) par pixel est important, plus la représentation des couleurs sera précise.
Les valeurs possibles de ce paramètre dépendent du type d'image utilisé :
Type de l'imageValeurs possibles
Image à couleurs issues d'une palette (constante TwainPalette).1, 4 ou 8
Image RVB (constante TwainRVB).8, 10 ou 16
Image en niveau de gris (constante TwainNiveauGris).8 ou 16
Image en noir et blanc (constante TwainNoirBlanc).1

Si ce paramètre n'est pas précisé, le nombre de bits par pixel par défaut du périphérique sera utilisé.
<Résolution de l'image> : Réel optionnel
Nombre de pixels par pouce (valeurs possibles selon le périphérique utilisé).
La résolution de l'image par défaut du périphérique sera utilisée :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si la résolution spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Contraste de l'image> : Réel optionnel
Contraste de l'image (valeur comprise entre -1000 et 1000).
Le contraste de l'image par défaut du périphérique sera utilisé :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si le contraste spécifié n'est pas supporté par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Brillance de l'image> : Réel optionnel
Brillance de l'image (valeur comprise entre -1000 et 1000).
La brillance de l'image par défaut du périphérique sera utilisée :
  • si ce paramètre n'est pas précisé ou correspond à 0.
  • si la brillance spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<Mode recto-verso> : Booléen optionnel
  • Vrai pour scanner un document en mode recto-verso,
  • Faux (par défaut) pour scanner le document d'un seul côté.
<Chargement automatique> : Booléen optionnel
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Remarques

Document provenant du périphérique Twain

Le "document provenant du périphérique Twain" correspond par exemple :
  • soit au document présent dans un scanneur au moment de l'appel de la fonction TwainVersGIF. Dans ce cas, les paramètres spécifiés grâce à la fonction TwainZoneScan sont pris en compte.
  • soit à l'image retransmise par une "web caméra" au moment de l'appel de la fonction TwainVersGIF.
  • soit à la première photographie sauvegardée dans un appareil photographique numérique.
    Remarque : Si l'interface utilisateur est utilisée, le document récupéré correspondra à la photographie sélectionnée par l'utilisateur. Si plusieurs photographies sont sélectionnées, seule la première photographie sélectionnée sera récupérée.

Gestion du type d'image

Si plusieurs constantes sont combinées dans le paramètre <Type d'image>, le meilleur type d'image supporté par le périphérique sera sélectionné (selon l'ordre de gestion des couleurs).
Par exemple : Si ce paramètre correspond à TwainNoirBlanc + TwainRVB, le type de l'image sera :
  • RVB, si ce type est supporté par le périphérique.
  • noir et blanc, dans le cas contraire.

Scanneur recto-verso

Si le scanneur gère le recto-verso, il est possible de réaliser un scan recto-verso. Le document généré contient le recto et le verso du document scanné.
Remarque : Suivant le matériel utilisé, le driver Twain peut ne pas suffire pour pouvoir scanner en recto-verso. Il peut être nécessaire d'installer des drivers supplémentaires fournis par le constructeur.

Scanneur multipages avec chargeur

Si le scanneur dispose d'un chargeur et gère le multipages, il est possible de réaliser un scan de toutes les pages à la suite.
Pour avoir plus de détails sur la procédure à suivre et un exemple de scan multipages, consultez TwainEtat.

Fonctionnement dans des applications 64 bits

Dans une application 64 bits, cette fonction utilisera automatiquement le driver Twain 64 bits. Si ce driver n'est pas installé, le périphérique TWAIN ne pourra pas être manipulé.
Classification Métier / UI : Code métier
Composante : wd290std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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