This is the latest update to the fastest MPEG player available on the classic
 68k Amiga platform. It is based on the work of Stephen Fellner and L?szl?
T?r?k,
 extended by a lot of additional improvements in terms of runtime performance
and
 audio/visual quality. RiVA served as the prominent testcase in the development
 cycle of the Apollo Core AMMX instruction set extension.

 Two binaries are provided in this archive, a classic m68k compatible build 
 (68040+) and an AMMX build, exclusive to Apollo Core Gold 2 and newer.

 Please note that mpega.library is required for audio decoding.

Changes since 0.53
 - fixed DHAM6 and DHAM8 modes in 68k build
 - optimized DHAM8 as a little apology for breaking it in the first place
   (significantly higher speed)
 - added 14 Bit audio output option (HQAUDIO)
 - added 16 Bit PAMELA audio output on Vampire V4 (HQAUDIO)
 - fixed and improved A/V sync
 - moved video timing relevant flag handling to safer places

Input steams / Quickstart:
 The input format supported by RiVA is MPEG-1 program streams. Modern video 
 formats can be converted to MPEG-1 using tools like ffmpeg or mencoder.

 Examples (assuming 16:9 aspect ratio content):
 ffmpeg -i source.mp4 -vcodec mpeg1video -filter:v scale=640:360 
        -b:v 1500k -maxrate 2200k -bf 3 -ac 2 -acodec mp2 -b:a 128k
dest_640x360.mpg
 mencoder -of mpeg -mpegopts format=mpeg1:tsaf:muxrate=1500 -o dest_640x360.mpg 
          -aid 1 -vf scale=640:360 -ofps 24 -oac lavc -ovc lavc -lavcopts 
 acodec=mp2:abitrate=128:vcodec=mpeg1video:vbitrate=1500:keyint=15:mbd=2:aspect=
16/9:vmax_b_frames=3  
          source.mp4

 RiVA should work well with default settings and the aforementioned encoding
 parameters on Apollo Core Gold2 and later. For optimal runtime performance, 
 use full screen on SAGA RTG (make sure, you have active screenmodes with 16 Bit

 depth), along with Paula audio output. AHI sound output will slow down the
 playback significantly. Windowed mode on Workbench will also be much slower 
 than the fullscreen mode. Some additional performance improvement is possible 
 by lower audio quality (e.g. commandline arguments AUDIOFREQDIV=2
AUDIOQUALITY=0).


Source code, licensing and building notes:
 The full source code is included, covered by the GNU general public license.
 The AGA and CGX renderers (unused in Apollo build) are available with dual
 licensing (GPL or MIT). 

 The only assembler supporting the extended Apollo instruction set is VASM.
 At least version 1.7h of VASM is required. Use the -devpac mode of VASM.
 Selection between the pure 68k build and the apollo build can be done with
 the APOLLO_CLIP master switch (0/1).

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                     72      72 100.0% -lh0- 5f14 Aug  6 13:28 RiVA-0.54/src/buildriva
[Amiga]                    109     198  55.1% -lh5- ca04 Aug  6 13:28 RiVA-0.54/src/buildriva.sh
[Amiga]                   1819    4499  40.4% -lh5- 9ba2 Aug  6 13:28 RiVA-0.54/src/ecstest.i
[Amiga]                   6996   18092  38.7% -lh5- a33a Aug  6 13:28 RiVA-0.54/src/gpl-2.0.txt
[Amiga]                   2637   17047  15.5% -lh5- 5551 Aug  6 13:28 RiVA-0.54/src/MacrosInterpol68k.m
[Amiga]                   1847    6564  28.1% -lh5- 8b69 Aug  6 13:28 RiVA-0.54/src/MacrosInterpolApollo.m
[Amiga]                    268     499  53.7% -lh5- 873b Aug  6 13:28 RiVA-0.54/src/mpegaadapter.i
[Amiga]                    424     987  43.0% -lh5- 5667 Aug  6 13:28 RiVA-0.54/src/p96YUVstuff.i
[Amiga]                   7029   33327  21.1% -lh5- 8f60 Oct 15 08:47 RiVA-0.54/src/RendererAGAC2P.i
[Amiga]                   3344   12540  26.7% -lh5- cb81 Oct 15 08:47 RiVA-0.54/src/RendererAGAInit.i
[Amiga]                   5435   22827  23.8% -lh5- 9cab Oct 15 08:47 RiVA-0.54/src/RendererCGXInit.i
[Amiga]                 103969  396914  26.2% -lh5- d1e4 Oct 15 08:48 RiVA-0.54/src/RiVA-0.54a0.s
[Amiga]                   1938    8893  21.8% -lh5- 831a Aug  6 13:28 RiVA-0.54/src/SubroutinesGen.i
[Amiga]                   7279   14904  48.8% -lh5- 3f23 Aug  6 13:28 RiVA-0.54/RiVA-0.54-apollo.info
[Amiga]                   4380    7970  55.0% -lh5- 83f3 Aug  6 13:28 RiVA-0.54/RiVA-0.54-m68k.info
[Amiga]                   2290    3578  64.0% -lh5- dbcb Aug  6 13:28 RiVA-0.54/RiVA.guide.info
[Amiga]                   1918   11372  16.9% -lh5- d34d Aug  6 13:28 RiVA-0.54/src/HuffmanTables.i
[Amiga]                   2266    8943  25.3% -lh5- e3d6 Aug  6 13:28 RiVA-0.54/src/MacrosAMMX.m
[Amiga]                   2086    5075  41.1% -lh5- 7aa9 Aug  6 13:28 RiVA-0.54/src/MacrosCoeff.m
[Amiga]                    761    2361  32.2% -lh5- aef9 Aug  6 13:28 RiVA-0.54/src/MacrosDCTCount.m
[Amiga]                   1384    4408  31.4% -lh5- 937b Aug  6 13:28 RiVA-0.54/src/MacrosGen.m
[Amiga]                   4680   19231  24.3% -lh5- cbc1 Aug  6 13:28 RiVA-0.54/src/MacrosIDCT68k.m
[Amiga]                   3289   13111  25.1% -lh5- 860b Aug  6 13:28 RiVA-0.54/src/MacrosIDCTApollo.m
[Amiga]                   1699    4414  38.5% -lh5- 3530 Aug  6 13:28 RiVA-0.54/src/MacrosMotion.m
[Amiga]                   2039    7345  27.8% -lh5- 535f Aug  6 13:28 RiVA-0.54/src/MacrosMPEG.m
[Amiga]                   1367    3123  43.8% -lh5- 4581 Aug  6 13:28 RiVA-0.54/src/MacrosMVDec.m
[Amiga]                   1930    3057  63.1% -lh5- 28bc Aug  6 13:28 RiVA-0.54.info
[Amiga]                   1570    2936  53.5% -lh5- 1d18 Oct 15 08:47 RiVA-0.54/README
[Amiga]                  23590   44300  53.3% -lh5- 4d62 Oct 15 08:40 RiVA-0.54/RiVA-0.54-apollo
[Amiga]                  27594   53148  51.9% -lh5- 2aab Oct 15 08:42 RiVA-0.54/RiVA-0.54-m68k
[Amiga]                  16589   60684  27.3% -lh5- ed3e Oct 15 08:44 RiVA-0.54/RiVA.guide
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        31 files  242598  792419  30.6%            Dec  3 19:53