File: UserManual_87.html

package info (click to toggle)
taopm 1.0-7
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 6,972 kB
  • sloc: sh: 9,809; cpp: 5,161; yacc: 2,298; lex: 464; makefile: 434; ansic: 57
file content (69 lines) | stat: -rwxr-xr-x 4,627 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<!-- HTML file produced from file: UserManual.tex --
 -- using Hyperlatex v 2.3.1 (c) Otfried Cheong--
 -- on Emacs 21.1 (patch 4) "Arches" XEmacs Lucid, Sun Apr 30 20:50:03 2000 -->
<HEAD>
<TITLE>Tao User Manual -- Damping Parts of an Instrument</TITLE>

    <link rel=stylesheet href="../../taomanual.css" type="text/css">
    
</HEAD><BODY BACKGROUND="bg.gif">

    <table width="500" border="0" align="left" cellspacing="2" cellpadding="2"><tr><td class="nav" valign="top"><!-- top panel --><A HREF="UserManual_85.html"><IMG ALT="Up" ALIGN=BOTTOM BORDER=0 SRC="up.gif"></A>
    <BR><A HREF="UserManual_85.html">Instrument Methods grouped by Function</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
    </td><td class="nav" valign="top"><A HREF="UserManual_86.html"><IMG ALT="Back" ALIGN=BOTTOM BORDER=0 SRC="back.gif"></A>
    <BR><A HREF="UserManual_86.html">Locking Parts of an Instrument</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
    </td><td class="nav" valign="top"><A HREF="UserManual_88.html"><IMG ALT="Forward" ALIGN=BOTTOM BORDER=0 SRC="forward.gif"></A>
    <BR><A HREF="UserManual_88.html">Graphically Placing Instruments</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
    </td></tr><!-- end top panel --><tr><td colspan="3" class="main"><!-- main text --><br><br>
<H3>Damping Parts of an Instrument</H3>


A number of methods are provided for damping parts of an instrument.
These include:
<P><PRE>
    setDamping(&lt;d&gt;)
    setDamping(&lt;x&gt;,&lt;d&gt;)
    setDamping(&lt;x&gt;,&lt;y&gt;,&lt;d&gt;)
    setDamping(&lt;x1&gt;,&lt;x2&gt;,&lt;y1&gt;,&lt;y2&gt;,&lt;d&gt;)
    resetDamping()
    resetDamping(&lt;x&gt;)
    resetDamping(&lt;x&gt;,&lt;y&gt;)
    resetDamping(&lt;x1&gt;,&lt;x2&gt;,&lt;y1&gt;,&lt;y2&gt;)
</PRE>
<P>In each case the argument <CODE>&lt;d&gt;</CODE> is a floating point value in
the range [0..1], where 0 represents no damping at all and 1 means that
the portion of material affected will be locked rigidly in a fixed
position. The progression from the former state to the latter as
<CODE>&lt;d&gt;</CODE> changes from 0 to 1 is logarithmic rather than linear
for reasons which are explained below.
<P>The damping value <CODE>&lt;d&gt;</CODE> is converted via the following formula
into the appropriate <CODE>velocityMultiplier</CODE> attribute (see section
<A HREF="UserManual_21.html">*</A>):
<P><BLOCKQUOTE><I> v<sub>m</sub> = 1 - (10000<sup>d</sup>)/(10000) </I></BLOCKQUOTE>
<P>where <I>v<sub>m</sub></I> and <I>d</I> correspond to <CODE>velocityMultiplier</CODE> and
<CODE>&lt;d&gt;</CODE> respectively.
<P>You may remember that the <CODE>velocityMultiplier</CODE> value also lies in the
range [0..1] and on each tick of the synthesis engine the velocity of
each cell is multiplied by this value.
<P>The <CODE>resetDamping</CODE><A NAME="1"> family</A> of methods set the damping back to what
it was when the instrument was created. This is useful for situations
where it is desirable to temporarily damp a region. An example application
might be playing a harmonic on a string. Any guitarist will know that
in order to do so a finger is placed momentarily in contact with one of
the strings, over a node, whilst (or after) the string is plucked. Once
the harmonic begins to clearly ring out the players finger is removed
again leaving the string to continue vibrating in its modified pattern.
<P>
    <BR></td></tr><!-- end main text --><tr><td class="nav" align="left" valign="top"><!-- bottom matter --><A HREF="UserManual_85.html"><IMG ALT="Up" ALIGN=BOTTOM BORDER=0 SRC="up.gif"></A>
    <BR><A HREF="UserManual_85.html">Instrument Methods grouped by Function</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
    </td><td class="nav" align="left" valign="top"><A HREF="UserManual_86.html"><IMG ALT="Back" ALIGN=BOTTOM BORDER=0 SRC="back.gif"></A>
    <BR><A HREF="UserManual_86.html">Locking Parts of an Instrument</A><BR><IMG width="167" height="1" SRC="trans1x1.gif">
    </td><td class="nav" align="left" valign="top"><!-- bottom matter --><A HREF="UserManual_88.html"><IMG ALT="Forward" ALIGN=BOTTOM BORDER=0 SRC="forward.gif"></A>
    <BR><A HREF="UserManual_88.html">Graphically Placing Instruments</A>
    <IMG width="167" height="1" SRC="trans1x1.gif">
    </td></tr><!-- end bottom matter -->

    <tr><td colspan="3" class="addr"><!-- bottom panel --><ADDRESS><FONT SIZE=-1>&#169;1999,2000 Mark Pearson
<A HREF="mailto:m.pearson@ukonline.co.uk">m.pearson@ukonline.co.uk</A> April 30, 2000</ADDRESS><BR></td></tr><!-- end bottom panel --></table></BODY></HTML>