home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Graphics / Graphics.zip / DKBOS2.ZOO / readme.1st < prev    next >
Text File  |  1992-07-18  |  3KB  |  78 lines
  1.  
  2. ******************************************************
  3.   Building Dkbtrace under OS/2....
  4. ******************************************************
  5.  
  6.    This file has all of the information needed in order to
  7. compile dkbtrace 2.12 for OS/2 2.0 using the IBM C Set/2.
  8. If the bugs in file I/O are removed from GCC 2.1, then I 
  9. will make a similar port of dkbtrace for it too.
  10. When I tried the current GCC 2.1 compiler, it produced 
  11. code that ran, but the file buffering is absolute trash, 
  12. the program completes without properly closing the files.
  13. This is something related to the GCC compiler, and until it is
  14. fixed, I'm not going to bother with hacking dkb to run with
  15. GCC's bugs.
  16.  
  17. Now back to the issue... 
  18. To compile dkbtrace version 2.12 for OS/2 with the IBM compiler,
  19. You need to do just a few things.
  20. First, get the DKB212SR.TAR.Z file from somewhere (the regular dkb
  21. sources...) and uncompress and untar it. 
  22. Unzip this set of files, into the same directory that you untarred the 
  23. dkb212sr.tar.Z into.
  24.  
  25. now run os2conf.cmd
  26.  
  27. This will do the following:
  28. copy os2conf.h config.h
  29. copy os2ibmc.mak makefile
  30.  
  31. Once this is done, just run nmake, and this
  32. should build dkbtrace.
  33.  
  34. GCC 2.1
  35. **********
  36. If you would like to try using GCC 2.1, and make the necessary fixes to
  37. the file I/O in either dkb or gcc, then copy os2gcc.mak to makefile
  38. and use gnu make (the emx port available from hobbes...)
  39.  
  40.  
  41. Testing it all out
  42. ********************
  43. To try out your newly compiled raytracer (or the executable 
  44. conatined in the package) run test.cmd 
  45. I have included a sample file called sunset.dat
  46.  
  47. Getting more DKB files, sources, pictures.
  48. *******************************************
  49. The home archive for DKBtrace is alfred.ccs.carleton.ca
  50. (at least it was the last time I checked)
  51. Use anonymous ftp, and it should be in /pub/dkbtrace/dkb2.12
  52. There were a couple other ports to OS/2, but none that I am aware
  53. of are 2.0 specific or 32bit.
  54.  
  55. Files are:  dkb212sr.tar.Z  - sources
  56.             dkb212dt.tar.Z  - Many more data files to trace :-)
  57.          dkb212.1side.ps.Z  - Doc files in PS. 
  58.             dkb212dc.tar.Z  - Docs in ascii (I think)
  59.  
  60. There aare also .zoo versions of most of the above files in the 
  61. same directory.
  62.  
  63. There are some other utilities etc available in the same place,
  64. but they are too numerous to list, the above two will get you started.
  65.  
  66.  
  67. For questions or information about this and the other included files and
  68. their usage, please contact  John E. Stone via email at:
  69.  
  70. internet:          johns@cs.umr.edu
  71.   bitnet:          s099466@umrvma
  72.  
  73. Hope you enjoy DKB :-)
  74.  
  75.        John Stone
  76.  
  77.  
  78.