summaryrefslogtreecommitdiff
path: root/doc/sane-xsane-gimp-doc.html
blob: fbc23a927dd365d381831796c55545d32ee6adab (plain)
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
<!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="GENERATOR" content="Mozilla/4.74 [en] (X11; U; Linux 2.2.18 i686) [Netscape]">
   <meta name="Author" content="Oliver Rauch">
   <meta name="Description" content="scan, photocopy and fax frontend for SANE">
   <title>XSane - Gimp plugin</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">Main window of gimp plugin</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>
<br>
<font color="#000000">Main window:</font>
<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-fax-doc.html">Fax mode</a></li>
<li><a href="sane-xsane-mail-doc.html">Mail mode</a></li>
<li><a href="sane-xsane-gimp-doc.html">Gimp plugin</a></li>
</ul>
<br>
<a href="sane-xsane-medium-definition-doc.html">Medium selection</a>
<br>
<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>
<br>
<a href="sane-xsane-advanced-doc.html">Advanced options window</a>
<br>
<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-image-doc.html">Image setup</a></li>
<li><a href="sane-xsane-setup-mail-doc.html">Mail setup</a></li>
<li><a href="sane-xsane-setup-save-doc.html">Saving setup</a></li>
</ul>
</td>



<td VALIGN=TOP BGCOLOR="#FFFFFF">
<blockquote>
<br>
If XSane is started as Gimp plugin, the scanned image automatically is transfered to the Gimp.
<br>
<br>
<br>
<center><img SRC="xsane-gimp.jpg" alt="XSane-main-window"></center>
<br>
<br>
<img SRC="xsane-colormode.jpg" alt="colormode">
&nbsp;&nbsp;
<b>Scanmode:</b>
<blockquote>
Select scanmode, e.g.: color, grayscale, halftone, lineart.
</blockquote>
 
<img SRC="xsane-scansource.jpg" alt="scansource">
&nbsp;&nbsp;
<b>Scansource:</b>
<blockquote>
Select scansource, e.g.: Flatbed, Transparency, Automatic Document Feeder.
</blockquote>

<img SRC="xsane-medium.jpg" alt="medium">
&nbsp;&nbsp;
<b><a href="sane-xsane-medium-definition-doc.html">Medium selection:</a></b>
<blockquote>
Select scanmedium, e.g.: <i>slide</i>, <i>standard negative</i>,
<i>Agfa negative</i>, ... or <i>Full range</i>.
</blockquote>                                                                                                           
 
<img SRC="xsane-resolution.jpg" alt="resolution">
&nbsp;&nbsp;
<b>Scan resolution:</b>
<blockquote>
Select resolution that is used for scanning. If the backends makes available a
range of resolutions (e.g. 100-600 dpi) XSane can display a slider or a
list of resolutions. You select this via <i>Preferences/Show resolution list</i>.
<br>
The backend can define a list of resolutions insted of a range, in this
case it is not possible to enable the slider.
<p>
To select exact resolutions with the slider click the slider with the mouse pointer
and use the cursor keys to change the value in steps of 1, if you press <i>ctrl</i>
and a cursor key the step is 10.
</blockquote>  
<br>
<br>
To start xsane as a GIMP plugin, you have to set a symbolic link from
the xsane binary to a GIMP plug-ins directory. In the following examples
we assume that xsane is located in /usr/local/bin:
<br>
<br>
<br>
gimp-1.0.x:
<blockquote>
<pre>ln -s /usr/local/bin/xsane ~/.gimp/plug-ins/</pre>
You can start xsane from the GIMP menu <i>Xtns/Xsane </i>
</blockquote>
<br>
<br>
gimp-1.1.x:
<blockquote>
<pre>ln -s /usr/local/bin/xsane ~/.gimp-1.1/plug-ins/</pre>
until gimp-1.1.9 you can start xsane from the GIMP menu <i>Xtns/Xsane </i>
<br>
since gimp-1.1.10 you can start xsane from the GIMP menu <i>File/Acquire</i>
</blockquote>
<br>
<br>
gimp-1.2.x:
<blockquote>
<pre>ln -s /usr/local/bin/xsane ~/.gimp-1.2/plug-ins/</pre>
You can start xsane from the GIMP menu<i> File/Acquire.</i>
</blockquote>
<br>
<br>
The GIMP´s XSane or Acquire menu contains short-cuts to the SANE devices that
were available at the time xsane was queried.
</blockquote>

<blockquote>
Note that gimp(1) caches these short-cuts in ~/.gimp/pluginrc.
Thus, when the list of available devices changes (e.g., a new scanner
is installed or the device of the scanner has changed), then it is
typically desirable to rebuild this cache. To do this, you can either
touch(1) the xsane binary (e.g.,"touch /usr/local/bin/xsane") or
delete the plugin cache (e.g., "rm ~/.gimp*/pluginrc"). Either
way, invoking gimp(1) afterwards will cause the pluginrc to be rebuilt.
<br>
<br>
If xsane is started as GIMP plugin it always sends the scanned image to the GIMP.
Copy and fax mode can not selected when xsane runs as GIMP plugin!
</blockquote>
</td>
</tr>
</table>

<hr WIDTH="100%">

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

</body>
</html>