authoring. resync message.
This commit is contained in:
39
README.md
39
README.md
@@ -1,30 +1,53 @@
|
||||
# tc.preset
|
||||
|
||||
A [jsui] replacement for the [preset] object in Cycling'74 Max, with extra features:
|
||||
A [jsui] replacement for the [preset] object in Cycling'74 Max.
|
||||
|
||||
## Features
|
||||
- Drag and drop presets to re-organize
|
||||
- Display presets as a grid or a list
|
||||
- Scrollable
|
||||
- Scrollable (requires Max 8.6.2)
|
||||
- Shows active preset even if recalled directly from pattrstorage
|
||||
- Shows previously active preset, with the ability to ignore preset 0 if it being used as an intermediary step
|
||||
- Shows presets being interpolated (using recall or recallmulti)
|
||||
- Shows preset name and lock state
|
||||
- Outputs active preset name and lock state from third and fourth outlet
|
||||
- Ability to rewrite json file automatically every time a preset is stored/moved/deleted/renamed/(un)locked
|
||||
- Helps keeping in sync a umenu with the list of stored slotstlet
|
||||
- More look customization
|
||||
- Same click + modifier key behavior as the vanilla object to store or delete presets
|
||||
|
||||
## How to use
|
||||
- Place `tc.preset.js` in the same directory as your patch, or somewhere in the Max search path
|
||||
- Create a [jsui @filename tc.preset.js]. You can either add `@jsarguments` followed by the name of the pattrstorage you want to communicate with, or set that later by sending a `pattrstorage` (followed by the pattrstorage name) message to the [jsui].
|
||||
- Connect the [pattrstorage] outlet to the [jsui] pattrstorage inlet
|
||||
- Create a [`jsui @filename tc.preset.js`]. You can either add `@jsarguments` followed by the name of the pattrstorage you want to communicate with, or set that later by sending a `pattrstorage` (followed by the pattrstorage name) message to the [jsui].
|
||||
- Connect the [pattrstorage] outlet to the [jsui] inlet
|
||||
|
||||
## Limitations
|
||||
- Resize doesn't work in Presentation mode (jsui limitation)
|
||||
- Some messages should be sent to the pattrstorage, some other to the jsui:
|
||||
- `recall`: send to pattrstorage
|
||||
- `recallmulti`: send to pattrstorage first, then to the jsui (pattrstorage limitation)
|
||||
- `store`: send to jsui
|
||||
- Due to the way [pattrstorage] works, some pattrstorage-specific messages should be sent to the [jsui] instead of the [pattrstorage]. Some to both:
|
||||
- `recall`, `delete`: send to [pattrstorage] only
|
||||
- `recallmulti`, `slotname`: send to [pattrstorage] first (for better timing), then to the [jsui]
|
||||
- `store`: send to [jsui] only
|
||||
- The js program send a lot of message to the [pattrstorage] (patch cord not required), which makes it output a lot of messages required for the [jsui] to stay in sync. Using one of the above messages incorrectly, or sending `getslotlist`, `getslotnamelist`, or any message that will impact the presets, it might cause the [pattrstorage] to get out of sync. In case something like that happens, you can send the `resync` message to the [jsui].
|
||||
|
||||
|
||||
## Desired features (for someday)
|
||||
- No need for a patch cord (programmatically create a [send]/[receive] pair?)
|
||||
- Ability to lock/unlock and rename directly in the jsui without the need of external objects
|
||||
- Ability to target a [pattrstorage] in a different patcher level
|
||||
|
||||
## License
|
||||
GPL-3.0-or-later
|
||||
|
||||
Copyright (C) 2024 Théophile Clet <contact@tflcl.xyz> - https://tflcl.xyz.
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
See <https://www.gnu.org/licenses/gpl-3.0.txt>.
|
@@ -689,6 +689,10 @@ function read() {
|
||||
}
|
||||
}
|
||||
|
||||
function resync() {
|
||||
calc_rows_columns();
|
||||
}
|
||||
|
||||
function find_pattrstorage(name) {
|
||||
active_slot = 0;
|
||||
pattrstorage_obj = this.patcher.getnamed(name);
|
||||
|
@@ -45,7 +45,7 @@
|
||||
"maxclass" : "comment",
|
||||
"numinlets" : 1,
|
||||
"numoutlets" : 0,
|
||||
"patching_rect" : [ 850.0, 546.0, 150.0, 87.0 ],
|
||||
"patching_rect" : [ 850.0, 546.0, 153.0, 87.0 ],
|
||||
"text" : "Minimum number of slots to display when scrollable is enabled. If a preset is stored in a slot higher than that value, then it is ignored."
|
||||
}
|
||||
|
||||
@@ -153,7 +153,7 @@
|
||||
"maxclass" : "comment",
|
||||
"numinlets" : 1,
|
||||
"numoutlets" : 0,
|
||||
"patching_rect" : [ 858.0, 316.0, 185.0, 74.0 ],
|
||||
"patching_rect" : [ 858.0, 316.0, 188.0, 74.0 ],
|
||||
"text" : "Makes displayed previous active slot and interpolation status to ignore slot 0. Can be usefull when using slot 0 as a temporary step for interpolation."
|
||||
}
|
||||
|
||||
@@ -517,7 +517,7 @@
|
||||
"maxclass" : "comment",
|
||||
"numinlets" : 1,
|
||||
"numoutlets" : 0,
|
||||
"patching_rect" : [ 527.0, 665.0, 65.0, 20.0 ],
|
||||
"patching_rect" : [ 523.0, 665.0, 65.0, 20.0 ],
|
||||
"text" : "For testing"
|
||||
}
|
||||
|
||||
@@ -855,7 +855,7 @@
|
||||
, {
|
||||
"box" : {
|
||||
"id" : "obj-8",
|
||||
"items" : "0 (tmp)",
|
||||
"items" : "<empty>",
|
||||
"maxclass" : "umenu",
|
||||
"numinlets" : 1,
|
||||
"numoutlets" : 3,
|
||||
@@ -944,8 +944,8 @@
|
||||
, {
|
||||
"box" : {
|
||||
"border" : 0,
|
||||
"embedstate" : [ [ "fontsize", 14 ], [ "displayinterp", 1 ], [ "fontname", "Arial" ], [ "stored_slot_color", 0.502, 0.502, 0.502, 1 ], [ "scrollable", 1 ], [ "layout", 1 ], [ "interp_slot_color", 1, 1, 1, 0.8 ], [ "bubblesize", 20 ], [ "spacing", 4 ], [ "min_rows", 10 ], [ "text_bg_color", 1, 1, 1, 0.5 ], [ "autowriteagain", 0 ], [ "empty_slot_color", 0.349, 0.349, 0.349, 1 ], [ "bgcolor", 0.2, 0.2, 0.2, 1 ], [ "text_color", 0.129, 0.129, 0.129, 1 ], [ "ignoreslotzero", 1 ], [ "margin", 7 ], [ "slot_round", 0 ], [ "active_slot_color", 0.808, 0.898, 0.91, 1 ] ],
|
||||
"filename" : "preset.better.js",
|
||||
"embedstate" : [ [ "fontsize", 14 ], [ "displayinterp", 1 ], [ "fontname", "Arial" ], [ "stored_slot_color", 0.502, 0.502, 0.502, 1 ], [ "scrollable", 1 ], [ "layout", 1 ], [ "interp_slot_color", 1, 1, 1, 0.8 ], [ "bubblesize", 20 ], [ "spacing", 4 ], [ "min_rows", 50 ], [ "text_bg_color", 1, 1, 1, 0.5 ], [ "autowriteagain", 0 ], [ "empty_slot_color", 0.349, 0.349, 0.349, 1 ], [ "bgcolor", 0.2, 0.2, 0.2, 1 ], [ "text_color", 0.129, 0.129, 0.129, 1 ], [ "ignoreslotzero", 1 ], [ "margin", 4 ], [ "slot_round", 0 ], [ "active_slot_color", 0.808, 0.898, 0.91, 1 ] ],
|
||||
"filename" : "tc.preset.js",
|
||||
"id" : "obj-10",
|
||||
"jsarguments" : [ "test" ],
|
||||
"maxclass" : "jsui",
|
||||
@@ -978,15 +978,15 @@
|
||||
"numinlets" : 1,
|
||||
"numoutlets" : 3,
|
||||
"outlettype" : [ "", "", "" ],
|
||||
"patching_rect" : [ 459.0, 664.0, 52.0, 22.0 ],
|
||||
"patching_rect" : [ 464.5, 664.0, 40.0, 22.0 ],
|
||||
"restore" : [ -0.857142857142857, -0.228571428571429, 0.314285714285714, 0.314285714285714, -0.171428571428571, -0.714285714285714, -0.942857142857143, 0.142857142857143, 0.485714285714286, 0.314285714285714, -0.057142857142857, -0.457142857142857, -0.771428571428571, -0.971428571428571, -1.0, -0.8 ],
|
||||
"saved_object_attributes" : {
|
||||
"parameter_enable" : 0,
|
||||
"parameter_mappable" : 0
|
||||
}
|
||||
,
|
||||
"text" : "pattr oui",
|
||||
"varname" : "oui"
|
||||
"text" : "pattr",
|
||||
"varname" : "u099005226"
|
||||
}
|
||||
|
||||
}
|
||||
@@ -1369,8 +1369,8 @@
|
||||
}
|
||||
],
|
||||
"dependency_cache" : [ {
|
||||
"name" : "preset.better.js",
|
||||
"bootpath" : "~/Documents/_MAX/pattrstorage_helper",
|
||||
"name" : "tc.preset.js",
|
||||
"bootpath" : "~/Documents/_MAX/tc.preset",
|
||||
"patcherrelativepath" : ".",
|
||||
"type" : "TEXT",
|
||||
"implicit" : 1
|
||||
|
Reference in New Issue
Block a user