Sophie

Sophie

distrib > Mageia > 5 > x86_64 > media > core-release > by-pkgid > b707d9a4ee443103660a75ccb6e51334 > files > 118

csound-doc-5.19.01-10.mga5.noarch.rpm

<?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>FLvslidBnk</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="FLvkeybd.html" title="FLvkeybd" />
    <link rel="next" href="FLvslidBnk2.html" title="FLvslidBnk2" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">FLvslidBnk</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="FLvkeybd.html">Prev</a> </td>
          <th width="60%" align="center">Orchestra Opcodes and Operators</th>
          <td width="20%" align="right"> <a accesskey="n" href="FLvslidBnk2.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry" title="FLvslidBnk">
      <a id="FLvslidBnk"></a>
      <div class="titlepage"></div>
      <a id="IndexFLvslidBnk" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">FLvslidBnk</span>
        </h2>
        <p>FLvslidBnk — 
      A FLTK widget containing a bank of vertical sliders.
    </p>
      </div>
      <div class="refsect1" title="Description">
        <a id="idp23344056"></a>
        <h2>Description</h2>
        <p>
      <span class="emphasis"><em>FLvslidBnk</em></span> is a widget containing a bank of vertical sliders.
    </p>
      </div>
      <div class="refsect1" title="Syntax">
        <a id="idp23344920"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>FLvslidBnk</strong></span> "names", inumsliders [, ioutable] [, iwidth] [, iheight] [, ix] \
      [, iy] [, itypetable] [, iexptable] [, istart_index] [, iminmaxtable]</pre>
      </div>
      <div class="refsect1" title="Initialization">
        <a id="idp23389008"></a>
        <h2>Initialization</h2>
        <p>
      <span class="emphasis"><em><span class="quote">“<span class="quote">names</span>”</span></em></span> -- a double-quoted string containing the names of each slider.  Each slider can have a different name. Separate each name with <span class="quote">“<span class="quote">@</span>”</span> character, for example: <span class="quote">“<span class="quote">frequency@amplitude@cutoff</span>”</span>. It is possible to not provide any name by giving a single space <span class="quote">“<span class="quote"> </span>”</span>. In this case, the opcode will automatically assign a progressive number as a label for each slider.
    </p>
        <p>
      <span class="emphasis"><em>inumsliders</em></span> -- the number of sliders.
    </p>
        <p>
      <span class="emphasis"><em>ioutable</em></span> (optional, default=0) -- number of a previously-allocated table in which to store output values of each slider. The user must be sure that table size is large enough to contain all output cells, otherwise a segfault will crash Csound. By assigning zero to this argument, the output will be directed to the zak space in the k-rate zone. In this case, the zak space must be previously allocated with the <a class="link" href="zakinit.html" title="zakinit"><em class="citetitle">zakinit</em></a> opcode and the user must be sure that the allocation size is big enough to cover all sliders. The default value is zero (i.e. store output in zak space).
    </p>
        <p>
      <span class="emphasis"><em>istart_index</em></span> (optional, default=0) -- an integer number referring to a starting offset of output cell locations. It can be positive to allow multiple banks of sliders to output in the same table or in the zak space. The default value is zero (no offset).
    </p>
        <p>
      <span class="emphasis"><em>iminmaxtable</em></span> (optional, default=0) -- number of a previously-defined table containing a list of min-max pairs, referred to each slider. A zero value defaults to the 0 to 1 range for all sliders without necessity to provide a table. The default value is zero.
    </p>
        <p>
      <span class="emphasis"><em>iexptable</em></span> (optional, default=0) -- number of a previously-defined table containing a list of identifiers (i.e. integer numbers) provided to modify the behaviour of each slider independently. Identifiers can assume the following values:

      </p>
        <div class="itemizedlist">
          <ul class="itemizedlist" type="disc">
            <li class="listitem">
              <p>-1 -- exponential curve response</p>
            </li>
            <li class="listitem">
              <p>0 -- linear response</p>
            </li>
            <li class="listitem">
              <p>number &gt; than 0 -- follow the curve of a previously-defined table to shape the response of the corresponding slider. In this case, the number corresponds to table number.</p>
            </li>
          </ul>
        </div>
        <p>

      You can assume that all sliders of the bank have the same response curve (exponential or linear). In this case, you can assign -1 or 0 to <span class="emphasis"><em>iexptable</em></span> without worrying about previously defining any table. The default value is zero (all sliders have a linear response, without having to provide a table).
    </p>
        <p>
      <span class="emphasis"><em>itypetable</em></span> (optional, default=0) -- number of a previously-defined table containing a list of identifiers (i.e. integer numbers) provided to modify the aspect of each individual slider independently. Identifiers can assume the following values:

      </p>
        <div class="itemizedlist">
          <ul class="itemizedlist" type="disc">
            <li class="listitem">
              <p>0 = Nice slider</p>
            </li>
            <li class="listitem">
              <p>1 = Fill slider</p>
            </li>
            <li class="listitem">
              <p>3 = Normal slider</p>
            </li>
            <li class="listitem">
              <p>5 = Nice slider</p>
            </li>
            <li class="listitem">
              <p>7 = Nice slider with down-box</p>
            </li>
          </ul>
        </div>
        <p>

      You can assume that all sliders of the bank have the same aspect. In this case, you can assign a negative number to <span class="emphasis"><em>itypetable</em></span> without worrying about previously defining any table. Negative numbers have the same meaning of the corresponding positive identifiers with the difference that the same aspect is assigned to all sliders. You can also assign a random aspect to each slider by setting <span class="emphasis"><em>itypetable</em></span> to a negative number lower than -7. The default value is zero (all sliders have the aspect of nice sliders, without having to provide a table).
    </p>
        <p>
      You can add 20 to a value inside the table to make the slider "plastic", or subtract 20 if you want to set the value for all widgets without defining a table (e.g. -21 to set all sliders types to Plastic Fill slider).
    </p>
        <p>
      <span class="emphasis"><em>iwidth</em></span> (optional) -- width of the rectangular area containing all sliders of the bank, excluding text labels, that are placed below that area.
    </p>
        <p>
      <span class="emphasis"><em>iheight</em></span> (optional) -- height of the rectangular area containing all sliders of the bank, excluding text labels, that are placed below that area.
    </p>
        <p>
      <span class="emphasis"><em>ix</em></span> (optional) -- horizontal position of the upper left corner of the rectangular area containing all sliders belonging to the bank. You have to leave enough space, below that rectangle, in order to make sure labels of sliders to be visible. This is because the labels themselves are external to the rectangular area.
    </p>
        <p>
      <span class="emphasis"><em>iy</em></span> (optional) -- vertical position of the upper left corner of the rectangular area containing all sliders belonging to the bank. You have to leave enough space, below that rectangle, in order to make sure labels of sliders to be visible. This is because the labels themselves are external to the rectangular area.
    </p>
      </div>
      <div class="refsect1" title="Performance">
        <a id="idp23402816"></a>
        <h2>Performance</h2>
        <p>
      There are no k-rate arguments, even if cells of the output table (or the zak space) are updated at k-rate.
    </p>
        <p>
      <span class="emphasis"><em>FLvslidBnk</em></span> is a widget containing a bank of vertical sliders. Any number of sliders can be placed into the bank (<span class="emphasis"><em>inumsliders</em></span> argument). The output of all sliders is stored into a previously allocated table or into the zak space (<span class="emphasis"><em>ioutable</em></span> argument). It is possible to determine the first location of the table (or of the zak space) in which to store the output of the first slider by means of <span class="emphasis"><em>istart_index</em></span> argument.
    </p>
        <p>
      Each slider can have an individual label that is placed below it. Labels are defined by the <span class="emphasis"><em><span class="quote">“<span class="quote">names</span>”</span></em></span> argument. The output range of each slider can be individually set by means of an external table (<span class="emphasis"><em>iminmaxtable</em></span> argument). The curve response of each slider can be set individually, by means of a list of identifiers placed in a table (<span class="emphasis"><em>iexptable</em></span> argument). It is possible to define the aspect of each slider independently or to make all sliders have the same aspect (<span class="emphasis"><em>itypetable</em></span> argument).
    </p>
        <p>
      The <span class="emphasis"><em>iwidth</em></span>, <span class="emphasis"><em>iheight</em></span>, <span class="emphasis"><em>ix</em></span>, and <span class="emphasis"><em>iy</em></span> arguments determine width, height, horizontal and vertical position of the rectangular area containing sliders. Notice that the label of each slider is placed below them and is not included in the rectangular area containing sliders. So the user should leave enough space below the bank by assigning a proper <span class="emphasis"><em>iy</em></span> value in order to leave labels visible.
    </p>
        <p>
      <span class="emphasis"><em>FLvslidBnk</em></span> is identical to <a class="link" href="FLslidBnk.html" title="FLslidBnk"><em class="citetitle">FLslidBnk</em></a> except it contains vertical sliders instead of horizontal. Since the width of each single slider is often small, it is recommended to leave only a single space in the names string (“ “), in this case each slider will be automatically numbered.
    </p>
        <div class="warning" title="IMPORTANT!" style="margin-left: 0.5in; margin-right: 0.5in;">
          <table border="0" summary="Warning: IMPORTANT!">
            <tr>
              <td rowspan="2" align="center" valign="top" width="25">
                <img alt="[Warning]" src="images/warning.png" />
              </td>
              <th align="left">IMPORTANT!</th>
            </tr>
            <tr>
              <td align="left" valign="top">
                <p>
        Notice that the tables used by <span class="emphasis"><em>FLvslidBnk</em></span> must be created with the <a class="link" href="ftgen.html" title="ftgen"><em class="citetitle">ftgen</em></a> opcode and placed in the orchestra before the corresponding valuator. They can not placed in the score. This is because tables placed in the score are created later than the initialization of the opcodes placed in the header section of the orchestra.
      </p>
              </td>
            </tr>
          </table>
        </div>
      </div>
      <div class="refsect1" title="Examples">
        <a id="idp23411168"></a>
        <h2>Examples</h2>
        <p>
      Here is an example of the FLvslidBnk opcode. It uses the file <a class="ulink" href="examples/FLvslidBnk.csd" target="_top"><em class="citetitle">FLvslidBnk.csd</em></a>.

      </p>
        <div class="example">
          <a id="idp23412160"></a>
          <p class="title">
            <strong>Example 270. Example of the FLvslidBnk opcode.</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>
            <pre class="programlisting">
