<doc>
  <legacy_id>2360</legacy_id>
  <name>revInitializeVideoGrabber</name>
  <type>command</type>
  <syntax>
    <example>revInitializeVideoGrabber <i>parentStack</i>,<i>videoMethod</i>,<i>grabberRect</i></example>
  </syntax>
  <library>Video library</library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Windows &amp; Dialog Boxes</category>
    <category>Images &amp; Multimedia</category>
    <category>Standalone Applications</category>
  </classification>
  <references>
    <command tag="revStopPreviewingVideo">revStopPreviewingVideo Command</command>
    <command tag="revRecordVideo">revRecordVideo Command</command>
    <command tag="revCloseVideoGrabber">revCloseVideoGrabber Command</command>
    <command tag="revVideoGrabIdle">revVideoGrabIdle Command</command>
    <command tag="revSetVideoGrabberRect">revSetVideoGrabberRect Command</command>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <web/>
  </classes>
  <security>
    <disk access="???"/>
    <privacy/>
  </security>
  <summary>Opens the <glossary tag="video grabber">video grabber</glossary> window.</summary>
  <examples>
    <example>revInitializeVideoGrabber the short name of this stack, "QT","100,100,200,200"</example>
    <example>revInitializeVideoGrabber the short name of this stack, "VFW",the rect of this stack</example>
  </examples>
  <description>
    <p>Use the <b>revInitializeVideoGrabber</b> <glossary tag="command">command</glossary> to start up <glossary tag="video capture">video capture</glossary> capability.</p><p/><p><b>Parameters:</b></p><p>The <i>parentStack</i> is the short name of the stack that the video-grabber should attach itself to.</p><p/><p>The <i>videoMethod</i> is either "QT" or "VFW".</p><p/><p>The <i>grabberRect</i> is the rectangle of the <glossary tag="video grabber">video grabber window</glossary>, and consists of four <glossary tag="integer">integers</glossary> separated by commas: the left, top, right, and bottom edges of the <glossary tag="video grabber">video grabber</glossary>, in <href tag="glossary/Appearance/288.xml">absolute (screen) coordinates</href>.</p><p/><p><b>Comments:</b></p><p>You must use the <b>revInitializeVideoGrabber</b> <glossary tag="command">command</glossary> before using any of the other <glossary tag="command">commands</glossary> and <glossary tag="function">functions</glossary> in the <glossary tag="Video library">Video library</glossary>. The <glossary tag="command">command</glossary> does two things:</p><p/><p>* Loads the code necessary for video capture into memory.</p><p>* Opens the video grabber window.</p><p/><p><b>Note:</b> The <glossary tag="video grabber">video grabber</glossary> is not a <glossary tag="stack window">stack window</glossary>, so you can't set its <property tag="properties">properties</property>. To change the size and location of the <glossary tag="video grabber">video grabber</glossary>, use the <command tag="revSetVideoGrabberRect">revSetVideoGrabberRect</command> <glossary tag="command">command</glossary>.</p><p/><p>Once the video grabber is open, you can use the <b>revVideoGrabDialog</b> <glossary tag="command">command</glossary> to specify where the video camera (or other video source) is connected. Use the <command tag="revRecordVideo">revRecordVideo</command> <glossary tag="command">command</glossary> to record video from the camera to a <keyword tag="file">file</keyword>, or use the <command tag="revPreviewVideo">revPreviewVideo</command> command to display video without saving it.</p><p/><p>To use QuickTime for video capture (on Mac OS, OS X, or Windows systems), specify "QT" as the <i>videoMethod</i>. To use <glossary tag="VFW">Video for Windows</glossary> (on <glossary tag="Windows">Windows systems</glossary>), specify "VFW".</p><p/><p>To close the window and unload the video capture code, you should use the <b>revCloseVideoGrabber</b> <glossary tag="command">command</glossary> when you're done with <glossary tag="video capture">video capture</glossary>.</p><p/><p><img src="202653"/> <b>Important!</b> The <b>revInitializeVideoGrabber</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="LiveCode 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.</p>
  </description>
</doc>