RATC controlSet command

Usage

The controlSet command is used to set the value of a Control Group in a compiled View File. For example:

controlSet "Main Gain" -3.4\r

Response

On success, RATC responds with:

valueIs "Main Gain" -3.40dB 61.5%\r\n

The Control Group name is enclosed in quotes to support names with embedded spaces. In fact, the quotes are not required for the command argument if the Control Group name has no embedded spaces.

In the response, the first token after the Control Group name is the current value expressed in the units appropriate to that particular Control Group. If the Control Group in question contains more than one control, and they are of different types, the units used will correspond to the units of the first control in the group.

In the response, the second token after the Control Group name is the current value of the Control Group expressed as a percentage of the maximum value. This can be thought of as a physical knob position - in this example, the 61.5% knob position corresponds to -3.4dB, and a 100% knob position will correspond to +12dB.

Possible Error Messages

\aBadArgumentCount\r\n

\aOverflow\r\n

\aUnlistedGroup "GroupName"\r\n

\aNotRunning\r\n