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

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


 

[Bubbles(curve,symbol,source,size_lo,size_hi,
color_lo,color_hi|,low,high,options|)]

JR   Viewer

Sets bubble plot parameters for the curve with 1-based index curve. The symbol type is specified by the symbol parameter (see all available symbol types in the description of the SymbolType command). The symbol size will be based on the Y values of the curve with 1-based index source. The source curve will not be drawn. The X values for the source curve are ignored: the nth point in curve will use the nth point in source. The size of the symbols (size_lo and size_hi) is specified in thousandths of inches, i.e. 200 = 0.2 inches. The size_lo and size_hi sizes correspond either the minimum and maximum Y values in source, or to the low and high settings, dependent on options. 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).

The optional options setting may be a combination of:

0x00000001Solid symbols will be outlined in black
0x00000002If set, bubble size/color scale is determined by the low and high values. If not set, size and color are determined by the minimum and maximum amplitudes in the source curve.
0x00000004If set, bubbles with amplitudes outside the low to high range will not be drawn. If not set, those bubbles will be drawn with the size and color associated with the low or high limit. This flag is meaningless if the 2 bit is not also set.

The default value for options if it is omitted is 1.

Combine options by adding them.

Note: source must be different than curve. If you want to use a curve's amplitudes for the bubble values, make a copy of that curve and set source to that copy.

____________________________

See also

Bubble Plot menu command

 


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