<?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.grab" module="jit" category="Jitter Generators, Jitter QuickTime">
	<digest>
		Digitize video from an external source
	</digest>
	<description>
		Use the <o>jit.grab</o> object to digitize video from any video digitizer and decompress the signal into a Jitter matrix.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Jitter
		</metadata>
		<metadata name="tag">
			camera
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				bang, messages in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				bang, messages in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="matrix">
			<digest>
				out
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="matrix">
			<digest>
				dumpout
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--MOP-->
	<mop matrixinputcount="1" matrixoutputcount="1">
		<matrixoutput name="out" planelink="1" typelink="1" dimlink="1" minplanecount="1" maxplanecount="32" mindimcount="1" maxdimcount="32">
			<types>
				char
			</types>
		</matrixoutput>
	</mop>
	<!--MESSAGES-->
	<methodlist>
		<method name="close">
			<arglist />
			<digest>
				Close an open sequence grab component
			</digest>
			<description>
				Closes an open sequence grab component. The component is automatically closed when the object is freed.
			</description>
		</method>
		<method name="exportimage">
			<arglist>
				<arg name="filename" type="symbol" />
				<arg name="file-type" type="symbol" />
			</arglist>
			<digest>
				Export the current frame as an image file
			</digest>
			<description>
				Export the current frame as an image file with the name specified by the first argument. The second argument sets the file type (default = png). Available file types are <m>png</m>, <m>tiff</m>, and <m>jpeg</m>.				<br />
				You can use the Max Preferences to <link anchor="defaultimageresolution" module="core" name="interface_preferences" type="vignette">specify a default image resolution</link> for png image types.
			</description>
		</method>
		<method name="getformatlist">
			<arglist />
			<digest>
				Report the available digitizer formats
			</digest>
			<description>
				Reports the list of available digitizer formats from the object's right outlet, preceded by the word <m>formatlist</m>.
			</description>
		</method>
		<method name="getframeratelist">
			<arglist />
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</method>
		<method name="getinputlist">
			<arglist />
			<digest>
				Report all video digitizer inputs
			</digest>
			<description>
				Reports the list of available inputs to the video digitizer from the object's right outlet, preceded by the word <m>inputlist</m>. Note that the digitizer must be <m>open</m> in order for this method to function.
			</description>
		</method>
		<method name="getvdevlist">
			<arglist />
			<digest>
				Report all available video digitizers
			</digest>
			<description>
				Reports the list of available video digitizers from the object's right outlet, preceded by the word <m>vdevlist</m>.
			</description>
		</method>
		<method name="open">
			<arglist />
			<digest>
				Open a sequence grab component
			</digest>
			<description>
				Opens a sequence grab component. A component must be explicitly opened before the <o>jit.grab</o> object will began digitizing.
			</description>
		</method>
	</methodlist>
	<jittermethodlist>
		<jittermethod name="clear" />
		<jittermethod name="exportattrs" />
		<jittermethod name="importattrs" />
		<jittermethod name="outputmatrix" />
	</jittermethodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="adapt" get="1" set="1" type="int" size="1">
			<digest>
				Adapt output matrix dimensions to native device dimensions.
			</digest>
			<description>
				Adapt output matrix dimensions to native device dimensions. Enabled by default if no <at>dim</at> specified.
			</description>
			<attributelist>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Adapt" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="automatic" get="1" set="1" type="int" size="1">
			<digest>
				Enable automatic matrix output.
			</digest>
			<description>
				Enable automatic matrix output when bound to <o>jit.world</o>.
			</description>
			<attributelist>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Automatic" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="colormode" get="1" set="1" type="symbol" size="1">
			<digest>
				Color encoding for output matrix
			</digest>
			<description>
				The output matrix's color encoding (default = argb)
			</description>
			<attributelist>
				<attribute name="enumvals" get="1" set="1" type="atom" size="3">
					<enumlist>
						<enum name="monochrome">
							<digest>
								TEXT_HERE
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="argb">
							<digest>
								ARGB (alpha, red, green, blue) colormode
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
						<enum name="uyvy">
							<digest>
								UYVY (YUV 4:2:2 packed) colormode
							</digest>
							<description>
								TEXT_HERE
							</description>
						</enum>
					</enumlist>
				</attribute>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Colormode" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="enum" />
			</attributelist>
		</attribute>
		<attribute name="drawto" get="1" set="1" type="symbol" size="1">
			<digest>
				Render context name
			</digest>
			<description>
				A render context name, used when <at>output_texture</at> is enabled.
			</description>
			<attributelist>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Drawto" />
			</attributelist>
		</attribute>
		<attribute name="dstrect" get="1" set="1" type="int" size="4">
			<digest>
				The portion of the output matrix used for decompressing media to the internal matrix. (default = 0 0 (matrix width)
			</digest>
			<description>
				The portion of the output matrix used for decompressing media to the internal matrix. (default = 0 0 (matrix width) (matrix height))
				<br />
				The proportions of the rectangle are expressed in the form <i>left top right bottom</i>. All values are relative to the top left corner of the viewing area of the output matrix.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Dest Rect" />
			</attributelist>
		</attribute>
		<attribute name="engine" get="1" set="1" type="symbol" size="1">
			<digest>
				Video engine backend.
			</digest>
			<description>
				Video engine backend. This argument can only be set in the max box. If not specified, it is determined by the Video Engine Max preference. As of this writing, possible values include <ar>avf</ar> (Mac only), <ar>qt</ar>, and <ar>viddll</ar>.
			</description>
			<attributelist>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Engine" />
			</attributelist>
		</attribute>
		<attribute name="format" get="1" set="1" type="int" size="1">
			<digest>
				Video format selection
			</digest>
			<description>
				The video digitizer format selection (default = digitizer-specific). For a list of supported formats, send the message <m>getformatlist</m>.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Format" />
			</attributelist>
		</attribute>
		<attribute name="framerate" get="1" set="1" type="float" size="1">
			<digest>
				Video digitizer frame rate
			</digest>
			<description>
				The video digitizer frame rate (default = digitizer-specific).
				<br />
				The digitizer has to be closed and re-opened before changes to <at>framerate</at> take effect.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Frame Rate" />
			</attributelist>
		</attribute>
		<attribute name="framereport" get="1" set="1" type="int" size="1">
			<digest>
				Frame reporting flag
			</digest>
			<description>
				Frame reporting flag (default = 0)
				<br />
				When enabled, the message <m>framecalc</m> will be sent from the rightmost outlet of the <o>jit.grab</o> object as each frame is processed, followed by the number of milliseconds spent doing so.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Frame Report" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="input" get="1" set="1" type="int" size="1">
			<digest>
				Current video digitizer input
			</digest>
			<description>
				The current video digitizer input (default = digitizer-specific)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Input" />
			</attributelist>
		</attribute>
		<attribute name="interp" get="1" set="1" type="int" size="1">
			<digest>
				Image interpolation flag
			</digest>
			<description>
				Image interpolation flag (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Interp" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="output_texture" get="1" set="1" type="int" size="1">
			<digest>
				Enable OpenGL texture output
			</digest>
			<description>
				Enable OpenGL texture output (default = 0). When enabled an OpenGL texture is output instead of a Jitter matrix. The object's <at>drawto</at> attribute must be set to a valid gl context. An RGBA texture is output using the movie's native dimensions. When enabled, the following attributes have no effect:
				<br />
				<at>adapt</at>
				<br />
				<at>colormode</at>
				<br />
				<at>dim</at>
				<br />
				<at>dstrect</at>
				<br />
				<at>srcrect</at>
				<br />
				<at>usedstrect</at>
				<br />
				<at>usesrcrect</at> 
			</description>
			<attributelist>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Output Texture" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="srcrect" get="1" set="1" type="int" size="4">
			<digest>
				Source Rect
			</digest>
			<description>
				TEXT_HERE
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Source Rect" />
			</attributelist>
		</attribute>
		<attribute name="texture_name" get="1" set="1" type="symbol" size="1">
			<digest>
				Output texture name
			</digest>
			<description>
				Output texture name, when <at>output_texture</at> is enabled.
			</description>
			<attributelist>
				<attribute name="introduced" get="1" set="1" type="symbol" size="1" value="7.0.0" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Texture Name" />
			</attributelist>
		</attribute>
		<attribute name="unique" get="1" set="1" type="int" size="1">
			<digest>
				Unique frame filter flag
			</digest>
			<description>
				Unique frame filter flag (default = 0 (disabled))
				<br />
				When the flag is set, only new frames from the digitizer are output when the object receives a bang. If no new frame has been received from the digitizer, the <o>jit.grab</o> object will not respond to the bang.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Unique" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="usedstrect" get="1" set="1" type="int" size="1">
			<digest>
				Destination rect flag
			</digest>
			<description>
				Destination rect flag (default = 0) When the flag is set, the <at>dstrect</at> attributes are used when copying an input matrix to the internal matrix.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Use Dest Rect" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="usesrcrect" get="1" set="1" type="int" size="1">
			<digest>
				Source rect flag
			</digest>
			<description>
				Source rect flag (default = 0) When the flag is set, the <at>srcrect</at> attributes are used when copying an input matrix to the internal matrix.
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Use Source Rect" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="vdevice" get="1" set="1" type="int" size="1">
			<digest>
				Current video digitizer
			</digest>
			<description>
				The current video digitizer (default = 0)
			</description>
			<attributelist>
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Vdevice" />
			</attributelist>
		</attribute>
	</attributelist>
	<jitterattributelist>
		<jitterattribute name="outputmode" />
		<jitterattribute name="out_name" />
		<jitterattribute name="type" />
		<jitterattribute name="dim" />
		<jitterattribute name="planecount" />
	</jitterattributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="jit.grab.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso display="jit.movie" name="jit.avf.movie" />
		<seealso display="jit.record" name="jit.avf.record" />
		<seealso name="jit.qt.effect" />
		<seealso name="jit.dx.grab" />
		<seealso name="jit.dx.videoout" />
		<seealso name="jit.qt.videoout" />
		<seealso module="jit" name="jitterchapter21" type="tutorial" />
	</seealsolist>
	<discussion>
	</discussion>
</c74object>
