<doc>
  <legacy_id>2399</legacy_id>
  <name>recordFormat</name>
  <type>property</type>
  <syntax>
    <example>set the recordFormat to <i>fileFormat</i></example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <command tag="record sound">record sound Command</command>
    <command tag="play">play Command</command>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Specifies the file <function tag="format">format</function> for sound files recorded with the <command tag="record sound">record sound</command> <glossary tag="command">command</glossary>.</summary>
  <examples>
    <example>set the recordFormat to "wave"</example>
    <example>set the recordFormat to the storedSoundFormat of me</example>
  </examples>
  <description>
    <p>Use the <b>recordFormat</b> <glossary tag="property">property</glossary> to specify what kind of file to create when recording a sound, depending on how the file will be used.</p><p/><p><b>Value:</b></p><p>The <b>recordFormat</b> is one of the following:</p><p/><p>        aiff    records a file in AIFF format</p><p>     wave    records a file in WAV format</p><p>      ulaw    records a file in AU format</p><p>   movie    records a file in QuickTime format</p><p/><p>By default, the <b>recordFormat</b> <glossary tag="property">property</glossary> is "aiff".</p><p/><p><b>Comments:</b></p><p>The <b>recordFormat</b> <glossary tag="property">property</glossary> determines what kind of file is created when you use the <command tag="record sound">record sound</command> <glossary tag="command">command</glossary> to record sound.</p><p/><p>Not all sound file formats are compatible with all supported codecs. If you try to record sound using a <b>recordCompressionType</b> that is not compatible with the <b>recordFormat</b>, the <glossary tag="compress">compression</glossary> type will be changed automatically to a <glossary tag="codec">codec</glossary> that is compatible with the specified <b>recordFormat</b>.</p><p/><p><code/><img src="202653"/> <b>Important!</b><code/> If the <property tag="recordFormat">recordFormat</property> is set to "movie", the resulting <keyword tag="file">file</keyword> is in the <glossary tag="QuickTime">QuickTime</glossary> file format. <glossary tag="QuickTime">QuickTime</glossary> files cannot be played as <glossary tag="audio clip">audio clips</glossary>. To play such a sound, either create a <keyword tag="player">player</keyword> and set its <property tag="filename">filename</property> <glossary tag="property">property</glossary> to the <glossary tag="file path">path</glossary> of the <keyword tag="file">file</keyword> you recorded, or use the<code> play videoclip </code>form of the <b>play</b> <glossary tag="command">command</glossary>.</p>
  </description>
</doc>