A newer version of Max is available. Click here to access the latest version of this document.

jit.qt.movie

Play or edit a QuickTime movie

Description

The jit.qt.movie object provides a full suite of services for QuickTime movies: playback, editing, import, export, effect generation and direct-to-video-output-component streaming.

Matrix Operator

matrix inputs:0, matrix outputs:1
Name IOProc Planelink Typelink Dimlink Plane Dim Type
out n/a 1 1 1 4 1 char

Information for Jitter Matrix Operator (MOP) messages and attributes to this object

Messages

addbgtrack red [int]
green [int]
blue [int]
 		Adds a background color track. Three arguments in the range 0-255 specify the RGB components of the track.
addfxtrack filename [symbol]
offset [int]
duration [int]
src1-track-number [int]
src2-track-number [int]
 		Adds a QuickTime Effect track or track group. The filename refers to a qtfx file generated by jit.qt.effect. Using the symbol dialog in place of the filename argument opens a file dialog box, which lets you choose a file name. The message requires a time offset (expressed in QuickTime time values), a time duration (also expressed in QuickTime time values) and a reference to existing tracks in the current movie to use as sources. The precise number of source tracks used will vary depending on the specific QuickTime effect. At least 1 and up to 3 new tracks will be generated, with reserved names such ___effect_track, ___effect_src1, etc. If desired, any and all Effects tracks can be removed using the deletefxtrack message, or the deletetrack message can be used to remove individual tracks.
addtrack track-type [symbol]
 Adds a track and associated media of the type specified by the argument. Supported track types are video, sound, text, base, mpeg, music, timecode, sprite, flash, movie, tween, and 3d.
(drag) When a media file which can be read by QuickTime is dragged from the Max 5 File Browser to a jit.qt.movie object, the file will be loaded.
append src-name [symbol]
time-start [int]
time-end [int]

Appends a portion of movie or track media to the current movie or track. To specify the entire movie as the source (and target), omit the source argument. If the symbol dialog is used for the src-name argument, a File dialog box will be presented to choose a file. If the symbol scrap is used for the src-name argument, the jit.qt.movie object will attempt to read the source from the clipboard.

To specify a track, use track track-number in the source and destination fields, where track-number is a valid track number (e.g., append mayhem.mov track 3 0 10000 track 2 ). A target track value of -1 creates a new track. You can also specify an entire movie by using track 0 .

Time is specified as QuickTime time values.
asyncimport filename [symbol]
0/1 [int]
converted-filename [symbol]
 		Asynchronous version of the import message, performing the import operation, if possible, in a background thread.
asyncread src-name [symbol]

Asynchronously reads a movie from a disk file, if possible. If no argument is present, or if the symbol dialog is used for the src-name argument, a File dialog box 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- or clipboard-based movies; the normal read behavior will be used instead. Note: use of asyncread and preroll unloads any sections of the current movie loaded into RAM using the loadram method.
deletetrack track-number [int]
 Deletes the specified track number.
dispose Closes the currently loaded movie.
cancelframedump Stops the frame dump process. See framedump.
copy src-name [symbol]

Copies an entire movie or track to the current movie. To specify the entire movie as the source (and target), omit the source arguments. If the symbol dialog is used for the src-name argument, a File dialog box will be presented to choose a file. If the symbol scrap is used for the src-name argument, the jit.qt.movie object will attempt to read the source from the clipboard.

To specify a track, use track track-number in the source and target fields. A target track value of -1 creates a new track. You can also specify an entire movie by using track 0.
cut start-time [int]
end-time [int]
noshift [literal]

Deletes a selected portion of a track or movie. To specify the entire movie for the operation, omit the track arguments. To specify a track, use track track-number .

Specifying the noshift argument will replace the deleted portions of the file or track with empty time. Time is specified as QuickTime time values.

Time is specified in QuickTime time units.
deletebgtrack Deletes a previously created background color track.
flash_var variable path [symbol]
data [list]
 		Passes a value to the Flash ActionScript variable specified by the variable path argument to the method. This path should conform to the ActionScript path spec ( path/to.variable ) for the variable in question. At this time, only simple ActionScript variables are supported (no arrays).
