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.
                                    -♦-