                           Win32Prn
                            v0.9.1b
                          Early alpha
                   (c) 2002-2003 Vit Timchishin
                     winprn32@gtech-ua.com

1. Introduction

This package allows OS/2 users to run Win32 printer driver under OS/2 using Odin project.

2. Requirements

MS Windows 2000
OS/2 Warp or eComStation
Odin

3. Installation
3.1. Package installation on OS/2 system

To install package on OS/2 system:
1) Create a directory (i.e. c:\win32prn)
2) Unpack the package to this directory
3) Add the directory to LIBPATH

3.2. Installing into Odin

To use package you need to install it into odin. To do this, add following lines to odin.ini file (located in the system32 odin directory):
1)[DLLRENAMEWIN] section:
WINSPOOL.DRV=WSPLPRN.DLL
WINSPOOL=WSPLPRN.DLL
GDI32=PRN32GD.DLL
GDI32ORG=GDI32.DLL
WSPLORIG=WINSPOOL.DLL

2)[DLLRENAMEOS2] section
WSPLPRN=WINSPOOL.DRV
WINSPOOL=WSPLORIG
GDI32=GDI32ORG
PRN32GD=GDI32

3.3. Printer driver installation in OS/2

To install virtual prnwin32 driver in OS/2 system:
1) Run win32prn daemon (see Running below)
2) Install at least one windows driver into OS/2 (see below)
2) Create new printer object by dragging and dropping Printer template to free space.
3) In dialog, select "Install new printer driver..." button
4) Click "Other OS/2 printer driver"
5) Into directory entry box enter path to prnwin32 directory
6) Click refresh
7) Select needed driver and click install

3.4. Installing additional windows printer driver

To install additional printer driver into OS/2 printing suubsystem:
1) Run win32prn daemon (see Running below)
2) Install windows driver into OS/2 (see below)
3) Select properties for printer object
4) Select printer driver tab
5) On Existing PRNWIN32 printer driver press right mouse button
6) Select "Install", "New device"
7) Select needed driver and click install

3.5. Installing Windows printer driver into OS/2

Since win32prn project can't provide printer properties dialog yet, each printer object from windows can be represented as distinct device kind.
So, you can create "My Printer 300 dpi" and "My Printer 600 dpi" or "My printer double-sided" Printers in Windows, then copy them to OS/2 and use as different printer devices.
Next steps are needed to transfer set up of windows printer to OS/2:
Note: You must use Local Printer under windows to transfer properties, not Network printer even if you wish to print to network from OS/2.
1) Set up properties under windows
2) Run regedit under windows
3) Export as ASCII text (not unicode!!!, this is named REGEDIT4 in file type combo) next branches:
    a)HKEY_LOCAL_MACHINE\System\CurrentControlSet\Contorl\Print\Environments\Windows NT x86\Drivers\Version-3\<Your printer driver name
    b)HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Print\Printers\<Printer object name>
4) Change produced files so that they can be imported into OS/2 regedit2:
4.1)Remove double quotes from varable names
4.2)Concatencate long lines, removing '\' backslash character
5) Import resulting files into OS/2 regedit2 using "File" -> "Import Registry File" command
6) You will also need to transfer driver files. They can be usually found under winnt\system32\spool\drivers\w32x86\3 directory. List of needed files can be found in the inf file supplied with drivers.
7) Add directory with printer driver files to OS/2 PATH

3.6. Setting up OS/2 printer object

You will need to set "Queue options" -> "printer-specific format" for OS/2 printer object

4. Running the project

To run the project you will need to start prn32d daemon.
Note: Start it minimized or detached because it will output a lot of debugging info at the stdout.

5. Known bugs and limitations
5.1. Black and white only

6. Working drivers database

Printer                 Driver name/version         Results

Canon LBP-810           CAPT 1.00.1.012d            OK
Epson EPL-N2050/PS+     3.31                        OK

7. Contacts

Please e-mail me with any results to winprn32@gtech-ua.com

8. Buf reports

Buf reports are wellcome.
It is highly recommended to use debug versions of the project and Odin to produce report
Next information is needed to be supplied with bug report (along with report description):
1) Printer name
2) Printer driver name & version
3) REG files you've imported
4) POPUPLOG.OS2 entries if any
5) Bug kind (trap, error screen, nothing printed, blank page printed, error page printed)
6) Any log files (odin*.log, pe*.log) produced by the daemon
7) Syslog output produced by the OS/2 win32prn driver
    ( to create the file, "C:\]start syslogd" before tryingto print,
      then look for \MPTN\ETC\syslog.msg,syslog.000,syslog.001,... files)

9. License

This program is provided "AS IS". Author is not responsible for any
problems you have.

You may distribute this program if you want. But you should distribute only the
original archive without any changes.