frame frame-number [int]
 Jump to the frame number specified by the frame-number argument (fast method).
frame_true frame-number [int]
 Jump to the frame number specified by the frame-number argument (slower, more accurate method).
export filename [symbol]
file-type [symbol]
0/1 [int]
 		The export message permits you to save movies in non-native formats (including still image formats). Since the export formats you would use when specifying the file type will differ widely depending on the type of movie file you are using, You should use the getexporterlist list message to the jit.qt.movie object to create new exporter list for every movie you want to export. Using the symbol dialog in place of the filename argument opens a Save dialog, which lets you choose a file name. Using the symbol fulldialog in place of the filename argument will show you an exporter-specific Export dialog box before the movie is exported. The optional final argument of 1 will show you a configuration dialog box before the movie is exported.
exportaudio The exportaudio message causes the jit.qt.movie to perform a export of the current movie's audio for use with the spigot~ object.
exportfile filename [symbol]
file-type [symbol]
0/1 [int]

Synonym for export (see above). Required for access to functionality from interfaces in which the word export is reserved (JavaScript, Java)
exportimagesettings Opens the settings dialog box for image export. Any changes made are applied to subsequent exportimage operations.
exportsettings Opens the settings dialog box for the currently chosen exporter component. Any changes made are applied to subsequent export operations with the same exporter.
deletefxtrack Deletes a previously created QuickTime Effects track or track group. QuickTIme Effects tracks are identified using special reserved names such as ___effect_track or ___effect_src1. This message will delete any and all tracks having such reserved names.
flatten filename [symbol]
flags [list]
 		Creates a "flattened" movie that has no unresolved data references (i.e., the movie is self-contained). If a filename is not specified, the Save dialog will appear to let you choose a filename unless the inplace argument is present (see below). The flatten message can take a number of optional symbol arguments, which may appear in any order:
inplace = a new file will not be created. the movie will be flattened in place
compress = compress the movie resource
faststart = places the movie resource before the data in the file
activeonly = flatten and copy active tracks only
exportimage src-name [symbol]
file-type [symbol]
0/1 [int]
 		The exportimage message permits you to export the current frame as an image file. If no filename is specified, an optional final argument of 1 will open the File Settings dialog to let you choose a filename. Available file types are png, bmp, jpeg, macpaint, photoshop, pict, qtimage, sgi, tga and tiff. If no file type is specified, the file type specified for the last image export will be used. If no images have been exported, the png filetype will be used as the default.
You can use the Max Preferences to specify a default image resolution.
getexporterlist Sends a list of the available export components out the object's right outlet.
getflash_var variable path [symbol]
 Retrieves the value of the Flash ActionScript variable specified by the variable path argument to the method. This path should conform to the ActionScript path spec ( path/to.variable ) for the variable in question. At this time, only simple ActionScript variables are supported (no arrays).
getgmode src-name [symbol]
track-number [int]
 		Synonym for gettrackgmode.
gettrackclip src-name [symbol]
track-number [int]
 		Used to obtain the clipping region for a track. Sends the list trackclip track-number clip-left clip-top clip-right clip-bottom out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackcount src-name [symbol]
 Sends the number of tracks in a movie out the object's right outlet, preceded by the word trackcount. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box.
gettrackbass src-name [symbol]
track-number [int]
 		Sends the list trackbass track-number sound bass level out the object's right outlet. Values can be between -1. and 1. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackdim src-name [symbol]
track-number [int]
 		Sends the list trackdim track-number width height out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackenabled src-name [symbol]
track-number [int]
 		Sends the list trackenabled track-number enabled-status out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackduration src-name [symbol]
track-number [int]
 		Sends the list trackduration track-number duration out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackcodec src-name [symbol]
track-number [int]
 		Sends the list trackcodec track-number codec-number codec-name out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackgmode src-name [symbol]
track-number [int]
 		Sends the list trackgmode track-number graphic-mode red green blue out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackinfo src-name [symbol]
track-number [int]
 		Sends the list trackinfo track-number track-type enabled-status layer-number out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettracklayer src-name [symbol]
