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:

Troubleshooting

Possible problems with KScan:

  1. Preview image and scanned image are too different
    Try turning on "Force brightness emulation" and "Force contrast emultaion" options.
  2. 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.
  3. 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.
  4. 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

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.