XSane

README for XSane 0.992 for OS/2: ================================ This is the 20. Version of XSane for OS/2. It may have bugs. It is not tested very well but short tests looked very good (At least for me ;-). It works with XFree86 as well as with HOBLink X11 for OS/2. I am interested in any feedback positive or negative! Send me a mail: fbakan@gmx.net This version supports: - preview scan, preview zoom - scan and save to pnm, jpeg, png, tiff, ps, pdf and raw file - handling of all backend options - helpfiles - copy mode (printing via ghostscript, see section "copy mode") - ocr output to a textfile using gocr.exe ( http://www.fbakan.de/gocr-os2.htm ) - gimp-plugin (only for GIMP2) It do not know if it supports: - fax mode (is there compatible faxsoftware?) Installation: ============= - this version is compiled with gcc321 ( ftp://ftp.netlabs.org/pub/gcc/gcc-3.2.1-r2 ), so you need it's runtime-dll gcc321m.dll. If you don't have it, you can download it here: http://www.fbakan.de/xsane/gcc321m.zip - you need to have gimp2.2 installed (even if you don't use it) for the details see: http://hobbes.nmsu.edu/cgi-bin/h-viewer?sh=1&fname=/pub/os2/apps/graphics/gimp/gimp-2.2.8.zip - you need all these DLLs even if you run XSane standalone and not as GIMP2-Plugin! - I didn't bother to check if this list is complete. If XSane complains about some DLL missing or dies with an entry in popuplog.os2, just ask me. - You need a recent version of libsane.dll (1.0.16 or later) in your LIBPATH and SANE has to be set up correctly. This means 'scanimage -L' should find your scanner. - try the latest version from Paul Smedley http://smedley.info/sane.html - If want a smaller libsane.dll just for your scanner, let me know and I'll try to build one for you. - Unpack/move the files from this xsane-0.992-OS2 package to your x:\usr tree. - XSane won't work if it does not find the files in \usr\share\sane\xsane *EXACTLY* in this place! - To get National Language Support (default is english language) you have to set (for example in your CONFIG.SYS or in a xsane-start.cmd) SET LANGUAGE=de (for german language support) Supported langages are: ca cs da de es fr hu it ja nl pl pt pt_BR ro ru sk sl sr sv tr vi zh zh_CN and perhaps something like SET OUTPUT_CHARSET=latin1 - to make 'help' work, you need to have a browser for X I use mosaic (it does not understand href="...#..." but is usable) - To make XSane work as Gimp-plugin copy x:\usr\bin\xsane.exe to x:\usr\lib\gimp\2.0\plug-ins\xsane.exe Copy-Mode: ========== If you want to use copy mode, you need ghostscript for OS/2. You can download it e.g. from http://www.cs.wisc.edu/~ghost/ Enter Setup/Copy options: enter as command (for example): x:/gs/gs8.53/bin/gsos2 -sDEVICE=ljet4 -sPAPERSIZE=a4 -dNOPAUSE -sOUTPUTFILE=lpt1 -q - Pay attention: you have to use "/", don't use "\". You probably have to change sDEVICE=ljet4 to match your printer. Don't forget to set SET GS_LIB=x:/GS/GS8.53/lib;x:/GS/FONTS;D:/PSFONTS (example) SET GS_FONTPATH=x:/GS/FONTS;D:/PSFONTS (example) in config.sys or the cmd-file that starts xsane To get a list of available device names, call x:\gs\gs8.53\bin\gsos2 -h Mail-Mode: ========== If you want to use mail mode, I suggest that you use ee (electric eyes) if you want to display the image. Enable debug messages: ====================== If something does not work you can enable debug-output by setting XSANE_DEBUG to a value between 1 and 128. Higher numbers give more messages. Enter from command-line for example: set XSANE_DEBUG=3 xsane 2>log.3 The error-messages are saved in log.3 If it doesn't work: =================== - Check if you have a valid scanner.conf file in SANE_CONFIG_DIR - Check if the right version of jpeg.dll is found. Newer versions of JAVA come with an incompatible version. - Have a look into popuplog.os2 - If XSane windows don't close correctly try another Window-Manager. Support: ======== There is no special support for XSane for OS/2. But there is a mailing list. Search for sane-os2 at groups.yahoo.com. You can also ask me and perhaps I can help. Licence: ======== - XSane and XSane for OS/2 stand under the terms of the GNU general public licence (GPL). You can find the sourcecode for XSane at: http://www.xsane.org - The gtk-libraries that come with XSane also do stand under the terms of the GNU general public licence - GPL (gdk, gtk, glib, gnu-intl, gmodule) - The sourcecode of XSane can be found at http://www.xsane.org - The sourcecode of Sane can be found at http://www.sane-project.org Compile it yourself: ==================== - ask me Thanks: ======= Thanks to Christian Hennecke for testing, to Frank Gieáler for GTK2 and XFree4.5.0 and of course to Oliver Rauch for writing XSane and for his support. Contact: ======== You can contact the author of XSane via email: see /usr/doc/xsane/xsane.AUTHOR but don't ask for help/support for XSane on OS/2, He does not have the time to give support to it and wants to use his free time to work on the code - please understand that. Franz Bakan fbakan@gmx.net 26. January 2007