mirror of
https://github.com/thestk/stk
synced 2026-01-14 13:31:53 +00:00
173 lines
10 KiB
HTML
173 lines
10 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>The Synthesis ToolKit in C++ (STK)</TITLE>
|
|
<LINK HREF="doxygen.css" REL="stylesheet" TYPE="text/css">
|
|
</HEAD>
|
|
<BODY BGCOLOR="#FFFFFF">
|
|
<CENTER>
|
|
<img src="princeton.gif"> <img src="ccrma.gif"> <img src="mcgill.gif"><P>
|
|
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="information.html">Information</a> <a class="qindex" href="classes.html">Classes</a> <a class="qindex" href="download.html">Download</a> <a class="qindex" href="usage.html">Usage</a> <a class="qindex" href="maillist.html">Mail List</a> <a class="qindex" href="system.html">Requirements</a> <a class="qindex" href="links.html">Links</a> <a class="qindex" href="tutorial.html">Tutorial</a></CENTER>
|
|
<HR>
|
|
<!-- Generated by Doxygen 1.3.6 -->
|
|
<h1>SKINI Class Reference</h1>STK SKINI parsing class.
|
|
<a href="#_details">More...</a>
|
|
<p>
|
|
<code>#include <<a class="el" href="SKINI_8h-source.html">SKINI.h</a>></code>
|
|
<p>
|
|
<p>Inheritance diagram for SKINI:
|
|
<p><center><img src="classSKINI.png" usemap="#SKINI_map" border="0" alt=""></center>
|
|
<map name="SKINI_map">
|
|
<area href="classStk.html" alt="Stk" shape="rect" coords="0,0,43,24">
|
|
</map>
|
|
<a href="classSKINI-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0>
|
|
<tr><td></td></tr>
|
|
<tr><td colspan=2><br><h2>Public Member Functions</h2></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a0" doxytag="SKINI::SKINI" ></a>
|
|
</td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a0">SKINI</a> ()</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Default constructor used for parsing messages received externally. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a1" doxytag="SKINI::SKINI" ></a>
|
|
</td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a1">SKINI</a> (char *fileName)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Overloaded constructor taking a SKINI formatted scorefile. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a2" doxytag="SKINI::~SKINI" ></a>
|
|
</td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a2">~SKINI</a> ()</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Class destructor. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top>long </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a3">parseThis</a> (char *aString)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Attempt to parse the given string, returning the message type. <a href="#a3"></a><br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top>long </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a4">nextMessage</a> ()</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Parse the next message (if a file is loaded) and return the message type. <a href="#a4"></a><br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a5" doxytag="SKINI::getType" ></a>
|
|
long </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a5">getType</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message type. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a6" doxytag="SKINI::getChannel" ></a>
|
|
long </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a6">getChannel</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message channel value. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a7" doxytag="SKINI::getDelta" ></a>
|
|
MY_FLOAT </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a7">getDelta</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message delta time value (in seconds). <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a8" doxytag="SKINI::getByteTwo" ></a>
|
|
MY_FLOAT </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a8">getByteTwo</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message byte two value. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a9" doxytag="SKINI::getByteThree" ></a>
|
|
MY_FLOAT </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a9">getByteThree</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message byte three value. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a10" doxytag="SKINI::getByteTwoInt" ></a>
|
|
long </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a10">getByteTwoInt</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message byte two value (integer). <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a11" doxytag="SKINI::getByteThreeInt" ></a>
|
|
long </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a11">getByteThreeInt</a> () const </td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current message byte three value (integer). <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a12" doxytag="SKINI::getRemainderString" ></a>
|
|
const char * </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a12">getRemainderString</a> ()</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return remainder string after parsing. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a13" doxytag="SKINI::getMessageTypeString" ></a>
|
|
const char * </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a13">getMessageTypeString</a> ()</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the message type as a string. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a14" doxytag="SKINI::whatsThisType" ></a>
|
|
const char * </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a14">whatsThisType</a> (long type)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the SKINI type string for the given type value. <br><br></td></tr>
|
|
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a15" doxytag="SKINI::whatsThisController" ></a>
|
|
const char * </td><td class="memItemRight" valign=bottom><a class="el" href="classSKINI.html#a15">whatsThisController</a> (long number)</td></tr>
|
|
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the SKINI controller string for the given controller number. <br><br></td></tr>
|
|
</table>
|
|
<hr><a name="_details"></a><h2>Detailed Description</h2>
|
|
STK SKINI parsing class.
|
|
<p>
|
|
This class parses SKINI formatted text messages. It can be used to parse individual messages or it can be passed an entire file. The file specification is Perry's and his alone, but it's all text so it shouldn't be to hard to figure out.<p>
|
|
SKINI (Synthesis toolKit Instrument Network Interface) is like MIDI, but allows for floating-point control changes, note numbers, etc. The following example causes a sharp middle C to be played with a velocity of 111.132:<p>
|
|
<pre class="fragment"><div> noteOn 60.01 111.13
|
|
</div></pre><p>
|
|
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="skini.html">Synthesis toolKit Instrument Network Interface (SKINI)</a></dd></dl>
|
|
by Perry R. Cook and Gary P. Scavone, 1995 - 2002.
|
|
<p>
|
|
|
|
<p>
|
|
Definition at line <a class="el" href="SKINI_8h-source.html#l00034">34</a> of file <a class="el" href="SKINI_8h-source.html">SKINI.h</a>.<hr><h2>Member Function Documentation</h2>
|
|
<a class="anchor" name="a3" doxytag="SKINI::parseThis" ></a><p>
|
|
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
|
<tr>
|
|
<td class="mdRow">
|
|
<table cellpadding="0" cellspacing="0" border="0">
|
|
<tr>
|
|
<td class="md" nowrap valign="top"> long SKINI::parseThis </td>
|
|
<td class="md" valign="top">( </td>
|
|
<td class="md" nowrap valign="top">char * </td>
|
|
<td class="mdname1" valign="top" nowrap> <em>aString</em> </td>
|
|
<td class="md" valign="top"> ) </td>
|
|
<td class="md" nowrap></td>
|
|
</tr>
|
|
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<table cellspacing=5 cellpadding=0 border=0>
|
|
<tr>
|
|
<td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<p>
|
|
Attempt to parse the given string, returning the message type.
|
|
<p>
|
|
A type value equal to zero indicates an invalid message. </td>
|
|
</tr>
|
|
</table>
|
|
<a class="anchor" name="a4" doxytag="SKINI::nextMessage" ></a><p>
|
|
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
|
<tr>
|
|
<td class="mdRow">
|
|
<table cellpadding="0" cellspacing="0" border="0">
|
|
<tr>
|
|
<td class="md" nowrap valign="top"> long SKINI::nextMessage </td>
|
|
<td class="md" valign="top">( </td>
|
|
<td class="mdname1" valign="top" nowrap> </td>
|
|
<td class="md" valign="top"> ) </td>
|
|
<td class="md" nowrap></td>
|
|
</tr>
|
|
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<table cellspacing=5 cellpadding=0 border=0>
|
|
<tr>
|
|
<td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<p>
|
|
Parse the next message (if a file is loaded) and return the message type.
|
|
<p>
|
|
A negative value is returned when the file end is reached. </td>
|
|
</tr>
|
|
</table>
|
|
<hr>The documentation for this class was generated from the following file:<ul>
|
|
<li><a class="el" href="SKINI_8h-source.html">SKINI.h</a></ul>
|
|
<HR>
|
|
|
|
<table>
|
|
<tr><td><A HREF="http://www-ccrma.stanford.edu/software/stk/"><I>The Synthesis ToolKit in C++ (STK)</I></A></td></tr>
|
|
<tr><td>©1995-2004 Perry R. Cook and Gary P. Scavone. All Rights Reserved.</td></tr>
|
|
</table>
|
|
|
|
</BODY>
|
|
</HTML>
|