track-number [int]
 		Sends the list tracklayer track-number visibility-number-layer out the object's right outlet.
gettrackname src-name [symbol]
track-number [int]
 		Sends the list trackname track-number track-name out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackoffset src-name [symbol]
track-number [int]
 		Sends the list trackoffset track-number time-offset out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettracktimescale src-name [symbol]
track-number [int]
 		Sends the list tracktimescale track-number track-timescale out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettracktype src-name [symbol]
track-number [int]
 		Sends the list tracktype track-number mediatype out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettracktypecode src-name [symbol]
track-number [int]
 		Sends the list tracktypecode track-number track-typecode out the object's right outlet. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
getvoclist Sends a list of the available video output components out the object's right outlet.

WINDOWS USERS: this feature is currently unsupported.
getvocmodes Sends a list of the available video output component modes out the object's right outlet.

WINDOWS USERS: this feature is currently unsupported.
getvrframes Causes a list of the current VR node frame arrangement, in columns by rows, to be sent from the object's right outlet.

getvrnodelist Causes a list of available VR movie nodes to be sent from the object's right outlet.

gmode track-number [int]
mode [int]
red [int]
green [int]
blue [int]
 		Synonym for trackgmode.
framedump start-frame [int]
end-frame [int]
frame-skip [int]
 		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.
gettrackpan src-name [symbol]
track-number [int]
 		Sends the list trackpan track-number sound pan value out the object's right outlet. Values can be between -1. and 1. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettracktreble src-name [symbol]
track-number [int]
 		Sends the list tracktreble track-number sound treble level out the object's right outlet. Values can be between -1. and 1. An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
gettrackvol src-name [symbol]
track-number [int]
 		Sends the list trackvol track-number sound amplitude level out the object's right outlet. Values can be between -1. and 1. (values below 0. aren't audible). An optional src-name argument can be used to used to specify a source other than the current movie. Using the symbol dialog rather than specifying a source will open a File dialog box. If no track number is specified, separate line listings for each track are sent out the right outlet.
jump frame-offset [int]
 Jumps to a frame relative to the current location, as specified by the frame offset argument (fast method).
jump_true frame-offset [int]
 Jumps to a frame relative to the current location, as specified by the frame offset argument (slower, more accurate method).
insert src-name [symbol]
time-start [int]
time-end [int]
time-start [int]
time-end [int]

Inserts a portion of movie or track media into the current movie or track, shifting any existing data to make room. To specify the entire movie as the source (and target), omit the source argument. If the symbol dialog is used for the src-name argument, a File dialog box will be presented to choose a file. If the symbol scrap is used for the src-name argument, the jit.qt.movie object will attempt to read the source from the clipboard.

To specify a track, use track track-number in the source and destination fields, where track-number is a valid track number (e.g., insert mayhem.mov track 3 0 10000 track 2 0 10000 ). A target track value of -1 creates a new track. You can also specify an entire movie by using track 0 .

Time is specified as QuickTime time values.
import filename [symbol]
0/1 [int]
converted-filename [symbol]

Use import to access non-movie formats that QuickTime can read, such as CD tracks.

The filename and converted-filename arguments indicate filenames, or you can use the word dialog to force the use of dialog boxes. If you don't explicitly provide a filename for the converted file, the jit.qt.movie object will create a temporary file and destroy it when you unload or close the movie.

The 0/1 flag opens the appropriate import settings dialog for the type of file you are importing. Settings persist, so you should only have to set them up once, if you are importing a batch of similar files.
loadram track-number [int]
 Loads a specified movie or track into RAM. Without arguments, loadram loads the entire movie. To specify an entire track, use a valid track number as a single argument.
Two additional arguments may be used to specify start and end times for the loadram operation. So, loadram followed by 2 arguments will load a specified portion of an entire movie, while loadram followed by 3 arguments will cause the jit.qt.movie to load a portion of a single track into RAM.
keypress ASCII value [int]
key code [int]
modifiers [int]
 		Passes the description of keyboard activity to a Flash movie. The argument format is identical to that output from the key object in response to keypresses.
kill

Deletes the diskfile associated with the currently loaded movie.

