home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / ppc / rtgppc / ppcdocs.txt next >
Text File  |  1998-01-06  |  9KB  |  178 lines
  1. Docs about rtgmaster PPC
  2. ========================
  3.  
  4. First of all: This is a PREVIEW of rtgmaster PPC !!! Coders read this docs very
  5. careful !!!
  6.  
  7. As now PowerPC Boards are available for the Amiga Computers, it will be interesting
  8. of creating games that will run on these Boards. The problem is, the current
  9. software available for PPC Boards does not feature PPC Native Graphics Functions.
  10. rtgmaster PPC will support such functions.
  11.  
  12. Before i go into detail i have to tell some things about how the Amiga PowerPC
  13. Control Software works principially. Actually, there are TWO software systems,
  14. one called ppc.library being shipped with the Boards, and one called WarpUP
  15. being available as Freeware (Reminds a bit of CyberGraphX and Picasso96, doesn't
  16. it ?). If you ran a program that used ppc.library, and now want to run a WarpUP
  17. program, you have to reboot (and vice versa).
  18.  
  19. 68k and PPC part
  20. ================
  21.  
  22. New for both:
  23.  
  24. - Added RtgBobSystem (Soft-sprites...)
  25. - Changed CopyRtgPixelArray (in a backward compatible way, to support AGA Support
  26.   without c2p...)
  27.  
  28.   * the Planar Copy under AGA is now fully functional (the function does Planar
  29.     Copy under AGA, Chunky Copy under GFX Board, so you can do AGA Support
  30.     without c2p, if you do not want c2p... you need two sets of graphics files
  31.     then... if you want to use c2p, use CopyRtgBlit instead, it does c2p for
  32.     AGA)
  33.   * Blit Width/Destination Width don't have to be the same any longer.
  34.     Destination Width/Height is always that of the Screen. Source Width
  35.     has to be the same like Destination Width, but it is possible to copy only
  36.     parts of the Buffer to the Destination, by using Source Offsets and
  37.     smaller Width/Height.
  38.  
  39. - Changed CopyRtgBlit (in a backward compatible way, due to user wishes... if you
  40.   don't need the new features you won't have to change your code !!!)
  41. - C Part of the thing is now StormC instead of SAS/C (more system-conform
  42.   Init-Code also...)
  43. - Fat/Mixed Binary (runs on PPC and on 68k Amigas !!!)
  44.  
  45. Masked Parameter:
  46.  
  47. 0: GfxBoard: Chunky Copy, AGA: c2p, Please use only Fullscreen c2p, not all c2p
  48.    Modules support Not-Fullscreen-c2p. To do Fullscreen c2p simply set All Offsets
  49.    to 0, all Width/Height to Screenwidth/Screenheight.
  50. 1: GfxBoard: Chunky Copy, No pixel will be overwritten with color 0. Not available
  51.    for AGA.
  52. 2: The same like 0, but also works with Fastram Buffers. Performs Chunky-Copy
  53.    for both GFX Boards and AGA.
  54. 3: The same like 1, but also works with Fastram Buffers. Performs Chunky-Copy with
  55.    color-0-restriction for both GFX Boards and AGA.
  56.  
  57. - rtg_MouseMove sends IDCMP_MOUSEMOVE messages additionally
  58. - rtg_DeltaMove sends IDCMP_MOUSEMOVE messages with Delta-Values. For EGS, which
  59.   does not support this feature, the same like rtg_MouseMove.
  60. - rtg_Workbench: Not yet working, hopefully in V31...
  61.  
  62. Note: rtg_MouseMove/rtg_DeltaMove do not work with the PPC Versions of the Message
  63. functions. Use the 68k Functions with Context-Switch, if you need these tags.
  64.  
  65. Also the PPC Versions do not send the timer values for IntuiMessages...
  66.  
  67. The ppc.library<->WarpUP Discussion
  68. ===================================
  69.  
  70. I am very sorry that i have to tell about this whole sad discussion. But i fear
  71. i HAVE to tell some words about it... I am sorry to Phase 5 that this text won't
  72. let their software look good. But as to game coding (what rtgmaster is intended
  73. mainly for) i am interest in EFFICIENCY. And for that i have to use WarpUP. Like
  74. most other PPC Software products that are in developpement do...
  75.  
  76. Now, why does WarpUP exist at all ? Why a second software ? (I tell at this place,
  77. that rtgmaster PPC uses WarpUP, like probably ANY bigger PPC Application asides
  78. from Wildfire does).
  79.  
  80. - Anytimes you want to start a PPC Function, a whole new task has to be started.
  81.   This causes slowdowns.
  82. - The 68k<->PPC Switches on ppc.library are slower than on WarpUP.
  83. - ppc.library Software is quite complicated to code... even if it is only a
  84.   "Hello, World" program. More complicated programs are VERY complicated to do.
  85. - Only the WarpUP-using Compiler StormC deals with Context-Switches AUTOMATICALLY.
  86. - Overall, the performance of WarpUP is much better, the usability too.
  87. - AFAIK, only WarpUP features Fat Binary, Mixed Binary and PPC Shared Libs.
  88.   (At least for the Version of ppc.library i saw last, this was true). I need
  89.   all these three features for rtgmaster PPC.
  90. - WarpUP uses the AmigaDOS Executable Format, while ppc.library uses the Format
  91.   of the Linux OS
  92.  
  93. I have to tell here, we have REALLY to be grateful to Phase 5 for creating the
  94. PowerUP Hardware. But they should have left the software part to Haage&Partner.
  95. Sorry, if i tell this that bluntly. Especially if you want to code a performance
  96. intensive game i only can recommend you to use WarpUP. Not only will the speed be
  97. better. You also will need much less knowledge to create PPC Applications. You can
  98. even create applications that run on both 68k and PPC very easy. Portability is the
  99. key :)
  100.  
  101. Sometimes it is said, that ppc.library would support Multiprocessoring, what WarpUP
  102. would not. This is wrong. WarpUP supports Multiprocessoring (but you have to create
  103. the PROTOCOL for the CPU communication yourselves). This is, because with the given
  104. PowerUP Hardware, running PPC and 68k parallel will SLOW DOWN your program, not SPEED
  105. UP it. With future Hardware that might be different, but not with the existing
  106. PowerUP Boards. And Sam Jordan, the coder of WarpUP already said, he would enhance
  107. the Multiprocessoring support in case such hardware appears.
  108.  
  109. Also Haage&Partner will support ANY Hardware manufacturer with WarpUP who wants to
  110. do a PPC Board. Not only the Phase 5 Hardware.
  111.  
  112. So, as rtgmaster PPC uses WarpUP, what does this mean ?
  113.  
  114. If you intend to use ppc.library, you should install the 68k Version of rtgmaster.
  115. Programs using the PPC functions of rtgmaster won't run then, of course. Alternatively
  116. you can simply install WarpUP V7. It provides compatibility with ppc.library, but it
  117. uses the same slow and problematic functions like ppc.library (because of that it is
  118. compatible...). When i tested rtgmaster PPC with powerpc.library V7 and ppc.library,
  119. though, i got a crash at startup, probably caused by the way ELF-Format does stack-handling,
  120. like i was told. I am not sure, if this is fixed with ppc.library V45, but to tell
  121. the truth, i don't care that much. If it does not run with ppc.library, try rtgmaster V27.
  122. Most new features of rtgmaster V30 are PPC-features, which are only usable with WarpUP.
  123.  
  124. How does the concept of rtgmasterPPC work ?
  125. ===========================================
  126.  
  127. rtgmaster PPC is a Mixed Shared Library, which means, that it has functions in 68k,
  128. and functions in PPC. On a 68k system, you should ONLY use the 68k functions, on a
  129. PowerUP system both can be used. Every rtgmaster function exists in both 68k and PPC,
  130. but not all of them are PPC Native. Some of those PPC functions (currently nearly all)
  131. simply call a Context-Switch and execute the function on 68k.
  132.  
  133. You SHOULD USE the function CheckPPCCommand() to find out which functions are available
  134. in "true PPC code".
  135.  
  136. To use the functions, for 68k you have to use the protos and the pragma-file (for
  137. SAS/C: pragmas-file). For PPC you only have to include the protos-File (works only
  138. with StormC PowerUP, in case other compilers supporting WarpUP appear, they will
  139. be supported, too, of course. And it works also with StormPowerASM, of course, and
  140. shold run with pASM - did not try it yet, just downloaded it- .
  141.  
  142. List of true PPC functions:
  143.  
  144. CS means that the PPC function exists, but is not a true PPC function. Instead
  145. it performs a context-switch to the 68k function. - means that not even this
  146. exists. I will fix this as soon as possible. Remember, this is yet a preview only.
  147. In case of - an empty function will be performed.
  148.  
  149. rtgP96.library       rtgCGX.library       rtgAMI.library       rtgEGS.library
  150. ==============       ==============       ==============       ==============
  151.  
  152. PPCCCopyRtgBlit      PPCCopyRtgBlit       PPCCopyRtgBlit       -
  153. PPCLockRtgScreen     PPCLockRtgScreen     PPCLockRtgScreen     -
  154. PPCUnlockRtgScreen   PPCUnlockRtgScreen   PPCUnlockRtgScreen   -
  155. PPCGetBufAdr         PPCGetBufAdr         PPCGetBufAdr         -
  156. PPCCopyRtgPixelArray PPCCopyRtgPixelArray -                    -
  157. PPCRtgSetTextMode    PPCRtgSetTextMode    PPCRtgSetTextMode    -
  158. PPCRtgSetTextModeRGB PPCRtgSetTextModeRGB PPCRtgSetTextModeRGB -
  159. PPCRtgInitRDCMP      PPCRtgInitRDCMP      PPCRtgInitRDCMP      -
  160. PPCopyRtgBlit        PPCCopyRtgBlit       PPCCopyRtgBlit       -
  161. PPCRtgScreenAtFront  PPCRtgScreenAtFront  PPCRtgScreenAtFront  -
  162. PPCDrawRtgLine       PPCDrawRtgLine       -                    -
  163. PPCWriteRtgPixel     PPCWriteRtgPixel     -                    -
  164. PPCRtgWaitRDCMP      PPCWaitRDCMP         PPCWaitRDCMP         -
  165. PPCRtgGetMsg         PPCRtgGetMsg         PPCRtgGetMsg         -
  166. PPCRtgReplyMsg       PPCRtgReplyMsg       PPCRtgReplyMsg       -
  167. PPCFillRtgRect       PPCFillRtgRect       CS                   -
  168. PPCFillRtgRectRGB    PPCFillRtgRectRGB    No 24 Bit for AGA    -
  169. PPCWriteRtgPixelArrayPPCWriteRtgPixelArray-                    -
  170. PPCCallRtgC2P        PPCCallRtgC2P        PPCCallRtgC2P        -
  171.  
  172. All other PPC functions simply perform a contextswitch to 68k.
  173.  
  174. Steffen Haeuser
  175.  
  176.  
  177.  
  178.