Navigation:  Programmer's Reference > Sending data to DPlot from another application >

XYZEx macro command

Print this Topic Previous pageReturn to chapter overviewNext page

Macro commands may be used either in macros or by sending the commands to DPlot via dynamic data exchange (DDE). Some commands are valid only in macros (noted by Macros Only). Commands sent to DPlot via DDE must be enclosed by square brackets [     ]. Macro commands should not include the brackets.

Command parameters shown in the descriptions below are placeholders for the actual values. Command parameters are either numeric values, equations that evaluate to numbers, or character strings. Character string parameters are always bound by double quotation marks. Equations must be preceded by an equals sign (=).

The pipe symbol (|) in the command syntax indicates that a parameter is optional, and should not be included in your macro unless otherwise noted.

All indices into arrays are 1-based, e.g. Curve1=1 refers to the first curve in a plot.

A 0x prefix for numbers in the descriptions below indicates hexadecimal notation; e.g. 0x0010 = 16.

JR/Viewer indicates that the command is supported by DPlot Jr or DPlot Viewer.
JR/Viewer indicates that the command is NOT supported by DPlot Jr or DPlot Viewer.


 

[XYZEx(replot,n,x1,y1,z1,x2,y2,z2,…,xn,yn,zn)]

JR   Viewer

Adds n x,y,z triplets to a contour plot. If replot is non-zero, the new x,y,z points plus any pre-existing x,y,z points are triangulated. If replot = 0, the new x,y,z points are added to the plot's data but are not triangulated and the plot is not redrawn. This is useful in environments (Microsoft Excel in particular) which limit the size of a command string, such that multiple XYZ (or XYZEx) commands are needed.

Important: The maximum command string length that DPlot will process is 32768 characters, including the command itself and all delimiters and spaces. For this reason you should limit the number of points sent with XYZEx to a maximum of about 1000 from a VB or C program, for example. If your application requires sending more than 1000 points, use multiple XYZ commands in separate XTYP_EXECUTE (LinkExecute in VB jargon) transactions. If you are manipulating DPlot from Microsoft Excel, the maximum command string length is 256 characters.

If replot is non-zero and an error in the triangulation occurs (for example if all points are collinear) an error message IS generated. This behavior is different than the XYZ command. In this case DPlot assumes that the calling program knows whether the sent data can be used to construct a valid plot or not, since the caller instructed DPlot to triangulate the data with the replot parameter.

 


Page url: https://www.dplot.com/help/index.htm?xyzexcommand.htm