The movieEngine Palette component is a UI-less moviePlayer, and is a multi-purpose tool for playing, controlling and examining movies. It can be used standalone or embedded in TouchDesigner applications. Unless otherwise noted, movieEngine features are also part of moviePlayer.
- Drag-drop movie or image files onto the viewer from the desktop or from Movie File In TOP. Alternately change the file name in the File parameter.
- Clicking on the movieEngine viewer controls scrubbing the movie (a minimal UI).
- It plays a movie's audio to an audio device and/or the component's output.
- movieEngine lets you switch to a new movie without frame drops via drag-drop, scripting or parameters.
- Movie playback can be externally controlled with CHOP ramps, python commands and pulse parameters.
- Using cues set up in moviePlayer, you can set multiple in- and out-points and then jump to cues, play and loop.
- movieEngine uses Movie Spec components that can hold your movie settings and cues, which enables you to later re-call and play sub-sections of movies using movieEngine or moviePlayer.
Note movieEngine follows the Initialize/Start convention of TouchDesigner, which gives more control over transition from one movie to the next. It separates the process of (1) specifying a new movie or movie spec via drag-drop of changing pars, (2) the Initialization of the new movie at certain starting point, cued ready to play and (3) triggering to Start at that point. This can all be done in one shot (default) or separately with the Initialize and Start pars.
(Get movieEngine from the Palette, or, from the External page of moviePlayer, press Create Engine COMP.)
Get movieEngine from the Palette -> Tools, then rclick -> View to get it in a floating window, or simply use movieEngine in the node viewer in the network.
To play a new file, (1) change the file name in the File parameter, or (2) drag-drop movie files from a file browser onto the panel UI or node viewer (with Viewer Active on), or (3) drag-drop a Movie File In TOP onto the panel or the node viewer in the network.
On the movieEngine parameter dialog, press Open Movie Parameters.
On the top row of the floating dialog, you see the tabs Player (for player settings) and Movie (settings for the specific movie you are playing now). Select Movie and adjust anything (say, Speed, Gamma) and verify the speed/level changes.
Movie Settings and Adjustments
On the movieEngine parameter dialog click Open Movie Parameters, or on the movieEngine panel click the Controls button on the left. This brings up the custom settings of the current movie.
Parameters on the Movie -> Settings 1 and Settings 2 pages adjust and prepare the movie: start-end trim, crop, Black Level / Luminance / Gamma adjustments, speed, audio gain, etc. Note that these adjustments don't affect the movie file itself, only how it is played in movieEngine.
The audio signal always goes out the second output. But movieEngine optionally plays audio to the default audio device (Internal Audio Player on the Control page). Its Volume parameter on the Control page is mirrored in the UI as the Audio slider. Alternately the second output of the component can be routed to a mixer/output component.
Initialize and Start
The Initialize/Start convention of movieEngine, and TouchDesigner in general, gives more control over a transition from one movie to the next. Normally, with On Source Change set to Initialize and Start, it will start playing the new movie as soon as it's loaded. But you can separate the process of (1) specifying a new movie or movie spec via drag-drop of changing pars, (2) the Initialization of the new movie at certain starting point, cued ready to play and (3) trigger to Start at that point. This can all be done in one shot (default) or separately with the Initialize and Start pars.
Assuming you want to seamlessly get the the new movie loaded, initialized and paused at a certain frame, ready-to-play, at which time you would press Start or trigger it externally. For this behavior, set On Source Change to Initialize and Pause. Alternately, you want movieEngine to initialize nothing while you drag-drop a new movie or change the File Path parameter, and then initialize only when you press Initialize, etc. You can set the starting time using Initialize Time parameter.
While playing, Go to Done, jumps to the end of the movie and stops. The pulse parameter Go Back to Prev Movie lets you alternate between the current and previous movie.
Timing information is sent out the out3 output of movieEngine in a CHOP, with time counters and the current initialize, start, running and done states.
movieEngine is designed to play a single movie at a time and does not crossfade between pairs. Because loading and initializing the next movie frequently takes more than one frame, the image may be invalid for one frame or more. By default it fades down for .2 sec, reloads, and fades up for .2 sec. You can set those to 0 sec but some frames of black may appear. You can set Transition to Freeze and Cut, and it will hold the last frame of the previous movie and cut to the new movie when ready. Other tools using movieEngine internally will do crossfades.
In moviePlayer you can set up cues (a point or sub-section of a movie), each with a "beauty" frame, a "start" time, an optional "end" time and a end-start crossfade time.
in movieEngine, you can play cues via the Go page of the parameter dialog.
Movie Spec Components
A Movie Spec component specifies a movie file path and movie adjustments like in/out trim points, cropping, brightness/gamma/black level, speed, cues, metadata and more.
To create a Movie Spec component, open a moviemovieEngine via the File parameter of movieEngine, or drop a movie from the file system or a Movie File In TOP onto movieEngine's UI viewer. Then go to the External page, and press Copy Cur Mvspec Below. A new Movie Spec component is created below whose icon is the current movie. (You can check its Settings pages and look inside to see its cues.)
Then you can drag-drop these "mvspec" components to the moviePlayer or movieEngine panel to switch movies with all their settings and cues. You can use moviePlayer to edit the mvspec component further.
Alternately, change the movieEngine parameter Source Type to Movie Spec COMP, and change the Movie Spec parameter to the Movie Spec component that you want to play. movieEngine
Movie Spec Metadata Info
A Movie Spec component, on its Info page, also holds persistent movie metadata (as read-only parameters) that is normally only available if you open the movie file: images per second, time lengths, resolution, aspect ratio. So you can get movie info without opening the movie. (it is updated/validated every time the movie is opened by moviePlayer/movieEngine).
More on Cues: Cue Boxes, Columns or List
You can change the display of the top area to display cues as a time-ordered list. On the UI page, change the Cue Edit Area menu to Cue List. Cue Columns is convenient for use with touch screens.
Note that every cue is a Base component in
movieEngine1/mvspec/cues, each with a few custom parameters.
After pressing Open Movie Parameters on the parameter dialog, if you have set a cue, you can see the Cues' parameters by selecting it in the top row of buttons beside Player and Movie. Or click the Set> menu and select Cue Parameters to bring up the parameters of a cue.
Here you see where the start, end and beauty times are held. You can name the cue. The Enable parameter undisplays the cue in the timeline, and is useful when it gets too cluttered. The Next Behavior menu allows you to stop or loop when reaching the end of a cue. You can set it to go black (0 0 0 1) or zero (0 0 0 0) at the end of the cue. You can safely delete or re-order
cue2... components in the cues network, or via the Set> menu.
The movie image and audio go out the first two outputs. Output 3 is the current movie's aspect ratio, length and rate. Output 4 contains cross-fading channels and diagnostics that may be useful.
movieEngine contains about 44 nodes initially without cues - your GPU memory may become the limiting factor as you add many moviePlayers. But its default behavior is to pause movieEngine when it is un-selected, to avoid using GPU and CPU time (see the Behavior page).
External Control of movieEngine
To drive movieEngine externally you can use CHOP timing ramps (like from a Timer CHOP, Beat CHOP or LFO CHOP). You can use python trigger commands to position/play at specific times or cues, or pulse parameters on the dialog UI that jump to cues or specific times.
To drive it externally, go to the External page, choose a CHOP and a channel that you want to drive it with and set the CHOP and Channel parameters. Select the appropriate units - seconds, frames (timeline frames) or 0-1 fraction. Then turn on External Control Active.
You can refer to values in the third output of the CHOP which contains 3 constant channels: length (how many seconds long in movieEngine is the currently selected cue (cue 0 is the full movie)), duration (this is the length divided by the Speed parameter - the movie takes longer to play if you set the Speed lower than 1)) and the movie's rate (images per second).
On the "Cues" page of the component's parameters, you can select a cue number and press Go to Cue and Play, for example. You can drive this with python or by exporting to the parameters.
You can alternately set a time and press Go to Time and Play. Also the parameters on the Cues page of movieEngine can be used to jump to cues, pause, play, etc.
Control of movieEngine with Python
The python extension in the component has the functions such as
GoToCue(cuenum, cuepoint, play) and
GoToTime(seconds, play). Example to go to 50 sec and play:
See the extension DAT in movieEngine, which contains more functions to control via python.
Multi-movieEngines or Multi-"Movie Specs"
There are two ways to manage multiple movies. Most simply, you can duplicate
movieEngine1 in the network and alter the duplicates. This will let you play several movies at one time. Changing the file name will delete all its cues and reinitialize all the parameters.
Alternately, if you have more that 10 movies or so, you can have a multitude of lightweight "Movie Spec" components, and drag-drop them onto any movie player. This is equivalent to setting a movieEngine's Movie Spec parameter to point to the external
To create a Movie Spec component, on movieEngine, on the External page, press the parameter "Copy Cur mvspec Below". It copies the current settings of the movie of movieEngine to a component
mvspec1, just below movieEngine in the network. ( Internally it is copying the template
movieEngine1/mvspec1 or the latest
The Movie Spec components are very lightweight. Inside it are 5 passive nodes plus one empty Base component per cue.
You can make several copies of
mvspec1. Then for each
mvspec*, you can edit its parameters manually. Then you can drag-drop it onto the
movieEngine viewer, or assign it to the Movie Spec parameter of
movieEngine. Then you can edit and add cues etc as you normally would with the moviePlayer UI. All edits are saved in your
movieEngine - moviePlayer Without UI
movieEngine is a lightweight component that can be embedded in other tools to smoothly drive movie playback and switching.
On moviePlayer, on the External page, press Create Engine COMP Below. It will create
movieEngine1 in the network below moviePlayer, which is the same as moviePlayer, but with its UI removed and other non-essential operators removed.
TIP: On movieEngine, you can middle-click to pause/play. You can left-click/drag on the image to scrub, and to pause when you release, release the mouse when the cursor is below the panel. To assure it's playing forward after you scrub, release with the cursor above the panel.
Also movieEngine is controllable via its parameters, its inputs and its Extensions calls in the same way as you control moviePlayer.
Crossfading Between Two movieEngines
To do crossfading or exact frame cuts between movies, you need two movieEngines or moviePlayers.
Every time you assign a new
mvspec to movieEngine's Movie Spec parameter, it may take a few frames to unload the prior movie, open the new movie and load the number of pre-read frames into the GPU. (It uses the Timer CHOP for this, and you can watch the timing on the
out4 of movieEngine So one movieEngine can never guarantee a perfect cut between movies. For this reason you need two movieEngine components to perfectly cut or crossfade between them. You get the second movieEngine to pre-load the next movie before making a cut or crossfade. You can use the "
fade fadein" channels coming out of the 4th output of movieEngine to control the cross-fading.
On the Setup page, Force Resolution internally scales the movie to your desired resolution when it is read. You can set the number of core for decoding, and turn on hardware decoding, which is recommended if possible.
Parameters - Control Page
Sourcetype - ⊞ -
- File Path
- Movie Spec COMP
On Source Change
Onsourcechange - ⊞ -
- Wait for Initialize or Start
- Initialize and Pause
- Initialize and Start
- Initialize and Use mvspec Play Parameter
Open Movie Parameters
Initialize Time (sec)
Go to Done
Go Back to Prev Mv
Parameters - Setup Page
Transition - ⊞ -
- Fade Down + Fade Up
- Freeze and Cut
Image Fade Down (sec)
Image Fade Up (sec)
Internal Audio Player
Audiodriver - ⊞ -
- default (DirectSound/CoreAudio)
Audiodevice - ⊞ -
- Speakers (4- RODE NT-USB)
- Line 1/2 (M-Audio Fast Track Ultra)
- Line 5/6 (M-Audio Fast Track Ultra)
- Speakers (Plugable USB Audio Device)
- Line 3/4 (M-Audio Fast Track Ultra)
- Speakers (2- USB Audio CODEC )
- S/PDIF (M-Audio Fast Track Ultra)
- Speakers (Realtek(R) Audio)
- U32J59x (2- NVIDIA High Definition Audio)
- M2767PW (2- NVIDIA High Definition Audio)
- Speakers (M-Audio Fast Track Ultra)
- Speakers (USB AUDIO CODEC)
Res - ⊞ -
Max Decode CPUs
Parameters - Go Page
Target Time for Go
Go to Time and Pause
Go to Time and Play
Target Cue for Go
Action for Go
Goaction - ⊞ -
- Cue Beauty
- Cue Start
- Cue End
Set Cur Cue on Go
Go to Cue and Pause
Go to Cue and Play
Parameters - UI Page
Timeunits - ⊞ -
- Time Code
View Range Start (sec)
View Range Length (sec)
Roller Wheel Zoom Image
Left/Mid Mouse Button Pan/Scale
Output Inspect Image
Parameters - Arrange Page
Viewerloc - ⊞ -
- Behind Controls
- Above Controls
Control Panel Always On
Control Panel Opacity
Expose Help Button
Cue Edit Area
Cueeditarea - ⊞ -
- Cue Box
- Cue Columns
- Cue List
Cue Edit Area Always On
Cue Edit Area Opacity
Size of Cuebar
Size of Cueloop
Size of Scrubber
Size of View Range
Size of Play Controls
Parameters - Select Page
Action on Select Node
Actionselecton - ⊞ -
- Go to Beauty
- Go to Start
- Go to End
Cue on Select
Set as Current Cue
Play on Select
Viewer Active on Select
Action on De-Select
Actionselectoff - ⊞ -
Parameters - External Page
External Control Active
Extunits - ⊞ -
Copy Cur mvspec Below
Save Cur mvspec to .tox
Create Engine COMP Below
- Output 0 -
- Output 1 -
- Output 2 -
- Output 3 -
- Output 4 -