sane − Scanner Access Now Easy : API pour accéder aux scanners

SANE est une interface de programmation d’application (API) qui fournit un accès standardisé à n’importe quel matériel de numérisation d’images. Cette interface standard permet de n’écrire qu’un pilote par scanner au lieu d’un par scanner et par application.

Bien que SANE soit principalement destiné à un environnement Unix, le standard a été soigneusement conçu pour qu’il soit possible d’implémenter l’API sur virtuellement tout matériel ou système d’exploitation.

Cette page de manuel résume les informations disponibles sur SANE.

Une application qui utilise l’interface SANE est appelé un frontend SANE . Un pilote qui implémente l’interface SANE est appelé un backend SANE. Un meta backend fournit des moyens pour gérer un ou plusieurs backends.

Le standard SANE définit une interface de programmation d’application (API) qui est utilisée pour faire communiquer les frontends et les backends. Il est décrit dans /usr/doc/sane-1.0.7/sane.ps (si LaTeX est installé sur votre système) et sur le site internet de SANE : http://www.mostang.com/sane/html/ (HTML), ou http://www.mostang.com/sane/sane.ps (Postscript).

Il y a davantage d’information pour les développeurs dans /usr/doc/sane-1.0.7/backend-writing.txt. Certaines routines internes de SANE (sanei) sont documentées en utilisant doxygen : http://sanei.meier-geinitz.de/ . Avant de commencer un nouveau projet de backend ou de frontend, regardez /usr/doc/sane-1.0.7/PROJECTS pour avoir la liste des projets prévus ou qui n’ont pas encore été inclus dans la distribution SANE.

Votre aide est toujours appréciée. Regardez /usr/doc/sane-1.0.7/TODO pour connaître les choses qui devraient être faites. On a besoin non seulement de développeurs, mais aussi de personnes pour relire, corriger la documentation et rapporter les bogues. De plus on a besoin de traduction pour les options des backends. Prenez contact sur la liste de diffusion de SANE pour les détails.

