Scroll to navigation

scanimage(1) SANE Scanner Access Now Easy scanimage(1)

NOM

scanimage – Numériser une image

SYNOPSIS

scanimage [-d périphérique] [--format=format_sortie] [-i profil] [-L] [-f format_périphérique] [-b [format]] [--batch-start=début] [--batch-count=compte] [--batch-increment=incrément] [--batch-double] [--accept-md5-only] [-p] [-o chemin] [-n] [-T] [-A] [-h] [-v] [-B taille] [-V] [options_spécifiques_périphérique]

DESCRIPTION

scanimage est une interface en ligne de commande pour contrôler les appareils d’acquisition d’image tels que les numériseurs à plat ou les appareils photographiques. L’appareil est contrôlé à l’aide d’options de ligne de commande. Après le traitement de la ligne de commande, scanimage s’exécute normalement pour acquérir l’image. Les données de l’image sont écrites sur la sortie standard dans un des formats PNM (portable aNyMaP) (PBM pour les images en noir et blanc, PGM pour les images en niveaux de gris et PPM pour les images en couleurs), ou dans les formats TIFF (noir et blanc, nuances de gris ou couleurs), PNG ou JPEG (niveau de compression 75). scanimage accède aux appareils d’acquisition d’image à l’aide de l’interface SANE (Scanner Access Now Easy), et peut par conséquent prendre en charge tout appareil pour lequel existe un dorsal SANE (essayer apropos sane- pour obtenir une liste des dorsaux disponibles).

EXEMPLES

Pour obtenir une liste de périphériques :


scanimage -L

Pour numériser avec les réglages par défaut dans le fichier image.pnm :


scanimage >image.pnm

Pour numériser 100x100 mm dans le fichier image.tiff (-x et -y peuvent ne pas être disponibles pour tous les appareils) :


scanimage -x 100 -y 100 --format=tiff >image.tiff

Pour afficher toutes les options disponibles :


scanimage -h

OPTIONS

Il existe deux ensembles d’options pour utiliser scanimage.

Les options fournies par scanimage lui-même sont listées ci-après. En plus, chaque dorsal propose son propre ensemble d’options, lesquelles peuvent aussi être spécifiées. Notez que les options fournies par le dorsal peuvent varier selon le numériseur choisi.

Souvent les options qui sont similaires de par leurs fonctions sont mises en œuvre différemment selon les dorsaux. Un exemple de cette différence est --mode Gray et --mode Grayscale. Cela peut être dû aux préférences des auteurs de dorsal. D’autres fois, les options sont définies par le numériseur lui-même et, par conséquent, sont hors de contrôle du code du dorsal.

Les paramètres sont séparés par un blanc des options monocaractères (par exemple, -d epson) et par un « = » pour les options multicaractères (par exemple, --device-name=epson).

Cette option spécifie le périphérique à accéder et doit être suivie d’un nom de périphérique de SANE tel que « epson:/dev/sg0 » ou « hp:/dev/usbscanner0 ». Une liste (partielle) de périphériques disponibles peut être obtenue avec l’option --list-devices (voir ci-après). Si aucun nom de périphérique n’est spécifié explicitement, scanimage lit un nom de périphérique dans la variable d’environnement SANE_DEFAULT_DEVICE. Si celle-ci n’est pas définie, scanimage essaie d’ouvrir le premier périphérique disponible.

Cette option détermine la manière dont les données d’image seront écrites sur la sortie standard ou dans le fichier spécifié par l’option --output-file. format_sortie peut être pnm, tiff, png ou jpeg. Si l’option --format n’est pas spécifiée, le format pnm est utilisé par défaut.

Cette option est utilisée pour inclure un profil ICC dans un fichier TIFF.

Cette option permet d’afficher une liste (partielle) de périphériques disponibles. Cette liste peut ne pas être complète puisque certains périphériques, bien que disponibles, ne sont listés dans aucun fichier de configuration (ceux-ci sont classiquement enregistrés dans le répertoire /etc/sane.d). Cela est particulièrement le cas lorsque l’accès aux numériseurs se fait à travers le réseau. Si un périphérique n’est listé dans aucun fichier de configuration, la seule façon d’y accéder consiste à utiliser son nom de périphérique complet. L’administrateur système peut être consulté pour récupérer le nom de tels périphériques.

Cette option fonctionne de manière similaire à l’option --list-devices, mais requiert une chaine de format. scanimage remplace respectivement les paramètres fictifs %d %v %m %t %i %n avec le nom du périphérique, le nom du fabricant, le nom de modèle, le type de numériseur, un numéro d’indice et une nouvelle ligne. La commande

scanimage -f ' numériseur numéro %i périphérique %d est un %t, modèle %m, produit par %v %n'

produira quelque chose comme ceci :

