Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
sane-epkowa(5)		       File Formats Manual		  sane-epkowa(5)

NAME
     sane-epkowa - SANE backend for EPSON scanners

DESCRIPTION
     The sane-epkowa library implements a SANE (Scanner Access Now Easy) backend
     that  provides  access  to  EPSON flatbed scanners.  This backend should be
     considered alpha-quality software!

     At present, the following scanners are known to work with this backend:

	    Model:
	    japan	     other
	    ---------------- -------------------
	    GT-6600U	     Perfection 610
	    GT-6700U	     Perfection 640U
	    GT-7200U	     Perfection 1250
			     Perfection 1250 PHOTO
	    GT-7300U	     Perfection 1260
			     Perfection 1260 PHOTO
	    GT-7600S	     Perfection 1200S
	    GT-7600U	     Perfection 1200U
	    GT-7600UF	     Perfection 1200U PHOTO
	    GT-7700U	     Perfection 1240U
	    GT-8300UF	     Perfection 1660 PHOTO
	    GT-8700	     Perfection 1640SU
	    GT-8700F	     Perfection 1640SU PHOTO
	    GT-8200U	     Perfection 1650
	    GT-8200UF	     Perfection 1650 PHOTO
	    GT-9300UF	     Perfection 2400 PHOTO
	    GT-9400	     Perfection 3170 PHOTO
	    GT-9700F	     Perfection 2450 PHOTO
	    GT-9800F	     Perfection 3200 PHOTO
	    GT-F500	     Perfection 2480 PHOTO
	    GT-F520	     Perfection 3490 PHOTO
	    GT-F550	     Perfection 2580 PHOTO
	    GT-F570	     Perfection 3590 PHOTO
	    GT-F600	     Perfection 4180 PHOTO
	    GT-F650	     Perfection V100 PHOTO
	    GT-F670	     Perfection V200 PHOTO
	    GT-F700	     Perfection V350 PHOTO
	    GT-S600	     Perfection V10
	    GT-X700	     Perfection 4870 PHOTO
	    GT-X750	     Perfection 4490 PHOTO
	    GT-X770	     Perfection V500 PHOTO
	    GT-X800	     Perfection 4990 PHOTO
	    GT-X900	     Perfection V700/V750
	    ES-2000	     Expression 1600
	    ES-2200	     Expression 1680
	    ES-6000	     GT-10000
	    ES-6000H	     GT-10000+
	    ES-6000HS
	    ES-7000H	     GT-15000
	    ES-8500	     Expression 1640XL
	    ES-9000H	     GT-30000
	    ES-10000G	     Expression 10000XL
	    ES-H300	     GT-2500
			     Stylus CX2800/CX2900/ME200
	    PX-A550	     Stylus CX3500/CX3600
			     Stylus CX3700/CX3800/DX3800
	    PX-A620	     Stylus CX3900/DX4000
			     Stylus CX4100/CX4200/DX4200
			     Stylus CX4300/CX4400/CX5500/CX5600/DX4400
			     Stylus CX4500/CX4600
	    PX-A650	     Stylus CX4700/CX4800/DX4800
			     Stylus CX4900/CX5000/DX5000
	    CC-600PX	     Stylus CX5100/CX5200
			     Stylus CX5300/CX5400
	    PX-A720	     Stylus CX5900/CX6000/DX6000
			     Stylus CX6300/CX6400
			     Stylus CX6500/CX6600
	    PX-A640	     Stylus CX7300/CX7400/DX7400
			     Stylus CX7700/CX7800
	    PX-A740	     Stylus CX8300/CX8400/DX8400
	    PX-FA700	     Stylus CX9300F/CX9400Fax/DX9400F
	    PM-A700	     Stylus Photo RX420/RX425/RX430
			     Stylus Photo RX500/RX510
	    PM-A750	     Stylus Photo RX520/RX530
	    PM-A820	     Stylus Photo RX560/RX580/RX590
	    PM-A840	     Stylus Photo RX585/RX595/RX610
	    PM-A850	     Stylus Photo RX600
	    PM-A870	     Stylus Photo RX620/RX630
	    PM-A890	     Stylus Photo RX640/RX650
	    PM-A940	     Stylus Photo RX680/RX685/RX690
	    PM-A900	     Stylus Photo RX700
	    PM-A920
	    PM-A950
	    PM-A970
	    PM-T960
	    PM-T990
	    LP-A500	     AcuLaser CX11
			     AcuLaser CX21
	    LP-M5500
	    LP-M5600

     For other scanners the software  may or may not work.  Please send mail  to
     sane-devel@lists.alioth.debian.org to report successes or failures.

