ampdbfs.xml


<refentry id="ampdbfs">
<indexterm id="IndexAmpdbfs"><primary>ampdbfs</primary></indexterm>
  <refentryinfo><title>Mathematical Operations:Amplitude Functions</title></refentryinfo>
  <refmeta>
    <refentrytitle>ampdbfs</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>ampdbfs</refname>
    <refpurpose>
       Returns the amplitude equivalent (in 16-bit signed integer scale) of the full scale decibel (dB FS) value <emphasis>x</emphasis>.
    </refpurpose>
  </refnamediv>

  <refsect1>
    <title>Description</title>
    <para>
      Returns the amplitude equivalent of the full scale decibel (dB FS) value <emphasis>x</emphasis>. The logarithmic full scale decibel values will be converted to linear 16-bit signed integer values from −32,768 to +32,767.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>ampdbfs</command>(x)  (no rate restriction)</synopsis>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the ampdbfs opcode. It uses the file <ulink url="examples/ampdbfs.csd"><citetitle>ampdbfs.csd</citetitle></ulink>.

      <example>
        <title>Example of the ampdbfs opcode.</title>

        <para>See the sections <link linkend="UsingRealTime"><citetitle>Real-time Audio</citetitle></link> and <link linkend="CommandFlags"><citetitle>Command Line Flags</citetitle></link> for more information on using command line flags.</para>
          <xi:include href="examples-xml/ampdbfs.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
      </example>

      Its output should include lines like:
      <screen>
     instr 1:  iamp = 29204.511
     instr 1:  iamp = 18426.801
     instr 1:  iamp = 16422.904
     instr 1:  iamp = 3276.800</screen>
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="ampdb"><citetitle>ampdb</citetitle></link>,
      <link linkend="dbamp"><citetitle>dbamp</citetitle></link>,
      <link linkend="dbfsamp"><citetitle>dbfsamp</citetitle></link>,
      <link linkend="Zerodbfs"><citetitle>0dbfs</citetitle></link>
    </para>
<para>New in Csound version 4.10</para>
  </refsect1>

</refentry>