smml 0.1.11.5 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bc386302aaef1ecc9aea9dc8a5a3cf2ae35b6535
-  data.tar.gz: 7c506e05aac70336b2d9c474492ece2993f77523
+  metadata.gz: 06bb5368c7eb0544ede87c56f49c7808730e974d
+  data.tar.gz: 35e8347b78ef6bc939822f70df30c3c6f9980fc8
 SHA512:
-  metadata.gz: 393656c916d75e843e40541370272454def0751d134f6526eafddf328b883f868279ce0783de05da6ef5b0991cfca90a7a700a6af870b975c4e822bd6b7a96f2
-  data.tar.gz: f817a17d7f50c215db348642e471765fa9e67fabaff70729b2ca0e463b3abc2f1cf926ff1a754599a31b01f148f776ca6941c03c4db04cc2278d057b97f56798
+  metadata.gz: a266b303a40de9ce2a99da0cfaeb25ee24f03d09c3426050b09e14455d879ea8568924a3c42242d7c72808ee5495aabf37caa7af2a4c9d3934383d6582d11054
+  data.tar.gz: 00c2c5d0aaa44000728c44222c1f070a054957af00699898b2c9d11816f349acf3a879b7572fa8daaec012e8afa8b6d0bddb012ec55b6514b88172d4cc512090

data/lib/smml/msm.rb

@@ -89,7 +89,7 @@ syntax: ...( will be changed time after time)
     (syswait:) =when using '(gm:on)' etc., this command is needed for all other tracks to adjust wait-time.
     ||| = track separater
     /// = page separater
-          series of page seperaters insert unique '(mark:all track mark)' to allready running tracks automaticaly.
+          series of page separaters insert unique '(mark:all track mark)' to allready running tracks automaticaly.
     (mark:posname) =position name for adjustment of tracks after long rest etc.
     .DC .DS .toCODA .CODA .FINE =coda mark etc.
     .SKIP =skip mark on over second time
@@ -97,14 +97,14 @@ syntax: ...( will be changed time after time)
     _snare! =percussion sound ( search word like 'snare' (can use tone number) from percussion list if exist )
         similarly, _s!=snare, k:bassKick, o:openHighHat, c:closedHighHat, cc:CrachCymbal, h:highTom, l:lowTom as default.
         map text personaly you set must start with tone number.
-    (loadf:filename.mid,2) =load filename.mid, track 2. Track must be this only and seperated by '|||'.
+    (loadf:filename.mid,2) =load filename.mid, track 2. Track must be this only and separated by '|||'.
     W:=abc        =macro definition. One Charactor macro can be used. use prefix '$' for refering.
     macro W:=abc  =macro definition.
     fn(x):=ab$x    =macro with args. in this case, '$fn(10)' is substituded by 'ab10'. similarly,
                   '$fn(:10,20,30)' = 'ab10ab20ab30'.
                   '$fn(4:10,20,30)' = 'ab10(wait:4)ab20(wait:4)ab30'.
-    compile order is : page,track seperate => macro set and replace => repeat check => sound data make
-    ; =seperater. same to a new line
+    compile order is : page,track separate => macro set and replace => repeat check => sound data make
+    ; =separater. same to a new line
     blank =ignored
     ;; comment =ignored after ';;' of each line
     ;;;;;;     =start mark of multi-line comment. end mark is same or longer mark of ';;'. these must start from the top of line.
@@ -151,7 +151,7 @@ end
 # num and fixed mark word, for swing rythm
 class MyLength < Numeric
   def initialize *a
-    p [:in,a,a.size] if $DEBUG
+    p [:in,a,a.size] if $DEBUG && $debuglevel>4
     a=a[0] if a.size==1
     r=[]
     case a
@@ -168,7 +168,7 @@ class MyLength < Numeric
     end
     @s=Float(r[0])
     @j=([r[1]]-[nil]).flatten||[]
-    p [:i,@s,@j,r,a]  if $DEBUG
+    p [:i,@s,@j,r,a]  if $DEBUG && $debuglevel>4
   end
   def s
     @s
