64 lines
3.7 KiB
Markdown
64 lines
3.7 KiB
Markdown
# tc.preset
|
|
|
|
A [jsui] replacement for the [preset] object in Cycling'74 Max.
|
|
|
|
## Features
|
|
- Same click + modifier key behavior as the vanilla object to store and delete presets
|
|
- Drag and drop presets to re-organize
|
|
- Display presets as a grid or a list
|
|
- Scrollable list layout (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
|
|
- Dynamically adapts to resize both in Edit and Presentation mode
|
|
- Select mode: simple click selects the slot, double click recalls it (allows for organizing presets without recalling them)
|
|
- Color mode: various ways to colorize preset slots
|
|
|
|
## How to install
|
|
- [Download](https://github.com/Teufeuleu/tc.preset/archive/refs/heads/main.zip) this repository (and please consider donating on the [gumroad page](https://glucose47.gumroad.com/l/tc_preset) if you like this package)
|
|
- Unzip the downloaded file and place the tc.preset folder in your Max Library package.
|
|
- Restart Max
|
|
|
|
## How to use
|
|
- In your Max patch, reate a [`tc.preset`] object (or a more lenghty [`jsui @filename tc.preset.js`])
|
|
- Connect the [pattrstorage] outlet to the [jsui] inlet
|
|
- Set the jsui attribute named "pattrstorage" to the name of the pattrstorage you just connected (or send a message like "pattrstorage my_pattrstorage_name")
|
|
|
|
|
|
## Limitations
|
|
- Due to the way [pattrstorage] works, some pattrstorage-specific messages should be sent to the [jsui] instead of the [pattrstorage]. Some to both:
|
|
- `recall`: send to [pattrstorage] only
|
|
- `recallmulti`, `slotname`: send to [pattrstorage] first (for better timing), then to the [jsui]
|
|
- `store`: send to [jsui] only
|
|
- Some messages to pattrstorage causes the jsui to be out of sync (`insert`, `lockall`, `read`, `readagain`, `remove`, `renumber`). If you use any of these messages, make sure to then send a `resync` to the jsui.
|
|
- The js program send a lot of message to the [pattrstorage] (using `maxobj.message()`syntax, so without patch cord), which in return send (using a patch cord) 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 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, if ever)
|
|
- 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
|
|
|
|
## Known bugs
|
|
- With slot_round > 0, interpolation visualization is a bit wacky
|
|
|
|
## 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>. |