<doc>
  <legacy_id>2502</legacy_id>
  <name>recordInput</name>
  <type>property</type>
  <syntax>
    <example>set the recordInput to <i>soundSource</i></example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <property tag="playDestination">playDestination Property</property>
    <command tag="record sound">record sound Command</command>
    <command tag="open driver">open driver Command</command>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Specifies where the <command tag="record sound">record sound</command> <glossary tag="command">command</glossary> should listen when recording a sound file.</summary>
  <examples>
    <example>set the recordInput to "imic" <i>-- internal microphone</i></example>
    <example>set the recordInput to "cd"</example>
    <example>if the recordInput is not in permittedDevices then exit mouseUp</example>
  </examples>
  <description>
    <p>Use the <b>recordInput</b> <glossary tag="property">property</glossary> to record sound from the system's microphone, a CD player, or other sources.</p><p/><p><b>Value:</b></p><p>The <b>recordInput</b> is a four-character <keyword tag="string">string</keyword>.</p><p/><p>The default value for the <b>recordInput</b> <glossary tag="property">property</glossary> is "dflt".</p><p/><p><b>Comments:</b></p><p>The <b>recordInput</b> <glossary tag="property">property</glossary> determines which input device is used as the sound source when you use the <command tag="record sound">record sound</command> <glossary tag="command">command</glossary> to record sound.</p><p/><p>The value "dflt" indicates that the <b>record sound</b> <glossary tag="command">command</glossary> should use the sound input device chosen in the user's system settings. If a different <i>soundSource</i> is specified, that input device is used instead.</p><p/><p>The possible <i>soundSources</i> vary, depending on the QuickTime version installed and on the system's hardware configuration. QuickTime 3.0 and later supports the following:</p><p>    imic - records from the internal microphone</p><p>    emic -records from the external sound input jack</p><p>    cd - records from an internal CD player</p><p>    irca - records from an RCA input jack</p><p>    tvfm - records from an FM radio tuner</p><p>    idav - records from a DAV analog input port</p><p>    mbay - records from a media-bay device</p><p>    modm - records from the modem</p><p>    zvpc - records from zoom video input</p><p>    none - does not record.</p>
  </description>
</doc>