home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / Graphics / akMPEG2 / akMPEG2.readme < prev    next >
Text File  |  2000-01-23  |  6KB  |  180 lines
  1. Short:    MPEG player for CyberGfx/AGA V3.09 (68k/PPC)
  2. Author:   Andreas R. Kleinert
  3. Uploader: info@ar-kleinert.de
  4. Type:     gfx/show
  5.  
  6.                              akMPEG Player
  7.  
  8.                               - SHAREWARE -
  9.  
  10.         © 1999-2000 by Andreas Ralph Kleinert. All rights reserved.
  11.  
  12.                     A PerSuaSiVe SoftWorX PRODUCT.
  13.  
  14.                         Needs Kickstart V3.x
  15.                  GUI created with StormWizard 2.0
  16.  
  17.                 Actively supports PowerPC (TM) via powerUP (TM)
  18.                    and ppc.library (or -emulation V0.6b+)
  19.  
  20.  
  21.  Program information
  22.  ===================
  23.  akMPEG is a program that has been designed to play MPEG animations
  24.  on CyberGfx or compatible systems with a 68030 or greater CPU.
  25.  Recommended is at least a 68030-50 or 68040-25 CPU.
  26.  
  27.  There are PPC versions available as well (040+PPC or 060+PPC).
  28.  
  29.  It allows several ways to replay animations:
  30.  
  31.    - in an overlay window on any kind of CyberGfx screen
  32.      (requires cgxvideo.library and a graphics card capable of Overlay)
  33.  
  34.    - in a normal window on any kind of a 16/24 bit deep CyberGfx screen
  35.  
  36.    - on a 16/24 bit deep CyberGfx screen (auto-selection)
  37.  
  38.    - on a 8 bit deep AGA or CyberGfx screen (requires OS 3.1)
  39.  
  40.  Please note, that conventional color 8 bit screen or window displays
  41.  (CyberGfx or AGA) are not supported due to speed reasons
  42.  (the window of the 24 bit player simply will stay empty).
  43.  
  44.  
  45.  Using the juggling-gigs.mpg animation from the Aminet CDs
  46.  (showing Urban Mueller juggling with harddisks) on a
  47.  CyberStormPPC system equipped with 68040-25 and PPC604e-180
  48.  the following results have been achieved with akMPEG 2.60:
  49.  
  50.  
  51.  800x600 8/16/24 Bit CyberGfx WB Screen (CV64/3D):
  52.  -------------------------------------------------
  53.      mpOV     9.222222 FPS   040-25        (sometimes  9.576923)
  54.   PPCmpOV    62.250000 FPS   PPC604e-180   (sometimes 83.000000)
  55.  
  56.  Own screen (24/8 Bit CV64/3D)
  57.  -----------------------------
  58.      mp24sc   5.533333 FPS   040-25        (sometimes  5.659091)
  59.   PPCmp24sc  41.500000 FPS   PPC604e-180   (sometimes 49.800000)
  60.  
  61.      mp8sc   10.375000 FPS   040-25        (constantly)
  62.   PPCmp8sc   83.000000 FPS   PPC604e-180   (sometimes 124.500000)
  63.  
  64.  
  65.  Display disabled
  66.  ----------------
  67.   If display has been disabled completely,
  68.   the V2.60 values for PPC oszilate between
  69.   83 and 124.5 FPS (no idea, why) and the
  70.   68k delivers ~10.4 FPS for Overlay/Gray
  71.   and ~6 FPS for any 24 Bit display.
  72.  
  73.   So, if you have a faster/slower graphics
  74.   card, you may estimate the max. possible FPS
  75.   rate from these values.
  76.  
  77.  
  78.  Basically it shouldn't matter whether the original or the emulation
  79.  ppc.library is being used. I've been extensively using both without
  80.  problems, while the numbers above have been taken with the original.
  81.  
  82.  NOTE: MPEG files with audio part are not supported - yet.
  83.  
  84.        There's MPEG-1 (ISO/IEC IS 11172-2) video bitstreams and
  85.        MPEG-2 ISO/IEC DIS 13818-2.
  86.  
  87.        Currently the player only supports video streams without audio parts,
  88.        thus no "MPEG system" animations.
  89.  
  90.  
  91.  Usage
  92.  =====
  93.  The GUI is quite self-explaining:
  94.  
  95.     - PPC support can be switched on or off (when available)
  96.     - B- and P-Frames may be skipped (default is "do not skip")
  97.     - looping is possible (default is "only play once")
  98.     - 16 bit overlay, 24 bit window, 24 bit screen
  99.       and 8 bit screen (gray) display is possible
  100.  
  101.  The MPEG players are external programs, that are run
  102.  asynchroneously. So it is possible to play more than
  103.  one animation at once. Or utilize PPC and 68k at the same
  104.  time. However, it is not possible to open more than one
  105.  overlay window at once (all except the first one will
  106.  show "Please wait..." until the resources again are free).
  107.  
  108.  One may also start the external player tools from Shell
  109.  (PPC version is named similarily, with "PPC" as prefix).
  110.  
  111.  The syntax can be requested by starting with "?" as the only
  112.  parameter. It's the same for both programs:
  113.  
  114.    akmp [-display=(ov|24|24sc|8sc)] [-nop -nob]
  115.         [-pubscr=pubscreenname] [-loop] anim.mpg
  116.  
  117.  Replay can be aborted via the player windows' close-gadget
  118.  - the gadget is present in the on-screen replay modes as well,
  119.  although it may not be visible there (click at upper left corner).
  120.  
  121.  Unless "loop" is specified, the animation only will be played once.
  122.  With "loop", it will be played "endless" (well, until someone hits
  123.  the close-gadget).
  124.  
  125.  Example display parameters for different replay modes:
  126.  
  127.     (PPC)akmp -display=ov anim.mpg     Overlay
  128.     (PPC)akmp -display=24 anim.mp      16/24 Bit Window
  129.     (PPC)akmp -display=24sc anim.mpg   16/24 Bit Screen
  130.     (PPC)akmp -display=8sc anim.mpg    8 Bit grayscale Screen (requires OS 3.1 !)
  131.  
  132.  Unless specified otherwise, "ov" is the default setting for display.
  133.  
  134.  That's it :-)
  135.  
  136.  
  137.  Tooltypes
  138.  ---------
  139.  
  140.   DEF_DIR       default directory
  141.   PUBSCR_OV     public screen name for overlay window display (mpOV)
  142.   PUBSCR_24     public screen name for 16/24 bit window display (mp24)
  143.  
  144.  
  145.  Overlay Support
  146.  ---------------
  147.   With an installed cgxvideo.library you can make use of the overlay
  148.   feature of any graphics cards that supports overlay (through this
  149.   library, that is).
  150.  
  151.   The CV64/3D supports video overlay, unless the driver's MULTIMEDIAMEM
  152.   setting has been changed, so that the 1 MB of texture/overlay memory
  153.   is being utilized for conventional display. One overlay "window"
  154.   at a time is possible.
  155.  
  156.   With the BVision/PPC (which perhaps also applies to the CyberVision/PPC)
  157.   it has been reported, that adding the tooltype VLAYER=DESTRUCTIVE
  158.   to the BVision Monitor Driver will enable overlay support through
  159.   cgxvideo.library, at least with CyberGraphX V4.1 (the commercial release).
  160.  
  161.   It's highly recommended to make use of overlay when available, since
  162.   it will allow for fastest and smoothest replay on your respective card.
  163.  
  164.  
  165.  Evaluation Restrictions
  166.  =======================
  167.  This is the evaluation version of akMPEG, which is SHAREWARE.
  168.  
  169.   - in the unregistered version, MPEGs show vertical stripes
  170.     when being replayed (except with the grayscale player)
  171.   - registered version shows filename instead of Copyright
  172.  
  173.  MPEGs with black vertical stripes may look "darkened"
  174.  compared to normal replay (I'd assume that's an optical effect).
  175.  
  176.  
  177.  Copyright and Distribution
  178.  ==========================
  179.  See program archive for copyright and distribution information.
  180.