|
|
|
|
|
- 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
TwainVersJPEG (Fonction) En anglais : TwainToJPEG 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é.
- soit d'enregistrer directement en mémoire au format JPEG (dans un buffer) le document provenant du périphérique Twain.
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
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. | 1 | TwainPalette | Image dont les couleurs sont 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.
<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émoire | Sauvegarde 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. | 1 | TwainPalette | Image dont les couleurs sont 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 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 : wd300std.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|