Differences

This shows you the differences between two versions of the page.

--- mozaic_include_migration_mananger [2021/07/14 05:47] – Added more info regarding the mmScriptId _ki
+++ mozaic_include_migration_mananger [2021/07/16 22:20] (current) – Capitalization _ki
@@ Line 66: / Line 66: @@
  <code>
   mmScriptId    = 0xDEAA0 // Please choose an new unique number up to 24bits !
-  mmScriptTimer = YES     // Remove the line if your script does define an OnTimer
+  mmScriptTimer = YES     // YES if script defines an own timer. Remove the line or
+                          // set to NO if Migration Manager should manage the timer
   Call @MigrationManagerOnLoad
   if mmIsMigrating
@@ Line 75: / Line 76: @@
 </code>
-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. A scripts unique id is used to identify other instances of this specific script even if other scripts using the Migration Manager are present. The id can be understood as „sender/receiver name or address“ of a script.
+==== 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/receiver name or address“ of a script, the Migration Manager only connects scripts with identical mmScriptId. A later change of the id for a script already in use is not  advisable as the data of older saved instances can no longer be imported.
 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 in new scripts using the Migration Manager Include Snippet:
+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 | |