WaveformGraphPopup

int WaveformGraphPopup (char title[], void *yArray, int numberOfPoints, int yDataType, double yGain, double yOffset, double initialX, double xIncrement);

Purpose

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.

Parameters

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.

VAL_CHAR A single byte character.
VAL_DOUBLE An 8 byte floating point value.
VAL_FLOAT A 4 byte floating point value.
VAL_INTEGER A 4 byte integer.
VAL_SHORT_INTEGER A 2 byte integer.
VAL_UNSIGNED_CHAR An unsigned single byte character.
VAL_UNSIGNED_INTEGER An unsigned 4 byte integer.
VAL_UNSIGNED_SHORT_INTEGER An unsigned 2 byte integer.
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.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Code Error Message String
xx Success