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

VectorPlot 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.


 

[VectorPlot(curve,AngleSource,MagnitudeSource,ColorLo,ColorHi,SizeLo,SizeHi|,"Heading"|)]

JR   Viewer

Sets vector plot options for the curve with 1-based index curve. Angular values are retrieved from the AngleSource'th curve; magnitudes from the MagnitudeSource'th curve. If either of these entries is non-positive, the vector plot option is turned off for curve. The AngleSource and MagnitudeSource curves will not be drawn (assuming both entries are positive).

By default, ColorLo and ColorHi are colors mapped to the low and high absolute values of the MagnitudeSource amplitudes. This behavior may be changed with a subsequent VectorPlotOptions (set 0x0040 bit) and VectorPlotColors command. To use the same color for all vectors, set ColorLo and ColorHi to the same values. Colors are in the form blue*65536+green*256+red, where blue, green, and red are between 0 and 255, inclusive. Colors may be specified in hexadecimal notation with a '0x' prefix. For example 0x00FFFF00 is cyan (blue=255, green=255, red=0). This obviously limits the number of colors in a vector plot to 2 (other than the blending between those colors). You can specify up to 8 colors with a subsequent VectorPlotColors command.

SizeLo and SizeHi are the lengths, in thousandths of inches, of the vectors corresponding to the low and high absolute values of the MagnitudeSource amplitudes or to the low and high magnitudes set with VectorPlotColors.

The optional "Heading" entry will be used as the heading for the color key, but only if the 0x0020 bit of the flags argument to a subsequent VectorPlotOptions command is set.

____________________________

See also

Vector Plot menu command

VectorPlotColors macro command

VectorPlotOptions macro command

 


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