<doc>
  <legacy_id>1393</legacy_id>
  <name>revVideoGrabSettings</name>
  <type>command</type>
  <syntax>
    <example>revVideoGrabSettings <i>dataVariable</i></example>
  </syntax>
  <library>Video library</library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Images &amp; Multimedia</category>
    <category>Standalone Applications</category>
  </classification>
  <references>
    <command tag="revSetVideoGrabSettings">revSetVideoGrabSettings Command</command>
    <command tag="revVideoGrabDialog">revVideoGrabDialog Command</command>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
  </classes>
  <security>
    <disk access="???"/>
    <privacy/>
  </security>
  <summary>Puts the current <glossary tag="video capture">video capture</glossary> settings, stored as <glossary tag="binary data">binary data</glossary>, into a <glossary tag="variable">variable</glossary>.</summary>
  <examples>
    <example>revVideoGrabSettings "tSettings"</example>
    <example>set the savedVideoSettings of this card to tSettings</example>
    <example>put tSettings into URL "binfile:/Data/Video Settings.dat"</example>
  </examples>
  <description>
    <p>Use the <b>revVideoGrabSettings</b> command to store video-capture settings you specify in the video capture dialog box.</p><p/><p><b>Parameters:</b></p><p>The <i>dataVariable</i> is the name of an existing variable.</p><p/><p><b>Comments:</b></p><p>The <b>revVideoFrameImage</b> command returns binary data, placing it in the <i>dataVariable</i>.</p><p/><p>You specify settings for video capture in the video capture dialog box, which is displayed by the <b>revVideoGrabDialog</b> command. You can get the current settings with the <b>revVideoGrabSettings</b> command and restore them later with the revSetVideoGrabSettings command. This allows you to make changes to the video-capture settings under script control.</p><p/><p>The value returned by the <b>revVideoGrabSettings</b> command consists of binary data and is not human-readable, but you can store it in a file or custom property and restore your settings later using the revSetVideoGrabSettings command.</p><p/><p><b> Important!</b>  The <b>revVideoGrabSettings</b> command works only for QuickTime video capture. If you are capturing video with Video for Windows, the <b>revVideoGrabSettings</b> command does not return a meaningful value.</p><p/><p><b> Important! </b> The <b>revVideoGrabSettings</b> command is part of the Video library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions section on the General screen of the Standalone Application Settings window, make sure that "Video Grabber" is selected from the list of script libraries.</p>
  </description>
</doc>