<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="jit.avc" module="jit" category="Jitter Devices">
	<digest>
		Control a FireWire VTR
	</digest>
	<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.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
		<metadata name="tag">
			Jitter Devices
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				messages in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				messages in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--MESSAGES-->
	<methodlist>
		<method name="close">
			<arglist />
			<digest>
				Close the AV/C connection
			</digest>
			<description>
				Closes the AV/C connection. The connection is closed automatically if the object is deleted, or the patch containing the object is closed.
			</description>
		</method>
		<method name="custom">
			<arglist>
				<arg name="sequence" type="list" />
			</arglist>
			<digest>
				Send a custom string of data
			</digest>
			<description>
				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
				<a href="http://www.1394ta.com">
					1394 Trade Association
				</a>
				. The relevant specification is the &quot;AV/C Tape Recorder/Player Subunit&quot;.
			</description>
		</method>
		<method name="fastwind">
			<arglist />
			<digest>
				Fast rewind the transport
			</digest>
			<description>
				Fast rewinds the transport.
			</description>
		</method>
		<method name="ff">
			<arglist />
			<digest>
				Fast forward the transport
			</digest>
			<description>
				Fast forwards the transport.
			</description>
		</method>
		<method name="getdevice">
			<arglist />
			<digest>
				Report the device name
			</digest>
			<description>
				Sends the name of the currently active device out the right outlet of the object in the form <m>device</m>  <i>active-device</i>.
			</description>
		</method>
		<method name="gettime">
			<arglist />
			<digest>
				Report the device time
			</digest>
			<description>
				Sends the name of the currently active device out the right outlet of the object in the form <m>time</m>  <i>DVdevicemedia-time</i>.
			</description>
		</method>
		<method name="gettransport">
			<arglist />
			<digest>
				Report the device transport state
			</digest>
			<description>
				The <m>gettransport</m> message will report the precise state of the transport of the VTR device to which it is connected out the right outlet of the <o>jit.avc</o> object.
			</description>
		</method>
		<method name="open">
			<arglist />
			<digest>
				Open an AV/C connection
			</digest>
			<description>
				Opens an AV/C connection to a compatible device if one can be found.
			</description>
		</method>
		<method name="pause">
			<arglist />
			<digest>
				Pause the transport playback
			</digest>
			<description>
				Pauses the transport playback.
			</description>
		</method>
		<method name="play">
			<arglist>
				<arg name="command" type="symbol" />
			</arglist>
			<digest>
				Set playback with options
			</digest>
			<description>
				Sets playback at normal speed. The following optional arguments are permitted:
				<br />
				<m>pause</m>: Pause in playback.
				<br />
				<m>reverse</m>: Playback at normal speed in reverse.
				<br />
				<m>revpause</m>: Pause in reverse playback.
				<br />
				<m>nextframe</m>: Playback the next sequential frame or field.
				<br />
				<m>prevframe</m>: Playback the previous sequential frame or field.
				<br />
				<m>sf</m>: Playback at the slowest forward special effect speed (sf = slowest, sf6 = slow, sf1 = fastest)
				<br />
				<m>sf6</m>: Playback at slow forward special effect speed
				<br />
				<m>sf5</m>: Playback at slow forward special effect speed
				<br />
				<m>sf4</m>: Playback at slow forward special effect speed
				<br />
				<m>sf3</m>: Playback at slow forward special effect speed
				<br />
				<m>sf2</m>: Playback at slow forward special effect speed
				<br />
				<m>sf1</m>: Playback at fastest slow forward special effect speed
				<br />
				<m>sr</m>: Playback at the slowest reverse special effect speed (sr = slowest, sr6 = slow, sr1 = fastest)
				<br />
				<m>sr6</m>: Playback at slow reverse special effect speed
				<br />
				<m>sr5</m>: Playback at slow reverse special effect speed
				<br />
				<m>sr4</m>: Playback at slow reverse special effect speed
				<br />
				<m>sr3</m>: Playback at slow reverse special effect speed
				<br />
				<m>sr2</m>: Playback at slow reverse special effect speed
				<br />
				<m>sr1</m>: Playback at fastest slow reverse special effect speed
				<br />
				<m>ff</m>: Playback at the fastest fast forward special effect speed (ff = fastest, ff6 = fast, ff1 = slowest)
				<br />
				<m>ff6</m>: Playback at fast forward special effect speed
				<br />
				<m>ff5</m>: Playback at fast forward special effect speed
				<br />
				<m>ff4</m>: Playback at fast forward special effect speed
				<br />
				<m>ff3</m>: Playback at fast forward special effect speed
				<br />
				<m>ff2</m>: Playback at fast forward special effect speed
				<br />
				<m>ff1</m>: Playback at slowest fast forward special effect speed
				<br />
				<m>fr</m>: Playback at the fastest fast reverse special effect speed. (fr = fastest, fr6 = fast, fr1 = slowest)
				<br />
				<m>fr6</m>: Playback at fast reverse special effect speed
				<br />
				<m>fr5</m>: Playback at fast reverse special effect speed
				<br />
				<m>fr4</m>: Playback at fast reverse special effect speed
				<br />
				<m>fr3</m>: Playback at fast reverse special effect speed
				<br />
				<m>fr2</m>: Playback at fast reverse special effect speed
				<br />
				<m>fr1</m>: Playback at slowest fast reverse special effect speed
			</description>
		</method>
		<method name="record">
			<arglist>
				<arg name="command" type="symbol" />
			</arglist>
			<digest>
				Set the DV device to record
			</digest>
			<description>
				Sets the DV device to record. The following optional arguments are permitted:
				<br />
				<m>recpause</m>: Pause while recording all signal(s)
				<br />
				<m>insertvideo</m>: Replace the video signal with a new signal, but leave any other signals on the medium intact
				<br />
				<m>insertaudio</m>: Replace the audio signal with a new signal, but leave any other signals on the medium intact
				<br />
				<m>insertav</m>: Replace the audio and video signals with new signals, but leave any other signals on the medium intact
				<br />
				<m>insertsubcode</m>: Replace the subcode signal with a new signal, but leave any other signals on the medium intact
				<br />
				<m>insertvideopause</m>: Pause recording signals, and set the recording mode <m>record insertvideo</m> 				<br />
				<m>insertaudiopause</m>: Pause recording signals, and set the recording mode <m>record insertaudio</m> 				<br />
				<m>insertavpause</m>: Pause recording signals, and establish the recording mode <m>record insertav</m> 				<br />
				<m>insertsubcodepause</m>: Pause recording signals, and set the recording mode <m>record insertsubcode</m> 
			</description>
		</method>
		<method name="recpause">
			<arglist />
			<digest>
				Pause while recording
			</digest>
			<description>
				Pauses while recording all signal(s).
			</description>
		</method>
		<method name="rewind">
			<arglist />
			<digest>
				Rewind the transport
			</digest>
			<description>
				Rewinds the transport.
			</description>
		</method>
		<method name="stop">
			<arglist />
			<digest>
				Halt the transport
			</digest>
			<description>
				Halts the transport.
			</description>
		</method>
		<method name="time">
			<arglist />
			<digest>
				Seek to a specified time
			</digest>
			<description>
				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.
			</description>
		</method>
	</methodlist>
	<jittermethodlist>
		<jittermethod name="exportattrs" />
		<jittermethod name="exportsummary" />
		<jittermethod name="getattributes" />
		<jittermethod name="getstate" />
		<jittermethod name="importattrs" />
		<jittermethod name="summary" />
	</jittermethodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.avc.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="jit.qt.grab" />
		<seealso name="jit.qt.videoout" />
		<seealso name="jitterchapter23" module="jit" type="tutorial" />
	</seealsolist>
</c74object>