OPTIONS
     The  options  the	backend  supports can either be selected through command
     line options to programs like scanimage or through GUI elements in xscanim-
     age or xsane.

     Valid command line options and their syntax can be listed by using
	    scanimage --help -d epkowa
     Not all devices support all options.

     Scan Mode
	    The --mode switch selects the basic mode of operation of the scanner
	    valid choices are Binary, Gray and Color.  The Binary mode is  black
	    and white only, Gray will produce up to 256 levels of gray and Color
	    means  24  bit  color mode. Some scanners will internally use 36 bit
	    color, the external interface however does only support 24 bits.

	    The --dropout option determines which color filters are used to scan
	    in Binary mode. Valid choices are None, Red, Green and Blue.

	    The --halftoning switch selects the mode  that  is	used  in  Binary
	    mode.  Valid  options  are	None, Halftone A (Hard Tone), Halftone B
	    (Soft Tone), Halftone C (Net Screen), Dither A (4x4 Bayer), Dither B
	    (4x4 Spiral), Dither C (4x4 Net Screen), Dither D (8x4 Net	Screen),
	    Text  Enhanced  Technology, Download pattern A, and Download pattern
	    B.

	    The --dropout switch selects the so called dropout color.  Vald  op-
	    tions  are	None,  Red,  Green  and  Blue.	The default is None. The
	    dropout color is used for monochrome scanning and selects the  color
	    that  is not scanned. This can be used to e.g. scan an original with
	    a colored background.

	    The --brightness switch controls the brightness of the  scan.  Valid
	    options  are  the numbers from -3 to 3. The default is 0. The larger
	    the brightness value, the brighter the image gets. If a user defined
	    table for the gamma correction is selected, the brightness parameter
	    is not available.

	    The --sharpness switch sets the sharpness of the image  data.  Valid
	    options  are the numbers from -2 to 2, with -2 meaning "Defocus", -1
	    "Defocus slightly", 0 "Normal", 1 "Sharpen slighly" and 2 "Sharpen".

	    The --gamma-correction switch controls  the  scanne  internal  gamma
	    correction.  Valid options are "Default", "User defined", "High den-
	    sity printing" "Low density printing" and "High contrast printing".

	    The --color-correction switch controls the	scanner  internal  color
	    correction	function. Valid options are "No Correction", "Impact-dot
	    printers", "Thermal printers", "Ink-jet  printers"	and  "CRT  moni-
	    tors". The default is "CRT monitors".

	    The  --resolution switch selects the resolution for a scan. Many EP-
	    SON scanners will scan in any  resulution  between	the  lowest  and
	    highest possible value. The list reported by the scanner can be dis-
	    played using the "--help -d epkowa" parameters to scanimage.

	    The  --mirror option controls the way the image is scanned. By read-
	    ing the image data from right to left the image  is  mirored.  Valid
	    options are "yes" and "no". The default is "no".

	    The  --speed  option  can improve the scan speed in monochrome mode.
	    Valid options are "yes" or "no", the "yes" option will speed up  the
	    scan if this option is supported.

	    The --auto-area-segmentation switch turns on the automatic area seg-
	    mentation  for  monochrome	scans. The scanner will try to determine
	    which areas are text and which contain images. The image areas  will
	    be	halftoned, and the text will be impoved. Valid options are "yes"
	    and "no". The default is "yes".

	    The --gamma-table parameter can be used to download a  user  defined
	    gamma  table.  The options takes 256 values from the range 0-255. In
	    color mode this option equally affects  the  red,  green,  and  blue
	    channel.

	    The  --red-gamma-table  parameter can be used to download a user de-
	    fined gamma table for the red channel. The	valid  options	are  the
	    same as for --gamma-table.

	    The --green-gamma-table parameter can be used to download a user de-
	    fined  gamma  table for the green channel. The valid options are the
	    same as for --gamma-table.

	    The --blue-gamma-table parameter can be used to download a user  de-
	    fined  gamma  table  for the blue channel. The valid options are the
	    same as for --gamma-table.

	    The  color	correction  coefficients  --cct-1  --cct-2  --cct-3  ...
	    --cct-9  will install color correction coefficients for the user de-
	    fined color correction. Possible values are in the range -127..127.

	    The --preview option requests a preview scan. The frontend	software
	    automatically  selects a low resolution. Valid options are "yes" and
	    "no". The default is "no".

	    The --preview-speed options will increase the scan speed if this  is
	    supported  by the scanner. Valid options are "yes" and "no", the de-
	    fault is "no".

	    The geometry options -l -t -x -y control the scan area: -l sets  the
	    top  left x coordinate, -t the top left y coordinate, -x selects the
	    width and -y the height of the scan aea. All parameters  are  speci-
	    fied in milimeters.

	    The --quick-format option lets the user select a scan area with pre-
	    defined  sizes.  Valid parameters are "CD", "A5 portrait", "A5 land-
	    scape", "Letter", "A4" and "max". The default is  "max",  which  se-
	    lects the largest possible area.

	    The --source option selects the scan source. Valid options depend on
	    the installed options. The default is "Flatbed".

	    The  --auto-eject  option  will eject a page after scanning from the
	    document feeder.

