<?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>ATSread</title>
<link rel="stylesheet" type="text/css" href="csound.css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1" />
<link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
<link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
<link rel="prev" href="ATSinterpread.html" title="ATSinterpread" />
<link rel="next" href="ATSreadnz.html" title="ATSreadnz" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">ATSread</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="ATSinterpread.html">Prev</a> </td>
<th width="60%" align="center">Orchestra Opcodes and Operators</th>
<td width="20%" align="right"> <a accesskey="n" href="ATSreadnz.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="ATSread">
<a id="ATSread"></a>
<div class="titlepage"></div>
<a id="IndexATSread" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">ATSread</span>
</h2>
<p>ATSread — reads data from an ATS file.
</p>
</div>
<div class="refsect1" title="Description">
<a id="idp14121392"></a>
<h2>Description</h2>
<p>
<span class="emphasis"><em>ATSread</em></span> returns the amplitude (<span class="emphasis"><em>kamp</em></span>) and frequency (<span class="emphasis"><em>kfreq</em></span>) information of a user specified partial contained in the ATS analysis file at the time indicated by the time pointer <span class="emphasis"><em>ktimepnt</em></span>.
</p>
</div>
<div class="refsect1" title="Syntax">
<a id="idp14122960"></a>
<h2>Syntax</h2>
<pre class="synopsis">kfreq, kamp <span class="command"><strong>ATSread</strong></span> ktimepnt, iatsfile, ipartial</pre>
</div>
<div class="refsect1" title="Initialization">
<a id="idp14173056"></a>
<h2>Initialization</h2>
<p>
<span class="emphasis"><em>iatsfile</em></span> – the ATS number (n in ats.n) or the name in quotes of the analysis file made using <a class="ulink" href="http://www-ccrma.stanford.edu/~juan/ATS.html" target="_top"><em class="citetitle">ATS</em></a>.
</p>
<p>
<span class="emphasis"><em>ipartial</em></span> – the number of the analysis partial to return the frequency in Hz and amplitude.
</p>
</div>
<div class="refsect1" title="Performance">
<a id="idp14175088"></a>
<h2>Performance</h2>
<p>
<span class="emphasis"><em>kfreq, kamp</em></span> - outputs of the <span class="emphasis"><em>ATSread</em></span> unit. These values represent the frequency and amplitude of a specific partial selected by the user using <span class="emphasis"><em>ipartial</em></span>. The partials' informations are derived from an ATS analysis. <span class="emphasis"><em>ATSread</em></span> linearly interpolates the frequency and amplitude between frames in the ATS analysis file at k-rate. The output is dependent on the data in the analysis file and the pointer <span class="emphasis"><em>ktimepnt</em></span>.
</p>
<p><span class="emphasis"><em>ktimepnt</em></span> – The time pointer in seconds used to index the ATS file. Used for <span class="emphasis"><em>ATSread</em></span> exactly the same as for <a class="link" href="pvoc.html" title="pvoc"><em class="citetitle">pvoc</em></a> and <a class="link" href="ATSadd.html" title="ATSadd"><em class="citetitle">ATSadd</em></a>.</p>
</div>
<div class="refsect1" title="Examples">
<a id="idp14178800"></a>
<h2>Examples</h2>
<p>
Here is an example of the ATSread opcode. It uses the file <a class="ulink" href="examples/ATSread.csd" target="_top"><em class="citetitle">ATSread.csd</em></a>.
</p>
<div class="example">
<a id="idp14179776"></a>
<p class="title">
<strong>Example 61. Example of the ATSread opcode.</strong>
</p>
<div class="example-contents">
<pre class="programlisting">
<span class="csdtag"><CsoundSynthesizer></span>
<span class="csdtag"><CsOptions></span>
<span class="comment">; Select audio/midi flags here according to platform</span>
-odac <span class="comment">;;;RT audio out</span>
<span class="comment">;-iadc ;;;uncomment -iadc if RT audio input is needed too</span>
<span class="comment">; For Non-realtime ouput leave only the line below:</span>
<span class="comment">; -o ATSread.wav -W ;;; for file output any platform</span>
<span class="csdtag"></CsOptions></span>
<span class="csdtag"><CsInstruments></span>
<span class="ohdr">sr</span> <span class="op">=</span> 44100
<span class="ohdr">ksmps</span> <span class="op">=</span> 32
<span class="ohdr">nchnls</span> <span class="op">=</span> 2
<span class="ohdr">0dbfs</span> <span class="op">=</span> 1
<span class="oblock">instr</span> 1 <span class="comment">; "beats.ats" is created by atsa</span>
ktime <span class="opc">line</span> 0, p3, 2
kfreq, kamp <span class="opc">ATSread</span> ktime, "beats.ats", 100
aout <span class="opc">oscili</span> 0.8, kfreq, 1
<span class="opc">outs</span> aout, aout
<span class="oblock">endin</span>
<span class="csdtag"></CsInstruments></span>
<span class="csdtag"><CsScore></span>
<span class="comment">;sine wave.</span>
<span class="stamnt">f</span> 1 0 16384 10 1
<span class="stamnt">i</span> 1 0 2
<span class="stamnt">e</span>
<span class="csdtag"></CsScore></span>
<span class="csdtag"></CsoundSynthesizer></span>
</pre>
</div>
</div>
<p><br class="example-break" />
</p>
<p>Here we're using <span class="emphasis"><em>ATSread</em></span> to get the 100th partial's frequency and amplitude data out of the 'beats.ats' ATS analysis file. We're using that data to drive an oscillator, but we could use it for anything else that can take a k-rate input, like the bandwidth and resonance of a filter etc.
</p>
</div>
<div class="refsect1" title="See also">
<a id="idp14181456"></a>
<h2>See also</h2>
<p><a class="link" href="ATSreadnz.html" title="ATSreadnz"><em class="citetitle">ATSreadnz</em></a>,
<a class="link" href="ATSinfo.html" title="ATSinfo"><em class="citetitle">ATSinfo</em></a>,
<a class="link" href="ATSbufread.html" title="ATSbufread"><em class="citetitle">ATSbufread</em></a>,
<a class="link" href="ATScross.html" title="ATScross"><em class="citetitle">ATScross</em></a>,
<a class="link" href="ATSinterpread.html" title="ATSinterpread"><em class="citetitle">ATSinterpread</em></a>,
<a class="link" href="ATSpartialtap.html" title="ATSpartialtap"><em class="citetitle">ATSpartialtap</em></a>,
<a class="link" href="ATSadd.html" title="ATSadd"><em class="citetitle">ATSadd</em></a>,
<a class="link" href="ATSaddnz.html" title="ATSaddnz"><em class="citetitle">ATSaddnz</em></a>,
<a class="link" href="ATSsinnoi.html" title="ATSsinnoi"><em class="citetitle">ATSsinnoi</em></a></p>
</div>
<div class="refsect1" title="Credits">
<a id="idp14186336"></a>
<h2>Credits</h2>
<p>
</p>
<table border="0" summary="Simple list" class="simplelist">
<tr>
<td>Author: Alex Norman</td>
</tr>
<tr>
<td>Seattle,Washington</td>
</tr>
<tr>
<td>2004</td>
</tr>
</table>
<p>
</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="ATSinterpread.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="OpcodesTop.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="ATSreadnz.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">ATSinterpread </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> ATSreadnz</td>
</tr>
</table>
</div>
</body>
</html>
distrib
>
Mageia
>
5
>
x86_64
>
media
>
core-release
>
by-pkgid
>
b707d9a4ee443103660a75ccb6e51334
>
files
>
9
