APPENDIX C: THE PLAYER UTILITY The Player utility on the Animation disk lets you play the animations you created with DeluxePaint III. You can boot the utility from the Workbench or use CLI arguments to start the Player. From the Workbench,open the Animation disk and click on the Play icon. This loads the program in the default screen format(lo-ress,320x200,with 32 colors). The screen is black and the menu bar is not displayed. To see the program's single menu,move the pointer to the upper left part of the screen and press down on the right mouse button. Animation appears in the menu bar,and the menu bar,and the menu options,Load,Play,About,and Quit appear below the title. You're now in the "interactive" mode. Choose Load and when the Load Anim requester appears,specify which drive you want to make active (df1: or df0:) and then load a picture or anim from the directory of the drive you chose. When you click Load in the requester Play to play a picture or anim you've already loaded,just as you would in DeluxePaint III. After you've loaded an animation in memory,the Load Anim requester looks a little different when you choose Load again. The Append button appears in the requester. Click Append only if you want to add the picture or animation you're currently loading to the back end of the animation that's already in memory. You can use the same keyboard commands you've used in DeluxePaint III while you view your animation. KEY EFFECT TAB TURNS COLOR CYCLING ON/OFF LEFT ARROW SLOWS DOWN PLAY RATE RIGHT ARROW SPEEDS UP PLAY RATE r REVESES PLAY DIRECTION ESC OR SPACE BAR STOPS PLAYS 1 GO TO PREVIOUS FRAME 2 GO TO NEXT FRAME 4 PLAY THE ANIMATION 5 PLAY ONCE 6 PLAY PING-PONG To use Player from the CLI,open the CLI from the Workbench. On the command line type PLAY,space bar,and the filename of the picture or anim you want to load. If you want to show the anim for a certain number of seconds,press the space bar and type that number after the filename. If you would like to indicate that the number is a loop count instead of time in seconds,press the space bar again and type "loops". You're now ready to issue play commands for your animation(or you can press Return right now and your animation will play and take you back to the CLI when it's finished). NOTE If you type an @ before the filename in the first line,the following text string is the name of a script file from which commands are read. Script files are ASCII text files created with a text editor such as ED or MEMACS,both of which are included with Workbench 1.3. Play Commands from CLI: COMMAND MEANING PLAY RUN THE INTERACTIVE PLAYER PLAY PICT_OR_ANIM LOAD PICT_OR_ANIM,INTERACTIVE PLAY PICT_OR_ANIM 10 LOAD PICT_OR_ANIM:SHOW FOR 10 SECONDS,THEN EXIT PLAY FOO 20 SECONDS LOAD FOO:SHOW FOR 20 SECONDS,THEN EXIT PLAY ANIM 20 LOOPS LOAD ANIM:PLAY 20 LOOPS,THEN EXIT PLAY @TEST READ COMMANDS FROM SCRIPT FILE "TEST" The script commands,one per line,are similar to the CLI commands except that the word "play" is ommitted. COMMAND MEANING PICT_OR_ANIM 5 DISPLAY PICT_OR_ANIM FOR 5 SECONDS ANIM 10 LOOPS DISPLAY ANIM FOR 10 LOOPS ANIM PLAY ANIM UNTIL USER HITS KEY PICT DISPLAY PICT UNTIL USER HITS KEY 236 If you hit the Space bar or click the left mouse button while a picture or anim is running,the program will move to the next command,even if the specified play-time has not elapsed. File names with blanks must be enclosed in quotation("")marks. A command line starting with a ;(semicolon)is skipped.