GogChart

GogChart — A set of axes and a collection of plots

Synopsis




            GogChart;
GogAxisSet  gog_axis_set_from_str           (char const *str);
gboolean    gog_chart_get_position          (GogChart const *chart,
                                             unsigned *x,
                                             unsigned *y,
                                             unsigned *cols,
                                             unsigned *rows);
void        gog_chart_set_position          (GogChart *chart,
                                             unsigned int x,
                                             unsigned int y,
                                             unsigned int cols,
                                             unsigned int rows);
gboolean    gog_chart_get_plot_area         (GogChart *chart,
                                             GogViewAllocation *plot_area);
void        gog_chart_set_plot_area         (GogChart *chart,
                                             GogViewAllocation const *plot_area);
void        gog_chart_request_cardinality_update
                                            (GogChart *chart);
void        gog_chart_get_cardinality       (GogChart *chart,
                                             unsigned *full,
                                             unsigned *visible);
void        gog_chart_foreach_elem          (GogChart *chart,
                                             gboolean only_visible,
                                             GogEnumFunc handler,
                                             gpointer data);
GSList*     gog_chart_get_plots             (GogChart const *chart);
GogAxisSet  gog_chart_get_axis_set          (GogChart const *chart);
gboolean    gog_chart_axis_set_is_valid     (GogChart const *chart,
                                             GogAxisSet type);
gboolean    gog_chart_axis_set_assign       (GogChart *chart,
                                             GogAxisSet type);
GSList*     gog_chart_get_axes              (GogChart const *chart,
                                             GogAxisType target);
GogGrid*    gog_chart_get_grid              (GogChart const *chart);

GogViewAllocationconst * gog_chart_view_get_plot_area
                                            (GogView const *view);


Object Hierarchy


  GObject
   +----GogObject
         +----GogStyledObject
               +----GogOutlinedObject
                     +----GogChart

Properties


  "cardinality-valid"    gboolean              : Read
  "is-plot-area-manual"  gboolean              : Read / Write
  "plot-area"            gchararray            : Read / Write

Description

Details

GogChart

typedef struct _GogChart GogChart;


gog_axis_set_from_str ()

GogAxisSet  gog_axis_set_from_str           (char const *str);

str :
Returns :

gog_chart_get_position ()

gboolean    gog_chart_get_position          (GogChart const *chart,
                                             unsigned *x,
                                             unsigned *y,
                                             unsigned *cols,
                                             unsigned *rows);

chart : const GogChart
x :
y :
cols :
rows :
Returns : TRUE if the chart has been positioned.

gog_chart_set_position ()

void        gog_chart_set_position          (GogChart *chart,
                                             unsigned int x,
                                             unsigned int y,
                                             unsigned int cols,
                                             unsigned int rows);

chart : GogChart
x :
y :
cols :
rows :

gog_chart_get_plot_area ()

gboolean    gog_chart_get_plot_area         (GogChart *chart,
                                             GogViewAllocation *plot_area);

Stores plot area in plot_area, in fraction of chart size, and returns TRUE if plot area position is manual.

chart : GogChart
plot_area : GogViewAllocation
Returns :

gog_chart_set_plot_area ()

void        gog_chart_set_plot_area         (GogChart *chart,
                                             GogViewAllocation const *plot_area);

If plot_area != NULL, sets plot area size and location, in fraction of chart size, and sets GogChart::is_plot_area_manual flag to TRUE. If plot_area == NULL, sets GogChart::is_plot_area_manual to FALSE.

chart : GogChart
plot_area : GogViewAllocation

gog_chart_request_cardinality_update ()

void        gog_chart_request_cardinality_update
                                            (GogChart *chart);

chart :

gog_chart_get_cardinality ()

void        gog_chart_get_cardinality       (GogChart *chart,
                                             unsigned *full,
                                             unsigned *visible);

Update and cache cardinality values if required, and returns full and visible cardinality. Full cardinality is the number of chart elements that require a different style. Visible cardinality is the number of chart elements showed in chart legend.

full and visible may be NULL.

chart : a GogChart
full : placeholder for full cardinality
visible : placeholder for visible cardinality

gog_chart_foreach_elem ()

void        gog_chart_foreach_elem          (GogChart *chart,
                                             gboolean only_visible,
                                             GogEnumFunc handler,
                                             gpointer data);

chart :
only_visible :
handler :
data :

gog_chart_get_plots ()

GSList*     gog_chart_get_plots             (GogChart const *chart);

chart :
Returns :

gog_chart_get_axis_set ()

GogAxisSet  gog_chart_get_axis_set          (GogChart const *chart);

chart :
Returns :

gog_chart_axis_set_is_valid ()

gboolean    gog_chart_axis_set_is_valid     (GogChart const *chart,
                                             GogAxisSet type);

chart :
type :
Returns :

gog_chart_axis_set_assign ()

gboolean    gog_chart_axis_set_assign       (GogChart *chart,
                                             GogAxisSet type);

chart :
type :
Returns :

gog_chart_get_axes ()

GSList*     gog_chart_get_axes              (GogChart const *chart,
                                             GogAxisType target);

chart : GogChart
target : GogAxisType
Returns : a list which the caller must free of all axis of type target associated with chart.

gog_chart_get_grid ()

GogGrid*    gog_chart_get_grid              (GogChart const *chart);

chart : GogChart
Returns : the grid associated with chart if one exists otherwise NULL.

gog_chart_view_get_plot_area ()

GogViewAllocationconst * gog_chart_view_get_plot_area
                                            (GogView const *view);

view :
Returns :

Property Details

The "cardinality-valid" property

  "cardinality-valid"    gboolean              : Read

Is the charts cardinality currently valid.

Default value: FALSE


The "is-plot-area-manual" property

  "is-plot-area-manual"  gboolean              : Read / Write

Is plot area manual.

Default value: FALSE


The "plot-area" property

  "plot-area"            gchararray            : Read / Write

Position and size of plot area, in percentage of chart size.

Default value: "0 0 1 1"