NAME

cxGeoPlotDataAdd - adds a dataset of x and y values to the current plot

C SPECIFICATION

#include <cx/Geometry.h>

int cxGeoPlotDataAdd(int n, float *x, float *y)

PARAMETERS

n

The number of (x, y) pairs.

x

The array of x values.

y

The array of y values.

FUNCTION RETURN VALUE

cxGeoPlotDataAdd returns an integer, which uniquely identifies this dataset on the plot. It can be used in a subsequent call to, for example, cxGeoPlotDataFocusSet (3E). In the event of an error (for example, the absence of a prior call to cxGeoPlotBegin, or a non-positive value for n) it returns with cx_err_error. A description of the error can be obtained by immediately calling cxGeoPlotGetLastError (3E).

DESCRIPTION

This function adds a dataset (a set of x and y values) to the current plot. Each dataset will be displayed on the plot according to attributes that may be set by subsequent calls to cxGeoPlotData* routines. This function must be called before any other cxGeoPlotData* routine, otherwise that routine will return an error. The attributes will apply to the current dataset. By default, this is the dataset from the most recent call to this function, although other datasets can be made current by calling cxGeoPlotDataFocusSet (3E).

SEE ALSO

cxGeoPlotDefine (3E), cxGeoPlotDataFocusSet (3E)

The source of the LineGraph module may be found at $EXPLORERHOME/src/LineGraph/linegraph.c (UNIX) and %EXPLORERHOME%\src\LineGraph\linegraph.c (NT). It illustrates the use of many of the cxGeoPlot* routines.

Last modified: Aug 04 14:54 1999
[ Documentation Home ]