2019-10-17T10:29:39Z

2018-03-27T18:14:07Z

Zukow: /* Configuring gt68xx Scanners */

''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 please use SCANdal 1.4
*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

Latest versions of SCANdal are included in MorphOS 3.x releases in Application directory

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]]

 
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 upto version 1.4 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.

MorphOS version of SCANdal supports saving using Reggae framework (including saving DPI info if format supports it).

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]]

===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]] 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]]

Scanning preferences can be saved in project file.

== 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
|-
|hp5590
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-HP5590
|-
|lexmark
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-LEXMARK
|-
|genesys
|style="text-align: right;"|http://www.sane-project.org/sane-backends.html#S-GENESYS
|}

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 model
! Driver
! Morphos native
! Ports
! Notes
|-
| UMAX Astra 1200S
| Umax.device
| Y
| SCSI
| working without problems quite fast
|-
| Epson 1640SU
| Epson2.device
| Y
| USB 1.1/SCSI
| working without problems, fast ADF supported, TA supported
|-
| Mustek Paragon 600 II CD
| mustek.device
| N
| SCSI
| working without problems quite slow
|-
| HP ScanJet 6300C
| hp.device
| N
| USB 1.1/SCSI
| stop working after a few scans 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, 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 ===
# Epson2 driver is included in MorphOS, check MOSSYS:Devs/Scanners/
# For SCSI scanners choose valid communication device in Device field (for example symbios.device), USB scanners don't need additional settings
# In SCANdal preferences choose Epson2.device full path in Scanner Driver
# Check if SCANdal connect to the scanner if not go to the next point
#(optional, usb scanners should autoconfigure since MorphOS 3.10)
Create and 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 Device field in SCANdal preferences should be left blank.

You can also try using the driver for USB scanners without any configuration file but it may not work.
[[File:Epsonconf.png |center]]

=== Configuring gt68xx Scanners ===
# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/gt68xx.device
# Download scanner's rom and put it in s:gt68xx directory
# Set correct path for scanner driver in SCANdal preferences, choose USB type connection
# Create a configuration file s:gt68xx.conf
# Autodetect Mustek BearPaw 1200 TA and Mustek BearPaw 1200 CS
usb 0x055f 0x021e
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 ===

# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/Umax.device
# Create/copy a configuration file s:umax.conf
# Choose valid scsi device (for example symbios.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 ===
# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/Mustek_usb.device
# Set correct path for Scanner Driver in SCANdal preferences, choose USB type connection
# Download to S: [http://brain.umcs.lublin.pl/~rzookol/download/mustek_usb.conf]

=== 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 Device field in SCANdal preferences should be left blank.

=== Configuring lexmark Scanners ===
# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/
# Set correct path for Scanner Driver in SCANdal preferences, choose USB type connection
# Copy lexmark.conf to S

=== 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'''

=== Configuring Genesys Scanners ===

# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/Genesys.device
# Set correct path for Scanner Driver in SCANdal preferences, choose USB type connection

=== Configuring Hp5590 Scanners ===

# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/Hp5590.device
# Set correct path for Scanner Driver in SCANdal preferences, choose USB type connection

=== Configuring Hp3500 Scanners ===

# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/Hp3500.device
# Set correct path for Scanner Driver in SCANdal preferences, choose USB type connection

=== Configuring Fujitsu Scanners ===

# Included in MorphOS 3.10: MOSSYS:Devs/Scanners/Fujitsu.device
# Set correct path for Scanner Driver in SCANdal preferences, choose USB type connection

== 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