index :: array

array.grainer~

array granulator

доступно с версии: 0.9.2

---

информация

Grain properties: @at - grain position in source array (in samples) @l - grain length (in samples) @amp - grain amplitude in 0..256 range @s - grain speed in -10..10 range @p - grain pan in 0..1 range @w - grain window: rect, tri or hann @tb - time before grain start (in samples) @ta - time after grain done (in samples) @r - grain number of repeats (-1: infinite) @tag - grain tag

аргументы:

• ARRAY array name
  тип: symbol
  

методы:

• align align grain(s) to onset
  параметры:
  • [SUBJ] if '*' or omitted: align all grains, if '.': align finished grains only, if float: align grain with corresponding #id, if symbol: align grains with corresponding tag
    тип: atom
    
• append append several grains
  параметры:

  • N number of grains
    тип: int
    обязательно: True
    

  • PROPS grain properties
    тип: list
    обязательно: True
    

• clear remove grain(s)
  параметры:
  • [SUBJ] if '*' or omitted: remove all grains, if '.': remove finished grains only, if float: remove grain with corresponding #id, if symbol: remove grains with corresponding tag
    тип: atom
    
• defer defer method call until grains will finish
  параметры:

  • [N] number of finished grains to wait before calling. If not specified, treat as 1.
    тип: int
    

  • METHOD method name
    тип: symbol
    обязательно: True
    

  • [ARGS] method arguments
    тип: list
    

• fill fill with grains (remove all existing grains before)
  параметры:

  • N number of grains
    тип: int
    обязательно: True
    

  • PROPS grain properties
    тип: list
    обязательно: True
    

• grain create single grain
  параметры:
  • PROPS grain properties
    тип: list
    обязательно: True
    
• onsets analyze source array for onsets
  параметры:

  • [METHOD=default] onset detection method
    тип: symbol
    

  • [SPACE=64] minimal space between onsets
    тип: float
    единица: ms
    

  • [SILENCE=-40] silence level
    тип: float
    единица: db
    

• pause pause (resume) grain(s)
  параметры:

  • SUBJ if '*': pause all grains, if float: pause grain with corresponding #id, if symbol: pause grains with matched tag
    тип: atom
    обязательно: True
    

  • [STATE] on/off value
    тип: int
    

• permutate permutate grain positions (@ta and @tb) values
  параметры:

  • [N] number of permutations. If N>0 results N-th next permutation, N<0 - N-th previous permutation
    тип: int
    

  • [TAG] if '*' or omitted: reverse positions of all grains, if '.': reverse positions of finished grains only, otherwise reverse grains with corresponding tag
    тип: symbol
    

• reverse reverse grain positions (@ta and @tb) values
  параметры:
  • [TAG] if '*' or omitted: reverse positions of all grains, if '.': reverse positions of finished grains only, otherwise reverse grains with corresponding tag
    тип: symbol
    
• set set grain(s) properties
  параметры:

  • SUBJ if '*': set for all grains, if float: set for grain with specified #id, if symbol: set for grains with specified tag
    тип: atom
    обязательно: True
    

  • PROPS grain properties
    тип: list
    обязательно: True
    

• shuffle shuffle grain positions (@ta and @tb) values
  параметры:
  • [TAG] if '*' or omitted: shuffle all grains, if '.': shuffle finished grains only, otherwise shuffle grains with corresponding tag
    тип: symbol
    
• slice slice specified duration to specified number of grains and add them
  параметры:

  • N desired number of grains
    тип: int
    обязательно: True
    

  • [DUR] duration to slice. Positive time value expected, for example: 100ms, 1.02s, 400samp etc. Float value treat as millisecond. If not specified - use the whole source array duration
    тип: atom
    

  • [GRAIN] properties of sliced grains
    тип: list
    

• spread uniformly arrange grains to fill specified time space
  параметры:

  • [DUR] time space. Positive time values are expected, for example: 100ms, 1.02s, 400samp etc. Float value treat as millisecond. If not specified - use the whole source array duration
    тип: atom
    

  • [TAG] if '*' or omitted: spread all grains, if '.': spread finished grains only, otherwise spread grains with corresponding tag
    тип: symbol
    

свойства:

• @array Запросить/установить array name
  тип: symbol
  

• @sync Запросить/установить grain sync mode. If 'none': start grains right after they are finished, if 'int': start grains after specified interval (@tsync).
  тип: symbol
  варианты: none, int, ext
  по умолчанию: none
  

• @tsync Запросить/установить grain sync interval
  тип: float
  единица: ms
  минимальное значение: 1
  по умолчанию: 50
  

• @prob Запросить/установить grain start probability in internal or external sync mode. ('int' or 'ext')
  тип: float
  диапазон: 0..1
  по умолчанию: 1
  

входы:

• control inlet
  тип: control

выходы:

• left output
  тип: audio
• right output
  тип: audio

ключевые слова:

array grain particle granular

Смотрите также: [array.each]

Авторы: Serge Poltavsky

Лицензия: GPL3 or later