From 4fbeb1e3bd9176aba5915b1d9f736a249c3db5d7 Mon Sep 17 00:00:00 2001 From: mkp Date: Fri, 26 Sep 2025 11:43:40 +0200 Subject: [PATCH 1/2] M4L production guidelines: add a section about parameter modulation --- m4l-production-guidelines/m4l-production-guidelines.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/m4l-production-guidelines/m4l-production-guidelines.md b/m4l-production-guidelines/m4l-production-guidelines.md index 2d74177..90a732f 100644 --- a/m4l-production-guidelines/m4l-production-guidelines.md +++ b/m4l-production-guidelines/m4l-production-guidelines.md @@ -157,6 +157,14 @@ The **Custom** Unit Style allows adding a custom unit in the **Custom Units** fi > If you don't want a parameter's automation lane to show as a grid but you do want its value to display as an integer without decimals _and_ you want to use a percentage sign as its unit, it is possible to set a parameter's **Type** to **Float** while setting its **Unit Style** to **Custom** and its **Custom Units** to `"%.0f %"`. +### Modulation + +For Clips in Session Mode, in the Clip View with the Envelopes section active, Automation movements can be drawn in the clip. If a parameter has a modulation mode configured it can additionally be controlled with Modulation. Clip Modulation works both in Session Mode and in Arrangement Mode. Note that in Arrangement Mode, only devices with one or more modulatable parameters will show up in the Clip's Envelopes section. + +By default, modulation is disabled for parameter objects in Max. However, to be feature complete you will want to choose a modulation mode for your parameters, depending on their Parameter Type and their role in your device. + +For parameter objects, you can set the **Clip Modulation Mode** in the Inspector under the **Parameter** properties. At Ableton, we usually choose **Bipolar** mode for Float type parameters and **Absolute** mode for Int type parameters, but you can also choose **Unipolar** or **Additive** modes. For more about modulation modes and how they behave exactly, see [Parameter Modulation](https://docs.cycling74.com/userguide/m4l/live_parameters/#parameter-modulation). + ### Saving Parameters Usually, users of Max for Live devices expect all devices parameters to be **stored and recalled correctly** with the Live Set or Live preset, otherwise the device is of limited use when customized. @@ -512,7 +520,7 @@ Note: many of these things can be checked and changed in the View > Parameters w - [ ] Automation: The parameter dropdown for a device contains all intended automatable parameters. - [ ] Value editing: Parameter Types and Units correspond to the kind of data being represented, taking into account that using the Int type gives users a tall grid automation lane. - [ ] Enum labels: Unit / labels of automation for Enum parameters don't have generic values ("val1"/"val2" for buttons). -- [ ] Modulation: All parameters have modulation active. +- [ ] Modulation: All parameters have a modulation mode set. Bipolar for Float, Absolute for Int, or different if you prefer. - [ ] Defaults: All default parameter values are correct, i.e. the device works well after newly instantiating it. - [ ] Save and recall: All parameters are recalled correctly when opening a Live Set that contains the device with non-default values for all parameters. - [ ] Push: The parameters show up correctly on Push. From 17e5c1f16f098eb4483b2beb2639b004c83e5687 Mon Sep 17 00:00:00 2001 From: mkp Date: Mon, 29 Sep 2025 12:47:15 +0200 Subject: [PATCH 2/2] =?UTF-8?q?Change=20=E2=80=9CSession/Arrangement=20Mod?= =?UTF-8?q?e=E2=80=9D=20to=20=E2=80=9CSession/Arrangement=20View=E2=80=9D?= =?UTF-8?q?=20as=20per=20pvo=E2=80=99s=20suggestion?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- m4l-production-guidelines/m4l-production-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/m4l-production-guidelines/m4l-production-guidelines.md b/m4l-production-guidelines/m4l-production-guidelines.md index 90a732f..fffc41e 100644 --- a/m4l-production-guidelines/m4l-production-guidelines.md +++ b/m4l-production-guidelines/m4l-production-guidelines.md @@ -159,7 +159,7 @@ The **Custom** Unit Style allows adding a custom unit in the **Custom Units** fi ### Modulation -For Clips in Session Mode, in the Clip View with the Envelopes section active, Automation movements can be drawn in the clip. If a parameter has a modulation mode configured it can additionally be controlled with Modulation. Clip Modulation works both in Session Mode and in Arrangement Mode. Note that in Arrangement Mode, only devices with one or more modulatable parameters will show up in the Clip's Envelopes section. +For Clips in Session View, in the Clip View with the Envelopes section active, Automation movements can be drawn in the clip. If a parameter has a modulation mode configured it can additionally be controlled with Modulation. Clip Modulation works both in Session View and in Arrangement View. Note that in Arrangement View, only devices with one or more modulatable parameters will show up in the Clip's Envelopes section. By default, modulation is disabled for parameter objects in Max. However, to be feature complete you will want to choose a modulation mode for your parameters, depending on their Parameter Type and their role in your device.