home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1998 #6 / amigaacscoverdisc1998-061998.iso / games / shareware / gms / gmsdev / readme.txt < prev    next >
Text File  |  1998-06-08  |  6KB  |  172 lines
  1.  
  2.  
  3.                T H E   G A M E S   M A S T E R   S Y S T E M
  4.  
  5.                                 VERSION 1.0
  6.  
  7.                                 21 MAY 1998
  8.  
  9.  
  10.  
  11. Hi there, and welcome to the first official version of GMS!  This is what
  12. many of you have been waiting for and the wait has been well worth it.
  13. When I posted a message to c.s.a.programmer two years ago about a new
  14. "games.library" there was a huge response, and ever since then there has
  15. been a lot of continued support.  It is because of the support and positive
  16. attitudes that GMS finally gets released today.
  17.  
  18. Thanks to the people that write to me and those that have supported the
  19. project throughout the design process.  Everyone who has supported GMS is
  20. mentioned on our web page, and I hope you all continue to help with this
  21. project.
  22.  
  23. If you are new to GMS, then I welcome you as a new developer.  If you have
  24. ideas for the project then send in a mail, or if you need assistance then
  25. join the new mailing list and ask questions.  Make sure that you read all of
  26. the text on licensing issues, and get programming :-)
  27.  
  28. The next version will be due out in 2 months, see you then!
  29.  
  30.  
  31.   - Paul Manias
  32.     Author of the Amiga Games Master System
  33.     WWW: http://gms.ethos.co.nz/gms/
  34.  
  35.  
  36.  
  37.  
  38.                                   N E W S
  39.  
  40.  
  41. Discussion List
  42. ---------------
  43. There is a discussion list available for talking about all things that are
  44. GMS related.  This is about the only place that you can talk to other GMS
  45. developers, so it is worth joining.  There is also a lot of inside
  46. information about future development, and things not mentioned here or on
  47. the web site.
  48.  
  49. To join, write to majordomo@lists.ethos.co.nz with "SUBSCRIBE GMS" in the
  50. message body.  You will receive a message that welcomes you to the list.
  51. To write a message to everyone, send mail to gms@lists.ethos.co.nz.  If you
  52. want to find out who is on the list, send a "WHO GMS" to majordomo.
  53.  
  54.  
  55. Licensing
  56. ---------
  57. All of the licensing details have been sorted out and are specified in the
  58. LICENSE.TXT file.  Before you can distribute a game written in GMS you will
  59. need to pay a license fee, which goes to the continuation of the project.
  60. Make sure that you read the entire licensing file before you even begin
  61. programming in GMS!
  62.  
  63. Also, when distributing your program, make sure you include the file
  64. GMSDev:Extras/GMS_README.TXT, which tells users where to get the GMS files
  65. from.
  66.  
  67.  
  68. Announcement List
  69. -----------------
  70. If you just want to receive announcements of new GMS releases, please send
  71. an e-mail to paul@ethos.co.nz with "SUBSCRIBE GMS-ANNOUNCE" in the header.
  72. Announcements are posted around every 3-4 months when a new version
  73. appears.
  74.  
  75.  
  76. System code to be released
  77. --------------------------
  78. All of the C and assembler code that makes GMS work will be released,
  79. except for the dpkernel.library.  This will allow new hardware drivers to
  80. be written and enhancements/bug fixes to be made.  This will start with the
  81. joyports module, so look out for it on Aminet and our web page.
  82.  
  83.  
  84. PC Conversion
  85. -------------
  86. Yes, GMS is being converted to the PC as part of the multiple-platform
  87. development programme.  This will make it possible for you to compile your
  88. programs on both the Amiga and the PC, and therefore earn more money :-).
  89. If you want to help with the conversion, write to paul@ethos.co.nz asking
  90. to help.
  91.  
  92.  
  93. Anyone want to write an editor?
  94. -------------------------------
  95. Someone other than myself needs to write the object editor for GMS.  It
  96. will have a GUI front end and lots of boxes and windows for the user to
  97. enter data for all currently available structures.  It also needs to be
  98. able to write out data as tag lists, in a file formatted to Amiga file
  99. hunks.  Look at Data Objects in the autodoc for detailed information.
  100.  
  101. [NB:  You do get a free GMS license for as long as you work on
  102. this.]
  103.  
  104.  
  105. Translation of autodocs
  106. -----------------------
  107. If you're interested in converting the docs to your own language, then
  108. write to me and I will give you my support.  Currently there are people
  109. working on French and Swedish translations, but I would like to have some
  110. people help them with these conversions as well.  The usual free GMS
  111. license applies.
  112.  
  113. Note:  To anyone that would like the French documentation, go to
  114.        Aminet and download dev/misc/gms_french.lha.  This is the
  115.        FULL documentation, with autodocs and all of the general
  116.        docs.
  117.  
  118.  
  119. Better Chunky 2 Planar
  120. ----------------------
  121. In this archive you will find the source to the C2P module (Asm/Chunky/
  122. 000.CPU1.s).  If anyone wants to implement a faster routine such as the one
  123. by Peter McGavin, go ahead.
  124.  
  125.  
  126.  
  127.                                C H A N G E S
  128.  
  129.  
  130. In order to upgrade your source code from V0.9 to V1.0, you need to make a
  131. couple of adjustments.  Most of these are fairly minor, e.g.  Screen
  132. attributes like DBLBUFFER have been changed to SCR_DBLBUFFER.  The
  133. Display() action has also been renamed to Show().  These changes are very
  134. easy to pick up from the existing source codes.
  135.  
  136. There is one major change, which is in the Picture support.  It no longer
  137. loads pictures into video ram, so you need to use a new Copy() action if
  138. you want to display your picture inside a screen.  Here is an example from
  139. a V0.9 source and the change to make it V1.0:
  140.  
  141.   if (background = Load(&BackFile, ID_PICTURE)) {
  142.    if (screen = Get(ID_SCREEN)) {
  143.       CopyStructure(background, screen);
  144.       screen->MemPtr1 = background->Bitmap->Data;  /* Illegal */
  145.       screen->Attrib  = DBLBUFFER;
  146.  
  147.     if (Init(screen,NULL)) {
  148.        CopyBuffer(screen,BUFFER1,BUFFER2);
  149.  
  150. Change to:
  151.  
  152.   if (background = Load(&BackFile, ID_PICTURE)) {
  153.    if (screen = Get(ID_SCREEN)) {
  154.       CopyStructure(background, screen);
  155.       screen->Attrib = SCR_DBLBUFFER;
  156.  
  157.     if (Init(screen,NULL)) {
  158.        if (Copy(background->Bitmap,screen->Bitmap) IS ERR_OK) {
  159.           CopyBuffer(screen,BUFFER2,BUFFER1);
  160.  
  161. Other changes in GMS are:
  162.  
  163.   * Line drawing now supports masking patterns in register d6.
  164.   * Picture remapping is automatic, so if you load a picture into a bitmap
  165.     that has a different set of colours, your machine will slow down...
  166.     Make sure that the Picture matches the destination that you are loading
  167.     it to - this is especially important for BOBS.
  168.   * You can make screen captures in PCX format by using the following:
  169.  
  170.       SaveToFile(Screen->Bitmap,&FileName,NULL);
  171.  
  172.