<doc>
  <legacy_id>2426</legacy_id>
  <name>recordRate</name>
  <type>property</type>
  <syntax>
    <example>set the recordRate to <i>kSamplesPerSecond</i></example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <property tag="recordSampleSize">recordSampleSize Property</property>
    <command tag="record sound">record sound Command</command>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Specifies how often the sound input should be read during sound recording.</summary>
  <examples>
    <example>set the recordRate to 48 <code><i>-- sample at 48 kHz</i></code></example>
  </examples>
  <description>
    <p>Use the <b>recordRate</b> <glossary tag="property">property</glossary> to trade off between sound quality and disk space when you record a sound.</p><p/><p><b>Value:</b></p><p>The <b>recordRate</b> is a non-negative number.</p><p/><p>By default, the <b>recordRate</b> <glossary tag="property">property</glossary> is 22.05.</p><p/><p><b>Comments:</b></p><p>The <b>recordRate</b> <glossary tag="property">property</glossary> determines the sound sampling rate when you use the <command tag="record sound">record sound</command> <glossary tag="command">command</glossary> to record sound to a file.</p><p/><p>The possible <b>recordRates</b> depend on the system's capabilities.</p><p/><p>The <i>kSamplesPerSecond</i> is the number of thousands of times per second the sound is sampled. The higher this number, the higher the quality of the resulting sound, and the larger the resulting <keyword tag="file">file</keyword>. For best sound quality, the higher <b>recordRates</b> should be used when the sound input is of high quality--for example, when recording from a CD--and when music is being recorded. (44.1 kHz is "CD-quality".) In general, you can use lower <b>recordRates</b> for spoken words than for music without compromising sound quality.</p><p/><p><code/><b>Note:</b><code/> The <command tag="answer record">answer record</command> <glossary tag="command">command</glossary> sets the <b>recordRate</b> <glossary tag="property">property</glossary> according to what the user chose in the <command tag="answer record">answer record</command> <glossary tag="dialog box">dialog box</glossary>.</p><p/>
  </description>
</doc>