<span class="csdtag">&lt;CsoundSynthesizer&gt;</span>
<span class="csdtag">&lt;CsOptions&gt;</span>
<span class="comment">; Select audio/midi flags here according to platform</span>
<span class="comment">; Audio out   Audio in    No messages</span>
-odac           -iadc     -d     <span class="comment">;;;RT audio I/O</span>
<span class="csdtag">&lt;/CsOptions&gt;</span>
<span class="csdtag">&lt;CsInstruments&gt;</span>

<span class="ohdr">sr</span> <span class="op">=</span> 44100
<span class="ohdr">kr</span> <span class="op">=</span> 441
<span class="ohdr">ksmps</span> <span class="op">=</span> 100
<span class="ohdr">nchnls</span> <span class="op">=</span> 1

gitypetable <span class="ohdr">ftgen</span> 0, 0, 8, <span class="op">-</span>2, 1, 1, 3, 3, 5, 5, 7, 7 
giouttable <span class="ohdr">ftgen</span> 0, 0, 8, <span class="op">-</span>2, 0, 0.2, 0.3, 0.4, 0.5, 0.6, 0.8, 1

<span class="opc">FLpanel</span> "Slider Bank", 400, 400, 50, 50
    <span class="comment">;Number of sliders</span>
    inum <span class="op">=</span> 8
    <span class="comment">; Table to store output</span>
    iouttable <span class="op">=</span> giouttable
    <span class="comment">; Width of the slider bank in pixels</span>
    iwidth <span class="op">=</span> 350
    <span class="comment">; Height of the slider in pixels</span>
    iheight <span class="op">=</span> 160
    <span class="comment">; Distance of the left edge of the slider</span>
    <span class="comment">; from the left edge of the panel</span>
    ix <span class="op">=</span> 30
    <span class="comment">; Distance of the top edge of the slider </span>
    <span class="comment">; from the top edge of the panel</span>
    iy <span class="op">=</span> 10
    <span class="comment">; Table containing fader types</span>
    itypetable  <span class="op">=</span> gitypetable
    <span class="opc">FLvslidBnk</span> "1@2@3@4@5@6@7@8@9@10@11@12@13@14@15@16", 16 , iouttable , iwidth , iheight , ix \
      , iy , itypetable
    <span class="opc">FLvslidBnk</span> " ", inum , iouttable , iwidth , iheight , ix \
      , iy <span class="op">+</span> 200 , <span class="op">-</span>23
