<doc>
	<legacy_id>2233</legacy_id>
	<name>revVideoGrabDialog</name>
	<type>command</type>

	<syntax>
		<example>revVideoGrabDialog [<i>settingsType</i>]</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Displays a dialog box for configuring <glossary tag="QuickTime">QuickTime</glossary> or <glossary tag="VFW">Video for Windows</glossary> <glossary tag="video capture">video capture</glossary>. </summary>

	<examples>
<example>revVideoGrabDialog</example>
<example>revVideoGrabDialog &quot;format&quot;</example>
<example><p>revVideoGrabDialog the label of button &quot;Dialog Type&quot;</p></example>
	</examples>

	<history>
		<introduced version="2.0">Added. </introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
	</platforms>

	<classes>
		<desktop/>
	</classes>

	<security>
		<disk/>
		<privacy/>
	</security>


	<classification>
		<category>Windows &amp; Dialog Boxes</category>
		<category>Images &amp; Multimedia</category>
		<category>Standalone Applications</category>
	</classification>

	<references>
		<command tag="revVideoGrabSettings">revVideoGrabSettings Command</command>
	</references>

	<description>
	<overview>Use the <b>revVideoGrabDialog</b> <glossary tag="command">command</glossary> to specify settings for use with the <glossary tag="video grabber">video grabber</glossary>. </overview>

	<parameters>
		<parameter>The <i>settingsType</i> is one of the following:<p>&#9;compression: Settings for compression when recording video</p><p>&#9;format: Video format, dimensions, and image depth</p><p>&#9;display: Appearance of previewed video in the video grabber</p><p>&#9;source: Video input channels and hue, contrast, and saturation settings</p><p>&#9;video: Pops up the QT video compression choice dialog for the videograbber</p><p>&#9;audio: Pops up the QT audio compression choice dialog for the videograbber</p><p></p><p><b>Note:</b> Some video camera drivers don't support some <i>settingsTypes</i>. </p></parameter>
	</parameters>

	<value></value>
	<comments>You must use the <b>revInitializeVideoGrabber</b> <glossary tag="command">command</glossary> to open the <glossary tag="video grabber">video grabber</glossary> before you can use the <b>revVideoGrabDialog</b> <glossary tag="command">command</glossary>. <p></p><p>If you specified &quot;QT&quot; as the video method when you executed the <b>revInitializeVideoGrabber</b> <glossary tag="command">command</glossary>, do not specify a <i>settingsType</i>. <glossary tag="QuickTime">QuickTime</glossary> video recording settings are found in a single <glossary tag="dialog box">dialog box</glossary>, which you display with the following <glossary tag="statement">statement</glossary>:</p><p></p><p>  revVideoGrabDialog</p><p></p><p>If you specified &quot;VFW&quot;, use the <i>settingsType</i> <glossary tag="parameter">parameter</glossary> to specify which <glossary tag="dialog box">dialog box</glossary> you want to show. </p><p></p><p><important> The <b>revVideoGrabDialog</b> <glossary tag="command">command</glossary> is part of the <glossary tag="Video library">Video library</glossary>. To ensure that the <glossary tag="command">command</glossary> works in a <glossary tag="standalone application">standalone application</glossary>, you must include this <glossary tag="Revolution custom library">custom library</glossary> when you create your <glossary tag="standalone application">standalone</glossary>. In the Inclusions section on the General screen of the <glossary tag="Standalone Application Settings">Standalone Application Settings</glossary> window, make sure that "Video Grabber" is selected from the list of script libraries. </important></p></comments>
	</description>
</doc>
