A newer version of Max is available. Click here to access the latest version of this document.

nslider

Output numbers from a notation display onscreen

Description

nslider or "Note Slider" is a musical-notation-based integer value slider.

Arguments

None.

Messages

bang In left inlet: Sends out the pitch and velocity values currently stored in nslider.
int input [int]
 In left inlet: The number received in the inlet is displayed graphically by nslider if it falls within its displayed range. The current velocity value (from 1 to 127) that nslider holds is sent out its right outlet, followed by the received number out the left outlet.
  (inlet1) velocity [int]
 In right inlet: The number received in the right inlet sets the output key velocity without triggering output.
float input [float]
 In left inlet: Converted to int.
  (inlet1) velocity [float]
 In right inlet: Converted to int.
list pitch and velocity [list]
 A list of two numbers sent to the left inlet of nslider can be used to set and output the note and velocity values.
chord pitch and velocity pairs [list]
 In left inlet: The word chord, followed by a list of MIDI note name and velocity pairs, can be used to play chords on the nslider in polyphonic mode (set by the mode 1 message). The chord message sends note-offs for currently held notes, followed by note-on commands for the specified note and velocity pairs. When the nslider object's state is saved by a preset object in polyphonic mode, the preset object will store chord messages.
clear In left inlet: The clear message will clear any notes on the staves, but will not trigger any output.
flush In left inlet: When the nslider object is in polyphonic mode (set by the mode 1 message), the flush message will send note-offs to currently held notes and clear the nslider object's display.
(mouse) nslider also sends out numbers when you click or drag on it with the mouse. The velocity value is determined by the previous value received in the right inlet.
If the nslider object is in polyphonic mode, you need to click on a note twice: once to send a note-on and drawe the note, and once again to send a note-off and erase the note.
set pitch and velocity [list]
 In left inlet: The word set, followed by a number, changes the value displayed by nslider, without triggering output. If the set message is followed by two numbers, both the note and velocity values are set, without causing output.

Attributes

Name Type g/s Description
bgcolor float Sets the background color for the object in RGBA format.
bordercolor float Sets the border color for the object in RGBA format.
fgcolor float Sets the foreground color for the object in RGBA format.
mode int
def.:0 		Sets the nslider object's mode of operation.
0 Monophonic: (the default) Only one note can be selected and displayed at one time.
1 Polyphonic: The kslider object keeps track of note-ons and note-offs, so it mirrors which notes are currently held down on your MIDI keyboard. A key is “turned off” by sending the kslider object a key on message with a velocity of 0.
rounded int
def.:8 		Sets the radius, in pixels for the nslider object.

Information for box attributes common to all objects

Output

int: nslider sends its current velocity value out its right outlet, followed by the (displayable) pitch value out its left outlet, when a number is received in its inlet or you click or drag on the object. In polyphonic mode, it will send a note value with a velocity of zero when a note is removed from the staves.

Examples

A useful tool to monitor an incoming MIDI stream

See Also

Name Description
kslider Output numbers from a keyboard onscreen
makenote Generate a note-off message following each note-on
notein Output received MIDI note messages
noteout Transmit MIDI note messages
pictslider Picture-based slider control
rslider Display or change a range of numbers
slider Output numbers by moving a slider onscreen