KScan Help
This help documentation is updated on Feb 2, 1998 for KScan 0.1.1
Contents
Introduction
KScan is a scanning program for the K Desktop Environment.
It is based upon
SANE
scanner drivers. The program is distributed under the
terms of the GNU General Public License. Last modified : 2 Feb 1998.
Features
The current version is 0.1.1. In the next versions some other features
will be added, e.g. auto brightness/contrast.
The current features are:
- Scanning region selection
- Image enhancement tuning without rescaning
- Zooming
- Gamma correction
- Saving scanned images in BMP format
Troubleshooting
Possible problems with KScan:
- Preview image and scanned image are too different
Try turning on "Force brightness emulation" and "Force contrast emultaion" options.
- After choosing Options/Backend, some messages
about AGFA SnapScan appear and than KScan hangs
A common problem with SANE 0.70. Either look through SANE mailing list archives and get
patches, or "downgrade" to previous version of SANE. Or, if there is a SANE >0.70, upgrade to it.
At my system, just editing SANE configuration files didn't help.
- KScan can't even scan a preview image
Try choosing your driver in Options/Backend. If this doesn't help, try xscanimage
(from SANE distribution). If it also doesn't work, this is a SANE configuration problem.
Otherwise your driver is not compatible with KScan (most likely). If you
have a flatbed scanner and it doesn't
work with KScan, please let me know, so I can fix
KScan.
- KScan scans with wrong resolution
Try setting "Maximal DPI" option. If it doesn't help, please contact
me
Precautions
Don't make KScan suid root on a multiuser machine! Otherwise an evil user can scan some
pornography into your /etc/passwd. Even if you modify KScan in order to make it handle
permissions, bad guys may find buffer overruns in it, write shellcode, and compromise your
system.
Changes
Version 0.1.1 - 2 Feb 98
- fixed a bug in preview.cpp that resulted in incorrect
brightness/contrast settings
- lets user to play with kscan even without a scanner
- remembers the preview image
- backend features analysis
- an attempt was made to fix autoconf/automake stuff
Version 0.1 - 2 Feb 98 an initial version
Author
KScan is written by Ivan Shvedunov.
Autoconf magic, this help skeleton etc. are borrowed from khexdit 0.4 (written by Stephan Kulow),
included in kdesdk package.