home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Jeux / demos / crystalPPC.lha / readme.txt < prev    next >
Text File  |  1998-02-09  |  4KB  |  122 lines
  1. Crystal Space (V0.05)
  2. ---------------------
  3.  
  4. * WARNING! Many filenames have changed (since V0.02) in this
  5. * distribution! It is best to delete everything (or move it
  6. * to another location) and start all over. The filename
  7. * changes are needed for DOS support.
  8.  
  9. * NOTE! djgpp.c has been renamed to djgpp.cpp since V0.05.
  10.  
  11.  
  12. This is yet another release of Crystal Space. Crystal Space is a
  13. 6DOF 3D engine (like Quake) with static colored lighting and
  14. other features. See 'document.txt' for a complete list of
  15. features and some explanation about the algorithms that were
  16. used.
  17.  
  18. Crystal Space is still very much under development. I would
  19. like to make an Internet project of Crystal Space. Everyone who
  20. feels inclined can contribute to the source. There are several
  21. things that still need to be done. See the 'todo.txt' file
  22. for more information about what is missing and a list of current
  23. known bugs.
  24.  
  25. Crystal Space is free and should remain free. I may put
  26. Crystal Space under the GNU license. In the mean time consider
  27. everything as copyrighted by me (Jorrit Tyberghein).
  28.  
  29. [LAWYER MODE ON]
  30.  
  31. DISCLAIMER! I'm not responsible in any way for any damage
  32. this program may incur on you, your family or your computer.
  33. I think nothing harmful will happen but if it does, the
  34. author (Jorrit Tyberghein) is not responsible!
  35.  
  36. [LAWYER MODE OFF]
  37.  
  38. Note that some of the included textures are probably not free.
  39. I'm not sure. I will remove them when someone can confirm that
  40. they are not free. This also means that I'm looking for textures
  41. that ARE free and can be safely included with this program.
  42. All textures beginning with 'my' are mine so those are free.
  43.  
  44.  
  45. Credits
  46. -------
  47.  
  48. Crystal Space has it's first contributor! Many thanks to Murat
  49. Demircioglu <demircio@boun.edu.tr> for providing the first steps
  50. to porting Crystal Space to DOS. His code is present in this
  51. archive.
  52.  
  53. David N. Arnold <derek_arnold@fuse.net> has enhanced the DOS
  54. port made by Murat. He added C++ classes and VESA support.
  55.  
  56. Nathaniel Saint Martin <nsaintmartin@mfoptima.fr> enhanced Arnold's
  57. DOS port again so that it works with the Watcom C++ compiler.
  58.  
  59. Steve Israelson <pfhorte@rogers.wave.ca> suggested a few
  60. enhancements to the inner draw_scanline functions to benifit
  61. processors with many registers (like the PowerPC and 680x0 and
  62. unlike the Pentium). He also removed the need for the loop
  63. counter ('i') in the inner loop.
  64.  
  65. Installation instructions...
  66. ----------------------------
  67.  
  68. To create Crystal Space from the source you can use one
  69. of the provided makefiles:
  70.  
  71.     makefile.djg    for the DJGPP/DOS port.
  72.     makefile.lnx    for Linux and X Windows.
  73.     makefile.sol    for Solaris and X Windows.
  74.     makefile.unx    for general Unix and X Windows.
  75.  
  76. Other platforms will be supported in future.
  77.  
  78. Edit the makefile and possibly make changes as explained
  79. in the makefile. Then type:
  80.  
  81.     make -f makefile.???
  82.  
  83. This should generate a correct executable ('cryst' or
  84. 'cryst.exe').
  85.  
  86.  
  87. Starting Crystal Space...
  88. -------------------------
  89.  
  90. Note that if you are running on a X Windows platform you must
  91. remove the line 'XSHM=yes' (or change it to 'no') in 'cryst.cfg'
  92. if your server does not support the Shared Memory Extension.
  93. You can try first with XSHM set to 'yes' (since that is faster)
  94. and change it if it doesn't work (you will get a message like:
  95. 'Xlib:  extension "MIT-SHM" missing on display').
  96.  
  97. When you start Crystal Space for the first time it will generate
  98. a large light.tables file. If that file already exists it will
  99. reuse that. Note that you need to remove this file if you change
  100. something that might alter that table. Some examples of this
  101. are:
  102.     - Adding or removing a texture from the 'world' file
  103.       (even if it is not used).
  104.     - Changing the definition of the three colors for the
  105.       color table in the 'cryst.cfg' file.
  106.     - Changing the colormap of one or more of the textures.
  107. If you don't remove 'light.tables' in those cases the colors will
  108. almost certainly be wrong.
  109.  
  110. Mipmapped textures and static lighting are currently always
  111. computed at startup.
  112.  
  113. When you start Crystal Space it will automatically load the
  114. file 'world' (commandline arguments would be nice).
  115.  
  116.  
  117. Jorrit Tyberghein,
  118.  
  119. Jorrit.Tyberghein@uz.kuleuven.ac.be
  120.  
  121.  
  122.