Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The text-based commands may also be generated by external tools and scripts rather than by AWE Designer. An example script, written in Python 3.11, is shown below. This script connects to the AWE Server at TCP port 15007 (to bypass port 15001, which AWE Designer GUI uses) and reads and writes the ScalerDBControl module’s currentGain variable in an active layout in real-time. The remainder of this document describes the full set of tuning commands and arguments.

The AWD which works with this script is attached below. Load this into Audio Weaver, then build and run the layout. The script has been tested with Python versions 2.7 and 3.11.

View file
nameTuning-API-Test.awd

...

All commands may fail for reasons not to do with the command. If the target crashes, or the link goes down, you may get a reply failed“failed,reason explaining what failedfailed”. Most commonly, these will be:

...

The flags argument is no longer used. It is retained for backwarsd backwards compatability, supply zero.

...

If the height or width are negative (usefully usually –1), then only the [top,left] position is used – the size of the rectangle is obtained from the image; otherwise the image is stretched or shrunk as needed in both axes to fit the rectangle specified.

...

ScriptFile may be commands instead of a filename, ; those commands are:

RemoveControls – deletes all the controls on a dialog

...

readonly=val – 0 or 1, default 0; – when set, prevents the user changing the selection

...

caption – specifies the caption to appear above the drop list control

attributes – a string of attribute attributes controlling the appearance of the combo box control

...

readonly=val – 0 or 1, default 0; when set, prevents the user changing the selection

...

readonly=val – 0 or 1, default 0; when set, prevents the user changing the selection

...

readonly – 0 or 1, default 0; when set, prevents the user editing the value

...

Creates an LED control. If the value described by dot-expression is non-zero, the LED is shown bright green, otherwise dark green. The expression is evaluated every 200mSec200 msec.

create_lookup

Syntax:

create_lookup, maxId

...

Creates a meter control. The value described by dot-expression is evaluated every 200mSec200 msec, and used to update the appearance of the meter.

...

The path to search is specified in the server INI file. The implied '.' (server working directory - always the directory containing the server executable binary) is always searched first. Due to this if If files are placed there, the search path need not be specified.

...

Brings Audio Weaver Server window to the foreground (top most in Z-order). Make Makes the window visible if it were was behind other windows.

On success, the reply is:

...

For more about binary packets, including a detailed list of available commands, see AWE Core Tuning Command Syntax and Protocol.