~ubuntu-branches/ubuntu/trusty/csound-manual/trusty-proposed

<!--     <bridgehead>New in Version 5.XX ()</bridgehead> --><!--  <para>

<bridgehead>New in Version 5.13 (January 2011)</bridgehead>

  <para>

    <itemizedlist>

      <listitem>

        <para>New opcodes:

          <itemizedlist>

            <listitem>

              <simpara><link linkend="median"><citetitle>median</citetitle></link> opcode.</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="filevalid"><citetitle>filevalid</citetitle></link>  opcode.</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="pvstanal"><citetitle>pvstanal</citetitle></link>, <link linkend="pvswarp"><citetitle>pvswarp</citetitle></link>, <link linkend="temposcal"><citetitle>temposcal</citetitle></link>, <link linkend="pvslock"><citetitle>pvslock</citetitle></link> spectral processing opcodes.</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="mincer"><citetitle>mincer</citetitle></link> opcode</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="fareylen"><citetitle>fareylen</citetitle></link> sequence opcodes.</simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

      <listitem>

        <para>

          New functionality

          <itemizedlist>

            <listitem>

              <simpara>Real random number generators using /dev/random (Linux only).

              </simpara>

            </listitem>

            <listitem>

              <simpara>INF macro added to orchestras; z read as infinity in scores</simpara>

            </listitem>

            <listitem>

              <simpara>init changed to allow multiple inits in on statement</simpara>

            </listitem>

            <listitem>

              <simpara>GEN for support of farey sequences</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="maxalloc"><citetitle>maxalloc</citetitle></link>,<link linkend="cpuprc"><citetitle>cpuprc</citetitle></link>, <link linkend="active"><citetitle>active</citetitle></link> now accept named instruments.</simpara>

            </listitem>

            <listitem>

              <simpara>If normalisation in pow opcodes is zero treat as 1</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="inch"><citetitle>inch</citetitle></link> can take upto 20 inputs and outputs.</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="pvscale"><citetitle>pvscale</citetitle></link>, <link linkend="pvsvoc"><citetitle>pvsvoc</citetitle></link> and <link linkend="pvsmix"><citetitle>pvsmix</citetitle></link> now have very good spectral envelope preservation modes (1 = filtered cepstrum, 2 = true envelope).</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="oscil1"><citetitle>oscil1</citetitle></link> could be static if the duration was long; now there is a

   positive minimum increment.</simpara>

            </listitem>

            <listitem>

              <simpara>GEN49 now uses search paths.</simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

      <listitem>

        <para>Bug fixes and improvements:

          <itemizedlist>

            <listitem>

              <simpara>Count of lines fixed in orchestras, and \ inside strings

              </simpara>

            </listitem>

            <listitem>

              <simpara>Fast tab opcodes made safe from crashes</simpara>

            </listitem>

            <listitem>

              <simpara>% in formated printing could crash</simpara>

            </listitem>

            <listitem>

              <simpara>Double free in fgen fixed</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="sndwarp"><citetitle>sndwarp</citetitle></link> quietened (gave too many messages)</simpara>

            </listitem>

            <listitem>

              <simpara>gen41 deals with positive probabilities</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="adsynt"><citetitle>adsynt</citetitle></link> reworked removing many bugs</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="adsynt2"><citetitle>adsynt2</citetitle></link> phase error fixed</simpara>

            </listitem>

            <listitem>

              <simpara>Bug in max number of gens fixed</simpara>

            </listitem>

            <listitem>

              <simpara>Better checking in grain4</simpara>

            </listitem>

            <listitem>

              <simpara>Better checking in <link linkend="adsyn"><citetitle>adsyn</citetitle></link></simpara>

            </listitem>

            <listitem>

              <simpara>modulus was wrong in new parser</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="atonex"><citetitle>atonex</citetitle></link>/<link linkend="tonex"><citetitle>tonex</citetitle></link> did wrong operation</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="mp3in"><citetitle>mp3in</citetitle></link> could repeat sound at end of file</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="changed"><citetitle>changed</citetitle></link> opcode initialised to zero</simpara>

            </listitem>

            <listitem>

              <simpara>Serious bug in <link linkend="tabmorpha"><citetitle>tabmorpha</citetitle></link> fixed</simpara>

            </listitem>

            <listitem>

              <simpara>GEN49 has serious bug removed, so no longer incorrect silences.</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="partikkel"><citetitle>partikkel</citetitle></link> opcode: fixed bug in sub-sample grain placement when

       using grain rate FM</simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

      <listitem>

        <para>

          Internal Changes:

          <itemizedlist>

            <listitem>

              <simpara>

   In the new parser only there are operator @ and @@ to round up the

       next integer to a power of 2 or powerof2+1

              </simpara>

            </listitem>

            <listitem>

              <simpara>Score sorting made much faster</simpara>

            </listitem>

            <listitem>

              <simpara>lineto improved</simpara>

            </listitem>

            <listitem>

              <simpara>Named gens allowed</simpara>

            </listitem>

            <listitem>

              <simpara>Various printing include instrument name if available</simpara>

            </listitem>

            <listitem>

              <simpara>Command option to omit loading a library</simpara>

            </listitem>

            <listitem>

              <simpara>Number of out channels no longer constrained to be number of in</simpara>

            </listitem>

            <listitem>

              <simpara>Many fixes to new parser</simpara>

            </listitem>

            <listitem>

              <simpara>More use of Warnings than Messages (allows for them to be switched off)</simpara>

            </listitem>

            <listitem>

              <simpara>csoundSetMessageCallback reset if callback set to null</simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

    </itemizedlist>

  </para>

 <bridgehead>New in Version 5.12 (January 2010)</bridgehead>

 <para>

   <itemizedlist>

     <listitem>

       <para>New opcodes:

         <itemizedlist>

           <listitem>

             <simpara>

               <link linkend="transegr"><citetitle>transegr</citetitle></link>

               is a version of

               the <link linkend="transeg"><citetitle>transeg</citetitle></link>

               opcode which has a release section which is triggered

               by midi,

               a <link linkend="turnoff2"><citetitle>turnoff2</citetitle></link>

               opcode or a negative instrument

               number <link linkend="i"><citetitle>i score event</citetitle></link>.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="ftgenonce"><citetitle>ftgenonce</citetitle></link>

               generates a function table from within an instrument

               definition, without duplication of data.

             </simpara>

           </listitem>

           <listitem>

             <simpara><link linkend="passign"><citetitle>passign</citetitle></link>

             allows quick initialization of i-rate variables from p-fields</simpara>

           </listitem>

           <listitem>

             <simpara><link linkend="crossfm"><citetitle>crossfm</citetitle></link>

             implements crossed fm synthesis.</simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="loopxseg"><citetitle>loopxseg</citetitle></link>

               is

               like <link linkend="loopseg"><citetitle>loopseg</citetitle></link>

               but with exponential envelope.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="looptseg"><citetitle>looptseg</citetitle></link>

               is like <link linkend="loopseg"><citetitle>loopseg</citetitle></link>

               but with a flexible envelope like <link linkend="transeg"><citetitle>transeg</citetitle></link> 

             </simpara>

           </listitem>

         </itemizedlist>

       </para>

     </listitem>

     <listitem>

       <para>Bug fixes and improvements:

         <itemizedlist>

           <listitem>

             <simpara>    

               <link linkend="pvshift"><citetitle>pvshift</citetitle></link> would overwrite in double mode.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="pan2"><citetitle>pan2</citetitle></link> case 3 fixed.

             </simpara>

           </listitem>

  <!--           <listitem>-->

 <!--             <simpara> -->

