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

jit.avc

Control a FireWire VTR

Description

Communicates with FireWire VTR devices, such as digital cameras and DV decks, using the 1394 AV/C protocol. Use it to control the transport of these devices with messages.

Examples

Attributes

Common Box Attributes

annotation [symbol]

Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.

background [int] (default: 0)

Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.

color [4 floats]

Sets the color for the object box outline.

fontface [int]

Sets the type style used by the object. The options are:

plain
bold
italic
bold italic

Possible values:

0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'

fontname [symbol]

Sets the object's font.

fontsize [float]

Sets the object's font size (in points).

Possible values:

'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'

hidden [int] (default: 0)

Toggles whether an object is hidden when the patcher is locked.

hint [symbol]

Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.

ignoreclick [int] (default: 0)

Toggles whether an object ignores mouse clicks in a locked patcher.

patching_rect [4 floats] (default: 0. 0. 100. 0.)

Sets the position and size of the object in the patcher window.

position [2 floats]

g/s(set)

Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.

presentation [int] (default: 0)

Sets whether an object belongs to the patcher's presentation.

presentation_rect [4 floats] (default: 0. 0. 0. 0.)

Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.

rect [4 floats]

g/s(set)

Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).

size [2 floats]

g/s(set)

Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.

textcolor [float]

Sets the color for the object's text in RGBA format.

textjustification [int]

Text Justification

Possible values:

0 = 'left'
1 = 'center'
2 = 'right'

varname [symbol]

Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.

Messages

close

Closes the AV/C connection. The connection is closed automatically if the object is deleted, or the patch containing the object is closed.

custom

Arguments

sequence [list]
Sends a custom string of data to the DV device. Messages are usually sent as a sequence of hexadecimal numbers. Accepted messages are documented by the 1394 Trade Association . The relevant specification is the "AV/C Tape Recorder/Player Subunit".

fastwind

Fast rewinds the transport.

ff

Fast forwards the transport.

getdevice

Sends the name of the currently active device out the right outlet of the object in the form device active-device .

gettime

Sends the name of the currently active device out the right outlet of the object in the form time DVdevicemedia-time .

gettransport

The gettransport message will report the precise state of the transport of the VTR device to which it is connected out the right outlet of the jit.avc object.

open

Opens an AV/C connection to a compatible device if one can be found.

pause

Pauses the transport playback.

play

Arguments

command [symbol]
Sets playback at normal speed. The following optional arguments are permitted:
pause: Pause in playback.
reverse: Playback at normal speed in reverse.
revpause: Pause in reverse playback.
nextframe: Playback the next sequential frame or field.
prevframe: Playback the previous sequential frame or field.
sf: Playback at the slowest forward special effect speed (sf = slowest, sf6 = slow, sf1 = fastest)
sf6: Playback at slow forward special effect speed
sf5: Playback at slow forward special effect speed
sf4: Playback at slow forward special effect speed
sf3: Playback at slow forward special effect speed
sf2: Playback at slow forward special effect speed
sf1: Playback at fastest slow forward special effect speed
sr: Playback at the slowest reverse special effect speed (sr = slowest, sr6 = slow, sr1 = fastest)
sr6: Playback at slow reverse special effect speed
sr5: Playback at slow reverse special effect speed
sr4: Playback at slow reverse special effect speed
sr3: Playback at slow reverse special effect speed
sr2: Playback at slow reverse special effect speed
sr1: Playback at fastest slow reverse special effect speed
ff: Playback at the fastest fast forward special effect speed (ff = fastest, ff6 = fast, ff1 = slowest)
ff6: Playback at fast forward special effect speed
ff5: Playback at fast forward special effect speed
ff4: Playback at fast forward special effect speed
ff3: Playback at fast forward special effect speed
ff2: Playback at fast forward special effect speed
ff1: Playback at slowest fast forward special effect speed
fr: Playback at the fastest fast reverse special effect speed. (fr = fastest, fr6 = fast, fr1 = slowest)
fr6: Playback at fast reverse special effect speed
fr5: Playback at fast reverse special effect speed
fr4: Playback at fast reverse special effect speed
fr3: Playback at fast reverse special effect speed
fr2: Playback at fast reverse special effect speed
fr1: Playback at slowest fast reverse special effect speed

record

Arguments

command [symbol]
Sets the DV device to record. The following optional arguments are permitted:
recpause: Pause while recording all signal(s)
insertvideo: Replace the video signal with a new signal, but leave any other signals on the medium intact
insertaudio: Replace the audio signal with a new signal, but leave any other signals on the medium intact
insertav: Replace the audio and video signals with new signals, but leave any other signals on the medium intact
insertsubcode: Replace the subcode signal with a new signal, but leave any other signals on the medium intact
insertvideopause: Pause recording signals, and set the recording mode record insertvideo
insertaudiopause: Pause recording signals, and set the recording mode record insertaudio
insertavpause: Pause recording signals, and establish the recording mode record insertav
insertsubcodepause: Pause recording signals, and set the recording mode record insertsubcode

recpause

Pauses while recording all signal(s).

rewind

Rewinds the transport.

stop

Halts the transport.

time

Causes the attached DV device to seek for the specified time on any loaded media. Time is specified by four integer arguments that specify hours, minutes, seconds and frames. Many devices do not support this function.

See Also

Name Description
Working with Video in Jitter Working with Video in Jitter
jit.qt.grab Digitize video from an external source
jit.qt.videoout Output video to QuickTime video output component
Tutorial 23: Controlling Your FireWire Camera Tutorial 23: Controlling Your FireWire Camera