Manual: Parameter Control Events

From OpenMPT Wiki
Jump to: navigation, search

Parameter Control Events (sometimes also referred to as “PC Events” or “PC Notes”) are meant as a straight-forward replacement for Zxx MIDI Macros for automating plugin parameters in the MPTM format. The key advantages over Zxx Macros are:

  • More parameters: The first 1,000 parameters of each plugin can be automated.
  • Increased granularity: The coarse 7-Bit automation range is extended to 1000 discrete values.
  • No complicated setup: There is no need to configure a Zxx macro and no restriction to sixteen macros.
  • Can be used anywhere: Parameter Control Events work anywhere in a pattern. No macro change command has to be called before executing a Parameter Control Event. They do not need to be placed on a specific channel to work, although it is generally recommended to reserve some extra channels in your patterns that you only use for automating plugin parameters — it simply looks more tidy and organised.

Parameter Control Events are entered into the pattern the same way as normal note events, but they always occupy a whole pattern cell:

Parameter Control Event.png

  • The note column indicates that this is a Parameter Control Event (instead of a normal Note Event). If there is no key assigned to Parameter Control Events in your keyboard map, you can also double-click the note column to open the Note Properties and change the note type to “PC” or “PCs”. There are two possible values for this column:
    • PC: Absolute setting. The specified parameter value is directly set on the first tick of the row.
    • PCs: Smooth parameter change. The specified parameter value is interpolated over the course of a whole row from the previous parameter setting.
  • The instrument column (xx) contains the plugin ID which can be obtained through the General Tab (in the Plugin section), from the Tree View or by right-clicking the pattern cell that holds the Parameter Control Event and choosing “Change Plugin”.
  • The volume column (yyy) contains the zero-based index of the parameter that should be controlled, in decimal notation. This, too, can be obtained from the General Tab (in the “Factory Preset” section) or by right-clicking the pattern cell that holds the Parameter Control Event and choosing “Change Plugin Parameter”.
  • The effect column (zzz) contains the parameter value, also in decimal notation. It ranges from 000 to 999.

Note that Parameter Control Events can be inserted into patterns automatically using the “Record Parameter Changes” option in the Plugin Window menu, or by setting up a MIDI Mapping.

You can use the Interpolate Effect command on a selection of Parameter Control events (any column). This will interpolate the parameter value (in the effect column) between the first and last event, replacing previous Parameter Control Event, filling in any blanks, and writing over note events.

You can delete the Parameter Control Event by entering a different note into the note column, or by pressing the delete shortcut key in the first column.