AG_FIXED_PLOTTER(3)

NAME
AG_FixedPlotter - agar integer plot widget

SYNOPSIS

    #include <agar/core.h>
    #include <agar/gui.h>

DESCRIPTION
The AG_FixedPlotter widget is a scrollable plotter widget that accepts integer values. It is mainly designed for displaying performance measurements.

Note: A much more featureful floating-point plotting widget is available as M_Plotter(3) in the ag_math library.

INHERITANCE HIERARCHY
AG_Object(3) -> AG_Widget(3) -> AG_FixedPlotter.

INITIALIZATION
AG_FixedPlotter * AG_FixedPlotterNew(AG_Widget *parent, enum ag_fixed_plotter_type type, Uint flags)

The AG_FixedPlotterNew() function allocates, initializes, and attaches a new AG_FixedPlotter widget. The type argument is one of:

    enum ag_fixed_plotter_type {
    	AG_FIXED_PLOTTER_POINTS,   /* Dots */
    	AG_FIXED_PLOTTER_LINES     /* Lines */
    } type;

Acceptable flags include:

AG_FIXED_PLOTTER_SCROLL
    Always scroll to the end of the plot if it is not visible.

AG_FIXED_PLOTTER_XAXIS
    Display the X-axis line.

AG_FIXED_PLOTTER_HFILL
    Expand horizontally in parent (equivalent to invoking AG_ExpandHoriz(3)).

AG_FIXED_PLOTTER_VFILL
    Expand vertically in parent (equivalent to invoking AG_ExpandVert(3)).

AG_FIXED_PLOTTER_EXPAND
    Shorthand for AG_FIXED_PLOTTER_HFILL|AG_FIXED_PLOTTER_VFILL.

PLOTTING
AG_FixedPlotterCurve * AG_FixedPlotterCurve(AG_FixedPlotter *fpl, const char *name, Uint8 r, Uint8 g, Uint8 b, Uint32 limit)

void AG_FixedPlotterDatum(AG_FixedPlotterCurve *curve, AG_FixedPlotterValue val)

The AG_FixedPlotterCurve() function creates a new curve into fpl. The r, g, b triplet composes a color to visually identify the item. limit is the maximum number of points (if 0, the maximum is implicitely INT_MAX - 1).

The AG_FixedPlotterDatum() function adds a value val to the specified curve.

EVENTS
The AG_FixedPlotter widget does not generate any event.

STRUCTURE DATA
For the AG_FixedPlotter object:

enum ag_fixed_plotter_type type
    Drawing method, initially set by AG_FixedPlotterNew().

SEE ALSO
AG_Intro(3), AG_Widget(3), AG_Window(3)

HISTORY
The AG_FixedPlotter widget first appeared in Agar 1.0.