NAME

cxGeoPlotDefine - closes the current plot and passes it to the geometry buffer

C SPECIFICATION

#include <cx/Geometry.h>

cxGeo cxGeoPlotDefine (float *start, float *end)

PARAMETERS

start

An array of two floating point numbers (interpreted as (x,y) coordinates), defining the bottom left-hand corner of the plot.

end

An array of two floating point numbers (interpreted as (x,y) coordinates), defining the top right-hand corner of the plot.

FUNCTION RETURN VALUE

cxGeoPlotDefine returns a tag for the geometry object that may be used to reference it at a later time with cxGeoFocus(3E). The function returns NULL in the event of an error; a description of the error can be obtained by immediately calling cxGeoPlotGetLastError (3E).

DESCRIPTION

This function closes the current plot and passes it to the geometry buffer. The position of the plot is defined to be at (start, end), where the coordinates of the plot are in screen coordinates (-1 to +1).

The appearance of the plot is set by all the calls to cxGeoPlot* and cxGeoPlotData* routines which are performed in between the call to cxGeoPlotBegin (which starts the plot) and cxGeoPlotDefine (which finishes it).

SEE ALSO

cxGeoPlotBegin (3E), cxGeoFocus (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 15:07 1999
[ Documentation Home ]