Xsane
Description:	A scanner driver for AmiCygnix
Download:	xsane.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	46Mb
Version:	0.999
Date:	08 Dec 19
Author:	Oliver Rauch <Oliver.Rauch@xsane.org> - OS4 port by Edgar Schwan
Submitter:	Edgar Schwan
Email:	eds/amicygnix de
Homepage:	http://www.amicygnix.de
Requirements:	AmigaOS 4.1, AmiCygnix V1.4, libusb 0.1.12
Category:	driver/misc
Replaces:	driver/misc/xsane.lha
License:	GPL
Distribute:	yes
Min OS Version:	4.1
FileID:	11067
Snapshots:
Comments:	12
Snapshots:	5
Videos:	0
Downloads:	4  (Current version)
	4  (Accumulated)

This is a port of the Linux scanner software "XSane" to AmiCygnix. In this
package the sane backends version 1.0.27 are included.
Compared to the first release of the package "XSane-0.998" many new scanners are
supported and several backends were bugfixed (See list of backends).

New is the backend "hpaio" from the driver software "hplip" by Hewlett-Packard
in the (at the moment latest) version 3.19.8. This adds support of over 500
scanners or all-in-one devices from this manufacturer.
Unfortunately, the data transfer via USB does not work here. The device must
have a network connection (LAN / W-LAN) and be connected to it. This is
basically recommended for performance reasons.
=> Please note the hints below!

At the moment only scanners with USB connector and network interface are
supported. But this should be the majority of the available scanners.

Please notice:

Because of software problems (OS4 USB stack) and hardware problems (articia
bug), the data transfer can freeze sometimes. Also it was reported, that the
whole system can freeze, if you plug in a scanners USB connector. Please keep
this in mind, if you consider to buy a new scanner!


Homepages: http://www.xsane.org
           http://www.sane-project.org
           https://developers.hp.com/hp-linux-imaging-and-printing


Features of XSane
------------------

  * Display an image in a viewer.
  * Saves images in these picture formats:
    - JPEG
    - PDF
    - PNG
    - PNM
    - PS
    - TIFF
  * Convert images into ASCII text using the OCR software "gocr". The program
    gocr V0.52 is incuded in this package.
  * Do a photocopy - send a scanned image to the printer.
  * Create multipage documents (PDF, PS, TIFF).
  * Send a fax - needs an external command like "sendfax" (not included).
  * Send a scanned image by e-mail. Needs the external command "sendmail" (not
    included)
  * Color managemant (CMS).
  * Batch processing
  * Can be used as a gimp plug-in.
  * And much more...


