home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 113 / EnigmaAmiga113CD.iso / software / sviluppo / quake_src / quake_src.readme < prev    next >
Encoding:
C/C++ Source or Header  |  2000-06-21  |  4.6 KB  |  112 lines
  1. Short:    Quake 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. standard Quake versions running under AmigaOS/68k, WarpOS or PowerUp.
  10.  
  11. Quake 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 Quake source is published under the GNU General Public License.
  35. Please read the file COPYING for more information.
  36.  
  37.  
  38.  
  39. Preparations for compiling with vbcc
  40. ------------------------------------
  41.  
  42. Requirements: Besides a correctly installed vbcc 0.7 (or better)
  43. system you need a "make" program, preferably GNU-make. I'm using
  44. an SAS/C compiled version, which I found on Aminet, for this task.
  45. You will also need the Amiga OS system header files (from OS 3.1
  46. NDUK or OS 3.5 Developer CD) and some custom header files, like
  47. AmiTCP/IP SDK, CyberGraphics, ChunkyPPC (WarpOS only) and Picasso96
  48. (not for WarpOS). When you want to create a PowerUp executable,
  49. you need the PowerUp developer archive and for WarpUp the WarpOS
  50. header files, of course.
  51.  
  52. The "libs" directory contains some link libs for 3rd party libra-
  53. ries, for all targets. If you already have them, it's ok, otherwise
  54. you could copy them into your VLIBxxx: directory (or make them
  55. yourself, by using vbcc's fd2lib tool). Copy libs/m68k to vlibm68k:,
  56. libs/warpos to vlibwos: and libs/powerup to vlibppc:.
  57.  
  58. The next step is to adapt the Makefiles. There are three Makefiles,
  59. one for the M68k port (Makefile.Amiga68k), one for WarpOS (Make-
  60. file.AmigaWOS) and one for PowerUp (Makefile.AmigaPUp). Edit the
  61. Makefile for the target you want to create and insert the correct
  62. include file paths. You should only make changes before the comment
  63. "SETUP AND BUILD". The paths you have to change are indicated by
  64. brackets and a descriptional text, e.g. "<text>". The following do
  65. exist:
  66.  
  67. <AmiTCP/IP SDK includes> = path to the AmiTCP/IP header files
  68. <OS includes> = path to the standard AmigaOS header files (OS3.x)
  69. <PowerUp includes> = path to the PowerUp specific header files
  70.  
  71. Note1: The standard include file path is assumed to be defined
  72. by the "vincludem68k/wos/ppc:" assignment, which means you should
  73. have an assigment like "assign vincludem68k: osinclude-path ADD"
  74. in your user-startup.
  75.  
  76. Note2: The WarpOS header files are assumed to reside in the standard
  77. header file path. If this is different on your system, feel free to
  78. add another -I definition to the CFLAGS variable.
  79.  
  80. When everything was done correctly, you should be able to compile
  81. your own Quake version now. Type
  82.  
  83. make -f makefile.Amiga68k       for compiling the 68040/060 version
  84. make -f makefile.AmigaWOS       for compiling the WarpOS version
  85. make -f makefile.AmigaPUp       for compiling the PowerUp version
  86.  
  87. I'm always interested in any changes or bug fixes, which improve
  88. the quality of our Quake port. So if you think you programmed a
  89. nice enhancement, I would happily include it into our next release.
  90.  
  91.  
  92.  
  93. Hints
  94. -----
  95.  
  96. If you are the proud owner of a PPC board you may consider to
  97. use the PPC-native compiler. It will drastically reduce compilation
  98. time (especially when optimizaion is turned on). Example for com-
  99. piling an M68k Quake with a WarpOS-native vbcc compiler:
  100. Replace "CC=vc" by "CC=vc +vc.config_wos" (or whatever your config
  101. file is called).
  102.  
  103. When the next vbcc release should appear (might be called V0.8?)
  104. you should change the PPC makefiles to compile a more optimized
  105. version. Increase optimization level by inserting -O1 or -O2 and
  106. -speed in CFLAGS. Delete the -amiga-align option to allow vbcc
  107. using PPC-friendly alignment whenever possible (vbcc >=0.7d supports
  108. #pragma amiga-align).
  109.  
  110.  
  111. Frank Wille                  21-Jun-2000                frank@phoenix.owl.de
  112.