GogErrorBar

## GogErrorBar GogErrorBar |

## Synopsis

                        GogErrorBar;
    enum                GogErrorBarDirection;
    enum                GogErrorBarDisplay;
    enum                GogErrorBarType;
    GogErrorBar *       gog_error_bar_dup                   (GogErrorBar const *bar);
    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);
    gboolean            gog_error_bar_is_visible            (GogErrorBar *bar);
    gpointer            gog_error_bar_prefs                 (GogSeries *series,
                                                             char const *property,
                                                             GogErrorBarDirection direction,
                                                             GogDataAllocator *dalloc,
                                                             GOCmdContext *cc);
    void                gog_error_bar_render                (const GogErrorBar *bar,
                                                             GogRenderer *rend,
                                                             GogChartMap *map,
                                                             double x,
                                                             double y,
                                                             double minus,
                                                             double plus,
                                                             GogErrorBarDirection direction);

## Object Hierarchy

      GObject
       +----GogErrorBar

## Implemented Interfaces

GogErrorBar implements GOPersist.

## Description

## Details

### GogErrorBar

    typedef struct _GogErrorBar GogErrorBar;

### 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_DIRECTION_HORIZONTAL` | horizontal (xy plots).
`GOG_ERROR_BAR_DIRECTION_VERTICAL` | vertical (xy plots).
`GOG_ERROR_BAR_DIRECTION_ANGULAR` | angular (polar plots).
`GOG_ERROR_BAR_DIRECTION_RADIAL` | radial (polar plots).

### 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;

`GOG_ERROR_BAR_DISPLAY_NONE` | no display.
`GOG_ERROR_BAR_DISPLAY_POSITIVE` | display positive deviations.
`GOG_ERROR_BAR_DISPLAY_NEGATIVE` | display negative deviations.
`GOG_ERROR_BAR_DISPLAY_BOTH` | display both positive and negative deviations.

### 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.

### gog_error_bar_dup ()

    GogErrorBar *       gog_error_bar_dup                   (GogErrorBar const *bar);

`bar` : | GogErrorBar
Returns : | the duplicated error bar. [transfer full]

### 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);

### gog_error_bar_is_visible ()

    gboolean            gog_error_bar_is_visible            (GogErrorBar *bar);

### gog_error_bar_prefs ()

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

`series` : | GogSeries
`property` : | the name of the `series` property correspondig to the GogErrorBar.
`direction` : | GogErrorBarDirection
`dalloc` : | GogDataAllocator
`cc` : | GOCmdContext
Returns : | the error bar properties GtkWidget. [transfer full]

### 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.