This file is indexed.

/usr/share/sane/xsane/doc/sane-xsane-preview-doc.html is in xsane-common 0.999-3ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="Author" content="Oliver Rauch">
   <meta name="Description" content="scan, photocopy and fax frontend for SANE">
   <title>XSane - Preview window</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">


<table>
<tr>
<td width=200>
<img SRC="xsane-logo.jpg" alt="XSane-logo" hspace=30 align=TOP>
</td>
<td>
<blockquote>
<h1><font color="#009900">Preview window</font></h1>
</blockquote>

</td>
</tr>
</table>


<hr WIDTH="100%">

<table>
<tr>
<td valign=TOP width="200" bgcolor="#E0E0BA">
<br>
<a href="sane-xsane-doc.html">Index</a>
<br>
<br>
<font color="#000000">XSane mode:</font>
<img SRC="xsane-target.jpg" alt="xsane-target">
<ul>
<li><a href="sane-xsane-viewer-doc.html">Viewer mode</a></li>
<li><a href="sane-xsane-save-doc.html">Save mode</a></li>
<li><a href="sane-xsane-copy-doc.html">Copy mode</a></li>
<li><a href="sane-xsane-multipage-doc.html">Multipage mode</a></li>
<li><a href="sane-xsane-fax-doc.html">Fax mode</a></li>
<li><a href="sane-xsane-email-doc.html">E-mail mode</a></li>
<li><a href="sane-xsane-gimp-doc.html">Gimp plugin</a></li>
</ul>
<br>
<a href="sane-xsane-scan-options-doc.html">Scan options</a>
<br>
<br>
<a href="sane-xsane-medium-definition-doc.html">Medium selection</a>
<br>
<br>
<a href="sane-xsane-color-management-doc.html">Color management</a>
<br>
<br>
<a href="sane-xsane-color-correction-doc.html">Color correction:</a>
<ul>
<li><a href="sane-xsane-color-correction-doc.html#GAMMA">Gamma correction</a></li>
<li><a href="sane-xsane-color-correction-doc.html#BRIGHTNESS">Brightness</a></li>
<li><a href="sane-xsane-color-correction-doc.html#CONTRAST">Contrast</a></li>
<li><a href="sane-xsane-color-correction-doc.html#THRESHOLD">Threshold</a></li>
<li><a href="sane-xsane-color-correction-doc.html#RGB_DEFAULT">RGB default</a></li>
<li><a href="sane-xsane-color-correction-doc.html#NEGATIVE">Negative</a></li>
<li><a href="sane-xsane-color-correction-doc.html#AUTOENHANCEMENT">Autoenhancement</a></li>
<li><a href="sane-xsane-color-correction-doc.html#ENHANCEMENT_DEFAULT">Default</a></li>
<li><a href="sane-xsane-color-correction-doc.html#RESTORE_ENHANCEMENT">Restore</a></li>
<li><a href="sane-xsane-color-correction-doc.html#STORE_ENHANCEMENT">Store</a></li>
<li><a href="sane-xsane-histogram-doc.html">Histogram window</a></li>
<li><a href="sane-xsane-preview-doc.html#PIPETTE_WHITE">Pipette functions</a></li>
</ul>
<br>
<a href="sane-xsane-standard-doc.html">Standard options window</a>
<br>
<br>
<a href="sane-xsane-advanced-doc.html">Advanced options window</a>
<br>
<br>
<a href="sane-xsane-preview-doc.html">Preview:</a>
<ul>
<li><a href="sane-xsane-preview-doc.html#PIPETTE_WHITE">Pipette white</a></li>
<li><a href="sane-xsane-preview-doc.html#PIPETTE_GRAY">Pipette gray</a></li>
<li><a href="sane-xsane-preview-doc.html#PIPETTE_BLACK">Pipette black</a></li>
<li><a href="sane-xsane-preview-doc.html#UNZOOM">Unzoom</a></li>
<li><a href="sane-xsane-preview-doc.html#ZOOM_OUT">Zoom out</a></li>
<li><a href="sane-xsane-preview-doc.html#ZOOM_IN">Zoom in</a></li>
<li><a href="sane-xsane-preview-doc.html#UNDO_ZOOM">Undo zoom</a></li>
<li><a href="sane-xsane-preview-doc.html#AUTOSELECT">Autoselect scanarea</a></li>
<li><a href="sane-xsane-preview-doc.html#AUTORAISE">Autoraise scanarea</a></li>
<li><a href="sane-xsane-preview-doc.html#SELECT_VISIBLE_AREA">Select visible area</a></li>
<li><a href="sane-xsane-preview-doc.html#DELETE_PREVIEW_CACHE">Delete preview cache</a></li>
<li><a href="sane-xsane-preview-doc.html#PRESET_AREA">Preset area</a></li>
<li><a href="sane-xsane-preview-doc.html#ROTATION">Rotation</a></li>
<li><a href="sane-xsane-preview-doc.html#ASPECT_RATIO">Aspect ratio</a></li>
<li><a href="sane-xsane-preview-doc.html#RGB_VALUES">RGB values</a></li>
<li><a href="sane-xsane-preview-doc.html#SELECT_SCAN_AREA">Select scanarea</a></li>
<li><a href="sane-xsane-preview-doc.html#MOVE_SCAN_AREA">Move scanarea</a></li>
</ul>
<br>
<a href="sane-xsane-batch-scan-doc.html">Batch scan:</a>
<ul>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_EMPTY">Empty batch list</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_OPEN">Open batch list</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_SAVE">Save batch list</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_ADD">Add area to list</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_DELETE">Remove selection</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_RENAME">Rename selection</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_ROTATE">Rotate image</a></li>
<li><a href="sane-xsane-batch-scan-doc.html#BATCH_SCAN_MIRROR">Mirror image</a></li>
</ul>
<br>
<font color="#000000">Setup:</font>
<ul>
<li><a href="sane-xsane-setup-copy-doc.html">Copy setup</a></li>
<li><a href="sane-xsane-setup-display-doc.html">Display setup</a></li>
<li><a href="sane-xsane-setup-enhancement-doc.html">Enhancement setup</a></li>
<li><a href="sane-xsane-setup-fax-doc.html">Fax setup</a></li>
<li><a href="sane-xsane-setup-filetype-doc.html">Filetype setup</a></li>
<li><a href="sane-xsane-setup-email-doc.html">E-mail setup</a></li>
<li><a href="sane-xsane-setup-save-doc.html">Saving setup</a></li>
<li><a href="sane-xsane-setup-color-management-doc.html">Color management setup</a></li>
</ul>
</td>



