Difference between revisions of "AnyWave:WriteMatlabScripted"
(→AwGetInputChannels()) |
(→AwGetInputChannels()) |
||
| Line 44: | Line 44: | ||
<br/> | <br/> | ||
'''AwGetInputChannels()''' will request the list of input channels for the plug-in. No parameters are required.<br/> | '''AwGetInputChannels()''' will request the list of input channels for the plug-in. No parameters are required.<br/> | ||
| − | AnyWave will send back a structure array containing Matlab structures which match structure defined by the '''AwChannel()''' function.<br/> | + | AnyWave will send back a structure array containing Matlab structures which match the structure defined by the '''AwChannel()''' function.<br/> |
'''AwChannel()''' is provided by AnyWave to easily create a Matlab structure which will be compatible with AnyWave's channels objects.<br/> | '''AwChannel()''' is provided by AnyWave to easily create a Matlab structure which will be compatible with AnyWave's channels objects.<br/> | ||
<br/> | <br/> | ||
This function is usefull if you want to get input the channels' informations without requesting for data.<br/> | This function is usefull if you want to get input the channels' informations without requesting for data.<br/> | ||
| + | |||
| + | Let's try it in our main function for our plug-in:<br/> | ||
Revision as of 14:27, 17 April 2014
Introduction
This section targets people who have a good knowledge and practice of Matlab language.
The purpose is to explain how to write a Matlab function that will be available to AnyWave.
The function will be executed by MATLAB after a connection to AnyWave has been established.
We will cover the AnyWave-Matlab API (Application Programming Interface) and develop examples through tutorials.
Where to start?
The first thing to do is to create the basic structure for a plug-in.
A Matlab Scripted plug-in is very simple, it is a folder containing at least two files.
Let's begin by creating a folder somewhere on the computer, called MyPlugin.
This can be done in MATLAB: create a folder and create a new function called main in that folder.
The main function is MANDATORY. It will be the main function AnyWave will call to execute our plugin.
As shown in the image above, a MyPlugin folder has been created and a main function was added.
We are now ready to write our first Matlab plug-in but before doing that we need to cover all the MATLAB functions provided by AnyWave.
Indeed, to get or put data from/to AnyWave, special functions are provided.
We can call that set of functions the AnyWave-MATLAB API.
AnyWave-Matlab functions
The table below shows a summary of all matlab functions available when writing a Matlab Scripted plug-in:
Function parameters placed between <> are optional.
| Function | Short description |
|---|---|
| AwGetInputChannels() | Get current input channels set by AnyWave for the plug-in. |
| AwGetData(start, duration, <filtering>, <filteringOptions>) | Get the data of the current input channels. |
| AwGetWorkingDir() | Get the full path to a temporary directory created by AnyWave for the plug-in. |
| AwGetFilePath() | Get the full path of the current open data file in AnyWave. |
| AwAddMarker(value, position, duration, <targeted channels>) | Add a marker in AnyWave. |
| AwSendMessage(message) | Send a message to AnyWave. The message will be added to the plug-in's log. |
AwGetInputChannels()
AnyWave uses channels to represent signals on screen but also as its internal data set.
When a plug-in is launched by AnyWave, a set of input and/or output parameters is defined.
AwGetInputChannels() will request the list of input channels for the plug-in. No parameters are required.
AnyWave will send back a structure array containing Matlab structures which match the structure defined by the AwChannel() function.
AwChannel() is provided by AnyWave to easily create a Matlab structure which will be compatible with AnyWave's channels objects.
This function is usefull if you want to get input the channels' informations without requesting for data.
Let's try it in our main function for our plug-in:
