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