## GogErrorBar

GogErrorBar

## Synopsis

                        GogErrorBar;
    enum                GogErrorBarType;
    enum                GogErrorBarDisplay;
    enum                GogErrorBarDirection;
    GogErrorBar *       gog_error_bar_dup                   (GogErrorBar const *bar);
    gpointer            gog_error_bar_prefs                 (GogSeries *series,
                                                             char const *property,
                                                             GogErrorBarDirection direction,
                                                             GogDataAllocator *dalloc,
                                                             GOCmdContext *cc);
    gboolean            gog_error_bar_get_bounds            (const GogErrorBar *bar,
                                                             int index,
                                                             double *min,
                                                             double *max);
    void                gog_error_bar_get_minmax            (const GogErrorBar *bar,
                                                             double *min,
                                                             double *max);
    void                gog_error_bar_render                (const GogErrorBar *bar,
                                                             GogRenderer *rend,
                                                             GogChartMap *map,
                                                             double x,
                                                             double y,
                                                             double minus,
                                                             double plus,
                                                             GogErrorBarDirection direction);
    gboolean            gog_error_bar_is_visible            (GogErrorBar *bar);

## Object Hierarchy

      GObject
       +----GogErrorBar

## Implemented Interfaces

GogErrorBar implements GOPersist.

## Description

## Details

### GogErrorBar

    typedef struct _GogErrorBar GogErrorBar;

### enum GogErrorBarType

    typedef enum {
    	GOG_ERROR_BAR_TYPE_NONE,
    	GOG_ERROR_BAR_TYPE_ABSOLUTE,
    	GOG_ERROR_BAR_TYPE_RELATIVE,
    	GOG_ERROR_BAR_TYPE_PERCENT
    } GogErrorBarType;

`GOG_ERROR_BAR_TYPE_NONE` | No error bars.
`GOG_ERROR_BAR_TYPE_ABSOLUTE` | Absolute errors.
`GOG_ERROR_BAR_TYPE_RELATIVE` | Relative errors.
`GOG_ERROR_BAR_TYPE_PERCENT` | Relative errors as percent.

### enum GogErrorBarDisplay

    typedef enum {
    	GOG_ERROR_BAR_DISPLAY_NONE,
    	GOG_ERROR_BAR_DISPLAY_POSITIVE,
    	GOG_ERROR_BAR_DISPLAY_NEGATIVE,
    	GOG_ERROR_BAR_DISPLAY_BOTH
    } GogErrorBarDisplay;

### enum GogErrorBarDirection

    typedef enum {
    	GOG_ERROR_BAR_DIRECTION_HORIZONTAL,
    	GOG_ERROR_BAR_DIRECTION_VERTICAL,
    	GOG_ERROR_BAR_DIRECTION_ANGULAR,
    	GOG_ERROR_BAR_DIRECTION_RADIAL
    } GogErrorBarDirection;

### gog_error_bar_dup ()

    GogErrorBar *       gog_error_bar_dup                   (GogErrorBar const *bar);

`bar` : |
Returns : |

### gog_error_bar_prefs ()

    gpointer            gog_error_bar_prefs                 (GogSeries *series,
                                                             char const *property,
                                                             GogErrorBarDirection direction,
                                                             GogDataAllocator *dalloc,
                                                             GOCmdContext *cc);

`series` : |
`property` : |
`direction` : |
`dalloc` : |
`cc` : |
Returns : |

### gog_error_bar_get_bounds ()

    gboolean            gog_error_bar_get_bounds            (const GogErrorBar *bar,
                                                             int index,
                                                             double *min,
                                                             double *max);

If the value correponding to `index` is valid, fills min and max with the error values: -> positive_error in `max`. -> negative_error in `min`. If one of the errors is not valid or not defined, its value is set to -1.0.

`bar` : | A GogErrorBar
`index` : | the index corresponding to the value which error limits are
`min` : | where the minimum value will be stored
`max` : | where the maximum value will be stored
Returns : | `FALSE` if the `bar->type` is `GOG_ERROR_BAR_TYPE_NONE` or if the value is not valid, `TRUE` otherwise.

### gog_error_bar_get_minmax ()

    void                gog_error_bar_get_minmax            (const GogErrorBar *bar,
                                                             double *min,
                                                             double *max);

`bar` : |
`min` : |
`max` : |

### gog_error_bar_render ()

    void                gog_error_bar_render                (const GogErrorBar *bar,
                                                             GogRenderer *rend,
                                                             GogChartMap *map,
                                                             double x,
                                                             double y,
                                                             double minus,
                                                             double plus,
                                                             GogErrorBarDirection direction);

Displays the error bar. If `plus` is negative, the positive side of the bar is not displayed, and if `minus` is negative, the negative side of the bar is not displayed. x_map and y_map are used to convert coordinates from data space to canvas coordinates. This function must not be called if gog_error_bar_get_bounds returned FALSE.

`bar` : | A GogErrorBar
`rend` : | A GogRenderer
`map` : | A GogChartMap for the chart
`x` : | x coordinate of the origin of the bar
`y` : | y coordinate of the origin of the bar
`minus` : | distance from the origin to the negative end of the bar
`plus` : | distance from the origin to the positive end of the bar
`direction` : | the GogErrorBarDirection for the bar.

### gog_error_bar_is_visible ()

    gboolean            gog_error_bar_is_visible            (GogErrorBar *bar);

`bar` : |
Returns : |