changed ascii art, addedd more comments

antigone.scd

@@ -8,19 +8,15 @@ GNU General Public Licence. See COPYING for more info.
 // Be nice. Say hi!
 postln("\n\n
 
-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 >>> Hello.                                                        <<<
 
+    _   _  _ _____ ___ ___  ___  _  _ ___   _____ _  _ ___ _    ___
+   /_\ | \| |_   _|_ _/ __|/ _ \| \| | __| / / __| || |_ _| |  |   \
+  / _ \| .` | | |  | | (_ | (_) | .` | _| / / (__| __ || || |__| |) |
+ /_/ \_\_|\_| |_| |___\___|\___/|_|\_|___/_/ \___|_||_|___|____|___/
 
- █████╗ ███╗   ██╗████████╗██╗ ██████╗  ██████╗ ███╗   ██╗███████╗
-██╔══██╗████╗  ██║╚══██╔══╝██║██╔════╝ ██╔═══██╗████╗  ██║██╔════╝
-███████║██╔██╗ ██║   ██║   ██║██║  ███╗██║   ██║██╔██╗ ██║█████╗
-██╔══██║██║╚██╗██║   ██║   ██║██║   ██║██║   ██║██║╚██╗██║██╔══╝
-██║  ██║██║ ╚████║   ██║   ██║╚██████╔╝╚██████╔╝██║ ╚████║███████╗
-╚═╝  ╚═╝╚═╝  ╚═══╝   ╚═╝   ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚══════╝
-
-
-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
 ");
 
@@ -30,11 +26,12 @@ Server.default.waitForBoot {
 	// home folder of current script
 	var dir = PathName(thisProcess.nowExecutingPath).pathOnly;
 
-	// load samples
+	// find samples locations
 	~granSmp = PathName(dir +/+ "smp/").files;
 	~granBfrList = List();
 	~granBfr = List();
 
+	// be nice and verbose in the post window while loading to buffers
 	postln(" \n~~~ Loading samples for granular synthesis ..." );
 	~granSmp.do({ |item, i|
 		postln("   " + i + "" + item.folderName +/+ item.fileName);
@@ -44,10 +41,11 @@ Server.default.waitForBoot {
 
 
 	//////////////////////////////////////////////////////////////////////////////////////
-	// granulator "Granny" definition
+	// granulator "Granny" definition - basic recipe for the cake
 
 	SynthDef(\Granny, {
 
+		// arguments - accessible/settable from outside
 		arg bufnum,
 		freq = 200, fvar = 0.05,
 		dur = 0.3, durvar = 0.01,
@@ -57,11 +55,13 @@ Server.default.waitForBoot {
 		reverb = 0.5,
 		posvar = 0.05,
 
-		lpfLFOSpeed = 0.013,
-		lpfLFOSpeedVar = 0.1,
-		lpfLFOMin = 400,
-		lpfLFOMax = 5000,
+		// lpfLFO changes the frequency of low pass filter using a slow sine oscilator
+		lpfLFOSpeed = 0.013, // frequency of the oscilator
+		lpfLFOSpeedVar = 0.1, // varies the freq of the LF oscilator
+		lpfLFOMin = 400, // from Hz
+		lpfLFOMax = 5000, // to Hz
 
+		// lpfLFO changes the position of granulation using a slow sine oscilator
 		posLFOSpeed = 0.005,
 		posLFOSpeedVar = 0.1,
 		posLFOMin = 0,
@@ -132,7 +132,7 @@ Server.default.waitForBoot {
 
 
 //////////////////////////////////////////////////////////////////////////////////////
-// Synths
+// cooking Synths