<?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>GEN17</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="GEN16.html" title="GEN16" />
<link rel="next" href="GEN18.html" title="GEN18" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">GEN17</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="GEN16.html">Prev</a> </td>
<th width="60%" align="center">Score Statements and GEN Routines</th>
<td width="20%" align="right"> <a accesskey="n" href="GEN18.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="GEN17">
<a id="GEN17"></a>
<div class="titlepage"></div>
<a id="IndexGEN17" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">GEN17</span>
</h2>
<p>GEN17 —
Creates a step function from given x-y pairs.
</p>
</div>
<div class="refsect1" title="Description">
<a id="id3737781"></a>
<h2>Description</h2>
<p>
This subroutine creates a step function from given x-y pairs.
</p>
</div>
<div class="refsect1" title="Syntax">
<a id="id3737792"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>f</strong></span> # time size 17 x1 a x2 b x3 c ...</pre>
</div>
<div class="refsect1" title="Initialization">
<a id="id3737987"></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 (see <a class="link" href="f.html" title="f Statement (or Function Table Statement)"><em class="citetitle">f statement</em></a>). The normal value is power-of-2 plus 1.
</p>
<p>
<span class="emphasis"><em>x1, x2, x3,</em></span> etc. -- x-ordinate values, in ascending order, 0 first.
</p>
<p>
<span class="emphasis"><em>a, b, c,</em></span> etc. -- y-values at those x-ordinates, held until the next x-ordinate.
</p>
<div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
<table border="0" summary="Note: Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25">
<img alt="[Note]" src="images/note.png" />
</td>
<th align="left">Note</th>
</tr>
<tr>
<td align="left" valign="top">
<p>
This subroutine creates a step function of x-y pairs whose y-values are held to the right. The right-most y-value is then held to the end of the table. The function is useful for mapping one set of data values onto another, such as MIDI note numbers onto sampled sound ftable numbers ( see <a class="link" href="loscil.html" title="loscil"><em class="citetitle">loscil</em></a>).
</p>
</td>
</tr>
</table>
</div>
</div>
<div class="refsect1" title="Examples">
<a id="id3738050"></a>
<h2>Examples</h2>
<p>
</p>
<div class="informalexample">
<pre class="programlisting">
<span class="stamnt">f</span> 1 0 128 -17 0 1 12 2 24 3 36 4 48 5 60 6 72 7 84 8</pre>
</div>
<p>
This describes a step function with 8 successively increasing levels, each 12 locations wide except the last which extends its value to the end of the table. Rescaling is inhibited. Indexing into this table with a MIDI note-number would retrieve a different value every octave up to the eighth, above which the value returned would remain the same.
</p>
</div>
<div class="refsect1" title="See Also">
<a id="id3738721"></a>
<h2>See Also</h2>
<p>
<a class="link" href="GEN02.html" title="GEN02"><em class="citetitle">GEN02</em></a>
</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="GEN16.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="GEN18.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">GEN16 </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> GEN18</td>
</tr>
</table>
</div>
</body>
</html>
