PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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 WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Permet :
  • soit d'enregistrer directement le document provenant du périphérique Twain dans un fichier JPEG.
  • 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é.
  • Versions 24 et supérieures
    soit d'enregistrer directement en mémoire au format JPEG (dans un buffer) le document provenant du périphérique Twain.
    Nouveauté 24
    soit d'enregistrer directement en mémoire au format JPEG (dans un buffer) le document provenant du périphérique Twain.
    soit d'enregistrer directement en mémoire au format JPEG (dans un buffer) le document provenant du périphérique Twain.
Exemple
// Enregistre le document présent dans le scanneur dans le fichier "MaPhoto.JPEG"
// Le document sera enregistré en noir et blanc
SI TwainVersJPEG("C:\Temp\MaPhoto.JPEG", 0, Faux, TwainNoirBlanc) = Vrai ALORS
Info("Le document a été enregistré")
SINON
Erreur("Le document n'a pas été scanné")
FIN
Versions 24 et supérieures
// Enregistre le document présent dans le scanneur en mémoire
// Le document sera enregistré en noir et blanc
IMG_MonImage = TwainVersJPEG(enMémoire, Faux, TwainNoirBlanc)
Nouveauté 24
// Enregistre le document présent dans le scanneur en mémoire
// Le document sera enregistré en noir et blanc
IMG_MonImage = TwainVersJPEG(enMémoire, Faux, TwainNoirBlanc)
// Enregistre le document présent dans le scanneur en mémoire
// Le document sera enregistré en noir et blanc
IMG_MonImage = TwainVersJPEG(enMémoire, Faux, TwainNoirBlanc)
Syntaxe
<Résultat> = TwainVersJPEG([<Fichier JPEG> [, <Qualité 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 pu être ni enregistré ni visualisé.
<Fichier JPEG> : 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 JPEG dans un sélecteur de fichiers.
<Qualité de l'image> : Entier optionnel
Qualité de l'image du document (valeur comprise entre 1 et 100). Plus la qualité de l'image sera faible, plus le taux de compression de l'image sera élevé et plus la taille du fichier sera petite.
La qualité 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 qualité spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<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 JPEG> 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 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
Versions 15 et supérieures
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Nouveauté 15
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Versions 24 et supérieures
<Résultat> = TwainVersJPEG(<EnMémoire> [, <Qualité 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 JPEG.
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.
<Qualité de l'image> : Entier optionnel
Qualité de l'image du document (valeur comprise entre 1 et 100). Plus la qualité de l'image sera faible, plus le taux de compression de l'image sera élevé et plus la taille du fichier sera petite.
La qualité 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 qualité spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<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 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
Versions 15 et supérieures
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Nouveauté 15
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Nouveauté 24
<Résultat> = TwainVersJPEG(<EnMémoire> [, <Qualité 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 JPEG.
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.
<Qualité de l'image> : Entier optionnel
Qualité de l'image du document (valeur comprise entre 1 et 100). Plus la qualité de l'image sera faible, plus le taux de compression de l'image sera élevé et plus la taille du fichier sera petite.
La qualité 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 qualité spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<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 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
Versions 15 et supérieures
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Nouveauté 15
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
<Résultat> = TwainVersJPEG(<EnMémoire> [, <Qualité 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 JPEG.
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.
<Qualité de l'image> : Entier optionnel
Qualité de l'image du document (valeur comprise entre 1 et 100). Plus la qualité de l'image sera faible, plus le taux de compression de l'image sera élevé et plus la taille du fichier sera petite.
La qualité 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 qualité spécifiée n'est pas supportée par le périphérique.
  • si le paramètre <Interface utilisateur> vaut Vrai.
<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 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
Versions 15 et supérieures
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
Nouveauté 15
  • Vrai pour charger automatiquement les pages dans le périphérique,
  • Faux dans le cas contraire.
  • 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 TwainVersJPEG. 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 TwainVersJPEG.
  • 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 : wd250std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire