X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=acre.h;h=7924cba2d26d38603b0318ac1d319a3f72ed6198;hb=3351362992de09bf601904f8c67da0eed58da32f;hp=df23199cbc0ea6a4a7230cadc1b48fbf818a0d85;hpb=803fba5eca929a4e0cb541223182eae86a96f9bb;p=acre diff --git a/acre.h b/acre.h index df23199..7924cba 100644 --- a/acre.h +++ b/acre.h @@ -89,7 +89,8 @@ void acre_set_y_axis_range_auto (acre_t *acre); /* Add a dataset to the plot. The plot assumes ownership of the - * dataset so it is not necessary to call acre_data_destroy on it. */ + * dataset so it is not necessary to call acre_data_destroy on it. + */ void acre_add_data (acre_t *acre, acre_data_t *data); @@ -111,6 +112,33 @@ acre_data_create (void); void acre_data_destroy (acre_data_t *data); +/* The style to be used for rendering data sets. */ +typedef enum +{ + /* A simple line graph connection each (X,Y) pair in order. */ + ACRE_STYLE_LINE, + + /* A bar chart. */ + ACRE_STYLE_BARS, + + /* Bars if there is room for them, a line otherwise. */ + ACRE_STYLE_BARS_OR_LINE, + + /* A timeline. + * + * Each (X,Y) pair specifies the (start,stop) time of a + * timeline bar. + * + * The acre_data_add_point_2d_named function is particularly + * useful to provide a name for each timeline bar. + */ + ACRE_STYLE_TIMELINE +} acre_style_t; + +/* Set the rendering style for this dataset. */ +void +acre_data_set_style (acre_data_t *data, acre_style_t style); + /* Set the label for this dataset (to appear in the plot's key). */ void acre_data_set_name (acre_data_t *data, const char *name); @@ -119,4 +147,9 @@ acre_data_set_name (acre_data_t *data, const char *name); void acre_data_add_point_2d (acre_data_t *data, double x, double y); +/* Add a datapoint with a name to the given dataset. */ +void +acre_data_add_point_2d_named (acre_data_t *data, double x, double y, + const char *name); + #endif /* ACRE_H */