Short:    Rtgmaster User Archive
Author:   MagicSN@Birdland.es.bawue.de
Uploader: MagicSN@Birdland.es.bawue.de
Type:     gfx/board

This is part of the new rtgmaster release V41.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 user. It contains Binaries and Demos.

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_dev.lha. The Developper Archive contains
Autodocs and Includes for the library itself, this is the User Archive with only
Binaries.


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:

- rtgCGX.library some minor updates

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)
- 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 Buggy Init code that caused rtgmaster to crash on about 5% of Amigas
  (not on mine, because of that, the bug was unnoticed for a long time)
- Added rtgP96.library which contains Doublebuffering for Picasso96.
- Fixed "Double PAL Screenmode Bug"
- Lots of internal stuff interesting for programmers only

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

V34 changes:

- Fixed PPCGetRtgMsg and PPCReplyRtgMsg

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
- Some small fixes and stuff

V37 changes:

- mainly bugfixes
- to people who have still problems with ramlib i recommend using the MCPramlibPatch
  (a utility for your startup-sequence which raises the ramlib stack to 8 KB).
  can't check, if it helps, as no ramlib stack problems whatsoever appear on
  my system. ramlib stack problems also disappear on a PPC System, if WarpUP
  V14 is installed... it also does something that you have more ramlib stack
  available.

V38 changes:

- bugfixes (rtgCGX.library Bugfix and RtgSetFont Bugfix)
- added vbcc-WarpOS Support to developper package

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

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).
- 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).


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
   30476   13039 57.2% 13-Aug-98 10:37:38 +mandelppc
     928     456 50.8% 14-Mar-97 12:29:34 +a.pal.info
    4222    1643 61.0% 14-Mar-97 12:29:40 +a0.pcx
    6566    1773 72.9% 14-Mar-97 12:29:30 +a0.pcx.info
    3089    1343 56.5% 14-Mar-97 12:29:40 +a1.pcx
    3571    1127 68.4% 14-Mar-97 12:29:40 +a10.pcx
    3593    1313 63.4% 14-Mar-97 12:29:40 +a8.pcx
    3571    1127 68.4% 14-Mar-97 12:29:40 +a9.pcx
     162      64 60.4% 14-Mar-97 12:29:34 +gfx.lis
    3297     881 73.2% 14-Mar-97 12:29:34 +statback.pcx
    8256     428 94.8% 14-Mar-97 12:28:42 +world.map
   14040    8158 41.8% 13-Feb-98 23:41:58 +flame
    3076    1303 57.6% 29-Jun-98 22:17:40 +flamme
   18132   11046 39.0% 13-Jan-98 15:33:02 +mandel
  126188   54839 56.5% 13-Jan-98 15:32:56 +mywolf
    3076     268 91.2% 14-Mar-97 12:39:00 +a.pal
    4869    2504 48.5% 14-Mar-97 12:29:40 +a2.pcx
    4730    2326 50.8% 14-Mar-97 12:29:40 +a3.pcx
    3284     545 83.4% 14-Mar-97 12:29:40 +a4.pcx
    4705    1936 58.8% 14-Mar-97 12:29:40 +a5.pcx
    4222    1643 61.0% 14-Mar-97 12:29:40 +a6.pcx
    3700     986 73.3% 14-Mar-97 12:29:40 +a7.pcx
   25444   19469 23.4% 14-Mar-97 12:28:42 +tables.dat
     813     445 45.2% 15-Jan-98 20:06:32 +Readme.Old.Stuff
   11452    4899 57.2% 17-Oct-97 20:09:34 +rtgEGS.library.v27
    5480    2859 47.8% 18-Feb-97 20:01:16 +rtggadtools.library
   50996   24208 52.5% 17-Oct-97 20:14:32 +rtgmaster.library.v27
   12880    5265 59.1% 17-Oct-97 20:09:38 +rtgP96.library.v27
    4848    2624 45.8% 03-Feb-97 07:30:16 +rtgPICA.library.v1
    8784    4994 43.1% 17-Oct-97 20:08:24 +rtgAMI.library.v27
   12372    5154 58.3% 17-Oct-97 20:08:56 +rtgCGX.library.v27
     624     253 59.4% 22-Nov-95 11:37:48 +RTG.info
   23468   11282 51.9% 10-Aug-98 18:03:54 +rtgAMI.library
   29272   11930 59.2% 10-Aug-98 18:04:10 +rtgCGX.library
   16444    6868 58.2% 13-Feb-98 23:27:02 +rtgEGS.library
   31276   12553 59.8% 10-Aug-98 18:04:26 +rtgP96.library
     624     251 59.7% 24-Mar-97 14:23:10 +rtgc2p.info
  114292   40101 64.9% 29-Jun-98 22:16:54 +rtgmaster.library
    1840     834 54.6% 19-Sep-97 13:02:00 +040
     820     576 29.7% 14-Oct-96 14:33:52 +chunky4
    2024    1062 47.5% 13-Feb-98 23:40:32 +cpu040
    1576     855 45.7% 11-Jan-98 21:40:06 +ecs
    1344     736 45.2% 19-Sep-97 13:02:04 +gd
    1640     862 47.4% 11-Jan-98 21:36:16 +leony
     860     456 46.9% 08-Jan-98 11:55:42 +Suzy
    4328    2518 41.8% 02-Jun-98 00:08:54 +rtgextra.library
   36902    5229 85.8% 24-Mar-97 11:45:12 +flame.iff
   23414   13711 41.4% 24-Mar-97 13:51:28 +mywolf.iff
   94720   60139 36.5% 13-Feb-98 23:45:14 +zhadoom.iff
     624     248 60.2% 24-Mar-97 14:25:36  demos.info
    1352     715 47.1% 26-Jun-97 19:46:52  Goodies.info
    5181    1522 70.6% 12-May-98 18:00:56  install_rtgmaster
    1238     458 63.0% 24-Mar-97 14:25:26  Install_RTGMaster.info
     624     252 59.6% 24-Mar-97 14:22:44  libs.info
     296     270  8.7% 13-Aug-98 11:00:46  mcpramlibpatch
     624     250 59.9% 24-Mar-97 14:22:48  pics.info
   23708    2931 87.6% 24-Mar-97 11:43:08 +flamme.iff
    9766    3152 67.7% 24-Mar-97 11:46:56 +mandel.iff
   51003   17650 65.3% 13-Aug-98 10:58:26  rtgmaster_user.guide
-------- ------- ----- --------- --------
  870706  376329 56.7% 20-Aug-98 22:24:52   59 files
