Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revisionLast revisionBoth sides next revision | ||
| mozaic_tips_and_tricks [2020/08/13 07:54] – Added Long & Short Pad and Shift deteciotn by wim _ki | mozaic_tips_and_tricks [2021/04/12 17:59] – NoteOn Velocity 0 _ki | ||
|---|---|---|---|
| Line 4: | Line 4: | ||
| This wiki page contains programming tips & tricks for [[mozaic_plugin_engine|Mozaic]] | This wiki page contains programming tips & tricks for [[mozaic_plugin_engine|Mozaic]] | ||
| + | * [[#NoteOn Velocity 0 Special Case]] | ||
| * [[#Two dimensional Arrays]] | * [[#Two dimensional Arrays]] | ||
| * [[#Multi dimensional Arrays]] | * [[#Multi dimensional Arrays]] | ||
| * [[#Store two positive Values into a single Variable]] | * [[#Store two positive Values into a single Variable]] | ||
| * [[#Store three unsigned Bytes into a single Variable]] | * [[#Store three unsigned Bytes into a single Variable]] | ||
| + | * [[#Output Fixed Point Values in Labels]] | ||
| * [[#Some Best Practice Tips]] | * [[#Some Best Practice Tips]] | ||
| * [[#Detect Long or Short Pad Taps]] | * [[#Detect Long or Short Pad Taps]] | ||
| Line 17: | Line 18: | ||
| * [[#Use a Knob to toggle 16 Pads View to HELP View]] | * [[#Use a Knob to toggle 16 Pads View to HELP View]] | ||
| * [[#Knob double-tap Support]] | * [[#Knob double-tap Support]] | ||
| + | * [[#Remove or add an entry inside an array]] | ||
| * [[#Using Logic Operators in Expressions instead of IF cases]] | * [[#Using Logic Operators in Expressions instead of IF cases]] | ||
| * [[#Using Inc and Dec in Expressions]] | * [[#Using Inc and Dec in Expressions]] | ||
| * [[# | * [[# | ||
| * [[#Include Snippets]] | * [[#Include Snippets]] | ||
| + | |||
| + | ===== NoteOn Velocity 0 Special Case===== | ||
| + | < | ||
| + | The Midi Spec allows to use a NoteOn command with velocity zero instead of a NoteOff command. If this combination is received by Mozaic, this midi command is automatically converted to
NoteOff vel 0 - even for the @OnMidiInput event and when checking MidiByte1. | ||
| + | |||
| + | Therefore scripts don‘t need to check for this ‚NoteOn Vel 0‘ case, as that special case is handled by Mozaic. Even when using MidiThrough, | ||
| + | |||
| ===== Two dimensional Arrays ===== | ===== Two dimensional Arrays ===== | ||
| Line 83: | Line 92: | ||
| varB = 124 // allowed range 0 .. ~16000 | varB = 124 // allowed range 0 .. ~16000 | ||
| | | ||
| - | combinedValue = valA + valB * maxA | + | combinedValue = valA + (valB * maxA) |
| </ | </ | ||
| + | |||
| + | For single-byte MIDI values, use 128 for maxA | ||
| To later extract the values from their packed format use | To later extract the values from their packed format use | ||
| Line 119: | Line 130: | ||
| </ | </ | ||
| + | |||
| + | \\ | ||
| + | ===== Output Fixed Point Values in Labels ===== | ||
| + | < | ||
| + | When outputting floating point values into labels (knobs, pads, titles) Moazic generates either a 4 digit fraction string | ||
| + | like 42.5000 (if a remainder present) or an integer value without fraction. | ||
| + | |||
| + | \\ | ||
| + | To always output a positive float with two digits (even when integer), one needs to split the input value and output the computed integer parts individually: | ||
| + | < | ||
| + | n = Round value * 100 | ||
| + | f = Div n, 100 | ||
| + | d = n-f*100 | ||
| + | r1 = Div d, 10 | ||
| + | r2 = d % 10 | ||
| + | LabelKnob 0, {B: | ||
| + | </ | ||
| + | |||
| + | \\ | ||
| + | To always output a negative and positive float with a single digit, the split needs to work on the absolute value | ||
| + | and a conditional statement is used to output both variants: | ||
| + | < | ||
| + | n = Round Abs(value * 10) | ||
| + | f = Div n, 10 | ||
| + | r = (n-f*10) % 10 | ||
| + | if value >=0 | ||
| + | LabelKnob 1, {N: +},f,{.},r | ||
| + | else | ||
| + | LabelKnob 1, {N: },f,{.},r | ||
| + | endif | ||
| + | </ | ||
| \\ | \\ | ||
| Line 350: | Line 392: | ||
| + | \\ | ||
| + | ===== Remove or add an entry inside an array ===== | ||
| + | < | ||
| + | Instead of running through an array with a FOR loop to shift entries to either insert or remove an intermedeate enry, it is way faster to use the CopyArray Mozaic function: | ||
| + | |||
| + | < | ||
| \\ | \\ | ||
| + | === Remove an entry of an array (shift left) === | ||
| + | |||
| + | < | ||
| + | @OnLoad | ||
| + | for i=0 to 6 | ||
| + | a[i] = i | ||
| + | endfor | ||
| + | Log {Before },a[0],{ },a[1],{ },a[2],{ },a[3],{ },a[4],{ },a[5],{ },a[6] | ||
| + | |||
| + | // Remove entry a[2] by left shift of the following entries | ||
| + | CopyArray a[3], a[2], 6 | ||
| + | | ||
| + | Log {After | ||
| + | @End | ||
| + | </ | ||
| + | |||
| + | \\ | ||
| + | === Insert an entry into array (shift right) === | ||
| + | |||
| + | Due to the inner working of CopyArray, the above trick doesn‘t work for right shifts - but one can use a temporary array to be more efficient than iterating over the array: | ||
| + | |||
| + | < | ||
| + | @OnLoad | ||
| + | for i=0 to 6 | ||
| + | a[i] = i | ||
| + | endfor | ||
| + | Log {Before | ||
| + | |||
| + | // Insert a new a[2] | ||
| + | CopyArray a[2], _tmp, 6 | ||
| + | CopyArray _tmp, a[3], 6 | ||
| + | a[2] = 9 | ||
| + | | ||
| + | Log {After | ||
| + | @End | ||
| + | </ | ||
| ===== Using Logic Operators in Expressions instead of IF cases ===== | ===== Using Logic Operators in Expressions instead of IF cases ===== | ||
| < | < | ||
_ki