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