"Fossies" - the Fresh Open Source Software Archive

Member "gimp-2.10.28/plug-ins/twain/README" (14 Sep 2021, 4025 Bytes) of package /linux/misc/gimp-2.10.28.tar.bz2:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 TWAIN Plug-in
    2 Copyright (C) 1999 Craig Setera
    3 Craig Setera <setera@home.com>
    4 03/31/1999
    5 
    6 Updated for Mac OS X support
    7 Brion Vibber <brion@pobox.com>
    8 07/22/2004
    9 
   10 This program is free software: you can redistribute it and/or modify
   11 it under the terms of the GNU General Public License as published by
   12 the Free Software Foundation; either version 3 of the License, or
   13 (at your option) any later version.
   14 
   15 This program is distributed in the hope that it will be useful,
   16 but WITHOUT ANY WARRANTY; without even the implied warranty of
   17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18 GNU General Public License for more details.
   19 
   20 You should have received a copy of the GNU General Public License
   21 along with this program.  If not, see <https://www.gnu.org/licenses/>.
   22 
   23 Based on (at least) the following plug-ins:
   24 Screenshot
   25 GIF
   26 Randomize
   27 
   28 Any suggestions, bug-reports or patches are welcome.
   29  
   30 This plug-in interfaces to the TWAIN support library in order
   31 to capture images from TWAIN devices directly into GIMP images.
   32 The plug-in is capable of acquiring the following type of
   33 images:
   34  - B/W (1 bit images translated to grayscale B/W)
   35  - Grayscale up to 16 bits per pixel
   36  - RGB up to 16 bits per sample (24, 30, 36, etc.)
   37  - Paletted images (both Gray and RGB)
   38 
   39 Prerequisites:
   40  Should compile and run on both Win32 and Mac OS X 10.3 (possibly
   41  also on 10.2).
   42 
   43 Known problems:
   44 
   45  - Multiple image transfers will hang the plug-in.  The current
   46    configuration compiles with a maximum of single image transfers.
   47  - On Mac OS X, canceling doesn't always close things out fully.
   48  - Epson TWAIN driver on Mac OS X crashes the plugin when scanning.
   49  
   50 Debugging:
   51  There are two different versions of the program included, a standard
   52  version and a version built for debugging.  The debugging version is
   53  a special version capable of capturing the TWAIN datasource data to
   54  a file for later processing.  This feature can be used to create a data
   55  dump that can be sent to me if for some reason the plug-in fails for
   56  your TWAIN datasource.  The function of the plug-in is controlled by
   57  the name of the executable file.  The plug-in should be placed in your
   58  plug-ins directory and named as follows:
   59 
   60 twain.exe - This is the standard (non-debugging) version.  This file will
   61   not behave differently if renamed.  This version is intended to be used
   62   unless your TWAIN datasource has some problem.
   63 
   64 gtwain.exe - This is the debugging version of the program shipped along.
   65   If this program is used as named, it will behave the same as "twain.exe"
   66   except that the file C:\twain.log will be written.  This file is a text
   67   file with very little information available for debugging.
   68 
   69 dtwain.exe - Renaming "gtwain.exe" to "dtwain.exe" in your plug-ins directory
   70   will change the behavior of the plug-in.  The menu option will be registered
   71   as "TWAIN Acquire (Dump)..." and will cause the TWAIN acquire operation to
   72   be dumped to the file "C:\twaincap.bin".  This file contains all of the data
   73   necessary to recreate the capture on another system (such as my machine).  The
   74   image will not be displayed, as it might cause the plug-in to crash making
   75   the data useless.  Instead, a message will be displayed that the image
   76   information was dumped to a file.
   77 
   78 rtwain.exe - Renaming "gtwain.exe" to "rtwain.exe" in your plug-ins directory
   79   will change the behavior of the plug-in.  The menu option will be registered
   80   as "TWAIN Acquire (Read)..." and will cause the TWAIN acquire operation to
   81   read a previously dumped (using dtwain.exe) TWAIN acquire from 
   82   "C:\twaincap.bin".
   83 
   84 If you find that you are unable to capture data from you datasource (the plug-in
   85 crashes or the image is wrong), please capture data using the following steps:
   86 
   87 1) Copy gtwain.exe to your plug-ins directory as "dtwain.exe".
   88 2) Run GIMP.
   89 3) Choose Xtns->TWAIN Acquire (Dump)...
   90 4) Choose the datasource settings that are causing problems.
   91 5) Choose a *SMALL* sample image.
   92 6) Zip up "C:\twaincap.bin" and "C:\twain.log" and send them to me.