Potmeter

Potmeter Rotation

potmeter_number

• shortname: pnu
• How: self:potmeter_number() or self:potmeter_number(number)
  • number: signed integer
• What: This function when given no parameter, returns the # number of the control element. These numbers are from the top left, read left to right, top to bottom 0 to 15 OR in the case of the PBF4 from 0 to 11. When this function is given a parameter, it will set the # number of the control element to the number given.
• Example:

potmeter_value

• shortname: pva
• How: self:potmeter_value() or self:potmeter_value(value)
  • value: integer, ranging 0...127
• What: This function returns the value of the potentiometer state. By default, this value is 0 when the potentiometer is set in the minimum position, and tops out at 127. When this function is given a parameter, it will set the value associated with the potentiometer state according to the parameter given and will output that value on each trigger.
• Example:

potmeter_min

• shortname: pmi
• How: self:potmeter_min() or self:potmeter_min(value)
  • value: integer, ranging 0...127
• What: This function returns the minimum value configured to the potentiometer minimum state. This is 0 by default. When given a parameter, this function changes the minimum value of the potentiometer state according to the value given as parameter.
• Example: The code self:potmeter_min(30) will set the potentiometer value minimum to 30.

potmeter_max

• shortname: pma
• How: self:potmeter_max() or self:potmeter_max(value)
  • value: integer, ranging 0...127
• What: This function returns the maximum value configured to the potentiometer maximum state. This is 127 by default. When given a parameter, this function changes the maximum value of the potentiometer state according to the value given as parameter.
• Example: The code self:potmeter_max(100) will set the potentiometer value maximum to 100.

potmeter_resolution

• shortname: pmo
• How: self:potmeter_resolution() or self:potmeter_resolution(bitdepth)
  • bitdepth: integer, ranging 4...12
• What: This function returns the value of the potentiometer mode. This is7 by default. This means that the number of steps between maximum and minimum values will be 2 to the power of 7 or 128. When given a parameter, this function sets the 'steps' between the minimum and maximum value according to the bitdepth given. For example setting it to 2 makes the potentiometer have 2 to the power of 4 or 16 steps.
• Example: The code self:potmeter_resolution(11) will make the potentiometer have 2048 steps. But be careful, if you don't increase the minimum and maximum potentiometer values, this "resolution" increase won't really show in usage. Increasing potmeter resolution could be useful for using 14-bit MIDI usage.

potmeter_elapsed_time

• shortname: pel
• How: self:potmeter_elapsed_time()
• What: This function returns the time elapsed since the last trigger in frames.
• Example:

potmeter_state

• shortname: pst
• How: self:potmeter_state()
• What: This function will return the "state" of the control element.
• Example: