Python: WIA API を使用して Windows でドキュメントをスキャンする

#!/usr/bin/env python3

# On charge la bibliothèque cliente pour les API Win32/COM
import win32com.client

# On charge et on instancie la classe qui permet de lister et manipuler les
# scanners
device_manager = win32com.client.Dispatch("WIA.DeviceManager")

# On parcourt tous les scanners dispo. Le "DeviceManager" va nous retourner
# des objets "DeviceInfo" qui nous permettront de récupérer les propriétés
# des périphériques et de nous y connecter par la suite.
for device_info in device_manager.DeviceInfos:
    print("-------------------------------------")
    # On affiche une à une les propriétés du scanner
    for prop in device_info.Properties:
        print("%s: %s" % (prop.Name, str(prop.Value)))

#!/usr/bin/env python3

import win32com.client

device_manager = win32com.client.Dispatch("WIA.DeviceManager")

# On prend le premier scanner disponible
#
# ATTENTION : contrairement aux listes Python, les listes Win32/COM
#             commencent à 1 et non à 0.
device_info = device_manager.DeviceInfos(1)

# On se connecte au scanner
device = device_info.Connect()

# On récupère le premier "élément" du périphérique (le scanner à plat pour
# moi). Il est possible qu'il y en ait plusieurs sur un scanner plus
# complexe, mais tous les scanners que j'ai utilisés n'en avait qu'un...
scan_source = device.Items(1)

# On numérise le document en sélectionnant au passage le format de l'image
# souhaité.
#
# NOTE¹ : À priori WIA semble supporter du BMP, du PNG, du JPEG etc. mais
#         je n'ai jamais réussi à obtenir autre chose que du BMP (c'est
#         peut-être dépendant des drivers ?). Je vous recommande donc de
#         choisir BMP et de convertir vous-même l'image dans un autre
#         format après coup, en utilisant la bibliothèque PIL par exemple.
#
# NOTE² : la constante « win32com.client.constants.wiaFormatBMP » n'existe
#         qu'après avoir exécuté « win32com.client.Dispatch("WIA.DeviceManager") »
#         dans le script.
#
#         Si jamais cette constante n'était pas disponible pour une raison
#         ou pour une autre, sachez que vous pouvez la remplacer par la
#         string suivante : "{B96B3CAB-0728-11D3-9D7B-0000F81EF32E}".
wia_image = scan_source.Transfer(win32com.client.constants.wiaFormatBMP)

# On sauvegarde l'image dans le fichier "out.bmp" dans le dossier courant
wia_image.SaveFile("out.bmp")

#!/usr/bin/env python3

import win32com.client

device_manager = win32com.client.Dispatch("WIA.DeviceManager")
device_info = device_manager.DeviceInfos(1)
device = device_info.Connect()
scan_source = device.Items(1)

# On liste les différents réglages du scanner
for prop in scan_source.Properties:
    print("%s: %s" % (prop.Name, str(prop.Value)))

>>> scan_source.Properties("Contrast").Value
... 0

>>> scan_source.Properties("Contrast").Value = 1000  # +100% de contraste

>>> scan_source.Properties("Contrast").Value
... 1000

>>> scan_source.Properties("Contrast").SubTypeMin
... -1000
>>> scan_source.Properties("Contrast").SubTypeMax
... 1000
>>> scan_source.Properties("Contrast").SubTypeStep
... 1

#!/usr/bin/env python3

import win32com.client

device_manager = win32com.client.Dispatch("WIA.DeviceManager")
device_info = device_manager.DeviceInfos(1)
device = device_info.Connect()
scan_source = device.Items(1)
scan_source.Properties("Contrast").Value = scan_source.Properties("Contrast").SubTypeMax // 2
wia_image = scan_source.Transfer(win32com.client.constants.wiaFormatBMP)
wia_image.SaveFile("out.bmp")