Sound.SC3.UGen.Dot

Module to provide graph drawing of unit generator graphs. The output is in the form of a dot graph, which can be layed out using the graphviz tools, see http://graphviz.org.

import Sound.SC3.ID
import Sound.SC3.UGen.Dot

Simple a-rate only graph.

draw (out 0 (sinOsc AR 440 0 * 0.1))

As above, but using the record interface.

import Sound.SC3.UGen.Dot.Type

let o = dot_options {use_tables = False}
in draw_with_opt o (out 0 (sinOsc AR 440 0 * 0.1))

With k-rate subgraph.

let f = lfSaw KR 1 0 * 220 + 440
in draw (out 0 (sinOsc AR f 0 * 0.1))

With k-rate & i-rate subgraphs

let {l = rand 'a' 200 400
    ;m = rand 'b' l 600
    ;a = rand 'c' 500 900
    ;f = lfSaw KR 1 0 * m + a}
in draw (out 0 (sinOsc AR f 0 * 0.1))

With control input

let f = control KR "freq" 440
in draw (out 0 (sinOsc AR f 0 * 0.1))

As above but with inlined controls.

let {f = control KR "freq" 440
    ;o = dot_options {inline_controls = True}}
in draw_with_opt o (out 0 (sinOsc AR f 0 * 0.1))

As above but without control name label.

let {o = dot_options {inline_controls = True
                     ,display_control_names = False}
    ;f = control KR "freq" 440}
in draw_with_opt o (out 0 (sinOsc AR f 0 * 0.1))

With multiple channel expansion.

let f = mce2 440 220
in draw (out 0 (sinOsc AR f 0 * 0.1))

With multiple root graph.

let {f = mce2 440 220 + in' 2 KR 0
    ;o1 = sinOsc AR f 0 * 0.1
    ;o2 = sinOsc KR (mce2 0.25 0.35) 0 * mce2 10 15 }
in draw (mrg [out 0 o1,out 0 o2])

With multiple channel UGen.

draw (out 0 (pan2 (sinOsc AR 440 0 * 0.1) 0 1))

With reserved labels (ie. ,,&), and fixed size graph (size in inches).

let o = svg_options {graph_size = Just (1,4)}
in draw_with_opt o (out 0 (sinOsc AR 440 0 >* 0))

Documentation

dot :: Drawable a => a -> String

dot_with_opt of dot_options.

dot_svg :: Drawable a => a -> String

dot_with_opt of svg_options.

draw_with_opt :: Drawable a => Dot_Options -> a -> IO ()

view_with of dot_with_opt.

draw :: Drawable a => a -> IO ()

draw_with_opt of dot_options.

draw_svg :: Drawable a => a -> IO ()

draw_with_opt of svg_options.

dot_options :: Dot_Options

Default dot format Dot_Options.

std_style dot_options

svg_options :: Dot_Options

Default svg format Dot_Options.