home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 113 / EnigmaAmiga113CD.iso / software / sviluppo / quakeworld_src / quakeworld_src.readme < prev    next >
C/C++ Source or Header  |  2000-06-21  |  5KB  |  110 lines
  1. Short:    QuakeWorld sources for Amiga 68k/WOS/PUp
  2. Author:   frank@phoenix.owl.de (Frank Wille), magicSN@birdland.es.bawue.de (Steffen Häuser)
  3. Uploader: frank@phoenix.owl.de
  4. Version:  1.0
  5. Type:     game/shoot
  6. Requires: vbcc 0.7 or StormC
  7.  
  8. This archive contains the full Quake source required to compile
  9. QuakeWorld versions running under AmigaOS/68k, WarpOS or PowerUp.
  10.  
  11. QuakeWorld was mainly developed with vbcc 0.7d (which is the current,
  12. non-public beta version), but you should not run into any problems
  13. when compiling with the last official version, vbcc 0.7 (Aminet).
  14. The only difference is, that you should not use any optimizations,
  15. because of possible compiler bugs. This means that the result will
  16. be a bit slower than mine.
  17.  
  18. StormC is also supported to some degree, Steffen Häuser provided
  19. the StormC Project Files (Quake109.¶), but he reported problems
  20. with some of the PPC assembler optimizations. With StormC you can
  21. only build a WarpOS version, nobody tried 68k for now. When there
  22. are any problems concerning StormC, please contact Steffen Häuser
  23. <magicSN@birdland.bawue.de>, not me!
  24.  
  25. We would love to see it, when somebody ports this source to another
  26. compiler, like SAS/C or GNU-C, but I chose vbcc for obvious reasons,
  27. and because it's the only compiler which can create executables for
  28. all three targets.
  29.  
  30.  
  31. Legal
  32. -----
  33.  
  34. The QuakeWorld source is published under the GNU General Public License.
  35. Please read the file COPYING for more information.
  36.  
  37.  
  38. Preparations for compiling with vbcc
  39. ------------------------------------
  40.  
  41. Requirements: Besides a correctly installed vbcc 0.7 (or better)
  42. system you need a "make" program, preferably GNU-make. I'm using
  43. an SAS/C compiled version, which I found on Aminet, for this task.
  44. You will also need the Amiga OS system header files (from OS 3.1
  45. NDUK or OS 3.5 Developer CD) and some custom header files, like
  46. AmiTCP/IP SDK, CyberGraphics, ChunkyPPC (WarpOS only) and Picasso96
  47. (not for WarpOS). When you want to create a PowerUp executable,
  48. you need the PowerUp developer archive and for WarpUp the WarpOS
  49. header files, of course.
  50.  
  51. The "libs" directory contains some link libs for 3rd party libra-
  52. ries, for all targets. If you already have them, it's ok, otherwise
  53. you could copy them into your VLIBxxx: directory (or make them
  54. yourself, by using vbcc's fd2lib tool). Copy libs/m68k to vlibm68k:,
  55. libs/warpos to vlibwos: and libs/powerup to vlibppc:.
  56.  
  57. The next step is to adapt the Makefiles. There are three Makefiles,
  58. one for the M68k port (Makefile.Amiga68k), one for WarpOS (Make-
  59. file.AmigaWOS) and one for PowerUp (Makefile.AmigaPUp). Edit the
  60. Makefile for the target you want to create and insert the correct
  61. include file paths. You should only make changes before the comment
  62. "SETUP AND BUILD". The paths you have to change are indicated by
  63. brackets and a descriptional text, e.g. "<text>". The following do
  64. exist:
  65.  
  66. <AmiTCP/IP SDK includes> = path to the AmiTCP/IP header files
  67. <OS includes> = path to the standard AmigaOS header files (OS3.x)
  68. <PowerUp includes> = path to the PowerUp specific header files
  69.  
  70. Note1: The standard include file path is assumed to be defined
  71. by the "vincludem68k/wos/ppc:" assignment, which means you should
  72. have an assigment like "assign vincludem68k: osinclude-path ADD"
  73. in your user-startup.
  74.  
  75. Note2: The WarpOS header files are assumed to reside in the standard
  76. header file path. If this is different on your system, feel free to
  77. add another -I definition to the CFLAGS variable.
  78.  
  79. When everything was done correctly, you should be able to compile
  80. your own QuakeWorld client/server now. Type
  81.  
  82. make -f makefile.Amiga68k       for compiling the 68040/060 version
  83. make -f makefile.AmigaWOS       for compiling the WarpOS version
  84. make -f makefile.AmigaPUp       for compiling the PowerUp version
  85.  
  86. I'm always interested in any changes or bug fixes, which improve
  87. the quality of our QuakeWorld port. So if you think you programmed a
  88. nice enhancement, I would happily include it into our next release.
  89.  
  90.  
  91. Hints
  92. -----
  93.  
  94. If you are the proud owner of a PPC board you may consider to
  95. use the PPC-native compiler. It will drastically reduce compilation
  96. time (especially when optimizaion is turned on). Example for com-
  97. piling an M68k Quake with a WarpOS-native vbcc compiler:
  98. Replace "CC=vc" by "CC=vc +vc.config_wos" (or whatever your config
  99. file is called).
  100.  
  101. When the next vbcc release should appear (might be called V0.8?)
  102. you should change the PPC makefiles to compile a more optimized
  103. version. Increase optimization level by inserting -O1 or -O2 and
  104. -speed in CFLAGS. Delete the -amiga-align option to allow vbcc
  105. using PPC-friendly alignment whenever possible (vbcc >=0.7d supports
  106. #pragma amiga-align).
  107.  
  108.  
  109. Frank Wille                  21-Jun-2000                frank@phoenix.owl.de
  110.