Play a QuickTime movie Use the jit.movie for working with QuickTime movies. Cycling '74 Jitter bang, messages in TEXT_HERE bang, messages in TEXT_HERE out TEXT_HERE dumpout TEXT_HERE char Load a QuickTime-compatible media file Read a movie from a disk file asynchronously Asynchronously reads a movie from a disk file, if possible. If no argument is present a file selection dialog will be presented to choose a file. Any argument is assumed to be a local file name. At this time, asynchronous reading is not supported for URL-based movies Close the currently loaded movie Stop the frame dump process Stops the frame dump process. See framedump. Jump to a frame number (fast method) Jump to a frame number (fast method). See the above Discussion for information on using seeknotify with this message. Jump to a frame number (slower, more accurate method) Jump to a frame number (slower, more accurate method). See the above Discussion for information on using seeknotify with this message. Do a framedump Commences a framedump, in which the movie will start from a frame specified by start-frame (the default is 1) and automatically output frames in sequence (no bang or outputmatrix message is necessary) up to the frame specified by end-frame, skipping frame-skip frames between each frame. The default values are 1 for the start frame, and the total framecount of the movie for the end frame. The default frame-skip value is 1.
During operation, the message framedump current_frame is sent out the right outlet after each frame has been output. When finished, the message framedump done is output. Jump to a relative movie frame (fast method) Jump to a relative movie frame (fast method). See the above Discussion for information on using seeknotify with this message. Jump to a relative movie frame (slower, more accurate method) Jump to a relative movie frame (slower, more accurate method). See the above Discussion for information on using seeknotify with this message. Start movie playback Starts movie playback at the current rate from the current QuickTime time value specified by time. Stop movie playback Stops movie playback. rate is unaffected). Read a movie from a disk file/URL/clipboard Reads a movie from a disk file, URL or the clipboard. If no argument is present a file selection dialog will be presented to choose a file. If the argument is parseable as a URL, the object will attempt to load a movie from that location. Otherwise, an argument is assumed to be a local file name.
If autostart is enabled, the movie will begin playing at once. Adapt output matrix dimensions to movie size flag Enable automatic matrix output. Enable automatic matrix output when bound to jit.world. Autoplay on movie open flag Autoplay on movie open flag (default = 1) Output matrix's color encoding The output matrix's color encoding. ARGB (alpha, red, green, blue) colormode UYVY (YUV 4:2:2 packed) colormode Render context name A render context name, used when output_texture is enabled. The portion of the output matrix written to by the input frame The portion of the output matrix used for decompressing media to the internal matrix (default = 0 0 (matrix width) (matrix height))
The bounds of the rectangle are expressed in the form left top right bottom. All values are relative to the top-left corner of the viewing area of the output matrix. Movie duration The duration of the movie. Video engine backend. Video engine backend. This argument can only be set in the max box. If not specified, it is determined by the Video Engine Max preference. As of this writing, possible values include avf (Mac only), qt and viddll. Internal FPS for the movie Number of frames in the movie Frame reporting flag Frame reporting flag (default = 0). When enabled, the message framecalc will be sent from the rightmost outlet of the jit.movie object as each frame is processed, followed by the number of milliseconds spent doing so. Output interpolation flag Looping mode Looping mode (default = 1 (start to end)) 0 = no looping TEXT_HERE 1 = normal looping (start to end) TEXT_HERE 2 = palindrome looping (start to end to start to ....) TEXT_HERE 3 = no looping, but use looppoints to define playback limits TEXT_HERE Loop point end for movie The movie loop point end. Time is specified as QuickTime time values. Movie loop points The movie loop points. Time is specified as QuickTime time values. Loop notification flag Loop notification flag (default = 0). When enabled, the jit.movie object will send the message loopnotify when the playing movie passes the loop point. In palindrome looping mode, the message will be sent at both the beginning and the end of the movie. Movie loop point start The movie loop point start. Time is specified as QuickTime time values. Native movie dimensions Native movie dimensions Load a movie file from disk Load a movie file from disk Movie file name Identifies the file name of a movie (Note: setting this attribute does not load a movie file). Fully specified path on disk for the movie The movie's fully-specified path on disk, if the movie has a disk-file (Note: setting this attribute does not load a movie file). Enable OpenGL texture output Enable OpenGL texture output (default = 0). When enabled an OpenGL texture is output instead of a Jitter matrix. The object's drawto attribute must be set to a valid gl context. An RGBA texture is output using the movie's native dimensions. When enabled, the following attributes have no effect:
adapt
colormode
dim
dstrect
srcrect
usedstrect
usesrcrect Current normalized position Current playback position, normalized between 0. and 1. See the above Discussion for information on using seeknotify when setting this attribute. Movie rate Movie duration in seconds The movie duration in seconds. The portion of the input matrix used when copying an input matrix to the internal matrix The portion of the QuickTime movie to decompress into a matrix (default = 0 0 (movie width) (movie height)). The bounds of the rectangle are expressed in the form left top right bottom. All values are relative to the top-left corner of the viewing area of the movie. Output texture name Output texture name, when output_texture is enabled. Current time in the movie The current time in the movie. Time is specified as QuickTime time values. See the above Discussion for information on using seeknotify when setting this attribute. Current playback time in seconds Current playback time in seconds. See the above Discussion for information on using seeknotify when setting this attribute. Movie timescale The timescale for the movie (default = 600, but movie-dependent) Unique frame filter flag Unique frame filter flag (default = 0 (disabled)). When the flag is set, only new frames from the movie are output when the object receives a bang. If no new frame has been decompressed, the jit.movie object will not respond to the bang. Destination rect flag Destination rect flag (default = 0). When the flag is set, the dstrect attributes are used when copying an input matrix to the internal matrix. Source rect flag Source rect flag (default = 0). When the flag is set, the srcrect attributes are used when copying an input matrix to the internal matrix. Movie sound volume Video and Graphics 01: Display a Video Video and Graphics 09: Building Live Video Effects Video Engines GL Texture Output Appendix A: QuickTime Confidential This document refers to the avf engine version of jit.movie.
The avf backed jit.movie is asynchronous when seeking (e.g. setting the time attribute or using the frame or jump messages). This means that the frame output immediately following a seek request is not guaranteed to be correct. Users requiring exact frame timing must use the seeknotify message output from the object's dump outlet to trigger frame output.