Welcome to Linux Knowledge Base and Tutorial
"The place where you learn linux"
The ONE Campaign to make poverty history

 Create an AccountHome | Submit News | Your Account  

Tutorial Menu
Linux Tutorial Home
Table of Contents

· Introduction to Operating Systems
· Linux Basics
· Working with the System
· Shells and Utilities
· Editing Files
· Basic Administration
· The Operating System
· The X Windowing System
· The Computer Itself
· Networking
· System Monitoring
· Solving Problems
· Security
· Installing and Upgrading
· Linux and Windows

Man Pages
Linux Topics
Test Your Knowledge

Site Menu
Site Map
Copyright Info
Terms of Use
Privacy Info
Masthead / Impressum
Your Account

Private Messages

News Archive
Submit News
User Articles
Web Links


The Web

Who's Online
There are currently, 201 guest(s) and 0 member(s) that are online.

You are an Anonymous user. You can register for free by clicking here




       scanimage   [-d|--device-name   dev]   [--format   format]
       [-i|--icc-profile profile] [-L|--list-devices]  [-f|--for­
       matted-device-list  format]  [--batch [=format]] [--batch-
       start  start]  [--batch-count  count]   [--batch-increment
       increment]       [--batch-double]      [--accept-md5-only]
       [-n|--dont-scan]  [-T|--test]  [-h|--help]  [-v|--verbose]
       [-V|--version] [device-specific-options]


       scanimage  is  a  command-line  interface to control image
       acquisition devices such as flatbed scanners  or  cameras.
       The  device is controlled via command-line options.  After
       command-line processing, scanimage  normally  proceeds  to
       acquire  an  image.  The image data is written to standard
       output in one of the PNM (portable  aNyMaP)  formats  (PBM
       for  black-and-white images, PGM for grayscale images, and
       PPM  for  color  images)  or  in  TIFF   (black-and-white,
       grayscale or color).  scanimage accesses image acquisition
       devices through the SANE (Scanner Access Now Easy)  inter­
       face  and  can  thus  support  any  device for which there
       exists a SANE backend (try apropos sane- to get a list  of
       available backends).


       To get a list of devices:

         scanimage -L

       To scan with default settings to the file image.pnm:

         scanimage >image.pnm

       To print all available options:

         scanimage -h


       The -d or --device-name options must be followed by a SANE
       device-name  like  `epson:/dev/sg0'  or  `hp:/dev/usbscan­
       ner0'.   A  (partial)  list  of  available  devices can be
       obtained with the --list-devices option (see  below).   If
       no  device-name is specified explicitly, scanimage reads a
       device-name     from     the     environment      variable
       SANE_DEFAULT_DEVICE.  If this variable is not set, scanim­
       age will attempt to open the first available device.

       The --format format option selects how image data is writ­
       ten  to  standard  output.  format can be pnm or tiff.  If
       --format is not used, PNM is written.

       The -f or --formatted-device-list option works similar  to
       --list-devices,  but  requires a format string.  scanimage
       replaces the placeholders %d %v %m %t %i with  the  device
       name,  vendor  name, model name, scanner type and an index
       number respectively. The command

              scanimage -f " scanner number %i device %d is a %t,
              model %m, produced by %v "

       will produce something like:

              scanner  number  0   device  sharp:/dev/sg1  is   a
              flatbed scanner,  model  JX250  SCSI,  produced  by

       The  --batch*  options  provide  the features for scanning
       documents using document  feeders.   --batch  [format]  is
       used  to specify the format of the filename that each page
       will be written to.  Each page is written out to a  single
       file.    If  format  is  not  specified,  the  default  of
       out%d.pnm (or out%d.tif for --format tiff) will  be  used.
       format  is given as a printf style string with one integer
       parameter.  --batch-start start selects the page number to
       start  naming files with. If this option is not given, the
       counter will start at 0.   --batch-count  count  specifies
       the  number  of  pages  to attempt to scan.  If not given,
       scanimage will continue scanning until the scanner returns
       a  state  other  than  OK.  Not all scanners with document
       feeders signal when the ADF is empty, use this command  to
       work  around  them.   With --batch-increment increment you
       can change the amount that the number in the  filename  is
       incremented by.  Generally this is used when you are scan­
       ning double-sided documents  on  a  single-sided  document
       feeder.   A  specific  command  is  provided  to aid this:
       --batch-double will automatically set the increment to  2.

       The  --accept-md5-only option only accepts user authoriza­
       tion requests that support MD5 security. The SANE  network
       daemon  (saned)  is  capable  of  doing such requests. See

       The -n or --dont-scan option requests that scanimage  only
       sets the options provided by the user but doesn't actually
       perform a scan. This option can be used to e.g.  turn  off
       the scanner's lamp (if supported by the backend).

       The -T or --test option requests that scanimage performs a
       few simple sanity tests to make sure the backend works  as
       defined by the SANE API (in particular the sane_read func­
       tion is excercised by this test).

       be used. Example: SANE_DEBUG_DLL=3 scanimage -L.

       As you might imagine, much of the power of scanimage comes
       from the fact that it can control any SANE backend.  Thus,
       the exact set of command-line options depends on the capa­
       bilities of the selected device.  To see the options for a
       device named dev, invoke scanimage via a  command-line  of
       the form:

              scanimage --help --device-name dev

       The  documentation for the device-specific options printed
       by --help is best explained with a few examples:

        --brightness -100..100% [0]
           Controls the brightness of the acquired image.

              The description above shows that  option  --bright­
              ness expects an option value in the range from -100
              to 100 percent.  The value in square brackets indi­
              cates that the current option value is 0 percent.

           Set default values for enhancement controls.

              The  description above shows that option --default-
              enhancements has no option  value.   It  should  be
              thought  of  as  having  an immediate effect at the
              point of the command-line at which it appears.  For
              example,  since this option resets the --brightness
              option, the option-pair --brightness 50  --default-
              enhancements would effectively be a no-op.

        --mode Lineart|Gray|Color [Gray]
           Selects the scan mode (e.g., lineart or color).

              The  description  above  shows  that  option --mode
              accepts an argument that must be one of the strings
              Lineart,  Gray,  or Color.  The value in the square
              bracket indicates that the option is currently  set
              to  Gray.  For convenience, it is legal to abbrevi­
              ate the  string  values  as  long  as  they  remain
              unique.   Also,  the  case  of the spelling doesn't
              matter.  For example, option setting --mode col  is
              identical to --mode Color.

        --custom-gamma[=(yes|no)] [inactive]
           Determines whether a builtin or a custom gamma-table
           should be used.

              The  description  above shows that option --custom-
              gamma expects  either  no  option  value,  a  "yes"
              ticular  mode  by  specifying the appropriate mode-
              options along with the --help option.  For example,
              the command-line:

              scanimage --help --mode color

              would  print the option settings that are in effect
              when the color-mode is selected.

        --gamma-table 0..255,...
           Gamma-correction table.  In color mode this option
           equally affects the red, green, and blue channels
           simultaneously (i.e., it is an intensity gamma table).

              The  description  above  shows that option --gamma-
              table expects zero or more values in the range 0 to
              255.   For  example,  a legal value for this option
              would be "3,4,5,6,7,8,9,10,11,12".  Since it's cum­
              bersome  to  specify long vectors in this form, the
              same can  be  expressed  by  the  abbreviated  form
              "[0]3-[9]12".   What  this  means is that the first
              vector element is set to 3, the 9-th element is set
              to  12  and  the  values inbetween are interpolated
              linearly.  Of course, it  is  possible  to  specify
              multiple   such   linear  segments.   For  example,
              "[0]3-[2]3-[6]7,[7]10-[9]6"   is   equivalent    to
              "3,3,3,4,5,6,7,10,8,6".   The program gamma4scanim­
              age can be used to generate such gamma tables  (see
              gamma4scanimage(1) for details).

        --filename <string> [/tmp/input.ppm]
           The filename of the image to be loaded.

              The  descriptoin  above  is an example of an option
              that takes an arbitrary string value (which happens
              to  be  a  filename).  Again, the value in brackets
              show that the option is current set to the filename


              The default device-name.


              This  directory  holds various configuration files.
              For details,  please  refer  to  the  manual  pages
              listed below.

              This file contains lines of the form



       David  Mosberger,  Andreas  Beck,  Gordon  Matzigkeit  and
       Caskey Dickson


       For vector options, the help output currently has no indi­
       cation as to how many elements a vector-value should have.

