index :: snd

snd.play~

Sound file player on steroids

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

---

информация

Supports variable speed playing, pausing, seeking, time-stretching and resampling

аргументы:

• N number of output channels
  тип: int
  

• NAME absolute or relative to patch sound file name
  тип: symbol
  

методы:

• ff fast forward by specified amount of time
  параметры:
  • [TIME] time amount. Can't be in seconds, milliseconds, samples, SMPTE. If the time unit is not specified treat float values as samples. If argument is not specified: jump one second forward.
    тип: atom
    
• open sets @name property
  параметры:
  • FILENAME absolute or relative to patch soundfile name
    тип: symbol
    обязательно: True
    
• pause pause
  параметры:
  • [FLAG] pause/resume flag. If true or omitted: pause, if false: resume.
    тип: bool
    
• rewind move backwards by specified amount of time (relative value)
  параметры:
  • [TIME] time amount. Can't be in seconds, milliseconds, samples, SMPTE. If the time unit is not specified treat float values as milliseconds. If arguments is not specified jump: one second backward.
    тип: atom
    
• seek move to specified time (absolute value)
  параметры:
  • [TIME] Time position. Can't be in seconds, milliseconds, samples, SMPTE. If the time unit is not specified treat float values as milliseconds. If arguments is not specified jump: seek to the beginning
    тип: atom
    
• start start playing
  параметры:
  • [FLAG] start/stop flag. If true or omitted: start, if false: stop.
    тип: bool
    
• stop stop playing
  параметры:
  • [FLAG] start/stop flag. If true or omitted: stop, if false: start.
    тип: bool
    

свойства:

• @begin Запросить/установить start playing position
  тип: atom
  единица: samp, sec, ms, smpte
  по умолчанию: 0
  

• @end Запросить/установить end playing position
  тип: atom
  единица: samp, sec, ms, smpte
  по умолчанию: -1
  

• @loop Запросить/установить play in the loop
  тип: bool
  по умолчанию: 0
  

• @n (initonly) Запросить/установить number of output channels
  тип: int
  диапазон: 1..32
  по умолчанию: 2
  

• @name Запросить/установить absolute or relative to patch soundfile name
  тип: symbol
  

• @on_err Запросить/установить the error send destination. For example, if soundfile was not found, the message [not_found( will be send to this global name
  тип: symbol
  

• @pitch Запросить/установить pitch-shift correction. Used only if @stretch mode enabled.
  тип: float
  диапазон: 0.25..4
  по умолчанию: 1
  

• @speed Запросить/установить playing speed. If @stretch mode is disabled (default): changes playing speed (also with pitch change respectively) in real time. If @stretch mode is enabled: can only change speed (without pitch change) only on the next playing cycle
  тип: float
  диапазон: 0.25..4
  по умолчанию: 1
  

• @stretch Запросить/установить stretch mode. If true: use timestretch and pitch-shifting
  тип: bool
  по умолчанию: 0
  

• @sync Запросить/установить sync mode. 'now': immediately starts playing (abort previous) after receiving start message. 'defer': wait until previous playing will be done, that starts new. 'wait': do not playing until previous playing will not finished
  тип: symbol
  варианты: now, defer, wait
  по умолчанию: now
  

входы:

• 1: start playing, 0: stop
  тип: control

выходы:

• first output channel
  тип: audio
• … output channel
  тип: audio
• n-th output channel
  тип: audio
• control output
  тип: control

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

play sound

Авторы: Serge Poltavsky

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