From 2d113e8792747151bf5d830f1a1485f2f951f940 Mon Sep 17 00:00:00 2001 From: Mattia Rizzolo Date: Fri, 3 Oct 2014 14:04:58 +0000 Subject: Imported Upstream version 0.50 --- doc/Makefile.in | 78 ++++++++++++ doc/autoenhance.jpg | Bin 0 -> 1219 bytes doc/brightness.jpg | Bin 0 -> 726 bytes doc/contrast.jpg | Bin 0 -> 922 bytes doc/default.jpg | Bin 0 -> 747 bytes doc/gamma.jpg | Bin 0 -> 808 bytes doc/negative.jpg | Bin 0 -> 1267 bytes doc/restore.jpg | Bin 0 -> 837 bytes doc/rgb-default.jpg | Bin 0 -> 1095 bytes doc/sane-backends-doc.html | 110 ++++++++++++++++ doc/sane-logo.jpg | Bin 0 -> 14856 bytes doc/sane-logo2.jpg | Bin 0 -> 6908 bytes doc/sane-pnm-doc.html | 39 ++++++ doc/sane-pnm16-doc.html | 42 ++++++ doc/sane-problems-doc.html | 116 +++++++++++++++++ doc/sane-scantips-doc.html | 48 +++++++ doc/sane-xsane-advanced-doc.html | 35 +++++ doc/sane-xsane-advanced.jpg | Bin 0 -> 13091 bytes doc/sane-xsane-copy-doc.html | 40 ++++++ doc/sane-xsane-copy.jpg | Bin 0 -> 25812 bytes doc/sane-xsane-doc.html | 232 ++++++++++++++++++++++++++++++++++ doc/sane-xsane-enhancement-doc.html | 101 +++++++++++++++ doc/sane-xsane-fax-doc.html | 39 ++++++ doc/sane-xsane-fax-project.jpg | Bin 0 -> 12185 bytes doc/sane-xsane-fax.jpg | Bin 0 -> 22366 bytes doc/sane-xsane-gimp-doc.html | 60 +++++++++ doc/sane-xsane-gimp.jpg | Bin 0 -> 21593 bytes doc/sane-xsane-histogram-doc.html | 55 ++++++++ doc/sane-xsane-histogram.jpg | Bin 0 -> 26450 bytes doc/sane-xsane-main-doc.html | 40 ++++++ doc/sane-xsane-pipette-black.jpg | Bin 0 -> 1058 bytes doc/sane-xsane-pipette-gray.jpg | Bin 0 -> 1077 bytes doc/sane-xsane-pipette-white.jpg | Bin 0 -> 1065 bytes doc/sane-xsane-preview-doc.html | 173 +++++++++++++++++++++++++ doc/sane-xsane-preview.jpg | Bin 0 -> 42499 bytes doc/sane-xsane-scan-doc.html | 92 ++++++++++++++ doc/sane-xsane-setup-copy-doc.html | 96 ++++++++++++++ doc/sane-xsane-setup-copy.jpg | Bin 0 -> 36848 bytes doc/sane-xsane-setup-display-doc.html | 99 +++++++++++++++ doc/sane-xsane-setup-display.jpg | Bin 0 -> 29270 bytes doc/sane-xsane-setup-fax-doc.html | 104 +++++++++++++++ doc/sane-xsane-setup-fax.jpg | Bin 0 -> 26701 bytes doc/sane-xsane-setup-save-doc.html | 92 ++++++++++++++ doc/sane-xsane-setup-save.jpg | Bin 0 -> 30881 bytes doc/sane-xsane-standard-doc.html | 33 +++++ doc/sane-xsane-standard.jpg | Bin 0 -> 16093 bytes doc/sane-xsane-visible-area.jpg | Bin 0 -> 847 bytes doc/sane-xsane-zoom-in.jpg | Bin 0 -> 1094 bytes doc/sane-xsane-zoom-not.jpg | Bin 0 -> 1150 bytes doc/sane-xsane-zoom-out.jpg | Bin 0 -> 1128 bytes doc/sane-xsane-zoom-undo.jpg | Bin 0 -> 1101 bytes doc/sane-xsane.jpg | Bin 0 -> 25412 bytes doc/store.jpg | Bin 0 -> 790 bytes doc/xsane-logo.jpg | Bin 0 -> 14048 bytes doc/xsane-logo2.jpg | Bin 0 -> 6898 bytes doc/xsane.man | 199 +++++++++++++++++++++++++++++ 56 files changed, 1923 insertions(+) create mode 100644 doc/Makefile.in create mode 100644 doc/autoenhance.jpg create mode 100644 doc/brightness.jpg create mode 100644 doc/contrast.jpg create mode 100644 doc/default.jpg create mode 100644 doc/gamma.jpg create mode 100644 doc/negative.jpg create mode 100644 doc/restore.jpg create mode 100644 doc/rgb-default.jpg create mode 100644 doc/sane-backends-doc.html create mode 100644 doc/sane-logo.jpg create mode 100644 doc/sane-logo2.jpg create mode 100644 doc/sane-pnm-doc.html create mode 100644 doc/sane-pnm16-doc.html create mode 100644 doc/sane-problems-doc.html create mode 100644 doc/sane-scantips-doc.html create mode 100644 doc/sane-xsane-advanced-doc.html create mode 100644 doc/sane-xsane-advanced.jpg create mode 100644 doc/sane-xsane-copy-doc.html create mode 100644 doc/sane-xsane-copy.jpg create mode 100644 doc/sane-xsane-doc.html create mode 100644 doc/sane-xsane-enhancement-doc.html create mode 100644 doc/sane-xsane-fax-doc.html create mode 100644 doc/sane-xsane-fax-project.jpg create mode 100644 doc/sane-xsane-fax.jpg create mode 100644 doc/sane-xsane-gimp-doc.html create mode 100644 doc/sane-xsane-gimp.jpg create mode 100644 doc/sane-xsane-histogram-doc.html create mode 100644 doc/sane-xsane-histogram.jpg create mode 100644 doc/sane-xsane-main-doc.html create mode 100644 doc/sane-xsane-pipette-black.jpg create mode 100644 doc/sane-xsane-pipette-gray.jpg create mode 100644 doc/sane-xsane-pipette-white.jpg create mode 100644 doc/sane-xsane-preview-doc.html create mode 100644 doc/sane-xsane-preview.jpg create mode 100644 doc/sane-xsane-scan-doc.html create mode 100644 doc/sane-xsane-setup-copy-doc.html create mode 100644 doc/sane-xsane-setup-copy.jpg create mode 100644 doc/sane-xsane-setup-display-doc.html create mode 100644 doc/sane-xsane-setup-display.jpg create mode 100644 doc/sane-xsane-setup-fax-doc.html create mode 100644 doc/sane-xsane-setup-fax.jpg create mode 100644 doc/sane-xsane-setup-save-doc.html create mode 100644 doc/sane-xsane-setup-save.jpg create mode 100644 doc/sane-xsane-standard-doc.html create mode 100644 doc/sane-xsane-standard.jpg create mode 100644 doc/sane-xsane-visible-area.jpg create mode 100644 doc/sane-xsane-zoom-in.jpg create mode 100644 doc/sane-xsane-zoom-not.jpg create mode 100644 doc/sane-xsane-zoom-out.jpg create mode 100644 doc/sane-xsane-zoom-undo.jpg create mode 100644 doc/sane-xsane.jpg create mode 100644 doc/store.jpg create mode 100644 doc/xsane-logo.jpg create mode 100644 doc/xsane-logo2.jpg create mode 100644 doc/xsane.man (limited to 'doc') 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,,

