<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>GEN51</title>
<link rel="stylesheet" href="csound.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
<link rel="up" href="ScoregensTop.html" title="Score Statements and GEN Routines" />
<link rel="prev" href="GEN49.html" title="GEN49" />
<link rel="next" href="GEN52.html" title="GEN52" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">GEN51</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="GEN49.html">Prev</a> </td>
<th width="60%" align="center">Score Statements and GEN Routines</th>
<td width="20%" align="right"> <a accesskey="n" href="GEN52.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="GEN51">
<a id="GEN51"></a>
<div class="titlepage"></div>
<a id="IndexGEN51" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">GEN51</span>
</h2>
<p>GEN51 —
This subroutine fills a table with a fully customized micro-tuning scale, in the manner of Csound opcodes <span class="emphasis"><em>cpstun</em></span>, <span class="emphasis"><em>cpstuni</em></span> and <span class="emphasis"><em>cpstmid</em></span>.
</p>
</div>
<div class="refsect1" title="Description">
<a id="id3748819"></a>
<h2>Description</h2>
<p>
This subroutine fills a table with a fully customized micro-tuning
scale, in the manner of Csound opcodes <a class="link" href="cpstun.html" title="cpstun"><em class="citetitle">cpstun</em></a>,
<a class="link" href="cpstuni.html" title="cpstuni"><em class="citetitle">cpstuni</em></a> et
<a class="link" href="cpstmid.html" title="cpstmid"><em class="citetitle">cpstmid</em></a>.
</p>
</div>
<div class="refsect1" title="Syntax">
<a id="id3749043"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>f</strong></span> # time size -51 numgrades interval basefreq basekey tuningRatio1 tuningRatio2 .... tuningRationN</pre>
</div>
<div class="refsect1" title="Performance">
<a id="id3749061"></a>
<h2>Performance</h2>
<p>
The first four parameters (i.e. p5, p6, p7 and p8) define the following
generation directives:</p>
<p>
<span class="emphasis"><em>p5 (numgrades)</em></span>
-- the number of grades of the micro-tuning scale
</p>
<p>
<span class="emphasis"><em>p6 (interval)</em></span>
-- the frequency range covered before repeating the grade
ratios, for example 2 for one octave, 1.5 for a fifth etcetera
</p>
<p>
<span class="emphasis"><em>p7 (basefreq)</em></span>
-- the base frequency of the scale in cps
</p>
<p>
<span class="emphasis"><em>p8 (basekey)</em></span>
-- the integer index of the scale to which to assign basefreq unmodified
</p>
<p>
The other parameters define the ratios of the scale:
</p>
<p>
<span class="emphasis"><em>p9...pN (tuningRatio1...etc.)</em></span>
-- the tuning ratios of the scale
</p>
<p>
For example, for a standard 12-grade scale with the base-frequency of
261 cps assigned to the key-number 60, the corresponding f-statement in
the score to generate the table should be:</p>
<pre class="programlisting">
<span class="comment">; numgrades basefreq tuning-ratios (eq.temp) .......</span>
<span class="comment">; interval basekey</span>
<span class="stamnt">f</span>1 0 64 -51 12 2 261 60 1 1.059463 1.12246 1.18920 ..etc...</pre>
<p>
After the gen has been processed, the table f1 is filled with 64
different frequency values. The 60th element is filled with the
frequency value of 261, and all other elements (preceding and
subsequents) of the table are filled according to the tuning ratios
</p>
<p>
Another example with a 24-grade scale with a base frequency of 440
assigned to the key-number 48, and a repetition interval of 1.5:</p>
<pre class="programlisting">
<span class="comment">; numgrades basefreq tuning-ratios .....</span>
<span class="comment">; interval basekey</span>
<span class="stamnt">f</span>1 0 64 -51 24 1.5 440 48 1 1.01 1.02 1.03 ..etc...</pre>
</div>
<div class="refsect1" title="Credits">
<a id="id3749761"></a>
<h2>Credits</h2>
<p>Author: Gabriel Maldonado</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="GEN49.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="ScoregensTop.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="GEN52.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">GEN49 </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> GEN52</td>
</tr>
</table>
</div>
</body>
</html>
