diff options
| author | Mattia Rizzolo <mattia@mapreri.org> | 2014-10-03 14:04:58 +0000 |
|---|---|---|
| committer | Mattia Rizzolo <mattia@mapreri.org> | 2014-10-03 14:04:58 +0000 |
| commit | 2d113e8792747151bf5d830f1a1485f2f951f940 (patch) | |
| tree | f29e273d53fe5735cdac171504d798bf45ea2007 /doc | |
Imported Upstream version 0.50upstream/0.50
Diffstat (limited to 'doc')
56 files changed, 1923 insertions, 0 deletions
diff --git a/doc/Makefile.in b/doc/Makefile.in new file mode 100644 index 0000000..0099667 --- /dev/null +++ b/doc/Makefile.in @@ -0,0 +1,78 @@ +SHELL = /bin/sh + +VPATH = @srcdir@ +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +top_builddir = .. + +prefix = @prefix@ +exec_prefix = @exec_prefix@ +bindir = @bindir@ +sbindir = @sbindir@ +libexecdir = @libexecdir@ +datadir = @datadir@ +sysconfdir = @sysconfdir@ +sharedstatedir = @sharedstatedir@ +localstatedir = @localstatedir@ +libdir = @libdir@ +infodir = @infodir@ +mandir = @mandir@ +includedir = @includedir@ +oldincludedir = /usr/include +configdir = ${sysconfdir}/sane.d +sanedatadir = ${datadir}/sane + +MKDIR = $(top_srcdir)/mkinstalldirs +INSTALL = @INSTALL@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_DATA = @INSTALL_DATA@ + +@SET_MAKE@ + +SECT1 = xsane.1 +MANPAGES = $(SECT1) +LATEX = TEXINPUTS=$(srcdir):$$TEXINPUTS latex +DLH = TEXINPUTS=$(srcdir):$$TEXINPUTS dlh +MAN2HTML= nroff -man |\ + man2html -compress -title $${page} -cgiurl '$$title.$$section.html'|\ + sed 's,<BODY>,<BODY BGCOLOR=\#FFFFFF TEXT=\#000000><H1 ALIGN=CENTER><IMG SRC="../sane.jpg" HEIGHT=117 WIDTH=346></H1>,' + +all: $(MANPAGES) + +%.1: %.man + sed -e 's|@DATADIR@|$(datadir)|g' \ + -e 's|@CONFIGDIR@|$(configdir)|g' \ + -e 's|@LIBDIR@|$(libdir)|g' \ + -e 's|@BINDIR@|$(bindir)|g' \ + -e 's|@SBINDIR@|$(sbindir)|g' $^ >$@ + +install: $(MANPAGES) + $(MKDIR) $(mandir)/man1 + @for page in $(SECT1); do \ + echo installing $${page} in $(mandir)/man1/$${page}...; \ + $(INSTALL_DATA) $${page} $(mandir)/man1/$${page} || exit 1; \ + done + $(MKDIR) $(datadir) + $(INSTALL_DATA) $(srcdir)/sane-*-doc.html $(sanedatadir)/ + $(INSTALL_DATA) $(srcdir)/*.jpg $(sanedatadir)/ + +docs: ps html + +html-man: $(MANPAGES) + @for page in $(MANPAGES); do \ + echo "translating $${page} to $${page}.html..."; \ + cat $${page} | $(MAN2HTML) > $${page}.html; \ + done + + +clean: + rm -f *.toc *.aux *.log *.cp *.fn *.tp *.vr *.pg *.ky *.blg *.idx *.cb + rm -f *.ilg + +distclean: clean + rm -f $(MANPAGES) + rm -f Makefile *~ + +depend: + +.PHONY: all install depend clean ps html htmlman sane-backends-html diff --git a/doc/autoenhance.jpg b/doc/autoenhance.jpg Binary files differnew file mode 100644 index 0000000..0be20e2 --- /dev/null +++ b/doc/autoenhance.jpg diff --git a/doc/brightness.jpg b/doc/brightness.jpg Binary files differnew file mode 100644 index 0000000..0a382d3 --- /dev/null +++ b/doc/brightness.jpg diff --git a/doc/contrast.jpg b/doc/contrast.jpg Binary files differnew file mode 100644 index 0000000..b8d0435 --- /dev/null +++ b/doc/contrast.jpg diff --git a/doc/default.jpg b/doc/default.jpg Binary files differnew file mode 100644 index 0000000..56602f8 --- /dev/null +++ b/doc/default.jpg diff --git a/doc/gamma.jpg b/doc/gamma.jpg Binary files differnew file mode 100644 index 0000000..bf24033 --- /dev/null +++ b/doc/gamma.jpg diff --git a/doc/negative.jpg b/doc/negative.jpg Binary files differnew file mode 100644 index 0000000..be4bec1 --- /dev/null +++ b/doc/negative.jpg diff --git a/doc/restore.jpg b/doc/restore.jpg Binary files differnew file mode 100644 index 0000000..754871b --- /dev/null +++ b/doc/restore.jpg diff --git a/doc/rgb-default.jpg b/doc/rgb-default.jpg Binary files differnew file mode 100644 index 0000000..b04a539 --- /dev/null +++ b/doc/rgb-default.jpg diff --git a/doc/sane-backends-doc.html b/doc/sane-backends-doc.html new file mode 100644 index 0000000..b36058d --- /dev/null +++ b/doc/sane-backends-doc.html @@ -0,0 +1,110 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.5 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="List of all available backend documentations"> + <title>SANE-Backends</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="sane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<font color="#000000">Index of sane backends</font></h1> + +<p> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<blockquote> +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-abaton-doc.html">sane-abaton</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-agfafocus-doc.html">sane-agfafocus</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-apple-doc.html">sane-apple</a></font></li> + +<li> +<font color="#000000">sane-artec</font></li> + +<li> +<font color="#000000">sane-canon</font></li> + +<li> +<font color="#000000">sane-coolscan</font></li> + +<li> +<font color="#000000">sane-dc210</font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-dc25-doc.html">sane-dc25</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-dll-doc.html">sane-dll</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-dmc-doc.html">sane-dmc</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-epson-doc.html">sane-epson</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-hp-doc.html">sane-hp</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-microtek-doc.html">sane-microtek</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-microtek2-doc.html">sane-microtek2</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-mustek-doc.html">sane-mustek</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-net-doc.html">sane-net</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-pint-doc.html">sane-pint</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-pnm-doc.html">sane-pnm</a></font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-qcam-doc.html">sane-qcam</a></font></li> + +<li> +<font color="#000000">sane-s9036</font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-st400-doc.html">sane-st400</a> +(backend not included into sane)</font></li> + +<li> +<font color="#000000">sane-sharp</font></li> + +<li> +<font color="#000000">sane-snapscan</font></li> + +<li> +<font color="#000000">sane-tamarack</font></li> + +<li> +<font color="#000000"><a href="/usr/local/share/sane/sane-umax-doc.html">sane-umax</a></font></li> +</blockquote> +</blockquote> +</blockquote> + +</body> +</html> diff --git a/doc/sane-logo.jpg b/doc/sane-logo.jpg Binary files differnew file mode 100644 index 0000000..218babf --- /dev/null +++ b/doc/sane-logo.jpg diff --git a/doc/sane-logo2.jpg b/doc/sane-logo2.jpg Binary files differnew file mode 100644 index 0000000..e0f604f --- /dev/null +++ b/doc/sane-logo2.jpg diff --git a/doc/sane-pnm-doc.html b/doc/sane-pnm-doc.html new file mode 100644 index 0000000..9a02d4d --- /dev/null +++ b/doc/sane-pnm-doc.html @@ -0,0 +1,39 @@ +<HTML> +<HEAD> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <META NAME="GENERATOR" CONTENT="Mozilla/4.05 [en] (X11; I; Linux 2.0.36 i586) [Netscape]"> + <META NAME="Author" CONTENT="Oliver Rauch"> + <META NAME="Description" CONTENT="scan, photocopy and fax frontend for SANE"> + <TITLE>SANE - XSane frontend</TITLE> +</HEAD> +<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EF" VLINK="#51188E" ALINK="#FF0000"> + +<BLOCKQUOTE> +<CENTER> +<H3> +<IMG SRC="sane-logo.jpg" HEIGHT=300 WIDTH=256 ALIGN=TEXTTOP></H3></CENTER> + +<CENTER> +<H1> +PNM BACKEND</H1></CENTER> + +<CENTER> +<H1> + +<HR WIDTH="100%"></H1></CENTER> +</BLOCKQUOTE> + +<BLOCKQUOTE> +<CENTER><FONT SIZE=+1>The PNM backend is a backend for testing SANE frontends. +It is not planned to give the user any useful functions!</FONT></CENTER> + +<CENTER><FONT SIZE=+1></FONT> </CENTER> + +<CENTER><FONT SIZE=+1></FONT></CENTER> + +<CENTER> +<HR WIDTH="100%"></CENTER> +</BLOCKQUOTE> + +</BODY> +</HTML> diff --git a/doc/sane-pnm16-doc.html b/doc/sane-pnm16-doc.html new file mode 100644 index 0000000..e6bc487 --- /dev/null +++ b/doc/sane-pnm16-doc.html @@ -0,0 +1,42 @@ +<HTML> +<HEAD> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <META NAME="GENERATOR" CONTENT="Mozilla/4.05 [en] (X11; I; Linux 2.0.36 i586) [Netscape]"> + <META NAME="Author" CONTENT="Oliver Rauch"> + <META NAME="Description" CONTENT="scan, photocopy and fax frontend for SANE"> + <TITLE>SANE - XSane frontend</TITLE> +</HEAD> +<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EF" VLINK="#51188E" ALINK="#FF0000"> + +<BLOCKQUOTE> +<CENTER> +<H3> +<IMG SRC="sane-logo.jpg" HEIGHT=300 WIDTH=256 ALIGN=TEXTTOP></H3></CENTER> + +<CENTER> +<H1> +PNM16 BACKEND</H1></CENTER> + +<CENTER> +<H1> + +<HR WIDTH="100%"></H1></CENTER> +</BLOCKQUOTE> + +<BLOCKQUOTE> +<CENTER><FONT SIZE=+1>The PNM16 backend is a backend for testing SANE frontends. +It is not planned to give the user any useful functions!</FONT></CENTER> + +<CENTER><FONT SIZE=+1>It reads a pnm image and converts it into a 8-16 +bits/sample image.</FONT></CENTER> + +<CENTER><FONT SIZE=+1></FONT> </CENTER> + +<CENTER><FONT SIZE=+1></FONT></CENTER> + +<CENTER> +<HR WIDTH="100%"></CENTER> +</BLOCKQUOTE> + +</BODY> +</HTML> diff --git a/doc/sane-problems-doc.html b/doc/sane-problems-doc.html new file mode 100644 index 0000000..085118b --- /dev/null +++ b/doc/sane-problems-doc.html @@ -0,0 +1,116 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="List of all available backend documentations"> + <title>SANE-Backends</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="sane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<br> +<br> +<h1> +<font color="#000000">SANE Problems</font></h1> +</blockquote> + +<br> +<br> +<blockquote><b><font color="#000000"><font size=+1>If you have any problems +with SANE or XSane please read this before you write any mails.</font></font></b></blockquote> + +<blockquote> +<blockquote> +<li> +<b><font color="#000000">The SANE frontend (like xsane or xscanimage) does +not start or aborts with a segmentation fault.</font></b></li> + +<p><br><font color="#000000">Edit /usr/local/etc/sane.d/dll.conf (or /usr/etc/sane.d/dll.conf) +and comment out all but the backend you need. To do this add a "#" at the +beginning of the relevant lines.</font><font color="#000000"></font> +<p><font color="#000000">If that does not help try to find out where the +error occurs:</font> +<br><font color="#000000"> gdb +xscanimage</font> +<br><font color="#000000"> r +<enter></font> +<br><font color="#000000">after the frontend returned:</font> +<br><font color="#000000"> backtrace +<enter></font> +<br> +<li> +<b><font color="#000000">The scanner starts the scan but it stops while +scanning</font></b></li> + +<li> +<b><font color="#000000">The scsi bus or the whole system freezes</font></b></li> + +<li> +<b><font color="#000000">The image is corrupted</font></b></li> + +<p><br><font color="#000000">In general there are three different reasons +that can cause such erros:</font> +<blockquote> +<li> +<font color="#000000">In most cases it is a problem with your scsi bus. +Please check the following points:</font></li> + +<blockquote> +<li> +<font color="#000000">The scsi bus has to be a chain (one line) that is +terminated on both ends. If possible the scanner should be on one end of +the chain because the connectors on most scsi scanners are not specified +for the scsi-2 standard.</font></li> + +<li> +<font color="#000000">If you do not use any ultra-scsi-devices and your +scsi controller is a fast scsi controller you can use passive terminators. +If one or more devices are ultra-scsi-devices you have to use active terminators.</font></li> + +<li> +<font color="#000000">If the scsi controller is at an end of the scsi chain +the termination of the controller has to be enabled. Otherwise it has to +be disabled. If you use a fast scsi controller and you have one or more +ultra-scsi-devices connected, you must not use the built in termination +of the scsi controller (because it is a passive terminator), you have to +use an active terminator instead.</font></li> + +<li> +<font color="#000000">The length of the scsi chain is limitted. If you +use no ultra-scsi-devices the whole length of the chain must not exceed +3 meters. If there are one or more ultra-scsi-devices in the scsi chain +the length of the chain must not exceed 1.5 meters. If there are +only 3 devices (2 devices + controller) the length of the chain may be +up to 3 meters, but if you have any problems you should try to reduce the +length.</font></li> +</blockquote> + +<li> +<font color="#000000">The driver for your scsi controller does not work +like expected. Update your scsi driver if you do not have the most recent +version.</font></li> + +<br><font color="#000000">If that does not help try it with an other type +of scsi card.</font> +<br> +<li> +<font color="#000000">May be your scanner/firmware does not work correct +with the backend you use. Update the backend version or contact the author +of the backend.</font></li> +</blockquote> +<font color="#000000"></font> +<br> +<li> +<b>Please read the documentation of the backend you use</b></li> +</blockquote> +<font color="#000000">If you tested everything above and you still need +help: contact the backend/frontend author or to the <a href="mailto: sane-devel@mostang.com">sane +mailling list</a> (you must be subscribed to the list).</font></blockquote> + +</body> +</html> diff --git a/doc/sane-scantips-doc.html b/doc/sane-scantips-doc.html new file mode 100644 index 0000000..9a4e45d --- /dev/null +++ b/doc/sane-scantips-doc.html @@ -0,0 +1,48 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.5 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="List of all available backend documentations"> + <title>SANE-Backends</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="sane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<font color="#000000">Scantips - links to the web</font></h1> + +<p> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<h4> +If you are looking for some tips about scanning, desktoppublishing etc, +take a look at these links:</h4> + +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="http://www.scantips.com/">http://www.scantips.com/</a></font></li> + +<li> +<font color="#000000"><a href="http://www.infomedia.net/scan/">http://www.infomedia.net/scan/</a></font></li> + +<li> +<font color="#000000"><a href="http://www.hsdesign.com/scanning/">http://www.hsdesign.com/scanning/</a></font></li> + +<li> +<font color="#000000"><a href="http://desktoppublishing.com/">http://desktoppublishing.com/</a></font></li> +</blockquote> +</blockquote> + +</body> +</html> diff --git a/doc/sane-xsane-advanced-doc.html b/doc/sane-xsane-advanced-doc.html new file mode 100644 index 0000000..b294836 --- /dev/null +++ b/doc/sane-xsane-advanced-doc.html @@ -0,0 +1,35 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Advanced options</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<br> +<blockquote> +<h1> +<u><font color="#009900">Advanced options window</font></u></h1> + +<p> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-advanced.jpg" height=238 width=291></center> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-advanced.jpg b/doc/sane-xsane-advanced.jpg Binary files differnew file mode 100644 index 0000000..309aa72 --- /dev/null +++ b/doc/sane-xsane-advanced.jpg diff --git a/doc/sane-xsane-copy-doc.html b/doc/sane-xsane-copy-doc.html new file mode 100644 index 0000000..e0f0b07 --- /dev/null +++ b/doc/sane-xsane-copy-doc.html @@ -0,0 +1,40 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Copy mode</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<u><font color="#009900">Copy mode</font></u></h1> +</blockquote> + +<blockquote> In Copy mode, the scanned image is converted to postscript. +The postscript file is piped as standard input to the command listed after +the printer symbol. +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-copy.jpg" height=416 width=270></center> + +<blockquote> +<br>The options of the printer and the printer command can be set in the +menu +<a href="sane-xsane-setup-printer-doc.html">Preferences/Setup</a></blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-copy.jpg b/doc/sane-xsane-copy.jpg Binary files differnew file mode 100644 index 0000000..13c1cd9 --- /dev/null +++ b/doc/sane-xsane-copy.jpg diff --git a/doc/sane-xsane-doc.html b/doc/sane-xsane-doc.html new file mode 100644 index 0000000..9956e12 --- /dev/null +++ b/doc/sane-xsane-doc.html @@ -0,0 +1,232 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Documentation index</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<br> +<BR></h1> + +<h1> +</h1> + +<h1> +</h1> + +<h1> +<br> +<u><font color="#009900">Index of xsane documentation</font></u></h1> + +<blockquote> +<br> +<br> +<br> </blockquote> +</blockquote> + +<blockquote> +<li> +<font color="#000000"><font size=+1>Xsane modes:</font></font></li> + +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="sane-xsane-scan-doc.html">Scan mode</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-copy-doc.html">Copy mode</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-fax-doc.html">Fax mode</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-gimp-doc.html">Gimp plugin</a></font></li> +</blockquote> +</blockquote> + +<li> +<font color="#000000"><font size=+1>Scanner option windows:</font></font></li> + +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="sane-xsane-standard-doc.html">Standard options +window</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-advanced-doc.html">Advanced options +window</a></font></li> +</blockquote> +</blockquote> + +<li> +<font color="#000000"><font size=+1><a href="sane-xsane-preview-doc.html">Preview</a></font></font></li> + +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#PIPETTE_WHITE">Pipette +white</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#PIPETTE_GRAY">Pipette +gray</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#PIPETTE_BLACK">Pipette +black</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#UNZOOM">Unzoom</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#ZOOM_OUT">Zoom +out</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#ZOOM_IN">Zoom +in</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#UNDO_ZOOM">Undo +zoom</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#SELECT_VISIBLE_AREA">Select +visible area</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#SELECT_SCAN_AREA">Select +scanarea</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#MOVE_SCAN_AREA">Move +scanarea</a></font></li> + +<br> </blockquote> +</blockquote> + +<li> +<font color="#000000"><font size=+1><a href="sane-xsane-enhancement-doc.html">Enhancement +functions</a>:</font></font></li> + +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#GAMMA">Gamma +correction</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#BRIGHTNESS">Brightness</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#CONTRAST">Contrast</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#RGB_DEFAULT">RGB +default</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#NEGATIVE">Negative</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#AUTOENHANCEMENT">Autoenhancement</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#ENHANCEMENT_DEFAULT">Enhancement +default</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#RESTORE_ENHANCEMENT">Restore +enhancement</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-enhancement-doc.html#STORE_ENHANCEMENT">Store +enhancement</a></font></li> + +<br> +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#PIPETTE_WHITE">Pipette +white</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#PIPETTE_GRAY">Pipette +gray</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-preview-doc.html#PIPETTE_BLACK">Pipette +black</a></font></li> + +<br> +<li> +<font color="#000000"><a href="sane-xsane-histogram-doc.html">Histogram +window</a></font></li> + +<li> +<font color="#000000">Highlight/White point</font></li> + +<li> +<font color="#000000">Shadow/Black point</font></li> + +<li> +<font color="#000000">Gamma/Gray point</font></li> +</blockquote> +</blockquote> + +<li> +<font color="#000000"><font size=+1>Setup:</font></font></li> + +<blockquote> +<blockquote> +<li> +<font color="#000000"><a href="sane-xsane-setup-copy-doc.html">Copy setup</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-setup-display-doc.html">Display +setup</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-setup-save-doc.html">Saving setup</a></font></li> + +<li> +<font color="#000000"><a href="sane-xsane-setup-fax-doc.html">Fax setup</a></font></li> +</blockquote> +</blockquote> + +<li> +<font color="#000000"><font size=+1>Supported functions:</font></font></li> + +<blockquote> +<blockquote> +<li> +<font color="#000000">Support for 9-16 bits/sample</font></li> + +<li> +<font color="#000000">Output formats</font></li> + +<li> +<font color="#000000">Automatic filename generation</font></li> + +<li> +<font color="#000000">Automatic Document Feeder</font></li> +</blockquote> +</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<blockquote><font size=+1>Author: <a href="mailto:Oliver.Rauch@Wolfsburg.DE">Oliver +Rauch</a></font> +<p><font size=+1><a href="http://www.wolfsburg.de/~rauch/sane/sane-xsane.html">Homepage +of xsane</a></font></blockquote> + +</body> +</html> diff --git a/doc/sane-xsane-enhancement-doc.html b/doc/sane-xsane-enhancement-doc.html new file mode 100644 index 0000000..32c1d05 --- /dev/null +++ b/doc/sane-xsane-enhancement-doc.html @@ -0,0 +1,101 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Enhancement</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<br> +<blockquote> +<h1> +<u><font color="#009900">Enhancement</font></u></h1> +XSane uses a gamma table to do the following enhancement functions. If +the scanner supports a custom gamma table (and the option is enabled) XSane +uses the scanner internal gamma table with the scanner's maximum bit depth.</blockquote> + +<center><img SRC="sane-xsane.jpg" height=416 width=270></center> + +<blockquote> +<dt> +<img SRC="gamma.jpg" height=21 width=22><a NAME="GAMMA"></a><b> Gamma correction:</b></dt> + +<blockquote>The gamma correction is a non linear correction. Black keeps +black and white keeps white +<blockquote>if the gamma value is greater than 1.0 the gray intensities +are brightned +<br>if the gamma value is smaller than 1.0 the gray intensities are darkend</blockquote> +</blockquote> + +<dt> +<img SRC="brightness.jpg" height=21 width=22><a NAME="BRIGHTNESS"></a><b> Brightness:</b></dt> + +<blockquote>positive values increase the brightness of the image. All values +are increased by the same value. 100% means a shift of the half value range +(on 8 bits (256 values) this means a shift of 128).</blockquote> + +<dt> +<img SRC="contrast.jpg" height=21 width=22><a NAME="CONTRAST"></a><b> Contrast:</b></dt> + +<blockquote>positive values increase the contrast of the image. Medium +gray keeps medium gray (8 bits: 128) +<blockquote>-100% means that all colors become medium gray +<br>+100% means that the difference between a value and medium gray is +doubled</blockquote> +</blockquote> + +<dt> +<img SRC="rgb-default.jpg" height=26 width=26><a NAME="RGB_DEFAULT"></a><b> RGB default:</b></dt> + +<blockquote>if RGB default is activated, all values for the color components +(red, green and blue) are set to the default values (gamma=1.0, brightness=0%, +contrast=0%). If you deactivate it, you can set different enhancement values +for each color.</blockquote> + +<dt> +<img SRC="negative.jpg" height=26 width=26><a NAME="NEGATIVE"></a><b> Negative:</b></dt> + +<blockquote>This option inverts the intensities (black <-> white). +It is for scanning negatives. +<p>Negatives do not only have inverted colors, it also is necessary +to do a color correction for each color component because the negatives +have very different color ranges for each color.</blockquote> + +<dt> +<img SRC="autoenhance.jpg" height=26 width=26><a NAME="AUTO_ENHANCEMENT"></a><b> Autoenhancement:</b></dt> + +<blockquote>If you press this button XSane tries to set good values +for brightness, contrast and gamma correction independance of the selected +part in the preview window. This does work quiet well for brightness and +contrast, but the gamma correction normally has to be corrected manually.</b> +<br>If RGB default is disabled, the components for each color are set +individually.</blockquote> + +<img SRC="default.jpg" height=26 width=26><a NAME="ENHANCEMENT_DEFAULT"></a><b> Enhancement default:</b> +<blockquote>Sets the enhancement values to default: gamma=1.0, brightness=0%, +contrast=0%.</blockquote> + +<dt> +<img SRC="restore.jpg" height=26 width=26><a NAME="RESTORE_ENHANCEMENT"></a><b> Restore enhancement:</b></dt> + +<blockquote>Restores the enhancement values from preferences.</blockquote> + +<dt> +<img SRC="store.jpg" height=26 width=26><a NAME="MEMORY_ENHANCEMENT"></a><b> Store enhancement (Memory):</b></dt> + +<blockquote>tore selected enhancement values to preferences.</blockquote> +</blockquote> + +<center> +<hr WIDTH="100%"> +<br><b><a href="../../c/sane/xsane/doc/sane-xsane-doc.html">INDEX</a></b></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-fax-doc.html b/doc/sane-xsane-fax-doc.html new file mode 100644 index 0000000..5eaf593 --- /dev/null +++ b/doc/sane-xsane-fax-doc.html @@ -0,0 +1,39 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Fax mode</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<blockquote> +<h3> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></h3> + </blockquote> + +<blockquote> +<h1> +<u><font color="#009900">Fax mode</font></u></h1> +This mode is a Frontend for SANE and for a faxprogram like hylafax or mgetty+sendfax +<br> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-fax.jpg" height=380 width=270> <img SRC="sane-xsane-fax-project.jpg" height=260 width=208></center> + +<p><br> +<blockquote>You need to have a faxprogram like hylafax(1) or mgetty+sendfax(8) +installed. The faxcommand and the options must be specified in the menu +<a href="sane-xsane-setup-doc.html">Preferences/Setup</a>.</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-fax-project.jpg b/doc/sane-xsane-fax-project.jpg Binary files differnew file mode 100644 index 0000000..03048b8 --- /dev/null +++ b/doc/sane-xsane-fax-project.jpg diff --git a/doc/sane-xsane-fax.jpg b/doc/sane-xsane-fax.jpg Binary files differnew file mode 100644 index 0000000..60d1065 --- /dev/null +++ b/doc/sane-xsane-fax.jpg diff --git a/doc/sane-xsane-gimp-doc.html b/doc/sane-xsane-gimp-doc.html new file mode 100644 index 0000000..7c4a49e --- /dev/null +++ b/doc/sane-xsane-gimp-doc.html @@ -0,0 +1,60 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [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"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<u><font color="#009900">Xsane as Gimp plugin</font></u></h1> +<font color="#000000">If xsane is started as Gimp plugin, the scanned image +automatically is transfered to the Gimp.</font> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-gimp.jpg" height=350 width=270></center> + +<blockquote> +<p>To start xsane as a gimp plugin, you have to set a symbolic link from +the xsane binary to a GIMP plug-ins directory. If xsane is located in /usr/local/bin +and you use-gimp-1.0.x do: +<blockquote> +<pre>ln -s /usr/local/bin/xsane ~/.gimp/plug-ins/</pre> +</blockquote> +if you use gimp-1.1.x, you have to do: +<blockquote> +<pre>ln -s /usr/local/bin/xsane ~/.gimp-1.1/plug-ins/</pre> +</blockquote> +You can start xsane from the GIMP menu <i>Xtns/Xsane </i>if GIMP-version +< 1.1.9, since GIMP-version-1.1.9 you can start xsane from the GIMP +menu<i> File/Acquire.</i> It 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. +<p>If xsane is started as GIMP plugin it always sends the scanned image +to the GIMP, copy- or fax- mode can not selected when xsane runs as GIMP +plugin!</blockquote> + +<center> +<p><br> +<hr WIDTH="100%"><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-gimp.jpg b/doc/sane-xsane-gimp.jpg Binary files differnew file mode 100644 index 0000000..f183d42 --- /dev/null +++ b/doc/sane-xsane-gimp.jpg diff --git a/doc/sane-xsane-histogram-doc.html b/doc/sane-xsane-histogram-doc.html new file mode 100644 index 0000000..736bde9 --- /dev/null +++ b/doc/sane-xsane-histogram-doc.html @@ -0,0 +1,55 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Histogram</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<u><font color="#009900">Histogram window</font></u></h1> + +<p> +<br> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-histogram.jpg" height=362 width=278></center> + +<p><br> +<blockquote> +<blockquote>The histogram shows the color density of the area that is selected +in the preview window. The top histogram represents the scanned raw image, +the bottom histogram represents the enhanced image. In grayscale mode, +there are three sliders in the gray range. The black slider defines the +black point, the white silder the white point and the gray slider the gray +point (gamma). If the <i>rgb default button</i> (in the xsane main window) +is not selected in color mode there are also sliders in the red, the green +and the blue range. In this case a move of a slider of the gray range also +moves the sliders of the color ranges. +<p>The <i>I</i>, <i>R</i>, <i>G</i> and <i>B</i> buttons define if the +<i>intensity</i>, <i>red</i>, <i>green</i> and/or <i>blue</i> histogram +components are shown. +<p>The curve-type button defines if the histogram curves are shown with +pixels or with lines. +<p>The <i>LOG</i> button defines if the densities are displayed linear +or logarithmical.</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-histogram.jpg b/doc/sane-xsane-histogram.jpg Binary files differnew file mode 100644 index 0000000..a13a912 --- /dev/null +++ b/doc/sane-xsane-histogram.jpg diff --git a/doc/sane-xsane-main-doc.html b/doc/sane-xsane-main-doc.html new file mode 100644 index 0000000..b3f0a42 --- /dev/null +++ b/doc/sane-xsane-main-doc.html @@ -0,0 +1,40 @@ +<HTML> +<HEAD> + <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> + <META NAME="GENERATOR" CONTENT="Mozilla/4.05 [en] (X11; I; Linux 2.0.36 i586) [Netscape]"> + <META NAME="Author" CONTENT="Oliver Rauch"> + <META NAME="Description" CONTENT="scan, photocopy and fax frontend for SANE"> + <TITLE>SANE - XSane frontend</TITLE> +</HEAD> +<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EF" VLINK="#51188E" ALINK="#FF0000"> + +<CENTER> </CENTER> + +<CENTER> +<DD> +<IMG SRC="xsane-logo.jpg" HEIGHT=300 WIDTH=256></DD></CENTER> + +<CENTER> +<DD> +<FONT SIZE=+2> a scanner-frontend for -><A HREF="http://www.mostang.com/sane">SANE</A>.</FONT></DD></CENTER> + +<CENTER> +<DD> +<FONT SIZE=+2> </FONT></DD></CENTER> + +<CENTER> +<HR WIDTH="100%"></CENTER> + +<CENTER> </CENTER> + +<BLOCKQUOTE> +<H1> +<U><FONT COLOR="#009900">The main window</FONT></U></H1> + +<CENTER><IMG SRC="sane-xsane.jpg" HEIGHT=443 WIDTH=306></CENTER> + +<CENTER> </CENTER> +</BLOCKQUOTE> + +</BODY> +</HTML> diff --git a/doc/sane-xsane-pipette-black.jpg b/doc/sane-xsane-pipette-black.jpg Binary files differnew file mode 100644 index 0000000..8508f14 --- /dev/null +++ b/doc/sane-xsane-pipette-black.jpg diff --git a/doc/sane-xsane-pipette-gray.jpg b/doc/sane-xsane-pipette-gray.jpg Binary files differnew file mode 100644 index 0000000..72211f3 --- /dev/null +++ b/doc/sane-xsane-pipette-gray.jpg diff --git a/doc/sane-xsane-pipette-white.jpg b/doc/sane-xsane-pipette-white.jpg Binary files differnew file mode 100644 index 0000000..b8b8b0f --- /dev/null +++ b/doc/sane-xsane-pipette-white.jpg diff --git a/doc/sane-xsane-preview-doc.html b/doc/sane-xsane-preview-doc.html new file mode 100644 index 0000000..996d21d --- /dev/null +++ b/doc/sane-xsane-preview-doc.html @@ -0,0 +1,173 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Preview</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<blockquote> +<h3> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></h3> + +<p> </blockquote> + +<blockquote> +<h1> +<u><font color="#009900">Preview window</font></u></h1> +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> +<br> </blockquote> + +<center><img SRC="sane-xsane-preview.jpg" height=643 width=407></center> + +<p><br> +<blockquote> +<br>With the smaller, black dashed frame in the preview you select the +area that shall be scanned. The larger, red dashed frame is only available +in COPY-mode, it shows the size of the page of the selected printer relative +to the zoom scale.</blockquote> + +<blockquote><img SRC="sane-xsane-pipette-white.jpg" height=26 width=27><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> + +<dt> +<img SRC="sane-xsane-pipette-gray.jpg" height=26 width=28> <a NAME="PIPETTE_GRAY"></a><b><u>Pipette +gray:</u></b></dt> + +<blockquote> +<dt> +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 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.</dt> +</blockquote> + +<dt> +<img SRC="sane-xsane-pipette-black.jpg" height=26 width=26> <a NAME="PIPETTE_BLACK"></a><b><u>Pipette +black:</u></b></dt> + +<blockquote> +<dt> +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 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.</dt> +</blockquote> + +<dt> +<img SRC="sane-xsane-zoom-not.jpg" height=26 width=26> <a NAME="UNZOOM"></a><b><u>Unzoom:</u></b></dt> + +<blockquote> +<dt> +Use full scan area.</dt> +</blockquote> + +<dt> +<img SRC="sane-xsane-zoom-out.jpg" height=27 width=27> <a NAME="ZOOM_OUT"></a><b><u>Zoom +out:</u></b></dt> + +<blockquote> +<dt> +Increase preview area by 20%.</dt> +</blockquote> + +<dt> +<img SRC="sane-xsane-zoom-in.jpg" height=26 width=26> <a NAME="ZOOM_IN"></a><b><u>Zoom +in:</u></b></dt> + +<blockquote> +<dt> +Zoom into selected area.</dt> +</blockquote> + +<dt> +<img SRC="sane-xsane-zoom-undo.jpg" height=26 width=26> <a NAME="UNDO_ZOOM"></a><b><u>Undo +zoom:</u></b></dt> + +<blockquote> +<dt> +Undo last zoom.</dt> +</blockquote> + +<dt> +<img SRC="sane-xsane-visible-area.jpg" height=26 width=26> <a NAME="SELECT_VISIBLE_AREA"></a><b><u>Select +visible area:</u></b></dt> + +<blockquote> +<dt> +Select the visible area in the preview window for scanning.</dt> +</blockquote> + +<dt> +<b><u>Acquire Preview:</u></b></dt> + +<blockquote> +<dt> +Start preview scan. If you resized the preview window, the new preview +is done with updated resolution.</dt> +</blockquote> + +<dt> +<b><u>Cancel Preview:</u></b></dt> + +<blockquote> +<dt> +Cancel a preview scan.</dt> + +<dt> +</dt> +</blockquote> + +<dt> +<a NAME="SELECT_SCAN_AREA"></a><b><u>Left mouse button:</u></b></dt> + +<blockquote> +<dt> +<u>Select scan area:</u> Press (&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></dt> + +<dt> +<u>Edit scan area:</u> Move the pointer over an edge of the existing selection, +the mouse pointer changes. Now press (&hold) the left mouse button, +you can move the draged edge of the scanarea, then release the left mouse +button.</dt> +</blockquote> + +<dt> +<a NAME="MOVE_SCAN_AREA"></a><b><u>Right and middle mouse button:</u></b></dt> + +<blockquote> +<dt> +If you press (&hold) the right or the middle mouse button in the selection +frame you can move the selection frame without resizing it.</dt> +</blockquote> +</blockquote> + +<blockquote> +<blockquote> +<blockquote> </blockquote> +</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-preview.jpg b/doc/sane-xsane-preview.jpg Binary files differnew file mode 100644 index 0000000..892e8d8 --- /dev/null +++ b/doc/sane-xsane-preview.jpg diff --git a/doc/sane-xsane-scan-doc.html b/doc/sane-xsane-scan-doc.html new file mode 100644 index 0000000..6995bf9 --- /dev/null +++ b/doc/sane-xsane-scan-doc.html @@ -0,0 +1,92 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Scan mode</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<br> +<blockquote> +<h1> +<u><font color="#009900">Scan mode (stand alone)</font></u></h1> +The scan mode is to scan an image and save it to a file. +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane.jpg" height=416 width=270></center> + +<blockquote> </blockquote> + +<h3> +<u><font color="#009900">Supported output formats:</font></u></h3> + +<blockquote>You can select the output format by the filename extension +(menu = "by ext") or by selecting the file format in the menu. Possible +are: <i>pnm, png, ps, jpeg, raw </i>and<i> tiff.</i></blockquote> + +<blockquote><i>Pnm</i> and <i>ps</i> (and raw) are always available. The +other formats are only available if necessary libraries are present (at +compilation time AND while xsane is executed). For <i>png</i> you need +libpng and libz, for <i>jpeg</i> you need jpeglib, for <i>tiff</i> you +need libtiff.</blockquote> + +<blockquote>The <i>raw</i> format is a 16 bit format comparable to 16 bit +binary <i>pnm</i> format that is not defined, for <i>pnm</i> the 16 bit +format only is defined as ascii mode which generates huge and slow files.</blockquote> + +<blockquote><b>The supported output formats depend on the bit depth of +the scanned image:</b> +<h4> +<u><font color="#990000">1 bit/pixel black/white mode:</font></u></h4> + +<blockquote><font color="#000099">pnm = pbm, png</font> +<br><font color="#000099">ps, jpeg and tiff are converted to 8 bit grayscale +mode.</font></blockquote> + +<h4> +<u><font color="#990000">8 bits/pixel grayscale mode:</font></u></h4> + +<blockquote><font color="#000099">pnm = pgm, png, ps, jpeg and tiff</font></blockquote> + +<h4> +<u><font color="#990000">16 bits/pixel grayscale mode (9-16 bits):</font></u></h4> + +<blockquote><font color="#000099">pnm (ascii), png and raw</font></blockquote> + +<h4> +<u><font color="#990000">24 bits/pixel RGB-color mode (8 bits/color):</font></u></h4> + +<blockquote><font color="#000099">pnm = ppm, png, ps, jpeg and tiff</font></blockquote> + +<h4> +<u><font color="#990000">48 bits/pixel RGB-color mode (9-16 bits/color):</font></u></h4> + +<blockquote><font color="#000099">pnm (ascii), png and raw</font></blockquote> + +<h4> +<u><font color="#990000">32 bits/pixel RGBA-color mode (8 bits/color):</font></u></h4> + +<blockquote><font color="#000099">rgba (raw) and png with alpha channel</font></blockquote> + +<h4> +<u><font color="#990000">64 bits/pixel RGBA-color mode (9-16 bits/color):</font></u></h4> + +<blockquote><font color="#000099">rgba (raw) and png with alpha channel</font></blockquote> +</blockquote> + +<center> +<hr WIDTH="100%"> +<br><a href="/usr/local/share/sane/sane-xsane-doc.html">INDEX</a></center> + +<p><br> +<br> +</body> +</html> diff --git a/doc/sane-xsane-setup-copy-doc.html b/doc/sane-xsane-setup-copy-doc.html new file mode 100644 index 0000000..bbd36b6 --- /dev/null +++ b/doc/sane-xsane-setup-copy-doc.html @@ -0,0 +1,96 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Setup</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<dd> +</dd> + +<dd> +</dd> + +<dd> +</dd> + +<blockquote> +<h1> +<u><font color="#009900">Copy setup</font></u></h1> + +<p> +<br> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-setup-copy.jpg" height=501 width=391></center> + +<blockquote> +<h4> +NAME:</h4> +</blockquote> + +<blockquote> +<blockquote>Define the name for the following printer definition.</blockquote> + +<h4> +COMMAND:</h4> + +<blockquote>Enter the command with which you print files. The command has +to read the file from the standard input. If you use the bsd printing system, +this is "lpr -", if you use the old printing system, this should be "lp +-".</blockquote> +</blockquote> + +<blockquote> +<h4> +COPY NUMBER OPTION:</h4> +</blockquote> + +<blockquote> +<blockquote>Enter the option of the printer command with wich the number +of copies are specified. This option is the last option passed to the printerrcommand +so if you specify a ";#" the option is ignored.</blockquote> + +<h4> +RESOLUTION:</h4> + +<blockquote>With <i>resolution</i> you specify the resolution that shall +be used for printing. It is not always necessary to set this value to the +resolution of the printer. Especally in grayscale and color mode it normally +is good to set this value to the half or the quarter of the printer resolution +because the printer needs a greater resolution to do the dithering. This +value does not effect a change of the image size, the image size only depends +on the given zoom factor.</blockquote> + +<h4> +PRINT AREA (WIDTH, HEIGHT, LEFT OFFSET, BOTTOM OFFSET):</h4> + +<blockquote>Each printer has it's own area size and position where it is +able to print.</blockquote> + +<h4> +PRINTER GAMMA VALUES:</h4> + +<blockquote>Addidtional gamma value for printing. The <i>Printer gamma +value</i> is used for grayscale and as common value for color mode. The +red, green and blue values are for color correction.</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-setup-copy.jpg b/doc/sane-xsane-setup-copy.jpg Binary files differnew file mode 100644 index 0000000..abe3d35 --- /dev/null +++ b/doc/sane-xsane-setup-copy.jpg diff --git a/doc/sane-xsane-setup-display-doc.html b/doc/sane-xsane-setup-display-doc.html new file mode 100644 index 0000000..948e4d1 --- /dev/null +++ b/doc/sane-xsane-setup-display-doc.html @@ -0,0 +1,99 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Setup</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<dd> +</dd> + +<dd> +</dd> + +<dd> +</dd> + +<dd> +</dd> + +<dd> +</dd> + +<blockquote> +<h1> +<u><font color="#009900">Display setup</font></u></h1> +</blockquote> + +<blockquote> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<h3> +<font color="#009900"></font></h3> +<font color="#009900"></font> +<center> +<p><br><img SRC="sane-xsane-setup-display.jpg" height=501 width=391></center> + +<p><br> +<blockquote> +<h4> +MAIN WINDOW SIZE FIXED:</h4> +</blockquote> + +<blockquote> +<blockquote>Select if the main window size shall be fixed (the window size +is defined by xsane) or it shall be a resizable with scrollbars if necessary. +The change of this option will take effect at the next start of xsane. +The option can be overwritten by the command line options --Fixed/-F or +--Resizeable/-R.</blockquote> +</blockquote> + +<blockquote> +<h4> +PRESERVE PREVIEW IMAGE:</h4> +</blockquote> + +<blockquote> +<blockquote>Preserve the preview image for the next program start. The +last preview image is displayed on the next program start, you don`t need +to redo the preview scan.</blockquote> + +<h4> +USE PRIVATE COLORMAP:</h4> + +<blockquote>If enabled and if the X server runs in 8 bit mode (256 colors) +then the preview uses an own color map.</blockquote> + +<h4> +PREVIEW GAMMA:</h4> + +<blockquote>Set the gamma correction value for the preview image. This +is to get correct colors on your monitor.</blockquote> + +<h4> +HELPFILE VIEWER:</h4> + +<blockquote>Enter a program to show the helpfiles. It must be a html-viewer. +If you enter the keywrod "netscape-remote", xsane uses a already running +netscape to show the onlinehelp. If you run kde, you may want to enter +"kdehelp" here.</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-setup-display.jpg b/doc/sane-xsane-setup-display.jpg Binary files differnew file mode 100644 index 0000000..e7d9d92 --- /dev/null +++ b/doc/sane-xsane-setup-display.jpg diff --git a/doc/sane-xsane-setup-fax-doc.html b/doc/sane-xsane-setup-fax-doc.html new file mode 100644 index 0000000..a5d3953 --- /dev/null +++ b/doc/sane-xsane-setup-fax-doc.html @@ -0,0 +1,104 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Setup</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<u><font color="#009900">Fax setup</font></u></h1> + +<p> +<br> +<br> +<br> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-setup-fax.jpg" height=501 width=391></center> + +<p><br> +<blockquote> +<h4> +COMMAND:</h4> + +<blockquote>Enter command to send/spool faxfiles. +<dd> +<b>hylafax: "sendfax"</b></dd> + +<dd> +<b>mgetty+sendfax: "faxspool"</b></dd> +</blockquote> + +<h4> +RECEIVER OPTION:</h4> + +<blockquote>Option to set receiver phone number or address. +<dd> +<b>hylafax: "-d"</b></dd> + +<dd> +<b>mgetty+sendfax: leave free</b></dd> +</blockquote> + +<h4> +POSTSCRIPTFILE OPTION:</h4> + +<blockquote>If there is an option that must be set before the filenames +of the faxfile or if it is necessary to specify an option for files in +postscript format, enter this option - otherwise let this field free. +<dd> +<b>hylafax: leave free</b></dd> + +<dd> +<b>mgetty+sendfax: leave free</b></dd> +</blockquote> + +<h4> +NORMAL MODE OPTION:</h4> + +<blockquote>If there is an option to set normal mode (98lpi) then enter +this option - otherwise let this field free. +<dd> +<b>hylafax: "-l"</b></dd> + +<dd> +<b>mgetty+sendfax: "-n"</b></dd> +</blockquote> + +<h4> +FINE MODE OPTION:</h4> + +<blockquote>If there is an option to set fine mode (196lpi) then enter +this option - otherwise let this field free. +<dd> +<b>hylafax: "-m"</b></dd> + +<dd> +<b>mgetty+sendfax: leave free</b></dd> +</blockquote> + +<h4> +VIEWER:</h4> + +<blockquote>Enter a program to show the postscript fax files on the screen. +<br>E.g. this can be "ghostscript" or "xv".</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-setup-fax.jpg b/doc/sane-xsane-setup-fax.jpg Binary files differnew file mode 100644 index 0000000..f2e66de --- /dev/null +++ b/doc/sane-xsane-setup-fax.jpg diff --git a/doc/sane-xsane-setup-save-doc.html b/doc/sane-xsane-setup-save-doc.html new file mode 100644 index 0000000..5e8cb2d --- /dev/null +++ b/doc/sane-xsane-setup-save-doc.html @@ -0,0 +1,92 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Setup</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<dd> +</dd> + +<dd> +</dd> + +<dd> +</dd> + +<dd> +</dd> + +<blockquote> +<h1> +<u><font color="#009900">Saving setup</font></u></h1> + +<p> +<br> +<br> +<br> </blockquote> + +<blockquote> </blockquote> + +<h3> +<font color="#009900"></font></h3> +<font color="#009900"></font> +<center> +<p><br><img SRC="sane-xsane-setup-save.jpg" height=501 width=391></center> + +<p><br> +<blockquote> +<h4> +OVERWRITE WARNING:</h4> +</blockquote> + +<blockquote> +<blockquote>If enabled, a warning comes up before an existing file is overwritten.</blockquote> + +<h4> +INCREASE FILENAME COUNTER:</h4> + +<blockquote>If enabled, the number in the filename of the following form +is automatically increased after a scan is completed: +<blockquote><i>image-001.ext</i></blockquote> +The number of digits is free and will not be changed, in case of an overflow, +a warning is printed and the counter becomes 0.</blockquote> + +<blockquote>If an automatic document feeder is used the filename should +contain a counter and this option should be enabled.</blockquote> + +<h4> +SKIP EXISTING NUMBERS:</h4> + +<blockquote>If <i>increase filename counter</i> is enabled, filenames that +already exist are skipped!</blockquote> + +<h4> +JPEG IMAGE QUALITY:</h4> + +<blockquote>If the image is saved in <i>jpeg</i> format this value defines +the quality of the image. Low values mean low quality and low file size, +high values mean high quality and high file size.</blockquote> + +<h4> +PNG IMAGE COMPRESSION:</h4> + +<blockquote>If the image is saved in <i>png</i> format this value defines +the compression level. The quality of the image keeps the same, low values +mean low compression, large files and low compression time. High values +mean high compression, smaller files and high compression time.</blockquote> +</blockquote> + +<hr WIDTH="100%"> +<center><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-setup-save.jpg b/doc/sane-xsane-setup-save.jpg Binary files differnew file mode 100644 index 0000000..07b6a22 --- /dev/null +++ b/doc/sane-xsane-setup-save.jpg diff --git a/doc/sane-xsane-standard-doc.html b/doc/sane-xsane-standard-doc.html new file mode 100644 index 0000000..3a09d7e --- /dev/null +++ b/doc/sane-xsane-standard-doc.html @@ -0,0 +1,33 @@ +<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> +<html> +<head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> + <meta name="GENERATOR" content="Mozilla/4.6 [en] (X11; I; Linux 2.2.11 i586) [Netscape]"> + <meta name="Author" content="Oliver Rauch"> + <meta name="Description" content="scan, photocopy and fax frontend for SANE"> + <title>XSane - Standard options</title> +</head> +<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> + +<dd> +<img SRC="xsane-logo2.jpg" height=150 width=128 align=LEFT></dd> + +<blockquote> +<h1> +<u><font color="#009900">Standard options window</font></u></h1> + +<p> +<br> +<br> +<br> +<br> +<br> </blockquote> + +<center><img SRC="sane-xsane-standard.jpg" height=275 width=307> +<br> +<hr WIDTH="100%"> +<br><a href="sane-xsane-doc.html">INDEX</a></center> + +<p><br> +</body> +</html> diff --git a/doc/sane-xsane-standard.jpg b/doc/sane-xsane-standard.jpg Binary files differnew file mode 100644 index 0000000..13be214 --- /dev/null +++ b/doc/sane-xsane-standard.jpg diff --git a/doc/sane-xsane-visible-area.jpg b/doc/sane-xsane-visible-area.jpg Binary files differnew file mode 100644 index 0000000..117a5ba --- /dev/null +++ b/doc/sane-xsane-visible-area.jpg diff --git a/doc/sane-xsane-zoom-in.jpg b/doc/sane-xsane-zoom-in.jpg Binary files differnew file mode 100644 index 0000000..dc73335 --- /dev/null +++ b/doc/sane-xsane-zoom-in.jpg diff --git a/doc/sane-xsane-zoom-not.jpg b/doc/sane-xsane-zoom-not.jpg Binary files differnew file mode 100644 index 0000000..b239646 --- /dev/null +++ b/doc/sane-xsane-zoom-not.jpg diff --git a/doc/sane-xsane-zoom-out.jpg b/doc/sane-xsane-zoom-out.jpg Binary files differnew file mode 100644 index 0000000..9e20fc1 --- /dev/null +++ b/doc/sane-xsane-zoom-out.jpg diff --git a/doc/sane-xsane-zoom-undo.jpg b/doc/sane-xsane-zoom-undo.jpg Binary files differnew file mode 100644 index 0000000..11e0890 --- /dev/null +++ b/doc/sane-xsane-zoom-undo.jpg diff --git a/doc/sane-xsane.jpg b/doc/sane-xsane.jpg Binary files differnew file mode 100644 index 0000000..31c37af --- /dev/null +++ b/doc/sane-xsane.jpg diff --git a/doc/store.jpg b/doc/store.jpg Binary files differnew file mode 100644 index 0000000..e1223df --- /dev/null +++ b/doc/store.jpg diff --git a/doc/xsane-logo.jpg b/doc/xsane-logo.jpg Binary files differnew file mode 100644 index 0000000..596f3da --- /dev/null +++ b/doc/xsane-logo.jpg diff --git a/doc/xsane-logo2.jpg b/doc/xsane-logo2.jpg Binary files differnew file mode 100644 index 0000000..133c3c7 --- /dev/null +++ b/doc/xsane-logo2.jpg diff --git a/doc/xsane.man b/doc/xsane.man new file mode 100644 index 0000000..8e69216 --- /dev/null +++ b/doc/xsane.man @@ -0,0 +1,199 @@ +.TH xsane 1 "02 Aug 1999" +.IX xsane +.SH NAME +xsane - scanner frontend for SANE +.SH SYNOPSIS +.B xsane +.RB [ --version | -v ] +.RB [ --device-settings +.IR file +.RB | -d +.IR file ] +.RB [ --scan | -s ] +.RB [ --copy | -c ] +.RB [ --fax | -f ] +.RB [ --no-mode-selection | -n ] +.RB [ --Fixed | -F ] +.RB [ --Scrolled | -S ] +.RB [ --display +.IR d ] +.RB [ --no-xshm ] +.RB [ --sync ] +.RB [ --debug-level +.IR n ] +.RI [ devicename ] +.SH DESCRIPTION +.B xsane +provides a graphical user-interface to control an image +acquisition device such as a flatbed scanner. It allows +previewing and scanning invidual images and can be invoked either +directly from the command-line or through The GIMP image manipulation +program. In the former case, +.B xsane +acts as a stand-alone program that saves acquired images in a suitable +PNM format (PBM for black-and-white images, PGM for grayscale images, +and PPM for color images) or converts the image to JPEG, PNG, PS or TIFF. +In the latter case, the images are directly passed to The GIMP for further +processing. + +.B xsane +accesses image acquisition devices through the SANE (Scanner Access +Now Easy) interface. The list of available devices depends on +installed hardware and configuration. When invoked without an +explicit devicename argument, +.B xsane +presents a dialog listing all known and available devices. To access +an available device that is not known to the system, the devicename +must be specified explicitly. +.SH RUNNING UNDER THE GIMP +To run +.B xsane +under the +.BR gimp (1), +simply set a symbolic link from the xsane-binary to one of the +.BR gimp (1) +plug-ins directories. For example, the command +.PP +.RS +ln -s @BINDIR@/xsane ~/.gimp/plug-ins/ +.RE +.PP +adds a symlink for the +.B xsane +binary to the user's plug-ins directory. After creating this symlink, +.B xsane +will be queried by +.BR gimp (1) +the next time it's invoked. From then on, +.B xsane +can be invoked through "Xtns->XSane->Device dialog..." menu entry. + +You'll also find that the "Xtns->XSane" menu contains short-cuts +to the SANE devices that were available at the time the +.B xsane +was queried. +Note that +.BR 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 +.BR touch (1) +the +.B xsane +binary (e.g., "touch @BINDIR@/xsane") or delete the plugin cache +(e.g., "rm ~/.gimp/pluginrc"). Either way, invoking +.BR gimp (1) +afterwards will cause the pluginrc to be rebuilt. +.SH OPTIONS +.PP +If the +.B --version +or +.B -v +flag is given xsane prints a version information and exits. +.PP +The +.B --scan +or +.B -s +flag forces xsane to start in scan mode. +.PP +The +.B --fax +or +.B -f +flag forces xsane to start in fax mode. +.PP +The +.B --copy +or +.B -c +flag forces xsane to start in fax mode. +.PP +The +.B --no-mode-selection +or +.B -n +flag disables the menu for xsane mode selection (scan, copy, fax). +.PP +The +.B --device-settings +or +.B -d +flag reads the next option as default filename +for device settings. The extension ".drc" must not +be included. +.PP +If the +.B --Fixed +or +.B -F +flag is given then xsane uses a fixed, non resizable main window. +The flag overwrites the preferences value. +.PP +If the +.B --Scrolled +or +.B -S +flag is given then xsane uses a scrolled, resizable main window. +The flag overwrites the preferences value. +.PP +The +.B --display +flag selects the X11 display used to present the graphical user-interface +(see +.BR X (1) +for details). +.PP +The +.B --no-xshm +flag requests not to use shared memory images. Shared memory images +usually enhance performance but cause problems with some buggy X11 +servers. Unless your X11 server dies when running this program, there +is no need or advantage to specify this flag. +.PP +The +.B --sync +flag requests a synchronous connection with the X11 server. This is for +debugging purposes only. +.SH FILES +.TP +.I $HOME/.sane/xsane/xsane.rc +This files holds the user preferences. Normally, this file should not +be manipulated directly. Instead, the user should customize the +program through the "Preferences" menu. +.TP +.I $HOME/.sane/xsane/devicename.rc +For each device, there is one rc-file that holds the saved settings +for that particular device. Normally, this file should not be +manipulated directly. Instead, the user should use the +.B xsane +interface to select appropriate values and then save the device +settings using the "Preferences->Save Device Settings" menubar entry. +.TP +.I $HOME/.sane/preview-devicename.ppm +After acquiring a preview, +.B xsane +normally saves the preview image in this device-specific file. Thus, +next time the program is started up, the program can present the old +preview image. This feature can be turned off through the +"Preferences->Preview Options..." dialog. +.TP +.I @DATADIR@/sane-style.rc +This system-wide file controls the aspects of the user-interface such +as colors and fonts. It is a GTK style file and provides fine control +over the visual aspects of the user-interface. +.TP +.I $HOME/.sane/sane-style.rc +This file serves the same purpose as the system-wide style file. If +present, it takes precedence over the system wide style file. +.SH "SEE ALSO" +gimp(1), xscanimage(1), scanimage(1), +sane\-dll(5), sane\-net(5), sane-scsi(5), +sane\-abaton(5), sane\-agfafocus(5), sane\-apple(5), sane\-dc25(5), +sane\-dmc(5), sane\-epson(5), sane\-hp(5), sane\-microtek(5), +sane\-microtek2(5), sane\-mustek(5), sane\-pint(5), sane\-pnm(5), +sane\-qcam(5), sane\-umax(5) +.SH AUTHOR +Oliver Rauch (Oliver.Rauch@Wolfsburg.DE) |
