OGLPlot3DScatter
int OGLPlot3DScatter (int panelHandle, int OGLControlId, const void *arrayOfXYZValues, int numberOfXPoints, int numberOfYPoints, int dataType);
Purpose
Creates a 3D scatter plot on the specified OGL control.
![]() |
Note The plot will not be displayed until the next call to OGLRefreshGraph even if the the plot is not set to be invisible. |
Parameters
Input | ||||||||||||||||||||||
Name | Type | Description | ||||||||||||||||||||
panelHandle | int | The specifier for a particular panel that is currently in memory. This handle will have been returned by the LoadPanel, NewPanel, or DuplicatePanel function. |
||||||||||||||||||||
OGLControlId | int | The ID returned by OGLNewCtrl or OGLConvertCtrl. | ||||||||||||||||||||
arrayOfXYZValues | const void * | The array of coordinate values that are to be plotted. The type of the array is decided by the data type that is passed to the function. The following table lists the data types and the associated data structure types.
|
||||||||||||||||||||
numberOfXPoints | int | Size of the row dimension of the array. | ||||||||||||||||||||
numberOfYPoints | int | Size of the column dimension of the array. | ||||||||||||||||||||
dataType | int | Specifies the data type of the XYZ Array. Valid Data Types:
|
Return Value
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
plotHandle | int | Returns the handle used to specify this plot in subsequent function calls. Negative values indicate that an error occurred.Error Codes
|
Additional Information
Library: OpenGL 3D Plotting Control
Include file: custctrl\cviogl.h
LabWindows/CVI compatibility: LabWindows/CVI 5.0 and later
Example
Refer to userint\custctrl\cviogl\ogldemo.cws for an example of using the OGLPlot3DScatter function.