533
edits
Console Commands: Difference between revisions
Apparently I'm wrong
(Added a couple of images, and a tip about silence log spam) |
Benvisions (talk | contribs) (Apparently I'm wrong) |
||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 8: | Line 8: | ||
* Not all of the commands below have undo/redo support. So if you make a change it might not be possible to undo it. | * Not all of the commands below have undo/redo support. So if you make a change it might not be possible to undo it. | ||
* It's possible to corrupt your sequence using the console. So if you're new to this it's highly recommended that you save your sequence before messing with the console. | * It's possible to corrupt your sequence using the console. So if you're new to this it's highly recommended that you save your sequence before messing with the console. | ||
* The fundamental time units used by the sequencer are quarter notes, starting at 0. So t=10 would mean the half-beat after the second beat. If you set the grid to 1/4 (the default) the grid lines match this time unit. Markers can only be placed at whole number time steps: t=0, 1, 2, etc. | * The fundamental time units used by the sequencer are quarter notes, starting at 0. So t=10 would mean the half-beat after the second beat. If you set the grid to 1/4 (the default) the grid lines match this time unit. Markers can only be placed at whole number time steps: t=0, 1, 2, etc. | ||
* Instruments are identified using a number, also known as the ID. The current instrument is stored in the global variable "instrument". So to figure out the number for an instrument, just choose that instrument in the UI, type "instrument", and press enter. You can also just pass "instrument" directly to use the current instrument, eg "setDetune(instrument, 1200)". | * Instruments are identified using a number, also known as the ID. The current instrument is stored in the global variable "instrument". So to figure out the number for an instrument, just choose that instrument in the UI, type "instrument", and press enter. You can also just pass "instrument" directly to use the current instrument, eg "setDetune(instrument, 1200)". | ||
* The console can be very noisy, but all the log spam comes from the ads. You can restrict the console to only show logs from the sequencer itself by enabling "Selected context only" in the console settings (see image). This works in Chrome, but there will be similar filters in any browser. | * The console can be very noisy, but all the log spam comes from the ads. You can restrict the console to only show logs from the sequencer itself by enabling "Selected context only" in the console settings (see image). This works in Chrome, but there will be similar filters in any browser. | ||
* Since 2023, if the browser questions pasting, you must use the command "allow pasting." | |||
[[File:Silencing log spam.png|alt=Silencing log spam|thumb|241x241px|To silence log spam, click the console settings button, then enable "Selected context only".]] | [[File:Silencing log spam.png|alt=Silencing log spam|thumb|241x241px|To silence log spam, click the console settings button, then enable "Selected context only".]] | ||
| Line 45: | Line 45: | ||
setPan(instrument, value) | setPan(instrument, value) | ||
Sets the panning of an instrument. The value can go from -1 to 1 in the UI, but this function can set it to anything. No undo/redo support. | Sets the panning of an instrument. The value can go from -1 to 1 in the UI, but this function can set it to anything. No undo/redo support. | ||
=== Volume === | |||
Instrument Volume: | |||
setInitialInstrumentVolume(instrument, value) | |||
Sets the volume of an instrument. The value can go from -1 to 1 in the UI, but this function can set it to anything. No undo/redo support. Does not update the UI automatically, either update the UI manually or use fillAdvancedInstrumentSettings() and fillSimpleInstrumentSettings() | |||
Sequence Volume: | |||
setInitialSongVolume(value) | |||
Sets the volume of the sequence. The value can go from -1 to 1 in the UI, but this function can set it to anything. No undo/redo support. Does not update the UI. | |||
== Intermediate techniques == | == Intermediate techniques == | ||
| Line 54: | Line 63: | ||
=== Fade notes === | === Fade notes === | ||
fadeNotesIn() | |||
fadeNotesOut() | |||
Fades the selected notes in or out. FadeNotesIn fades in the segment from 0 volume to the original volume, and fadeNotesOut fades the notes from their original volume to 0. | |||
Fades the selected notes in or out | |||
Includes undo/redo support. | Includes undo/redo support. | ||
| Line 80: | Line 88: | ||
Due to the limitations of detune markers, this will only work if the melody sticks to whole number time steps (ie lines up with the quarter note grid), and there's only ever one note at a particular time. This function ignores drum kit instruments. | Due to the limitations of detune markers, this will only work if the melody sticks to whole number time steps (ie lines up with the quarter note grid), and there's only ever one note at a particular time. This function ignores drum kit instruments. | ||
Includes undo/redo support. | |||
=== Convert to Marimba === | |||
convertToMarimba() | |||
Clones and detunes the "2023 Drum Kit" for each note in the selection, then moves each note to the closest octave of the three "Marimba" notes in the kit. This is useful for using the marimba as its own instrument, and works with multiple notes at a time. This function ignores drum kit instruments. | |||
Includes undo/redo support. | Includes undo/redo support. | ||
| Line 179: | Line 193: | ||
For example, you can halve the volume like this (eg for a custom delay effect, copy, shift, then tweak the volume): | For example, you can halve the volume like this (eg for a custom delay effect, copy, shift, then tweak the volume): | ||
tweakNotes(n => n.volume *= 0.5) | tweakNotes(n => n.volume *= 0.5) | ||
We can also use tweakNotes to quantize the note times. This code snaps the notes to the nearest grid line (grid is a global variable that contains the grid value, see setGrid above): | |||
tweakNotes(n=>n.time = Math.round(n.time * grid) / grid) | |||
Another example is the humanize function, which is built on tweakNotes (in fact, several of the other functions could be rewritten in terms of tweakNotes): | Another example is the humanize function, which is built on tweakNotes (in fact, several of the other functions could be rewritten in terms of tweakNotes): | ||
function humanize(volumeVariation = 0.2, timeVariation = 0.1) { | function humanize(volumeVariation = 0.2, timeVariation = 0.1) { | ||