<!--           <link linkend="gettempo"><citetitle>gettempo</citetitle></link> now works. -->

<!--              </simpara> -->

  <!--          </listitem> -->

           <listitem>

             <simpara>

               <link linkend="clockon"><citetitle>clockon</citetitle></link>

               and  <link linkend="clockoff"><citetitle>clockoff</citetitle></link>

               now work again.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="cross2"><citetitle>cross2</citetitle></link> and <link linkend="interp"><citetitle>interp</citetitle></link> could have divided by zero

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               linecount for error messages no longer includes text

               from <link linkend="CommandUnifileParFile"><citetitle>.csoundrc</citetitle></link>

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="p5gconnect"><citetitle>p5gconnect</citetitle></link>

               changed to use a separate thread to avoid timeout problem.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="transeg"><citetitle>transeg</citetitle></link> checks argument count.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               <link linkend="sfload"><citetitle>sfload</citetitle></link>

               used to be limited to 10 sound fonts and was not policed.

               Now open-ended.

             </simpara>

           </listitem>

         </itemizedlist>

       </para>

     </listitem>

     <listitem>

       <para>

         Internal Changes:

         <itemizedlist>

           <listitem>

             <simpara>

               \&quot; allowed as an escape in orchestral strings

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               New parser fixed on optional arguments

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               Better checking of <link linkend="f"><citetitle>f</citetitle></link> statement with negative number

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               Soundfonts only initialise pitches array once, in the

               soundfont opcodes.

             </simpara>

           </listitem>

           <listitem>

             <simpara>

               Usual collection of gratuitous minor changes, layout and comments

             </simpara>

           </listitem>

         </itemizedlist>

       </para>

     </listitem>

   </itemizedlist>

 </para>

  <bridgehead>New in Version 5.11 (June 2009)</bridgehead>

  <para>

    <itemizedlist>

      <listitem>

        <para>New opcodes:

          <itemizedlist>

            <listitem>

              <simpara><link linkend="mp3in"><citetitle>mp3in</citetitle></link>

              allows reading of mp3 files directly in the orchestra.</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="wiiconnect"><citetitle></citetitle>wiiconnect</link>, <link linkend="wiidata"><citetitle></citetitle>wiidata</link>, <link linkend="wiisend"><citetitle></citetitle>wiisend</link>, <link linkend="wiirange"><citetitle></citetitle>wiirange</link> opcodes by john ffitch to recieve and send data to a wiimote controller.</simpara>

            </listitem>

            <listitem>

              <simpara>New opcodes to receive data directly from a p5glove by john ffitch <link linkend="p5gdata"><citetitle>p5gdata</citetitle></link></simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="tabsum"><citetitle>tabsum</citetitle></link> sums sections of ftables</simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="MixerSetLevel_i"><citetitle>MixerSetLevel_i</citetitle></link> an init-time only version of <link linkend="MixerSetLevel"><citetitle>MixerSetLevel</citetitle></link></simpara>

            </listitem>

             <listitem>

              <simpara><link linkend="doppler"><citetitle>doppler</citetitle></link>

              implements a simulation of the doppler effect.</simpara>

            </listitem>

             <listitem>

              <simpara><link linkend="filebit"><citetitle>filebit</citetitle></link> reports the file depth of a file.</simpara>

            </listitem>

           <listitem>

             <simpara>

               The new <link linkend="SignalFlowGraphOpcodes"><citetitle>Signal

                   Flow opcodes </citetitle></link> enable the usage of

               signal flow graphs in Csound.

             </simpara>

           </listitem>

          </itemizedlist>

        </para>

      </listitem>

      <listitem>

        <para>

          New functionality

          <itemizedlist>

            <listitem>

              <simpara>

                New panning type for <link linkend="pan2"><citetitle></citetitle>pan2</link> opcode

              </simpara>

            </listitem>

            <listitem>

              <simpara>

                New csd score tag &lt;CsExScore&gt;.

              </simpara>

            </listitem>

            <listitem>

              <simpara>

                New -Ma option for ALSA RT MIDI module which listens to all devices.

              </simpara>

            </listitem>

            <listitem>

              <simpara>There is a gen49 to read mp3 files

              </simpara>

            </listitem>

            <listitem>

              <simpara>

                Added rounding bin code to <link linkend="pvscale"><citetitle>pvscale</citetitle></link>

              </simpara>

            </listitem>

            <listitem>

              <simpara>

              Added non-power-of-2 table support for <link linkend="ftload"><citetitle>ftload</citetitle></link> and <link linkend="ftsave"><citetitle>ftsave</citetitle></link>

              </simpara>

            </listitem>

            <listitem>

              <simpara>

              GEN23 totally rewritten to be more consistent in what constitutes

       a separator and comments. (Still no /* */ comments)

              </simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

      <listitem>

        <para>Bug fixes and improvements:

          <itemizedlist>

            <listitem>

              <simpara>

                New examples for pvs opcodes by Joachim Heintz: <link linkend="pvsarp"><citetitle></citetitle>pvsarp</link>, <link linkend="pvscent"><citetitle></citetitle>pvscent</link>, <link linkend="pvsbandp"><citetitle></citetitle>pvsbandp</link>, <link linkend="pvsbandr"><citetitle></citetitle>pvsbandr</link>, <link linkend="pvsbufread"><citetitle></citetitle>pvsbufread</link>,  <link linkend="pvsadsyn"><citetitle></citetitle>pvsadsyn</link>,  <link linkend="pvsynth"><citetitle></citetitle>pvsynth</link>,  <link linkend="pvsblur"><citetitle></citetitle>pvsblur</link>,  <link linkend="pvscale"><citetitle></citetitle>pvscale</link>,  <link linkend="pvscross"><citetitle></citetitle>pvscross</link>,  <link linkend="pvsfilter"><citetitle></citetitle>pvsfilter</link>,  <link linkend="pvsfreeze"><citetitle></citetitle>pvsfreeze</link>,  <link linkend="pvshift"><citetitle></citetitle>pvshift</link>,  <link linkend="pvsmaska"><citetitle></citetitle>pvsmaska</link>,  <link linkend="pvsmorph"><citetitle></citetitle>pvsmorph</link>

              </simpara>

            </listitem>

            <listitem>

              <simpara>Use of automatic numbering of ftables reuses table numbers

              </simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="seed"><citetitle></citetitle>seed</link> with positive argument was wrong

              </simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="sprintf"><citetitle></citetitle>sprintf</link> with an empty string printed wrong data

              </simpara>

            </listitem>

            <listitem>

              <simpara><link linkend="mute"><citetitle></citetitle>mute</link> now works with both numeric and named instruments

              </simpara>

            </listitem>

            <listitem>

              <simpara>Small fixes in <link linkend="diskin"><citetitle></citetitle>diskin</link>, and in <link linkend="tablexkt"><citetitle></citetitle>tablexkt</link>

              </simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

      <listitem>

        <para>

          Internal Changes:

          <itemizedlist>

            <listitem>

              <simpara>SConstruct now builds completely independent shared libraries

       for Python, Lua, and Java wrappers.

              </simpara>

            </listitem>

            <listitem>

              <simpara>New Parser almost usable

              </simpara>

            </listitem>

            <listitem>

              <simpara> Redrawing of graphs fixed so that only selected ones get redrawn.

              </simpara>

            </listitem>

            <listitem>

              <simpara>RT-alsa more forgiving on near sample rates

              </simpara>

            </listitem>

            <listitem>

              <simpara>It is possible to have the score generated by an external program

         rather than using standard score format using

         &lt;CScore bin="translater"&gt; to call the program translater on the

         score data

              </simpara>

            </listitem>

            <listitem>

              <simpara>lpc_export fixed

              </simpara>

            </listitem>

            <listitem>

              <simpara>Removed limit on macro names length

              </simpara>

            </listitem>

            <listitem>

              <simpara>PMAX, the number of arguments to a score event has been reduced

    by 2, and an overflow system introduced so GENs can have

    arbitrary numbers of arguments.

              </simpara>

            </listitem>

            <listitem>

              <simpara>Increased API version to 2.1.

              </simpara>

            </listitem>

            <listitem>

              <simpara>    New API function pointer ldmemfile2withCB() which is

       a version of ldmemfile() allowing a callback to be set and called

       exactly once to process the MEMFIL buffer after it is loaded.

              </simpara>

            </listitem>

            <listitem>

              <simpara>csound->floatsize set; zero in earlier versions

              </simpara>

            </listitem>

            <listitem>

              <simpara>GetChannelLock added

              </simpara>

            </listitem>

          </itemizedlist>

        </para>

      </listitem>

    </itemizedlist>

  </para>

              <simpara>New <link linkend="dcblock2"><citetitle>dcblock2</citetitle></link> opcode by &namevictor;.</simpara>

            <listitem><simpara>New Score control opcodes by &namevictor;: <link linkend="rewindscore"><citetitle>rewindscore</citetitle></link> and <link linkend="setscorepos"><citetitle>setscorepos</citetitle></link>.</simpara>

              <simpara>

              </simpara>

              <simpara>

              </simpara>