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
|
class:: Warp
summary:: specification of a shape for a mapping of numerical input
related:: Classes/ControlSpec, Classes/Spec
categories:: Control, Spec
description::
The subclasses of Warp specify translations from input (a number) to an output (another number). This is an abstract class - already available shapes are emphasis::linear, exponential, sine, cosine, decibel, curve:: (this is similar to the curves in envelopes, see also link::Classes/Env::).
Warps are internally created by link::Classes/ControlSpec::. Usually they are created by the message strong::asWarp::, understood by symbols and numbers. A warp has a link::Classes/Spec:: to specify a certain range of input and output values.
code::
// create a new warp:
a = \exp.asWarp;
a = -4.asWarp; // a curve warp;
::
ClassMethods::
private::initClass
InstanceMethods::
method::map
Maps and constrains a strong::value:: between 0 and 1 to the output domain.
method::unmap
in the output domain to a value in the range between 0 and 1.
code::
g = -3.asWarp;
g.map(0.5);
g.unmap(0.9);
// fore and back translation should be identical:
g.unmap(g.map(0.5));
::
|
