236 lines
6.6 KiB
HTML
236 lines
6.6 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-dmc</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-dmc</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 13 Jul 2008<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-dmc - SANE backend for the Polaroid Digital Microscope Camera
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-dmc</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to the Polaroid Digital Microscope Camera.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
<I>special</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Where
|
|
<I>special</I>
|
|
|
|
is the UNIX path-name for the special device that corresponds to the
|
|
scanner. The special device name must be a generic SCSI device or a
|
|
symlink to such a device. Under Linux, such a device name could be
|
|
<I>/dev/sga</I>
|
|
|
|
or
|
|
<I>/dev/sge</I>,
|
|
|
|
for example.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>IMAGING MODES</H2>
|
|
|
|
The Polaroid DMC supports a number of imaging modes. This driver supports
|
|
five of the imaging modes:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><B>Full Frame</B>
|
|
|
|
<DD>
|
|
This mode corresponds to the 801-by-600 pixel full-color full-frame image.
|
|
<DT id="3"><B>Viewfinder</B>
|
|
|
|
<DD>
|
|
This mode corresponds to the 270-by-201 pixel grey-scale viewfinder image.
|
|
This image is acquired very quickly.
|
|
<DT id="4"><B>Raw</B>
|
|
|
|
<DD>
|
|
This mode corresponds to the 1599-by-600 pixel "raw" image from the
|
|
CCD. It is grey-scale, with pixels alternating horizontally between
|
|
red, green and blue stripes. The pixels are twice as high as they are
|
|
wide, so the image is distorted.
|
|
<DT id="5"><B>Thumbnail</B>
|
|
|
|
<DD>
|
|
This mode corresponds to the 80-by-60 pixel full-color thumbnail image.
|
|
<DT id="6"><B>Super Resolution</B>
|
|
|
|
<DD>
|
|
This image is a 1599-by-1200 pixel full-color image constructed by filtering
|
|
and interpolating the "raw" image. The filtering and interpolation is
|
|
done in software, so this mode is very slow. Also, this mode places
|
|
restrictions on how the image is read which means that the "preview" mode
|
|
of xscanimage does not work in Super Resolution mode. (xcam and the
|
|
non-preview modes of scanimage and xscanimage work fine, however.)
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OTHER SETTINGS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><B>ASA Setting</B>
|
|
|
|
<DD>
|
|
This setting adjusts the camera's sensitivity. You can choose one of
|
|
25, 50, or 100 "equivalent" ASA.
|
|
<DT id="8"><B>Shutter Speed</B>
|
|
|
|
<DD>
|
|
You can select a shutter speed from 8 to 1000 milliseconds. The shutter
|
|
speed is quantized in units of 32 microseconds.
|
|
<DT id="9"><B>White Balance</B>
|
|
|
|
<DD>
|
|
You can choose one of "Daylight", "Incandescent" or "Fluorescent"
|
|
white balances. This setting more-or-less corresponds to the
|
|
"Color Temperature" settings on Polaroid's Windows and Mac software.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The contents of the
|
|
<I>dmc.conf</I>
|
|
|
|
file is a list of device names that correspond to DMC
|
|
scanners. Empty lines and lines starting with a hash mark (#) are
|
|
ignored. A sample configuration file is shown below:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="10"><DD>
|
|
/dev/scanner
|
|
<BR>
|
|
|
|
# this is a comment
|
|
<BR>
|
|
|
|
/dev/sge
|
|
</DL>
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="11"><I>@CONFIGDIR@/dmc.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="12"><I>@LIBDIR@/libsane-dmc.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="13"><I>@LIBDIR@/libsane-dmc.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14"><B>SANE_CONFIG_DIR</B>
|
|
|
|
<DD>
|
|
This environment variable specifies the list of directories that may
|
|
contain the configuration file. Under UNIX, the directories are
|
|
separated by a colon (`:'), under OS/2, they are separated by a
|
|
semi-colon (`;'). If this variable is not set, the configuration file
|
|
is searched in two default directories: first, the current working
|
|
directory (".") and then in @CONFIGDIR@. If the value of the
|
|
environment variable ends with the directory separator character, then
|
|
the default directories are searched after the explicitly specified
|
|
directories. For example, setting
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
to "/tmp/config:" would result in directories "tmp/config", ".", and
|
|
"@CONFIGDIR@" being searched (in this order).
|
|
<DT id="15"><B>SANE_DEBUG_DMC</B>
|
|
|
|
<DD>
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the debug level for this backend. E.g.,
|
|
a value of 128 requests all debug output to be printed. Smaller
|
|
levels reduce verbosity.
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
In the "Full Frame" and "Raw" modes, images must be read in units
|
|
of entire lines. The driver performs no buffering in these modes;
|
|
if you ask sane_read to read a non-integral number of lines, it
|
|
may read less than you ask for. If you ask sane_read to read
|
|
less than a single line, it returns SANE_STATUS_INVAL.
|
|
<P>
|
|
|
|
In the "Super Resolution" mode, images must be read in units of
|
|
<I>two</I> lines (3198 pixels or 9594 bytes.) If you try to read less
|
|
than two lines, you get SANE_STATUS_INVAL. The Super Resolution mode
|
|
is very slow.
|
|
<P>
|
|
|
|
In the "Viewfinder" and "Thumbnail" modes, the entire image must
|
|
be read in one SCSI transfer. In this case, the driver performs
|
|
buffering and you can read the image in as small an increment as you
|
|
like.
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+sane">sane</A>(7), <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5)
|
|
<A NAME="lbAL"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
David F. Skoll
|
|
<P>
|
|
|
|
The backend is derived from
|
|
<B>sane-hp</B>
|
|
|
|
by David Mosberger
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="17"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="18"><A HREF="#lbAD">DEVICE NAMES</A><DD>
|
|
<DT id="19"><A HREF="#lbAE">IMAGING MODES</A><DD>
|
|
<DT id="20"><A HREF="#lbAF">OTHER SETTINGS</A><DD>
|
|
<DT id="21"><A HREF="#lbAG">CONFIGURATION</A><DD>
|
|
<DT id="22"><A HREF="#lbAH">FILES</A><DD>
|
|
<DT id="23"><A HREF="#lbAI">ENVIRONMENT</A><DD>
|
|
<DT id="24"><A HREF="#lbAJ">BUGS</A><DD>
|
|
<DT id="25"><A HREF="#lbAK">SEE ALSO</A><DD>
|
|
<DT id="26"><A HREF="#lbAL">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:04 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|