File: README.md

package info (click to toggle)
faust 2.79.3%2Bds-2
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 397,496 kB
  • sloc: cpp: 278,433; ansic: 116,164; javascript: 18,529; vhdl: 14,052; sh: 13,884; java: 5,900; objc: 3,852; python: 3,222; makefile: 2,655; cs: 1,672; lisp: 1,146; ruby: 954; yacc: 586; xml: 471; lex: 247; awk: 110; tcl: 26
file content (61 lines) | stat: -rw-r--r-- 1,454 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
# faust2svgplot

## A tool to create SVG and HTML files of plotted values.

### Usage
```
faust2svgplot <options> <file.dsp> 
./file -n (nb_samples)[default:4096]> -bs (buffer_size)[default:1] -r (sample_rate)[default:44100] -s (start_at_sample)[default:0] -sp (split)[default:0]
```
### Basic example 

Here is a DSP code example:
 
```
import("stdfaust.lib");
process = 
(
    (
        os.osc(100),
        os.square(100)*0.15,
        os.triangle(400)*0.15
    )
);
```

<img src="example.png" class="mx-auto d-block" width="80%">

#### Notes
* in usage, insert in <file.dsp> your favourite Faust dsp file

### The probe metadata 

You can use the `probe` metadata in bargraph in order to plot specific signals in the program. Here is a DSP code example:

```cpp
import("stdfaust.lib");

sendtoOut(n) = vbargraph("[probe:%n]label%n",0,1);

process = 
(
    (
        ((os.osc(100) : sendtoOut(1)),
        (os.square(100)*0.15 : sendtoOut(2)),
        (os.triangle(400)*0.15 : sendtoOut(3)))
        :>_
    )
);
```

<img src="probeexample.png" class="mx-auto d-block" width="80%">

### The split option
You can split your graph in multiples graph.svg for every probe and every channel.
* usage: `./file -sp 1`

<img src="splitexample.png" class="mx-auto d-block" width="80%">

#### Notes
* the probes are evaluated at every buffer size end. 
If you want the maximum precision, you will need to have a buffer size of 1 sample (set to 1 by default).