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
Wrap
Text File
|
1992-03-11
|
8KB
|
164 lines
This file describes the steps need to be taken to compile this package
under MSDOS or UNIX.
-----------------------------------------------------------------------------
MSDOS
-----
Under MSDOS, This package was ported to Borland BC++ 3.0 and to the
MSDOS gcc port DJGPP. The package will probably compile under previous
version of Borland's compiler. The DJGPP port is not fully tested and is
using Borland's real mode make, maker (BC++ 3.0) or make (previous versions
of BC++).
If you are using different compiler, prepare for big hacking (I will
discuss some of the problems to expect below...).
Edit the file makeflag.dos (BC++) or makeflag.djg (DJGPP).
Set all the variables to the correct path you would like the include
files/libraries/binaries to be installed to.
Also set the compiler/linker flags you would like to compile the package
with.
Type 'make -f makefile.tc' for BC++, 'maker -f makefile.djg' for DJGPP.
Note the use of the real mode make of BC++ 3.0. The protected mode make
can not be used with DJGPP.
This should build the two libraries (cagd_lib and misc_lib) following
by all the tools including the solid modeler itself - IRIT.
Once everything built, change directory to the binaries directory. Edit
all *.cfg configuration files and follow the instructions in them to configure
the programs to your system.
On line help is saved in irit.hlp and is copied to the binaries
directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
to get a hardcopy manual for IRIT. Alternatively print 'irithlp.doc' which is
a similar but plain text file.
Each of the subdirectories poly3d/poly3d-r/poly3d-h has a batch file
called test.bat. Run them to test your new executables. Note you will need
a gif viewer for poly3d-r images and that test.bat on poly3d-h do require
poly3d.exe to display the hidden line removed results. On the IRIT
subdirectory type 'IRIT demo.irt' to run a demo of IRIT. There are quite a
few other .irt files in that directory you may want to try. You can run all
these tests by executing 'make -f makefile.tc test' from the main directory.
Things to watch for:
* all the makefiles in the subdirectories source makeflag.dos/djg via the line
'!include "../makeflag.dos"'. If your make support different include
structure or does not support it at all, you will have to change or
manually substitute makeflag.dos content into the subdirectory makefiles.
* Additional two libraries called gif_libl.lib and intr_lib.lib (libgif.a and
libintr.a for DJGPP) are provided here in a compiled form in the lib
subdirectory. These libraries are required for building poly3d, poly3d-r
and irit itself. The sources of gif_lib and intr_lib are not provided here
but can be separately ftp'ed (see below). This library is compiled for
large model in the BC++ case.
What if you do not have Borland's BC(++) or DJGPP:
* DJGPP is free, so my first advise is if you a 386 machine or above,
ftp it and use it.
* These programs use graphics. These programs are based on intr_lib windowing
system. Using another compiler means you will have to write an interface to
that compiler graphics calls (assuming it have them). This is
probably your major problem. To get an idea of what is involved, look at
intr_lib sources. Specifically look at intr_bgi.c interface to Borland's
BGI drivers and at intr_djg.c interface to DJGPP. You will need to
implement the graphics function call in them.
* For some reason, there is really no standard for makefile formats. I would
guess you will need to update/modify the current ones so they can work for
you.
* Since all programs build under MSDOS and several UNIX platforms, good
chance is that once you have solved the above problems, programs will build
correctly and with no major problems. Good luck - you will need it.
The DJGPP port is new and as such has several minor problems. Below
are the problems I have encountered so far in patch level 5:
* The floating point emulator emu387 as provided with patch level 5 has a
problem when comparing two negative numbers which returns the opposite
result since they are compared as positive. This renders the emulation
mode useless, but if you are lucky enough to have 387 or 486 then this
obviously should create no problem.
* The MouseWarp function does not update the mouse cursor location properly
which makes the use of the keyboard impossible. Furthermore, MouseGetEvent
will "eat" keystroke events even if no M_KEYPRESS event requested.
* The ATI driver provided is for version 2 only. I modified it to work on
my ATI version 1.
The author of DJGCC (DJ Delorie) have been notified on these problems.
You can contant me for more details, if desired. From all the above,
the MouseWarp/GetEvent is the more severe since there is no work around.
Linking with the current libgr.a will render the keyboard useless in
moving the mouse (You will have to have a mouse).
-----------------------------------------------------------------------------
UNIX
----
Edit the file makeflag.unx in the main directory.
Set all the variables to the correct path you would like the include
files/libraries/binaries to be installed to.
Select the correct compiler flags if your architecture exists there.
Otherwise create a new entry for these flags for your system.
Type 'make -f makefile.unx'. This should build the two libraries
(cagd_lib and misc_lib) following by all the tools including the solid
modeler itself - IRIT.
Once everything built, change directory to the binaries directory. Edit
all *.cfg configuration files and follow the instructions in them to configure
the programs to your system.
On line help is saved in irit.hlp and is copied to the binaries
directory. In the docs directories, the 'irit.tex' can be latex'ed and printed
to get a hardcopy manual for IRIT. Alternatively print 'irithlp.doc' which is
a similar but plain text file.
Each of the subdirectories poly3d/poly3d-r/poly3d-h has a batch file
called test.bat. Run them to test your new executables by doing 'csh test.bat'.
Note you will need a gif viewer for poly3d-r images and that test.bat on
poly3d-h do require poly3d executable to display the hidden line removed
results. On the IRIT subdirectory type 'irit demo.irt' to run a demo of IRIT.
There are quite a few other .irt files in that directory you may want to try.
Make sure the IRIT_PATH environment variable is properly set as described in
the manual. You can run all these tests by executing 'make -f makefile.unx test'
from the main directory.
Things to watch for:
* all the makefiles in the subdirectories source makeflag.unx via the line
'include ../makeflag.unx'. If your make support different include structure
or does not support it at all, you will have to change it or manually
substitute makeflag.unx content into the subdirectory makefiles.
* Your system must support either X11 or gl. Without graphics you would not
be able to build most of the tools, including IRIT itself.
* poly3d-r is NOT building under UNIX by default. This is because you need
another library called gif_lib to link to, and which is not
provided with this package. You can ftp it separately (see below).
With gif_lib, you will also be able to save the raster window of poly3d
as a GIF image. Again this option of poly3d is disabled by default.
This is not a major drawback. The poly3d-r renderer renders into 8 bit
GIF images and results are medium at best. Using the filter IRIT2RAY,
use RAYSHADE which is far superior and recommended.
-----------------------------------------------------------------------------
The intr_lib sources can be ftped from the following two places:
1. wuarchive.wustl.edu. directory mirrors/msdos/irit/intrlib?.zip
2. simtel20.arpa.mil, directory PD:<MSDOS.IRIT> as intrlib?.zip
where ? is the current version.
libintr.a (DJGPP) and intr_lib.lib (MSDOS) are built from this package.
-----------------------------------------------------------------------------
The gif_lib sources can be ftped from the following two places:
1. wuarchive.wustl.edu. directory mirrors/msdos/gif/giflib??.zip
2. simtel20.arpa.mil, directory PD:<MSDOS.GIF> as giflib??.zip
where ?? is the current version.
libgif.a (UNIX) and gif_libl.lib (MSDOS) are built from the lib subdirectory
of giflib??.zip package.