home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / i / iritsm3s.zip / readme.1st < prev   
Text File  |  1992-03-11  |  8KB  |  164 lines

  1. This file describes the steps need to be taken to compile this package
  2. under MSDOS or UNIX.
  3.  
  4. -----------------------------------------------------------------------------
  5.  
  6. MSDOS
  7. -----
  8.    Under MSDOS, This package was ported to Borland BC++ 3.0 and to the
  9. MSDOS gcc port DJGPP. The package will probably compile under previous
  10. version of Borland's compiler. The DJGPP port is not fully tested and is
  11. using Borland's real mode make, maker (BC++ 3.0) or make (previous versions
  12. of BC++).
  13.    If you are using different compiler, prepare for big hacking (I will
  14. discuss some of the problems to expect below...).
  15.    Edit the file makeflag.dos (BC++) or makeflag.djg (DJGPP).
  16. Set all the variables to the correct path you would like the include
  17. files/libraries/binaries to be installed to.
  18.    Also set the compiler/linker flags you would like to compile the package
  19. with.
  20.    Type 'make -f makefile.tc' for BC++, 'maker -f makefile.djg' for DJGPP.
  21. Note the use of the real mode make of BC++ 3.0. The protected mode make
  22. can not be used with DJGPP.
  23.    This should build the two libraries (cagd_lib and misc_lib) following
  24. by all the tools including the solid modeler itself - IRIT.
  25.  
  26.    Once everything built, change directory to the binaries directory. Edit
  27. all *.cfg configuration files and follow the instructions in them to configure
  28. the programs to your system.
  29.    On line help is saved in irit.hlp and is copied to the binaries
  30. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  31. to get a hardcopy manual for IRIT. Alternatively print 'irithlp.doc' which is
  32. a similar but plain text file.
  33.  
  34.    Each of the subdirectories poly3d/poly3d-r/poly3d-h has a batch file
  35. called test.bat. Run them to test your new executables. Note you will need
  36. a gif viewer for poly3d-r images and that test.bat on poly3d-h do require
  37. poly3d.exe to display the hidden line removed results. On the IRIT
  38. subdirectory type 'IRIT demo.irt' to run a demo of IRIT. There are quite a
  39. few other .irt files in that directory you may want to try. You can run all
  40. these tests by executing 'make -f makefile.tc test' from the main directory.
  41.  
  42.    Things to watch for:
  43.  
  44. * all the makefiles in the subdirectories source makeflag.dos/djg via the line
  45.   '!include "../makeflag.dos"'. If your make support different include
  46.   structure or does not support it at all, you will have to change or
  47.   manually substitute makeflag.dos content into the subdirectory makefiles.
  48. * Additional two libraries called gif_libl.lib and intr_lib.lib (libgif.a and
  49.   libintr.a for DJGPP) are provided here in a compiled form in the lib
  50.   subdirectory. These libraries are required for building poly3d, poly3d-r
  51.   and irit itself. The sources of gif_lib and intr_lib are not provided here
  52.   but can be separately ftp'ed (see below). This library is compiled for
  53.   large model in the BC++ case.
  54.  
  55.    What if you do not have Borland's BC(++) or DJGPP:
  56.  
  57. * DJGPP is free, so my first advise is if you a 386 machine or above,
  58.   ftp it and use it.
  59. * These programs use graphics. These programs are based on intr_lib windowing
  60.   system. Using another compiler means you will have to write an interface to
  61.   that compiler graphics calls (assuming it have them). This is
  62.   probably your major problem. To get an idea of what is involved, look at
  63.   intr_lib sources. Specifically look at intr_bgi.c interface to Borland's
  64.   BGI drivers and at intr_djg.c interface to DJGPP. You will need to
  65.   implement the graphics function call in them.
  66. * For some reason, there is really no standard for makefile formats. I would
  67.   guess you will need to update/modify the current ones so they can work for
  68.   you.
  69. * Since all programs build under MSDOS and several UNIX platforms, good
  70.   chance is that once you have solved the above problems, programs will build
  71.   correctly and with no major problems. Good luck - you will need it.
  72.  
  73.  
  74.     The DJGPP port is new and as such has several minor problems. Below
  75.   are the problems I have encountered so far in patch level 5:
  76.  
  77. * The floating point emulator emu387 as provided with patch level 5 has a
  78.   problem when comparing two negative numbers which returns the opposite
  79.   result since they are compared as positive. This renders the emulation
  80.   mode useless, but if you are lucky enough to have 387 or 486 then this
  81.   obviously should create no problem.
  82. * The MouseWarp function does not update the mouse cursor location properly
  83.   which makes the use of the keyboard impossible. Furthermore, MouseGetEvent
  84.   will "eat" keystroke events even if no M_KEYPRESS event requested.
  85. * The ATI driver provided is for version 2 only. I modified it to work on
  86.   my ATI version 1.
  87.  
  88.   The author of DJGCC (DJ Delorie) have been notified on these problems.
  89.   You can contant me for more details, if desired. From all the above,
  90.   the MouseWarp/GetEvent is the more severe since there is no work around.
  91.   Linking with the current libgr.a will render the keyboard useless in
  92.   moving the mouse (You will have to have a mouse).
  93.  
  94.  
  95. -----------------------------------------------------------------------------
  96.  
  97. UNIX
  98. ----
  99.    Edit the file makeflag.unx in the main directory.
  100. Set all the variables to the correct path you would like the include
  101. files/libraries/binaries to be installed to.
  102. Select the correct compiler flags if your architecture exists there.
  103. Otherwise create a new entry for these flags for your system.
  104.    Type 'make -f makefile.unx'. This should build the two libraries
  105. (cagd_lib and misc_lib) following by all the tools including the solid
  106. modeler itself - IRIT.
  107.  
  108.    Once everything built, change directory to the binaries directory. Edit
  109. all *.cfg configuration files and follow the instructions in them to configure
  110. the programs to your system.
  111.    On line help is saved in irit.hlp and is copied to the binaries
  112. directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
  113. to get a hardcopy manual for IRIT. Alternatively print 'irithlp.doc' which is
  114. a similar but plain text file.
  115.  
  116.    Each of the subdirectories poly3d/poly3d-r/poly3d-h has a batch file
  117. called test.bat. Run them to test your new executables by doing 'csh test.bat'.
  118. Note you will need a gif viewer for poly3d-r images and that test.bat on
  119. poly3d-h do require poly3d executable to display the hidden line removed
  120. results. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
  121. There are quite a few other .irt files in that directory you may want to try.
  122. Make sure the IRIT_PATH environment variable is properly set as described in
  123. the manual. You can run all these tests by executing 'make -f makefile.unx test'
  124. from the main directory.
  125.  
  126.    Things to watch for:
  127.  
  128. * all the makefiles in the subdirectories source makeflag.unx via the line
  129.   'include ../makeflag.unx'. If your make support different include structure
  130.   or does not support it at all, you will have to change it or manually
  131.   substitute makeflag.unx content into the subdirectory makefiles.
  132. * Your system must support either X11 or gl. Without graphics you would not
  133.   be able to build most of the tools, including IRIT itself.
  134. * poly3d-r is NOT building under UNIX by default. This is because you need
  135.   another library called gif_lib to link to, and which is not
  136.   provided with this package. You can ftp it separately (see below).
  137.   With gif_lib, you will also be able to save the raster window of poly3d
  138.   as a GIF image. Again this option of poly3d is disabled by default.
  139.   This is not a major drawback. The poly3d-r renderer renders into 8 bit
  140.   GIF images and results are medium at best. Using the filter IRIT2RAY,
  141.   use RAYSHADE which is far superior and recommended.
  142.  
  143. -----------------------------------------------------------------------------
  144.  
  145. The intr_lib sources can be ftped from the following two places:
  146.  
  147. 1. wuarchive.wustl.edu. directory mirrors/msdos/irit/intrlib?.zip
  148. 2. simtel20.arpa.mil, directory PD:<MSDOS.IRIT> as intrlib?.zip
  149. where ? is the current version.
  150.  
  151. libintr.a (DJGPP) and intr_lib.lib (MSDOS) are built from this package.
  152.  
  153. -----------------------------------------------------------------------------
  154.  
  155. The gif_lib sources can be ftped from the following two places:
  156.  
  157. 1. wuarchive.wustl.edu. directory mirrors/msdos/gif/giflib??.zip
  158. 2. simtel20.arpa.mil, directory PD:<MSDOS.GIF> as giflib??.zip
  159. where ?? is the current version.
  160.  
  161. libgif.a (UNIX) and gif_libl.lib (MSDOS) are built from the lib subdirectory
  162. of giflib??.zip package.
  163.  
  164.