This command does not offer a warning dialog, and cannot be undone.
newmovie width [int]
height [int]
timescale [int]
 		Creates a new empty movie of the specified width and height (default 320 240) and timescale (default 600) to fill as you desire.
mouse x [int]
y [int]
button-flag [int]
 		Passes the description of a mouse movement or click to a Flash movie. The argument format is identical to that output from the jit.window and jit.pwindow objects in response to mouse activity. The key modifiers flags are currently unused, although their presence has no adverse affects and simplifies patching.
mxform track-number [int]
a [float]
b [float]
u [float]
c [float]
d [float]
v [float]
tx [float]
ty [float]
w [float]
 		Sets up a movie or track geometrical matrix transformation using the same 3x3 matrix used with the jit.mxform2d object. The matrix transform can be used to perform scaling, rotation, skewing, and perspective operations on a movie or track using a list of 9 floating point values for the 3x3 transformation matrix. (default 1. 0. 0. 0. 1. 0. 0. 0. 1.) For more information on this transformation, see the jit.mxform2d object reference page.
opcolor track-number [int]
red [int]
green [int]
blue [int]
 		Synonym for trackopcolor.
paste src-name [symbol]
time-start [int]
time-end [int]
time-start [int]
time-end [int]

Pastes a portion of movie or track media into the current movie or track, overwriting any existing data. To specify the entire movie as the source (and target), omit the source argument. If the symbol dialog is used for the src-name argument, a File dialog box will be presented to choose a file. If the symbol scrap is used for the src-name argument, the jit.qt.movie object will attempt to read the source from the clipboard.

To specify a track, use track track-number in the source and destination fields, where track-number is a valid track number (e.g., paste mayhem.mov track 3 0 10000 track 2 0 10000 ). A target track value of -1 creates a new track. You can also specify an entire movie by using track 0 .

Time is specified as QuickTime time values.
prepend src-name [symbol]
time-start [int]
time-end [int]

Prepends a portion of movie or track media to the current movie or track. To specify the entire movie as the source (and target), omit the source argument. If the symbol dialog is used for the src-name argument, a File dialog box will be presented to choose a file. If the symbol scrap is used for the src-name argument, the jit.qt.movie object will attempt to read the source from the clipboard.

To specify a track, use track track-number in the source and destination fields, where track-number is a valid track number (e.g., append mayhem.mov track 3 0 10000 track 2 ). A target track value of -1 creates a new track. You can also specify an entire movie by using track 0 .

Time is specified as QuickTime time values.
start Starts movie playback at the current rate from the current QuickTime time value specified by time.
stop Stops movie playback (rate is unaffected).
read src-name [symbol]

Reads a movie from a disk file, URL or the clipboard. If no argument is present, or if the symbol dialog is used for the src-name argument, a File dialog box will be presented to choose a file. If the argument scrap is used for the src-name argument, the object will attempt to load a movie from the clipboard. If the argument is parsable as an http://, ftp:///, file://, or rtsp:// 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.
unloadram Unloads any previously loaded portions of the current movie from RAM. Portions of the movie may have been loaded into RAM through use of the loadram message, or through the asyncread and preroll messages, which preroll sections of the movie into RAM, as well.
tighten src-name [symbol]
 Removes empty time from a movie or a track media.
trackbass track-number [int]
bass-level [int]
 		Sets the track's bass equalization level. Valid input values are between -1. and 1.
trackdim track-number [int]
width [int]
height [int]
 		Sets a track's dimensions to the specified width and height.
trackclip track-number [int]
left [int]
top [int]
right [int]
bottom [int]
 		Sets the track's clipping region to the specified rectangle.
trackenabled track-number [int]
0/1 [int]
 		The trackenabled message followed by a track number and a 0 or 1 will disable or enable the specified track number.
trackduration track-number [int]
duration [int]
 		Sets a track's duration. The track will be scaled to the new duration. The duration is specified as QuickTime time values.
trackgmode track-number [int]
mode [int]
red [int]
green [int]
blue [int]
 		Sets a track's graphic mode. The arguments specify a track number, an integer which specifies the graphic mode, and three integers in the range 0-255 which specify the RGB value of the opcolor. Available graphic mode numbers are:
