Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionLast revisionBoth sides next revision | ||
mozaic_include_migration_mananger [2020/07/13 08:09] – created MigrationManager Include Documentation _ki | mozaic_include_migration_mananger [2021/07/16 22:20] – Updated comment, there‘s more work needed... _ki | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Mozaic: Migration Manager | + | ====== Mozaic: |
{{tag> | {{tag> | ||
Line 22: | Line 22: | ||
* Updating of the script should be intended or likely | * Updating of the script should be intended or likely | ||
- | ==== Samples | + | ==== Scripts |
* The [[https:// | * The [[https:// | ||
- | * The [[https:// | + | * The [[https:// |
- | * The 'MutatoR' | + | * The[[https:// |
+ | * The[[https:// | ||
\\ | \\ | ||
Line 40: | Line 41: | ||
* Your scipt also needs to define the 4 event functions @MigrateSend, | * Your scipt also needs to define the 4 event functions @MigrateSend, | ||
+ | |||
+ | * Choose a unique **mmScriptId** for your script, see [[#Reserved mmScriptId‘s]] | ||
==== @OnLoad ==== | ==== @OnLoad ==== | ||
Line 62: | Line 65: | ||
| | ||
< | < | ||
- | mmScriptId | + | mmScriptId |
- | mmScriptTimer = YES // Remove the line if your script does define an OnTimer | + | mmScriptTimer = YES |
+ | // Set to NO if Migration Manager should manage the timer | ||
Call @MigrationManagerOnLoad | Call @MigrationManagerOnLoad | ||
if mmIsMigrating | if mmIsMigrating | ||
Line 71: | Line 75: | ||
endif | endif | ||
</ | </ | ||
+ | |||
+ | ==== Choose a unique mmScriptId ==== | ||
+ | Each script needs to use an own unique mmScriptId. There could be several totally different scripts including the Migration Manager Snippet loaded in a single AUv3 host session, therefore the scripts unique id is used to identify other instances of this specific script and to ensure the scripts ‚own‘ data is received. The id can be understood as „sender/ | ||
+ | The maximum value for mmScriptId is 24bits or 6 hex chars (0x000100 to 0xFFFF80) | ||
+ | |||
+ | \\ | ||
+ | === Reserved mmScriptId‘s === | ||
+ | The following mmScriptId ranges are already in use by other scripts and should be avoided: | ||
+ | ^ ^ mmScriptId ^ end of range ^ script ^ | ||
+ | | | 0x4200 | 0x420F | MS6 SysEx Performance Editor and Spatial Processor | | | ||
+ | | | 0xDEAA0 | 0xDEAAF | Migration Manager Demo | | | ||
+ | | | 0x4D4D43 | 0x4D4D4F | Midi Multicast | | | ||
+ | | | 0x50C001 | 0x50C01F | MutatoR | | | ||
==== @OnTimer ==== | ==== @OnTimer ==== |