sane-backends 1.0.12       15 Apr 2003               scanimage(1)
Help us cut cost by not downloading the whole site!
Use of automated download sofware ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and therefore is expressedly prohibited. For more details on this, take a look here



Security Code
Security Code
Type Security Code

Don't have an account yet? You can create one. As a registered user you have some advantages like theme manager, comments configuration and post comments with your name.

Help if you can!

Amazon Wish List

Did You Know?
You can help in many different ways.


Tell a Friend About Us

Bookmark and Share

Web site powered by PHP-Nuke

Is this information useful? At the very least you can help by spreading the word to your favorite newsgroups, mailing lists and forums.
All logos and trademarks in this site are property of their respective owner. The comments are property of their posters. Articles are the property of their respective owners. Unless otherwise stated in the body of the article, article content (C) 1994-2013 by James Mohr. All rights reserved. The stylized page/paper, as well as the terms "The Linux Tutorial", "The Linux Server Tutorial", "The Linux Knowledge Base and Tutorial" and "The place where you learn Linux" are service marks of James Mohr. All rights reserved.
The Linux Knowledge Base and Tutorial may contain links to sites on the Internet, which are owned and operated by third parties. The Linux Tutorial is not responsible for the content of any such third-party site. By viewing/utilizing this web site, you have agreed to our disclaimer, terms of use and privacy policy. Use of automated download software ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and are therefore expressly prohibited. For more details on this, take a look here

PHP-Nuke Copyright © 2004 by Francisco Burzi. This is free software, and you may redistribute it under the GPL. PHP-Nuke comes with absolutely no warranty, for details, see the license.
Page Generation: 0.10 Seconds