X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=acre.h;h=9611da3d8d15a8b7c4cf00d4bfd07f564b5e574a;hb=f38364b3004fb77dd8ebd6c6a37c66873f37e2b2;hp=df23199cbc0ea6a4a7230cadc1b48fbf818a0d85;hpb=803fba5eca929a4e0cb541223182eae86a96f9bb;p=acre diff --git a/acre.h b/acre.h index df23199..9611da3 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,27 @@ 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 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 +141,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 */