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

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.

[SwitchX(Curve|,options|)]

JR Viewer

Uses the amplitudes of Curve as the independent variable (X values) of all other curves and shows the results in a new document. Curve must have monotonically increasing X values. If options is omitted, the new curves will be sorted in increasing order of the new independent variable and placed in a new document. If options is used and bit 1 is not set (e.g. [SwitchX(Curve,0)], the curves will not be sorted. If bit 1 is set, the curves will be sorted on X. If the 2 bit of options is set, the existing curves will be replaced by the results of this operation. If bit 2 is not set, the result will be placed in a new document.

Example:

[SwitchX(1,0)]