Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
AG_FIXED_PLOTTER(3)	     Library Functions Manual	     AG_FIXED_PLOTTER(3)

NAME
     AG_FixedPlotter -- agar integer plot widget

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

DESCRIPTION
     AG_FixedPlotter  traces  lines or dots over recorded integer values along a
     horizontal axis.  Originally designed to monitor frame  rates,  it  can  be
     useful for performance monitoring in general.

     Note:  For  general-purpose  and  more advanced plotting functions, M_Plot-
     ter(3) is available as part of 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_plot-
     ter_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 container.

     AG_FIXED_PLOTTER_VFILL    Expand vertically in parent container.

     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.

Agar 1.7			December 21, 2022	     AG_FIXED_PLOTTER(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=AG_FixedPlotter&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help