graphics.hlp (
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
_pg_chartms
◄Summary► ◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
The _pg_chartms function displays a multiseries bar, column, or
line chart, depending on the type specified in the chart
environment. All the series must contain the same number of data
points, specified by the <n> argument.
The <values> array is a two-dimensional array containing all value
data for every series to be plotted on the chart. Each column of
values represents a single series. The parameter <rowdim> is the
integer value used to dimension rows in the array declaration for
<values>.
For example, the following code fragment declares the identifier
<values> to be a two-dimensional floating-point array with 20 rows
and 10 columns:
#define ARRAYDIM 20
float values [ARRAYDIM][10];
short rowdim = ARRAYDIM;
Note that the number of columns in the <values> array cannot
exceed 10, the maximum number of data series on a single chart.
Note also that <rowdim> must be greater than or equal to the <n>
argument, and the column dimension in the array declaration must
be greater than or equal to the <nseries> argument. Setting <n>
and <nseries> to values less than the full dimensional size of the
<values> array allows plotting of only part of the data contained
in <values>.
The character array <serieslabels> holds the labels used in the
chart legend to identify each series.
Return Value
The function returns 0 if there were no errors. A nonzero value
indicates a failure.
-♦-