IviSpecAn_AddTraces
IviSpecAnMultitrace Capability Group
C Function Prototype
ViStatus IviSpecAn_AddTraces (ViSession vi, ViConstString destinationTrace, ViConstString trace1, ViConstString trace2);
Purpose
This function adds trace 1 and trace 2, point by point, and stores the results in the destination trace. Any data in the destination trace is deleted.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The ViSession handle that you obtain from the IviSpecAn_init or IviSpecAn_InitWithOptions function. The handle identifies a particular instrument session. Default Value: None |
| destinationTrace | ViConstString | Pass the trace name into which the added traces are stored. Any data in the destination trace is overwritten.
This control accepts either a virtual repeated capability name or an instrument-specific trace name. Virtual repeated capability names are aliases for instrument-specific trace strings. The instrument-specific trace strings can differ from one instrument to another. Virtual repeated capability names allow you to use and swap instruments without having to change the trace names in your source code. You specify virtual repeated capability names in MAX. Default Value: "" Note: You can specify the trace name as a string variable or as a literal enclosed in double quotes. |
| trace1 | ViConstString | Pass the trace name of one of the two traces to be added.
This control accepts either a virtual repeated capability name or an instrument-specific trace name. Virtual repeated capability names are aliases for instrument-specific trace strings. The instrument-specific trace strings can differ from one instrument to another. Virtual repeated capability names allow you to use and swap instruments without having to change the trace names in your source code. You specify virtual repeated capability names in MAX. Default Value: "" Note: You can specify the trace name as a string variable or as a literal enclosed in double quotes. |
| trace2 | ViConstString | Pass the trace name of the second trace to be added.
This control accepts either a virtual repeated capability name or an instrument-specific trace name. Virtual repeated capability names are aliases for instrument-specific trace strings. The instrument-specific trace strings can differ from one instrument to another. Virtual repeated capability names allow you to use and swap instruments without having to change the trace names in your source code. You specify virtual repeated capability names in MAX. Default Value: "" Note: You can specify the trace name as a string variable or as a literal enclosed in double quotes. |