kopia lustrzana https://gitlab.com/sane-project/website
243 wiersze
10 KiB
HTML
243 wiersze
10 KiB
HTML
<html><body>
|
|
<a href="doc004.html"><img src=../icons/next.gif alt="Next"></a>
|
|
<a href="doc000.html"><img src=../icons/up.gif alt="Up"></a>
|
|
<a href="doc002.html"><img src=../icons/previous.gif alt="Previous"></a>
|
|
<a href="doc000.html"><img src=../icons/contents.gif alt="Contents"></a>
|
|
<hr>
|
|
|
|
<title>Using SANE</title>
|
|
<h2><a name="s2">2 Using SANE</a></h2>
|
|
|
|
<p>To start using SANE, fetch the latest version of the distribution from
|
|
the ftp directory:
|
|
<center>
|
|
<a href="ftp://ftp.mostang.com/pub/sane/"><tt>ftp://ftp.mostang.com/pub/sane/</tt></a>
|
|
</center>
|
|
|
|
<p>If you want to build the graphical-user-interface programs that come
|
|
with SANE, you will also need to fetch, build and install the GIMP or,
|
|
at a minimum, the GTK distribution. Both GIMP and GTK are available
|
|
at <a href="ftp://ftp.gimp.org/">ftp://ftp.gimp.org/</a>. GTK
|
|
is the user-interface toolkit that originally has been developed for
|
|
the GIMP, but is now being adopted by many other projects, including
|
|
SANE. Note that the SANE distribution will build just fine without
|
|
the GIMP/GTK libraries. However, that way none of the nice
|
|
graphical-user-interface programs will be built, thus taking away much
|
|
of the fun. So, unless you are building SANE for a server only, I
|
|
recommend that you install at least GTK, if not GIMP.
|
|
|
|
<p>After fetching the SANE distribution, unpack the compressed tar file
|
|
and follow the instructions in the README file. The README explains
|
|
how to build and install SANE. Also, take a look at the file called
|
|
PROBLEMS; it contains a list of known problems and their work arounds.
|
|
|
|
<p>Note that you don't have to own a scanner or a camera to play
|
|
with SANE. The distribution includes a pseudo-driver that simulates a
|
|
scanner by reading portable ``anymap'' (PNM) files. Also,
|
|
SANE is not limited to Linux. Besides Linux for Alpha, x86 and m68k,
|
|
it includes support for AIX, Digital Unix, FreeBSD, HP-UX, IRIX,
|
|
NetBSD, SCO, Solaris, SunOS, and even OS/2.
|
|
|
|
<p>After installing SANE, you should be able to type the command
|
|
<blockquote>
|
|
<pre>
|
|
scanimage --list-devices
|
|
</pre>
|
|
</blockquote>
|
|
and get the output shown below:
|
|
<blockquote><font size=-1>
|
|
<pre>
|
|
device `mustek:/dev/scanner' is a Mustek MFC-06000CZ flatbed scanner
|
|
device `pnm:0' is a Noname PNM file reader virtual device
|
|
device `pnm:1' is a Noname PNM file reader virtual device
|
|
</pre>
|
|
</font></blockquote>
|
|
|
|
As the listing shows, in this particular case, a Mustek scanner is
|
|
available under name <tt>mustek:/dev/scanner</tt> and two fake devices
|
|
called <tt>pnm:0</tt> and <tt>pnm:1</tt> are available that can be used to
|
|
read PNM files. To get list of all options for a particular device,
|
|
for example <tt>pnm:0</tt>, simply type:
|
|
<blockquote>
|
|
<pre>
|
|
scanimage --device pnm:0 --help
|
|
</pre>
|
|
</blockquote>
|
|
This will produce the help message shown in Figure <a href="doc003.html#f1">1</a>.
|
|
|
|
<p><p><a name="f1"></a>
|
|
<blockquote>
|
|
<font size=-1>
|
|
<pre>
|
|
Usage: scanimage [OPTION]...
|
|
|
|
Start image acquisition on a scanner device and write PNM image data to
|
|
standard output.
|
|
|
|
-d, --device-name=DEVICE use a given scanner device
|
|
-h, --help display this help message and exit
|
|
-L, --list-devices show available scanner devices
|
|
-v, --verbose give even more status messages
|
|
-V, --version print version information
|
|
|
|
Options specific to device `pnm':
|
|
Source Selection:
|
|
--filename <\<>string> [/tmp/input.ppm]
|
|
The filename of the image to be loaded.
|
|
Image Enhancement:
|
|
--brightness -100...100% [0]
|
|
Controls the brightness of the acquired image.
|
|
--contrast -100...100% [0]
|
|
Controls the contrast of the acquired image.
|
|
--grayify[=(yes|no)] [no]
|
|
Load the image as grayscale.
|
|
--three-pass[=(yes|no)] [no]
|
|
Simulate a three-pass scanner by returning 3 separate frames. For
|
|
kicks, it returns green, then blue, then red.
|
|
--hand-scanner[=(yes|no)] [no]
|
|
Simulate a hand-scanner. Hand-scanners often do not know the image
|
|
height a priori. Instead, they return a height of -1. Setting this
|
|
option allows one to test whether a front end can handle this
|
|
correctly.
|
|
--default-enhancements
|
|
Set default values for enhancement controls (brightness & contrast).
|
|
|
|
</pre>
|
|
</font></blockquote>
|
|
<p><center>Figure 1: Scanimage Help Message For <tt>pnm:0</tt> Pseudo-Device</center>
|
|
|
|
<p>
|
|
|
|
<p>The SANE package comes with a detailed man page that explains the
|
|
specifics of the <tt>scanimage</tt> program. As an example, suppose we
|
|
had a PPM file named <tt>input.ppm</tt>. We can use the scanimage
|
|
program to ``scan'' that image and increase its brightness by 50%
|
|
using the following command:
|
|
<blockquote>
|
|
<pre>
|
|
scanimage --device pnm --brightness 50 input.ppm > output.ppm
|
|
</pre>
|
|
</blockquote>
|
|
If you look at file <tt>output.ppm</tt> with an image viewer such as xv,
|
|
you should be able to see that <tt>output.ppm</tt> is noticeably
|
|
brighter.
|
|
|
|
<p><p><a name="f2"></a>
|
|
<center>
|
|
|
|
<img width=500 height=672 src="img000.gif">
|
|
<p><center>Figure 2: SANE Dialog Window</center>
|
|
|
|
</center>
|
|
<p>
|
|
|
|
<p><p><a name="f3"></a>
|
|
<center>
|
|
|
|
<img width=780 height=881 src="img001.gif">
|
|
<p><center>Figure 3: SANE Preview Window</center>
|
|
|
|
</center>
|
|
<p>
|
|
|
|
<p>You may say: cool, but where is the graphical user-interface?
|
|
Assuming you had the GTK libraries installed when SANE was built, you
|
|
can invoke a program called <tt>xscanimage</tt> that will present you
|
|
with a dialog box containing a list of available devices. If you
|
|
double-click on the ``pnm:0'' entry, you'll get the dialog shown in
|
|
Figure <a href="doc003.html#f2">2</a>. As you can see, the dialog includes two
|
|
text-entry boxes labeled ``Filename'' and a slider labelled
|
|
``Brightness''. If you enter <tt>output.ppm</tt> in the first text-entry
|
|
box and <tt>input.ppm</tt> in the second box and move the brightness
|
|
slider to 50.0, you can press the Scan button at the bottom left and
|
|
get the same result as with the scanimage command line shown above. Of
|
|
course, before doing the actual scanning, you could press the Preview
|
|
button at the bottom right to pop up a preview window (see
|
|
Figure <a href="doc003.html#f3">3</a>). In the preview window, you can push the
|
|
Acquire->Preview button to obtain a low-resolution preview
|
|
of the final image. For example, by moving the brightness slider
|
|
around, you can see how the brightness of the image is affected. After
|
|
moving the slider, you'll need to press the Acquire Preview button to
|
|
get an updated preview.
|
|
|
|
<p>When scanning an image with a real scanner or camera, you'll usually
|
|
want to enhance it in various ways, such as making it appear sharper.
|
|
The nice thing about the xscanimage program is that it can also be run
|
|
as a GIMP extension. To do this, simply create a symlink from the GIMP
|
|
plug-ins directory to the xscanimage binary. Assuming the SANE
|
|
installation defaults, you could do this with the following command:
|
|
<blockquote>
|
|
<pre>
|
|
ln -s /usr/local/bin/xscanimage ~/.gimp/plug-ins
|
|
</pre>
|
|
</blockquote>
|
|
|
|
<p><p><a name="f4"></a>
|
|
<center>
|
|
|
|
<img width=565 height=699 src="img002.gif">
|
|
<p><center>Figure 4: Mustek Dialog Window for <tt>xscanimage</tt></center>
|
|
|
|
</center>
|
|
<p>
|
|
|
|
<p>After making this link, xscanimage will attach itself to the GIMP's
|
|
``Xtns'' menu the next time you start it. This makes it possible to
|
|
invoke, for example, the PNM pseudo-device by selecting
|
|
``Xtns->Acquire Image->pnm:0''. When invoked in
|
|
this manner, pressing the Scan button will put the newly scanned image
|
|
inside a GIMP window (instead of saving it to disk). Now, the usual
|
|
GIMP image-manipulation functions can be used to enhance the acquired
|
|
image before saving it.
|
|
|
|
<p>The PNM pseudo-device may be fun, but what does a real scanner
|
|
interface look like? Figure <a href="doc003.html#f4">4</a> shows the xscanimage
|
|
dialog as it appears for Mustek flatbed scanners. The figure also
|
|
demonstrates another feature of xscanimage: tool tips (also known as
|
|
``balloon help''). Tool tips make it easier for new users to get
|
|
acquainted with the capabilities of their scanner or camera. In the
|
|
figure, the mouse points to the Scan Source menu and, as a result, the
|
|
help information for that menu is shown in the yellow box below the
|
|
mouse pointer. Tool tips are handy for new users, but after a while,
|
|
they tend to get in your way. Thus, xscanimage allows advanced users
|
|
to turn off the tool tips using the Preferences sub-menu.
|
|
|
|
<p><p><a name="f5"></a>
|
|
<center>
|
|
|
|
<img width=780 height=546 src="img003.gif">
|
|
<p><center>Figure 5: Mustek Dialog With Gamma Table Editor</center>
|
|
|
|
</center>
|
|
<p>
|
|
|
|
<p>As you can see, the Mustek dialog looks quite different from the PNM
|
|
pseudo-device interface. This is because the underlying devices have
|
|
different capabilities. In fact, the device dialog depends not only on
|
|
the selected device, but also on the mode of the device. For example,
|
|
when turning on the ``Use custom gamma table'' option near the bottom
|
|
of the dialog, the interface changes, and the result is shown in
|
|
Figure <a href="doc003.html#f5">5</a>. As you can see, the right half of the dialog
|
|
now contains a graph editor that allows the user to modify the
|
|
intensity, red, green or blue gamma table. In other words, xscanimage
|
|
displays precisely the options that are active or meaningful for a
|
|
given scan mode, greatly reducing the likelihood of confusing the
|
|
user.
|
|
|
|
<p>Looking at the image-intensity gamma table in the right half of the
|
|
figure, you can probably imagine that it would be rather annoying to
|
|
define the gamma tables each time you started xscanimage. Once the
|
|
ideal tables have been found, it would be nice if it were possible to
|
|
save them. For this purpose, xscanimage allows saving the current
|
|
device settings through an entry in the Preferences sub-menu. Once
|
|
saved, whenever xscanimage is started, it automatically restores the
|
|
last saved option values for that device.
|
|
|
|
<p><p><hr>
|
|
<a href="doc004.html"><img src=../icons/next.gif alt="Next"></a>
|
|
<a href="doc000.html"><img src=../icons/up.gif alt="Up"></a>
|
|
<a href="doc002.html"><img src=../icons/previous.gif alt="Previous"></a>
|
|
<a href="doc000.html"><img src=../icons/contents.gif alt="Contents"></a>
|
|
<hr>
|
|
</body></html>
|