Skip to content

Commit

Permalink
deploy: df9ad5c
Browse files Browse the repository at this point in the history
  • Loading branch information
@tjingboem
tjingboem committed May 23, 2024
1 parent 585b358 commit 5ee55f3
Show file tree
Hide file tree
Showing 522 changed files with 3,992 additions and 3,986 deletions.
16 changes: 8 additions & 8 deletions C.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,39 +39,39 @@ <h2>
</p>
</div>
<div class="refsect1">
<a id="idm399000"></a>
<a id="idm399012"></a>
<h2>Description</h2>
<p>
This statement switches automatic carrying of missing arguments on or off.
</p>
</div>
<div class="refsect1">
<a id="idm399003"></a>
<a id="idm399015"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>C</strong></span> p1</pre>
</div>
<div class="refsect1">
<a id="idm399007"></a>
<a id="idm399019"></a>
<h2>Performance</h2>
<p>
<span class="emphasis"><em>p1</em></span> -- Specifies whether to switch off (value
0) or on (non-zero).
</p>
</div>
<div class="refsect1">
<a id="idm399011"></a>
<a id="idm399023"></a>
<h2>Examples</h2>
<p>
Here is an example of the C statement. It uses the file <a class="ulink" href="examples/b.csd" target="_top"><em class="citetitle">C.csd</em></a>.
</p>
<div class="example">
<a id="idm399016"></a>
<a id="idm399028"></a>
<p class="title">
<strong>Example 1274. Example of the C statement.</strong>
</p>
<div class="example-contents">
<div class="refsect1">
<a id="idm399018"></a>
<a id="idm399030"></a>
<pre class="programlisting">
<span class="nt">&lt;CsoundSynthesizer&gt;</span>

