Python implementation of the Sane API (using ctypes) and abstration layer.
The code is divided in 3 layers:
- rawapi : Ctypes binding to the raw Sane API
- abstract : An Object-Oriented layer that simplifies the use of the Sane API and try to avoid possible misuse of the Sane API. When scanning, it also takes care of returning a Pillow image.
- abstract_th : The Sane API is not thread-safe and cannot be used in a multi-threaded environment easily. This layer solves this problem by using a fully dedicated thread.
libsane Pillow (if the abstraction layer is used)
$ sudo pip install pyinsane
$ git clone https://github.com/jflesch/pyinsane.git $ cd pyinsane $ sudo python ./setup.py install
$ python ./run_tests.py
Unit tests require at least one scanner with a flatbed and an ADF (Automatic Document Feeder).
If possible, they should be run with at least 2 scanners connected. The first that appear in "scanimage -L" must be the one with the ADF.
My current setup:
- HP Officejet 4500 G510g (Flatbed + ADF)
- HP Deskjet 2050 J510 series (Flatbed)
import pyinsane.abstract as pyinsane devices = pyinsane.get_devices() assert(len(devices) > 0) device = devices print("I'm going to use the following scanner: %s" % (str(device))) scanner_id = device.name
or if you already know its name/id:
import pyinsane.abstract as pyinsane device = pyinsane.Scanner(name="somethingsomething") print("I'm going to use the following scanner: %s" % (str(device)))
device.options['resolution'].value = 300 # Beware: Some scanner have "Lineart" or "Gray" as default mode device.options['mode'].value = 'Color' scan_session = device.scan(multiple=False) try: while True: scan_session.scan.read() except EOFError: pass image = scan_session.images
Multiple scans using an automatic document feeder (ADF)
if not "ADF" in device.options['source'].constraint: print("No document feeder found") return device.options['source'].value = "ADF" # Beware: Some scanner have "Lineart" or "Gray" as default mode device.options['mode'].value = 'Color' scan_session = device.scan(multiple=True) try: while True: try: scan_session.scan.read() except EOFError: print ("Got a page ! (current number of pages read: %d)" % (len(scan_session.images))) except StopIteration: print("Document feeder is now empty. Got %d pages" % len(scan_session.images)) for idx in range(0, len(scan_session.images)): image = scan_session.images[idx]
import pyinsane.abstract_th as pyinsane # When imported, it will start a new thread, dedicated to Sane. # Its API is the same than for pyinsane.abstract. You can use it the # same way. # Note however that the Sane thread can only do one thing at a time, # so some function call may be on hold on a semaphore for some times.
The folder 'examples' contains more detailed examples. For instance, examples/scan.py shows how to get pieces of a scan as it goes.
To run one of these scripts, run:
python -m examples.[script] [args]
python -m examples.scan toto.png
GPL v3 2012(c) Jerome Flesch (firstname.lastname@example.org)