@@ -289,10 +289,10 @@ module MmlReg
     self.r(key,sort,pre)
   end
   def self.trackr
-    self.r([:hexraw,:sharp,:chord,:word,:sound,:tieNote,:register,:modifier,:velocity,:tempo,:num,:octave,:note2,:note,:mod,:note?,:sound?])
+    self.r([:hexraw,:sharp,:chord,:sword,:word,:sound,:tieNote,:register,:modifier,:velocity,:tempo,:num,:octave,:note2,:note,:mod,:note?,:sound?])
   end
   def self.multipletr
-    self.r([:note2,:word,:note,:sound,:tieNote,:register,:chord,:numswing,:num,:sharp,:octave,:mod])
+    self.r([:note2,:sword,:word,:note,:sound,:tieNote,:register,:chord,:numswing,:num,:sharp,:octave,:mod])
   end
   def self.macroDefr
     self::MacroDef
@@ -319,6 +319,7 @@ module MmlReg
     :repStart,
     :repEnd,
     :note2,
+    :sword,
     :word,
     :modifier,
     :sharp,
@@ -355,15 +356,16 @@ module MmlReg
   @@h[:repmark]="\\.FINE|\\.DS|\\.DC|\\.\\$|\\.toCODA|\\.CODA|\\.SKIP"
   @@h[:comment]="\\( *comment[^\(\)]*\\)"
   @@h[:note2]="\\( *tne *:[^\(\)]*\\)|\\( *[[:alpha:]\\-\\+]+,[^,]*\\)"
+  @@h[:sword]="\\([^\(\):,]*:[^\(\),]+\\([^\(\)]+\\)\\)"
   @@h[:word]="\\([^\(\):,]*:[^\(\)]*\\)"
   @@h[:wordStart]="\\([^\(\):]*:"
   @@h[:sharp]="\\([+-]*[[:digit:]\\.]*\\)"
   @@h[:word?]="\\([^\(\)]*\\)"
-  @@h[:chord]="\\{[^\{\}]+,[^\{\},]+\\}|:[[:alpha:]][[:alnum:]]*,"
+  @@h[:chord]="\\{[^\{\}]+,[^\{\},]+\\}|:[[:alpha:]][[:alnum:]]*\\([-+,:[:digit:]]+\\),|:[[:alpha:]][[:alnum:]]*,"
   @@h[:velocity]="v[[:digit:]]+"
   @@h[:note]="[abcdefgACDFGr]|\\{[[:digit:]]+\\}"
   @@h[:note?]="[BE]"
-  @@h[:dummyNote]="o"
+  @@h[:dummyNote]="o|m|O|M"
   @@h[:randNote]="\\?"
   @@h[:sound]="_[^!]+!|="
   @@h[:tieNote]="~|w"
@@ -407,6 +409,7 @@ module MmlReg
            self.r([:macrodefAStart,:macrodefStart,:macrodefA,:macrodef])
   RepStrArray=["[","]",".CODA",".DS",".DC",".FINE",".toCODA",".$",".SKIP"]
   ArgIsOne=%w[ bendCent mark p gm gs xg loadf text ]