<td VALIGN=TOP BGCOLOR="#FFFFFF">
<blockquote>
<br>
The preview window is to select an area that you want to scan. You can
resize the preview window and zoom into the scan area.
<br>
<br>
<br>
<center><img SRC="xsane-preview.jpg" alt="preview-window"></center>
<br>
<blockquote>
<br>With the smaller, black/white dashed frame in the preview you select the
area that shall be scanned. The larger, red/green dashed frame is only
available in COPY-mode and in FAX-mode. It shows
the size of the page of the selected printer relative to the zoom scale.
</blockquote>

<img SRC="xsane-batch-scan-add.jpg" alt="batch-scan-add">
&nbsp;&nbsp;
<a NAME="BATCH_SCAN_ADD"></a><b><u>Batch scan add area:</u></b>
<blockquote>
Adds the selected area to the batch scan list.
</blockquote>

<img SRC="xsane-pipette-white.jpg" alt="pipette-white">
&nbsp;&nbsp;
<a NAME="PIPETTE_WHITE"></a><b><u>Pipette white:</u></b>
<blockquote>
Use mouse pointer and click a point that shall be white. If
you use the left mouse button only the intensity is used to calculate the
white point. If <i>RGB default</i> (main window) is not activated you can
use the middle mouse button to define the white point for each color component.
You can abort the selection by pressing the right mouse button.
</blockquote>

<img SRC="xsane-pipette-gray.jpg" alt="pipette-gray">
&nbsp;&nbsp;
<a NAME="PIPETTE_GRAY"></a><b><u>Pipette gray:</u></b>
<blockquote>
Use mouse pointer and click a point that shall be medium gray. If you use
the left mouse button only the intensity is used to calculate the gray
point. If <i>RGB default</i> (main window) is not activated you can use
the middle mouse button to define the gray point for each color component.
You can abort the selection by pressing the right mouse button.
</blockquote>

<img SRC="xsane-pipette-black.jpg" alt="pipette-black">
&nbsp;&nbsp;
<a NAME="PIPETTE_BLACK"></a><b><u>Pipette black:</u></b>
<blockquote>
Use mouse pointer and click a point that shall be black. If you use the
left mouse button only the intensity is used to calculate the black point.
If <i>RGB default</i> (main window) is not activated you can use the middle
mouse button to define the black point for each color component. You can
abort the selection by pressing the right mouse button.
</blockquote>

<img SRC="xsane-zoom-not.jpg" alt="zoom-not">
&nbsp;&nbsp;
<a NAME="UNZOOM"></a><b><u>Unzoom:</u></b>
<blockquote>
Use full scan area.
</blockquote>

<img SRC="xsane-zoom-out.jpg" alt="zoom-out">
&nbsp;&nbsp;
<a NAME="ZOOM_OUT"></a><b><u>Zoom out:</u></b>
<blockquote>
Increase preview area by 20%.
</blockquote>

<img SRC="xsane-zoom-in.jpg" alt="zoom-in">
&nbsp;&nbsp;
<a NAME="ZOOM_IN"></a><b><u>Zoom in:</u></b>
<blockquote>
Zoom into selected area.
</blockquote>

<img SRC="xsane-zoom-undo.jpg" alt="zoom-undo">
&nbsp;&nbsp;
<a NAME="UNDO_ZOOM"></a><b><u>Undo zoom:</u></b>
<blockquote>
Undo last zoom.
</blockquote>

