<doc>
  <legacy_id>2268</legacy_id>
  <name>recordCompression</name>
  <type>property</type>
  <syntax>
    <example>set the recordCompression to <i>codecName</i></example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <function tag="recordCompressionTypes">recordCompressionTypes Function</function>
    <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 which <glossary tag="codec">codec</glossary> is used to <function tag="compress">compress</function> recorded sounds.</summary>
  <examples>
    <example>set the recordCompression to "MAC6"</example>
    <example>if the recordCompression is "raw " then requestAnotherType</example>
  </examples>
  <description>
    <p>Use the <b>recordCompression</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>recordCompression</b> is a four-character string.</p><p/><p>By default, the <b>recordCompression</b> <glossary tag="property">property</glossary> is "<code>raw </code>".</p><p/><p><b>Comments:</b></p><p>The <b>recordCompression</b> <glossary tag="property">property</glossary> determines what kind of <glossary tag="compress">compression</glossary> is used 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>Not all codecs are compatible with all supported sound file formats. If you try to record sound using a <b>recordCompression</b> that is not compatible with the file <function tag="format">format</function> specified by the <property tag="recordFormat">recordFormat</property> <glossary tag="property">property</glossary>, the <glossary tag="compress">compression</glossary> type will be changed automatically to a <glossary tag="codec">codec</glossary> that is compatible with the specified <property tag="recordFormat">recordFormat</property>.</p><p/><p>The <i>codecs</i> are installed by <glossary tag="QuickTime">QuickTime</glossary>. You can obtain a list of available <glossary tag="codec">codecs</glossary> using the <function tag="recordCompressionTypes">recordCompressionTypes</function> <control_st tag="function">function</control_st>. The <keyword tag="default">default</keyword> setting, "raw " (note the trailing space), indicates no <glossary tag="compress">compression</glossary> will be used.</p><p/><p><code/><b>Note:</b><code/> The <command tag="answer record">answer record</command> <glossary tag="command">command</glossary> sets the <b>recordCompression</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>
  </description>
</doc>