From 1145733c29db0a678537ce99ff60e21613f622a8 Mon Sep 17 00:00:00 2001 From: Igor Pashev Date: Fri, 6 Jan 2023 10:02:49 +0200 Subject: Import iscan 2.30.4-2 --- doc/Makefile.am | 46 ++++++++++ doc/iscan-registry.man | 49 +++++++++++ doc/iscan.man | 89 +++++++++++++++++++ doc/sane-epkowa.man | 225 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/xinetd.sane | 15 ++++ 5 files changed, 424 insertions(+) create mode 100644 doc/Makefile.am create mode 100644 doc/iscan-registry.man create mode 100644 doc/iscan.man create mode 100644 doc/sane-epkowa.man create mode 100644 doc/xinetd.sane (limited to 'doc') diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..d29fcc1 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,46 @@ +## Makefile.am -- an automake template for a Makefile.in file +## Copyright (C) 2004 Olaf Meeuwissen +## +## This file is part of the "Image Scan!" build infra-structure. +## +## The "Image Scan!" build infra-structure is free software. +## You can redistribute it and/or modify it under the terms of the GNU +## General Public License as published by the Free Software Foundation; +## either version 2 of the License or at your option any later version. +## +## This program is distributed in the hope that it will be useful, but +## WITHOUT ANY WARRANTY; without even the implied warranty of FITNESS +## FOR A PARTICULAR PURPOSE or MERCHANTABILITY. +## See the GNU General Public License for more details. +## +## You should have received a verbatim copy of the GNU General Public +## License along with this program; if not, write to: +## +## Free Software Foundation, Inc. +## 59 Temple Place, Suite 330 +## Boston, MA 02111-1307 USA + +man_MANS = \ + sane-epkowa.5 \ + iscan-registry.8 + +if ENABLE_FRONTEND +man_MANS += iscan.1 +endif + + +EXTRA_DIST = \ + sane-epkowa.man \ + iscan.man \ + iscan-registry.man \ + xinetd.sane + +CLEANFILES = $(man_MANS) + +configdir = $(sysconfdir)/sane.d + +%.1 %.5 %.8: %.man + @sed -e 's|@CONFIGDIR@|$(configdir)|g' \ + -e 's|@LIBDIR@|$(libdir)/sane|g' \ + $^ >$@ + @echo Generating manpage $@... diff --git a/doc/iscan-registry.man b/doc/iscan-registry.man new file mode 100644 index 0000000..fc41f06 --- /dev/null +++ b/doc/iscan-registry.man @@ -0,0 +1,49 @@ +.TH ISCAN-REGISTRY 8 "2011-04-11" "Image Scan! for Linux" "System Administration Utilities" +.SH NAME +iscan-registry \- (un)register iscan interpreter plugins +.SH SYNOPSIS +.B iscan-registry +\fI--help | --version\fR +.br +.B iscan-registry +\fI--add \fR +.br +.B iscan-registry +\fI--remove \fR +.SH DESCRIPTION +\&'iscan\-registry' updates the run\-time data for Image Scan! for Linux +.PP +Image Scan! for Linux plugins may need to (un)register themselves. +This utility gives plugins a common interface to do just that. You +should not need to use this utility manually. +.PP +The following options are supported: +.TP +\fB\-h\fR, \fB\-\-help\fR +displays this message and exit +.TP +\fB\-v\fR, \fB\-\-version\fR +displays program version and exit +.TP +\fB\-a\fR, \fB\-\-add\fR +adds a plugin to the run\-time data +.TP +\fB\-r\fR, \fB\-\-remove\fR +removes a plugin from the run\-time data +.PP +The following s are supported: +.IP +interpreter usb [] +.PP +The and are the USB IDs in hexadecimal +notation, prefixed with '0x'. and optional +are pathnames to the corresponding files. +Note that the pathname should not include an extension. +.SH AUTHOR +Written by AVASYS CORPORATION. +.SH COPYRIGHT +Copyright \(co 2008 SEIKO EPSON CORPORATION +.br +This is free software. You may redistribute copies of it under the +terms of the GNU General Public License, version 2 or later. +See for details. diff --git a/doc/iscan.man b/doc/iscan.man new file mode 100644 index 0000000..10505b1 --- /dev/null +++ b/doc/iscan.man @@ -0,0 +1,89 @@ +.TH ISCAN 1 "2011-10-19" "Image Scan! for Linux" "User Commands" +.IX iscan +.SH NAME +iscan - Image Scan! for Linux SANE frontend +.SH DESCRIPTION +.B Image Scan! for Linux +(iscan) provides a graphical user-interface to control +EPSON scanners. It allows the previewing and scanning of images. +.B iscan +can be invoked either from the command-line or +through the GIMP image manipulation program. + +When run from the command line, +.B iscan +acts as a stand-alone program that saves acquired images in PNM, PNG, +JPEG, TIFF, PCX or PDF format. Alternatively, acquired images can be sent +directly to a printer, provided your print system handles PNG natively. +CUPS and Photo Image Print System, versions 1.3.1 and later, do this. +LPRng and other LPD based printer systems may need a little help. +Refer to your print system's documentation for more information on how +to set this up. When run as a GIMP plugin, the images are passed to +the GIMP for further processing. + +.B iscan +accesses EPSON image acquisition devices through the SANE (Scanner +Access Now Easy) interface. + +.SH RUNNING UNDER THE GIMP +As of version 1.15.0, +.B iscan +is automatically registered as a +.BR gimp (1) +plugin if you install the binary package. In case it didn't (because +you built from source for example), you can register it yourself by +creating a symbolic link from the +.B iscan +binary to one of the +.BR gimp (1) +plug-ins directories. For example, for gimp-1.2.x the command +.PP +.RS +ln -s /usr/bin/iscan ~/.gimp-1.2/plug-ins/ +.RE +.PP +adds a symlink for the +.B iscan +binary to the user's plug-ins directory. Your system administrator +can register it for all users by creating a symbolic link in the +.BR gimp (1) +system plug-ins directory. After creating such a symlink, +.B iscan +will be queried by +.BR gimp (1) +the next time it's invoked. From then on, +.B iscan +can be invoked through "Xtns->Acquire Image->Scanning (iscan)" menu +entry. +.SH PRINTER SETUP +When not using the default printer , it is necessary to input the +printer name from /etc/printcap into the Print Command field of the +Configuration dialog. For example, if the printer name is pm900c, +input the following command. +.PP +.RS +lpr -Ppm900c +.SH EPSON Scan! for Linux WORKFLOW +Use the following steps to scan an image with iscan. +.PP +.RS +.br +1. Select the document source. +.br +2. Select the image type. +.br +3. Preview the full page. +.br +4. Create a marquee (frame) of the image area to scan. +.br +5. Auto expose the selected area. +.br +6. Select the image destination. +.br +7. Scan the final image. +.RE +.SH SEE ALSO +gimp(1), gimptool(1), scanimage(1), sane-scsi(5), sane\-dll(5), +sane\-net(5), sane\-"backendname"(5) +.SH AUTHOR +Noriyoshi Sasaki and Peter Schretlen diff --git a/doc/sane-epkowa.man b/doc/sane-epkowa.man new file mode 100644 index 0000000..dcfa19c --- /dev/null +++ b/doc/sane-epkowa.man @@ -0,0 +1,225 @@ +.TH SANE\-EPKOWA 5 "2012-03-05" "Image Scan! for Linux" +.IX sane\-epkowa +.SH NAME +sane\-epkowa - SANE backend for EPSON scanners +.SH DESCRIPTION +The +.B sane\-epkowa +library implements a SANE (Scanner Access Now Easy) backend that +provides access to a large number of EPSON devices. A list with +supported device information may be found in the +.I iscan-data +package's documentation directory, typically +.I /usr/share/doc/iscan-data/. + +.SH OPTIONS +The options the backend supports can either be selected through command line +options to programs like scanimage or through GUI elements in xscanimage or xsane. + +Valid command line options and their syntax can be listed by using +.RS +scanimage \-\-help \-d epkowa +.RE +Not all devices support all options and not all options may be docmented below. +.TP +.I Scan Mode +The +.I \-\-mode +switch selects the basic mode of operation of the scanner valid choices are +.I Binary, Gray and Color. +The Binary mode is black and white only, Gray will produce up to 256 levels of gray +and Color means 24 bit color mode. Some scanners will internally use 36 bit color, +the external interface however does only support 24 bits. + +The +.I \-\-halftoning +switch selects the mode that is used in Binary mode. Valid options are None, +Halftone A (Hard Tone), Halftone B (Soft Tone), Halftone C (Net Screen), +Dither A (4x4 Bayer), Dither B (4x4 Spiral), Dither C (4x4 Net Screen), +Dither D (8x4 Net Screen), Text Enhanced Technology, Download pattern A, +and Download pattern B. + +The +.I \-\-dropout +switch selects the so called dropout color. Valid options are None, Red, Green +and Blue. The default is None. The dropout color is used for +monochrome scanning and selects the color that is not scanned. This can be used +to e.g. scan an original with a colored background. + +The +.I \-\-brightness +switch controls the brightness of the scan. Valid options are the numbers from \-3 to +3. The default is 0. The larger the brightness value, the brighter the image gets. If +a user defined table for the gamma correction is selected, the brightness parameter is +not available. + +The +.I \-\-sharpness +switch sets the sharpness of the image data. Valid options are the numbers from \-2 to +2, with \-2 meaning "Defocus", \-1 "Defocus slightly", 0 "Normal", 1 "Sharpen slighly" +and 2 "Sharpen". + +The +.I \-\-gamma\-correction +switch controls the scanner's internal gamma correction. Valid options are "Default", "User +defined", "High density printing" "Low density printing" and "High contrast printing". + +The +.I \-\-color\-correction +switch controls the scanner's internal color correction function. Valid options are "No +Correction", "Impact\-dot printers", "Thermal printers", "Ink\-jet printers" and "CRT +monitors". The default is "CRT monitors". + +The +.I \-\-resolution +switch selects the resolution for a scan. Many EPSON scanners will scan in any resolution between +the lowest and highest possible value. The list reported by the scanner can be displayed using +the "\-\-help \-d epkowa" parameters to scanimage. + +The +.I \-\-mirror +option controls the way the image is scanned. By reading the image data from right to left the +image is mirored. Valid options are "yes" and "no". The default is "no". + +The +.I \-\-speed +option can improve the scan speed in monochrome mode. Valid options are "yes" or "no", the "yes" +option will speed up the scan if this option is supported. + +The +.I \-\-auto\-area\-segmentation +switch turns on the automatic area segmentation for monochrome scans. The scanner will try to +determine which areas are text and which contain images. The image areas will be halftoned, +and the text will be impoved. Valid options are "yes" and "no". The default is "yes". + +The +.I \-\-gamma\-table +parameter can be used to download a user defined gamma table. The options takes 256 values from +the range 0..255. In color mode this option equally affects the red, green, and blue channel. + +The +.I \-\-red\-gamma\-table +parameter can be used to download a user defined gamma table for the red channel. The valid +options are the same as for \-\-gamma\-table. + +The +.I \-\-green\-gamma\-table +parameter can be used to download a user defined gamma table for the green channel. The valid +options are the same as for \-\-gamma\-table. + +The +.I \-\-blue\-gamma\-table +parameter can be used to download a user defined gamma table for the blue channel. The valid +options are the same as for \-\-gamma\-table. + +The color correction coefficients +.I \-\-cct\-1 \-\-cct\-2 \-\-cct\-3 ... \-\-cct\-9 +will install color correction coefficients for the user defined color correction. Possible +values are in the range \-127..127. + + +The +.I \-\-preview +option requests a preview scan. The frontend software automatically selects a low +resolution. Valid options are "yes" and "no". The default is "no". + +The +.I \-\-preview\-speed +options will increase the scan speed if this is supported by the scanner. Valid options +are "yes" and "no", the default is "no". + + +The geometry options +.I \-l \-t \-x \-y +control the scan area: \-l sets the top left x coordinate, \-t the top left y coordinate, +\-x selects the width and \-y the height of the scan aea. All parameters are specified in +milimeters. + +The +.I \-\-quick\-format +option lets the user select a scan area with predefined sizes. Valid parameters are "CD", +"A5 portrait", "A5 landscape", "Letter", "A4" and "max". The default is "max", which +selects the largest possible area. + +The +.I \-\-source +option selects the scan source. Valid options depend on the installed options. The default +is "Flatbed". + +The +.I \-\-auto\-eject +option will eject a page after scanning from the document feeder. + + +.SH CONFIGURATION FILE +The configuration file @CONFIGDIR@/epkowa.conf specifies the device(s) that the +backend will use. Possible connection types are: +.TP +.I USB +All supported USB devices should be recognised automatically when the +"usb" keyword is specified. You may have to add yourself to a +specific system group though to get the privileges required to access +the device. See the configuration file for information on how to get +unsupported devices recognised. +.TP +.I SCSI +The "scsi" keyword activates detection of supported SCSI devices. If +your device is not recognised despite this see the configuration file +for more information. +.TP +More extensive documentation is available in the comments of the +default configuration file. +.SH FILES +.TP +.I @LIBDIR@/libsane\-epkowa.a +The static library implementing this backend. +.TP +.I @LIBDIR@/libsane\-epkowa.so +The shared library implementing this backend (present on systems that +support dynamic loading). +.SH ENVIRONMENT +.TP +.B SANE_DEBUG_EPKOWA +If the library was compiled with debug support enabled, this +environment variable controls the debug level for this backend. The +following, case insensitive string literals are supported (in +increasing level of feedback): FATAL, MAJOR, MINOR, INFO, CALL, DATA, +CMD, HEX, IMG. Note that the last level includes the raw image data +as obtained from the scanner and produces vast amounts of output. For +most trouble shooting situations, the HEX level is sufficient. + +.TP +.B SANE_EPSON_CMD_LVL +This allows to override the function or command level that the backend +uses to communicate with the scanner. The function level a scanner +supports is determined during the initialization of the device. If the +backend does not recognize the function level reported by the scanner +it will default to function level B5. Valid function levels include +A1, A2, B1, B2, B3, B4, B5, B6, B7, B8, D1, D2, D7, D8 and F5. Use +this feature only if you know what you are doing! + +.SH "SEE ALSO" + +sane\-scsi(5), scanimage(1), xscanimage(1), xsane(1) + +.SH BUGS +Sometimes the scanner is not initialized correctly. The problem can be +resolved by killing the program and restarting it again. + +.SH UNSUPPORTED DEVICES +Note that a number of EPSON scanners require a non-free plugin before +they can be used by the backend. + +The backend may be used with EPSON scanners that are not yet listed +under the list of supported devices. A scanner that is not recognized +may default to the function level B3, which means that not all +functions that the scanner may be capable of are accessible. + +If the scanner is not even recognized as an EPSON scanner it is +probably because the device info reported by the scanner is not in +the correct format. Please send this information to the sane-devel +mailing list. + +.SH AUTHOR + +AVASYS CORPORATION diff --git a/doc/xinetd.sane b/doc/xinetd.sane new file mode 100644 index 0000000..f3af497 --- /dev/null +++ b/doc/xinetd.sane @@ -0,0 +1,15 @@ +# default: off +# description: SANE network scanner daemon +# Please note that this service is registered by the IANA under +# the name "sane-port". If your /etc/services file only has a +# sane-port entry, rename the service in this file to match it. +# Alternatively, you can add an alias in /etc/services. +service sane +{ + disabled = no + port = 6566 + socket_type = stream + wait = no + user = root + server = /usr/sbin/saned +} -- cgit v1.2.3