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
  • 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 PDF.
  • 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 : enregistrer le document, modifier les 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 PDF (dans un buffer) le document provenant du périphérique Twain.
Exemple
// Acquisition tant qu'il y a des pages dans le chargeur
TwainVersPDF("Fichier.PDF")
// Enregistre le document présent dans le scanneur en mémoire
// Le document sera enregistré en noir et blanc
IMG_MonImage = TwainVersPDF(enMémoire, Faux, TwainNoirBlanc)
Syntaxe

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

<Résultat> = TwainVersPDF([<Fichier PDF> [, <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 PDF> : 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 PDF dans un sélecteur de fichiers.
<Interface utilisateur> : Booléen optionnel
  • Vrai si l'interface utilisateur du périphérique Twain utilisé doit être affichée. Lors de l'enregistrement du document, le <Fichier PDF> sera proposé par défaut.
  • Faux (valeur par défaut) 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 dont les couleurs sont 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. Toutes les pages contenues dans le chargeur du scanner sont scannées dans un unique fichier PDF.
Remarque : Sans chargeur, pour scanner plusieurs pages dans un unique fichier PDF, il faut scanner chaque page dans un fichier PDF puis utiliser la fonction PDFFusionne.

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

<Résultat> = TwainVersPDF(<EnMémoire> [, <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 PDF.
Cette chaîne d'octets peut être par la suite affectée à un champ Image, enregistrée dans un fichier (fonction fSauveBuffer), 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.
<Interface utilisateur> : Booléen optionnel
  • Vrai si l'interface utilisateur du périphérique Twain utilisé doit être affichée.
  • Faux (valeur par défaut) 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 dont les couleurs sont 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. Toutes les pages contenues dans le chargeur du scanner sont scannées dans un unique fichier PDF.
Remarque : Sans chargeur, pour scanner plusieurs pages dans un unique fichier PDF, il faut scanner chaque page dans un fichier PDF puis utiliser la fonction PDFFusionne.
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 TwainVersPDF. 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 TwainVersPDF.
  • 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.

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 : wd300std.dll
Version minimum requise
  • Version 19
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