ParamGet

Overview

Gets parameters in other modules

Discussion

The ParamGet module gets the value of a parameter from another module.

At instantiation time (or in Module Name and Arguments in Audio Weaver Designer), you specify the data type of the input pin and also the variable which will be fetched. The variable is specified as

Mod.Var

where Mod is the name of the module (in the same level of the hierarchy as the ParamGet module) and Var is the variable name. You can also specify modules that are within subsystems using

Subsystem.Mod.Var.

You can also go up in hierarchy and get parameters from modules that are in an upper system. Use a single backslash character to move up one level in the hierarchy. Use multiple backslash characters to traverse multiple levels of hierarchy. Suppose that the ParamGet module is located in:

SYS.Subsystem.ParamGet

and you want to get the variable

SYS.Scaler1.gain

Then set the Mod.Var field to

\Scaler1.gain

And finally, you can also get individual values from arrays using the syntax

Mod.Var[index]

where index is the zero-based index of the element in the array Var to get.

The Mod.Var argument can also be resolved using objectAlias instead of relative path. See the Advanced Module Features | ObjectAlias section for further discussion.

The argument executionOrder determines when the param get will actually execute in relation to the target module:

        Undefined = Let the build process decide

        Before = Set the parameter before the target module executes

        After = Set the parameter after the target module executes

This can be confirmed by generating a .AWS file and looking at the order which the modules are added to the layout, which set the execution order.

Module Pack

Standard

ClassID

classID = 170

Type Definition

typedef struct _ModuleParamGet
{
ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
void * modPtr;                                // Points to the module to get
void * varPtr;                                // Points to the variable to get within the module instance structure
} ModuleParamGetClass;

Variables

Properties

Name	Type	Usage	isHidden	Default Value	Range	Units
modPtr	void *	parameter	1		Unrestricted
varPtr	void *	parameter	1		Unrestricted

Pins

Output Pins


Name	out
Description	parameter value
Data Type	float

Matlab Usage

File Name: param_get_module.m 
 M=param_get_module(NAME, DATATYPE, MODVAR) 
 Parameter get module.  This module can reach into the instance structure 
 of other modules and gets the parameter values.  Arguments: 
    NAME - name of the module. 
    DATATYPE - string specifying the data type of the variable and  
               also used for the data type of the input pin. Allowable 
               values are 'float', 'int', or 'fract32'. Implicit casts from  
               'int' to 'uint' variables allowed, but take caution to avoid  
               passing out of range values. 
    MODVAR - specifies the module and variable name using the form: 
              'MOD.VAR' where MOD is the module name and VAR is the  
              variable name.  You can also specify internal subsystems using 
              'SUBSYS.MOD.VAR'. 
    EXECUTIONORDER - Determines when the ParamSet module executes relative 
                     to the module it is controlling.  Allowable values are: 
                     'undefined' - the default.  The execution order is set 
                                   by the routing algorithm and can occur before 
                                   or after the module it is controlling. 
                     'before' - forces ParamSet to execute before the module it 
                                is controlling. 
                     'after' - forces ParamSet to execute after the module it 
                                is controlling. 
                     When using 'before' and 'after' you could get a build error 
                     indicating that no more modules can execute or there is a  
                     circular dependency.