home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 1200 / CCE_1233.ZIP / CCE_1233 / MPLAYER.132 / MPLYR_EN.DOC < prev    next >
Text File  |  1996-09-16  |  15KB  |  393 lines
  1.  
  2.  
  3. ****************************************************************************
  4.                  M_PLAYER.PRG DOCUMENTATION Version 1.30
  5.                     (developed from AVI_QT.PRG V1.10)
  6. ****************************************************************************
  7.  
  8.  
  9.      Quick Time (MOV) and AVI player (with sound), and a FLI/FLC player
  10.  
  11.  
  12.  
  13.  
  14.                 G E N E R A L   C O N S I D E R A T I O N S
  15.                 *******************************************
  16.  
  17.  
  18. What it can do:
  19. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  20.         Can play three types of animations:
  21.         - *.MOV (Quick Time)
  22.                 - graphics with CVID compression only
  23.                 - sound mono/stereo, 8/16 bits with TWOS or RAW format
  24.                 - switch for image-sound synchronisation
  25.                 - switch for sound
  26.         - *.AVI (Video for Windows)
  27.                 - graphics with CVID and CRAM16 compression (not CRAM8)
  28.                 - sound mono/stereo, 8/16 bits with TWOS or RAW format
  29.                 - switch for image-sound synchronisation
  30.                 - switch for sound
  31.         - *.FLI/FLC
  32.                 - graphics only
  33.                 - 3 speeds
  34.  
  35.  
  36. Looking at all the CD's I've got, 74% of the .AVI or .MOV animations can be 
  37. played with M_PLAYER. If I add the files where I can hear the sound (graphics 
  38. not supported) or see the images (sound not supported) it's 92% of all my 
  39. animations. Not bad, and I am adding more formats all the time.
  40.  
  41.  
  42. Hardware required:
  43. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  44.         - Falcon 32768 color mode and plenty of RAM
  45.         - TT + NOVA, 32768/256 color modes and plenty of RAM
  46.         - TT + Crazy Dots 2 32768/256 color modes and plenty of RAM
  47.  
  48.  
  49. Why not a STE?
  50. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  51. Sorry, but I use some instructions or addressing modes which require a 68030.
  52.  
  53.  
  54. Why not with 16 or 256 colors with my Falcon?
  55. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  56. Those graphics modes use bit-planes, and it's hard to manage... I've choosen 
  57. the True color mode because 1pixel=1word in memory, that's easy! But I am 
  58. working on 256-colour compatability for the next version.
  59.  
  60.  
  61. Why 'plenty of RAM'?
  62. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  63. Lots of RAM is necessary when sound is played; manydeo-only MOV or AVI 
  64. files should be playable on most machines since images are read from the 
  65. disk one by one and immediately displayed. This means only one frame at a 
  66. time is read into RAM.
  67.  
  68. For sound, the only way I found to keep the replay speed correctly in sync 
  69. with the animation was to load the whole sound first, then play it (DMA 
  70. sound!) while loading the frames. This way, I get no sound-cuts.
  71.  
  72.  
  73. Damn!, I've got 16Mb of TT RAM, and DMA sound can't be played from it!
  74. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  75. Well, you should set the 'TT Load' and 'TT Malloc' flags of the program to 
  76. keep the largest possible amount of ST RAM free. TT RAM is then used to load 
  77. the remaining sound data if it doesn't all fit into ST RAM. While playing, 
  78. this data is then copied into ST RAM by blocks till the end of the animation. 
  79. A copy of 1.5Mb takes 0.5sec. You may get some small gaps in the sound while 
  80. it is being copied across.
  81.  
  82.  
  83.  
  84.  
  85.                 R U N N I N G   T H E   P R O G R A M
  86.                 *************************************
  87.  
  88.  
  89. The files:
  90. ¨¨¨¨¨¨¨¨¨¨
  91.         M_PLAYER.PRG        ; the program V1.30
  92.         M_PLAYER.RSC        ; the resource file (put into the same folder!)
  93.         MPLYR_EN.DOC        ; English documentation (Merci Dave B.!)
  94.         MP_ICONS.RSC        ; 4 icons made by Julien C. for your desktop
  95.         (can someone make a german translation?)
  96.  
  97.  
  98. Running:
  99. ¨¨¨¨¨¨¨¨
  100. You can double-click on it (you'll get the fileselector). You can also drag 
  101. and drop one animation on it (the fileselector will be skipped).
  102.  
  103.         First dialog:
  104.  
  105.         1) The first line indicates the type of file selected
  106.  
  107.         2) The green box gives information about the video data (size,
  108.         number of frames, compression) and if the compression is supported or
  109.         not. If you have selected a sound-only file, you will get a message
  110.         saying 'No graphics found'. This dialogue also indicates whether the
  111.         video format is supported or not. If it is not supported, M_PLAYER
  112.         will still play any sound data that may be present, but there will be
  113.         no video
  114.  
  115.         3) The orange box gives information about the sound (frequency,
  116.         resolution, channels). Some frequencies and resolutions (4bits) are not
  117.         supported. Sometimes you'll get the 'Supported' message but you get no
  118.         sound: this means that the system has run out of memory. If there is no
  119.         sound data present, You will get the message 'No Sound'. The file will
  120.         still play but it will be in video only.
  121.  
  122.         4) The 'Play Sound' box selects/deselects sound playing (subject to
  123.         sound data being present of course!).
  124.  
  125.         5) The 'Synchronize' box selects/deselects synchronization between
  126.         sound and video (subject to sound and video data both being present 
  127.         of course!).
  128.  
  129.         6) 'Max speed' is a switch for FLI/FLC files to display frames with
  130.         no delay between them.
  131.  
  132.         7) 'Long delay' is a switch for FLI/FLC files to increase the delay from
  133.         normal to long when 'Max speed' is not set.
  134.  
  135.         8) 'Information...' gives information about the program and it's 
  136.         author. Please remember the program is shareware - registering for 
  137.         the very modest shareware fee will support further development.
  138.  
  139.         9) 'Go!' starts the animation. If sound data needs loading, playback
  140.         will be delayed and you will see a dialogue box saying 'Loading
  141.         sound...'.
  142.  
  143.         10) 'Cancel' does just that.
  144.  
  145.  
  146. Statistics:
  147. ¨¨¨¨¨¨¨¨¨¨¨
  148. At the end of an animation, a BOX with statistics is displayed, if the movie 
  149. was only a sound file, this box is skipped. The following information is 
  150. given:
  151.  
  152.         * Total frames: the number of video frames in the file.
  153.         * Frames displayed: the number of video frames actually displayed
  154.           (100% without sound synchronisation, sometimes less with synchronisation
  155.           on because some frames have been skipped to 'follow' the sound data).
  156.         * Total time: the duration of the animation in seconds.
  157.         * Average: number of frames actually displayed every second.
  158.  
  159.  
  160. Program ending:
  161. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  162. If you've started with a fileselector, you'll be back in it after every 
  163. animation. You must choose 'cancel' from the selector to quit. With drag and 
  164. drop, you'll return automatically to the desktop.
  165.  
  166.  
  167. How to stop an animation?
  168. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  169. Press the 'Control' key.
  170.  
  171.  
  172.  
  173.  
  174.                       S O M E   Q U E S T I O N S
  175.                       ***************************
  176.  
  177.  
  178. How was it done?
  179. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  180. Dieter Fiebelkorn sent me his own work (in 'C') that could display CVID frames 
  181. from an .AVI or .MOV file. I made the translation into ASM, then added the GEM 
  182. interface, DMA sound, synchronisation and the NOVA and Crazy Dots 2 support.
  183.  
  184.  
  185. Development History.
  186. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  187. Version 1.1:
  188. The .AVI file parsing has been totally re-written to use the 'idx1' section 
  189. and get the sound more easily.
  190.  
  191. Version 1.2:
  192. The FLI/FLC format is supported and the synchronisation has been improved with 
  193. some files (fewer frames skipped).
  194.  
  195. Version 1.22:
  196. All files can be played in 256 colors mode (with a graphic card). That was 
  197. only possible with files in CVID format before. Note that video display in 256 
  198. colour mode is in mono only.
  199.  
  200. Version 1.30:
  201. Crazy Dots 2 and Falcon compatability added.
  202.  
  203.  
  204. Development Tools.
  205. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  206. I used ASSEMBLE (Brainstorm), the fastest and the best assembler I've ever seen.
  207.  
  208.  
  209.  
  210.  
  211.                             S U N D R Y  B I T S
  212.                             ********************
  213.  
  214.  
  215. The size of the program
  216. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  217. Dieter's version builds a very large table (512k, to convert CVID colors into 
  218. 16 bits) each time it is launched. Because this needs floating point routines 
  219. (if no 68882 is present), I prefered to include this table directly onto the 
  220. disk (versions 1.00 to 1.20).
  221.  
  222. But, I found that 530Kb was a bit big on the disk and into memory (for 
  223. instance, a CRAM16 movie doesn't need it). So I took back Dieter's method and 
  224. now this table is built in memory only if required, and so does not need a 
  225. coprocessor. That's what the delay is between the main dialog and 'Loading sound...'.
  226.  
  227.  
  228. Frequencies
  229. ¨¨¨¨¨¨¨¨¨¨¨
  230. MAC or PC files have mainly use one of 3 frequencies: 11kHz, 22kHz or 44kHz. 
  231. When M_PLAYER loads the sound, it makes a frequency conversion to get 12,5kHz 
  232. or 25kHz or 50kHz which are the DMA frequencies (each 8 bytes per block, it 
  233. repeats the last byte, so getting 9 bytes and that's all).
  234.  
  235.  
  236. Bugs?
  237. ¨¨¨¨¨
  238. Yes, possibly! M_PLAYER may crash when:
  239.  
  240.         - The fileselector is used with a CD ROM (I've got ICD+Metados).
  241.           Fix: Drag and drop the movies onto the program's icon.
  242.         - The animation is larger than the screen (you should try, maybe
  243.           it won't crash for you).
  244.           Fix: Try using a virtual screen.
  245.         - Extendos is running.
  246.           Fix: Don't know.
  247.         - Turbo Veille is running.
  248.           Fix: Don't know.
  249.  
  250. Please report any problems, bugs and development suggestions to the UK shareware 
  251. co-ordinator, (address at the end of this text) who will pass them on to the 
  252. author.
  253.  
  254.  
  255. Thanks for their bug reports to:
  256. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  257.  
  258.         - Pascal R. (Pierrevert, France, Falcon 4Mo)
  259.         - Julien C. (Méron, France, Falcon 4Mo)
  260.         - Hervé P. (Paris, Falcon 4Mo)
  261.         - Dave B. (Stony Stratford, England, TT 20Mo + Crazy Dots 2)
  262.  
  263.  
  264.  
  265. Please remember that:
  266.  
  267. **************  T H I S  P R O G R A M  I S  S H A R E W A R E  *************
  268.  
  269. From version 1.4, M_PLAYER is shareware. Unregistered versions are limited to 
  270. monochrome display. To get the best from M_PLAYER, register the program, get 
  271. 32768 colour mode and prepare to be amazed. They said it couldn't be done!
  272.  
  273. If you want to register, please send £7 (seven UK pounds) or equivalent to 
  274. the UK support co-ordinator:
  275.  
  276.  
  277.                          Dave Brook
  278.                          22 Woolrich Gardens
  279.                          Stony Stratford
  280.                          BUCKS  MK11 1JX
  281.                          ENGLAND
  282.  
  283.                          email: register@mbha.demon.co.uk
  284.  
  285.  
  286. You will get your key a short time later. It is unquestionably the best seven 
  287. quid's worth of shareware you will find, and it helps to ensure further 
  288. development of this great program. Registered users will get routine upgrades 
  289. free of charge. Wherever possible, upgrades and keys will be distributed by 
  290. email, so please include your postal and email address as well as your name on 
  291. your registration request.
  292.  
  293.  
  294.  
  295.  
  296.                         S O M E   T E S T S
  297.                         *******************
  298.  
  299.  
  300. Here is my system:
  301. TT 32MHz, 2 Mo ST RAM, 16 Mo TT RAM, NOVA 32768 colors, CD-ROMx2 68030-cache 
  302. is ON and the program runs into TT RAM. My screen mode is 640x480x32768.
  303.  
  304. Most of those animations are taken from CDs sold with French magazines, so If 
  305. you're not French you won't be able to find them easily. But these tests will 
  306. give you an idea of the possible speed.
  307.  
  308.         - AVI tests:
  309.           These were done before I added the sound. So the results are without
  310.           synchronisation so they are displayed at maximum speed. With synchro-
  311.           nisation, I get a minimum of 90% of frames displayed.
  312.  
  313.  
  314.         CD Atari Compendium
  315.         Path: FILES\MISC\JAGUAR\AVI, size 160x120.
  316.  
  317.            file            | total time         | frames/s
  318.            ----------------+--------------------+---------
  319.            DEFENDER        | 9,6                | 26.5
  320.            HIGHLAND        | 24.6               | 25.9
  321.            IRON2           | 16.9               | 25.9
  322.            PENGUINS        | 5.9                | 25.4
  323.            PITFALL         | 12.5               | 26.2
  324.            RAYMAN          | 11.8               | 25.8
  325.            ULTRA           | 9.9                | 25.4
  326.            WMCJ            | 9.8                | 25.8
  327.            ----------------+--------------------+---------
  328.  
  329.  
  330.         CD Loisirs CD n15
  331.         MYTHES\VIDATA, size 368x276
  332.  
  333.            file            | total time         | frames/s
  334.            ----------------+--------------------+---------
  335.            AVLEVFR         | 70.2               | 15.0
  336.            ----------------+--------------------+---------
  337.  
  338.  
  339.         PC Fun CD FUN n17
  340.         root, size 320x240
  341.  
  342.            file            | total time         | frames/s
  343.            ----------------+--------------------+---------
  344.            PCF17           | 6                  | 13.9
  345.            ----------------+--------------------+--------------
  346.  
  347.  
  348.         - MOV tests:
  349.           Files are synchronised, sometimes frames must be skipped
  350.           because the display is too slow. The size is always 320x240.
  351.  
  352.  
  353.         PC Fun CD FUN n17
  354.         path GUIGNOLS
  355.  
  356.            file            | frames displayed/total | frames/s
  357.            ----------------+------------------------+------------------
  358.            JOHNNY          | 78/111                 | 10.6 (good)
  359.            TAPIE           | 59/87                  | 10.1 ( " )
  360.            VILLIERS        | 18/42                  |  6.5 (sometimes frozen)
  361.            ----------------+------------------------+------------------
  362.  
  363.  
  364.         GEN 4 CD n°87
  365.         path CLUBEURO\VIDEOS
  366.  
  367.            file            | frames displayed/total | frames/s
  368.            ----------------+------------------------+------------------
  369.            DEFI            | 277/279                | 6.8 (good)
  370.            ----------------+------------------------+------------------
  371.  
  372.  
  373.         path VIDEO
  374.  
  375.  
  376.            file            | frames displayed/total | frames/s
  377.            ----------------+------------------------+------------------
  378.            G4NEWS          | 4851/5376 (6 minutes!) | 13.5 (good)
  379.            G4TDN3D         | 1523/3060              |  7.4 ( " )
  380.            G4RSCI          | 3462/3844              | 13.5 ( " )
  381.            G4TBM           | 1561/2136              | 10.9 ( " )
  382.            1G4RPAN         | 1905/2358              | 11.8 ( " )
  383.            G4INTRO         | 246/496                |  7.5 (good)
  384.            G4PCON          | 291/577                |  7.5 (good)
  385.            ----------------+------------------------+------------------
  386.  
  387.  
  388. Well, this is the END...
  389.  
  390.  
  391.  
  392.  
  393.