File: 06-var-function.rst.txt

package info (click to toggle)
python-pyo 1.0.6-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 52,332 kB
  • sloc: python: 135,133; ansic: 127,822; javascript: 16,116; sh: 395; makefile: 388; cpp: 242
file content (69 lines) | stat: -rw-r--r-- 1,873 bytes parent folder | download | duplicates (2)
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
Controlling user variables in an expression from python
============================================================================================================================================


**06-var-function.py**

User variables are created with the keyword `var`:

.. code-block:: scheme

    (var #var (init))

The variable name must begin with a `#`.

They are computed only at initialization, but can be changed from the 
python script with method calls (`varname` is a string and `value` is a 
float)::

    obj.setVar(varname, value)

The following example illustrates a self-modulated oscillator of which
the frequency and the feedback are controlled from the python side with
method calls.

.. code-block:: python

    from pyo import *
    
    s = Server().boot()
    
    expression = """
    (var #pitch 200)
    (var #feed 0.5)
    (define oscloop (
            (let #xsin
                (sin (+ (* twopi (~ $1)) (* #xsin $2))) // #xsin used before...
            ) // ... "let" statement finished = one-delay feedback loop!
            #xsin // oscloop function outputs #xsin variable
        )
    )
    
    (oscloop #pitch #feed)
    
    """
    
    expr = Expr(Sig(0), expression, mul=0.5)
    expr.editor()
    
    # Shows two sliders, one for the frequency and one for the feedback parameter.
    pit = Sig(200)
    pit.ctrl([SLMap(100, 1000, "log", "value", 200)], title="Frequency")
    feed = Sig(0.5)
    feed.ctrl([SLMap(0, 1, "lin", "value", 0.5)], title="Feedback")
    
    
    def change():
        "Sends new values to user variables in the expression."
        expr.setVar(["#pitch", "#feed"], [pit.get(), feed.get()])
    
    
    # Calls the change() function every 20 ms to update the user variables.
    pat = Pattern(change, 0.025).play()
    
    sc = Scope(expr)
    
    pan = Pan(expr).out()
    
    s.gui(locals())