CONFIGURATION FILE
     The configuration file /usr/local/etc/sane.d/epkowa.conf specifies the  de-
     vice(s)  that  the  backend will use. The current version only supports one
     scanner per EPSON backend. Possible connection types are:

     SCSI   This is the default, and if nothing else is  specified  the  backend
	    software  will  open  a given patch as SCSI device. More information
	    about valid syntax for SCSI devices can be found in sane-scsi(5).

     PIP - Parallel Interface
	    The parallel interface can be configured in  two  ways:  An  integer
	    number  starting  at  the beginning of a line will be interpreted as
	    the IO address of the parallel port. To make it clearer that a  con-
	    figured  IO  address is a parallel port the port address can be pre-
	    ceded by the string "PIO". The PIO connection does not use a special
	    device file in the /dev directory.

     USB    A device file that is preceded by the string "USB" is treated  as  a
	    scanner  connected via the Universal Serial Bus. The correct special
	    device file has to be created prior to using it with Sane.	See  the
	    USB  documentation	for more information about how to set up the USB
	    subsystem and the required device files.

FILES
     /usr/local/lib/sane/libsane-epkowa.a
	    The static library implementing this backend.

     /usr/local/lib/sane/libsane-epkowa.so
	    The shared library implementing this  backend  (present  on  systems
	    that support dynamic loading).

ENVIRONMENT
     SANE_DEBUG_EPKOWA
	    If	the  library was compiled with debug support enabled, this envi-
	    ronment variable controls the debug level for this backend.  E.g., a
	    value of 128 requests all debug output to be printed.  Smaller  lev-
	    els reduce verbosity.

     SANE_EPSON_CMD_LVL
	    This allows to override the function or command level that the back-
	    end uses to communicate with the scanner. The function level a scan-
	    ner  supports is determined during the initialization of the device.
	    If the backend does not recognize the function level reported by the
	    scanner it will default to function level B5. Valid function  levels
	    are  A1, A2, B1, B2, B3, B4, B5, B6, B7, B8 and F5. Use this feature
	    only if you know what you are doing!

SEE ALSO
     sane-scsi(5), scanimage(1), xscanimage(1), xsane(1), sane-epson(5)

BUGS
     When used with "scanimage -T" the backend hangs after sucessfully	complet-
     ing  the tests. It is necessary to powercycle the scanner to get the commu-
     nication between backend and scanner going again.

     Sometimes the scanner is not initialized correctly. The problem can be  re-
     solved by killing the program and restarting it again.

UNSUPPORTED DEVICES
     The  backend  may be used with EPSON scanners that are not yet listed under
     the list of supported devices. A scanner that is not recognized may default
     to the function level B3, which means that not all functions that the scan-
     ner may be capable of are accessible.

     If the scanner is not even recognized as an EPSON scanner	it  is	probably
     because  the  device name eported by the scanner is not in the correct for-
     mat. Please send this information to the backend maintainer (email  address
     is  in  the AUTHORS file).devices. A scanner that is not recognized may de-
     fault to the function level B3, which means that not all functions that the
     scanner may be capable of are accessible.

     If the scanner is not even recognized as an EPSON scanner	it  is	probably
     because  the  device name eported by the scanner is not in the correct for-
     mat. Please send this information to the backend maintainer (email  address
     is in the AUTHORS file).

AUTHOR
     EPSON AVASYS Corporation

				   2008-02-07			  sane-epkowa(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sane-epkowa&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help