jit.qt.record

jit.qt.record

Record a QuickTime movie

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

Matrix Operator: in[1] out[1]

Name IOProc Planelink Typelink Dimlink Plane Dim Type

in n/a n/a n/a n/a n/a n/a n/a

out n/a yes yes yes all all char long float32 float64

Attributes:

Name Type Description

dstrect int list[4] 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

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 list[4] The plane mapping from input matrix to output movie (default = 0 1 2 3)

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 list[4] 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 (get) int 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.

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 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.

Example:

Name	IOProc	Planelink	Typelink	Dimlink	Plane	Dim	Type
in	n/a	n/a	n/a	n/a	n/a	n/a	n/a
out	n/a	yes	yes	yes	all	all	char long float32 float64

Name	Type	Description
dstrect	int list[4]	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
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 list[4]	The plane mapping from input matrix to output movie (default = 0 1 2 3)
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 list[4]	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 (get)	int	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.