home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac11disk / mp_ste / english / mp_ste.eng < prev    next >
Encoding:
Text File  |  1989-06-08  |  16.6 KB  |  492 lines

  1. ****************************************************************************
  2.             DOCUMENTATION OF MP_STE.PRG
  3. ****************************************************************************
  4.  
  5.  
  6.     Player of movies Quick Time (Mac), AVI (PC) images and sound,
  7.     FLI/FLC/FLH, GIF (PC), DL (?), SEQ, PI1+DLT, FLM/Extended FLM
  8.             and CDH/CDL (Atari).
  9.           Maker of MOV (images & sound!)
  10.           Maker of QuickTime VR/1
  11.           Maker of AVI (images & sound!)
  12.                       Maker of Animated-GIF
  13.               Maker of FLM (images & sound!)
  14.      Converter of AVI/MOV/FLI/FLC/FLH to Extended FLM with sound
  15.  
  16.  
  17. Author:
  18.  
  19. TELLO Guillaume
  20. 240 rue Estienvrin
  21. 49260 Montreuil Bellay
  22.     FRANCE
  23.  
  24. Email: gtello@wanadoo.fr
  25.  
  26. ******* Shareware **********
  27.  
  28.     You can register directly to me:
  29.  
  30.     CAN$15, US$10, 15DM, 60 French Francs (Eurocheques in francs, bank
  31.     notes from your country, but not coins!).
  32.  
  33.     UK users, you can register (7UKP or more!) at:
  34.  
  35.         Antony Lacey   (algy@allatsea.demon.co.uk)
  36.     59 Owenford Road
  37.     Radford
  38.     Coventry CV6 3FQ
  39.     England
  40.  
  41.     North America Users, you can register (US$10 or CAN$15) at:
  42.  
  43.     Nima Montaser          Hardware and Software Specialists
  44.     Homa Systems House       ATARI Graphics and Multimedia
  45.        P.O. Box 52127          nima@magmacom.com
  46.        Ottawa, ON  K1N 5S0     aa414@freenet.carleton.ca
  47.        Canada   Tel:(613)722-0901   Fax:(613)722-9061
  48.                URL: http://www.magmacom.com/~nima
  49.  
  50.  
  51.     Limitations of the Shareware version:
  52.     SEE AT THE END OF THIS DOCUMENT.
  53.  
  54. ****************************
  55.  
  56.         OVERVIEW
  57.         ********
  58.  
  59. Capabilities:
  60. ¨¨¨¨¨¨¨¨¨¨¨¨¨
  61.     1) Allows you to create a MOV animation (Quick Time) from a serie
  62. of images listed into a BATCH file and with an optional sound:
  63.         - images TGA2 24 or 16 bits -> MOV with RLE16 compression
  64.         - images IMG ('ximg', 256 colors) -> MOV with RLE8
  65.         - sounds AVR, 8/16 bits, mono/stereo
  66.         - sounds WAV, 8/16 bits, mono/stereo
  67.         - QuickTime VR/1 extension for interactive movies
  68.     (see BATCH Files, SLIDSHOW.ENG)
  69.  
  70.     2) Allows you to create an AVI animation (Video for Windows) from
  71. a serie of images listed into a BATCH file and with an optional sound:
  72.         - images IMG ('ximg', 256 colors) -> MOV with RLE8
  73.         - sounds AVR, 8/16 bits, mono/stereo
  74.         - sounds WAV, 8/16 bits, mono/stereo
  75.     (see BATCH Files, SLIDSHOW.ENG)
  76.  
  77.     3) Allows you to create an animated GIF89a from a serie of GIF
  78. images only listed into a BATCH file:
  79.         - extension M_PLAYER for the number of frames
  80.         - extension DELAY for the timing infos
  81.         - extension NETSCAPE for looping
  82.     (see BATCH Files, SLIDSHOW.ENG)
  83.  
  84.     4) Allows you to create an Extended FLM animation from a serie of
  85. ST-Low images listed into a batch file and an optional sound:
  86.         - images DEGAS PI1 (320x200x16)
  87.         - images NEO (320x200x16)
  88.         - AVR/WAV sound (DMA frequencies +/-2% 8 bits mono/stereo)
  89.     (see BATCH Files, SLIDSHOW.ENG)
  90.  
  91.     5) Allows you to convert any supported MOV/AVI with sound or any
  92. FLI/FLC/FLH into a new FLM format with sound to get a high speed display:
  93.         - FLI/FLC/FLH converted to FLM with their original synchro
  94.         - MOV/AVI converted to FLM with their synchro + sound
  95.         - images are ST Low or ST High according to the current
  96.         monitor used.
  97.  
  98.     6) Can replay 12 types of animations:
  99.     - *.MOV (Quick Time)
  100.         - images compressions:
  101.              CVID (compressed yuv)
  102.              RLE1, RLE2 (grey and col), RLE4 (grey and col),
  103.              RLE8 (grey and col), RLE16, RLE24, RLE32
  104.              SMC8 (grey and col)
  105.              RAW1, RAW2 (grey and col), RAW4 (grey and col),
  106.              RAW8 (grey and col), RAW16, RAW24, RAW32
  107.              RPZA (15 bits)
  108.              WRLE (256 colors)
  109.              MSVC8 (grey and col), MSVC16
  110.              YUV2, YUV9, YVU9 (uncompressed yuv)
  111.         - sound mono/stereo, 8/16 bits, TWOS or RAW format
  112.         - synchronisation image/sound ON or OFF
  113.         - sound ON or OFF
  114.  
  115.     - *.AVI (Video for Windows)
  116.         - images compressions:
  117.              CVID
  118.              CRAM8, CRAM16
  119.              MSVC8, MSVC16
  120.              RLE8
  121.              RGB8
  122.              YUV9, YVU9
  123.              (no IV32, you must pay Intel $5000 to get the
  124.              licence. The less we use it, the best!)
  125.         - sound mono/stereo, 8/16 bits
  126.         - synchronisation image/sound ON or OFF
  127.         - sound ON or OFF
  128.  
  129.     - *.FLI/FLC/FLH (Autodesk Animator)
  130.     - *.SEQ     (Cyber Paint)        Not in monochrome
  131.     - *.PI1 + *.DLT    (Cyber)            Not in monochrome
  132.     - *.FLM        (Kinetic Microsystems)    Not in monochrome
  133.     - *.FLM        (Lexicor)
  134.     - *.DL        (types 1 and 2)
  135.         - images only
  136.         - speed ORIGINAL or MAXI
  137.         (for PI1 + DLT, you must clic on the PI1 file, the DLT
  138.         file must be into the same folder with the same name, for
  139.         example: c:\ESSAI.PI1 and c:\ESSAI.DLT)
  140.  
  141.     - *.FLM (Extended FLM Lexicor)
  142.         - images 320x200x16, 640x480x16 or 640x400x2
  143.         - sound DMA 8 bits mono/stereo at 12017, 25033 or 50066 KHz
  144.         - independent timing for each frame
  145.  
  146.     - *.FLM        (Video Master V1.0)    Not in monochrome
  147.         - images 160x100x16 (VMAS)
  148.         - sound 8 bits, mono, any frequency
  149.  
  150.     - *.GIF    (Compuserve, 87a et 89a)
  151.         - synchro ON or OFF with delays (version GIF89a)
  152.         - the number of frames isn't displayed if the animation
  153.         doesn't contain the M_PLAYER extension.
  154.  
  155.     - *.CDH/*.CDL (CD Stratos)        Not in monochrome
  156.         - images mono (CDH) fitting into 640x400
  157.         - images 16 greys (CDL) fitting into 320x200
  158.         - DMA sound 8 bits mono 12516Hz
  159.  
  160.     - *.BAT (Batch Files for slideshow or movie creation):
  161.         - very simple language to display a serie of images (with
  162.         nested loops)
  163.         - supported formats:
  164.             TGA2 uncompressed (your POV creations!)
  165.             IMG ('XIMG' and 256 colors)
  166.             GIF (87a or 89a, 256 colors maxi)
  167.             PI1 (Degas 320x200x16)
  168.             NEO (Neochrome 320x200x16)
  169.         (see SLIDSHOW.ENG)
  170.  
  171.  
  172. Hardware required:
  173. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  174.  
  175.     Machine
  176.     ~~~~~~~
  177.  
  178.     - STF/Mega STF:    Yamaha PSG used for the sound...
  179.     - STE/Mega STE: DMA sound!
  180.     - TT without graphic card: DMA sound
  181.     - Falcon in ST Low or High: DMA sound
  182.     - PC + PaCifiST (GREAT ST Emulator)
  183.  
  184.     (For TT and Falcon, M_PLAYER.PRG is better than MP_STE.PRG because
  185. it is written for the 68030 and it can display up to 65536 colors).
  186.  
  187.     Supported sound systems:
  188.     - Yamaha PSG (every ST)
  189.     - DMA sound (TT, STE, Mega STE)
  190.     - Sound Cards:
  191.         * ST Replay 16
  192.         * ST Replay 8
  193.         * MV 16
  194.     (see at § 'Sound system selection')
  195.  
  196.     Display
  197.     ~~~~~~~
  198.  
  199.     MP_STE supports both color or monochrome display.
  200.  
  201.     --- Color Display ---
  202.     Every animation is displayed in ST Low mode using 16 grey levels if
  203. the animation has more than 16 colors (256, 32768, 65536, 16 millions) or
  204. 16 colors for the others (SEQ, FLM, DLT, MOV-RAW4,RLE4).
  205.     An optional mode is present to reduce the palette of the animations
  206. with 256 colors, then you'll get a COLOR DISPLAY! See at § 'Palette
  207. reduction' (option not available in the demo version).
  208.     The program switches automatically to ST Low, thus it can be run
  209. in ST Medium on a ST(E) or in any resolution on a TT.
  210.  
  211.     --- Monochrome Display ---
  212.     Every animation with at least 256 colors is displayed en ST High
  213. using a fast dithering. Those with less than 256 colors, except FLM in ST
  214. High, are not currently supported.
  215.  
  216.         Memory
  217.         ~~~~~~
  218.  
  219.     A ST(E) with 1Mb can be enough for many little animations, but you
  220. should know that, when there is a sound, it is loaded entierely before the
  221. animation is displayed (faster then, cause only the images are treated
  222. while playing). So, with those kind of animations 2Mb or 4Mb seem to be
  223. better.
  224.  
  225.     Drives
  226.     ~~~~~~
  227.  
  228.     Floppies can be enough, but once again, the images are loaded one
  229. by one (to save memory) while playing, and so, using floppies will slow
  230. down the animation. A Hard drive is highly recommended (Or use a
  231. RAMDISK...).
  232.  
  233.  
  234.             RUNNING THE PROGRAM
  235.             *******************
  236.  
  237. The files
  238. ¨¨¨¨¨¨¨¨¨
  239.     MP_STE.PRG/ACC    ; the program
  240.     MP_STE.RSC    ; its interface (into the same folder!)
  241.     MP_STE.ENG    ; you're reading me
  242.     HISTORIC.TXT    ; programmer's daily
  243.     SLIDSHOW.ENG    ; doc for BATCH files, MOV-Maker, GIF-Maker
  244.     COMMANDS.ENG    ; options of the command line (en mode TTP)
  245.     FORMATS.ENG    ; my extensions for FLM, GIF and ACC message
  246.  
  247. Running
  248. ¨¨¨¨¨¨¨
  249.  
  250.     How to select the animation
  251.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  252.  
  253.     MP_STE can be lauched as a PRG but also as an accessory, you just
  254. have to rename it as MP_STE.ACC and copy it (with its RSC) into the
  255. root directory of the boot drive.
  256.     It can also be run as a TTP or GTP with a command line containing
  257. options (see COMMANDS.ENG).
  258.  
  259.     The file name can contain '*' and '?' (wildcards) to replay
  260. several animations from the same directory.
  261.  
  262.     Infos into the first dialog box
  263.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  264.  
  265.     It indicates the filename, the size of the animation (or 'No
  266. graphics found') and the number of frames included (most of the GIFs
  267. haven't this information stored if they have not the M_PLAYER extension).
  268.     It gives the sound parameters (or 'No sound').
  269.  
  270.     Graphics and sounds can be 'Supported' (known by MP_STE) or
  271. 'Unsupported' (unknown, so they won't be replayed). This is also
  272. indicated.
  273.  
  274.     Settings into this box
  275.     ~~~~~~~~~~~~~~~~~~~~~~
  276.  
  277.     The [R] button switches to 'loop' mode for any animation (with or
  278. without sound).
  279.  
  280.     For AVI/MOV/GIF/Extended FLM you get:
  281.     [] Play Sound
  282.     [] Synchronise
  283.  
  284.     that allow you to replay the sound or not and to synchronise the
  285. images with the timings included into the file.
  286.     On slower machines, synchronisation leads to skip some frames to
  287. 'follow' the original timings. With 8Mhz, it is sometimes better to set
  288. OFF the synchronisation (longer display, but not jerky). This is no longer
  289. true with the Extended FLM whose format is adaptated to the Atari display,
  290. so you get a very good quality of animation.
  291.  
  292.     For the other animations you get two radio-buttons:
  293.     [] max speed
  294.     [] xxx frames/sec
  295.  
  296.     Max speed allows you to replay every frame without timing
  297. consideration, the other button allows you to limit the speed to its
  298. original value (the one contained into the file). If the machine is slow,
  299. both options lead to the same display.
  300.  
  301.     Replay the animation
  302.     ~~~~~~~~~~~~~~~~~~~~
  303.  
  304.     With the 'Go!' button, you start the animation with the settings
  305. you specified.
  306.     If the button is named '(Alt) Go!', it means that a second option
  307. is available if you press 'Alt' while clicking:
  308.     BATCH Files:
  309.     - instead of a slideshow, you create a MOV, AVI, FLM or a GIF file.
  310.     MOV/AVI/FLI/FLC/FLH files:
  311.     - instead of the animation, you get a conversion of your file into
  312.     the Extended FLM format ('Play sound' adds or not the sound into
  313.     the FLM, 'Synchronise' or 'xxx frames/sec' copies the original
  314.     timing infos into the FLM).
  315.  
  316.     QuickTime VR/1
  317.     ~~~~~~~~~~~~~~
  318.  
  319.     Those files are a set of images in witch you can move at random
  320. using the arrow keys. A dialog appears showing the available moves
  321. (horizontally, vertically or both). If you combine SHIFT and an arrow, the
  322. display is faster.
  323.  
  324.     End of the animation
  325.     ~~~~~~~~~~~~~~~~~~~~
  326.  
  327.     GIF: Control stops the animation, Shift stops a looping file at
  328.     the end of the current loop.
  329.  
  330.     Others: Control stops the animation.
  331.  
  332.     Infos in the second dialog box
  333.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  334.  
  335.     These are some statistics:
  336.     * Total frames:    number of frames into the file
  337.     * Frames displayed: number of frames actually displayed (100%
  338.     without synchro, 100 or less with synchro if frames have been
  339.     skipped)
  340.     * Total time: number of seconds that the animation lasted
  341.     * Average: number of frames per second
  342.  
  343.     Sound System selection
  344.     ~~~~~~~~~~~~~~~~~~~~~~
  345.  
  346.     To go to the sound systems list, you must 'Shift'+Clic on the
  347. 'Info... / ^ Sound' button or 'Shift'+Clic on the Information dialog
  348. itself.
  349.     Then, you clic on the sound system you've got!
  350.     If one of them appears not to be present (DMA according to the
  351. cookie for example) it will be displayed in grey, and so, disabled.
  352.  
  353.     If you want your sound system being the default one, clic on
  354. 'Save and Exit', this will update the RSC file for you.
  355.  
  356.     The best sound system is the DMA (0% of machine time!), then there
  357. are the sound cards (26% with ST Replay 16 and a STE 8MHz), then comes the
  358. Yamaha PSG (36% of machine time).
  359.  
  360.  
  361. How was it programmed?
  362. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  363.     It has been entierely programmed in ASM 68000 using ASSEMBLE
  364. (Brainstorm). This program is an adaptation of M_PLAYER that is a 68030
  365. version for TT and Falcon (256c to True Color).
  366.  
  367. Limits of MP_STE
  368. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  369.  
  370.     The frequencies of the sounds
  371.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  372.  
  373.     The files from the MAC or PC have often frequencies close to
  374. 11025Hz, 22050Hz et 44100Hz (I accept +/- 2%). The DMA on the Atari knows
  375. 12517Hz, 25033Hz et 50066Hz. Each time I load a sound I convert it from PC
  376. frequencies to DMA frequencies (each 8th sample, I add a 9th value, and
  377. the correspondance 8 to 9 gives a very fast and good conversion).
  378.     If there is no DMA system, the sound is always played at 9600Hz
  379. using hardware interruptions (Timer A) using the correspondance 8 to 7) and
  380. always in mono.
  381.     If the sound is not played (also it was 'Supported'), it means that
  382. you haven't enough memory. Try to select the Yamaha PSG instead of the
  383. DMA sound, because:
  384.     DMA: 1 second 8 bits stereo 25033Hz = 50066 bytes
  385.     PSG: 1 second 8 bits mono at 9600Hz =  9600 bytes!
  386.  
  387.     Size of the images with a color display
  388.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  389.  
  390.     The screen mode is ST Low (320x200):
  391.     - every animation below 320x200 is displayed as is.
  392.     - if the width is greater than 320, it is reduced to its half (in
  393.     both directions for proportions)
  394.     - if the height is greater than 200, only the central part can be
  395.     seen
  396.  
  397.     Examples:
  398.         320x240    -> only lines from 20 to 219 are displayed
  399.         640x400 -> reduced to 320x200
  400.         640x480 -> reduced to 320x240 and only lines from 20 to
  401.         219 are displayed
  402.  
  403.     Finally, every animation up to 640x??? is accepted.
  404.  
  405.     Size of the images with a Monochrome Display
  406.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  407.  
  408.     The screen mode is ST High (640x400):
  409.     - every animation below 640x400 is displayed as is.
  410.     - if the height is greater than 400, the central part is displayed
  411.  
  412.     Particular cases:
  413.     * DL animations are always doubled on the screen
  414.     * when converting an anim to FLM, if its size is below 320x200, it
  415.     is doubled.
  416.  
  417.  
  418.     Palette reduction (not in monochrome)
  419.     ~~~~~~~~~~~~~~~~~
  420.  
  421.     There are only 16 colors available on a ST(E). So, if the the
  422. animation has 16 colors, you'll get them, if more you'll get 16 grey
  423. levels. But, if the animation has 256 colors, you can try to reduce the
  424. palette to get a color display (when this option is available, you get
  425. an up arrow displayed into the 'Go!' button).
  426.     To do this, you must use the Shift key while clicking on the 'Go!'
  427. button, the analysis begins: all the frames are read and the number of
  428. colors actually used is displayed.
  429.     Those informations are saved and will remain available as long as
  430. you don't run another analysis.
  431.     Then, you must run again the animation with Shift + 'Go!' and,
  432. after a short delay (computing the new palette), you get your COLOR
  433. animation!
  434.  
  435.     You can combine, at the second 'Go!', the effects of Shift and Alt
  436. to save a FLM file with colors!
  437.  
  438.     Accepted formats for palette reduction are:
  439.     MOV: RAW8, RLE8, MSVC8, WRLE, SMC
  440.     AVI: RLE8, RGB8, CRAM8, MSVC8
  441.     FLI, FLC
  442.         DL
  443.  
  444. Limitations of the Shareware version
  445. ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
  446.  
  447.     MOV, AVI and GIF maker
  448.     ~~~~~~~~~~~~~~~~~~~~~~
  449.  
  450.     The animations created with MP_STE will contain a grey palette
  451. when using the unregistered version. This is not really a limit if you use
  452. those animations on the ST, because anyway, they are displayed in grey.
  453.     But if you want to export your work on another machine with a
  454. higher display (Falcon, TT, PC, MAC), only the registered version will
  455. allow you to get colored animations.
  456.  
  457.     FLM Maker
  458.     ~~~~~~~~~
  459.  
  460.     When you create a FLM from a serie of Degas/NEO images, you get a
  461. grey palette with the unregistered version.
  462.  
  463.     Extended FLM with sound/AVI/MOV/FLI conversions
  464.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  465.  
  466.     MP_STE defines a new FLM format with timing infos and sound to get
  467. high speed animations on a ST(E), the FLM format is ST Low or ST High
  468. according to the current display.
  469.     You can convert any supported MOV/AVI/FLI/FLC/FLH to FLM keeping
  470. its synchro and sound. If you are using the unregistered version, you
  471. won't be able to save the sound into the FLM (only the images with the
  472. synchro).
  473.  
  474.     Palette reduction
  475.     ~~~~~~~~~~~~~~~~~
  476.  
  477.     In the demo version, you can't get colors with the 256 colors
  478. animations, you must register to get this option.
  479.  
  480.     Where to find the last version?
  481.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  482.  
  483.     On the WEB:
  484.     http://perso.wanadoo.fr/gtello ('official' page)
  485.     http://heml.passagen.se/atari/
  486.     http://www.magmacom.com/~nima
  487.     http://www.allatsea.demon.co.uk
  488.  
  489.     FTP site:
  490.     ftp://193.190.205.13/Archive/atari
  491.  
  492.     Names are MP_STE.ZIP and M_PLAYER.ZIP (TT/Falcon).