<img SRC="xsane-autoselect.jpg" alt="autoselect">
&nbsp;&nbsp;
<a NAME="AUTOSELECT"></a><b><u>Autoselect:</u></b>
<blockquote>
Select part with image(s).
</blockquote>

<img SRC="xsane-autoraise_scanarea.jpg" alt="autoraise">
&nbsp;&nbsp;
<a NAME="AUTORAISE"></a><b><u>Autoraise:</u></b>
<blockquote>
Click to an image and the image will be selected.
</blockquote>

<img SRC="xsane-visible-area.jpg" alt="select-visible-area">
&nbsp;&nbsp;
<a NAME="SELECT_VISIBLE_AREA"></a><b><u>Select visible area:</u></b>
<blockquote>
Select the visible area in the preview window for scanning.
</blockquote>

<img SRC="xsane-delete-preview-cache.jpg" alt="delete-preview-image-cache">
&nbsp;&nbsp;
<a NAME="DELETE_PREVIEW_CACHE"></a><b><u>Delete preview image cache:</u></b>
<blockquote>
Delete all images in the preview cache. When you did change anything on
the scanning surface you should press this button to make sure that
you do not use old preview images.
</blockquote>

<img SRC="xsane-preset-area.jpg" alt="preset-area">
&nbsp;&nbsp;
<a NAME="PRESET_AREA"></a><b><u>Preset area:</u></b>
<blockquote>
Select a sub surface of the scan surface as maximum scan area.
The defined areas are relative to the surface of the scanner.
<br>
The list of preset areas can be edited by the user:
<br>
<br>
<b>Add active preview area selection:</b>
<ul>
<li>Open the menu with a short click with the left mouse button.</li>
<li>Move the mouse pointer to the position where you want to add the new entry.</li>
<li>Press and hold the right mouse button to open the context menu</li>
<li>Select <i>Add selection to list</i>
<br>
<br>
<img SRC="xsane-preset-area-context-menu.jpg" alt="add selection to list">
<br>
<br>
</li>
</ul>
<b>Rename, reorder or delete an existing item:</b>
<ul>
<li>Open the menu with a short click with the left mouse button.</li>
<li>Move the mouse pointer to the item you like to edit.</li>
<li>Press and hold the right mouse button to open the context menu</li>
<li>Select the function you like to execute
<br>
<br>
<img SRC="xsane-preset-area-context-menu.jpg" alt="edit selection">
<br>
<br>
</li>
</ul>
</blockquote>

<img SRC="xsane-rotation.jpg" alt="rotation">
&nbsp;&nbsp;
<a NAME="ROTATION"></a><b><u>Rotation:</u></b>
<blockquote>
Select rotation angel and mirror plane. Take care that the
<i>preset areas</i> are relative to the scanner surface (not to the
display surface): so they also are rotated on display when you select
a rotation.
</blockquote>

<img SRC="xsane-aspect-ratio.jpg" alt="aspect ratio">
&nbsp;&nbsp;
<a NAME="ASPECT_RATIO"></a><b><u>Aspect ratio:</u></b>
<blockquote>
Define the aspect ratio width:height of the created image.
You can only draw the selection frame with the selected aspect ratio.
</blockquote>

<img SRC="xsane-rgb-values.jpg" alt="RGB values">
&nbsp;&nbsp;
<a NAME="RGB_VALUES"></a><b><u>RGB values:</u></b>
<blockquote>
The frame shows the red, green and blue color components of the pixel under the
mouse pointer. The top line shows the values of the raw image, the bottom line
shows the values of the enhanced image.

</blockquote>

<b><u>Acquire Preview:</u></b>
<blockquote>
Start preview scan. If you resized the preview window, the new preview
is done with updated resolution.
</blockquote>

<b><u>Cancel Preview:</u></b>
<blockquote>
Cancel a preview scan.
</blockquote>

<a NAME="SELECT_SCAN_AREA"></a><b><u>Left mouse button:</u></b>
<blockquote>
<u><b>Select scan area:</b></u> Press (&amp;hold) left mouse button to define
one edge, move the mouse so that the area you want to scan is in the frame
and release the button.
<br>
<br>
<u><b>Edit scan area:</b></u> Move the pointer over an edge or side of the
existing selection, the mouse pointer changes. Now press (&amp;hold) the left
mouse button, you can move the draged edge/side of the scanarea, then release the
left mouse button.
</blockquote>

<a NAME="MOVE_SCAN_AREA"></a><b><u>Right and middle mouse button:</u></b>
<blockquote>
If you press (&amp;hold) the right or the middle mouse button in the selection
frame you can move the selection frame without resizing it.
</blockquote>

</blockquote>
</td>
</tr>
</table>

<hr WIDTH="100%">

<blockquote>
Author: <a href="mailto:Oliver.Rauch@xsane.org">Oliver Rauch</a>
</blockquote>

</body>
</html>