Expand Down Expand Up @@ -115,14 +115,14 @@ <h2>Examples</h2>
</p>
</div>
<div class="refsect1">
<a id="idm399132"></a>
<a id="idm399144"></a>
<h2>See Also</h2>
<p>
<a class="link" href="ScoreStatements.html" title="Score Statements"><em class="citetitle">Score Statements</em></a>
</p>
</div>
<div class="refsect1">
<a id="idm399137"></a>
<a id="idm399149"></a>
<h2>Credits</h2>
<p>
</p>
Expand Down
10 changes: 5 additions & 5 deletions CsBeats.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ <h2 class="title"><a id="CsBeats"></a>Csbeats</h2>
standard output.
</p>
<div class="refsect1">
<a id="idm440469"></a>
<a id="idm440481"></a>
<p>
The <span class="emphasis"><em>csbeats</em></span> language is very simple, having
only 5 kinds of statement, and only one of them has any
Expand Down Expand Up @@ -154,7 +154,7 @@ <h2 class="title"><a id="CsBeats"></a>Csbeats</h2>
</div>
</div>
<div class="refsect1">
<a id="idm440522"></a>
<a id="idm440534"></a>
<p>
The opening of Bach's Goldberg variation number 3 can be coded
as:
Expand Down Expand Up @@ -271,21 +271,21 @@ <h2 class="title"><a id="CsBeats"></a>Csbeats</h2>
</p>
</div>
<div class="refsect1">
<a id="idm440572"></a>
<a id="idm440584"></a>
<h2>A Complete Example</h2>
<p>
Here is a simple example of the <span class="emphasis"><em>csbeats</em></span>
score generator. It uses the file <a class="ulink" href="examples/csbeats.csd" target="_top"><em class="citetitle">csbeats.csd</em></a>.
</p>
<div class="example">
<a id="idm440578"></a>
<a id="idm440590"></a>
<p class="title">
<strong>Example 1375. A simple example of csbeats.</strong>
</p>
<div class="example-contents">
<p>See the sections <a class="link" href="UsingRealTime.html" title="Real-Time Audio"><em class="citetitle">Real-time Audio</em></a> and <a class="link" href="CommandFlags.html" title="Csound command line"><em class="citetitle">Command Line Flags</em></a> for more information on using command line flags.</p>
<div class="refsect1">
<a id="idm440585"></a>
<a id="idm440597"></a>
<pre class="programlisting">
<span class="nt">&lt;CsoundSynthesizer&gt;</span>
<span class="nt">&lt;CsOptions&gt;</span>
Expand Down
12 changes: 6 additions & 6 deletions CscoreCompile.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ <h2 class="title" style="clear: both"><a id="CscoreCompile"></a>Compiling a Csco
<p>
So, to create a standalone program, write a control program as shown in the previous section. Let's assume that you saved this program in a file named <span class="quote">“<span class="quote"><span class="emphasis"><em>mycscore.c</em></span></span>”</span>. Next, you need to compile and link this program with the Csound library and <span class="emphasis"><em>cscoremain.c</em></span> in order to create an exectuable by following the set of directions below that apply to your operating system. It will be helpful to already have some familiarity with the C compiler on your computer since the information below cannot be complete for all possible systems.
</p>
<h3><a id="idm440344"></a>Linux and Unix</h3>
<h3><a id="idm440356"></a>Linux and Unix</h3>
<p>
The following commands assume that you have copied your file <span class="emphasis"><em>mycscore.c</em></span> into the same directory as <span class="emphasis"><em>cscoremain.c</em></span>, that you have opened a terminal to that same directory, and that you have previously installed a binary distribution of Csound that placed a library <span class="emphasis"><em>libcsound.a</em></span> or <span class="emphasis"><em>libcsound.so</em></span> into <span class="emphasis"><em>/usr/local/lib</em></span> and the header files for the Csound API into <span class="emphasis"><em>/usr/local/include/csound</em></span>.
</p>
Expand All @@ -80,14 +80,14 @@ <h3><a id="idm440344"></a>Linux and Unix</h3>
<p>
It is possible that on some Unix systems, the C compiler will be named <span class="emphasis"><em>cc</em></span> or something else other than <span class="emphasis"><em>gcc</em></span>.
</p>
<h3><a id="idm440361"></a>Windows</h3>
<h3><a id="idm440373"></a>Windows</h3>
<p>
Csound is usually compiled on Windows using the MinGW environment that makes GCC -- the same compiler used on Linux -- available using a Unix-like command shell (MSYS). Since pre-compiled libraries for Csound on Windows are built in this way, you may need to use MinGW as well to link to them. If you have built Csound using another compiler, then you should be able to build <span class="emphasis"><em>Cscore</em></span> with that compiler as well.
</p>
<p>
Compiling standalone <span class="emphasis"><em>Cscore</em></span> programs using MinGW should be similar to the procedure for Linux above with library and header paths changed appropriately for where Csound is installed on the Windows system. <span class="emphasis"><em>(Please feel free to contribute more detailed instructions here as the editor has been unable to test Cscore on a Windows machine).</em></span>
</p>
<h3><a id="idm440367"></a>OS X</h3>
<h3><a id="idm440379"></a>OS X</h3>
<p>
The following commands assume that you have copied your file <span class="emphasis"><em>mycscore.c</em></span> into the same directory as <span class="emphasis"><em>cscoremain.c</em></span> and that you have opened a terminal to that same directory. In addition, the Apple-supplied developer tools (including the GCC compiler) should be installed on your system and you should have previously installed a binary distribution of Csound that placed the CsoundLib framework into <span class="emphasis"><em>/Library/Frameworks</em></span>.
</p>
Expand All @@ -104,7 +104,7 @@ <h3><a id="idm440367"></a>OS X</h3>
<div class="informalexample">
<pre class="screen">./cscore test.sco</pre>
</div>
<h3><a id="idm440378"></a>MacOS 9</h3>
<h3><a id="idm440390"></a>MacOS 9</h3>
<p>
You will need CodeWarrior or some other development environment installed on your computer (MPW may work). Download the source code distribution for OS 9 (it will have a name like <span class="emphasis"><em>Csound5.05_OS9_src.smi.bin</em></span>).
</p>
Expand All @@ -114,7 +114,7 @@ <h3><a id="idm440378"></a>MacOS 9</h3>
<p>
Once you have the proper files included in the project window, click the "Make" button and CodeWarrior should produce an application named <span class="quote">“<span class="quote"><span class="emphasis"><em>Cscore</em></span></span>”</span>. When you run this application, it first displays a window allowing you to type in the arguments to the main function. You only need to type in the filename or pathname to the input score -- do not type in "cscore". The input file should be in the same folder as the application or else you will need to type a full or relative pathname to the file. Output will be displayed in the console window. You can use the <span class="emphasis"><em>Save</em></span> command from the <span class="emphasis"><em>File</em></span> menu before quitting if you wish. Alternatively, in the commandline dialog, you can choose to redirect the output to a file by clicking on the <span class="emphasis"><em>File</em></span> button on the right side of the dialog. (Note that the console window can only display about 32,000 characters, so writing to a file is necessary for long scores).
</p>
<h3><a id="idm440393"></a>Making Cscore usable from within Csound</h3>
<h3><a id="idm440405"></a>Making Cscore usable from within Csound</h3>
<p>
To operate from Csound, first follow the instructions for compiling Csound (see <a class="link" href="BuildingCsound.html" title="Building Csound"><em class="citetitle">Building Csound</em></a>) according to the operating system that you are using. Once you have successfully built an unmodified Csound system, then substitute your own <span class="emphasis"><em>cscore()</em></span> function for the one in the file <span class="emphasis"><em>Top/cscore_internal.c</em></span>, and rebuild Csound.
</p>
Expand All @@ -127,7 +127,7 @@ <h3><a id="idm440393"></a>Making Cscore usable from within Csound</h3>
<p>
A simple approach to using a <span class="emphasis"><em>Cscore</em></span> callback via the API would be to modify the standard Csound main program -- which is a simple Csound host -- contained in the file <span class="emphasis"><em>frontends/csound/csound_main.c</em></span>. Adding a call to <span class="emphasis"><em>csoundSetCscoreCallback()</em></span> after the call to <span class="emphasis"><em>csoundCreate()</em></span> but before the call to <span class="emphasis"><em>csoundCompile()</em></span> should do the job. Recompiling this file and linking to an existing Csound library will make a commandline version of Csound that works similarly to the one described above. Don't forget to use the -C flag.
</p>
<h3><a id="idm440417"></a>Notes about score formats and run-time behavior</h3>
<h3><a id="idm440429"></a>Notes about score formats and run-time behavior</h3>
<p>
As stated previously, the input files to <span class="emphasis"><em>Cscore</em></span> may be in original or time-warped and pre-sorted form; this modality will be preserved (section by section) in reading, processing, and writing scores. Standalone processing will most often use unwarped sources and create unwarped new files. When running from within Csound, the input score will arrive already warped and sorted, and can thus be sent directly (normally section by section) to the orchestra. One advantage of this method of using <span class="emphasis"><em>Cscore</em></span> is that all of the syntactical conveniences of the full Csound score language may be used -- macros, arithmetic expressions, carry, ramp, etc. -- since the score will go through the "Carry, Tempo, Sort" phases of score processing before being passed to the user-supplied <span class="emphasis"><em>Cscore</em></span> program.
</p>
Expand Down
14 changes: 7 additions & 7 deletions GEN01.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,19 +39,19 @@ <h2>
</p>
</div>
<div class="refsect1">
<a id="idm402788"></a>
<a id="idm402800"></a>
<h2>Description</h2>
<p>
This subroutine transfers data from a soundfile into a function table.
</p>
</div>
<div class="refsect1">
<a id="idm402791"></a>
<a id="idm402803"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>f</strong></span># time size 1 filcod skiptime format channel</pre>
</div>
<div class="refsect1">
<a id="idm402795"></a>
<a id="idm402807"></a>
<h2>Performance</h2>
<p>
<span class="emphasis"><em>size</em></span> -- number of points in the table. Ordinarily a power of 2 or a power-of-2 plus 1 (see <a class="link" href="f.html" title="f Statement (or Function Table Statement)"><em class="citetitle">f statement</em></a>); the maximum tablesize is 16777216 (2<sup>24</sup>) points. The allocation of table memory can be <span class="emphasis"><em>deferred</em></span> by setting this parameter to 0; the size allocated is then the number of points in the file (probably not a power-of-2), and the table is not usable by normal oscillators, but it is usable by a <a class="link" href="loscil.html" title="loscil"><em class="citetitle">loscil</em></a> unit. The soundfile can also be mono or stereo.
Expand Down Expand Up @@ -141,19 +141,19 @@ <h2>Performance</h2>
</div>
</div>
<div class="refsect1">
<a id="idm402841"></a>
<a id="idm402853"></a>
<h2>Examples</h2>
<p>
Here is an example of the GEN01 routine. It uses the files <a class="ulink" href="examples/gen01.csd" target="_top"><em class="citetitle">gen01.csd</em></a> and several sound files.
</p>
<div class="example">
<a id="idm402846"></a>
<a id="idm402858"></a>
<p class="title">
<strong>Example 1289. An example of the GEN01 routine.</strong>
</p>
<div class="example-contents">
<div class="refsect1">
<a id="idm402848"></a>
<a id="idm402860"></a>
<pre class="programlisting">
<span class="nt">&lt;CsoundSynthesizer&gt;</span>
<span class="nt">&lt;CsOptions&gt;</span>
Expand Down Expand Up @@ -240,7 +240,7 @@ <h2>Examples</h2>
</p>
</div>
<div class="refsect1">
<a id="idm403106"></a>
<a id="idm403118"></a>
<h2>Credits</h2>
<p>September 2003. Thanks goes to Dr. Richard Boulanger for
pointing out the references to the AIFF file format.</p>
Expand Down
16 changes: 8 additions & 8 deletions GEN02.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,19 +39,19 @@ <h2>
</p>
</div>
<div class="refsect1">
<a id="idm403118"></a>
<a id="idm403130"></a>
<h2>Description</h2>
<p>
This subroutine transfers data from immediate pfields into a function table.
</p>
</div>
<div class="refsect1">
<a id="idm403121"></a>
<a id="idm403133"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>f</strong></span> # time size 2 v1 v2 v3 ...</pre>
</div>
<div class="refsect1">
<a id="idm403125"></a>
<a id="idm403137"></a>
<h2>Initialization</h2>
<p>
<span class="emphasis"><em>size</em></span> -- number of points in the table.
Expand Down Expand Up @@ -93,21 +93,21 @@ <h2>Initialization</h2>
</div>
</div>
<div class="refsect1">
<a id="idm403135"></a>
<a id="idm403147"></a>
<h2>Examples</h2>
<p>
Here is an example of the GEN02 routine. It uses the files <a class="ulink" href="examples/gen02.csd" target="_top"><em class="citetitle">gen02.csd</em></a>.

