Fix midi cc input and add examples
This commit is contained in:
@ -13,10 +13,12 @@ Topos can interact with the physical world or react to events coming from outsid
|
||||
|
||||
Topos can use MIDI input to estimate the bpm from incoming clock messages and to control sounds with incoming note and cc messages. Sending MIDI messages to Topos is like sending messages to far away universe; you can't expect a quick response, but the messages will be received and processed eventually.
|
||||
|
||||
### Note input
|
||||
|
||||
Midi input can be enabled in the settings panel. Once you have done that, you can use the following functions to control values. All methods have channel parameter as optional value to receive only notes from a certain channel:
|
||||
* <ic>active_notes(channel?: number)</ic>: returns array of the active notes / pressed keys as an array of MIDI note numbers (0-127). Returns undefined if no notes are active.
|
||||
* <ic>sticky_notes(channel?: number)</ic>: returns array of the last pressed keys as an array of MIDI note numbers (0-127). Notes are added and removed from the list with the "Note on"-event. Returns undefined if no keys have been pressed.
|
||||
* <ic>last_note(channel?: number)</ic>: returns the last note that has been received. Returns undefined if no notes have been received.
|
||||
* <ic>last_note(channel?: number)</ic>: returns the last note that has been received. Returns 60 if no other notes have been received.
|
||||
* <ic>buffer()</ic>: return true if there are notes in the buffer.
|
||||
* <ic>buffer_note(channel?: number)</ic>: returns last unread note that has been received. Note is fetched and removed from start of the buffer once this is called. Returns undefined if no notes have been received.
|
||||
|
||||
@ -50,7 +52,7 @@ ${makeExample(
|
||||
${makeExample(
|
||||
"Play last note",
|
||||
`
|
||||
beat(0.5) && last_note() :: sound('sawtooth').note(last_note())
|
||||
beat(0.5) && sound('sawtooth').note(last_note())
|
||||
.vib([1, 3, 5].beat(1))
|
||||
.vibmod([1,3,2,4].beat(2)).out()
|
||||
`,
|
||||
@ -65,70 +67,35 @@ ${makeExample(
|
||||
true
|
||||
)}
|
||||
|
||||
### Midi CC input
|
||||
|
||||
### Run scripts with mini note messages and channels
|
||||
Midi CC messages can be used to control any value in Topos. Midi input can be defined in Settings and last received CC message can be used to control any numeric value within Topos.
|
||||
|
||||
Midi note messages with channels can also be used to run scripts. This can be enabled in the settings panel by setting "Route channels to scripts".
|
||||
|
||||
### Midi clock
|
||||
|
||||
Topos can controlled from external hadware or software using Midi clock messages. To enable this feature, you need to connect a MIDI input as Midi Clock in the settings panel. Once you have done that, Topos will listen to incoming clock messages and will use them to estimate the current bpm. Topos will also listen to Start, Stop and Continue messages to start and stop the evaluation. Different MIDI devices can send clock at different resolution, define Clock PPQN in settings to match the resolution of your device.
|
||||
|
||||
## Mouse input
|
||||
|
||||
<<<<<<< Updated upstream
|
||||
## Mouse
|
||||
=======
|
||||
Topos can use MIDI input to estimate the bpm from incoming clock messages and to control sounds with incoming note and cc messages. Sending MIDI messages to Topos is like sending messages to far away universe; you can't expect a quick response, but the messages will be received and processed eventually.
|
||||
|
||||
Midi input can be enabled in the settings panel. Once you have done that, you can use the following functions to control values. All methods have channel parameter as optional value to receive only notes from a certain channel:
|
||||
* <ic>active_notes(channel?: number)</ic>: returns array of the active notes / pressed keys as an array of MIDI note numbers (0-127). Returns undefined if no notes are active.
|
||||
* <ic>sticky_notes(channel?: number)</ic>: returns array of the last pressed keys as an array of MIDI note numbers (0-127). Notes are added and removed from the list with the "Note on"-event. Returns undefined if no keys have been pressed.
|
||||
* <ic>last_note(channel?: number)</ic>: returns the last note that has been received. Returns undefined if no notes have been received.
|
||||
* <ic>buffer()</ic>: return true if there are notes in the buffer.
|
||||
* <ic>buffer_note(channel?: number)</ic>: returns last unread note that has been received. Note is fetched and removed from start of the buffer once this is called. Returns undefined if no notes have been received.
|
||||
Currently supported methods for CC input are:
|
||||
* <ic>last_cc(control: number, channel?: number): Returns last received CC value for given control number (and optional channel). By default last CC value is last value from ANY channel or 64 if no CC messages have been received.
|
||||
|
||||
${makeExample(
|
||||
"Play active notes as chords",
|
||||
"Play notes with cc",
|
||||
`
|
||||
beat(1) && active_notes() && sound('sine').chord(active_notes()).out()
|
||||
beat(0.5) && sound('arp').note(last_cc(74)).out()
|
||||
`,
|
||||
true
|
||||
)}
|
||||
|
||||
${makeExample(
|
||||
"Play active notes as arpeggios",
|
||||
"Control everything with CCs",
|
||||
`
|
||||
beat(0.25) && active_notes() && sound('juno').note(
|
||||
active_notes().beat(0.5)+[12,24].beat(0.25)
|
||||
).cutoff(300 + usine(1/4) * 2000).out()
|
||||
`,
|
||||
true
|
||||
)}
|
||||
beat(0.5) :: sound('sine')
|
||||
.freq(last_cc(75)*3)
|
||||
.cutoff(last_cc(76)*2*usine())
|
||||
.sustain(1.0)
|
||||
.out()
|
||||
|
||||
${makeExample(
|
||||
"Play continous arpeggio with sticky notes",
|
||||
`
|
||||
beat(0.25) && sticky_notes() && sound('arp')
|
||||
.note(sticky_notes().palindrome().beat(0.25)).out()
|
||||
`,
|
||||
true
|
||||
)}
|
||||
|
||||
${makeExample(
|
||||
"Play last note",
|
||||
`
|
||||
beat(0.5) && last_note() :: sound('sawtooth').note(last_note())
|
||||
.vib([1, 3, 5].beat(1))
|
||||
.vibmod([1,3,2,4].beat(2)).out()
|
||||
`,
|
||||
true
|
||||
)}
|
||||
|
||||
${makeExample(
|
||||
"Play buffered note",
|
||||
`
|
||||
beat(1) && buffer() && sound('sine').note(buffer_note()).out()
|
||||
beat(last_cc(74)/127*.5) :: sound('sine')
|
||||
.freq(last_cc(75)*6)
|
||||
.cutoff(last_cc(76)*3*usine())
|
||||
.sustain(last_cc(74)/127*.25)
|
||||
.out()
|
||||
`,
|
||||
true
|
||||
)}
|
||||
@ -143,7 +110,6 @@ Midi note messages with channels can also be used to run scripts. This can be en
|
||||
Topos can controlled from external hadware or software using Midi clock messages. To enable this feature, you need to connect a MIDI input as Midi Clock in the settings panel. Once you have done that, Topos will listen to incoming clock messages and will use them to estimate the current bpm. Topos will also listen to Start, Stop and Continue messages to start and stop the evaluation. Different MIDI devices can send clock at different resolution, define Clock PPQN in settings to match the resolution of your device.
|
||||
|
||||
## Mouse input
|
||||
>>>>>>> Stashed changes
|
||||
|
||||
You can get the current position of the mouse on the screen by using the following functions:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user