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

jit.qt.record

Record a QuickTime movie

Description

The jit.qt.record object take a sequence of Jitter matrices as input, saving the sequence to disk as a QuickTime movie.

Matrix Operator

matrix inputs:1, matrix outputs:1
Name IOProc Planelink Typelink Dimlink Plane Dim Type
out n/a 1 1 1 1 1 char long float32 float64

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

Messages

stop Stop recording.
write movie-name [symbol]
FPS [float]
codec [symbol]
quality [symbol]
timescale [int]
Writes the sequence of incoming Jitter matrices to a disk file as a QuickTime movie. The default is to write a 30. fps raw codec max quality file with a timescale of 600.

The following list of codecs is deprecated (retained for reference). See codeclist for the preferred method to list valid system codecs. The available codec types are raw , cinepak , graphics , animation , video , componentvideo , jpeg , mjpega , mjpegb , sgi , planarrgb , macpaint , gif , photocd , qdgx , avrjpeg , opendmljpeg , bmp , winraw , vector , qd , h261 , h263 , dvntsc , dvpal , dvprontsc , dvpropal , flc , targa , png , tiff , componentvideosigned , componentvideounsigned , cmyk , microsoft , sorenson , indeo4 , argb64 , rgb48 , alphagrey32 , grey16 , mpegyuv420 , yuv420 , sorensonyuv9 and mpeg4 .

The available codec quality settings are lossless , max , min , low , normal , or high . Note that minimum quality is, in many cases, the codec's default quality. Use "low" quality for consistent results.

Attributes

Name Type g/s Description
codeclist symbol (get) The valid video codecs available on the system
Sending the message getcodeclist will cause a list of all valid codecs (that is, those with a functioning compressor component) to be reported from the dumpout. This list is guaranteed to contain only working codecs, and should be used in preference to the old, static codec list.
colormode symbol The input matrix's color encoding (default = argb)
argb = ARGB (alpha, red, green, blue) colormode
uyvy = UYVY (YUV 4:2:2 packed) colormode
datarate int The maximum data rate of compressed video written to disk (default = codec-dependent)
Note that not all codecs support data rate control (for instance, Photo-JPEG does not).
dstrect int The portion of the output matrix written to by the input frame (default = 0 0 (matrix width) (matrix height))
The proportions of the rectangle are expressed in the form left top right bottom . All values are relative to the top left corner of the object's viewing area.
flatten int Flatten flag (default = 0)
When the flag is set, recorded files are flattened. Additional optional arguments are available, and may appear in any order after the flag:
compress = compress the movie resource
faststart = places the movie resource before the data in the file
activeonly = flatten and copy active tracks only
frame int Frame number (default = -1 (disabled))
Typically, the jit.qt.record object passes input matrices directly to the outlet without any processing. Setting frame to a number greater than or equal to zero (0) during recording permits viewing of the compressed, previously recorded frame specified by the frame attribute's value, while the object continues to record new frames.
hint int Hint flag (default = 0)
When the flag is set, recorded files are saved as hinted movies.
interp int Interpolation flag (default = 0)
When the flag is set, the incoming matrix is interpolated when scaling to display.
kframe int Keyframe rate (default = 50)
If set, the jit.qt.record object will attempt to configure the compressor to use the specified keyframe rate, when data is written to disk. Keyframes (temporal compression) are not available to all codecs.
planemap int The plane mapping from input matrix to output movie (default = 0 1 2 3)
preview int Preview flag (default = 0 (off))
Typically, the jit.qt.record object passes input matrices directly to the outlet without any processing. Enabling preview during recording permits viewing of the compressed frames as they are recorded.
realtime int Realtime record flag (default = 0)
If set, the jit.qt.record object will write frames to disk exactly as they are received, without regard for the specified fps setting. Note that this may result in non-uniform movies. When disabled, the object uses the fps setting to ensure uniform temporal spacing between frames written to disk. In either mode, recording will not begin until a new frame is received.
srcrect int The portion of the input matrix used when copying an input matrix to the internal matrix. (default = 0 0 (matrix width) (matrix height)) The proportions 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 input matrix.
time int (get) The current duration, in QuickTime time units, of media written to disk (default = operation-specific)
The time attribute only returns data during write operations.
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.
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.

Information for box attributes common to all objects

Examples

See Also

Name Description
jit.qt.effect QuickTime Effects for Jitter matrices
jit.qt.grab Digitize video from an external source
jit.qt.movie Play or edit a QuickTime movie
jit.qt.videoout Output video to QuickTime video output component
jit.vcr Record a QuickTime movie with MSP audio
Tutorial 19: Recording QuickTime movies Tutorial 19: Recording QuickTime movies
Tutorial 21: Working With Live Video and Audio Input Tutorial 21: Working With Live Video and Audio Input