Le paquetage sane-backends contient beaucoup de backends, documentations (y compris le standard SANE ), le support réseau, et le frontend en ligne de commande « scanimage ». Les frontends « xscanimage », « xcam », and « scanadf » sont aussi présents dans le paquetage sane-frontends. Les deux paquetages peuvent être téléchargés depuis la page internet de SANE (http://www.mostang.com/sane/). Vous pouvez obtenir des informations au sujet des autres frontends et backends sur la page (http://www.mostang.com/sane/frontends.html).

Les sections suivantes fournissent de brèves descriptions et des liens vers d’autres informations sur plusieurs aspects de SANE. Un nom avec un nombre entre parenthèses (par ex. ‘sane-dll(5)’) fait référence à une page de manuel, dans ce cas à « man 5 sane-dll » . Des entrées comme « /usr/doc/sane-1.0.7/sane.tex » font références à des fichiers textes qui sont copiés dans le répertoire de documentation de SANE (/usr/doc/sane-1.0.7) au moment de l’installation. Toutes les autres références sont des adresses de pages internet.

Page internet de SANE

Des informations sur tous les aspects de SANE, y compris un tutorial et un lien vers la FAQ de SANE peuvent être trouvées sur la page internet de SANE : http://www.mostang.com/sane/.

Liste de diffusion de SANE

Il y a une liste de diffusion par courriel destinée aux discussions sur le standard SANE et ses implémentations : sane-devel. Puisqu’actuellement c’est la seule liste de diffusion dédiée à SANE, il est permis d’y poser des questions qui ne sont pas strictement en relation avec le développement de SANE. Pour s’inscrire ou se désinscrire, voyez : http://www.mostang.com/sane/mail.html

Compiler et installer SANE

Lisez /usr/doc/sane-1.0.7/README et les fichiers README relatifs aux différents systèmes d’exploitation pour obtenir des informations sur la compilation et l’installation de SANE.

Configuration SCSI

Pour les informations à propos des divers systèmes et contrôleurs SCSI, voyez sane-scsi(5).

Configuration USB

Pour les informations à propos de la configuration USB, voyez sane-usb(5).

scanimage

Frontend en ligne de commande. Voyez scanimage(1).

saned

Démon réseau de SANE qui permet à des clients distants d’accéder aux périphériques d’acquisition disponibles sur l’hôte local. Voyez saned(1).

sane-find-scanner

sane-find-scanner est un outil en ligne de commande pour trouver les scanners SCSI et certains USB et déterminer leurs fichiers de périphériques UNIX associés. Voyez sane-find-scanner(1).

Regardez aussi le paquetage sane-frontends (qui comprend xscanimage, xcam, et scanadf) et la page d’information des frontends sur http://www.mostang.com/sane/sane-frontends.html.

abaton

Le backend SANE pour les scanners Abaton supporte le Scan 300/GS (8bit, 256 niveaux de gris) et le Scan 300/S (noir et blanc, non testé). Voyez sane-abaton(5) pour les détails.

agfafocus

Ce backend supporte les scanners AGFA Focus et le Siemens S9036 (non testé). Voyez sane-agfafocus(5) pour les détails.

apple

Le backend SANE pour les scanners Apple supporte les scanners suivants : AppleScanner, OneScanner et ColorOneScanner. Voyez sane-apple(5) pour les détails.

artec

Le backend SANE Artec supporte plusieurs scanners Artex/Ultima SCSI comme le BlackWidow BW4800SP et le Plustek 19200S. Voyez sane-artec(5) pour les détails.

as6e

C’est le backend SANE pour le scanner sur port parallèle Artec AS6E. Voyez sane-as6e(5) pour les détails.

avision

Ce backend supporte les scanners Avision AV 630 CS. Voyez sane-avision(5) pour les détails.

bh

Le backend bh supporte les scanners de documents de la série Bell+Howell Copiscan II. Voyez sane-bh(5) pour les détails.

canon

Le backend canon supporte les scanners SCSI CanoScan 300, CanoScan 600, et CanoScan 2700F. Voyez sane-canon(5) pour les détails.

coolscan

C’est le backend SANE pour le scanner de diapositives Nikon Coolscan. Voyez sane-coolscan(5) pour les détails.

epson

Le backend epson supporte les scanners Epson SCSI, port parallèle et USB. Voyez sane-epson(5) pour les détails.

hp

Le backend hp supporte les scanners HP ScanJet et les périphériques multi-fonctions OfficeJet (MFPs) qui supportent SCL (Scanner Control Language de HP). Voyez sane-hp(5) pour les détails.

m3096g

Ce backend supporte le scanner Fujitsu M3096Gm. Voyez sane-fujitsu(5) pour les détails.

microtek

Le backend microtek supporte les scanners Microtek de seconde génération avec un jeu de commande SCSI-1. Voyez sane-microtek(5) pour les détails.

microtek2

Le backend microtek2 supporte certains scanners Microtek avec un jeu de commande SCSI-2. Voyez sane-microtek2(5) pour les détails.

mustek

Le backend mustek supporte la plupart des scanners Mustek SCSI dont les séries Paragon et ScanExpress et le 600 II N (non-SCSI). Certains scanners Trust sont aussi supportés. Voyez sane-mustek(5) pour détails.

mustek_pp

Le backend mustek_pp supporte les scanners Mustek sur port parallèle. Voyez sane-mustek_pp(5) pour les détails.

mustek_usb

Le backend mustek_usb supporte certains scanners Mustek USB Voyez sane-mustek_usb(5) pour les détails.

nec

Le backend nec supporte le scanner NEC PC-IN500/4C SCSI. Voyez sane-nec(5) pour les détails.

pie

Le backend pie supporte les scanners PIE et Devcom SCSI. Voyez sane-pie(5) pour les détails.

plustek

Le backend plustek supporte les scanners Plustek sur port parallèle. Voyez sane-plustek(5) pour les détails.

ricoh

Le backend ricoh supporte les scanners Ricoch IS50 et IS60. Voyez sane-ricoh(5) pour les détails.

s9036

Le backend s9036 supporte le scanner Siemens 9036. Voyez sane-s9036(5) pour les détails.

sharp

Le backend sharp supporte les scanners Sharp SCSI. Voyez sane-sharp(5) pour les détails.

sm3600

Le backend SANE sm3600 supporte le scanner Microtek ScanMaker 3600 USB. Voyez sane-sm3600(5) pour les détails.

snapscan

Le backend supporte les scanners AGFA SnapScan. Voyez sane-snapscan(5) pour les détails.

sp15c

Ce backend supporte le scanner FCPA ScanPartner 15C. Voyez sane-fujitsu(5) pour les détails.

st400

Le backend sane-st400 supporte le scanner Siemens ST400 et ST800. Voyez sane-st400(5) pour les détails.

tamarack

Le backend tamarack supporte les scanners Tamarack Artiscan. Voyez sane-tamarack(5) pour les détails.

umax

Le backend sane-umax supporte plusieurs scanners UMAX SCSI et certains scanners Linotype Hell SCSI. Voyez sane-umax(5) pour les détails.

umax_pp

Le backend sane-umax_pp supporte les scanners Umax sur port parallèle et le HP 3200C. Voyez sane-umax_pp(5) pour les détails.

umax1200u

Le backend sane-umax1220u supporte le scanner UMAX Astra 1220U (USB) (et aussi le UMAX Astra 2000U, du même type). Voyez sane-umax1220u(5) pour les détails.

Jetez aussi un oeil à la page http://www.mostang.com/sane/sane-backends.html et dans la liste des projets dans /usr/doc/sane-1.0.7/PROJECTS.

sane-dc210

Backend pour le Kodak DC210. Voyez sane-dc210(5).

sane-dc240

Backend pour le Kodak DC240. Voyez sane-dc240(5).

sane-dc25

Backend pour le Kodak DC20/DC25. Voyez sane-dc25(5).

sane-dmc

Backend pour le Polaroid Digital Microscope. Voyez sane-dmc(5).

sane-gphoto2

Backend pour les appareils photos numériques supportés par la bibliothèque gphoto2. (Voyez http://www.gphoto.org pour davantage d’information et la liste des appareils supportés). Gphoto2 supporte plus de 140 modèles différents d’appareils photos. Cependant, veuillez noter qu’il reste encore du développement et des tests à faire avant que tous ces appareils photos soient supportés par le backend SANE. Voyez sane-gphoto2(5).

sane-qcam

Backend pour le Connectix QuickCam. Voyez sane-qcam(5).

Jetez aussi un oeil à la page http://www.mostang.com/sane/sane-backends.html et dans la liste des projets dans /usr/doc/sane-1.0.7/PROJECTS.

sane-dll

La bibliothèque sane-dll implémente un backend SANE qui permet d’accéder à un nombre arbitraire d’autres backend SANE par chargement dynamique. Voyez sane-dll(5).

sane-net

Le démon réseau saned permet d’accéder à des scanners qui sont connectés à d’autres ordinateurs du réseau. Voyez sane-net(5) et saned(1).

sane-pnm

lecteur d’image PNM pseudo-backend. Le but de ce backend est de fournir une aide pour déverminer des frontends SANE. Voyez sane-pnm(5).

sane-pint

Backend pour les scanners qui utilisent le pilote de périphérique PINT (Pint Is Not Twain). Le pilote PINT est activement développé sur la plateforme OpenBSD, et a été porté vers quelques autres saveurs d’Unix. Voyez sane-pint(5),

sane-v4l

La bibliothèque sane-v4l implémente un backend SANE qui fournit un accès générique aux caméras vidéos et équipement similaires utilisant l’API V4L (Video for Linux). Voyez sane-v4l(5).

Jetez aussi un oeil à la page http://www.mostang.com/sane/sane-backends.html et dans la liste des projets dans /usr/doc/sane-1.0.7/PROJECTS.

Veuillez noter que la configuration par défaut utilise sane-dll comme backend de plus haut niveau. Toutefois ce n’est probablement pas une bonne idée de commencer par lire sane-dll(5). Le backend de plus haut niveau est déterminé par les liens symboliques libsane.* symlinks dans /usr/lib/sane.

Pour les scanners SCSI, lisez sane-scsi(5), et sane-usb(5) pour les scanners USB.

Si vous rencontrez des problèmes pour que votre périphérique soit reconnu, essayer de définir les variables d’environnement qui sont disponibles pour vous assister dans la résolution de tels problèmes. Les variables d’environnement sont documentées dans les pages de manuels concernées. Par exemple, pour obtenir un maximum d’information de déverminage lors du test d’un scanner Mustek SCSI, définissez les variables SANE_DEBUG_DLL, SANE_DEBUG_MUSTEK, et SANE_DEBUG_SANEI_SCSI à 128, puis invoquez scanimage ou n’importe quel programme que vous essayez de déverminer. Pour un scanner Mustek sur /dev/scanner, vous pourriez invoquer scanimage comme suit :

scanimage -d mustek:/dev/scanner -h

Si ça marche, vous pouvez essayer d’acquérir une image avec :

scanimage -d mustek:/dev/scanner >t.pnm

Si vous n’êtes pas sûr du périphérique générique SCSI ou USB auquel est connecté votre scanner, essayez la commande sane-find-scanner. Habituellement, il suffit de l’invoquer sans argument. L’invocation de cette commande produit une sortie similaire à celle ci :

$ sane-find-scanner

sane-find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/scanner
sane-find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/sge

Remarquer que sane-find-scanner trouvera tous les scanners qui sont connectés à un bus SCSI Il peut même trouver des scanners qui ne sont pas du tout supportés par SANE.

Il y a plusieurs raisons qui peuvent expliquer les messages suivants en provenance des frontends : "scanimage: no SANE devices found" ou "xscanimage: no devices available.".

*

Votre scanner n’est reconnu par aucun backend. Il n’est pas supporté. Vous pouvez demander au mainteneur de votre backend (voir /usr/doc/sane-1.0.7/AUTHORS) ou la liste de diffusion SANE (voir ci-dessus) si il est prévu d’ajouter le support.

*

SANE ne peut pas accéder le fichier de périphérique (par ex. /dev/sga). Vérifiez les permissions.

*

Votre backend n’est pas listé dans /etc/sane.d/dll.conf (ou il est en commentaire).

*

Il y a des vieilles installations de SANE sur votre système. Si vous avez installé les bibliothèques SANE dans /usr/local/lib (par défaut) vous devriez vérifier s’il n’y aurait pas des vieilles bibliothèques SANE dans /usr/lib. Supprimez les (rm -r /usr/lib/libsane* /usr/lib/sane).

*

Si vous pouvez utiliser SANE avec scanimage mais avec aucun autre frontend graphique, vérifiez que /etc/ld.so.conf contient /usr/local/lib et non /usr/local/lib/sane. Voyez aussi la documentation des frontends.

Si vous pensez avoir découvert un bogue dans un backend, contactez son auteur. Vous trouverez son adresse électronique dans /usr/doc/sane-1.0.7/AUTHORS . S’il n’y a pas de mainteneur actif, vous pouvez aussi contacter la liste de diffusion sane-devel (voir http://www.mostang.com/sane/mail.html pour les détails). Vous devez vous inscrire à la liste, autrement votre courriel ne sera pas envoyé aux autres inscrits.

Si vous voulez envoyez des rapport de bogues concernant la compilation, installation, portage, documentation de SANE, vous pouvez aussi contacter l’auteur de cette page de manuel à <henning AT meier-geinitz.de>.

David Mosberger-Tang et beaucoup d’autres (voir /usr/doc/sane-1.0.7/AUTHORS pour les détails). Cette page de manuel a été écrite par Henning Meier-Geinitz. Une partie du texte a été reprise dans le standard SANE, plusieurs pages de manuels et des fichiers README.

Sébastien Blanchet, 2003