SIGVIEW supports various command-line parameters enabling you to use some SIGVIEW functions from external applications or batch files. Since this feature is based on a simple command-line invocation, it can be used from any other programming language or environment capable of using command-line system calls.
This feature allows you to start a new SIGVIEW instance with specific parameters, but even more importantly, it allows you to pass commands to the already running SIGVIEW instance. This provides a powerful remote control API which can be used to automate many analysis procedures. Simply, if a SIGVIEW instance is already running and you issue a command-line call (e.g. "SIGVIEW.exe <action> <parameters>"), it will not start new SIGVIEW instance but pass the parameters to the already running instance which will execute it.
Typical application examples for command-line invocation would be to perform the same analysis on many different files or to perform some live signal analysis according to a time schedule.
General syntax of command-line invocation is of the form:
SIGVIEW.exe <action> <parameters>
Each command invocation checks if there is already a SIGVIEW instance running and if yes, sends a command to it. Otherwise, a new SIGVIEW instance is started and executes the command. To make calling SIGVIEW.exe easier, you can use environment variable SIGVIEW_EXE which contains the full path of the SIGVIEW executable. For example, in a batch file it would look like this:
%SIGVIEW_EXE% <action> <parameters>
Instead of providing a single function for each analysis feature in SIGVIEW, the command-line interface is based on creating and reusing SIGVIEW workspace files (SWS). This means that you will always create a workspace file first, containing the basics of analysis you would like to control remotely. For more details about creating and using SWS files, please proceed here. The first command you will use will probably be loading of the SWS file, for example:
%SIGVIEW_EXE% -loadsws c:\myworkspace.sws
After the SWS has been loaded, you will be able use various commands to start/stop analysis, save data to a file etc. For example, to save content of a window to a 16-bit WAV file, you would use:
%SIGVIEW_EXE% -savewav16 window1 "c:\my dir\file1.wav"
To be able to reference single windows from your workspace, as "window1" in the above example, you have to assign those a new window name before saving your SWS file. This is done by using the "Edit/Change Window title" menu option. Instead of a default window name, assign the window a name which describes its usage well and can be used in command line calls, for example "daq window", "myfft1" or "result".