Documentation‎ > ‎

Melody

This node is used to specify a melody.

Input Pins:

None

Output Pins:

1 note data pin

Parameters:

Note Sequence - The note sequence, look below for commands you can use in a note sequence.

Repeat Count - This is how many times to repeat the melody.  Useful if plugging it into a sequencer or similar type nodes.

Note Sequence Commands:

These are the commands you can use in the note sequence box.  By default, notes are full volume (1.0), length 0.25, normal style, octave 3 and have no staccato.  Commands are not case sensitive and are seperated by spaces.

Style - "Normal" By default, it can be set to "normal" or "nice".  Nice style adds a small envelope (5% of the total note length on each side) on the beginning and end of each note to ramp in and out the volume to make the notes not pop.  Normal style adds no envelope.  Use an envelope node if you want a better envelope.  When you change the style, it affects all notes that occur after this command until you set another style.  You can use "sty" instead of style for short.

Length - Sets the length (in seconds) for all notes after this command.  By default notes are length 0.25.  You can use "len" for short.

Octave - Set the octave for all notes after this command.  By default, notes are octave 3.  You can use "o" for short.

Staccato - Sets the percentage of the note that is spent in silence for all notes after this command.  By default, this is 0.0 meaning play a tone for the full length of a note.  0.5 would mean only play for the first half of the note length and silence for the second half.  1.0 means total silence and no tone played.  Useful for stylistic purposes, and also useful for envelopes, letting a note end early so that it can do the "release" portion of an envelope before the next note begins.  Use "sta" for short

Frequency - You can use this command to play a specific frequency.  It will play the frequency in the current style, length and staccato that are currently set.  This is useful for playing frequencies that don't exist with normal musical notation, or for getting low frequencies to make LFO's for use in filters and such.  Use "fr" for short.  This is a floating point number so you aren't limited to integers!

Notes - You can use regular musical notation to play notes.  The notes will be played in the current style, length, octave and staccato settings.  Valid notes are (not case sensitive): A,  A# / Bb, B, C, C# / Db, D, D# / Eb, E, F, F# / Gb, G, G# / Ab.

Rest - Use this to place a rest for the current note duration.  You can also use "R" for short.

Volume - Use this command to change the volume of all notes past this command.  By default, note volume is 1.0.  valid ranges are from 0.0 to 1.0.  Use "V" for short.

+ or -   -  Use plus or minus to go up or down notes relative to the last played note.  If no note has been played in the sequence previously, these commands will be ignored.

An example note sequence might look like the below:

style nice A B C Db length 0.5 octave 2 A B C Db sta 0.5 A B C D# volume 0.5 + 1 + 2 - 5
Comments