## GogChartMap

GogChartMap — 2D data to canvas coordinate conversion

## Synopsis

                        GogChartMapPolarData;
                        GogChartMap;
    GogChartMap*        gog_chart_map_new                   (GogChart *chart,
                                                             GogViewAllocation const *area,
                                                             GogAxis *axis0,
                                                             GogAxis *axis1,
                                                             GogAxis *axis2,
                                                             gboolean fill_area);
    void                gog_chart_map_2D_to_view            (GogChartMap *map,
                                                             double x,
                                                             double y,
                                                             double *u,
                                                             double *v);
    GogAxisMap*         gog_chart_map_get_axis_map          (GogChartMap *map,
                                                             unsigned int index);
    gboolean            gog_chart_map_is_valid              (GogChartMap *map);
    void                gog_chart_map_free                  (GogChartMap *map);
    GOPath*             gog_chart_map_make_path             (GogChartMap *map,
                                                             double const *x,
                                                             double const *y,
                                                             int n_points,
                                                             GOLineInterpolation interpolation);
    GOPath*             gog_chart_map_make_close_path       (GogChartMap *map,
                                                             double const *x,
                                                             double const *y,
                                                             int n_points,
                                                             GogSeriesFillType fill_type);
    GogChartMapPolarData* gog_chart_map_get_polar_parms     (GogChartMap *map);

## Description

## Details

### GogChartMapPolarData

    typedef struct {
    	double cx, cy;
    	double rx, ry;
    	double th0, th1;
    } GogChartMapPolarData;

### GogChartMap

    typedef struct _GogChartMap GogChartMap;

### gog_chart_map_new ()

    GogChartMap*        gog_chart_map_new                   (GogChart *chart,
                                                             GogViewAllocation const *area,
                                                             GogAxis *axis0,
                                                             GogAxis *axis1,
                                                             GogAxis *axis2,
                                                             gboolean fill_area);

Creates a new GogChartMap, used for conversion from data space to canvas space.

`chart` : | a GogChart
`area` : | area allocated to chart
`axis0` : | 1st dimension axis
`axis1` : | 2nd dimension axis
`axis2` : | 3rd dimension axis
`fill_area` : | does chart fill allocated area
Returns : | a new GogChart object.

### gog_chart_map_2D_to_view ()

    void                gog_chart_map_2D_to_view            (GogChartMap *map,
                                                             double x,
                                                             double y,
                                                             double *u,
                                                             double *v);

Converts a 2D coordinate from data space to canvas space.

`map` : | a GogChartMap
`x` : | data x value
`y` : | data y value
`u` : | placeholder for x converted value
`v` : | placeholder for y converted value

### gog_chart_map_get_axis_map ()

    GogAxisMap*         gog_chart_map_get_axis_map          (GogChartMap *map,
                                                             unsigned int index);

Convenience function which returns one of the associated axis_map.

Valid values are in range [0..2].

`map` : | a GogChartMap
`index` : | axis index
Returns : | a GogAxisMap.

### gog_chart_map_is_valid ()

    gboolean            gog_chart_map_is_valid              (GogChartMap *map);

Tests if `map` was correctly initializied, i.e. if all associated axis_map are valid (see `gog_axis_map_is_valid()` ).

given to gog_chart_map_new.

`map` : | a GogChartMap
Returns : | `TRUE` if `map` is valid.

### gog_chart_map_free ()

    void                gog_chart_map_free                  (GogChartMap *map);

Frees `map` object.

`map` : | a GogChartMap

### gog_chart_map_make_path ()

    GOPath*             gog_chart_map_make_path             (GogChartMap *map,
                                                             double const *x,
                                                             double const *y,
                                                             int n_points,
                                                             GOLineInterpolation interpolation);

Creates a new GOPath using `x` and `y` data, each valid point being connected with respect to `interpolation`.

`map` : | a GogChartMap
`x` : | x data
`y` : | y data
`n_points` : | number of points
`interpolation` : | interpolation type
Returns : |

### gog_chart_map_make_close_path ()

    GOPath*             gog_chart_map_make_close_path       (GogChartMap *map,
                                                             double const *x,
                                                             double const *y,
                                                             int n_points,
                                                             GogSeriesFillType fill_type);

Creates a new GOPath using `x` and `y` data, with respect to `fill_type`.

`map` : | a GogChartMap
`x` : | x data
`y` : | y data
`n_points` : | number of points
`fill_type` : | fill type
Returns : |

### gog_chart_map_get_polar_parms ()

    GogChartMapPolarData* gog_chart_map_get_polar_parms     (GogChartMap *map);

Convenience function for retrieving data related to polar plot layout.

`map` : | a GogChartMap
Returns : | a GogChartMapPolarData struct.