README for XSane 0.96 for OS/2: =============================== This is now the 14. 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 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://home.tiscalinet.de/fbakan/gocr-os2.htm ) - gimp-plugin It do not know if it supports: - fax mode (is there compatible faxsoftware?) Installation: ============= - make shure that you have the following dll's in your libpath: dll available for example at --------------------------------------------------------------------------------------------- gimp122.dll | included for convenience (http://os2ports.com/ftp/pub/os2/unix/xfree86/ports...) gtk12.dll, gdk12.dll | http://os2ports.com/ftp/pub/os2/unix/xfree86/ports/Gnome/gtk128.zip gmodule.dll, glib12.dll | http://os2ports.com/ftp/pub/os2/unix/xfree86/ports/Gnome/glib128.zip intl.dll | http://os2ports.com/ftp/pub/os2/unix/xfree86/ports/libs/gettext.zip iberty.dll | http://paulf.free.fr/dlls.zip png.dll | http://os2ports.com/ftp/pub/os2/unix/xfree86/ports/graphic_libs/libpng103.zip tiff.dll | http://os2ports.com/ftp/pub/os2/unix/xfree86/ports/graphic_libs/tiff34.zip jpeg.dll | ftp://ftp.leo.org/pub/historic/comp/os/os2/leo/devtools/libraries/jpeg6b.zip z.dll | http://www.unixos2.org/sw/pub/nonunixos2/zlib114.zip --------------------------------------------------------------------------------------------- - make shure that you have a working libsane.dll from SANE (1.0.5 or later) in your LIBPATH and set up SANE correctly. That means 'scanimage -L' should find your scanner. - Unpack/move the files to your x:/XFree86 tree. - XSane won't work if it does not find the files in \XFree86\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) SET GNULOCALEDIR=x:/XFree86/share/locale and SET LANGUAGE=de (for german language support) Supported langages are: cs, da, de, es, fr, hu, it, ja, nl, pt, pt_BR, pt, ro, ru, sk, sl, sv, tr, vi, zh Copy/move the sane-backends.mo file of your language xx from your SANE-Distribution ( usr/share/locale/xx/LC_MESSAGES/sane-backends.mo ) to the path, GNULOCALEDIR ist pointing to. If you use gettext 0.10.40 or later you probably have to use the set OUTPUT_CHARSET=.... variable. See gettext 0.10.40 README.OS2 (For details to set up a unix-like environement have a look at http://www.os2world.com/os2files/xfree86/unix_environment.html) - create the directory HOME/.sane if you don't have it allready HOME has to be replaced with the value of your HOME environement variable set in config.sys This is the place where xsane saves it's settings. I recommend also to set the SANE_CONFIG_DIR in config.sys ( for example: SET SANE_CONFIG_DIR=g:\home\.sane ) and strore the SANE-config-files (dll.conf, 'scanner-model'.conf, and net.conf) in this directory. - to make 'help' work, you need to have a browser for X I use mosaic (it does not understand href="...#..." but is usable) - Edit xsane.cmd in x:\XFree86\bin and make an object for it on your desktop and start it. - To make it possible to be used as Gimp-plugin copy x:\XFree86\bin\xsane.exe to x:\XFree86\lib\X11\.gimp-1.2\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.14/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.14/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.14\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. Help-Menu: ========== If you use HOBX11 or another PM-XServer and you want a PM-WEB-Browser start (For Example Mozilla) when you click the Help-Buttons, drop me a mail and I can make a special binary available that supports this. 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 egroups / 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: ==================== - At http://home.tiscalinet.de/fbakan you will find the information how to build XSane 0.96 for OS/2. Contact: ======== You can contact the author of XSane via email: Oliver.Rauch@rauch-domain.de 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. This is the sixth edition of this OS2-Readme. If you find bugs or have suggestions, let me know. Franz Bakan fbakan@gmx.net 9 May 2005