rubySC 0.1.0 → 0.2.0

data/README.md

@@ -0,0 +1,68 @@
+# rubySC
+
+rubySC est une petite biliothèque qui complète à sa manière
+[SCruby](https://github.com/maca/scruby) en offrant une interface avec
+la bibliothèque JTLib de SuperCollider, cette dernière étant tournée
+vers le live coding, et le scriptage de partition plus que la
+recherche acoustique _per se_.
+
+## Installation
+
+vous devez avoir installé supercollider. Pour l'instant, je n'ai testé
+le programme que sur linux, et l'appel au programme est fait par une
+bonne grosse commande 'system'
+
+## Utilisation
+
+* Un objet "SC" s'occupe de l'interface OSC avec superCollider.
+
+`SC.demarrer`
+
+* On ajoute des "voix", c'est-à-dire un mélange de 7 paramètres
+
+  * instrument : regardez les noms des synthdef dans "init.sc" (ils proviennent tous de recherches sur [SCcode](http://sccode.org/))
+  * dur : les rythmes de votre mélodie
+  * degree : les notes de votre mélodie
+  * amp : le volume de la mélodie
+  * octave : le registre dans lequel se situe votre voix
+  * root : le micro-registre, utilisé pour faire des marches par exemple
+  * scale : l'echelle utilisé pour votre mélodie
+
+`SC.set paramètre(hash), :nomVoix (ou "nomVoix")`
+plus précisément, avec "au clair de la lune" :
+
+	` SC.set ({ :degree => [0,0,0,1,2,1,0,2,1,1,0], :dur => [1, [1, 1, 1 , 1 ,2 ,2 ,1 ,1 ,1 ,1 ,4]]}) , :superius
+	  SC.set ({ :degree => [[0, 2, 4], [0,3,5], [0,2,4], [1,3,4], [0,2,4], [1,3,4], [0,2,4]], :dur => [1, [2,2,2,2,2,2,4]])}, :basse`
+
+On peut ensuite modifier ces voix
+
+	`SC.set ({ :amp => 0.2, :instrument => :wobble, :
+
+* arrêter ou reprenez vos voix : 
+   
+   ` mu.stop :voixUn, :voixDeux ## arrête deux voix
+    mu.play :voixUn ## reprend voixUn
+    mu.remove :all  ## arrête tout et supprime les voix `
+
+Les voix sont stockées dans 'listeVoix'
+
+	SC.listeVoix.inspect
+
+* Deux modules stockent des fonctions plus intéressantes.
+
+	1. Partition, gère tout ce qui est transposition de masse
+	1. Marche, permet de transposer la mélodie d'une voix
+	   `Marche.diatonique :nomVoix, intervalleDeMarche, nbRepetitions`
+	   `Marche.diatonique :superius, 2, 2 ## deux marches par tierce ascendante`
+
+* Vous pouvez essayer de rajouter des instruments dans "init.sc", ou
+bien en apprenant SuperCollider, ou bien en cherchant par vous-mêmes
+des plugins sur le net.
+
+== 
+
+
+Copiez-le comme des gros gorets, qu'un truc un peu simple un jour
+surgisse de ce monde de fous de MAOistes qui veulent détruire le monde
+à force de complexitudinités...
+

data/lib/init.sc

@@ -1,6 +1,6 @@
 //////////dictionnaire d'instruments
 
-SynthDef(\sax, { |out, freq=440, amp=0.1, gate=1|
+SynthDef(\sax, { |out, freq, amp=0.1, gate=1|
 	var num = 16;
 	var harms = Array.series(num, 1, 1) * Array.exprand(num, 0.995, 1.001);
 	var snd = SinOsc.ar(freq * SinOsc.kr(Rand(2.0,5.0),0,Rand(0.001, 0.01),1) * harms, mul:Array.geom(num, 1, 0.63));
@@ -10,6 +10,51 @@ SynthDef(\sax, { |out, freq=440, amp=0.1, gate=1|
 	Out.ar(out, snd!2);
 }).add;
 
+SynthDef(\wobble, { arg out=0, amp=0.1, gate=1, pan=0, spread=0.8, freq, doneAction=2;
+	var sig, sig1, sig2, sig3;
+	sig1 = LFSaw.ar(freq * 1 + (0.04 * [1,-1]));
+	sig2 = LFSaw.ar(freq * 0.99 );
+	sig3 = LFSaw.ar(freq * 1 );
+	sig = sig1 + sig2 + sig3;
+	sig = (sig*50).tanh;
+	sig = sig * EnvGen.ar(\adsr.kr(Env.adsr(0.01,0.1,0.8,0.1)),gate,doneAction:doneAction);
+	sig = Splay.ar(sig, spread, amp, pan);
+	Out.ar(out, sig);
+}).add;
+
+SynthDef(\fatsaw,
+	{
+		arg freq=440, amp=0.3, fat=0.0033, ffreq=2000, atk=0.001, dec=0.3, sus=0.5, rls=0.1,gate=1;
+
+		var f1,f2,f3,f4,synth;
+
+		f1=freq-(freq*fat);
+		f2=freq-(freq*fat/2);
+		f3=freq+(freq*fat/2);
+		f4=freq+(freq*fat);
+
+		synth = LFSaw.ar([f1,f2,f3,f4],[0,0.001,0.002,0.004,0.008]);
+		synth = synth * EnvGen.kr(Env([0,1,sus,0],[atk,dec,rls],'lin',2),gate,doneAction:0);
+		synth=Splay.ar(synth,0.7);
+		synth=RLPF.ar(synth,ffreq*Linen.kr(gate,0.1,0.4,0.2,0),0.4);
+		Out.ar([0,1],synth*amp);
+},[0.1,0.3,4,2]).add;
+
+
+SynthDef("plucking", {arg amp = 0.1, freq = 440, decay = 5, coef = 0.1;
+
+var env, snd;
+env = EnvGen.kr(Env.linen(0, decay, 0), doneAction: 2);
+snd = Pluck.ar(
+        in: WhiteNoise.ar(amp),
+        trig: Impulse.kr(0),
+
+        maxdelaytime: 0.1,
+        delaytime: freq.reciprocal,
+        decaytime: decay,
+        coef: coef);
+    Out.ar(0, [snd, snd]);
+}).add;
 
 ///////// Ligne de fin pour mettre le bouzin en route
 

data/lib/musique.rb

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+load 'lib/circularList.rb'
+#load 'superCollider.rb'
+
+# fonctions de plus haut niveau
+
+
+## module utiliser pour faire des choses au niveau de toutes les voix.
+
+module Partition
+
+  def self.importer JSON
+
+  def self.echelle echelle
+    SC.listeVoix.each_key do |voix|
+      SC.set ({:scale => echelle}), voix
+    end
+    self.updateScore
+  end
+
+
+  def self.transpose intervalle
+    SC.listeVoix.each_key do |voix|
+      SC.set ({:root => intervalle}), voix
+    end
+    self.updateScore
+  end
+
+end
+
+## module pour gérer des marches.
+
+
+module Marche 
+  
+  def self.diatonique voix, intervalle, nbFois
+    melodie=SC.listeVoix[voix.to_s].degree
+    tmp= Array.new(nbFois) do |x|
+      "Pseq(#{melodie.map { |note| note+intervalle*x }})"
+    end
+    tmp.delete("\"")
+    SC.set ({:degree => "[#{tmp.join ","}]"}), voix.to_s
+  end
+
+end
+

data/lib/rubySC.rb

@@ -1,11 +1,15 @@
 #! /usr/bin/ruby
 # -*- coding: utf-8 -*-
 
+load "#{File.join(File.dirname(__FILE__), "voix.rb")}"
+load "#{File.join(File.dirname(__FILE__), "musique.rb")}"
+
+require 'active_support'
 require 'osc-ruby'
 #require 'osc-ruby/em_server'
 require 'singleton'
 include ObjectSpace
-load "#{File.join(File.dirname(__FILE__), "voix.rb")}"
+
 
 
 ## classe principale, singleton
@@ -15,21 +19,24 @@ load "#{File.join(File.dirname(__FILE__), "voix.rb")}"
 # "d'ordre supérieur" qui permet de modifier plusieurs voix ensemble,
 # et donc de créer de la logique musicale
 
-class Musique
+class SC
 
-  include Singleton
+  cattr_reader :listeVoix
+  include Partition, Marche
 
   # ouvre le contact avec SuperCollider
 
-  def initialize
+  def self.demarrer
 
     ## démarre SuperCollider
+    #TODO : faire quelque chose d'un peu plus propre
 
     unless p `ps -ef | grep "sclang" | grep -v "grep" | wc -l`.to_i > 0
       system "sclang -u 57320 #{File.join(File.dirname(__FILE__), "init.sc")} &"
     end
 
-    ## récupère l'adresse du port, mais la lib ne marche pas ??
+    ##  TODO : En théorie, récupèrer l'adresse du port, surtout si une autre instance de
+    ## SuperCollider existe...
     
     # @server= OSC::EMServer.new 3333
     # @server.add_method '/portSuperCollider' do |message|
@@ -39,115 +46,109 @@ class Musique
 
     # variables et méthodes d'utilisation
     
-    @listeVoix=Hash.new
+    @@listeVoix=Hash.new
     define_finalizer(self, Proc.new {self.quit})
     
   end
 
-  def quit
+  ##TODO : trouver une manuère plus propre de quitter SuperCollider,
+  ##Jack a toujours l'air de se vexer...
+  def self.quit
     `killall scsynth sclang`
   end
 
 
   # fonction permettant de communiquer directement avec SuperCollider,
   # ce qui permet pour qui connaît la syntaxe sclang de faire des
-  # ajustages directs
+  # ajustages directs. À ne pas utiliser normalement.
 
-  def send message
+  def self.send message
     @postMan.send OSC::Message.new "/SC", message.to_s
   end
 
-  
-  def updateScore
-    @listeVoix.each do |key, value|
+  ## fonction semi-privée
+
+  def self.updateScore
+    @@listeVoix.each do |key, value|
       value.instance_variables.each do |variable|
         self.updater key, variable[1..-1], value.instance_variable_get(variable) unless value.instance_variable_get(variable).nil?
       end
     end
   end
 
-  def updater voix, arg, value
-    if voix.is_a? String then
-      case arg
-      when "dur"
-        self.send "Pbindef (\\#{voix}, \\#{arg}, Pseq(#{value}.convertRhythm, inf))"
-      when "degree"
-        self.send "Pbindef(\\#{voix}, \\#{arg}, Pseq(#{value}, inf))"
-      when "scale"
-        self.send "Pbindef(\\#{voix}, \\#{arg}, Scale.#{value})"
-      when "instrument"
-        self.send "Pbindef(\\#{voix}, \\#{arg}, \\#{value})"
-      else
-        self.send "Pbindef(\\#{voix}, \\#{arg}, #{value})"
-      end
+  def self.updater voix, arg, value
+    case arg
+    when "dur"
+      self.send "Pbindef (\\#{voix}, \\#{arg}, Pseq(#{value}.convertRhythm, inf))"
+    when "degree"
+      self.send "Pbindef(\\#{voix}, \\#{arg}, Pseq(#{value}, inf))"
+    when "scale"
+      self.send "Pbindef(\\#{voix}, \\#{arg}, Scale.#{value})"
+    when "instrument"
+      self.send "Pbindef(\\#{voix}, \\#{arg}, \\#{value})"
+    else
+      self.send "Pbindef(\\#{voix}, \\#{arg}, #{value.to_s})"
     end
   end
 
   # fonctions principales 
   
-  def set voix, options={}
-    if voix==:all then
-      begin 
-        raise 'ArgumentError : vous ne pouvez appeler une voix "all", renommez-la'
+  public
+  
+  def self.set options={}, *voix
+    if voix.nil?
+      begin
+        raise ArgumentError
       rescue
-        gets voix
+        puts "vous devez donner un nom à votre (vos) voix"
       end
-    elsif @listeVoix[voix.to_s].nil? then
-      @listeVoix[voix.to_s]=Voix.new options
-    else
-      @listeVoix[voix.to_s].set options
-    end
-    self.updateScore   
-    self.play voix.to_s
-  end
-  
-  def remove *args
-    if args[0]==:all then
-      args=@listeVoix.keys
     end
-    args.each do |voix|
-      @listeVoix.delete args
+    voix.each do |voix|
+      p voix.to_s
+      if voix==:all then
+        begin 
+          raise ArgumentError 
+        rescue
+          puts " vous ne pouvez appeler une voix \"all\", renommez-la'"
+        end
+      elsif @@listeVoix[voix.to_s].nil? then
+        @@listeVoix[voix.to_s]=Voix.new options
+      else
+        @@listeVoix[voix.to_s].set options
+      end
+      self.updateScore   
+      self.play voix.to_s
     end
   end
+    
 
-  def play *args
+  def self.play *args
     if args[0]==:all then
-      args=@listeVoix.keys
+      args=@@listeVoix.keys
     end
     args.each do |voix|
       self.send "Pdef(\\#{voix.to_s}).play"
     end
   end	
   
-  def stop *args
+  def self.stop *args
     if args[0]==:all then
-      args=@listeVoix.keys
+      args=@@listeVoix.keys
     end
     args.each do |voix|
       self.send "Pdef(\\#{voix}).stop"
     end
   end
-  
-  ### fonction Live Coding
-  
-  def list
-    @listeVoix.each do |k, v|
-      puts "#{k} : #{v.inspect}"
-    end
-  end
 
 
-  # fonctions de très haut niveau
-
-  def echelle echelle
-    @listeVoix.each_key do |voix|
-      self.set voix, {:scale => echelle}
+  def self.remove *args
+    if args[0]==:all then
+      args=@@listeVoix.keys
+    end
+    args.each do |voix|
+      self.stop voix
+      @@listeVoix.delete voix
     end
-    self.updateScore
   end
   
-  def grilleAccords
-
-  end
-
 end

data/lib/voix.rb

@@ -1,26 +1,35 @@
 # -*- coding: utf-8 -*-
-# sorte de classe privée un peu inutile pour garder en mémoire
+# sorte de classe privée pour garder en mémoire
 # ce qui se passe dans les 'voix'...
 
 class Voix
+
+  attr_reader :dur, :degree, :octave, :root, :scale, :amp, :instrument
   
   def initialize options={}
    
+    @dur=options[:dur]
+    @degree=options[:degree]
+    @octave=options[:octave]
+    @root=options[:root]
+
     if options[:scale].nil?
       then @scale = "major"
     else @scale=options[:scale]
     end
-    @dur=options[:dur]
-    @degree=options[:degree]
-    @octave=options[:octave]
-    @amp=options[:amp]
+
+    if options[:amp].nil?
+      then @amp = "Pwhite(0.2,0.5)"
+    else @amp=options[:amp]
+    end
+
     if options[:instrument].nil?
       then @instrument = "default"
     else @instrument=options[:instrument].to_s
     end
+
   end
   
-  # permet de set plein d'options à la fois, ce qui est plutôt cool
   def set options
     options.each do |key, value|
       if value.is_a? Symbol

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubySC
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,24 +9,8 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-11 00:00:00.000000000 Z
+date: 2014-01-19 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: osc-ruby
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: shoulda
   requirement: !ruby/object:Gem::Requirement
@@ -123,6 +107,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: active_support
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Petite bibliotheque permettant une communication simple entre SuperCollider/JITlib
   et Ruby. Se concentre avant tout sur les capacités logiques de création de mélodies
   plus que sur la génération de son. Nécessite d'installer supercollider sur l'ordinateur
@@ -132,13 +132,14 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE.txt
-- README.rdoc
+- README.md
 files:
 - lib/init.sc
+- lib/musique.rb
 - lib/rubySC.rb
 - lib/voix.rb
 - LICENSE.txt
-- README.rdoc
+- README.md
 homepage: http://github.com/simdax/rubySC
 licenses:
 - MIT
@@ -154,7 +155,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 2342837960793631421
+      hash: -1688632819092793939
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/README.rdoc

@@ -1,42 +0,0 @@
-= rubySC
-
-1. Créez une instance de Musique :
-
- ` mu=Musique.instance `
-
-1. ajouter une nouvelle voix :
-
- ` mu.set :nomVoix (ou "nomVoix"), :param => valeur `
-
-1. il y a 6 paramètres pouvant être réglés :
-    
-  * instrument : pour l'instant, seulement deux ("sax" ou "default") !!
-  * dur : les rythmes de votre mélodie
-  * degree : les notes de votre mélodie
-  * amp : le volume de la mélodie
-  * octave : le registre dans lequel se situe votre voix
-  * scale : l'echelle utilisé pour votre mélodie
-
-1. arrêter ou reprenez vos voix : 
-   
-   ` mu.stop :voixUn, :voixDeux ## arrête deux voix
-   ` mu.play :voixUn ## reprend voixUn
-   ` mu.stop :all  ## arrête tout
-
-1. Des bêtes de méta-fonctions sont à prévoir. 
-
-== Contributing to rubySC
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
-* Fork the project.
-* Start a feature/bugfix branch.
-* Commit and push until you are happy with your contribution.
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2014 simdax. See LICENSE.txt for
-further details.
-