0 = srcCopy
1 = srcOr
2 = srcXor
3 = srcBic
4 = notSrcCopy
5 = notSrcOr
6 = notSrcXor
7 = notSrcBic
8 = patCopy
9 = patOr
10 = patXor
11 = patBic
12 = notPatCopy
13 = notPatOr
14 = notPatXor
15 = notPatBic
32 = blend
33 = addPin
34 = addOver
35 = subPin
36 = transparent
37 = addMax
38 = subOver
39 = adMin
49 = grayishTextOr
50 = highlighttransfermode
64 = ditherCopy
256 = graphicsModeStraightAlpha
257 = graphicsModePreWhiteAlpha
258 = graphicsModePreBlackAlpha
260 = graphicsModeStraightAlphaBlend
tracklayer track-number [int]
layer-number [int]
 		The track's visibility layer. Valid visibility layer values are integers between -32768 and 32767. Lower numbers are "on top".
trackname Sets the track's name.
trackoffset track-number [int]
offset-value [int]
 		The track's time offset. The offset is specified as QuickTime time values.
trackopcolor track-number [int]
red [int]
green [int]
blue [int]
 		Sets a track's opcolor, used by some QuickTime gmodes. The message arguments specify a track number and three integers in the range 0-255 specify the RGB value of the opcolor.
trackpan track-number [int]
pan [int]
 		The track's panning. Valid input values are between -1. (left channel only) and 1. (right channel only).
tracktimescale track-number [int]
timescale [int]
 		Adjusts a track's timescale (default timescale is media dependent).
tracktreble track-number [int]
treble-level [int]
 		The track's treble equalization level. Valid input values are between -1. and 1.
trackvol track-number [int]
volume [int]
 		The track's amplitude level. Valid input values are between -1. and 1. (values below 0 are inaudible).
trim track-number [int]
start [int]
end [int]
 		Retains a selected portion of movie or track between the time points (expressed as QuickTime time values) specified by the start and end arguments, and deletes the rest. Specifying the noshift argument will replace the deleted portions of the file or track with blank space, and using the scale argument will scale the remaining portion to the length of the original movie or track.
savemovie Saves the current movie to the currently referenced disk file (if any). If there is no currently referenced disk file (e.g. the movie was read from a URL or from the clipboard), this message operates as savemovieas.
savemovieas filename [symbol]
 Saves the current movie under a new filename, and changes the movie's file reference to the saved file. In the absence of a filename argument, or if dialog is specified in place of a filename, the object will present a standard File dialog box.
savemoviecopy filename [symbol]
 Saves the current movie under a new filename, but doesn't change the movie's file reference to the saved file (subsequent saves continue to reference whatever file (if any) was referred to previous to issuing the message). In the absence of a filename argument, or if dialog is specified in place of a file name, the object will present a standard File dialog box.
scale start [int]
end [int]
scaled-end [int]

Selects the portion of the current movie (or a track) between start and end and scales it to the range start to scaled end . To specify the entire movie for the operation, omit the track argument. To specify a track, use track track-number in the track number field, where track-number is a valid track number.

Time is specified as QuickTime time values.
undo Undoes the most recent editing operation.
toscrap time-start [int]
time-end [int]

Copies a movie or track (or portion thereof) to the clipboard. The message toscrap with no arguments copies the entire movie. The message toscrap track track-number copies a track to the clipboard. Additional optional arguments specify the start and end times of the movie to copy.

Time is specified as QuickTime time values.

Attributes