numériseur numéro 0 périphérique epson2:libusb:001:005 est un flatbed scanner, modèle Perfection1200, produit par Epson

Les options --batch* fournissent des fonctionnalités pour la numérisation de document si un chargeur automatique de documents est utilisé.

Cette option permet de spécifier le format du nom du fichier où chaque page sera écrite. Chaque page est écrite dans un seul fichier. Si l’option format n’est pas indiquée, ce sera out%d.pnm par défaut (ou out%d.tif pour --format tiff, out%d.png pour --format png ou out%d.jpg pour --format jpeg). Cette option est incompatible avec l’option --output-path. format est donné par une chaine de style printf(1) avec un entier comme paramètre.

Cette option choisit le numéro de début pour le nommage des fichiers. Si cette option n’est pas fournie, le numérotage commencera à 1.

Cette option spécifie le nombre de pages à numériser. Si elle n’est pas indiquée, scanimage continuera à numériser jusqu’à ce que le numériseur renvoie un état autre que OK. Tous les numériseurs avec chargeur automatique ne signalent pas quand celui-ci est vide. Cette option permet de contourner ce problème.

Cette option définit l’incrémentation du numéro dans le nom de fichier. Elle est utilisée généralement lors de la numérisation des deux côtés d’un document avec un chargeur automatique simple côté de document. L’option --batch-double est une commande spécifique pour cela.

Cette option définit automatiquement l’incrément à 2. Elle est équivalente à --batch-increment=2.

Cette option demande de presser la touche Entrée avant de numériser une page. Elle peut être utilisée pour numériser plusieurs pages sans l’aide d’un chargeur automatique de document.

Accepter uniquement les requêtes d’autorisation qui gèrent la fonction de sécurité MD5. Le démon réseau saned(8) de SANE peut faire de telles requêtes.

Cette option fait que scanimage affiche un indicateur de progression. Ce dernier affiche le pourcentage de données de l’image actuelle déjà reçu.

Cette option fait que scanimage enregistre la numérisation de sortie dans le chemin indiqué. Cette option est incompatible avec l’option --batch. Le programme essaiera de deviner le format_sortie à partir du nom de fichier. En cas d’impossibilité, il affiche un message d’erreur et quitte.

Cette option fait que scanimage établisse seulement les options demandées par l’utilisateur, mais ne réalise pas réellement la numérisation. Cette option peut être utilisée, par exemple, pour éteindre la lampe du numériseur (si cette action est gérée par le dorsal).

Cette option fait que scanimage réalise quelques tests simple de cohérence pour être sûr que le dorsal fonctionne comme défini dans l’API de SANE. En particulier, la fonction sane_read() est mise en pratique par ce test.

Cette option fait que scanimage liste toutes les options disponibles exposées par le dorsal, incluant les options de bouton. L’information est affichée sur la sortie standard et aucune numérisation n’est réalisée.

Cette option affiche l’aide. L’information est affichée sur la sortie standard et aucune numérisation n’est réalisée.

Cette option augmente la prolixité de la sortie de scanimage. Cette option peut être spécifiée à plusieurs reprises, augmentant d’autant le degré de prolixité.

Cette option change la taille du tampon d’entrée de 1 Mo (valeur par défaut) à taille Ko.

Cette option fait que scanimage affiche le nom du programme et du paquet, le numéro de version de la distribution de SANE utilisée et la version du dorsal chargé. Si davantage d’informations à partir des numéros de version de dorsal est nécessaire, la variable DEBUG de la couche dll peut être utilisée. Exemple : SANE_DEBUG_DLL=3 scanimage -L.

Comme on peut l’imaginer, une grande partie de la puissance de scanimage provient du fait qu’il peut contrôler n’importe quel dorsal de SANE. Par conséquent, l’ensemble exact des options de ligne de commande dépend des possibilités du périphérique choisi. Pour connaitre les options d’un appareil appelé périphérique, invoquez scanimage à l’aide d’une ligne de commande de la forme :

scanimage --help --device-name périphérique

La documentation des options spécifiques à l’appareil affichée avec l’option --help est mieux expliquée avec quelques exemples :

-l 0..218mm [0]

Position x en haut et à gauche de l’aire numérisée.

La description ci-dessus indique que l’option -l attend une valeur d’option dans l’intervalle 0 à 218 mm. La valeur entre crochets indique que la valeur de l’option actuelle est 0 mm. La plupart des dorsaux fournissent des options de géométrie similaires pour la position en haut et à gauche (-t), la largeur (-x) et la hauteur de l’aire de numérisation (-y).

--brightness -100..100% [0]

Contrôle de la luminosité de l’image obtenue.

La description ci-dessus indique que l’option --brightness attend une valeur d’option dans l’intervalle -100 à 100 pour cent. La valeur entre crochets indique que la valeur de l’option actuelle est 0 pour cent.