</p>
<div class="example">
<a id="idm403140"></a>
<a id="idm403152"></a>
<p class="title">
<strong>Example 1290. Example of the GEN02 routine.</strong>
</p>
<div class="example-contents">
<p>See the sections <a class="link" href="UsingRealTime.html" title="Real-Time Audio"><em class="citetitle">Real-time Audio</em></a> and <a class="link" href="CommandFlags.html" title="Csound command line"><em class="citetitle">Command Line Flags</em></a> for more information on using command line flags.</p>
<div class="refsect1">
<a id="idm403147"></a>
<a id="idm403159"></a>
<pre class="programlisting">
<span class="nt">&lt;CsoundSynthesizer&gt;</span>
<span class="nt">&lt;CsOptions&gt;</span>
Expand Down Expand Up @@ -186,14 +186,14 @@ <h2>Examples</h2>
</p>
</div>
<div class="refsect1">
<a id="idm403382"></a>
<a id="idm403394"></a>
<h2>See Also</h2>
<p>
<a class="link" href="GEN17.html" title="GEN17"><em class="citetitle">GEN17</em></a>
</p>
</div>
<div class="refsect1">
<a id="idm403387"></a>
<a id="idm403399"></a>
<h2>Credits</h2>
<p>December 2002. Thanks to Rasmus Ekman, corrected the limit
of the <span class="emphasis"><em>PMAX</em></span> variable.</p>
Expand Down
14 changes: 7 additions & 7 deletions GEN03.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,19 +39,19 @@ <h2>
</p>
</div>
<div class="refsect1">
<a id="idm403400"></a>
<a id="idm403412"></a>
<h2>Description</h2>
<p>
This subroutine generates a stored function table by evaluating a polynomial in x over a fixed interval and with specified coefficients.
</p>
</div>
<div class="refsect1">
<a id="idm403403"></a>
<a id="idm403415"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>f</strong></span> # time size 3 xval1 xval2 c0 c1 c2 ... cn</pre>
</div>
<div class="refsect1">
<a id="idm403407"></a>
<a id="idm403419"></a>
<h2>Initialization</h2>
<p>
<span class="emphasis"><em>size </em></span> -- number of points in the table. Must be a power of 2 or a power-of-2 plus 1.
Expand Down Expand Up @@ -104,20 +104,20 @@ <h2>Initialization</h2>
</div>
</div>
<div class="refsect1">
<a id="idm403446"></a>
<a id="idm403458"></a>
<h2>Examples</h2>
<p>
Here is an example of the GEN03 generator. It uses the file <a class="ulink" href="examples/gen03.csd" target="_top"><em class="citetitle">gen03.csd</em></a>.
</p>
<div class="example">
<a id="idm403451"></a>
<a id="idm403463"></a>
<p class="title">
<strong>Example 1291. Example of the GEN03 generator.</strong>
</p>
<div class="example-contents">
<p>See the sections <a class="link" href="UsingRealTime.html" title="Real-Time Audio"><em class="citetitle">Real-time Audio</em></a> and <a class="link" href="CommandFlags.html" title="Csound command line"><em class="citetitle">Command Line Flags</em></a> for more information on using command line flags.</p>
<div class="refsect1">
<a id="idm403458"></a>
<a id="idm403470"></a>
<pre class="programlisting">
<span class="nt">&lt;CsoundSynthesizer&gt;</span>
<span class="nt">&lt;CsOptions&gt;</span>
Expand Down Expand Up @@ -238,7 +238,7 @@ <h2>Examples</h2>
</p>
</div>
<div class="refsect1">
<a id="idm403989"></a>
<a id="idm404001"></a>
<h2>See Also</h2>
<p>
<a class="link" href="GEN13.html" title="GEN13"><em class="citetitle">GEN13</em></a>,
Expand Down
Loading

0 comments on commit 5ee55f3

Please sign in to comment.