Name Type g/s Description
acodec symbol The audio codec, used by the export message.
adapt int Adapt output matrix dimensions to movie size flag (default = 0)
autosave int Autosave movie on close flag (default = 0)
autostart int Autoplay on movie open flag (default = 1)
codec symbol The visual codec, used by the export message.
codecquality symbol The visual codec quality, used by the export message.
colormode symbol The output matrix's color encoding (default = argb)
argb = ARGB (alpha, red, green, blue) colormode
uyvy = UYVY (YUV 4:2:2 packed) colormode
deinterlace int Deinterlace playback hint flag (default = movie-dependent)
When enabled, decompresses both fields of an interlaced movie at high quality, and then filters the image to reduce interlacing artifacts. Notes: Requires QuickTime version 6.5 or above, and the highquality attribute to be enabled. Playback hints are saved with the movie, if any of the jit.qt.movie object's save methods are used.
dstrect int 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.
duration int The movie's duration (default = movie-dependent)
When setting the duration, any value which is different from the current duration will scale the entire movie to the new length, unless the additional argument noscale is used. In that case, the movie length is changed without scaling. For more precise control of scaling, use the scale message.
editduration int The duration of the movie, in the same units specified by editmode.
editmode int Editing time-value mode (default = 0 (QuickTime time units))
Sets the expected time units for certain editing operations. At the time of this writing, the following operations support editmode: loadram, unloadram, insert, paste, trim, cut, scale, prepend, append, looppoints, loopstart and loopend. 0 = QuickTime time units (TimeScale-based)
1 = Milliseconds
2 = Frames
3 = True frames
edittime int The current time in the movie, in the same units specified by editmode.
exporter int The currently selected export component (referenced by position in the output list from getexporterlist)
fps float (get) The approximate calculation of the movie's internal FPS
framecount int (get) The number of frames in the movie
framereport int Frame reporting flag (default = 0)
When enabled, the message framecalc will be sent from the rightmost outlet of the jit.qt.movie object as each frame is processed, followed by the number of milliseconds spent doing so.
highquality int High quality playback hint flag (default = movie-dependent)
When enabled, the movie renders at the highest possible quality, at the expense of time and memory. Note: playback hints are saved with the movie, if any of the jit.qt.movie object's save methods are used.
id3album symbol album ID3 tag (for MP3 files)
id3artist symbol artist ID3 tag (for MP3 files)
id3comment symbol comment ID3 tag (for MP3 files)
id3date symbol date ID3 tag (for MP3 files)
id3encoder symbol encoder ID3 tag (for MP3 files)
id3name symbol track name ID3 tag (for MP3 files)
id3track symbol track number ID3 tag (for MP3 files)
id3url symbol url ID3 tag (for MP3 files)
interp int Output interpolation flag (default = 0)
loop int Looping mode (default = 1 (start to end))
0 = no looping
1 = normal looping (start to end)
2 = palindrome looping (start to end to start to ....)
3 = no looping, but use looppoints to define playback limits
loopend int The movie looppoint end
Time is specified as QuickTime time values.
looppoints int The movie looppoints
Time is specified as QuickTime time values.
loopreport int Loop notification flag (default = 0)
When enabled, the jit.qt.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.
loopstart int The movie looppoint start
Time is specified as QuickTime time values.
movie_dim int (get) Equivalent to moviedim
moviedim int (get) The movie's native dimensions
moviename symbol The movie's filename
moviepath symbol (get) The movie's fully-specified path on disk (if the movie has a disk-file)
movierate float (get) The movie's actual rate (reflecting start/stop/palindrome looping)
poster int The movie's poster frame
An optional int argument specifies the time to use. Time is specified as QuickTime time values. The default is to use the first frame.
preroll int Preroll movie on stop flag (default = 0)
When enabled, the jit.qt.movie object will attempt to asynchronously preroll the next section of the current movie for fast, non-interrupting restart.
Note: use of preroll and asyncread unloads any sections of the current movie loaded into RAM using the loadram method.
rate float The movie's rate (default = 1.)
singlefield int Single-field playback hint flag (default = movie-dependent)
When enabled, decompresses one field of an interlaced movie at high quality, and then scales the image to the frame size. Notes: Requires the highquality attribute to be enabled. Playback hints are saved with the movie, if any of the jit.qt.movie object's save methods are used.
soc symbol The name of the spigot~ object (if any) associated with the object.
srcrect int 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.
time int The current time in the movie. Time is specified as QuickTime time values.
timecode symbol (get) The movie's timecode
If the current movie has a Timecode track, sends the list timecode timecode-val . If the timecode is to be interpreted as a simple counter (see timecodeinfo, below), the list has a single timecode-val : the counter. If the timecode represents a timer value, the list has 4 elements, which represent hours , minutes , seconds , frames .
timecodeinfo symbol (get) The movie's timecode definition information
If the current movie has a Timecode track, sends the list timecodeinfo [ drop/nondrop ] [ counter/time ] [ fps1 ] [ fps2 ]. These represent:
drop/nondrop = whether timecode drops frames occasionally to stay in synchronization (possible values: drop, nondrop).
counter/timer = whether timecode should be interpreted as a simple counter, rather than as a time value (possible values: counter, timer).
fps1 = a frames-per-second calculation, based on the number of time units per second, divided by the standard duration of a frame, as provided by the timecode definition.
fps2 = frames-per-second, as provided by the timecode definition. If the timecode is to be interpreted as a counter (see counter/timer , above, this is the number of frames stored per timer "tick".
timecodevis int Timecode track visibility flag (default = 0)
When enabled, any Timecode tracks in the current movie are made visible (rendered in the frame).
timescale int (get) The timescale for the movie (default = 600, but movie-dependent)
unique int 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.qt.movie object will not respond to the bang.
use_movie_loop int Equivalent to usemovieloop
usedstrect int Destination rect flag (default = 0)
When the flag is set, the dstrect attributes are used when copying an input matrix to the internal matrix.
usemovieloop int Internal looping mode flag (default = 0 (use object's loop attribute))
0 = use the object's loop attribute to determine looping status, ignoring any internal looping information in the movie itself
1 = the movie's internal looping status overrides the object's loop attribute
usesrcrect int Source rect flag (default = 0)
When the flag is set, the srcrect attributes are used when copying an input matrix to the internal matrix.
voc int Video output component playback mode (default = -1)
-1 or no argument = video output component playback off
0 or above = video output component playback on (argument determines which component to use, using an index derived from its position in the list generated by the getvoclist message).

WINDOWS USERS: this feature is currently unsupported.
voc_sound_mode int VOC sound mode flag (default = 0)
When the flag is set, movie sound is not passed to the VOC, when in video output component playback mode (see the voc attribute for more information.)
vocmode int The video output component mode (e.g. for DV, this might be NTSC or PAL) (default = component-specific)

WINDOWS USERS: this feature is currently unsupported.
vol float The movie's sound volume (default = 1.)
vrcorrection int Current VR node imaging correction (warping) (default = movie-specific), only applies to panoramic nodes
0 = No warping
1 = 1-dimensional warping
2 = 2-dimensional warping
vrfov float Current VR movie field of view (default = movie-specific), fov is field of view. Valid ranges are typically in the range 8-145.
vrnode int The current VR node (default = movie-specific)
vrpan float The current VR movie pan (default = movie-specific)
vrquality int The current VR node quality (default = movie-specific), only applies to panoramic nodes
0 = Minimum quality
1 = Low quality
2 = Normal quality
3 = High quality
4 = Maximum quality
vrtilt float The current VR movie tilt (default = movie-specific)
window symbol Window name (default = none)
If this attribute is set, the jit.qt.movie object will render directly into the named jit.window object, thus able to use hardware decompression and interpolation as permitted by QuickTime. The window must have noaccel set to 1 in order for this to work.
If no symbol argument is given, the jit.qt.movie object's default behaviour of rendering to and outputting a matrix is used.

Information for box attributes common to all objects

Examples

See Also

Name Description
jit.dx.grab Digitize video from an external source using DirectX (Windows only)
jit.qt.effect QuickTime Effects for Jitter matrices
jit.qt.grab Digitize video from an external source
jit.qt.record Record a QuickTime movie
jit.qt.videoout Output video to QuickTime video output component
Tutorial 1: Playing a QuickTime Movie Tutorial 1: Playing a QuickTime Movie
Tutorial 4: Controlling Movie Playback Tutorial 4: Controlling Movie Playback
Tutorial 19: Recording QuickTime movies Tutorial 19: Recording QuickTime movies
Tutorial 24: QuickTime Effects Tutorial 24: QuickTime Effects
Tutorial 44: Flash Interactivity Tutorial 44: Flash Interactivity
Tutorial 49: Colorspaces Tutorial 49: Colorspaces
Appendix A: QuickTime Confidential Appendix A: QuickTime Confidential