View source for Numériser un document avec SCANdal

[[Page_principale|Retour sur la page principale]]


''Author: Michał Żukowski''

[[File:scandal_logo.png|center]]

<center><big>[http://brain.umcs.lublin.pl/~rzookol HomePage]</big></center>



'''SCANdal''' is a graphic interface for scanner drivers in '''Betascan/SANE''' standard. It uses MUI and was ported on all Amiga-like operating systems (MorphOS, AmigaOS 4.x, AmigaOS3.x, AROS). The point of its developing was to provide their users a free software that allows them to use scanners effectively and uses advanced functions of new version of the every mentioned operating systems.   

== Requirements==
For proper use of '''SCANdal''' you need the following components to be installed in your system:
*MUI (Magic User Interface) version 3.8 or later
*urltext.mcc MUI class

For MorphOS version lower than 2.x
*Update Pack containing '''jfif.library''' and '''png.library''' as well as an '''Aboutbox.mcc''' class
*MorphOS version of this software uses advanced MUI 4.x, so it may not work properly with older MUI versions

Additionally the computer should be fitted with a proper hardware interface (SCSI or USB) to connect your scanner to. You should also have proper scanner drivers for '''Betascan''' standard installed. SCANdal as a graphic interface does not give the possibility to scan anything without proper drivers available.

==SCANdal Installation==
SCANdal is ready to run right after decompressing the archive in destination directory and doesn't copy any files into any other directories. For proper working it requires Betascan drivers in #?.device form to be present in any directory on you hard drive.

== Usage ==
===Device preferences===

* SCSI
Current scanner communication system with SCSI devices is based on two device files (#?.device). First is basic device performing sending and receiving data from and to scanner on a low (hardware) level. In MorphOS for example, in case of using SCSI card, '''symbios.device''' is created in memory. For Poseidon USB stack communication using usbwrap.class, '''usbraw.device''' is created. For older Blizzard 1230 cards device is called '''1230scsi.device'''.

Name of the device you are using, has to by typed in '''Device''' field in SCSI scanner device preferences. You can select proper file if that's the form your device exists, or select one from the list of devices present in memory. In that case, you have to tick the''' Show devices in memory''' option and select proper name.

After selection the device, you have to select the unit, which usually is a device number on SCSI bus, or user-defined number in Poseidon USB stack preferences, for usbwrap.class (when we use older 68k EpsonUSB.device). 

* USB and SCSI
Next you have to select Betascan driver file, by filling the '''Scanner driver'''. Some of the drivers require and allows you to set scanner's preferences in configuration files #?.conf. These files are placed in the S: directory.  Refer to the SANE documentation for information about the configuration files.
[[File:scandal_prefs.png|left]]
[[File:scandal_prefs2.png|none]]

<br>
In the '''Miscalaneus''' tab one can select colors for ruler and default save paths and path for Sketch plugins (i.e ''Morphos:Applications/Sketch/plugins''). Sketch plugins support requires Morphos 2.5 or later. You can also turn off bottom panel with graphics operation icons.

[[File:prefs.png|center]]

SCANdal opens the device and begins the communication during first scanning process. One can set an icon tooltype ('''AUTOCONNECT = TRUE''')  or '''Automatically  connect on startup''' checkmark , which initiates the communication with the scanner when you start the program. In addition, you can connect to the scanner by clicking on the '''Connect''' button in the '''Information''' tab. If device preferences are changed when program is running, communication with old device is closed, and program will use new device from now on. Possibility of using multiple scanners at the same time will be added in future. After proper scanner configuration, you can save the preferences using '''Settings'''->'''Use''' or '''Settings'''->'''Save''' options from menu items. Restoring previous settings is possible by using '''Settings'''->'''Load last saved''' menu item.

===Savers===

SCANdal supports graphic file formats listed below:
*'''IFF DEEP''' - uncompressed data save, 24 bits per pixel.
*'''JPEG'''  - save in 8 bits for images scanned in LineArt and Grey modes and in 24 bits if you scan in full color. For JPEG format you can set quality (1%-100%) and use progressive mode. The DPI information is saved.
*'''PNG'''  - save in 8 bits for images scanned in LineArt and Grey modes, and in 24 bits if you scan in full color. For PNG format you can set compression level (1-7). The DPI information is saved.
*'''TIFF''' - save in 8 bits for images scanned in LineArt and Grey modes, and in 24 bits if you scan in full color. For TIFF format these compression modes can be set: : NONE, PackBits, LZW, Deflate,  JPEG  (JPEG compression may not work depending of tiff.library version). The DPI information is saved.
*'''PDF''' - save in 8 bits for images scanned in LineArt and Grey modes, and in 24 bits if you scan in full color, image compression support. PDF support requires hpdf.library.

Support for PNG and JPEG formats is compiled into a program in AmigaOS4.x, AmigaOS3.x and AROS version. In MorphOS versions, SCANdal uses jfif.library and png.library libraries, so it uses less memory and takes less disk space. More savers will be added in further versions. 

Additional options:
*'''Auto suffix''' - automatically adds file extension (.deep, .jpg, .png) if user inputs filename without one
*'''Ask before overwrite''' - displays proper requester when you try to overwrite an existing file with the same name

===Loading previously scanned images===

SCANdal makes use of Reggae classes to load images and it checks images for its DPI to ensure proper printing/handling.
If Reggae decoder doesn't support DPI information or DPI information isn't saved in the picture one can select DPI from window.[[File:Dpiselect.png|center]]

For full loading support download additional Reggae decoders and demuxers from http://brain.umcs.lublin.pl/~rzookol/classes.html

===Printing===
SCANdal prints images using Turboprint (included in MorphOS) and takes care of image's DPI.

===Scanning preferences===

Scanning preferences are divided into two tabs:

#General settings in '''Preferences''' -> '''Scanner ''' tab allow to set up options like:
#*'''Resolution''' (in dots per inch - DPI) using slider or gadget with predefined vallues
#*'''Mode''' (LineArt - black and white mode, Grey - grayscale and Color - full color scanning, modes list depends of scanner abilities)[[File:scandal_scanprefs.png|center]]<br>Depending on scanner and driver function:
#*hardware Gamma correction
#*quality change
#*negative scan mode
#*scanning in preview mode, which should be faster than normal scanning mode
#*scanning speed mode
#*paper source (Flatbed/ADF/TA) 
#*halftones (works only in b-w mode for most backends)
#*threshold (works only in b-w mode for most backends)
#Scanning area settings are placed in '''Scan''' tab, additionally in preview area you can mark the desired scan area using mouse, left button double-click marks whole available area. Scan area marker frame has got white spots. Holding left mouse button over them allows you to resize or move the frame. In MorphOS version, moving mouse pointer over the spots will cause it (pointer) to change shape, so the user knows, that the resize or move options are available.[[File:scandal_frame.png|center]]

In future, scanning preferences will be saved as separate project. This function is being implemented now.

== Supported scanners ==


The following SANE backends has been ported to MorphOS:
{| class="wikitable"; text-valign: top; width: 100%;"
|-
! Backend name
! style="text-align: right;|Supported scanner list
|-
|umax
|style="text-align: right; width: 90%"|http://www.sane-project.org/sane-backends.html#S-UMAX
|-
|epson2
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-EPSON2
|-
|epson (deprecated)
|
|-
|gt68xx
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-GT68XX
|-
|plustek 
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-PLUSTEK
|-
|mustek_usb 
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-MUSTEK-USB
|-
|plustek
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-PLUSTEK
|-
|lexmark
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-LEXMARK
|}


Scanners listed as supported by these backends on http://www.sane-project.org/sane-backends.html should work. In addition, scanner drivers written for Betascan 68k work (http://aminet.net/search?query=betascan). 


'''TESTED SCANNERS'''
{| class="prettytable" style="text-align: center; text-valign: top; width: 100%"
|-
! Scanner <br>model
! Driver
! Morphos<br>native
! Ports
! Notes
|-
| UMAX Astra 1200S
| Umax.device
| Y
| SCSI 
| working without problems<br>quite fast
|-
| Epson 1640SU
| Epson2.device
| Y
| USB 1.1/SCSI
| working without problems, fast<br> ADF supported, TA supported
|-
| Mustek Paragon 600 II CD
| mustek.device
| N
| SCSI
| working without problems<br>quite slow
|-
| HP ScanJet 6300C
| hp.device
| N
| USB 1.1/SCSI
| stop working after a few scans<br>probably hardware failure
|-
| Mustek BearPaw 1200 TA
| gt68xx.device
| Y
| USB
| quite slow, TA supported, problems with quality
|-
| Plustek S24
| gt68xx.device
| Y
| USB 1.1
| gamma supported, slow warming up,<br>quality quite ok
|-
| Mustek 600 CU
| mustek_usb.device
| Y
| USB
| working without problems, MorphOS 2.7 required, gamma, preview, threshold supported
|-
| Epson Perfection 1260 Photo
| plustek.device
| Y
| USB
| TA supported, can't change color mode, can't change scanning area size - driver problem
|}


'''ADF''' - Auto Document Feeder,
'''TA''' - Transparency Adapter

=== Configuring EPSON Scanners ===
# Download epson2 driver: [http://brain.umcs.lublin.pl/~rzookol/download/epson2.lha] (08.01.2011)
# Unpack files to any directory
# For SCSI scanners choose valid communication device in Device field (for example symbios.device).
# In SCANdal preferences choose Epson2.device full path in Scanner Driver
# Copy epson2.conf to S:
* For SCSI scanners leave this file unchanged 
 #epson2.conf
 #usb prod_id vendor_id
 #usb 1208 266
 scsi EPSON
*When You use USB just comment '''scsi''' line and uncomment  '''usb 1208 266''': 
 #epson2.conf
 #usb prod_id vendor_id
 usb 1208 266
 #scsi EPSON

You have to look in poseidon preferences whether product id and vendor id match (decimal numbers). Values 1208 and 266 in this example are for Epson 1640SU only! Additionally, scanner has to be unbinded from any Poseidon usb classes (if it is binded) and <font style="color: red">Device</font> field in SCANdal preferences should be <font style="color: red">left blank.</font>
[[File:Epsonconf.png |center]]

=== Configuring gt68xx Scanners ===
# Download Driver: [http://brain.umcs.lublin.pl/~rzookol/download/gt68xx.device] (25.12.2010)
# Copy the device to any directory
# Download scanner's rom and put it in s:gt68xx directory
# Create a configuration file s:gt68xx.conf
  # Autodetect Mustek BearPaw 1200 TA and Mustek BearPaw 1200 CS
  usb 0x055f 0x021e
Additionally, scanner has to be unbinded from any Poseidon usb classes (if it is binded) and <font style="color: red">Device </font>field in SCANdal preferences should be <font style="color: red">left blank.</font>. You have to look in Poseidon preferences for your scanner product id and vendor id (hex format) or check this page for ids and roms: http://www.meier-geinitz.de/sane/gt68xx-backend/

=== Configuring UMax Scanners ===

# Download Driver: [http://aminet.net/driver/other/umax_morphos.lha]
# Copy the device to any directory
# Create/copy a configuration file s:umax.conf
# Choose valid scsi device (for example symbos.device) in SCANdal preferences Device field and appropriate Unit number.

If Your scanner doesn't work well in color mode try setting "option scan-lines" to lower value (10). It has been rewritten not to use fork() and pipe() so it's more stable than 68k version and it supports only SCSI connections.

=== Configuring mustek_usb Scanners ===
# Download Driver: [http://brain.umcs.lublin.pl/~rzookol/download/mustek_usb/mustek_usb.device] (20.01.2011)
# Copy the device to any directory
# Download to S: [http://brain.umcs.lublin.pl/~rzookol/download/mustek_usb.conf] 
# In SCANdal preferences choose mustek_usb.device full path in Scanner Driver field

=== Configuring plustek-usb Scanners ===
# Download Driver: [http://brain.umcs.lublin.pl/~rzookol/download/plustek_sane21.lha] (11.01.2011)
# Copy the plustek-usb.device to any directory
# In SCANdal preferences choose plustek-usb.device full path in Scanner Driver field
# Copy plustek.conf to S:
# Edit configuration file
 #[usb] vendor- and product-ID 
 [usb] 0x07B3 0x0017

Additionally, scanner has to be unbinded from any Poseidon usb classes (if it is binded) and <font style="color: red">Device</font> field in SCANdal preferences should be <font style="color: red">left blank.</font>

=== Configuring lexmark Scanners ===
# Download Driver: [http://brain.umcs.lublin.pl/~rzookol/download/lexmark.lha] (11.01.2011)
# Copy the lexmark.device to any directory
# In SCANdal preferences choose lexmark.device full path in Scanner Driver field
# Copy lexmark.conf to S

Additionally, scanner has to be unbinded from any Poseidon usb classes (if it is binded) and <font style="color: red">Device</font> field in SCANdal preferences should be <font style="color: red">left blank.</font>

=== Configuring canon630u Scanners ===

# Download Driver: [http://brain.umcs.lublin.pl/~rzookol/download/canon630u.lha] (30.11.2010)
# Copy the canon630u.device to any directory
# In SCANdal preferences choose canon630u.device full path in Scanner Driver field

'''THIS DRIVER HAS NOT BEEN TESTED. BE CAREFULL'''

Additionally, scanner has to be unbinded from any Poseidon usb classes (if it is binded) and <font style="color: red">Device</font> field in SCANdal preferences should be <font style="color: red">left blank.</font>

== Authors ==
;Main code:
:Michał 'rzookol' Żukowski

;email:
:rzookol at poczta.onet.pl
:rzookol at brain.umcs.lublin.pl
:rzookol / #morphos / #ppa freenode.net

;Additional code:
:Gianfranco 'ShInKurO' Gignina
:Antoine 'Czeko' Dubourg

;Icons:
:Maciej Żukowski