|
|
|
|
|
|
|
|
|
|
- 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
TwainVersBMP (Fonction) En anglais : TwainToBMP Permet d'effectuer une des actions suivantes : - enregistrer directement le document provenant du périphérique Twain dans un fichier Bitmap (extension ".BMP").
- 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é.
- enregistrer directement en mémoire au format Bitmap (dans un buffer) le document provenant du périphérique Twain.
// Enregistre le document présent dans le scanneur dans le fichier "MaPhoto.BMP"
// Le document sera enregistré en noir et blanc
SI TwainVersBMP("C:\Temp\MaPhoto.BMP", Faux, TwainNoirBlanc) = Vrai ALORS
Info("Le document a été enregistré")
SINON
Erreur("Le document n'a pas été scanné")
FIN
// Enregistre le document présent dans le scanneur en mémoire
// Le document sera enregistré en noir et blanc
IMG_MonImage = TwainVersBMP(enMémoire, Faux, TwainNoirBlanc)
Syntaxe
Enregistrer et visualiser le document provenant du périphérique Twain dans un fichier Bitmap Masquer les détails
<Résultat> = TwainVersBMP([<Fichier BMP> [, <Interface utilisateur> [, <Type de l'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 BMP> : 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 Bitmap dans un sélecteur de fichiers. <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 BMP> sera proposé par défaut.
- Faux si l'interface utilisateur du périphérique Twain ne doit pas être affichée.
<Type de l'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 | | 1 | TwainPalette | Image à couleurs issues d'une palette. | | 2 | TwainRVB | Image RVB. | | 3 | TwainNiveauGris | Image en niveau de gris. | | 4 | TwainNoirBlanc | Image en noir et blanc. | | - | TwainToutType | Image 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'image | Valeurs 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 BMP le document provenant du périphérique Twain Masquer les détails
<Résultat> = TwainVersBMP(<EnMémoire> [, <Interface utilisateur> [, <Type de l'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 BMP.
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émoire | Sauvegarde le document provenant du périphérique Twain en mémoire. |
<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 de l'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 | | 1 | TwainPalette | Image à couleurs issues d'une palette. | | 2 | TwainRVB | Image RVB. | | 3 | TwainNiveauGris | Image en niveau de gris. | | 4 | TwainNoirBlanc | Image en noir et blanc. | | - | TwainToutType | Image 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'image | Valeurs 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 TwainVersBMP. 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 TwainVersBMP.
- 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 : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|