Backends
--------

  Following backends (scanner driver) from the sane backends package 1.0.27 are
  included. The backends marked with a '*' were bugfixed since the release of
  the previous package "sane-frontends".

  Important: A backend for a certain manufacturer can also support other
             manufacturers.

    Name                             Supports also

  - artec_eplus48u (Artec/Ultima)    Medion/Lifetec/Tevion/Cytron, Memorex,
                                     Microstar, Trust, Umax, Yakumo

    Important: Needs additional firmware file. See "Cygnix:CygnixPPC/gtk2.24/
               share/man/man5/sane-artec_eplus48u.5". Please copy to "Cygnix:
               CygnixPPC/gtk2.24/share/sane/artec_eplus48u".

  - avision                          Bell+Howell, Fujitsu, Hewlett-Packard,
                                     iVina, Kodak, Kyocera, Minolta, Mitsubishi,
                                     OKI, Visioneer, Xerox

  - canon630u

  - canon_dr

  - cardscan (Corex)

  - coolscan2 (Nikon)

  - coolscan3 (Nikon)

  - dell1600n_net

  - epjitsu                          Fujitsu

    Important: Needs additional firmware file. See "Cygnix:CygnixPPC/gtk2.24/
               share/man/man5/sane-epjitsu.5". Please copy to "Cygnix:
               CygnixPPC/gtk2.24/share/sane/epjitsu".

  - epson

  - epson2

  - epsonds

  - fujitsu

  - genesys *                        Canon, DCT, Hewlett-Packard, Medion/
                                     Lifetec/Tevion/Cytron, Panasonic, Pentax,
                                     Plustek, Syscan, Visioneer, Xerox

  - gt68xx                           Artec/Ultima, Boeder, Fujitsu, Genius,
                                     Googlegear, Lexmark, Medion/Lifetec/Tevion/
                                     Cytron, Mustek, NeatReceipts, Nortek,
                                     Packard Bell, Plustek, RevScan, Trust,
                                     Visioneer

    Important: Needs additional firmware file. See "Cygnix:CygnixPPC/gtk2.24/
               share/man/man5/sane-gt68xx.5". Please copy to "Cygnix:
               CygnixPPC/gtk2.24/share/sane/gt68xx".

  - hp

  - hp3500

  - hp3900                           BenQ, Umax

  - hp4200

  - hp5400

  - hp5590

  - hpljm1005

  - kvs1025 (Panasonic)

  - kvs20xx (Panasonic)

  - lexmark                          Dell

  - ma1509                           Fujitsu, Mustek

  - magicolor (Konica Minolta)
              (supports SNMP)

  - microtek2                        Genius, ScanPort, Vobis

  - mustek_usb                       Trust

  - mustek_usb2

  - net
                                     Agfa, Hewlett-Packard, Trust
  - niash

  - pieusb                           Reflecta

  - pixma (Canon)

  - plustek *                        Ambir, Canon, Compaq, Epson, Genius,
                                     Hewlett-Packard, Mustek, Portable
                                     Peripheral Co., Ltd., Syscan, Umax,
                                     Visioneer

  - rts8891                          Hewlett-Packard, Umax

  - sm3600 (Microtek)

  - sm3840 (Microtek)

  - snapscan                         Agfa, BenQ (Acer), Epson, Guillemot /
                                     Hercules, Mitsubishi

    Important: Needs additional firmware file. See "Cygnix:CygnixPPC/gtk2.24/
               share/man/man5/sane-snapscan.5". Please copy to "Cygnix:
               CygnixPPC/gtk2.24/share/sane/snapscan".

  - stv680                           Aiptek, Creative, Digital Dream, Konica

  - test

  - u12                              Genius, Plustek, RevScan

  - umax

  - umax1220u

  - xerox_mfp                        Dell, Samsung


  Additionally included are backends of the following manufacturers:

  - Hewlett-Packard (hpaio / hplip)

    Important notes:

    * As described above, the hpaio backend works only with scanners connected
      to the network. When starting XSane, such a scanner is usually detected
      automatically. This presupposes, however, that the "Bonjour" or the
      "AirLink" service is activated in the printer's settings, as mDNS is used
      for the detection. Detection using SNMP seems not to work.

    * Sometimes the device is still not recognized. For this purpose, the
      program "HPLIP-Selector" was developed, which can be found in the direc-
      tory "Cygnix:Software/XSane-0.999". There, the connected model can be
      selected in a list. After entering the device IP and saving the settings,
      XSane starts directly with this driver without the selection of found
      scanner appears.

      WATCH OUT:

      Please pay attention to the correct selection of the model !!! For damage
      to the device, I assume no liability!

    * Some models require external plugins that are only available in binary
      form for Linux. Even if these devices are found, they will not work. The
      program "HPLIP-Selector" filters these out automatically.

      This mainly applies to scanners that require support for one of the
      following scan protocols:

      * SOAP1
      * Marvell
      * SOAP2
      * ESCL
      * ORBLITE

      On the other hand, the following protocols should work:

      * SCL
      * PML
      * Duplex SCL
      * LEDM
      * Marvell2

  - Epson (epkowa / iscan)

    Important: Many of the scanners supported by the epkowa backend do need
               an external library provided by Epson. The sources of these
               libraries are not available, so they cannot be compiled for OS4.
               Please have a look at the file "Cygnix:CygnixPPC/gtk2.24/share/
               iscan-data/epkowa.desc".

  More informations about these backends you can find on the Sane homepage
  http://www.sane-project.org or in the directory "Cygnix:Software/XSane-0.999/
  doc".


Additional software
-------------------

  These programs are included:

  * scanimage

    A commandline frontend for Sane. More informations in the man file
    "Cygnix:CygnixPPC/gtk2.24/share/man/man1/scanimage.1".

  * sane-find-scanner

    Tests, if a scanner is basically detected by Sane. For a real support
    a corresponding backend must exist.
    See man file "Cygnix:CygnixPPC/gtk2.24/share/man/man1/sane-find-scanner.1".

  * gamma4scanimage

    Creates a gamma table for "scanimage".
    See man file "Cygnix:CygnixPPC/gtk2.24/share/man/man1/gamma4scanimage.1".

  * saned

    A Sane daemon that allows remote clients to access image acquisition devices
    available on the local host.
    Works only in debug mode (call "Cygnix:CygnixPPC/gtk2.24/sbin/saned -d").
    See man file "Cygnix:CygnixPPC/gtk2.24/share/man/man8/saned.8".

  * gocr

    Converts an image into text (version 0.52).
    See man file "Cygnix:CygnixPPC/man/man1/gocr.1".

  Hint: The man files can be viewed with "xman", accessible via the desktop
        panel.