--default-enhancements

Ensemble des valeurs par défaut pour les contrôles d’amélioration.

La description ci-dessus indique que l’option --default-enhancements n’a pas de valeurs d’option. Elle doit être pensée comme ayant un effet immédiat au point de la ligne de commande à laquelle elle apparaît. Par exemple, puisque cette option réinitialise l’option --brightness, la paire d’options --brightness 50 --default-enhancements n’aura aucune action.

--mode Lineart|Gray|Color [Gray]

Sélection du mode le numérisation (par exemple, trait ou couleur)

La description ci-dessus indique que l’option --mode accepte un argument qui doit être une des chaines Lineart, Gray ou Color. La valeur entre crochets indique que l’option est actuellement définie à Gray. Pour des raisons pratiques, il est autorisé d’abréger les valeurs des chaines à condition qu’elles restent uniques. En outre, l’appellation est insensible à la casse. Par exemple, les définitions --mode col et --mode Color sont identiques.

--custom-gamma[=(yes|no)] [inactive]

Détermination de l’utilisation d’une table gamma, interne ou personnalisée.

La description ci-dessus indique que l’option --custom-gamma attend soit aucune valeur, soit une chaine « yes », soit une chaine « no ». Spécifier cette option sans aucune valeur équivaut à spécifier « yes ». La valeur entre crochets indique que cette option n’est pas active actuellement, c’est-à-dire qu’essayer de définir cette option aboutira à un message d’erreur. L’ensemble des options disponibles dépend typiquement des réglages des autres options. Par exemple, la table --custom-gamma ne peut être active que si les modes de numérisation niveaux de gris ou couleur ont été demandés.

L’option --help est traitée après toutes les autres options. Il est donc possible de connaitre les réglages d’option pour un mode particulier en spécifiant les options de mode avec l’option --help. Par exemple, la ligne de commande :

scanimage --help --mode color

affiche le réglage des options actives quand le mode couleur est sélectionné.

--gamma-table 0..255,...

Table de corrections de gamma. Dans le mode couleur, cette option affecte de la même manière les canaux rouge, vert et bleu simultanément (c’est-à-dire c’est une table d’intensités de gamma).

La description ci-dessus indique que l’option --gamma-table attend zéro ou plusieurs valeurs dans l’intervalle 0 à 255. Par exemple, une valeur valable pour cette option peut être « 3,4,5,6,7,8,9,10,11,12 ». Puisqu’il est laborieux de spécifier des séquences longues de cette forme, ces dernières peuvent être abrégées sous la forme « [0]3-[9]12 ». Cela signifie que le premier élément est défini à 3, le neuvième élément à 12 et les valeurs intermédiaires sont interpolées de manière linéaire. Bien sûr, il est possible de spécifier plusieurs segments linéaires de ce type. Par exemple, « [0]3-[2]3-[6]7,[7]10-[9]6 » est équivalent à « 3,3,3,4,5,6,7,10,8,6 ». Le programme gamma4scanimage peut être utilisé pour générer de telles tables gamma (voir gamma4scanimage(1) pour plus de détails).

--filename <chaine> [/tmp/input.ppm]

Le nom de fichier de l’image à charger.

La description ci-dessus est un exemple d’option prenant une valeur arbitraire de chaine (qui s’avère être un nom de fichier). De nouveau, la valeur entre crochets indique que la valeur de l’option est actuellement définie au nom de fichier /tmp/input.ppm.

ENVIRONNEMENT

Le nom de périphérique par défaut.

FICHIERS

/etc/sane.d
Le répertoire contenant divers fichiers de configuration. Pour plus de détails, consultez les pages de manuel listées ci-dessous.
~/.sane/pass
Ce fichier contient des lignes de la forme :

utilisateur:mot_de_passe:ressource

scanimage utilise cette information pour répondre automatiquement aux requêtes d’autorisation d’utilisateur. Ce fichier doit avoir la permission 0600 ou une plus stricte. Ce fichier doit être utilisé en concomitance avec l’option --accept-md5-only pour éviter des attaques du côté serveur. Cette ressource peut contenir n’importe quel caractère dans la limite de 127 caractères.

VOIR AUSSI

sane(7), gamma4scanimage(1), xscanimage(1), xcam(1), xsane(1), scanadf(1), sane-dll(5), sane-net(5), sane-"nom_dorsal"(5)

AUTEUR

David Mosberger, Andreas Beck, Gordon Matzigkeit, Caskey Dickson, et beaucoup d’autres. Pour des questions ou des commentaires, contactez la liste de diffusion sane-devel (voir http://www.sane-project.org/mailing-lists.html).

BOGUES

Pour les options de séquences de l’option --gamma-table, l’aide affichée n’indique pas le nombre d’éléments pouvant être utilisés.

TRADUCTION

La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.

10 juillet 2008