## 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 shown 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"