DVMAKER MENUS Each DVMaker menu option is explained below. The procedure for selecting an option is the same in all cases: NEW [A-R] Loads a new blank video, with View and Video tracks, one empty Scene effect and the default non-eraseable Show effect. If you've changed the current video since you last saved (or if you've never saved it), a message asks: [Name of your video] has been changed! Save it? Click Yes if you want to save your changes (or name it, if you haven't done that) before you load a new video; click No to discard the changes (or discard the video, if you haven't saved it) and load a blank video; click Cancel to return to the current video. OPEN [A-O] Displays the Open File requester from which you can select and load (open) videos into DVMaker. Click on the video you want; its name appears in the File box at the bottom of the requester. The list window displays the names of all the disks currently available and a Parent Directory listing. Click on the Parent Directory to move to the next higher level on the disk. Click on any disk name to see the contents of that disk. Or you can click in the Drawer and/or File windows and type in the name of the Drawer or File you want to open. When you have the correct Drawer and File, click Open to load the video into DVMaker. When a video is opened, the current directory is set to the video's drawer and any temporary work files are opened there. Click on the ? icon to get a directory of all files on the current disk. Click the ! icon to stop the program from scrolling through the directory (this is useful if you spot the file you want and dont' need to see the rest of the directory). Click Cancel to return to your current video. ° See your Amiga manual if you need more information about Files, Drawers, and pathnames. APPEND Displays the Append File requester, which is similar to the requester described under Open, above. When you use Append to load a video, the selected video is attached (appended) to the end of the current video. Using Append you can build a long video by combining several short ones. SAVE [A-S] Immediately saves the current video under the current name to the current disk and drawer. If you've made changes to the video and use the Save command, the original video on disk is replaced with the current video. The first time (only) you select Save, the Save As requester appears. When a video is saved a new file is opened and created from the original file (contents, memory, and temporary files included). If the new file is successfully written to disk, the original file is renamed dvbackup.vid, and the new file is named. The new file is then reopened. You can always go back to the original file by opening dvbackup.vid. SAVE AS Displays the standard Save requester, with the current video name, Drawer and File. You can change the name of the video and or where to save it in this requester. The list window displays the names of all the disks currently available and a Parent Directory listing. Click on the Parent Directory to move to the next higher level on the disk. Click on any disk name to see the contents of that disk. You can also click in the Drawer and/or File windows and type in the name of the Drawer or File you want saved. When you have the correct Drawer and File, click Save to save the video. Click on the ? icon to get a directory of all files on the current disk. click the ! icon to stop the program from scrolling through the directory (this is useful if you spot the file you want and don't need to see the rest of the directory). Click Cancel to return to your current video without saving the changes. * See your Amiga manual if you need more information about Files, Drawers, and pathnames. PLAY SCENE [A-K] Plays the currently selected scene. PLAY VIDEO [A-L[ Plays the entire selected video. QUIT [A-Q] Closes DVMaker and returns you to the WorkBench. If you've changed the current video since you last saved (or if you've never saved it), a message box appears and asks: [Name of your video] has been changed! Save it? Click Yes if you want to save your changes (or name it, if you haven't done that) before you quit; click No to discard the changes and return to the WorkBench (No also discards the video if you haven't saved it); click Cancel to return to the current video. EDIT MENU This menu controls cutting, copying, and pasting of video Parts, and several other editing features. ERASE [A-E] Use this option carefully. It deletes the current selection from the video without changing the current contents of the Scrap Buffer. Anything erased is gone forever because there's no way to undo this command. However, if you Erase a scene, the Parts to that scene are not automatically deleted from memory. You must select Remove Unused (Parts Menu) to delete Parts that you're not using in the current video and reclaim the memory and disk space used by those Parts. CUT [A-X] Cuts the current selection out of the video and copies it to the Scrap Buffer. To select multiple tracks or effects, hold down the Shift key and click on them. When you select a track, all of the effects on the track are automatically selected. You can put the contents of the Scrap Buffer back into the video at a new location (or the same location) by using Paste. If you use Cut to delete a scene from your video, remember that the Parts to that scene are not automatically deleted from memory. You must select Remove Unused (Parts Menu) to delete Parts that you're not using in the current video and reclaim the memory and disk space used by those Parts. COPY [A-C] Copies the current selection to the Scrap Buffer. You can put the contents of the Scrap Buffer back into the video at a new location (or the same location) by using Paste. The Scrap Buffer can also be pasted into a new video. PASTE [A-P] Pastes the current contents of the Scrap Buffer (selections you've cut or copied, see Cut and Copy above) at the designated location in the current video. Or you can open a new video and paste the contents of the Scrap Buffer into the new video. When you cut or copy a track or set of tracks, and then select Paste, a track outline appears attacheed to the cursor; position the track anywhere in the Track Area and click to place it. Similarly, if you cut or copy an effect or set of effects and then select Paste, an effect outline appears attached to the cursor; position the effect anywhere on a Track in the Effect Area and click to place it. TURN ON Turns on the current selection, an Anim for example, if it was previously turned off. TURN OFF Disables the current selection so that it's ignored when the video plays. This is useful when you're editing a video and don't want to play all its sections. Turn on reverses the effects of Turn Off. OPEN Opens the current selection, which brings up a requester where you can modify the parameters of that selection. Double-clicking the selection is the same as using Open. When a selection can't be opened, Deluxe Video III informs you. COPY PALETTE Copies the color palette and color cycling information (if any) from the current selection to the next track you select. To use Copy Palette: 1. Click a track (1) to select it (the palette from this track will be copied). 2. Choose Copy Palette. 3. Click another track (2); the palette from track 1 now applies to track 2. SCENE MENU CHANGE Displays the Scene requester from which you can change the name of the Scene and its default display options. NAME Click in this window and enter a new name or alter the existing name. DISPLAY OPTIONS Whenever a Scene is created, it uses the default display options for the Video track where the Scene is placed. You can alter those display options here. Choose each option by clicking on the box to the left of the option; if the box is highlighted a small square appears inside the box and the option is active. Double Buffer When this optin is active, two copies of each rastport (that is, two buffers) are allocated in Chip RAM. Double buffers are used for brush animation. Brushes are animated by drawing in one buffer while displaying the other buffer, and then flipping between the two when the drawing is completed. This option must be on for flicker-free brush animation. Double Buffer doubles the amount of Chip memory each raster requires, so if you're just showing slides (and viewport animation), don't use Double Buffer. Restore Black When you move a brush over a raster, this option restores the raster with color 0 using the mask of the brush. If you're doing brush animation over a color 0 backdrop, you can get faster and smoother animation by selecting this option. Save & Restore When this option is active, Deluxe Video III saves what is under the raster as the bursh moves over it, and later restores what was there. Double buffering with Save & Restore is the classic form of brush animation. PARTS MENU This menu controls loading and manipulating Parts, which are the data elements that make up a video. LOAD When you highlight this option, a submen displays the different Part types of Deluxe Video III. They are Anims, AnimBrushes, Brushes, Instruments, Pictures, Sounds, and Tunes. When you select one of these types, the Parts requester for that type appears. After you select the Part you want and load it, it can be accessed by the video in either the Video Script or the Scene Script. DVMaker uses one style of requester to manage the loading of all types of Parts. Double-clicking a Part track or selcting a Part from the menu displays the same requester. PART TYPE The top bar of the requester displays the type of Part yo uselect (Animbrushes in our example). IN VIDEO This window shows which Parts are already in the current video. ON DISK This window displays a list of all the files in the named disk Drawer. The names of all the disks currently available, and the Parent Directory appear at the end of the list. Click on the Parent Directory to move to the next higher level on the disk. Click on any disk name to display the contents of that disk. * See your Amiga manual if you need more information about Files, Drawers, and pathnames. DRAWER This window shows the name of the current drawer. You can click in the Drawer window and type in the name of the Drawer or File you want. SELECTION This area shows the name and Drawer of the selected Part, the number of times it's been used in the video, and the Pool Memory it requires (Pool Memory Used/Pool Memory Size). Pool Memory stores information about the object, such as its size, position, type, and location. The object itself is NOT stored in Pool Memory. SELECT/DONE Click this button to accept the selected Part and load it into the video. PREVIEW Click this button to see or hear a preview of the selected Part. A Sound or Tune Part palys until you click the Preview button again or until the Sound or Tune ends. Any other type of Part (a selected Brush or Anim for example) appears on the Preview Screen. To select a brush, place the pointer on the brush and click. The selected brush appears with a rectangle highlighting its border. If you're previewing an Anim, the screen title shows the frame number and total number of frames (e.g., DVideo III: Frame 1/25). The following keys are active in a Preview screen: Esc Ends previewing and closes the Preview screen. You can also choose Close from the Preview menu to return to the requester and shut down the Preview screen. This key also cancels a drag operation if you are dragging an object. Arrows Up, down, left, and right scroll the Preview screen. h - Cuts the image size in half, down to a minimum of 1/8 full size. H - Doubles the image size, but to no more than full size. l - Displays the previous frame of the selected Anim or AnimBrush, or displays the previous cel of the selected figure. This key has no function for other Parts. 2 - Displays the next frame of the selected Anim or AnimBrush. This key has no function for other Parts. a - Toggles the display of all other brushes (not AnimBrushes). j - Switches to the alternate preview screen, if there is one. For the Position and MoveTo effects, pressing this key switches between the Preview What and the Preview Where options. For the MovePath effect pressing this key switches between the Trace and Edit Screens. c - Uses the color palette of the selected object. C - Uses default color palette. b - Moves (pushes) selected object to back. f - Moves (pops) selected object to front. @ - Toggles feedback of coordinates while dragging an object. You can also exit the Preview screen by clicking the front/back gadget in the upper right corner. However, the screen is still present in the background; you must click the Preview button on the requester to eliminate the preview screen. Choose Close from the Preview menu to return to the Parts requester and shut down the Preview screen. REMOVE Click to remove the selected Part from the video. See also Remove Unused, below. INFO Click to display the Info requester for the selected Part Type. There are two types of Info requesters: Audio Info is for any Sound, Tune, or Instrument Part; and Picture (or Raster) Info is for any Anim, AnimBrush, Brush, or Picture Part. The Audio Info requester has two main sections: IFF Info and User Info. IFF Info This section displays the basic information about the audio Part, in the following categories: Size Displays the number of samples and the frequency of the Sound in Hz. For a Tune, Size displays the number of tracks and instruments used. For an Instrument, it's the frequency in Hz and the number of octaves covered by the Instrument. Memory The amount of memory (in bytes) that the Audio Part uses, listed as the amount of Chip RAM and the amount of Fast RAM required. Instruments The Instruments required to play the Tune. User Info This section lets you alter some of the information about the selected Audio Part. MIDI Channel Appears for an Instrument Part only. Click this check's box to send the instruemtn request out through a MIDI channel. Click the up or down arrows to alter the MIDI channel chosen or the MIDI preset. Or click on either value shown and type in a new value. To use MIDI, you must turn on MIDI Enabled in the Options menu. To turn MIDI on permanently, you must set MIDI=yes in Tool Types; See Appendix D: Customizing DeluxeVideo III. Preopen When checked, Deluxe Video III looks to see if the selected files is available before running the video. If the file can't be found, a message tells you so before the video plays. Preload When checked, the data is loaded when you load the script into DVMaker. Use this option so you don't have to wait for data to load during playback. Not critical Check this box to tell DeluxeVideo III to continue, even if this Audio Part can't be found (or fit into available memory). You may want to activate Not Critical for a sound you think might be too big to fit into memory. OK Click to accept any changes and return to the Parts requester. Cancel Click to return to the Parts requester without changes. The Picture Info requester also has two main sections:IFF Infor and User Info. IFF Info This section display the basic information about an image, in the following categories. Size Shows the size in pixels of the image, shown as (horizontal) x (vertical) x (number of bitplanes). Colors Gives the number of colors in the image. Modes Tells you the resolution mode of the image. If nothing is shown here, the picture is in LoRes 32 color mode. Memory Displays the amount of memory (in bytes) that the image takes up, listed as the amount of Chip RAM and the amount of Fast RAM required. Origin Displays the origin point of the image, in horizontal and vertical pixels. Offset The amount the image is offset from the origin, in horizontal and vertical pixels. Other This lists the number of frames in the image, if the image is an Anim or AnimBrush. User Info This section lets you alter some of the information about the image. Mode, HiRes LACE If you want to customize the resolution of the selected image, click on the HiRes Or (Inter)LACE box. Check Modes to use these settings. Origin Click the up or down arrows to alter the origin point of the image, in horizontal and vertical pixels. Or click on the value shown and type in a new value. Offset Click the up or down arrows to alter the amount the image is offset from the origin, in horizontal and vertical pixels. Or click on the value shown and type in a new value. Preopen When checked, DeluxeVideo III looks to see if the file is available before running the video. If it can't find the file, a message appears to that effect before the video plays. Preload When checked, the data is loaded when you load the script into DVMaker. Use this option to avoid waiting for data to load during playback. Not critical Check this box to tell DeluxeVideo III to continue even if the selected images can't be found. OK Click this button to accept any changes and return to the Parts requester. Cancel Click this button to return to the Parts requester without changes. ! Click the ! icon to stop the directory from scrolling (this is useful if you've already spotted the file you want and don't need to see the rest of the directroy). ? Click on the ? icon to get a directory of all files on the current disk. CANCEL Click this button to return to the Script without changes. FIND ALL Displays a requester whre you can find all the Parts associated with the current video. If you move a video and its Parts without using DVMover, use this option so that DeluxeVideo can find the Parts and record their pathnames. REMOVE UNUSED Removes any unused Parts from the video. An unused Part is a Par that is not referenced by a track. You must choose Remove Unused (rather than Erase of Cut from the Edit menu) to delete unused Parts from your scene or video. UNLOAD ALL Frees the memory associated with all parts. Try this option if you receive a low memory error. OPTIONS MENU SCREEN Lets you choose among several screen display options, which appear in a submenu. WORKBENCH If you choose WorkBench, the DVMaker screen appears as a window on the WorkBench screen. CUSTOM If you choose Custom, DVMaker appears in a screen of its own (the default setting). INTERLACE If you choose interlace, the DVMaker screen has twice its normal vertical resolution, which doubles the amount of tracks you can have visible. WORKBENCH This command opens or closes the WorkBench. More memory is available if you close the WorkBench and use a Custom screen. EXPERT Lets you use expert level tracks and effects. When Expert mode is activated, more tracks options appear in the Choose a Track requester when you add a new track. Similarly, more effect options appear in the Choose and Effect requester when you add a new effect. MEMORY Lets you manipulate memory usage in DeluxeVideo III several ways. The submenu options are: SHOW USAGE Causes a graph of the available memory to appear at the bottom of the screen. The graph is blank until the video or scene is played; then the available memory values are recorded and displayed. The memory usage uses the time scale in the Effects Area of the script to show you how close your video is to running out of memory. If you change the script, you must play the video again for the memory graph to reflect your changes. While the memory graph is visible, pressing either c or f toggles between displaying the Chip or Fast RAM available. BUFFERS SIZES... Displays a requester where you can change the sizes of the video buffers. Deluxe Video III uses three buffers to store a video: the Video Script is stored in one, the current Scene is stored in another, and a list of all parts is stored in the third. The default sizes for these buffers are 4000, 8000, and 8000 bytes respectively. These sizes are sufficient for most normal videos. When the requester appears, you can change the size of each buffer by clicking on the up or down arrow immediately to the left of the buffer size. These new sizes take effect the next time you choose New or Open. If you want to change the sizes for the video you're working on, set the new sizes, then save the video and open it again. When you save a video, the actual buffer sizes and the minimum size of the buffers are saved with it. When you open the video, the buffer sizes you entered are used unless they're too small for the video, in which case the sizes read from the file are used instead. When DVPlayer opens a video, it uses the minimum buffer size so that the maximum possible RAM is available for the video. DISCARD SCRAP Discards the contents of the current Scrap Buffer, freeing up some memory. See also Cut, Copy, and Paste in the Edit menu. PANIC! In low memory conditions, choose Panic to free up all available allocated memory. MIDI ENABLED Sends any MIDI data from a Tune track out the serial port. This function is also controlled by the button on the Control Panel (see Control Panel). You must have a MIDI interface hooked up and MIDI-compatible musical instruments connected to the MIDI port, as well as appropriate speakers and amplifiers, to hear the MIDI data as sound. DVMOVER This program is a utility for moving a video file to another disk or drawer along with all of the necessary data. DVMover also changes the Part drawer names in the video to match the new location of the Part files. Using DVMover breaks down into the following steps: 1. Run DVMover. 2. Load a video into DVMover. 3. Change the destination drawer to the new location. 4. Copy the video. DVMOVER WINDOW When you load DVMover the DVMover Window appears. The window is partially concealed by the About DVMover notice. Besides supplying copyright information about the utility, it gives you a brief reminder of how to use it. Click OK to see all of the DVMover window. Destination Click in the Video Name ARea and type to change the video's name. Enter the name of the destination drawer in the Video Drawer area by clicking in that area and typing the appropriate drawer, or click the Change button to bring up the Video Drawer requester where you can locate the desired drawer, click on it, and then click OK to put that drawer name at the top of the DVMover window. Follow the same procedure with the Part Drawer section. Click Load to load in another video by bringing up the Data File requester. Parts in the Video This section lists the Parts of the video that have been loaded into DVMover. When you first start DVMover, this area is empty. Click the Load Video button in the middle of the window or select Load Video from the Project menu to load a video into DVMover. If there are more Parts to the video than can be displayed at one time in the Parts list, you can click on the up or down arrows to thte right or drag the scroll bar to reveal the rest of the Parts. The buttons below the Parts list apply to selected Parts. To select a Part in the list, click on its name to highlight it. Click on it a second time to deselect it. Copy copies the selected Parts to the destination. After copying, the path in the Parts list changes to match the new destination. Move is the same as Copy, but the original file is deleted. Find begins a search of all the selected Parts. When they're found, the paths in the Parts list change to match their new location. A requester appears in which you can specify a starting point for the search. Use Change to manually change the path for the selected Parts. All selects all Parts in the list. Toggle reverses the selection state of all Parts. Selected Parts are deselected and vice versa. None deselects all parts. Get Sizes reads the sizes of the selected Parts (and their icons). Options Click on any of these boxes to select an option (the box is highlgihted to show that the option is active.) If Ask before replacing Parts is selected when you move a video, and anyu Part of that video already exists in the destination drawer, a message asks if you want to copy over the existing part. If Replace ]all is selected, you won't be informed when existing Parts are overwritten. If Don't replace is selected, Parts are copied but none will be overwritten. If Copy part icons is selected, icons will be copied, too. PROJECT MENU T LOAD VIDEO [A-O] Displays the Data File requester where you can choose which video to load into DVMover. Find the video file you want to move in the list at the top of the requester. To move up a level on the disk directories, click on the Parent Dir Listing. Click on other disk names to see the contents of other disks. When you find the file you want, click on it and its name and path appear below the list. Click the ? icon to display all files on a disk; click the ! icon to halt the listing of files. Click Load to load the video into DVMover; click Cancel to return to DVMover without loading a video. COPY VIDEO [A-C] Copies all video Parts to the destination. Changes the Parts drawers to match the new destination and saves the video. If your video and its Parts are too big to fit on one floppy, you can use this procedure to copy your video to two floppies (1 and 2). > Load the video you want to copy into DVMover. > Select all Parts (click on the All button, below the Parts in the video list), and then click on the GetSizes button. > Set the destination to floppy 2. > Look at the memory availabilty reading in the DVMover Title Bar. Deselect Parts (click on them) until the remaining selected Parts can fit into the available space on floppy 2. Make sure you don't cut it too close. You must leave some extra room on the disk for the Amiga operating system. > Click on the Copy button below the Parts in the video list. > When the disk drive stops whirring, click on the Toggle button to select the Parts that wouldn't fit on floppy 2. > Set the destination to floppy 1 and click on the Copy button again. > When the disk drive stops whirring, click on Save Video. Select floppy 1 from the requester; enter the name of your video, and click Save to save the video on floppy 1. Store these disks together. You'll need them both to play your video. MOVE VIDEO [A-M] Same as Copy Video, but deletes the original Parts and video after copying. Use this option with care. When you select Move Video, DVMover displays a warning messgae asking you to confirm your selection. If you really want to move the video and its Parts, click Yes. SAVE VIDEO [A-S] Displays a file requester and then saves the video with Parts drawers as shown in the Parts list of the requester. RENAME VIDEO [A-R] Use Rename Video to change the name of the video that is currently loaded. QUIT [A-Q] Closes DVMover and returns you to the WorkBench. ABOUT T DVPLAYER This program plays one or more videos. If you want to play just one video, double-click on the video's icon and it automatically loads DVPlayer and plays normally. * For this to work you must assign DVideo properly; see Installation and Setup in Chapter 1. If you want to play several videos, select the first one with the mouse, then hold down the Shift key and click on the other videos you want to play. DVPlayer plays these videos in the order you select them. While still holding down the Shift key, double-click the last video you want, and DVPlayer plays all of the selected videos in sequence. CONTROL PANEL You can control a video while it's playing through DVPlayer by using the Control Panel or the keyboard. To display the Control Panel, while the video is playing: > Press the Help key or the right mouse button. Pressing either Help or the right mouse button removes the Control Panel when the Control Panel is visible. The Control Panel is normally appears at the bottom of the view, but if the view is overscan, the Control Panel is shown in the normal (non-overscan) region so that it's totally visible. * If the Mouse-Skip video option is on, then the right mouse button is reserved for skipping to the previous scene, and you'll need to use the Help key to display/hide the Control Panel. The Control Panel buttons are described below, from left to right. Keyboard equivalents from the Control Panel buttons appear in brackets. * After you've selected any of the other Control Panel buttons, you must click the Forward button to continue playing your video. Power [Esc] This button, marked with a red rectangle, stops playing the video and returns you to the WorkBench (if you were running DVPlayer) or to DVMaker (if you were running DVMaker). Rewind to Start [F1] Instantly rewinds to the beginning of the video. <-- Previous Scene [Shift-Tab] Skips the video to the beginning of the previous Scene. << Scene Start [Left-Shift <--] This button (marked with double left-facing arrows) skips the video to the beginning of this Scene. Pause [V] This button, makred with a black rectangle, pauses the video. > Forward [-->] Resumes playing the video. >> Fast Forward [Right-Shift -->] Runs the video clock faster than real-time, so that the video plays more swiftly. --> Next Scene [Tab] Skips the video to the beginning of the next Scene. Time Counter This area displays the time elasped during the video. .... Single Step [F2] Pauses the video with the first press. You can then click the Forward button repeadedly to step through the video one frame at a time. This feature is very useful when you are trying to synchronize multiple animations. Loop [F3] Loops the video to the beginning and replays it continuously. Audio [F4] Controls the Audio tracks of the video. If this button is off, no Audio track will play during the video. M MIDI [F5] Controls the MIDI output of the video. If this is on, the MIDI options listed in the SMUS files for Tune tracks are used instead of the Amiga instruments. To Back This button hides the Control Panel. Alt Esc Quit playing the current video and skip to the next one (if you have shift-selected a series of videos to play). INSTANT SLIDESHOW This program quickly and easily creates a slide show video from a list of pictures. You can play a video created in this way with DVPlayer or it can be loaded into DVMaker and modified like any other video. InstantSlideShow is also a very easy way to begin creating a video that has a series of pictures; it's faster to use InstantSlideShow to get a series of pictures in a Script than it is load each one into DVMaker. INSTANT SLIDESHOW DISPLAY When you load the program (double-click its icon), the Instant-SlideShow Display appears. There are three keyboard options available: ° Press > to select the next slide ° Press < to select the previous slide ° Press Esc to stop making a list of slides when you've selected multiple slides from the Files window. SLIDES The list of pictures in your InstantSlideShow appears in this area. Selected pictures are highlighted. Click on the up or down arrows to the right or drag the slider to see more picture names. FIRST Click to place the selected picture first on the list. If more than one picture is selected, all pictures are placed at the head of the list in the same order as they appeared on the list. LAST Click to place the selected picture last on the list. If more than one picture is selected, then all picutres are placed at the bottom of the list in the same order as they appeared on the list. SOONER Click to place the selected picture one slot highter on the list. If more than one picture is selected, they are all placed one slot higher on the list in the same order as they appeared on the list. LATER Click to place the selected picture one slot lower on the list. If more than one picture is selected, they are all placed one slot lower on the list in the same order as they appeared on the list. SORT Click to sort all pictures, selected or not, into alphabetical order. PREVIEW Click to see the selected picture. Choose Close from the Preview menu to return to the InstantSlideShow window. REMOVE Click to remove the selected picture(s) from the list. FILES This window shows the available files on disk. Find the Picture file you want in the requester. To move up a level on the disk directories, click on the Parent Dir listing. Click on other disk names to see the contents of other disks. When you find the Picture file you want, click on it and its name and path appear below the list and in the Slides window. Click the ? icon to display all files on a disk; click the ! icon to halt the listing of files. OPTIONS This section controls the timing of the SlideShow. Select any box by clicking it; when active, the box is highlighted. Wait for mouse makes the slide show wait for a mouse click before showing the next picture. Check the Wait box to have the slide show wait the indicated number of seconds before showing the next Picture. Click the up or down arrows to increase or decrease the duration, or click in the box directly and type in a new time value. Check the Overscan box to have the pictures displayed in overscan mode. Make Video Click this button to create the InstantSlideShow of the pictures on the list. INSTANT SLIDESHOW MENU PROJECT MENU Make Video [A-M] This command has the same function as the Make Video button on the Display. QUIT [A-Q] This command closes InstantSlideShow and returns you to the WorkBench. SUMMARY OF TRACKS AND EFFECTS TRACKS What follows is a list of all the tracks supported by DeluxeVideo III, cross-referenced with their associated effects. Tracks from the Video SCript are marked [VS]; tracks from the Scene Script are marked [SS]. See the appropriate sections of this Reference chapter for more information about any track or effect. Anim Track [SS] Back, Clear, ClrCycle, FadeIn, FadeOut, FadePtrn, Front, HAMFixup, Hide, Load, LockClrs, MakeAnim, MoveTo, Options, PlayAnim, Position, Release, Scroll, Show, SlideIn, SlideOut, UnLoad, WipeIn, WipeOut. AnimBrush Track [SS] GoTo, Hide, Load, MovePath, MoveTo, PlayAnim, Position, Release, Show, Stamp, UnLoad, UnScroll, UseClrs, WipeIn, WipeOut BackDrop Track [SS] Back, Clear, ClrCycle, Continue, FadeIn, FadeOut, FadePtrn, Front, HAMFixup, Hide, LockClrs, MakeAnim, MoveTo, Options, Position, Release, Scroll, Show, SlideIn, SlideOut, WipeIn, WipeOut Background Track [VS,SS] Hide, Purge Box Track [SS] GoTo, Hide, Load, MovePath, MoveTo, Pattern, Pickup, Position, Release, Scroll, Show, STamp, UnLoad, UnScroll, UseClrs, WipeIn, WipeOut Brush Track [SS] GoTo, Hide, Load, MovePath, MoveTo, Pattern, Pickup, Position, Release, Scroll, Show, Stamp, Unload, UnScroll, UseClrs, WipeIn, WipeOut Control Track [VS,SS] Button, GoTo, Joystick, KeyTo, Label, PanelOn, Pointer, TimeStep, Wait Device Track [VS,SS] Message Picture Track [SS] Back, Clear, ClrCycle, FadeIn, FadeOut, FadePtrn, Front, HAMFixup, Hide, Load, LockClrs, MakeAnim, MoveTo, Options, Pattern, Position, Release, Scroll, Show, Slide In, Slide Out, Unload, Wipein, Wipeout Sound Track [SS] Load, Pan, Play, UnLoad Textline Track [SS] GoTo, Hide, Load, MovePath, MoveTo, Pattern, Pickup, Position, Release, Scroll, Show, Stamp, Unload, Unscroll, Useclrs, Wipein, Wipeout Tune Track [VS] Load, Play, Unload, Volume Video Track [VS] Scene View Track [VS] Show TRACKS AVAILABLE IN VIDEO SCRIPT Background, Control, Device, Tune, Video, View TRACKS AVAILABLE IN SCENE SCRIPT Anim, AnimBrush, BackDrop, Background, Box, Brush, Control, Device, Picture, Sound, Textline TRACK TYPES AUDIO (Sound, Tune) EXPERT (Background, Device) OBJECT (AnimBrush, Box, Brush, Textline) SETUP (Video, View) VIEWPORT (Anim, Backdrop, Picture) EFFECTS Effect Tracks/Type Exper Mode Back Viewport x Button Control x ClrCycl Viewport Continue Backdrop x FadeIn Viewport FadeOut Viewport FadePtrn Viewport x Front Viewport x GoTo Object, Control KeyTo Control Hide Background, Object Viewport Label Control Load Object, Viewport (except Backdrop), Audio LockClrs Viewport x MakeAnim Viewport Message Device x MovePath Object MoveTo Object Options Viewport x PanelOn Control Pattern Picture x Pickup Object x Play Audio PlayAnim Anim,AnimBrush Pointer Control Position Object Purge Background x Release Object,Viewport x Scene Video Scroll Object, Viewport Show Object, Viewport SlideIn Viewport SlideOut Viewport Unload Audio, Object Viewport x Wait Control Appendix A: Technical Information HOW DELUXE VIDEO III DISPLAYS PARTS If you want to become an expert DeluxeVideo user, you should spend some time studying how Deluxe Video's screen display is formed. The figures below shows the elements of a display. The terminology is Commodore's, and we apologize for the jargon,but we'll use these terms rather than invent our own. As you read through this section, refer to this figure if you need clarification of a term. The Screen For our purposes, the screen is simply your monitor's screen. DeluxeVideo doesn't care about the size of your screen, but it cares a lot about the size of the view. The VIEW The View is a rectangle of video data. This rectangle is defined by its origin, size, and offset. The origin is always the center of the View. You can set the size and offset of your View in the View requester. In our figure, the View is set to be larger than the area of the monitor's screen. Most Amiga programs set the view size to 320 x 300 to guarantee that the entire view is visible on all computer monitors. As a result, there is a blank area visible around the view. For video applications, it is better to make the view larger than most monitors can display, so that there is no blank border. A large view such as this is called overscan. Professional video applications demand an even larger view, sometimes called severe-overscan. DVMaker lets you set normal overscan by clicking a button in the View requester. If you are in Expert mode, you can also set severe overscan, though we do not recommend this, since too much overscan may result in Video Nightmare. BITMAPS For the sake of clarity, we divide bitmaps into two classes; rasters and objects. The primary difference between the two is that a raster has a viewport directly associated with it (because it was loaded into a Viewport track). An object must be attached to a viewport track to be seen. RASTERS A raster is a picture or an anim (or a backdrop created when DeluxeVideo plays a video). A raster has an origin, a size, a depth (in bit planes, which determines the number of colors), and a viewmode (LoRes, HiRes, Interlace). The origin of the raster is normally its center. Regardless of how the origin is intitalized, you can change it to any location within the raster. To change a raster origin, use the Origin option in the User Infor area of the Raster Info requester. (To display the Raster Info requester, click Info in the Parts requester for your raster.) A raster can be any size from 1x1 to 1008x800. The most important characteristic of a raster from the point of view of how it behaves in DeluxeVideo III is that the raster has a Rastport and a Viewport. Objects (brushes, and anything else "attached" to a viewport) do no have viewports. RASTPORTS A rastport is a region of a raster defined by a size, origin, and offset. The rastport define what appears in the view. The rastport size is limited by the raster size and by the viewport size, whichever is smaller. The rastport is initially set to be the same size as the viewport, which in turn is set to be the same size as the view (see Viewport, below). The rastport is constrained to lie entirely within the raster. Animation is achieved by changing the rastports is revealed or hidden. If you change the rastports offset (Position) the raster appears to scroll inside the rastport, though in fact it is the rastport that scrolls. The What & Where example in Chapter Five: Video Effects illustrates how changes in the size and position of the rastport creates animation effects. VIEWPORTS A viewport is a region defining where the rastport appears in the view. It size is forced to be identical to the matching rastport and the viewport's origin is fixed at it's center. Viewports are initially created at the same size as the View, set in the requester for the View track. You can change the size of your viewport by using the What option of the Position of MoveToEffect. Animation is achieved by changing the viewport's offset with time. OBJECTS An object is a brush, animbrush, or textline (or a box created when DeluxeVideo plays a video). Each object is defined by a size, origin, and offset. Objects have the dquivalent of a rastport that you can adjust to change how much of the object is displayed and where that window is positioned over the object. You make these adjustments in the What and Where requester just as you would for a Raster. However, an object has no viewport, and must be attached to a viewport track (or to another object attached to a viewport track) to be visible. An ojbect is positioned relative to its parent by placing its origin at an offset from the parent's origin. (The parent is the object or raster to which the object is attached.) The object is animated (moved across the screen) by changing its offset with time. Appendix B: Troubleshooting When you first begin using DeluxeVideo III, it is likely that you will not do everything right the first time. The program prompts you with error messages, but until you are familiar with the different AmigaDOS error messages and the concepts of attaching tracks and displaying viewports, you'll probably have some trouble figuring out what the error messages mean. The following list of error messages and what they really mean is meant as a help. It is by no means a complete list of error messages. These are the messages we think you'll run into in your early experience with the product and that you may not understand right away. MOST COMMON AMIGADOS ERROR MESSAGES AmigaDOS error 205: AmigaDOS cannot find the file you specified. Check that you have the correct file name and drawer. Check that the disk is in the drive. AmigaDO"S error 103: Not enough physical memory (ram:) to complete this task. Try closing the WorkBench or other applications. AmigaDOS error 221: Disk Full. Not enough space on your disk. AmigaDOS error 214: Disk is write protected. DVideoIII needs to be able to write to the disk to make temporary files. MOST COMMON VIEWPORT ERROR MESSAGES Error 215: Brush's viewport is not visible. You will get this error message if you try and "show" an object track that's connected to a viewport track (BackDrop, Picture, or Anim), which has not been "shown" by a Show, Position, MoveTo, etc. Error 224: Viewport is not visible. Make your viewport track (BackDrop, Picture, or Anim) visible with a Show or Position effect. Error 225: Track not attached to a Viewport. Attach your track to a Viewport (BackDrop, Picture, or Anim). Appendix C: Using ARexx & DeluxeVideo By using a Device track in DeluxeVideo III you can communicate with an external program that can, in turn, communicate with another device. The common language by which you communicate between DeluxeVideo III and another deive is ARexx. ARexx is an Amiga implementation of the well know REXX language. ARexx is currently available from William S. Hawes (address on Page 237). You will need the libraries that come with ARexx in order for DeluxeVideo III to communicate with other devices. THE THEORY Let's use the SuperGen example included with DeluxeVideo III to outline the procedure. When you have Expert mode turned on in DVIII you will have an added video track called Device. When you add a Device track, a requester asks for the Port Name. Type in SuperGen as the Port Name. This defines to DVIII that all messages for this Device track will be sent to a port called "SuperGen." Now drag down a new effect. For a Device track there is only one effect - a Message. In the Message requester you input the message text that you want sent to the port as well as some options for special cases. Type "FadeIn" in the Message Text box. This sends a message of "FadeIn" via an ARexx port to a program (DVSuperGen) that, using software included with SuperGen, then controls the SuperGen hardware. Did you get all that? WHAT YOU NEED TO RUN THE SUPERGEN EXAMPLE Obvisouly you will need an Amiga and DeluxeVideo III and a SuperGen from Digital Creations. Once you have this all set up you will need to have the ARexx libraries (rexxsyslib.library and rexxsuport.library) and the SuperGen libraries (SuperGen.library and copinit.library) in the LIBS: drawer on the volume you booted from when you booted. These libraries come from ARexx and SuperGen respectively. You also need the program SuperGen. This is in the rexx_examples drawer on the DVideo disk. From the CLI you must launch the SuperGen program, which will leave a little window open on your WorkBench. Now you can launch DVIII and create a Device track as outlined in the "theory" section above. COMMANDS IN THE SUPERGEN EXAMPLE There are five "messages" that you can send through the SuperGen example program. ° Reset: Immediately sets the background and graphics values to 100% external video. ° FadeIn: Over the duration of the effect, gradually increase to 100% Amiga grapics. ° FadeOut: Over the duration of the effect, gradually decrease to 100% Amiga graphics. ° BgFadeIn: Over the duration of the effect, gradually increase to 100% Amiga background. ° BgFadeOut: Over the duration of the effect, gradually decrease to 100% Amiga background. FOR PROGRAMMERS ONLY! Also included in the rexx_examples drawer on the DVideo disk are various other files for C programmers to create their own programs to communicate via an ARexx port with DVideo. Again, to use these you wil need ARexx, code from the manufacture of the device you wish to control, and a C compiler. Electronic Arts will not be giving technical support for programmers to write their own programs. You will have to contact the manufacturer of the device, ARexx, and or the compiler maker. These files are included only as examples and not as finished and working code. SuperGen Executable program for controlling the Digital Creations SuperGen. sgmain.c Main C source for SuperGen. supergen.lmk Link file for Manx C. supergen.lnk Link file for Lattice C. VTRTest Executable program demonstrates shell of real program to control a VTR. vtmain.c Main C source for VTRTest. vtrtest.lmk Link file for Manx C. vtrtest.lmk Link file for Lattic C. W Appendix D:Customizing DeluxeVideo This chapter lists the tooltype options available for all four DeluxeVideo programs. The casual user doesn't need to use them at all. The options are listed in order of sophistication. The first group is for advanced users, and the second group is for experts. Each parameter is shown with its default. Numerical parameters are followed by the allowable minimum and maximum. Each one if sollowed by code letters indicating which program it applies to M=DVMaker, P=DVPlayer, X=DVMover, I=InstantSlideShow. ADVANCED TOOLTYPES "anim=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add an Anim track to a video or choose the Load>Anims menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for Anims on disk. "animbrush=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add an AnimBrush track to a video or choose the Load>AnimBrushes menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for AnimBrushes on disk. "brush=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add a brush track to a video or choose the Load Brush menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for Brushes on disk. "closewb=no" [MP] - By default the WorkBench is open when you use DVMaker and DVPlayer. Set to "yes" to close the WorkBench and free up about 30K of memory. Be aware, however, that some early versions of WorkBench may not reopen properly. "credits=yes" [P] - Suppresses the DVideo splash screen so that you can show your videos without the DVideo credits at the beginning. 'expert=no" [M] - Sets the default value of the Expert menu option in DVMaker. Setting this in tooltypes saves the user the trouble of setting it via the menu each time he runs DVMaker. "instruments=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add an Instrument track to a video or choose the Load Instrument menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for Instruments on the disk. "MIDI=no" [MP] - For DVMaker this saves you the trouble of using the Enable MIDI menu option each time you run DVMaker. For DVPlayer this enables MIDI so you don't need a button effect on the control track to turn on MIDI. In general, this enables DVideo to play music on a MIDI device. When a tune is played, any instrument that has its MIDI flag on will be played as a MIDI instrument with the indicated channel and preset (set the channel and preset using the "Info" requester under the Instruments Part requester). Any instrument with the MIDI flag off will be played as an Amiga instrument. "numfiles=80" 20.400 [MPXI] - Specified the approximate number of files that can be displayed in the file requester. This option is most useful to hard disk users. The average file name is about 10 bytes long, but with other information requires about 25 bytes of memory. So if you specify 40 files, a 1000 byte block of memory (FAST, not CHIP) will be allocated to hold file names for the file requester. The memory is not permanently allocated, and will be freed by DVideo's memory manager if memory starts to get tight. The default holds about 80 file names, but you can increase to any value up to 400. "partsize=8000" 1000..100000 [MXK] - Sets the default size of the part buffer. "parts=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add any part to a video (that is a part that doesn't have its own drawer setting in tooltypes). Also causes the file list to be kept in memory separate from the file lits for videos or other parts, so that the list doesn't have to be rebuilt next time you look for parts on disk. "pictures=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add a Picture track to a video or choose the Load Picture menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for Pictures on the disk. "screen=1" 0..1 [M] - Lets you specify which type of screen the DVMaker window is opened. Use 0 for the workbench screen, 1 for a custom HIRES screen, and 2 for a custom HIRES LACE screen. "scenesize=8000" 1000..100000 [MXI] - Sets the default size of the scene buffer. "searchpath=" 195 characters max [MP] - Define a series of drawers to look in if a part cannot be found in the drawer it's supposed to be in. Separate drawer names with a space, "searchpath=parts videos." Suppose a part isn't where it's supposed to be, for example: If a video is in "dh0:dv/videos"... and one of its parts has a drawer defined as "dh0:dv/parts and in tooltypes "searchpath=df1: /mystuff dh0:moreparts" ...then DVMaker will search for the part in this order dh0:dv/parts - it looks in the part's drawer first dh0:dv/videos - next it checks the current directory (i.e. the video's location) df1: - then the search path dh0:dv/videos/mystuff -.../mystuff relative to the current directory dh0:moreparts Note: A video will always play if the parts are in the same drawer as the video. "sounds=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add a Sound track to a video or choose the Load Sound menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for Sounds on disk. "tunes=" 195 characters max [M] - (for hard disk users) Specifies the drawer to look in when you add a Tune track to a video or choose the Load Tune menu option. Also causes the file list to be kept in memory separate from the file lists for videos or other parts, so that the list doesn't have to be rebuilt next time you look for Tunes on disk. "videos=" 195 characters max [M] - Specifies the drawer to look in when you open a video. This must be a complete path name starting with a volume name, like this "dh0:dvideo/myvideos." It can't start with a logical volume name that is assigned to a particular drawer. Floppy disk uses may wish to set "video=df1:." EXPERT TOOLTYPES "dirlevel=1" 0..128 [PI] - If a program is launched by selecting a drawer icon and shift-double-clicking the program's icon, it will search the directory for files. This parameter sets the directory depth to search for files. Normally the dirlevel is one so that only the drawer itself is searched. If level is two, the next level of subdrawers would be searched. "hamicon=yes" [MP] - Set this to "no" if you don't want the HAMFixup icon to be displayed during a HAMFixup effect. "numscenes=1" 1..10 [MPX] - Sets the number of scenes that are kept in memory. Normally only one scene is kept in memory at a time, so if you open one scene and then antoher, the first one must be saved on disk before the second one is loaded. Use a higher value if you find yourself switching between scenes frequently and you don't want to load them from disk each time. This is useful only if you have lots of memory. "priority=5" 0..128 [MP] - Sets the task priority while playing a video. The music subtask priority is set to one higher and the sound subtask priority is set to two higher. If you set this value too high, other tasks on your Amiga may not be able to run and you may be forced to reboot. Use this at your own risk. "preload=no" [P] - Use this in conjunction with "numscenes." Before a video is played, the indicated number of scenes will be preloaded into memory. This eliminates a disk I/O delay between scenes. You still need to use "preload' on any parts you want preloaded. "xoffset=0" -32..32 [MP] - An offset added to the x value in a video's view track. Use this if someone generates a video on their machine and it's not centered horizontally in the screen of your machine. Correct the problem by setting an x offset value in the tooltypes of the DVPlayer icon. "xoverextra=32" 0..64 [MP] - The number of extra pixels added to a normal screen width to get overscan. Normally this is 32, so that overscan would be 352. A professional video user may want to change this so that he doesn't have to manually set the overscan size each time. Since values larget than 32 may cause trouble, only experts should use this option. "yoffset=0" -32..32 [MP] - An offset added to they y value in a video's view track. Use this if someone generates a video on their machine and it is not centered vertically in the screen of your machine. Correct the problem by setting a y offset value in the tooltypes of the DVPlayer icon. "yoverextra=40" 0..80 [MPI] - (The default on a PAL machine is 34.) The number of extra pixels added to a normal screen height to get overscan. Normally this is 40, so that overscan would be 240. A professional video user may want to change this so that the overscan size does not have to be set manually each time. Since values larger than 40 may cause trouble, only experts should use this option. "vpspacing=3" 1..10 [MP] - Sets the number of blank video lines to skip between viewports in a view. A professional video user may need to reduce this value. Smaller values may cause errors in the color palette, and larger values may cause the control panel to be invisible. Appendix E: Keyboard Equivalents DVMaker Project Menu A-R New A-O Open A-S Save A-K Play Scene A-L Play Video A-Q Quit Edit Menu A-E Erase A-X Cut A-C Copy A-P Paste DVMOVER Project Menu A-O Load Video A-C Copy Video A-M Move Video A-S Save Video A-R Rename Video A-Q Quit INSTANTSLIDE SHOW Project Menu A-M Move Video A-Q QUIT PARTS MENU KEYBOARD COMMANDS FROM THE PREVIEW SCREEN Esc - Ends previewing and closes the Preview screen. You can also choose Close from the Preview menu to return to the requester and shut down the Preview screen. This key also cancels a drag operation if you are dragging an object. Arrows - Up, down, left and right scroll the Preview screen. l - Displays the previous frame of the selected Anim or AnimBrush, or displays the previous cel of the selected figure. This key has no function for other Parts. 2 - Displays the next frame of the selected Anim or AnimBrush. This key has no function for other Parts. a - Toggles the display of all other Parts on the same track. b - Moves (pushes) selected object to back. c - Uses the color palette of the selected object. C - Uses default color palette d - deletes a point, just like the Delete button on the Path requester. f - moves (pops) the selected object to the front. h - Cuts the image size in half, down to a minimum of 1/8 full size. H - doubles the image size, but to no more than full size. i - inserts a new point, just like the Insert button on the Path requester. j - switches to the alternate preview screen, if there is one. For the Position and MoveTo effects, pressing this key switches between the Preview What and the Preview Where options. For the MovePath effect, pressing this key switches between the Trace and Edit screens. @ - Toggles feedback of coordinates while dragging an object. + - Selects the next pint and draws the Object there. - - Selects the previous point and draws the Object there. You can also exit the Preview screen by clicking the front/back gadget in the upper right corner. However, the screen is still present in the background; you must click the Preview button on the requester to eliminate the preview screen. Choose Close from the Preview menu to return to the Parts requester and shut down the Preview Screen. CONTROL PANEL The Control Panel buttons can be manipulated from the Keyboard. Power [Esc] Rewind to Start [F1] Previous Scene [Shift-Tab] Scene Start [Left-Shift <--] Pause [v] Forward [-->] Fast Forward [Right-Shift -->] Next Scene [Tab] Single Step [F2] Loop [F3] Audio [F4] MIDI [F5] Alt Esc - Quit playing the current video and skip to the next one (if you have shift-selected a series of videos to play)