home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 245.lha / Play.docs < prev    next >
Text File  |  1989-06-08  |  5KB  |  109 lines
  1. This is documentation for "Play" - the player program which
  2. accompanies Deluxe Paint III.  This documentation and the Play
  3. program and icon are 
  4.  
  5.              Copyright 1989 Electronic Arts 
  6.  
  7. and have been uploaded by permission of Electronic Arts.  If you
  8. recirculate this file, please keep this ARChive intact and do not
  9. separate the documentation or the icon from the player, as the
  10. player has no built in help and many of its functions would be
  11. non-obvious to a user who has never seen it before. Thank you.
  12.  
  13. -----
  14. [documentation which follows was keyed in by Harv Laser (Plink:
  15. CBM*HARV) from the Dpaint III manual with the express permission
  16. of Electronic Arts]
  17. -----
  18.  
  19. THE PLAYER UTILITY
  20.  
  21. The Player utility lets you play the animations you created with
  22. DeluxePaint III.  You can boot the utility from the Workbench or
  23. use CLI arguments to start the Player.
  24.  
  25. From the Workbench click on the Play icon. This loads the program
  26. in the default screen format (lo-res, 320 x 200, with 32 colors). 
  27. The screen is black and the menu bar is not displayed.  To see
  28. the program's single menu, move the pointer to the upper left
  29. part of the screen and press down on the right mouse button. 
  30. ANIMATE appears in the menu bar, and the menu options, LOAD,
  31. PLAY, ABOUT, and QUIT appear below the title.
  32.  
  33. You're now in the "interactive" mode.  Choose LOAD and when the
  34. Load Anim requester appears, specify which drive you want to make
  35. active (df1: or df0:) and then load a picture or anim from the
  36. directory of the drive you chose.  When you click Load in the
  37. requester, the utility automatically plays the highlighted file. 
  38. Choose PLAY to play a picture or anim you've already loaded, just
  39. as you would in DeluxePaint III.
  40.  
  41. After you've loaded an animation in memory, the Load Anim
  42. requester looks a little different when you choose LOAD again. 
  43. The APPEND button appears in the requester.  Click APPEND only if
  44. you want to add the picture or animation you're currently loading
  45. to the back end of the animation that's already in memory.
  46.  
  47. You can use the same keyboard commands you've used in DeluxePaint
  48. III while you view your animation.
  49.  
  50. KEY                         EFFECT
  51.  
  52. Tab                         Turns color cycling on/off
  53. Left Arrow                  Slows down play rate
  54. Right Arrow                 Speeds up play rate
  55. r                           Reverses play direction
  56. Esc or Space bar            Stops play
  57. 1                           Go to previous frame
  58. 2                           Go to next frame
  59. 4                           Play the animation
  60. 5                           Play once
  61. 6                           Play ping-pong
  62.  
  63. To use Player from the CLI, open the CLi from the Workbench.  On
  64. the command line type PLAY, [space bar], and the filename of the
  65. picture or anim you want to load.  If you want to show the anim
  66. for a certain number of seconds, press the [space bar] and type
  67. that number after the filename.  If you would like to indicate
  68. that the number is a loop count instead of time in seconds, press
  69. the [space bar] again and type "loops".  You're now ready to
  70. issue play commands for your animation (or you can press [return]
  71. right now and your animation will play and take you back to the
  72. CLI when it's finished).
  73.  
  74. *NOTE if you type an @ before the filename in the first line, the
  75. following text string is the name of a script file from which
  76. commands are read.  Script files are ASCII text files crated with
  77. a text editor such as ED or MEMACS, both of which are included
  78. with Workbench 1.3.
  79.  
  80. Play Commands from CLI:
  81.  
  82. COMMAND                     MEANING
  83.  
  84. play                        Run the interactive Player
  85. play pict_or_anim           Load pict_or_anim, interactive
  86. play pict_or_anim 10        Load Pict_or_anim: show for 10       
  87.                                seconds then exit
  88. play foo 20 seconds         Load foo: show for 20 seconds, then  
  89.                              exit
  90. play anim 20 loops          Load anim: play 20 loops, then exit
  91. play @test                  REad commands from script file "test"
  92.  
  93. The script commands, one per line, are similar to the CLI
  94. commands except that the word "play" is omitted.
  95.  
  96. COMMAND                     MEANING
  97.  
  98. pict_or_anim 5              Display Pict_or_anim for 5 seconds
  99. anim 10 loops               Display anim for 10 loops
  100. anim                        Play anim until user hits key
  101. pict                        Display pict until user hits key
  102.  
  103. If you hit the Space bar or click the left mouse button while a
  104. picture or anim is running the program will move to the next
  105. command, even if the specified play-time has not elapsed.
  106.  
  107. File names with blanks must be enclosed in quotation (" ") marks.
  108.  
  109. A command line starting with a ; (semicolon) is skipped.