Preferences and Layout
Global Preferences
To apply custom Audio Weaver Designer settings, use the Global Preferences menu at ‘File → Global Preferences’.
![](../../__attachments/2984838731/image-20221230-002245.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Minimize Target Reads and Writes
Minimize Target Reads and Writes is an optional feature of AWE Designer, and can be enabled/disabled with the “Minimize target reads and writes” checkbox in AWE Designer → Global Preferences. It is disabled by default.
![](../../__attachments/2984838731/image-20230221-181308.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
When Minimize target reads and writes is disabled, AWE Designer uses the Tuning Interface to query a target for every module and its variables in the running layout, every time a change is made. This ensures that the canvas / target stay in sync throughout tuning, but also increases the traffic on the tuning interface.
With Minimize Target Reads and Writes enabled, AWE Designer will used cached module variable values on the canvas, as opposed to querying the target. This significantly reduces the number of commands sent by the Tuning Interface, but could cause the Canvas/target to be inaccurate and out of sync.
Minimize target reads and writes can be very useful on targets with limited communication/tuning capabilities.
Generate LST Files on Save
LST files provides a high level, human readable overview of a saved AWE layout. They are a good way to diff variables and arrays between different designs.
If enabled, a corresponding LST file is automatically generated/updated each time a layout is Saved in Designer. LST file generation is disabled by default, and can be enabled by selecting the “Generate LST file on save” checkbox in AWE Designer->Global Preferences .
![](../../__attachments/2984838731/image-20230221-184148.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Here is an example LST file generated from this passthrough layout.
----------------------------------------------------------------------
TopLevel,NewClass,active
blockSize: 32
numInChannels: 2
numOutChannels: 2
sampleRate: 48000
----------------------------------------------------------------------
SYS_deint,Deinterleave,active
SYS_toFloat.out --> in out1 --> SYS_inter.in1
out2 --> SYS_inter.in2
numOut: 2
----------------------------------------------------------------------
SYS_inter,Interleave,active
SYS_deint.out1 --> in1 out --> SYS_toFract.in
SYS_deint.out2 --> in2
numIn: 2
----------------------------------------------------------------------
SYS_toFloat,TypeConversion,active
.SYS_in --> in out --> SYS_deint.in
outType: 0
----------------------------------------------------------------------
SYS_toFract,TypeConversion,active
SYS_inter.out --> in out --> .SYS_out
outType: 1
Native Audio Settings
The AWE Server → File → “Native Audio Settings” menu allows a user to customize PC audio settings when running AWE in Native mode.
Using the dropdown menu, users can select between DirectX and ASIO drivers. All available Input and Output devices will be shown, and the user can check/uncheck the toggle boxes to enable or disable certain devices. The user can also set the default hardware sample rate for both DirectX and ASIO, as well as additional ASIO specific parameters (block size, ASIO device).
Note: If ASIO drivers are not installed on the PC, then the ASIO option will not appear in the dropdown selector.
AWE Server keeps a tally of how many channels are currently enabled on the input and output, displaying the total counts in the text field to the right of device selector boxes. The input channels will be interleaved at the input pin of an Audio Weaver layout, and then back out at the output pin.
![The Native Audio Settings menu, showing the DirectX - ASIO dropdown selector. DirectX is currently selected, and multiple audio input and output devices are available.](../../__attachments/2984838731/image-20230223-155918.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Native Audio Settings menu, showing DirectX/ASIO dropdown. DirectX is selected, and a variety of Input and Output devices are available to enable/disable.
![](../../__attachments/2984838731/image-20230223-160059.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Native Audio Settings menu with all available DirectX input and output devices enabled. Note the increase in channel count vs the prior screenshot, where only one audio device is enabled. Also note the decrease in sample rate. This is because one of the selected input devices has a max SR of 16000, so all other devices conform to that max.
![](../../__attachments/2984838731/image-20230223-145811.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Native Audio Settings with ASIO selected. Note the extra ASIO specific configuration parameters (ASIO device, ASIO block size)
Loop-Back
Audio loopback can be a useful tool to route audio between different applications on the same PC. For instance, the audio output from a layout created in Designer and running on the Native target can be used as the input for a Digital Audio Workstation (DAW) such as Audacity. In Windows, a 3rd party application that implements audio loopbacks is required. In the example below, Virtual Audio Cable (VAC) is used, but there are many other options available.
Note: Loopback devices are only supported when connected to the Native target
To use audio loopback devices, select the loopback input and/or output devices in the Native Audio Settings menu (Line 1 (Virtual Audio Cable)) in the image below. In this example, the output from Designer will be routed to Audacity, so only the output VAC is selected. Click Save to apply the selection.
In Designer, open a new canvas and implement a layout similar to the one below, with generated stereo audio being output to the first two channels of the VAC.
Layout Properties Menu
The layout properties dialog provides information about your layout and along with some control over how the layout behaves. To edit your layout’s properties, navigate to ‘Layout → Layout Properties’ from the top banner of Audio Weaver.
![](../../__attachments/2984838731/image-20221230-002236.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
The top section includes information about the current layout. The next section allows the user to control whether the input data source and output data destination is a file or an audio device. The following section provides control of AWS file generation and some extra error checking on the output pin. The AWS file will be generated in the same folder as the current AWD file. If "Validate System Output pin" is checked, then the system checks if the inherited output pin properties fall within the specified ranges for the attached hardware output pin. The final section “Protect Layout” allows the entire layout to be locked from editing.
Managing the Canvas
The AWE Designer Canvas consists of pages. You can change your drawing space using the “Layout → Canvas Size” menu.
![](../../__attachments/2984838731/image-20221230-002544.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
![](../../__attachments/2984838731/image-20221230-002601.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Note: The canvas size is limited to 10x5. The zoom and align toolbar icons can be used to change your view and to easily organize your modules.
Setting Search Paths
Audio Weaver Designer comes with a few default search paths for Audio and Modules. You can add additional search paths for both modules and files (audio files, etc) via Designer.
The reason to update a module search path would be if you have created your own custom module. To add additional Module Search Paths, select File-> Set Module Path.
![](../../__attachments/2984838731/image-20221214-232617.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Module Browser/Palette
The Module Browser allows filtering by a few different parameters. You can filter the Module Browser list via data type by selecting/deselecting the boxes above the browser and under the search bar. The browser will only show modules with datatypes that match the selected boxes. For instance, if a user is not interested in any fract32 modules, they could deselect the box and see only float/int modules.
The image below shows the “Gain” modules of all data types.
![](../../__attachments/2984838731/image-20221214-232624.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
The next image shows the same “Gain” category but without fract32 modules. Notice that the list is significantly shorter.
![](../../__attachments/2984838731/image-20221214-232630.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
If you know the name or a keyword of the desired module, you can also use the search bar to filter the available modules.
By default, the module browser will filter out deprecated modules and missing modules (not present on the connected target). To toggle these filters, open the Designer File->Global Preferences dialog and toggle the “Show deprecated modules” checkbox. Beneath the checkbox, there is also a dropdown menu which provides the option to show all modules, filter by target, or filter by ModuleList.h (see below). Deprecated modules will appear in the browser with a yellow exclamation mark overlay, and missing modules with a red x.
![](../../__attachments/2984838731/image-20221214-232655.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
![](../../__attachments/2984838731/image-20221214-232704.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)
Note: The image above was captured while connected to a target which does not contain the advanced module pack, therefore InvertN is missing.
An advanced feature is the ability to specify a specific ModuleList.h file as module filter. Any modules not in the specified list will appear on the canvas outlined in red.
![](../../__attachments/2984838731/image-20221214-232741.png?inst-v=afeb83b1-861e-46b8-b4de-1c642321bb7f)