home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / mtek004.zip / mtekscan.txt < prev    next >
Text File  |  1997-09-16  |  10KB  |  334 lines
  1.  
  2.  
  3.  
  4. mtekscan(1)              mtekscan manual              mtekscan(1)
  5.  
  6.  
  7. NAME
  8.        mtekscan - driver for MicroTek SCSI scanners
  9.  
  10. SYNOPSIS
  11.        mtekscan <SCSI ID of scanner> [options]
  12.  
  13.  
  14. DESCRIPTION
  15.        mtekscan  is a driver that allows the use of MicroTek SCSI
  16.        scanners with Linux.  It is a command  line  utility  that
  17.        scans an image and writes the data to stdout or to a spec-
  18.        ified  file.   Originally  developed  for  use  with   the
  19.        MicroTek  ScanMaker  E6,  it  is  known to work with other
  20.        MicoTek SCSI scanners as well. So far, it  has  been  suc-
  21.        cessfully tested with a ScanMaker II, ScanMaker III, Scan-
  22.        Maker E3, ScanMaker 35t+, and ScanMaker  E6,  as  well  as
  23.        with an Adara ImageStar I, Genius ColorPage-SP2 and a Pri-
  24.        max DeskScan Color.
  25.  
  26.  
  27. OPTIONS
  28.        All options and arguments have to be separated by  spaces;
  29.        combining options like '-cpVt' is not allowed. If mutually
  30.        exclusive options are specified on the same  command  line
  31.        (like  '-c  -g')  the  last option overrides previous ones
  32.        (unless explicitly stated otherwise, as for the -T and  -G
  33.        options,  see below).  Note that some of the options might
  34.        not be available, depending on the scanner model used.
  35.  
  36.        <SCSI ID of scanner>
  37.               This is required for the OS/2 version, and must
  38.               have your scanner's ID #; i.e. 6.
  39.  
  40.        -o <file>
  41.               If this is specified, mtekscan writes  it's  output
  42.               to <file> , instead of stdout.
  43.  
  44.  
  45.        -f <x1> <y1> <x2> <y2>
  46.               Sets the scanning frame to the rectangle defined by
  47.               the upper left corner <x1>,<y1> and the lower right
  48.               corner  <x2>,<y2>.  The coordinates are measured in
  49.               inch; the origin is at the top left corner  of  the
  50.               scanning area.
  51.  
  52.  
  53.        -r <resolution>
  54.               Sets  the  scanning  resolution  (in  dpi).  As the
  55.               MicroTek scanners only accept  resolution  settings
  56.               in  1% or 5% steps of the maximum, the closest pos-
  57.               sible value is selected.
  58.  
  59.  
  60.        -b     Selects line art (black and white) scanning.
  61.  
  62.  
  63.        -a     Selects halftone scanning. The document is dithered
  64.  
  65.  
  66.  
  67. ffwd                        13 Apr 97                           1
  68.  
  69.  
  70.  
  71.  
  72.  
  73. mtekscan(1)              mtekscan manual              mtekscan(1)
  74.  
  75.  
  76.               using  a  halftoning  pattern  that can be selected
  77.               with the -H option.
  78.  
  79.  
  80.        -g     Selects grayscale scanning.
  81.  
  82.  
  83.        -c     Selects color scanning.
  84.  
  85.  
  86.        -s <n> Sets the shadow adjustment value (black  level)  to
  87.               <n>,  where  <n> is a decimal value in the range of
  88.               0..255. All pixel values less than or equal to this
  89.               value  are  set  to 0, and the remaining values are
  90.               mapped into the range of 0 through 255.
  91.  
  92.               This option only works in multi-bit scanning  modes
  93.               (color or grayscale).  The default value is 0.
  94.  
  95.  
  96.        -l <n> Sets  the  highlight adjustment value (white level)
  97.               to <n>, where <n> is a decimal value in  the  range
  98.               of  0..255.  All pixel values greater than or equal
  99.               to this value are set to  255,  and  the  remaining
  100.               values  are mapped into the range of 0 through 255.
  101.  
  102.               This option only works in multi-bit scanning  modes
  103.               (color or grayscale).  The default value is 255.
  104.  
  105.  
  106.        -m <n> Sets the midtone adjustment value to <n>, where <n>
  107.               is a decimal value in  the  range  of  0..255.  All
  108.               pixel values larger than or equal to <n> are mapped
  109.               into the range of 128 through 255, and  all  values
  110.               less  than  <n>  are  mapped  into  the  range of 0
  111.               through 127.
  112.  
  113.               This option only works in multi-bit scanning  modes
  114.               (color or grayscale).  The default value is 128.
  115.  
  116.  
  117.        -d <n> [ <n> <n> ]
  118.               Selects  a  digital  brightness adjustment value of
  119.               <n>, where <n> is a decimal value in the  range  of
  120.               -100..100.  If  just  one  value is specified after
  121.               this option, it determines the overall  brightness.
  122.               If  three  values are specified, they determine the
  123.               red, green, and blue channel brightness  adjustment
  124.               individually.
  125.  
  126.               The default value is 0.
  127.  
  128.  
  129.        -e <n> Sets   the   exposure   time   adjustment   (analog
  130.  
  131.  
  132.  
  133. ffwd                        13 Apr 97                           2
  134.  
  135.  
  136.  
  137.  
  138.  
  139. mtekscan(1)              mtekscan manual              mtekscan(1)
  140.  
  141.  
  142.               brightness adjustment) to <n>, where <n> is a deci-
  143.               mal  value  usually  in  the range of -18..21 (some
  144.               scanner models may accept higher values). Note that
  145.               this  value  must be a multiple of 3, otherwise the
  146.               closest possible value is selected.
  147.  
  148.               The default value is 0.
  149.  
  150.  
  151.        -k <n> Sets the contrast adjustment to <n>, where <n> is a
  152.               decimal value usually in the range of -42..49 (some
  153.               scanner models may accept higher values). Note that
  154.               this  value  must be a multiple of 7, otherwise the
  155.               closest possible value is selected.
  156.  
  157.               The default value is 0.
  158.  
  159.  
  160.        -G <n> [ <n> <n> ]
  161.               Sets the gamma correction to <n>.  Specifying  just
  162.               one  value  after  the  -G selects an overall gamma
  163.               correction value; if  three  values  are  specified
  164.               they select red, green and blue channel gamma indi-
  165.               vidually.
  166.  
  167.               The default value is 1.0 for all three channels.
  168.  
  169.  
  170.        -T <file>
  171.               Loads the gamma correction  table(s)  from  <file>.
  172.               If  this  is specified, it overrides any gamma set-
  173.               tings specified with the -G option, even if the  -T
  174.               option  is  specified  before the -G on the command
  175.               line.
  176.  
  177.               The default is not to load correction tables from a
  178.               file.
  179.  
  180.  
  181.        -t     Selects  transparency  scanning  if  a transparency
  182.               illuminator is installed.
  183.  
  184.  
  185.        -n     Selects negative scanning (reverse colors).
  186.  
  187.  
  188.        -H <n> Selects the built-in halftoning pattern <n>,  where
  189.               <n>  is  a decimal value in the range of 0..11. The
  190.               halftoning  pattern  defines  how  the   image   is
  191.               dithered when scanning halftone images (option -a).
  192.  
  193.  
  194.        -p     Enables prescan mode, resulting in faster but  less
  195.               accurate scans.
  196.  
  197.  
  198.  
  199. ffwd                        13 Apr 97                           3
  200.  
  201.  
  202.  
  203.  
  204.  
  205. mtekscan(1)              mtekscan manual              mtekscan(1)
  206.  
  207.  
  208.        -v <n> Sets  the  scanning velocity to <n>, where <n> is a
  209.               decimal value in the range of 1..7  (higher  values
  210.               resulting  in  longer scan times). Setting a higher
  211.               value can result in better quality if segment scan-
  212.               ning is necessary (see option -B below).
  213.  
  214.               The default value is 1 (fastest).
  215.  
  216.  
  217.        -B     Disables backtracking between scanning segments. If
  218.               the transfer buffer of the generic SCSI  driver  is
  219.               too  small,  the  scan process will be divided into
  220.               several steps, or segments. Usually, the scan  head
  221.               will  move  a bit backwards before beginning with a
  222.               new segment. This can  be  disabled  by  specifying
  223.               this  switch, resulting in faster but less accurate
  224.               scans.
  225.  
  226.  
  227.        -C     Disables the recalibration at the start of a  scan.
  228.               This  results  in  much  shorter scanning times but
  229.               less quality.
  230.  
  231.               Note that specifying this option causes a SCSI  bus
  232.               lock-up  if the scanner did not calibrate itself at
  233.               least once (e.g. if the scanner was  just  switched
  234.               on).  At  least one scan must be made with calibra-
  235.               tion enabled before this option can be used.
  236.  
  237.  
  238.        -P     Same as '-p -C' (see above).
  239.  
  240.  
  241.        -V     Verbose mode. Scanner settings and progress  infor-
  242.               mation is written to stderr.
  243.  
  244.  
  245.        -i     Shows  options  supported  by  the scanner in short
  246.               format. The first values are the  maximum  document
  247.               size and resolution, and the number of contrast and
  248.               exposure time values accepted, followed by  a  list
  249.               of  option  letters  supported by the scanner. This
  250.               information is intended for use  with  a  graphical
  251.               scanning frontend.
  252.  
  253.  
  254.        -I     Shows internal scanner data in long, human-readable
  255.               format.
  256.  
  257.  
  258.        -S     Perform a self-test of  the  scanner  hardware  and
  259.               exit.
  260.  
  261.  
  262.  
  263.  
  264.  
  265. ffwd                        13 Apr 97                           4
  266.  
  267.  
  268.  
  269.  
  270.  
  271. mtekscan(1)              mtekscan manual              mtekscan(1)
  272.  
  273.  
  274.        -h     Displays a list of command line options accepted by
  275.               mtekscan.
  276.  
  277.  
  278. BUGS
  279.        mtekscan can cause kernel panics, system crashes, SCSI bus
  280.        lock-ups  and various other nasty things. Really.  Select-
  281.        ing a negative brightness value with the  -d  option  pro-
  282.        duces  strange (and definitely wrong) results, at least on
  283.        a ScanMaker E6. Specifying different brightness adjustment
  284.        values for the red, green, and blue channels does not have
  285.        the desired effect but just affects the overall brightness
  286.        (again,  at  least on an E6). And probably there's a thou-
  287.        sand more.
  288.  
  289.  
  290. AUTHOR
  291.        mtekscan is Copyright (C) 1996, 1997 by Jan  Schoenepauck,
  292.        <schoenep@uni-wuppertal.de>.   Some  Parts  of the program
  293.        were taken from the muscan driver for Mustek  scanners  by
  294.        Torsten  Eichner  <eichner@rhrk.uni-kl.de>.   The code for
  295.        the three-pass scanner support is heavily based on a patch
  296.        by Warwick Allison <warwick@cs.uq.edu.au>.
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331. ffwd                        13 Apr 97                           5
  332.  
  333.  
  334.