_pg_chartscatter Functions

Description

Display scatter charts.

#include <pgchart.h>

short __far _pg_chartscatter( _chartenv __far *env, float __far *xvalues,
float __far *yvalues, short n );

short __far _pg_chartscatterms( _chartenv __far *env, float __far *xvalues,
float __far *yvalues, short nseries, short n, short rowdim,
char __far * __far *serieslabels );

env Chart environment structure  
xvalues Array of x-axis data values  
yvalues Array of y-axis data values  
n Number of data values to chart  
nseries Number of series to chart  
rowdim Row dimension of data array  
serieslabels Array of labels for series  

Remarks

The _pg_chartscatter function displays a scatter diagram for a single series of data.

The _pg_chartscatterms function displays a scatter diagram for more than one series of data.

The arguments xvalues and yvalues are two-dimensional arrays containing data for the x axis and y axis, respectively. Columns for each array hold data for individual series; thus the first columns of xvalues and yvalues contain plot data for the first series, the second columns contain plot data for the second series, and so forth.

The n, rowdim, nseries, and serieslabels arguments fulfill the same purposes as those used in the _pg_chartms function. See _pg_chartms for an explanation of these arguments.

For a discussion of the chart environment and related topics, see “Presentation-Graphics Functions”.

Return Value

The _pg_chartscatter and _pg_chartscatterms functions return 0 if there were no errors. A nonzero value indicates a failure.

Compatibility

Standards:None

16-Bit:DOS

32-Bit:None

See Also

_pg_analyzescatter functions, _pg_defaultchart, _pg_initchart

Example

See the example for _pg_chart.