# 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