SourceProperties

Overview

Source buffer holding 1 wire of data

Discussion

The source module has an internal buffer holding 1 output wire's worth of floating point data. The module continuously copies the data from the internal value buffer to the output wire. Since this is a source module, you must specify the number of channels, blockSize, and sample rate of the output pin.

The module also supports real and complex data. For complex data data, set the .value field to complex data in MATLAB. On the target, complex data is stored in interleaved fashion: real, imag, real, etc.

Additionally, this module makes the wire information available as internal variables. Block size, channel number, sample rate and signal complexity can be accessed in MATLAB code, source code, or in a layout using the ParamGet module.

Type Definition

CODE

typedef struct _ModuleSourceProperties
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    INT32 BlockSize;                              // Block Size
    INT32 NumChannels;                            // Number of Channels
    INT32 SampleRate;                             // Sample Rate
    INT32 IsComplex;                              // Is Complex
    FLOAT32* value;                               // Array of interleaved audio data.
} ModuleSourcePropertiesClass;

Variables

Properties

Name	Type	Usage	isHidden	Default value	Range	Units
BlockSize	int	const	0	16	Unrestricted
NumChannels	int	const	0	2	Unrestricted
SampleRate	int	const	0	48000	Unrestricted
IsComplex	int	const	0	0	Unrestricted
value	float*	parameter	0	[16 x 2]	Unrestricted

Pins

Output Pins

Name: out

Description: output data

Data type: float

MATLAB Usage

File Name: source_properties_module.m

CODE

 M=source_properties_module(NAME, NUMCHANNELS, BLOCKSIZE, SAMPLERATE, ISCOMPLEX)
 Creates a source module that allows you to inject test data into
 the audio processing layout.  
 
 Arguments:
    NAME - name of the module.
    NUMCHANNELS - number of interleaved channels in each output pin.
         By default, NUMCHANNELS=1;
    BLOCKSIZE - number of samples per output channel. By default,
         BLOCKSIZE=32.
    SAMPLERATE - sample rate of the output signal in Hz. By default,
         SAMPLERATE=48000.
    ISCOMPLEX - Boolean indicating whether the output holds complex data.
         By default, ISCOMPLEX=0.