,' + +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 new file mode 100644 index 0000000..0be20e2 Binary files /dev/null and b/doc/autoenhance.jpg differ diff --git a/doc/brightness.jpg b/doc/brightness.jpg new file mode 100644 index 0000000..0a382d3 Binary files /dev/null and b/doc/brightness.jpg differ diff --git a/doc/contrast.jpg b/doc/contrast.jpg new file mode 100644 index 0000000..b8d0435 Binary files /dev/null and b/doc/contrast.jpg differ diff --git a/doc/default.jpg b/doc/default.jpg new file mode 100644 index 0000000..56602f8 Binary files /dev/null and b/doc/default.jpg differ diff --git a/doc/gamma.jpg b/doc/gamma.jpg new file mode 100644 index 0000000..bf24033 Binary files /dev/null and b/doc/gamma.jpg differ diff --git a/doc/negative.jpg b/doc/negative.jpg new file mode 100644 index 0000000..be4bec1 Binary files /dev/null and b/doc/negative.jpg differ diff --git a/doc/restore.jpg b/doc/restore.jpg new file mode 100644 index 0000000..754871b Binary files /dev/null and b/doc/restore.jpg differ diff --git a/doc/rgb-default.jpg b/doc/rgb-default.jpg new file mode 100644 index 0000000..b04a539 Binary files /dev/null and b/doc/rgb-default.jpg differ 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 @@ + + + + + + + + SANE-Backends + + +  +
+
+ +
+

