|
HBITMAP DPlot_PlotBitmap(DPLOT *DPlot, float *array1, float *array2, LPSTR commands,int cx, int cy);
HBITMAP DPlot_PlotBitmap8(DPLOT *DPlot, double *array1, double *array2, LPSTR commands, int cx, int cy);
Parameters
*DPlot | Address of a DPLOT structure. A DPLOT structure contains format information for the graph: number of curves, number of points in each curve, line and symbol styles used, etc. This structure is defined in the header/include file accompanying the various source examples. |
*array1 | Address of the X array for XY plots or a 4-element array used for the extents of a contour plot on a rectangular grid. Not used for contour plots of random points or 1D plots. |
*array2 | Address of the Y array for XY plots,
Z array for contour plots on a rectangular grid,
X,Y,Z triplets (in the order x(0),y(0),z(0),x(1),y(1),z(1),... etc.) for contour plots of randomly-spaced points.
Y (amplitude) array for box-and-whisker plots and dot graphs. |
commands | Character string with zero or more DPlot commands. Valid commands and the syntax for those commands are described in the DPlot Command Syntax section of DPlot's Help file. This string is limited to 32768 characters and must be null-terminated. |
cx, cy | Requested width and height of the bitmap, in pixels. |
Return Values
0 | Generic error attempting to communicate with DPlot. This most often indicates that DPlot is currently busy, e.g. a modal dialog box is open, or that one or more commands in the commands parameter is invalid. (In the latter case, DPlot will show an "Error processing this command" MessageBox. |
<>0 | Handle to a device-dependent bitmap. This picture may be drawn in your application with the Windows API functions BitBlt and/or StretchBlt. |
Remarks
Palette information is not returned, so this function does not work particularly well with 256 (or fewer) color displays.
If DPlot was not running when DPlot_PlotBitmap was called, this function will shut DPlot down immediately before returning to the caller. If this is undesirable (for example if your application will be making multiple calls to DPlot_PlotBitmap functions), you should first start DPlot with DPlot_Start.
|
|