home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac11disk / m_player / mplyr_en.doc < prev    next >
Encoding:
Text File  |  1989-06-08  |  9.0 KB  |  285 lines
  1. ****************************************************************************
  2.             M_PLAYER.PRG DOCUMENTATION
  3. ****************************************************************************
  4.  
  5.        It's a Quick Time and AVI player with sound, and a MPEG,
  6.          FLI/FLC/FLH, SEQ, PI1+DLT, FLM, DL, GIF, CDH, CDL,CDV player.
  7.           It can also CREATE Quick Time files (Images & sound),
  8.               QuickTime VR/1 files (Interactive Video)
  9.                   or AVI files (Images & sound)
  10.                   of FLM files (Images & sound)
  11.               or GIF animated files (without sound)
  12.  
  13.  
  14. Author:
  15.  
  16. TELLO Guillaume
  17. 240 rue Estienvrin
  18. 49260 Montreuil Bellay
  19. FRANCE
  20.  
  21. Email: gtello@wanadoo.fr
  22.  
  23. Download M_PLAYER from:
  24.     http://perso.wanadoo.fr/gtello (my page)
  25.     http://www.tripnet.se/~mille
  26.     http://www.magmacom.com/~nima
  27.         ftp://193.190.205.13/Archive/atari
  28.     http://www.allatsea.demon.co.uk
  29.  
  30.         (Besides, you'll find the STE version too).
  31.  
  32. ********** Shareware ****************
  33.  
  34.     If you want to register, please send 15DM, CAN$15, US$10, 60F or
  35. 7UKP to me or to my bank:
  36.     Crédit Agricole Anjou Mayenne/49000 Angers (France)
  37.     Account n°10434852000
  38.  
  39.     North America User, you can register (US$10) at:
  40.  
  41.     Nima Montaser          Hardware and Software Specialists
  42.     Homa Systems House       ATARI Graphics and Multimedia
  43.        P.O. Box 52127          nima@magmacom.com
  44.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  45.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  46.                URL: http://www.magmacom.com/~nima
  47.  
  48.         UK users, you can register (7UKP or more!) at:
  49.  
  50.         Antony Lacey   (algy@allatsea.demon.co.uk)
  51.     59 Owenford Road
  52.     Radford
  53.     Coventry CV6 3FQ
  54.     England
  55.  
  56.  
  57.         G E N E R A L   C O N S I D E R A T I O N S
  58.         *******************************************
  59.  
  60. Capabilities:
  61. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  62.     1) Can create Quick Time movies from a serie of images (and an
  63. optional sound), images formats are:
  64.         - TGA2 16 or 24 bits (to RLE16 compression)
  65.         - IMG ('ximg', 256 colors) (to RLE8 compression)
  66.     Sound formats are:
  67.         - AVR, 8/16 bits, mono/stereo
  68.         - WAV, 8/16 bits, mono/stereo
  69.         - QuickTime VR/1 extension for interactive Video.
  70.     (see below BATCH files, and SLIDSHOW.DOC)
  71.  
  72.         2) Can create Video for Windows (AVI) movies from a serie of
  73. images (and an optional sound), images formats are:
  74.         - IMG ('ximg', 256 colors) (to RLE8 compression)
  75.     Sound formats are:
  76.         - AVR, 8/16 bits, mono/stereo
  77.         - WAV, 8/16 bits, mono/stereo
  78.     (see below BATCH files, and SLIDSHOW.DOC)
  79.  
  80.     3) Can create GIF Animated files from a serie of GIF images (87a
  81. or 89a):
  82.         - M_PLAYER extension with number of frames
  83.         - DELAY extension with the timing infos
  84.         - NETSCAPE extension with the looping infos
  85.     (see below BATCH files, and SLIDSHOW.DOC)
  86.  
  87.     4) Can create Extended FLM files from a serie of ST-Low pictures
  88. and an optionnal sound:
  89.         - Images DEGAS (320x200x16)
  90.         - Images NEO (320x200x16)
  91.         - AVR/WAV sounds (DMA freq +/-2%, 8bits, mono/stereo)
  92.  
  93.     5) Can play 12 types of animations:
  94.     - *.MOV (Quick Time)
  95.         - graphics with:
  96.             CVID (compressed yuv)
  97.             RLE1, RLE2 (grey or col), RLE4 (grey or col),
  98.             RLE8 (grey or col), RLE16, RLE24, RLE32
  99.             SMC8 (grey or col)
  100.             RAW1, RAW2 (grey or col), RAW4 (grey or col),
  101.             RAW8 (grey or col), RAW16, RAW24, RAW32
  102.             RPZA (15 bits)
  103.             WRLE (256 colors)
  104.             MSVC8 (grey or  col) MSVC16
  105.             YUV2, YUV9, YVU9 (uncompressed yuv)
  106.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  107.         - switch for image-sound synchronisation
  108.         - switch for sound
  109.     - *.AVI (Video for Windows)
  110.         - graphics with:
  111.             CVID
  112.             CRAM16, CRAM8
  113.             MSVC16, MSVC8
  114.             RLE8
  115.             RGB8
  116.             YUV9, YVU9, IV32
  117.         - sound mono/stereo, 8/16 bits with TWOS or RAW format
  118.         - switch for image-sound synchronisation
  119.         - switch for sound
  120.  
  121.         - *.MPG (MPEG)
  122.         - Video MPEG 1 und MPEG 2
  123.         - no audio
  124.  
  125.     - *.FLI/FLC/FLH (Autodesk Animator)
  126.     - *.SEQ        (Cyber Paint)
  127.     - *.PI1 + *.DLT    (Cyber)
  128.     - *.FLM        (Kinetic Microsystems)
  129.     - *.FLM        (Lexicor)
  130.     - *.DL        (types 1 and 2)
  131.         - graphics only
  132.         - normal speed or maxi speed
  133.         (for PI1 + DLT, you must select the PI1 file, then the DLT
  134.         file must share the same name and be located into the same
  135.         directory: c:\EXAMPLE.PI1 and c:\EXAMPLE.DLT)
  136.  
  137.     - *.FLM     (Extended FLM Lexicor)
  138.         - images 320x200x16, 640x480x16 or 640x400x2
  139.         - sound DMA 8 bits mono/stereo at 12017, 25033 or 50066 KHz
  140.         - independent timing for each frame
  141.  
  142.     - *.FLM        (Video Master V1.0)
  143.         - images 160x100x16 (VMAS)
  144.         - images 160x100x256 (VFAL)
  145.         - sound 8 bits, mono, any frequency
  146.  
  147.     - *.GIF        (Compuserve, 87a and 89a)
  148.         - synchro or not with the delays (version 89a)
  149.         - number of frames displayed in the stats dialog only
  150.  
  151.     - *.CDH, *.CDL, *.CDV    (CD Stratos Magazine)
  152.         - images mono (CDH) fitting in 640x400
  153.         - images 16 greys (CDL) fitting in 320x200
  154.         - images 256 colors (CDV) fitting in 640x480
  155.           (an IFF file with the same name, except last char, must
  156.           be located into the same folder to get the palette!
  157.           ex: TEST9.CDV must come with TEST1.IFF).
  158.         - DMA sound 8 bits mono 12516Hz
  159.  
  160.     - step by step mode
  161.         - every frame displayed (auto or not)
  162.         - can save this frame into a TGA file (auto or not)
  163.         - doesn't work with NOVA or TT 256 colors
  164.  
  165.     - *.BAT (Batch files for slideshow):
  166.         - simple language to load and display a serie of images
  167.         - image format:
  168.             TGA 2 uncompressed (your POV creations for example)
  169.             IMG ('XIMG' and 256 colors)
  170.             GIF (87a or 89a, 256 colors maxi)
  171.             PI1 (DEGAS 320x200x16)
  172.             NEO (Neochrome 320x200x16)
  173.         more formats will be added in the furture
  174.         (see SLIDSHOW.DOC)
  175.  
  176.     - *.BAT (Batch Files)
  177.         - animations chained of any type
  178.         - can loop
  179.         (see SLIDSHOW.DOC)
  180.  
  181.  
  182. Hardware requiered:
  183. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  184.     - Atari TT030:
  185.         - with or without CaTTamaran 48MHz
  186.         - graphic cards accepted:
  187.             - NOVA (256, 32768 or 65536 colors)
  188.             - Crazy Dots1/2 (256 or 32768 colors)
  189.             - Matrix (256 colors)
  190.             - Cyrel (256 colors)
  191.         - without graphic card (256 colors)
  192.  
  193.     - Falcon, True Color (32768 colors) and plenty of RAM (Outside
  194.     accepted! Afterburner 040, ScreenBlaster, Blow up,
  195.     Centurbo I)
  196.     - PowerBook with MagicMac (256 colors, without sound...)
  197.     - HADES 040/060 (same as with TT+NOVA card) with sound:
  198.         - on the old Yamaha (default)
  199.         - P-SOUND card (parallel port)
  200.  
  201.         R U N N I N G   T H E   P R O G R A M
  202.         *************************************
  203.  
  204. The files:
  205. ¨¨¨¨¨¨¨¨¨¨
  206.     M_PLAYER.PRG    ; the program
  207.     M_PLAYER.RSC    ; the dialogs (put into the same folder!)
  208.     MPLYR_FR.DOC    ; french documentation
  209.     MPLYR_EN.DOC    ; english documentation (Thanks Dave!)
  210.     MPLYR_GE.DOC    ; german documentation (Thanks Martin)
  211.     MPLYR_SV.DOC    ; swedish documentation (Thanks Mille)
  212.     MP_ICONS.RSC    ; 4 icons made by Julien Chauveau for your desktop.
  213.     SLIDSHOW.DOC    ; batch files and MOV-Maker
  214.     HISTORIC.TXT    ; the history
  215.     COMMANDS.DOC    ; the options of the command line (TTP mode)
  216.  
  217. Running:
  218. ¨¨¨¨¨¨¨¨
  219.     The 'Go' button can come with the Alt key to get:
  220.     - the step by step mode (AVI, MOV or FLx)
  221.     - the creation of an animation with a BATCH file (else, you get
  222.     only the slideshow of images).
  223.  
  224.     You can specify a mask as the filename (*.MOV)
  225.  
  226.     For the use of a window, you can specify the default mode with a
  227. RSC editor ('W' button selected or not).
  228.     The "R" button allows you to repeat the animation. With a TT: when
  229. the TT Ram is used to store the remaining sound blocs (for large anims),
  230. you don't get sound at the second loop as the ST Ram blocs have been
  231. overwritten.
  232.  
  233. QuickTime VR/1
  234. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  235.     Those anims are a set of views (and even animated views) that the
  236. user can visit by driving the display with the arrow keys and eventually
  237. the SHIFT key to go faster.
  238.     One more dialog is opened to indicate what movements are available
  239. on this movie (horizontally, vertically or both). This format allows, for
  240. example, to view an object from every angle around it.
  241.  
  242. How to stop an animation?
  243. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  244.     With the 'Control' key (no stats box).
  245.     With SHIFT and an animation that loops (GIF for example), the
  246. display is stopped at the end of the current loop and you get the stats
  247. box.
  248.  
  249.  
  250. Step by Step mode
  251. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  252.     ** Fileselector **
  253.  
  254.     You must specify the path where the TGA files will be saved, their
  255. default name is:
  256.     FRM00001.TGA (up to 99999 different files!)
  257.     You can change the first 7 characters by entering them into the
  258. 'File name' field of the fileselector. They will replace 'FRM'.
  259.  
  260.     ** Mini Menu **
  261.  
  262.     (S) save: saves the current frame
  263.     (A) all : saves all the frames (starting at the current one), you
  264.     can stop that with the Control key.
  265.         (a bell during saving indicates a write error, maybe Disk
  266.         full or else)
  267.     (Q) quit: quits
  268.     Esc    : same as above
  269.     (R) run    : displays automatically the frames until you use the
  270.     Control Key.
  271.     Other   : any other key advances one step ahead into the file.
  272.  
  273.     ** TGA Files **
  274.  
  275.     format: TGA 2 uncompressed, header is 18 bytes long:
  276.  
  277.     Long $00000200
  278.     Long $00000000
  279.     Long $00000000
  280.     Word width    (Intel)
  281.     Word height    (idem)
  282.     Word $1820
  283.     Then the pixels line by line with 3 bytes per pixel:
  284.     Blue/Green/Red.
  285.