Short: Rtgmaster Developer Archive Author: MagicSN@Birdland.es.bawue.de Uploader: MagicSN Birdland es bawue de Type: driver/video Architecture: m68k-amigaos; ppc-warpup This is part of the new rtgmaster release V42.0. rtgmaster is a library system to make GFX Board Compatible Game Coding easy. It supports : - Direct Access to the Video RAM - With some effort the code even runs on ECS/AGA (through c2p) - Supports nearly all WB Emulations (Does not support Retina WB Emulation...), including Support for CyberGraphX and Picasso96 - Alternatively to Direct Video RAM Access on a Screen (Fast) it also supports writing to a Workbench Window (Slower, though...) - PowerPC, using the WarpUP System from H&P. It also runs on plain 68k Systems, though (Fat Binary) - And much more This part of the archive is for the developper. It contains Binaries and Demos, Autodocs and Includes. You might be interested in getting the Driver Archive, additionally, if you do not want having to bother with Library/OS Coding. This Driver Archive contains an example driver where you do not have to know about this. This is all done internally in the driver. Note: If you use MCP, i recommend using at least Version MCP131B8. Earlier versions might use up too much ramlib stack. According to a user, this was fixed with Version MCP131B8. So i recommend at least this version. If problems still appear, i recommend installing MCPramlibpatch. This might also apply to MCP-Clones like MCX. The other rtgmaster archive is rtgmaster_user.lha. The User Archive contains Demos and Binaries (they are also contained here, though). V21 changes: - Important rtgCGX.library bugfix for 15/16/24 Bit Screens (there is not yet a program using rtgmaster in Truecolor mode, though, most games are these days still 8 Bit, if not to say all) - Workaround for CyberGraphX V41 R55 Bug concerning WaitBOVP. Doublebuffering will now work with the buggy CyberGraphX Version again. (Bugreport already sent). - Installer script finally fixed. V22 changes: - Moon source added, with the permission of the author - rtgCGX changes - Note about how to make a game running on the CV64 (the CV64 does some special things... Genetic Species is coded GOOD for example, it runs, tiny3d is NOT). it is only a small thing, but many coders seemed not to have a look at it. And no, it is no rtgmaster problem, if you use CyberGraphX or Picasso96, you will get the same problems... you can't assume BytesPerRow = BytesPerPixel * Width on the CV64, basically, but have to read out the real BytesPerRow... New in second V22 version (sorry :) ) : - Problems with CopyRtgPixelArray call and Cybervision64 Board should now finally be fixed (so Tiny3D should now work on the CV64 also) V23 changes: - Problems with rtgmaster and MCP and similar tools finally solved (please delete libs:rtg/rtgPICA.library, for this sublibrary it is not yet solved... delete it even if you do not have a Picasso II... the rtgmaster installer now does not install rtgPICA.library automatically, you have to install it manually, if you still use the original Picasso II WB Emulation, and not CyberGraphX/P96 for Picasso II) - Some minor bugs in rtgAMI.library fixed - Speedup of Doublebuffering in rtgAMI.library of 2000% (only, if you use OS3.0/3.1) - Added Support for BlitzBasic (Basic support for Blitz Basic only...) - Fixed Bug in Screenmoderequester (crash when a Screenmode was chosen using the Keyboard) - Default c2p directory now always is libs:rtgc2p - There probably will be a new version with faster/better ECS/AGA Support soon... V26 changes: - Fixed a bug that was inside rtgmaster since the very beginning and caused it to crash on a few Amigas (not on mine, this is why i not noticed this bug before) - Lots of small bugfixes in not-so-often used functions of rtgAMI.library - Fixed finally the "PAL Screenmodes appear twice" Bug - Included a new sublibrary for P96 Native. This sublibrary needs the latest P96 Version, and supports P96 style Doublebuffering (Doublebuffering of rtgCGX.library only works with CyberGraphX or Probench3, not with P96). - Added E Includes provided by bhar@hem.passagen.se V27 changes: - Now runs again on AGA-only systems (sorry for this bug :( Fixed it) - Added info for people still having problems on AGA-only systems to the docs (some people have incorrect startup-sequences) - Added announcement for PPC rtgmaster version V32 changes: - Added PowerPC Support (optional) - Added Workbench Window + Public Screen Window Support - Added Softsprite Functions from Rady Marusa (thanks, Rady :) ) - Added MOUSEMOVE Support - This release runs on both PPC Systems and on Systems without PPC :) - Added new very fast c2p V35 changes: - Workbench Window Mode: Added Support for programs that change their Palette while the game is running (up to now this only worked correctly on a Screen) - Workbench Window Mode: Optimized Color-Conversion function much, especially for PPC (thanks to Sam Jordan for the hint to use PPC ASM for this, and also thanks for the example sources he provided to me), but also for 68k. The Colors should also look more correct now - Some programs cannot run on a WB Window, as they change their colors TOO OFTEN for Color-Conversion to handle it. Rtgmaster contains now a special mode that enables the program to change the Workbench Palette (and reset it to the normal colors after Quit), if the "normal" method fails. Of course the normal method should be used if possible. That this "change of WB Colors" might be needed for some programs (Crystal3D...) is not the fault of rtgmaster, it is the fault of the Workbench Screen, that has a limit of how fast Colorchanges are allowed on the Workbench (Colorcycling for example will NOT work on Workbench Screen) - rtg_BusSystem now also recognizes AteoBus (Pixel64) and PCI (Inferno) - CV/3D is now correctly reognized as "Zorro 3" (was recognized as "Zorro 2" before), if present in a Zorro 3 System - Added Includes for GNU C 68k (inline/rtgmaster.h) Thanks to trance@master.echo.ch for the inline-file :) - Some small fixes and stuff V37: Mainly bugfixes, + updated E Includes thanks to r.zimmerling@link-dd.cl.sub.de for updating them :) V38 changes: - bugfixes (rtgCGX.library Bugfix and RtgSetFont Bugfix) - added Support for the new vbcc-WarpOS Compiler V40 changes: - added RtgScreenToFront function for handling several RtgScreens at the same time - added RtgConvert function to convert RGB 24 Bit input to any 15-24 Bit format (both 68k and PPC) - Bugfix: CopyRtgPixelArray in rtgP96.library (the "Abuse problem") - Bugfix: Mousemove problem for rtgCGX.library - Added: Example about PPC rtgmaster coding with vbcc-WarpOS, together with installation docs of vbcc-WarpOS and of the rtgmaster-files for vbcc-WarpOS. The example executable needs a GFX Board to work, but can easily be changed to run on AGA too. V41 changes: - bugfixes - added MCPramlibpatch to archive (if you get ramlib crashes, include it to your startup-sequence... some people seem to have too much ramlib-consuming on their system installed. MCPramlibpatch raises the ramlib stack to fix this). - updated rtgm.lib so that it also works with the final version of vbcc-WarpOS - added info to the docs for people who have problems with the new FlashROM of PPC Boards or the CV/PPC Basically: For both: Install the WarpOS 3.1 archive which is available at: ftp://ftp.haage-partner.com/WarpUP Then: echo >env:powerpc/TERMINATOR "2" echo >envarc:powerpc/TERMINATOR "2" This removes some unclean OS-Patches that are included in the latest version of the FlashROM. If you have a CV/PPC or BV/PPC you should also: echo >env:powerpc/force "1" echo >envarc:powerpc/force "1" echo >env:powerpc/gfxaddr "$e0000000" echo >envarc:powerpc/gfxaddr "$e0000000" This is needed as the CV/PPC is no Zorro-Board. You need only to do it once. Future versions of WarpUP will do it automatically with the Installer. Avoid starting ppc.library programs in your startup-sequence. Some of them (for example RC5-PPC) make rtgmaster not running anymore. Any complaints about this behaviour should go to Phase 5, not to me (if they remove the LoadSeg-Patch from the FlashROM again, those problems would disappear). V42 changes: - Bugfix GetRtgScreenData concerning MouseX/MouseY for rtgAMI.library (but better use RtgInitRDCMP for mouseposition anyways) - added rtgmaster<->Warp3D interface, see rtgmaster_dev.guide for more information (Warp3D is the new 3D standard for the Amiga, rtgCV3D.library was cancelled, as Warp3D is much better... Warp3D is for both 68k and PPC) - added possibility to access the Screen/Window structures of a RtgScreen, if present (see rtgmaster_dev.guide for more) - added new c2p module - hopefully fixed "16/24 Bit modes for rtgCGX.library on Cybervision Boards" Bug (Note: About env:powerpc-Variables concerning the FlashROM/CVPPC trouble... they are set automatically by the WarpUP 3.1 Installer, as i was now informed, so no need to bother about it anymore... :) ) Steffen Haeuser