Tested scanners
---------------

  Current version (backends 1.0.27 and "XSane 0.999"):

    * HP OfficeJet 6950 All-in-One:
                             Was found automatically and works (hpaio)

    * HP Officejet Pro 8175 All-in-One Printer;
                             Works, but was not automatically detected. Must be
                             activated via the program "HPLIP selector". (hpaio)

    * HP Envy 4528 All-in-One Printer:
                             Works, but was not automatically detected. Must be
                             activated via the program "HPLIP selector". Here
                             please select "HP Envy 4524 All-in-One Printer".
                             (hpaio)

    * Canon LiDE 110: Works (genesys)

                      Important: Please make sure, that the bit depth is set to
                                 8 bit!
                                 To calibrate the scanner, please scan the
                                 provided calibration sheet before you scan any
                                 other things! (See sane-genesys.5 man file)

    * Epson Perfection 3200 Photo (GT-9800): Works. (epson, epson2, epkowa)


  Backends 1.0.23 and "XSane 0.999":

    * Canon LiDE 30: Works (plustek)

    * Canon LiDE 110: Works (genesys)

                      Important: Please make sure, that the bit depth is set to
                                 8 bit!
                                 To calibrate the scanner, please scan the
                                 provided calibration sheet before you scan any
                                 other things! (See sane-genesys.5 man file)

    * Canon LiDE 200: Mostly works (genesys)

                      It was reported, that the scanning procedure is very
                      noisy while scanning in 600 dpi - 300 dpi was O.K.

                      Important: Please make sure, that the bit depth is set to
                                 8 bit!
                                 To calibrate the scanner, please scan the
                                 provided calibration sheet before you scan any
                                 other things! (See sane-genesys.5 man file)

    * Canon Pixma MP620: Works (pixma)

    * Epson Perfection 1650 Photo: Works (epson, epson2, epkowa)

    * Epson Perfection 3200 Photo (GT-9800): Works. (epson, epson2, epkowa)


  Backends 1.0.22 and "XSane 0.998":

    * Canon LiDE 30: Works (plustek)

    * Epson Perfection 3200 Photo (GT-9800): Works. (epson, epson2, epkowa)

    * Epson Perfection 1650 Photo: Works (epson, epson2, epkowa)

    * Canon LiDE 20: Didn't work, but it seems not to be the fault of XSane.
                     Please try! (plustek)

    * Canon LiDE 200: Didn't work. (genesys, SAM 460ex)


  Backends 1.0.20 and "sane-frontends":

    * Epson Perfection 1660 Photo: Was not recognized by xscanimage. Please
                                   try again with this version!

    * Xerox Phaser 6180MFP: Was recognized, but was not supported by backends
                            1.0.20.

    * CanoScan 4400f: Was recognized, but was not supported by backends
                      1.0.20.

    * HP Officejet 7410 All-in-one: System crashed after plug in the USB cable
                                    (SAM 440).

    * Mustek ScanExpress 1200 UB Plus: System freezed after plug in the USB
                                       cable (AmigaOne XE).


Installation
------------

  The X11 environment AmiCygnix version 1.4 (or higher) must be installed
  before! AmiCygnix is available on OS4-depot (http://os4depot.net).

  To install the package, just click on the "Install"-icon. The data will be
  installed into the AmiCygnix package. Afterwards you can find the programs in
  "Cygnix:Software".


Donations
---------

  If you like to support my work, you can make a donation by using paypal:

   http://www.schwan-clan.de/amiga/Donate.html

  Thanks!


Thanks to...
------------

  ... Hans Verkuil for his initial port of X11R6.3 to OS 3.x
  ... Pål Ringkilen (beta testing and for his LiDE 110 scanner!)
  ... Thomas Blatt for icons and testing
  ... Michael Christoph for testing
  ... Gero Birkenfeld (beta testing)
  ... aclogic (beta testing)
  ... Chris Young (beta testing)
  ... Frank Tully (beta testing)
  ... Paul E. Bloedel (beta testing)
  ... Paul R. Zager (beta testing)
  ... Kees Marijnsen (beta testing)
  ... Rene W. Olsen (libusb)