+Index of sane backends

+  +

  +
  +
  +
  +
  +
  +
 

+ +
+
+
+
  • +sane-abaton
    • + +
  • +sane-agfafocus
    • + +
  • +sane-apple
    • + +
  • +sane-artec
    • + +
  • +sane-canon
    • + +
  • +sane-coolscan
    • + +
  • +sane-dc210
    • + +
  • +sane-dc25
    • + +
  • +sane-dll
    • + +
  • +sane-dmc
    • + +
  • +sane-epson
    • + +
  • +sane-hp
    • + +
  • +sane-microtek
    • + +
  • +sane-microtek2
    • + +
  • +sane-mustek
    • + +
  • +sane-net
    • + +
  • +sane-pint
    • + +
  • +sane-pnm
    • + +
  • +sane-qcam
    • + +
  • +sane-s9036
    • + +
  • +sane-st400 +(backend not included into sane)
    • + +
  • +sane-sharp
    • + +
  • +sane-snapscan
    • + +
  • +sane-tamarack
    • + +
  • +sane-umax
    • +
    +
    +
    + + + diff --git a/doc/sane-logo.jpg b/doc/sane-logo.jpg new file mode 100644 index 0000000..218babf Binary files /dev/null and b/doc/sane-logo.jpg differ diff --git a/doc/sane-logo2.jpg b/doc/sane-logo2.jpg new file mode 100644 index 0000000..e0f604f Binary files /dev/null and b/doc/sane-logo2.jpg differ 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 @@ + + + + + + + SANE - XSane frontend + + + +
    +
    +

    +

    + +
    +

    +PNM BACKEND

    + +
    +

    + +

    +
    + +
    +
    The PNM backend is a backend for testing SANE frontends. +It is not planned to give the user any useful functions!
    + +
     
    + +
    + +
    +
    +
    + + + 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 @@ + + + + + + + SANE - XSane frontend + + + +
    +
    +

    +

    + +
    +

    +PNM16 BACKEND

    + +
    +

    + +

    +
    + +
    +
    The PNM16 backend is a backend for testing SANE frontends. +It is not planned to give the user any useful functions!
    + +
    It reads a pnm image and converts it into a 8-16 +bits/sample image.
    + +
     
    + +
    + +
    +
    +
    + + + 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 @@ + + + + + + + + SANE-Backends + + +  +
    +
    + +
      +
      +
      +

    +SANE Problems

    +
    + +
      +
      +
    If you have any problems +with SANE or XSane please read this before you write any mails.
    + +
    +
    +
  • +The SANE frontend (like xsane or xscanimage) does +not start or aborts with a segmentation fault.
    • + +


    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. +

    If that does not help try to find out where the +error occurs: +
            gdb +xscanimage +
            r +<enter> +
    after the frontend returned: +
            backtrace +<enter> +
      +

  • +The scanner starts the scan but it stops while +scanning
    • + +
  • +The scsi bus or the whole system freezes
    • + +
  • +The image is corrupted
    • + +


    In general there are three different reasons +that can cause such erros: +

    +
  • +In most cases it is a problem with your scsi bus. +Please check the following points:
    • + +
    +
  • +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.
    • + +
  • +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.
    • + +
  • +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.
    • + +
  • +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.
    • +
    + +
  • +The driver for your scsi controller does not work +like expected. Update your scsi driver if you do not have the most recent +version.
    • + +
    If that does not help try it with an other type +of scsi card. +
      +
  • +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.
    • +
    + +
      +
  • +Please read the documentation of the backend you use
    • +
    +If you tested everything above and you still need +help: contact the backend/frontend author or to the sane +mailling list (you must be subscribed to the list).
    + + + 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 @@ + + + + + + + + SANE-Backends + + +  +
    +
    + +
    +

    +Scantips - links to the web

    +  +

      +
      +
      +
      +
      +
      +
     

    + +

    +If you are looking for some tips about scanning, desktoppublishing etc, +take a look at these links:

    + +
    +
    +
  • +http://www.scantips.com/
    • + +
  • +http://www.infomedia.net/scan/
    • + +
  • +http://www.hsdesign.com/scanning/
    • + +
  • +http://desktoppublishing.com/
    • +
    +
    + + + 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 @@ + + + + + + + + XSane - Advanced options + + +  +
    +
    + +
      +
    +

    +Advanced options window

    +  +

      +
      +
      +
      +
      +
      +
     

    + +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-advanced.jpg b/doc/sane-xsane-advanced.jpg new file mode 100644 index 0000000..309aa72 Binary files /dev/null and b/doc/sane-xsane-advanced.jpg differ 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 @@ + + + + + + + + XSane - Copy mode + + +  +

    +
    + +
      +

    +Copy mode

    +
    + +
     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. +
      +
      +
      +
     
    + +
    + +
      +
    The options of the printer and the printer command can be set in the +menu +Preferences/Setup
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-copy.jpg b/doc/sane-xsane-copy.jpg new file mode 100644 index 0000000..13c1cd9 Binary files /dev/null and b/doc/sane-xsane-copy.jpg differ 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 @@ + + + + + + + + XSane - Documentation index + + +  +

    +
    + +
    +

    +
    +

    + +

    +

    + +

    +

    + +

    +
    +Index of xsane documentation

    + +
      +
      +
      +
     
    +
    + +
    +
  • +Xsane modes:
    • + +
    +
    +
  • +Scan mode
    • + +
  • +Copy mode
    • + +
  • +Fax mode
    • + +
  • +Gimp plugin
    • +
    +
    + +
  • +Scanner option windows:
    • + +
    +
    +
  • +Standard options +window
    • + +
  • +Advanced options +window
    • +
    +
    + +
  • +Preview
    • + +
    +
    +
  • +Pipette +white
    • + +
  • +Pipette +gray
    • + +
  • +Pipette +black
    • + +
  • +Unzoom
    • + +
  • +Zoom +out
    • + +
  • +Zoom +in
    • + +
  • +Undo +zoom
    • + +
  • +Select +visible area
    • + +
  • +Select +scanarea
    • + +
  • +Move +scanarea
    • + +
     
    +
    + +
  • +Enhancement +functions:
    • + +
    +
    +
  • +Gamma +correction
    • + +
  • +Brightness
    • + +
  • +Contrast
    • + +
  • +RGB +default
    • + +
  • +Negative
    • + +
  • +Autoenhancement
    • + +
  • +Enhancement +default
    • + +
  • +Restore +enhancement
    • + +
  • +Store +enhancement
    • + +
      +
  • +Pipette +white
    • + +
  • +Pipette +gray
    • + +
  • +Pipette +black
    • + +
      +
  • +Histogram +window
    • + +
  • +Highlight/White point
    • + +
  • +Shadow/Black point
    • + +
  • +Gamma/Gray point
    • +
    +
    + +
  • +Setup:
    • + +
    +
    +
  • +Copy setup
    • + +
  • +Display +setup
    • + +
  • +Saving setup
    • + +
  • +Fax setup
    • +
    +
    + +
  • +Supported functions:
    • + +
    +
    +
  • +Support for 9-16 bits/sample
    • + +
  • +Output formats
    • + +
  • +Automatic filename generation
    • + +
  • +Automatic Document Feeder
    • +
    +
    +
    + +
    +
    Author: Oliver +Rauch +

    Homepage +of xsane

    + + + 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 @@ + + + + + + + + XSane - Enhancement + + +  +
    +
    + +
      +
    +

    +Enhancement

    +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.
    + +
    + +
      +
    + Gamma correction:
    + +
    The gamma correction is a non linear correction. Black keeps +black and white keeps white +
    if the gamma value is greater than 1.0 the gray intensities +are brightned +
    if the gamma value is smaller than 1.0 the gray intensities are darkend
    +
    + +
    + Brightness:
    + +
    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).
    + +
    + Contrast:
    + +
    positive values increase the contrast of the image. Medium +gray keeps medium gray (8 bits: 128) +
    -100% means that all colors become medium gray +
    +100% means that the difference between a value and medium gray is +doubled
    +
    + +
    + RGB default:
    + +
    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.
    + +
    + Negative:
    + +
    This option inverts the intensities (black <-> white). +It is for scanning negatives. +

    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.

    + +
    + Autoenhancement:
    + +
    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. +
    If RGB default is disabled, the components for each color are set +individually.
    + + Enhancement default: +
    Sets the enhancement values to default: gamma=1.0, brightness=0%, +contrast=0%.
    + +
    + Restore enhancement:
    + +
    Restores the enhancement values from preferences.
    + +
    + Store enhancement (Memory):
    + +
    tore selected enhancement values to preferences.
    +
    + +
    +
    +
    INDEX
    + +


    + + 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 @@ + + + + + + + + XSane - Fax mode + + + +

    +

    +

    + 
    + +
    +

    +Fax mode

    +This mode is a Frontend for SANE and for a faxprogram like hylafax or mgetty+sendfax +
      +
      +
      +
      +
     
    + +
       
    + +


    +

    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 +Preferences/Setup.
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-fax-project.jpg b/doc/sane-xsane-fax-project.jpg new file mode 100644 index 0000000..03048b8 Binary files /dev/null and b/doc/sane-xsane-fax-project.jpg differ diff --git a/doc/sane-xsane-fax.jpg b/doc/sane-xsane-fax.jpg new file mode 100644 index 0000000..60d1065 Binary files /dev/null and b/doc/sane-xsane-fax.jpg differ 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 @@ + + + + + + + + XSane - Gimp plugin + + +  +

    +
    + +
    +

    +Xsane as Gimp plugin

    +If xsane is started as Gimp plugin, the scanned image +automatically is transfered to the Gimp. +
      +
      +
      +
     
    + +
    + +
      +

    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: +

    +
    ln -s /usr/local/bin/xsane ~/.gimp/plug-ins/
    +
    +if you use gimp-1.1.x, you have to do: +
    +
    ln -s /usr/local/bin/xsane ~/.gimp-1.1/plug-ins/
    +
    +You can start xsane from the GIMP menu Xtns/Xsane if GIMP-version +< 1.1.9, since GIMP-version-1.1.9 you can start xsane from the GIMP +menu File/Acquire. It contains short-cuts to the SANE devices that +were available at the time xsane was queried.
    + +
    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. +

    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!

    + +
    +


    +

    INDEX
    + +


    + + diff --git a/doc/sane-xsane-gimp.jpg b/doc/sane-xsane-gimp.jpg new file mode 100644 index 0000000..f183d42 Binary files /dev/null and b/doc/sane-xsane-gimp.jpg differ 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 @@ + + + + + + + + XSane - Histogram + + +  +

    +
    + +
    +

    +Histogram window

    +  +

      +
      +
      +
      +
      +
      +
      +
     

    + +
    + +


    +

    +
    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 rgb default button (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. +

    The I, R, G and B buttons define if the +intensity, red, green and/or blue histogram +components are shown. +

    The curve-type button defines if the histogram curves are shown with +pixels or with lines. +

    The LOG button defines if the densities are displayed linear +or logarithmical.

    +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-histogram.jpg b/doc/sane-xsane-histogram.jpg new file mode 100644 index 0000000..a13a912 Binary files /dev/null and b/doc/sane-xsane-histogram.jpg differ 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 @@ + + + + + + + SANE - XSane frontend + + + +

     
    + +
    +
    +
    + +
    +
    + a scanner-frontend for ->SANE.
    + +
    +
    + 
    + +
    +
    + +
     
    + +
    +

    +The main window

    +  +
    + +
     
    +
    + + + diff --git a/doc/sane-xsane-pipette-black.jpg b/doc/sane-xsane-pipette-black.jpg new file mode 100644 index 0000000..8508f14 Binary files /dev/null and b/doc/sane-xsane-pipette-black.jpg differ diff --git a/doc/sane-xsane-pipette-gray.jpg b/doc/sane-xsane-pipette-gray.jpg new file mode 100644 index 0000000..72211f3 Binary files /dev/null and b/doc/sane-xsane-pipette-gray.jpg differ diff --git a/doc/sane-xsane-pipette-white.jpg b/doc/sane-xsane-pipette-white.jpg new file mode 100644 index 0000000..b8b8b0f Binary files /dev/null and b/doc/sane-xsane-pipette-white.jpg differ 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 @@ + + + + + + + + XSane - Preview + + + +
    +

    +

    +  +

     

    + +
    +

    +Preview window

    +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. +
      +
      +
      +
     
    + +
    + +


    +

      +
    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.
    + +
    Pipette +white: +
    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 RGB default (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.
    + +
    + Pipette +gray:
    + +
    +
    +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 RGB default (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.
    +
    + +
    + Pipette +black:
    + +
    +
    +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 RGB default (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.
    +
    + +
    + Unzoom:
    + +
    +
    +Use full scan area.
    +
    + +
    + Zoom +out:
    + +
    +
    +Increase preview area by 20%.
    +
    + +
    + Zoom +in:
    + +
    +
    +Zoom into selected area.
    +
    + +
    + Undo +zoom:
    + +
    +
    +Undo last zoom.
    +
    + +
    + Select +visible area:
    + +
    +
    +Select the visible area in the preview window for scanning.
    +
    + +
    +Acquire Preview:
    + +
    +
    +Start preview scan. If you resized the preview window, the new preview +is done with updated resolution.
    +
    + +
    +Cancel Preview:
    + +
    +
    +Cancel a preview scan.
    + +
    +
    +
    + +
    +Left mouse button:
    + +
    +
    +Select scan area: 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.
    +
    + +
    +Edit scan area: 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.
    +
    + +
    +Right and middle mouse button:
    + +
    +
    +If you press (&hold) the right or the middle mouse button in the selection +frame you can move the selection frame without resizing it.
    +
    +
    + +
    +
    +
     
    +
    +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-preview.jpg b/doc/sane-xsane-preview.jpg new file mode 100644 index 0000000..892e8d8 Binary files /dev/null and b/doc/sane-xsane-preview.jpg differ 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 @@ + + + + + + + + XSane - Scan mode + + +  +

    +
    + +
      +
    +

    +Scan mode (stand alone)

    +The scan mode is to scan an image and save it to a file. +
      +
      +
     
    + +
    + +
     
    + +

    +Supported output formats:

    + +
    You can select the output format by the filename extension +(menu = "by ext") or by selecting the file format in the menu. Possible +are: pnm, png, ps, jpeg, raw and tiff.
    + +
    Pnm and ps (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 png you need +libpng and libz, for jpeg you need jpeglib, for tiff you +need libtiff.
    + +
    The raw format is a 16 bit format comparable to 16 bit +binary pnm format that is not defined, for pnm the 16 bit +format only is defined as ascii mode which generates huge and slow files.
    + +
    The supported output formats depend on the bit depth of +the scanned image: +

    +1 bit/pixel black/white mode:

    + +
    pnm = pbm, png +
    ps, jpeg and tiff are converted to 8 bit grayscale +mode.
    + +

    +8 bits/pixel grayscale mode:

    + +
    pnm = pgm, png, ps, jpeg and tiff
    + +

    +16 bits/pixel grayscale mode (9-16 bits):

    + +
    pnm (ascii), png and raw
    + +

    +24 bits/pixel RGB-color mode (8 bits/color):

    + +
    pnm = ppm, png, ps, jpeg and tiff
    + +

    +48 bits/pixel RGB-color mode (9-16 bits/color):

    + +
    pnm (ascii), png and raw
    + +

    +32 bits/pixel RGBA-color mode (8 bits/color):

    + +
    rgba (raw) and png with alpha channel
    + +

    +64 bits/pixel RGBA-color mode (9-16 bits/color):

    + +
    rgba (raw) and png with alpha channel
    +
    + +
    +
    +
    INDEX
    + +


    +
    + + 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 @@ + + + + + + + + XSane - Setup + + +  +

    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +

    +Copy setup

    +  +

      +
      +
      +
      +
      +
      +
      +
     

    + +
    + +
    +

    +NAME:

    +
    + +
    +
    Define the name for the following printer definition.
    + +

    +COMMAND:

    + +
    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 +-".
    +
    + +
    +

    +COPY NUMBER OPTION:

    +
    + +
    +
    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.
    + +

    +RESOLUTION:

    + +
    With resolution 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.
    + +

    +PRINT AREA (WIDTH, HEIGHT, LEFT OFFSET, BOTTOM OFFSET):

    + +
    Each printer has it's own area size and position where it is +able to print.
    + +

    +PRINTER GAMMA VALUES:

    + +
    Addidtional gamma value for printing. The Printer gamma +value is used for grayscale and as common value for color mode. The +red, green and blue values are for color correction.
    +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-setup-copy.jpg b/doc/sane-xsane-setup-copy.jpg new file mode 100644 index 0000000..abe3d35 Binary files /dev/null and b/doc/sane-xsane-setup-copy.jpg differ 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 @@ + + + + + + + + XSane - Setup + + +  +

    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +

    +Display setup

    +
    + +
      +
      +
      +
      +
      +
      +
     
    + +

    +

    + +
    +


    + +


    +

    +

    +MAIN WINDOW SIZE FIXED:

    +
    + +
    +
    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.
    +
    + +
    +

    +PRESERVE PREVIEW IMAGE:

    +
    + +
    +
    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.
    + +

    +USE PRIVATE COLORMAP:

    + +
    If enabled and if the X server runs in 8 bit mode (256 colors) +then the preview uses an own color map.
    + +

    +PREVIEW GAMMA:

    + +
    Set the gamma correction value for the preview image. This +is to get correct colors on your monitor.
    + +

    +HELPFILE VIEWER:

    + +
    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.
    +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-setup-display.jpg b/doc/sane-xsane-setup-display.jpg new file mode 100644 index 0000000..e7d9d92 Binary files /dev/null and b/doc/sane-xsane-setup-display.jpg differ 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 @@ + + + + + + + + XSane - Setup + + +  +

    +
    + +
    +

    +Fax setup

    +  +

      +
      +
      +
      +
      +
      +
      +
      +
     

    + +
    + +


    +

    +

    +COMMAND:

    + +
    Enter command to send/spool faxfiles. +
    +hylafax: "sendfax"
    + +
    +mgetty+sendfax: "faxspool"
    +
    + +

    +RECEIVER OPTION:

    + +
    Option to set receiver phone number or address. +
    +hylafax: "-d"
    + +
    +mgetty+sendfax: leave free
    +
    + +

    +POSTSCRIPTFILE OPTION:

    + +
    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. +
    +hylafax: leave free
    + +
    +mgetty+sendfax: leave free
    +
    + +

    +NORMAL MODE OPTION:

    + +
    If there is an option to set normal mode (98lpi) then enter +this option - otherwise let this field free. +
    +hylafax: "-l"
    + +
    +mgetty+sendfax: "-n"
    +
    + +

    +FINE MODE OPTION:

    + +
    If there is an option to set fine mode (196lpi) then enter +this option - otherwise let this field free. +
    +hylafax: "-m"
    + +
    +mgetty+sendfax: leave free
    +
    + +

    +VIEWER:

    + +
    Enter a program to show the postscript fax files on the screen. +
    E.g. this can be "ghostscript" or "xv".
    +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-setup-fax.jpg b/doc/sane-xsane-setup-fax.jpg new file mode 100644 index 0000000..f2e66de Binary files /dev/null and b/doc/sane-xsane-setup-fax.jpg differ 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 @@ + + + + + + + + XSane - Setup + + +  +

    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +

    +Saving setup

    +  +

      +
      +
      +
     

    + +
     
    + +

    +

    + +
    +


    + +


    +

    +

    +OVERWRITE WARNING:

    +
    + +
    +
    If enabled, a warning comes up before an existing file is overwritten.
    + +

    +INCREASE FILENAME COUNTER:

    + +
    If enabled, the number in the filename of the following form +is automatically increased after a scan is completed: +
    image-001.ext
    +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.
    + +
    If an automatic document feeder is used the filename should +contain a counter and this option should be enabled.
    + +

    +SKIP EXISTING NUMBERS:

    + +
    If increase filename counter is enabled, filenames that +already exist are skipped!
    + +

    +JPEG IMAGE QUALITY:

    + +
    If the image is saved in jpeg 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.
    + +

    +PNG IMAGE COMPRESSION:

    + +
    If the image is saved in png 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.
    +
    + +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-setup-save.jpg b/doc/sane-xsane-setup-save.jpg new file mode 100644 index 0000000..07b6a22 Binary files /dev/null and b/doc/sane-xsane-setup-save.jpg differ 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 @@ + + + + + + + + XSane - Standard options + + +  +

    +
    + +
    +

    +Standard options window

    +  +

      +
      +
      +
      +
      +
     

    + +
    +
    +
    +
    INDEX
    + +


    + + diff --git a/doc/sane-xsane-standard.jpg b/doc/sane-xsane-standard.jpg new file mode 100644 index 0000000..13be214 Binary files /dev/null and b/doc/sane-xsane-standard.jpg differ diff --git a/doc/sane-xsane-visible-area.jpg b/doc/sane-xsane-visible-area.jpg new file mode 100644 index 0000000..117a5ba Binary files /dev/null and b/doc/sane-xsane-visible-area.jpg differ diff --git a/doc/sane-xsane-zoom-in.jpg b/doc/sane-xsane-zoom-in.jpg new file mode 100644 index 0000000..dc73335 Binary files /dev/null and b/doc/sane-xsane-zoom-in.jpg differ diff --git a/doc/sane-xsane-zoom-not.jpg b/doc/sane-xsane-zoom-not.jpg new file mode 100644 index 0000000..b239646 Binary files /dev/null and b/doc/sane-xsane-zoom-not.jpg differ diff --git a/doc/sane-xsane-zoom-out.jpg b/doc/sane-xsane-zoom-out.jpg new file mode 100644 index 0000000..9e20fc1 Binary files /dev/null and b/doc/sane-xsane-zoom-out.jpg differ diff --git a/doc/sane-xsane-zoom-undo.jpg b/doc/sane-xsane-zoom-undo.jpg new file mode 100644 index 0000000..11e0890 Binary files /dev/null and b/doc/sane-xsane-zoom-undo.jpg differ diff --git a/doc/sane-xsane.jpg b/doc/sane-xsane.jpg new file mode 100644 index 0000000..31c37af Binary files /dev/null and b/doc/sane-xsane.jpg differ diff --git a/doc/store.jpg b/doc/store.jpg new file mode 100644 index 0000000..e1223df Binary files /dev/null and b/doc/store.jpg differ diff --git a/doc/xsane-logo.jpg b/doc/xsane-logo.jpg new file mode 100644 index 0000000..596f3da Binary files /dev/null and b/doc/xsane-logo.jpg differ diff --git a/doc/xsane-logo2.jpg b/doc/xsane-logo2.jpg new file mode 100644 index 0000000..133c3c7 Binary files /dev/null and b/doc/xsane-logo2.jpg differ 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) -- cgit v1.2.3