home *** CD-ROM | disk | FTP | other *** search
/ Action Games (Willard) / ACTGMS_VOL1.iso / xerix2 / x2src.doc < prev    next >
Encoding:
Text File  |  1994-11-09  |  9.8 KB  |  232 lines
  1.  
  2.         -----------------------------------------------
  3.         Information on the XERIX II Source Code Package
  4.         -----------------------------------------------
  5.  
  6.             from Brendan Reville/Twilight Software
  7.  
  8.  
  9.      Xerix II: The Caverns of Mars, is blitzing the world with
  10. its awesome quality and intense action.
  11.  
  12.      Since the release of Xerix I, programmers from around the
  13. world have asked Brendan Reville to share his secrets, from
  14. sprite collision, to multi-layered scrolling, to advanced
  15. keyboard handling, to arcade game logic, and beyond.  Many
  16. programmers wanted to see the source code to see how it was done.
  17.  
  18.      Now Brendan Reville, the 17 year old creator of Xerix I and
  19. Xerix II, has decided to make available the source code to Xerix
  20. II.  The complete Borland/Turbo C source code to the game, along
  21. with its .PRJ project file, all the ShareWare edition's level
  22. definition files, all other data files (also for the ShareWare
  23. edition's first six levels) AND all support programs, is
  24. available for only $89 Australian Dollars.  (That's less than $70
  25. US dollars!)
  26.  
  27.      The source code is provided mainly as an educational tool,
  28. so that experienced programmers may find out how certain things
  29. in Xerix II are done.  Many routines may be freely reused in
  30. other programs, while some other files and routines may NOT be
  31. reused in other programs, without prior written permission from
  32. Brendan Reville.
  33.  
  34.      And as an added bonus, the Xerix II Source Code Package
  35. includes a full Registered copy of the game - at no extra charge!
  36.  
  37.  
  38. ---- The following Projects (.PRJ project files) are included
  39. (and they contain the listed C files):
  40.  
  41.      [note that only the files marked with an asterix (*) may be
  42.      reused in your own programs]
  43.  
  44. XERIX2    - the main game
  45.      x2action.c     - the main action loop
  46.      x2alien.c      - controls aliens
  47. *    x2block.c      - controls backing scenery tiles(/blocks)
  48.      x2bonus.c      - controls bonus modules
  49.      x2ctrl.c       - Xerix II control menu system
  50. *    x2file.c       - file management and miscellaneous
  51.                          (including data decompression)
  52. *    x2font.c       - proportionally-spaced font management
  53.      x2game.c       - game structure
  54. *    x2im.c         - image drawing and collision detection
  55.      x2input.c      - handles user input
  56. *    x2mem.c        - memory handling routines
  57. *    x2menu.c       - menu handling routines
  58. *    x2mkey.c       - MultiKey multiple-keystroke-reading handler
  59. *    x2ms.c         - MultiScape multi-layered scrolling routines
  60. *    x2pal.c        - palette handling functions
  61. *    x2picdsp.c     - displays image file from within data file
  62. *    x2scale.c      - bitmap scaling routine
  63. *    x2seq.c        - scrolling text-sequence routine
  64.      x2shot.c       - player's-shots management routines
  65. *    x2sys.c        - Xerix II system interface routines
  66.                          (sound/graphics initialisation etc.)
  67. *    x2timing.c     - timing routines
  68.      x2title.c      - title sequence routine
  69.      x2vars.c       - declarations of all global variables
  70.      xerix2.c       - main routine
  71.      dsmistuf.c     - empty functions to replace DSMI code
  72.  
  73.      (There are over 8000 lines of C code in total!)
  74.  
  75.  
  76. RESMAN    - resource manager, puts all data files into one file
  77. *    resman.c       - the resource manager program
  78.  
  79.  
  80. MAKLEV    - creates one level data file from a .h level
  81.                definition file
  82. *    maklev.c       - outputs level data file from .h file
  83.                          (with data compression)
  84.  
  85.  
  86. MAKESEQ   - writes special sequence files (like dying/winning)
  87. *    makeseq.c      - writes special .seq files
  88.  
  89.  
  90.      Note that ONLY the above C files that are actually marked
  91. WITH an asterix (*) may be reused in your own programs.  
  92.      All other files may be viewed, but may NOT be reused,
  93. whether modified or not, in your own programs.
  94.  
  95.      -- A ShareWare evaluation copy of Fastgraph/Light (from Ted
  96. Gruber Software) is included so that you can compile the program
  97. and also try Fastgraph for yourself.  The included CLIP utility
  98. will also allow you to view the included .SPR image files.
  99.      -- DSMI (Otto Chrons' Digital Sound and Music Interface -
  100. the sound system used) is not required to recompile the program. 
  101. In fact the initialisation routine and music-loading routines
  102. were modified from Otto Chrons' copyrighted code.  Hence they
  103. cannot be distributed and have been replaced by empty functions
  104. (in dsmistuf.c).  References to any of DSMI's routines have been
  105. removed or commented out so that Xerix II can be recompiled,
  106. requiring only Fastgraph (or Fastgraph/Light).
  107.      -- A copy of DMP (the Dual Module Player) is also included
  108. in the Source Code Package.  This utility by Otto Chrons, which
  109. uses DSMI, allows you to play a variety of digital music formats
  110. through many different sound devices.  This program demonstrates
  111. the capabilities of DSMI, and will also let you play the included
  112. (*.AM?) music files from Xerix II.
  113.  
  114.      Understand that the source code is in its original state,
  115. and has not been perfectly tidied up.  This is to show just what
  116. the code looks like after extensive development and testing. 
  117. Extensive documentation of each module is not included; instead
  118. programmers can explore the code themselves to see how it works. 
  119. Programming experience is presumed - the Source Code Package will
  120. not serve as a tutorial in programming.
  121.  
  122.      This Source Code Package is intended for individual users
  123. only.  Contact Twilight Software for inquiries on Site Licenses
  124. for the Xerix II Source Code Package.
  125.  
  126.  
  127. ---- The following auxiliary files are included:
  128.      [...Note that auxiliary files are included only for the
  129.           ShareWare edition's levels (the first 6) - so only the
  130.           ShareWare edition of Xerix II can be rebuilt from the
  131.           Source Code Package...]
  132.  
  133.      For each ShareWare level (00-05):
  134.  
  135.      level??.h      - all data structures describing a level. 
  136.                          These are .h files using filled data
  137.                          structures which describe backings,
  138.                          aliens and so on.
  139.                          (Several thousand lines in total!)
  140.      leveldat.0??   - data file made for above .h file by MAKLEV
  141.      levbacka.0??   - first Fastgraph .SPR image for scenery
  142.      levbackb.0??   - second Fastgraph .SPR image for scenery
  143.      alienspr.0??   - .SPR image of alien sprites (2 main sets)
  144.      ship_spr.0??   - .SPR image of ship sprites (1 image set)
  145.      shot_spr.0??   - .SPR image of shot sprites (1 image set)
  146.      bonusspr.0??   - .SPR image of bonus module sprites (1 set)
  147.  
  148.      Note that some images, such as bonusspr.0??, are reused for
  149. most or all levels.
  150.  
  151.      Also note that the above files may NOT be reused in your
  152.      own programs.
  153.  
  154.  
  155.      Also included:
  156.  
  157.      .SAM files: audio sample files for in-game sound effects
  158.  
  159.           Note that these sounds may NOT be reused in your own
  160.           programs.
  161.  
  162.      .SPR files: (Fastgraph .SPR image files, all 320x200x256)
  163.           twilogo.spr    - Twilight Software logo
  164.           seqbck?.spr    - set of sequence backing images
  165.           font0.spr      - thin font
  166.           font1.spr      - thick font
  167.           title.spr      - XERIX II title sprite
  168.           fontgame.spr   - in-game font set for scores etc.
  169.  
  170.           Note that with the exception of font0.spr and
  171.           font1.spr, these files may NOT be reused in your own
  172.           programs.
  173.  
  174.      .SEQ files: special sequence files, built with MAKESEQ.PRJ.
  175.  
  176.      .AM1 files: (10 of DSMI's AMF music files)
  177.  
  178.           Note that none of these songs may be used in your own
  179.           programs.  They may not be distributed in any way.
  180.  
  181.  
  182.      If you wish to purchase the Xerix II Source Code Package,
  183. print the Order Form (below) and fill it in.  Send it to the
  184. address given, along with payment for $89 Australian Dollars. 
  185. Make sure that payment is in Australian Currency.
  186.  
  187.                         ...Cut here...
  188. -----------------------------------------------------------------
  189.             Xerix II Source Code package Order Form
  190.  
  191. Please send me the entire Xerix II Source Code Package on 3.5"
  192. disk.  By ordering this product I understand that I may not
  193. distribute any of the files in this package under any
  194. circumstances, except for those files which are linked in to my
  195. own executable programs.  I understand that I may only link in
  196. those files which are specifically stated as being usable in my
  197. own programs in the X2SRC.DOC file.  I will not hold Brendan
  198. Reville or his representatives responsible for any damages which
  199. may be caused by using the contents of this package.  I also
  200. understand that the software remains the property of Brendan
  201. Reville, and that no warranty is given as to the fitness of the
  202. Source Package for any purpose (hence no refunds are available). 
  203. I enclose payment (not cash) for $89 Australian Dollars, in
  204. Australian Currency.
  205.  
  206. Signed: ______________________     Date: _________________
  207.                                     (in date/month/year format)
  208.  
  209. Legal requirements aside, I do want to receive all of Brendan
  210. Reville's source code for Xerix II, as well as all the auxiliary
  211. files, to see just how a real game works!  Please send it all
  212. (including a Registered edition of Xerix II) to me at:
  213.  
  214. Name: ___________________________________
  215.  
  216. Address:  _______________________________
  217.  
  218.           _______________________________
  219.  
  220.           _______________________________
  221.  
  222. Country:  _______________________________
  223.  
  224. Phone number: _____________________ (include international codes)
  225.  
  226.  
  227. Post this form to:  Twilight Software
  228.                     PO Box 304
  229.                     Milsons Point NSW 2061
  230.                     Australia
  231. -----------------------------------------------------------------
  232.