+  ArgIsName=%w[ p dumpVar ]
   def self.event m,rest=[]
     ((@@keys-rest).map{|k|m=~/\A#{@@h[k]}\z/ ? k : nil}-[nil])[0]
   end
@@ -521,6 +524,77 @@ def mergeValues a,b
   }
   r
 end
+class Chord
+  def self.notes type,subtype
+    ten=[0]
+    case type
+    when "power"
+      ten+=[7]
+    when "7"
+      ten+=[4,7,10]
+    when "m7"
+      ten+=[3,7,10]
+    when "maj7"
+      ten+=[4,7,11]
+    when "mmaj7"
+      ten+=[3,7,11]
+    when "maj" # no need
+      ten+=[4,7]
+    when "m"
+      ten+=[3,7]
+    when "6"
+      ten+=[4,7,9]
+    when "m6"
+      ten+=[3,7,9]
+    when "sus4"
+      ten+=[5,7]
+    when "aug", "+"
+      ten+=[4,8]
+    when "dim"
+      ten+=[3,6]
+    when "dim7"
+      ten+=[3,6,9]
+    when ""
+      ten+=[4,7]
+    else
+      STDERR.puts "unknown chord type? #{type}"
+    end
+    if subtype
+      tention=subtype.split(',')
+      tention.each{|i|
+        case i
+        when "+5"
+          ten=ten-[7]+[8]
+        when "-5"
+          ten=ten-[7]+[6]
+        when "9"||"add9"
+          ten=ten+[14]
+        when "+9"
+          ten=ten+[15]
+        when "-9"
+          ten=ten+[13]
+        when "+11"
+          ten=ten+[6]
+        when "13"
+          ten=ten+[9]
+        when "-13"
+          ten=ten+[8]
+        when /^:/
+          t=$'.to_i
+          ten=ten+[t]
+        else
+          STDERR.puts "unknown chord sub type? #{subtype}"
+        end
+      }
+    end
+    ten=ten.sort
+    ten
+  end
+  def self.type c
+    c=~/([^(]*)(\((.*)\))?/
+    self.notes($1,$3)
+  end
+end
 class Notes < Hash
   @@rythmChannel=9
   @@notes={
@@ -547,6 +621,15 @@ class Notes < Hash
   def initialize
     @@notes.each{|k,v|self[k]=v}
   end
+  def self.n2note num
+    @@invert[num%@@octave]
+  end
+  def self.n2octave num
+    num/@@octave-1
+  end
+  def self.nDisplay n
+    "#{n}[#{self.n2octave(n)}#{self.n2note(n)}]"
+  end
   def self.get last,dist=0
     last=~/(\-*)(\+*)([[:alpha:]])/
     oct=$1.size*(-1)+$2.size
@@ -580,6 +663,9 @@ class ScaleNotes < Array
       @@mode[s[i+1]]=tmp
     }
   end
+  def move s
+    initialize(self.map{|i|Notes.get(i,s)})
+  end
   def keys
     @@mode.keys
   end
@@ -1318,6 +1404,8 @@ module MidiHex
   # track initialize
   def self.trackPrepare tc=0
     self.getDefault
+    @dummyNoteOrg=["o","O"]
+    @multidummySize=3
     @basekeybend=0
     @theremin=false
     @strokespeed=0
@@ -1381,7 +1469,7 @@ module MidiHex
     @waitingtime=0
     @nowtime+=start
     r=[Event.new(:on)]
-    r<<Event.new(:e,start," 9#{ch} #{key} #{vel} # #{start} later, sound on only , note #{@key} velocity #{velocity}\n")
+    r<<Event.new(:e,start," 9#{ch} #{key} #{vel} # #{start} later, sound on only , note #{Notes.nDisplay(@key)} velocity #{velocity}\n")
     r
   end
   def self.soundOff key=@basekey,ch=@ch,sharp=0
@@ -1420,6 +1508,7 @@ module MidiHex
     len+=len*self.getswing(swing)
     bendStart=@bendNow
     ch=[ch,0x0f].min
+    key=self.rndNote if @dummyNoteOrg.member?(key)
     key+=sharp
     @key=[[key,0x7f].min,0].max
     return self.thereminNote(len,key,velocity,ch) if @theremin
@@ -1440,7 +1529,7 @@ module MidiHex
     @lenForGate=false
     @nowtime+=start
     r=[]
-    r<<Event.new(:e,start," 9#{ch} #{key} #{vel} # #{start} later, sound on note #{@key} velocity #{velocity}\n")
+    r<<Event.new(:e,start," 9#{ch} #{key} #{vel} # #{start} later, sound on note #{Notes.nDisplay(@key)} velocity #{velocity}\n")
     b=@preAfter.shift
     bends=expre=false
     if b
@@ -1471,13 +1560,29 @@ module MidiHex
     end
     r
   end
+  def self.resetRand
+    @lastRandNote=false
+  end
+  def self.rndNote useScale=true
+    key=rand(0x7f)
+    key=self.note2key(@scalenotes.sample) if @scalenotes.size>0 && useScale
+    if @downRandDummy && @lastRandNote
+      key-=12 while key>@lastRandNote && key>12
+    elsif ! @downRandDummy && @lastRandNote
+      key+=12 while key<@lastRandNote && key<127-12
+    end
+    @lastRandNote=key
+    key
+  end
   def self.dummyNote key,len,accent=false,sharp=0,swing=false
     len+=len*self.getswing(swing)
-    vel=@veloecity
+    vel=@velocity
     vel+=@accentPlus
+    @downRandDummy=false
     if key=="?"
-      key=rand(0x7f)
-      key=self.note2key(@scalenotes.sample) if @scalenotes.size>0
+      key=rndNote
+    elsif key=="O"
+      @downRandDummy=true
     end
     key=@preNote.shift if @preNote.size>0
     len=@preLength.shift if @preLength.size>0
@@ -1559,10 +1664,6 @@ module MidiHex
   end
   def self.chordName c,l=false,accent=false,sharp=0,swing=false
     l+=l*self.getswing(swing)
-    c=~/(.)([^(]*)(\((.*)\))?/
-    root=$1
-    type=$2
-    subtype=$4
     same=false
     same=(@lastchordName==c) if @lastchordName
     if same
@@ -1573,64 +1674,12 @@ module MidiHex
       end
     else
       @lastchordName=c
+      c=~/(.)([^(]*)(\((.*)\))?/
+      root=$1
+      type=$2
+      subtype=$4
       base=self.note2key(root)+sharp
-      ten=[0]
-      case type
-      when "power"
-        ten+=[7]
-      when "7"
-        ten+=[4,7,10]
-      when "m7"
-        ten+=[3,7,10]
-      when "maj7"
-        ten+=[4,7,11]
-      when "mmaj7"
-        ten+=[3,7,11]
-      when "maj" # no need
-        ten+=[4,7]
-      when "m"
-        ten+=[3,7]
-      when "6"
-        ten+=[4,7,9]
-      when "m6"
-        ten+=[3,7,9]
-      when "sus4"
-        ten+=[5,7]
-      when "aug" || "+"
-        ten+=[4,8]
-      when "dim"
-        ten+=[3,6]
-      when "dim7"
-        ten+=[3,6,9]
-      when ""
-        ten+=[4,7]
-      else
-        STDERR.puts "unknown chord type? #{type}"
-      end
-      if subtype
-        tention=subtype.split(',')
-        tention.each{|i|
-          case i
-          when "+5"
-            ten=ten-[7]+[8]
-          when "-5"
-            ten=ten-[7]+[6]
-          when "9"||"add9"
-            ten=ten+[14]
-          when "+9"
-            ten=ten+[15]
-          when "-9"
-            ten=ten+[13]
-          when "+11"
-            ten=ten+[6]
-          when "13"
-            ten=ten+[9]
-          when "-13"
-            ten=ten+[8]
-          end
-        }
-      end
-      ten=ten.sort
+      ten=Chord.notes(type,subtype)
       p "#{root} #{ten*','}" if $DEBUG
       chord=ten.sort.map{|i|base+i}
       chord=self.invert(@lastchord,chord)
@@ -1664,17 +1713,30 @@ module MidiHex
   def self.chord c,l=false,accent=false,sharp=0,swing=false
     l+=l*self.getswing(swing)
     r=[]
+    c=c.map{|i|i =~/^\?/ ? ["?"]*@multidummySize : i }.flatten
     sspeed=@strokespeed
     c=c.reverse if @strokeUpDown<0
     span=c.size
     sspeed=l/span/@strokefaster if span*sspeed>l/@strokefaster
-    c.each{|i|
+    tmp=[]
+    ns=c.map{|i|
+      case i
+      when "?"
+        i=self.rndNote
+        i+=12 if tmp.member?(i)
+        tmp<<i
+        i
+      else
+        i
+      end
+    }
+    ns.each{|i|
       r+=self.soundOn(i,@velocity,@ch,sharp)
       @waitingtime+=sspeed
     }
     l-=sspeed*(span-1)
     @waitingtime,rest=self.byGate(l)
-    c.each{|i|
+    ns.each{|i|
       r+=self.soundOff(i,@ch,sharp)
     }
     self.strokeUpDownReset
@@ -2017,13 +2079,28 @@ module MidiHex
   end
   # todo: use scale name
   def self.scale s
-    @scalenotes.reset
     s=s.split(",")
     first=s.first
     mode=s[1]
-    if @scalenotes.keys.member?(:"#{mode}")
+    if s.size==1
+      case first
+      when /^[-+]/
+        shift=first.to_i
+        @scalenotes=@scalenotes.move(shift)
+      when /^:?(.)(.*)/
+        @scalenotes.reset
+        base=$1
+        ten=Chord.type($2)
+        ten.each{|i|
+          note=Notes.get(base,i) # if i=~/^[-+]+[[:digit:]]+$/
+          @scalenotes<<note
+        }
+      end
+    elsif @scalenotes.keys.member?(:"#{mode}")
+      @scalenotes.reset
       @scalenotes.setmode(first,:"#{mode}")
     else
+      @scalenotes.reset
       s.each{|i|
         note=i
         note=Notes.get(first,i) if i=~/^[-+]+[[:digit:]]+$/
@@ -2143,9 +2220,10 @@ module MidiHex
     when "+"
       @strokeUpDown=1
     else
-      s=s.to_i
+      s=(s=~/\./ ? s.to_f : s.to_i)
       @strokeUpDown= s<0 ? -1 : 1
       @strokespeed=s.abs
+      @strokespeed=(s.abs*@tbase).to_i if s.class==Float
     end
   end
   def self.setTheremin flag
@@ -2264,8 +2342,16 @@ module MidiHex
       STDERR.puts "register: no data"
     end
   end
-  def self.setSwing k,v
-    @swingHash[k.to_i]=v.to_f
+  def self.setSwing k,v,hs=@swingHash
+    v=v.to_f
+    k=~/of/
+    if $&
+      k,all=$`.to_i,$'.to_i
+      hs[k]=v
+      hs[all-k]=all-v
+    else
+      hs[k.to_i]=v
+    end
   end
   def self.setRegister k,v
     @registerHash[k.to_i]=v
@@ -2276,14 +2362,18 @@ module MidiHex
     @basekeyCenter=@basekey
   end
   def self.dumpVar v
-    v=~/\A[[:alnum:]]+\z/
-    if $&
-      puts "@#{v} #{eval("@#{v}")}"
-    elsif v=="?"
-      puts self.instance_variables.map{|i|i.to_s[1..-1]}.sort
-    else
-      puts "bad name '#{v}'"
-    end
+    vars=self.instance_variables.map{|i|i.to_s[1..-1]}.sort
+    s=v.split(',')
+    s.each{|v|
+      v=~/\A[[:alnum:]]+\z/
+      if $& && vars.member?(v)
+        puts "@#{v} #{eval("@#{v}")}"
+      elsif v=="?"
+        puts vars*", "
+      else
+        puts "bad name '#{v}'"
+      end
+    }
   end
   def self.key2bend k
     v=k.class==Float ? @bendCent*(k-k.to_i) : 0
@@ -2406,7 +2496,7 @@ module MidiHex
       case i
       when /^\(setSwing:(.*)\)/
         k,v=$1.split(',')
-        swingHash[k.to_i]=v.to_f
+        self.setSwing(k,v,swingHash)
         res<<[:modifier,i]
       when /^(\*)?([[:digit:].]+)(_([[:digit:]]+)j,)?/
         tick=$1? $2.to_f : $2.to_f*tbase
@@ -2720,8 +2810,8 @@ module MidiHex
         @h<<[:soundOn,i]
       when /^\(off:(.*)\)/
         @h<<[:soundOff,$1]
-      when /^\(scale:(.*)\)/
-        @h<<[:call,:scale,$1]
+      when /^\(s(cale)?:(.*)\)/
+        @h<<[:call,:scale,$2]
       when /^\(gtune:(.*)\)/
         @h<<[:call,:gtuning,$1]
       when /^\(chordcenter:(.*)\)/
@@ -2793,11 +2883,17 @@ module MidiHex
         end
       when "r"
         wait<<[:rest,i]
-      when "o"
+      when "o","O"
         wait<<[:dummyNote,i]
       when " "
       when "?"
         wait<<[:dummyNote,"?"]
+      when "m"
+        @h<<[:call,:resetRand]
+        wait<<[:chord,["??"]]
+      when "M"
+        @h<<[:call,:resetRand]
+        wait<<[:chord,["?O"]]
       else
         if @notes.keys.member?(i)
           wait<<[:sound,i]
@@ -3047,7 +3143,7 @@ def funcApply m,name,x
     r<<fbody
   }
   sep=""
-  sep="(wait:#{interval})" if interval
+  sep="(wait:#{interval})" if interval && interval.size>0
   r*sep
 end
 def macroDef data

data/lib/smml/version.rb

@@ -1,3 +1,3 @@
 class Smml
-  VERSION = "0.1.11.5"
+  VERSION = "0.1.12"
 end

data/tutorial_smml.md

@@ -173,7 +173,7 @@ cdim7
 cpower
 ```
 
-followed by
+followed by tentions comma separated.
 
 ```
 (+5)
@@ -186,6 +186,38 @@ followed by
 (-13)
 ```
 
+direct tention order by pre ':' with a half note distance number from chord base note.
+
+```
+ (:1,:2,:3,+5)
+```
+
+in chord name, generally numbers don't mean chromatic distance. don't confuse.
+easy way of counting distance number in chord is to count only white key ignoring black on a piano.
++5 means a sharp of 5th. if there is perfect 5th in the chord, 5th note will be deleted by '(+5)' because they don't appear together generally.
+when you want to use abnormal tentions like conbination of these, direct order can be used like 'c7(:8)' on your own risk.
+:8 expresses a note sharp of 5th by a half note expression. count all of the white and black key between c and g sharp on a piano.
+
+
+for example,
+list of chromatic scale expression is here, (when base note is 'c')
+
+```
+ :0  c
+ :1  C
+ :2  d
+ :3  D
+ :4  e
+ :5  f
+ :6  F
+ :7  g
+ :8  G
+ :9  a
+ :10 A
+ :11 b
+ :12 c (next octave)
+```
+
 
 ## tempo
 ;; most commands except note type ones, are inside parenthesis. set the tempo 120 bpm.
@@ -303,7 +335,7 @@ So '(p:guitar,2)' selects an instrument line '5 two' as the 2nd result of search
 
 ## track
 ;; in SMF, MIDI channel is 1 - 16, and drum is in 10 channel. but currently, these are automaticaly set.
-;; you don't need to think about it. simply seperate tracks with a command '|||'.
+;; you don't need to think about it. simply separate tracks with a command '|||'.
 
 ```
 (p:piano) c d e f ||| (p:organ) e f g a ||| (p:guitar) g a b c
@@ -319,7 +351,7 @@ So '(p:guitar,2)' selects an instrument line '5 two' as the 2nd result of search
 
 
 currenly track names are not used as default, and tracks continue with apprearing order. so if there are no data in some tracks in mid parts of pages,
-use blank tracks by track seperaters.
+use blank tracks by track separaters.
 
 ```
     c     ;; track 1
@@ -344,7 +376,7 @@ first two tracks are 'organ' sound by the same track names declared.
 
 
 ## page
-;; then seperate pages by three or longer one line '/'.
+;; then separate pages by three or longer one line '/'.
 ;; but this command do not adjust time potisions. it simply resets track number increment.
 
 ```
@@ -361,7 +393,7 @@ first two tracks are 'organ' sound by the same track names declared.
 cdef c2d2e2f2 c3def ||| efga e2f2g2a2 e3fga ||| gabc g2a2b2c2 g3abc
 ```
 
-;; if you want to adjust tracks, use a blank page by two lines of page seperaters. the last three 'c' will be played adjusted instead each preceding note lengths are different.
+;; if you want to adjust tracks, use a blank page by two lines of page separaters. the last three 'c' will be played adjusted instead each preceding note lengths are different.
 
 ```
 cd ||| e ||| abcde 
@@ -398,7 +430,7 @@ these are played like  this.
 ```
 
 ;; same mark names 'm' in repeated section or one track will be automaticaly substituded by 'm m@2 m@3'. to adjust, use it in other tracks.
-or use a comma as a seperater of a name and a counter; '(mark:hoge@3)' = '(mark:hoge,3)'.
+or use a comma as a separater of a name and a counter; '(mark:hoge@3)' = '(mark:hoge,3)'.
 
 ```
   a b c (mark:m) a b c (mark:m@2) a b c (mark:m@3)
@@ -410,9 +442,10 @@ search MIDI format and set valid hex data.
 
 ```
   &(00 00 00)
+  &(00,00,00)
 ```
 
-hex data must be ``` 00 01 02 ... FD FE FF ```. one byte is by two hex letters. seperaters are a blank or comma.
+hex data must be ``` 00 01 02 ... FD FE FF ```. one byte is by two hex letters. separaters are a blank or comma.
 ;; currently hex only can be used. oct/decimal may be able to use someday.
 all in SMF track data, unique formated prefix delta tick time data is needed. so if want, you can use '$delta(240)' for 240 ticks.
 the tick means a minimum time span in SMF , one beat equals to 480 ticks as default. in this case, delta time is set to half beat.
@@ -477,7 +510,7 @@ EFF:=(
 ```
 
 after parenthesis, don't set any letters without blanks.
-but now, this is for easy way of writing only, and may not be so useful. to use this multi line values, each line must be seperated.
+but now, this is for easy way of writing only, and may not be so useful. to use this multi line values, each line must be separated.
 
 ```
 $EFF[1] $EFF[2] $EFF[3] $EFF[4]
@@ -531,7 +564,7 @@ use parts split note hight, length, velocity, gate time, pre modifier; sound ele
 ```
 
 the first value of each part will used for the first note 'a'. and so on.
-inside parts, position is seperated by ',' or use dummy value 'o'.
+inside parts, position is separated by ',' or use dummy value 'o'.
 '(V:,,,60,,)' is '(V:ooo 60 oo)'. last dummy values can be omitted. in this case, 4th note 'd' velocity is set to 60.
 if 6th note don't exist, pre modifier element values are simply ignored.
 
@@ -573,10 +606,13 @@ etc.
 if a scale has been defined as below, random notes will be selected from its scale notes.
 
 ```
- (scale:a,b,c,d,e)
- (scale:a,+2,+3,+5,+7,+9,+11)
+ (scale:a,b,c,d,e)             ;; series of note names
+ (scale:a,+2,+3,+5,+7,+9,+11)  ;; first note and plus values to add to first note
+ (scale:+5)                    ;; shift all values from preceding scale. after above scale, this will be '(scale:d, ...)'.
+ (scale: :g7, )                ;; by chord name
 ```
 
+shift value etc. is by a half tone.
 still incompleted to use.
 
 
@@ -626,7 +662,7 @@ or like this.
 ```
 
 ## compile order
-now compiling order is : page,track seperate => macro set and replace => repeat check => sound data make.
+now compiling order is : page,track separate => macro set and replace => repeat check => sound data make.
 if there are bugs, error can appear by macro definitions appear in the last step 'sound data make' for example.
 
 ## D.S. al fine
@@ -654,8 +690,8 @@ dal segno jump mark.
 
 if there is no followed number, 'abc' is repeated 2 times.
 
-## seperater
-;; ';' can be used for one line data as line seperater.
+## separater
+;; ';' can be used for one line data as line separater.
 
 ```
   $ smml -d "abc;def|||mc:=ggg;ccc$mc ddd" -o out.mid
@@ -756,7 +792,7 @@ set these modifiers before note commands.
  (loadf:filename.mid,2)
 ```
 
-load the second track data of filename.mid. when using it, the track must be itself only. seperate by '|||'.
+load the second track data of filename.mid. when using it, the track must be itself only. separate by '|||'.
 this command do not check about track data strictly. be careful.
 
 
@@ -769,7 +805,7 @@ this command do not check about track data strictly. be careful.
 now, note type commands are :
 
 ```
-      c         ;; single note
+      c         ;; single note 'c'
       C         ;; c sharp
       (-)d      ;; single note with flat/sharp/natural modifiers
       {64}      ;; single note by absolute note number
@@ -778,11 +814,14 @@ now, note type commands are :
       {47,:0}   ;; multi note. second note is by 12 series half tone notation
       :cmaj7,   ;; chord name
       =         ;; copy of the latest note type command
+      ?         ;; random note
+      o         ;; dummy note ; use a random note if there is no substitution command
+      m         ;; multi dummy note ; similiar to  '{?,?,?}'
 ```
 
   and other commands are with parentheses.
 
-```~``` or ```w``` seems likely note type, but it is compressed to preceding note as calculated note length. most commands cannot be set inside of ```'c~~~'.```
+```~``` and ```w``` seem like note type, but it is compressed to preceding note as calculated note length. most commands cannot be set inside of ```'c~~~'.```
 
 ;; theremin like sound,
 
@@ -841,11 +880,20 @@ easy way to express fuzzy swing rythm.
 
 ```
  /:a2b1/
- (setSwing:2,2.4)(setSwing:1,0.6)/:a2,b1,/
- (setSwing:2,1.8)(setSwing:1,1.2)/:a2,b1,/
+ (setSwing: 2, 2.4)(setSwing: 1, 0.6) /:a2,b1,/
+ (setSwing: 2, 1.8)(setSwing: 1, 1.2) /:a2,b1,/
 ```
+series of ```ab``` ,
+just 2:1, first longer, first shorter. rythm will be broken if setting part is wrong.
 
-just 2:1, first longer, first shorter. broken if setting part is wrong.
+```
+ (setSwing: 2of3, 2.4)/:a2,b1,/
+```
+
+same as the second line of above. key value must be integer, not float.
+'2of3' and '1of5' can be used at once, but rythm will not be what you predict.
+value for 1of3 , set by rest of 2of3, is overwitten by 1of5.
+there is no way to help it.
 
 ;; register of modifiers
 
@@ -895,7 +943,7 @@ text implement to MIDI file.
 but now blanks are removed. someday maybe fixed ?
 
 
-## test, debug etc.
+## test, debug etc. for developers
 
 ```
   (setInt: varName,10)
@@ -905,3 +953,17 @@ but now blanks are removed. someday maybe fixed ?
 
 directly set local MidiHex variable, dump while compiling if the varName and value are valid.
 
+# syntax implement policy: 
+
+
+parenthesis command is buil with (name:value,value,...). names often used are shorter, or leave it as it is as possible.
+
+
+sound is modifier + note + length word.
+
+
+let it not too complicated in sound part for visibility.
+especially, for other words not to hide note type words.
+
+
+many values in MIDI are 0-127, so values are integers except pre -/+ values that mean differences.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smml
 version: !ruby/object:Gem::Version
-  version: 0.1.11.5
+  version: 0.1.12
 platform: ruby
 authors:
 - tabasano
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-17 00:00:00.000000000 Z
+date: 2014-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler