Debian Codegraph @

upstream/debian-unstable/man5/sane-dmc.5

raw
1 .TH sane\-dmc 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-dmc
3 .SH NAME
4 sane\-dmc \- SANE backend for the Polaroid Digital Microscope Camera
5 .SH DESCRIPTION
6 The
7 .B sane\-dmc
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to the Polaroid Digital Microscope Camera.
10 .SH "DEVICE NAMES"
11 This backend expects device names of the form:
12 .PP
13 .RS
14 .I special
15 .RE
16 .PP
17 Where
18 .I special
19 is the UNIX path-name for the special device that corresponds to the
20 scanner. The special device name must be a generic SCSI device or a
21 symlink to such a device. Under Linux, such a device name could be
22 .I /dev/sga
23 or
24 .IR /dev/sge ,
25 for example.
26 .SH IMAGING MODES
27 The Polaroid DMC supports a number of imaging modes. This driver supports
28 five of the imaging modes:
29 .PP
30 .TP
31 .B Full Frame
32 This mode corresponds to the 801-by-600 pixel full-color full-frame image.
33 .TP
34 .B Viewfinder
35 This mode corresponds to the 270-by-201 pixel grey-scale viewfinder image.
36 This image is acquired very quickly.
37 .TP
38 .B Raw
39 This mode corresponds to the 1599-by-600 pixel "raw" image from the
40 CCD. It is grey-scale, with pixels alternating horizontally between
41 red, green and blue stripes. The pixels are twice as high as they are
42 wide, so the image is distorted.
43 .TP
44 .B Thumbnail
45 This mode corresponds to the 80-by-60 pixel full-color thumbnail image.
46 .TP
47 .B Super Resolution
48 This image is a 1599-by-1200 pixel full-color image constructed by filtering
49 and interpolating the "raw" image. The filtering and interpolation is
50 done in software, so this mode is very slow. Also, this mode places
51 restrictions on how the image is read which means that the "preview" mode
52 of
53 .BR xscanimage (1)
54 does not work in Super Resolution mode.
55 .RB ( xcam (1)
56 and the non-preview modes of
57 .BR scanimage (1)
58 and
59 .BR xscanimage (1)
60 work fine, however.)
61 .PP
62 .SH OTHER SETTINGS
63 .TP
64 .B ASA Setting
65 This setting adjusts the camera's sensitivity. You can choose one of
66 25, 50, or 100 "equivalent" ASA.
67 .TP
68 .B Shutter Speed
69 You can select a shutter speed from 8 to 1000 milliseconds. The shutter
70 speed is quantized in units of 32 microseconds.
71 .TP
72 .B White Balance
73 You can choose one of "Daylight", "Incandescent" or "Fluorescent"
74 white balances. This setting more-or-less corresponds to the
75 "Color Temperature" settings on Polaroid's Windows and Mac software.
76 .SH CONFIGURATION
77 The contents of the
78 .I dmc.conf
79 file is a list of device names that correspond to DMC
80 scanners. Empty lines and lines starting with a hash mark (#) are
81 ignored. A sample configuration file is shown below:
82 .PP
83 .RS
84 /dev/scanner
85 .br
86 # this is a comment
87 .br
88 /dev/sge
89 .RE
90 .SH FILES
91 .TP
92 .I /etc/sane.d/dmc.conf
93 The backend configuration file (see also description of
94 .B SANE_CONFIG_DIR
95 below).
96 .TP
97 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-dmc.a
98 The static library implementing this backend.
99 .TP
100 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-dmc.so
101 The shared library implementing this backend (present on systems that
102 support dynamic loading).
103 .SH ENVIRONMENT
104 .TP
105 .B SANE_CONFIG_DIR
106 This environment variable specifies the list of directories that may
107 contain the configuration file. On *NIX systems, the directories are
108 separated by a colon (`:'), under OS/2, they are separated by a
109 semi-colon (`;'). If this variable is not set, the configuration file
110 is searched in two default directories: first, the current working
111 directory (".") and then in
112 .IR /etc/sane.d .
113 If the value of the environment variable ends with the directory separator
114 character, then the default directories are searched after the explicitly
115 specified directories. For example, setting
116 .B SANE_CONFIG_DIR
117 to "/tmp/config:" would result in directories
118 .IR "tmp/config",
119 .IR ".",
120 and
121 .I "/etc/sane.d"
122 being searched (in this order).
123 .TP
124 .B SANE_DEBUG_DMC
125 If the library was compiled with debug support enabled, this
126 environment variable controls the debug level for this backend. E.g.,
127 a value of 128 requests all debug output to be printed. Smaller
128 levels reduce verbosity.
129 .SH BUGS
130 In the "Full Frame" and "Raw" modes, images must be read in units
131 of entire lines. The driver performs no buffering in these modes;
132 if you ask sane_read to read a non-integral number of lines, it
133 may read less than you ask for. If you ask sane_read to read
134 less than a single line, it returns SANE_STATUS_INVAL.
135 .PP
136 In the "Super Resolution" mode, images must be read in units of
137 \fItwo\fR lines (3198 pixels or 9594 bytes). If you try to read less
138 than two lines, you get SANE_STATUS_INVAL. The Super Resolution mode
139 is very slow.
140 .PP
141 In the "Viewfinder" and "Thumbnail" modes, the entire image must
142 be read in one SCSI transfer. In this case, the driver performs
143 buffering and you can read the image in as small an increment as you
144 like.
145
146 .SH "SEE ALSO"
147 .BR sane (7),
148 .BR sane\-scsi (5)
149
150 .SH AUTHOR
151 Dianne Skoll <[email protected]>
152 .PP
153 The backend is derived from
154 .BR sane\-hp (5)
155 by David Mosberger.