<span class="comment">; End of panel contents</span>
<span class="opc">FLpanelEnd</span>
<span class="comment">; Run the widget thread!</span>
<span class="opc">FLrun</span>


<span class="oblock">instr</span> 1
<span class="comment">;Dummy instrument</span>
<span class="oblock">endin</span>


<span class="csdtag">&lt;/CsInstruments&gt;</span>
<span class="csdtag">&lt;CsScore&gt;</span>

<span class="comment">; Instrument 1 will play a note for 1 hour.</span>
<span class="stamnt">i</span> 1 0 3600
<span class="stamnt">e</span>


<span class="csdtag">&lt;/CsScore&gt;</span>
<span class="csdtag">&lt;/CsoundSynthesizer&gt;</span>
</pre>
          </div>
        </div>
        <p><br class="example-break" />
    </p>
      </div>
      <div class="refsect1" title="See Also">
        <a id="idp23414440"></a>
        <h2>See Also</h2>
        <p>
      <a class="link" href="FLslider.html" title="FLslider"><em class="citetitle">FLslider</em></a>,
      <a class="link" href="FLslidBnk.html" title="FLslidBnk"><em class="citetitle">FLslidBnk</em></a>
    </p>
      </div>
      <div class="refsect1" title="Credits">
        <a id="idp23415936"></a>
        <h2>Credits</h2>
        <p>Author: Gabriel Maldonado</p>
        <p>New in version 5.06</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="FLvkeybd.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="FLvslidBnk2.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">FLvkeybd </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> FLvslidBnk2</td>
        </tr>
      </table>
    </div>
  </body>
</html>