Add hello world example

Author: ideoforms

examples/hello-world.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+
+#-------------------------------------------------------------------------------
+# Minimal example of using python-supercollider.
+#
+# Before running this script, the SC server must be started, and the following
+# SynthDef stored:
+#
+# SynthDef(\sine, { |out = 0, freq = 440.0, gain = 0.0|
+#     Out.ar(out, SinOsc.ar(freq) * gain.dbamp);
+# }).store;
+#-------------------------------------------------------------------------------
+
+from supercollider import Server, Synth
+import time
+
+#-------------------------------------------------------------------------------
+# Create connection to default server on localhost:57110
+#-------------------------------------------------------------------------------
+server = Server()
+
+#-------------------------------------------------------------------------------
+# Create a Synth, set its parameter, query the parameter, and free it.
+#-------------------------------------------------------------------------------
+synth = Synth(server, "sine", { "freq" : 440.0, "gain" : -36.0 })
+print("Created synth")
+synth.get("freq", lambda n: print("Frequency: %.1f" % n))
+time.sleep(1.0)
+synth.free()
+print("Freed synth")