int WaveformGraphPopup (char title[], void *yArray, int numberOfPoints, int yDataType, double yGain, double yOffset, double initialX, double xIncrement);
Plots a waveform on a graph control in a dialog box.
WaveformGraphPopup scales the values in yArray according to yGain and yOffset. The function scales the x-axis timebase according to initialX and xIncrement. WaveformGraphPopup computes each point in the plot as follows:
xi = (i × xIncrement) + initialX
yi = (wfmi x yGain) + yOffset
where i is the index of the point in the waveform array.
Input | ||||||||||||||||||
Name | Type | Description | ||||||||||||||||
title | string | Title of the dialog box. | ||||||||||||||||
yArray | void * | Array that contains the values to plot along the y-axis. The data type must be of the type specified by yDataType. | ||||||||||||||||
numberOfPoints | integer | Number of points to plot. This value controls the number of points to plot even if the number of elements in xArray is greater than the numberOfPoints. numberOfPoints must be greater than zero. |
||||||||||||||||
yDataType | integer | The data type of the y array. The following table lists the valid data types.
|
||||||||||||||||
yGain | double-precision | The gain to apply to the waveform (yArray) data. The default value is 1.0. |
||||||||||||||||
yOffset | double-precision | A constant offset to add to the waveform (yArray) data. The default value is 0.0. |
||||||||||||||||
initialX | double-precision | The initial value for the x-axis. The default value is 0.0. |
||||||||||||||||
xIncrement | double-precision | The increment along the x-axis for each new point. The default value is 1.0. |
Name | Type | Description | ||||
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
|