Analyze a series of data for a scatter chart.
#include <pgchart.h>
short __far _pg_analyzescatter( _chartenv __far *env, float __far *xvalues,
float __far *yvalues, short n );
short __far _pg_analyzescatterms( _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 |
The _pg_analyzescatter set of routines analyzes a single or multiple series of data without actually displaying the graphic image.
The _pg_analyzescatter function fills the chart environment for a single-series scatter diagram. The variables calculated by this function reflect the data given in the arguments xvalues and yvalues. All arguments are the same as those used in the _pg_chartscatter function.
The _pg_analyzescatterms function fills the chart environment for a multiseries scatter diagram. The variables calculated by _pg_analyzescatterms reflect the data given in the arguments xvalues and yvalues. All arguments are the same as those used in the function _pg_chartscatterms.
Boolean flags in the chart environment, such as AUTOSCALE and LEGEND, should be set to TRUE before calling _pg_analyzescatterms; this ensures that the function will calculate all defaults.
For a discussion of the chart environment and related topics, see “Presentation-Graphics Functions”.
The _pg_analyzescatter and _pg_analyzescatterms functions return 0 if there were no errors. A nonzero value indicates a failure.
Standards:None
16-Bit:DOS
32-Bit:None
_pg_chartscatter functions, _pg_defaultchart, _pg_initchart
See the example for _pg_analyzechart.