# PlotDigitalLines

int PlotDigitalLines (int panelHandle, int controlID, void *dataArray, int numberOfPoints, int dataType, unsigned char numLines);

## Purpose

Plots data from a single bus to a digital graph. Use PlotDigitalLinesMultiBus to plot data from multiple buses.

Use PlotDigitalLines to send each data sample from each line as a separate data array value. Call PlotPackedDigitalLines to send packed data in which each data array element contains data values for multiple lines.

If you use NI-DAQmx to acquire the data you plot with PlotDigitalLines, you must call DAQmxReadDigitalLines as the read function.

## Parameters

Input
Name | Type | Description
panelHandle | integer | Specifier for a particular panel that is currently in memory. You obtain this handle from LoadPanel, NewPanel, or DuplicatePanel.
controlID | integer | The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by NewCtrl or DuplicateCtrl.
dataArray | void * | Array that contains the values to plot on the digital graph. The data type must be of the type specified by dataType. If the value of a data item is non-zero, then the line is high; if the value is 0, then the line is low. The data in the array must be interleaved. To pass all the data samples for each line sequentially, call the PlotDigitalLinesMultiBus function and assign each line to its own bus.
numPoints | integer | The number of points to plot. This value controls the number of points to plot even if the number of elements in the dataArray is greater than the numPoints. numPoints must be greater than zero.
dataType | integer | The data type of dataArray. The data must be one of the following valid integer data types:
VAL_CHAR | A single byte character
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
numLines | unsigned char | The number of lines to plot. LabWindows/CVI divides the dataArray evenly among the lines. You cannot mask out a particular line to keep LabWindows/CVI from plotting it.

## 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