X-Git-Url: https://git.octo.it/?p=rrdtool.git;a=blobdiff_plain;f=src%2Frrd_graph.h;h=24331a6c86f1e4a625d272b411225f1649b8b4d4;hp=2e8e3bc341f85cdd6c4c20d048b235338912a4f7;hb=355e29120ccb981bab8779dab297d0302b7524ec;hpb=4414926d4c2ab02e84ffe1d55d26b27632cb18aa diff --git a/src/rrd_graph.h b/src/rrd_graph.h index 2e8e3bc..24331a6 100644 --- a/src/rrd_graph.h +++ b/src/rrd_graph.h @@ -1,100 +1,157 @@ #ifndef _RRD_GRAPH_H #define _RRD_GRAPH_H +#define y0 cairo_y0 +#define y1 cairo_y1 +#define index cairo_index + +/* this may configure __EXTENSIONS__ without which pango will fail to compile + so load this early */ +#if defined(_WIN32) && !defined(__CYGWIN__) && !defined(__CYGWIN32__) +#include "../win32/config.h" +#else +#ifdef HAVE_CONFIG_H +#include "../rrd_config.h" +#endif +#endif + +#include +#include +#include +#include + +#include + + #include "rrd_tool.h" #include "rrd_rpncalc.h" -#include "rrd_gfx.h" -#define MAX_VNAME_LEN 255 -#define DEF_NAM_FMT "%255[-_A-Za-z0-9]" +#ifdef WIN32 +# include +# define MAXPATH MAX_PATH +#endif + +#define ALTYGRID 0x01 /* use alternative y grid algorithm */ +#define ALTAUTOSCALE 0x02 /* use alternative algorithm to find lower and upper bounds */ +#define ALTAUTOSCALE_MIN 0x04 /* use alternative algorithm to find lower bounds */ +#define ALTAUTOSCALE_MAX 0x08 /* use alternative algorithm to find upper bounds */ +#define NOLEGEND 0x10 /* use no legend */ +#define NOMINOR 0x20 /* Turn off minor gridlines */ +#define ONLY_GRAPH 0x40 /* use only graph */ +#define FORCE_RULES_LEGEND 0x80 /* force printing of HRULE and VRULE legend */ -#define ALTYGRID 0x01 /* use alternative y grid algorithm */ -#define ALTAUTOSCALE 0x02 /* use alternative algorithm to find lower and upper bounds */ -#define ALTAUTOSCALE_MAX 0x04 /* use alternative algorithm to find upper bounds */ -#define NOLEGEND 0x08 /* use no legend */ -#define NOMINOR 0x10 /* Turn off minor gridlines */ -#define ONLY_GRAPH 0x20 /* use only graph */ -#define FORCE_RULES_LEGEND 0x40 /* force printing of HRULE and VRULE legend */ +#define FORCE_UNITS 0x100 /* mask for all FORCE_UNITS_* flags */ +#define FORCE_UNITS_SI 0x100 /* force use of SI units in Y axis (no effect in linear graph, SI instead of E in log graph) */ -#define FORCE_UNITS 0x80 /* mask for all FORCE_UNITS_* flags */ -#define FORCE_UNITS_SI 0x80 /* force use of SI units in Y axis (no effect in linear graph, SI instead of E in log graph) */ +#define FULL_SIZE_MODE 0x200 /* -width and -height indicate the total size of the image */ +#define NO_RRDTOOL_TAG 0x400 /* disable the rrdtool tag */ -enum tmt_en {TMT_SECOND=0,TMT_MINUTE,TMT_HOUR,TMT_DAY, - TMT_WEEK,TMT_MONTH,TMT_YEAR}; +enum tmt_en { TMT_SECOND = 0, TMT_MINUTE, TMT_HOUR, TMT_DAY, + TMT_WEEK, TMT_MONTH, TMT_YEAR +}; -enum grc_en {GRC_CANVAS=0,GRC_BACK,GRC_SHADEA,GRC_SHADEB, - GRC_GRID,GRC_MGRID,GRC_FONT,GRC_ARROW,GRC_AXIS,GRC_FRAME,__GRC_END__}; +enum grc_en { GRC_CANVAS = 0, GRC_BACK, GRC_SHADEA, GRC_SHADEB, + GRC_GRID, GRC_MGRID, GRC_FONT, GRC_ARROW, GRC_AXIS, GRC_FRAME, __GRC_END__ +}; #define MGRIDWIDTH 0.6 #define GRIDWIDTH 0.4 -enum gf_en {GF_PRINT=0,GF_GPRINT,GF_COMMENT,GF_HRULE,GF_VRULE,GF_LINE, - GF_AREA,GF_STACK,GF_TICK, - GF_DEF, GF_CDEF, GF_VDEF, GF_SHIFT, -#ifdef WITH_PIECHART - GF_PART, -#endif - GF_XPORT}; +enum gf_en { GF_PRINT = 0, GF_GPRINT, GF_COMMENT, GF_HRULE, GF_VRULE, GF_LINE, + GF_AREA,GF_GRAD, GF_STACK, GF_TICK, GF_TEXTALIGN, + GF_DEF, GF_CDEF, GF_VDEF, GF_SHIFT, + GF_XPORT +}; + +enum txa_en { TXA_LEFT = 0, TXA_RIGHT, TXA_CENTER, TXA_JUSTIFIED }; enum vdef_op_en { - VDEF_MAXIMUM=0 /* like the MAX in (G)PRINT */ - ,VDEF_MINIMUM /* like the MIN in (G)PRINT */ - ,VDEF_AVERAGE /* like the AVERAGE in (G)PRINT */ - ,VDEF_PERCENT /* Nth percentile */ - ,VDEF_TOTAL /* average multiplied by time */ - ,VDEF_FIRST /* first non-unknown value and time */ - ,VDEF_LAST /* last non-unknown value and time */ - ,VDEF_LSLSLOPE /* least squares line slope */ - ,VDEF_LSLINT /* least squares line y_intercept */ - ,VDEF_LSLCORREL /* least squares line correlation coefficient */ - }; -enum text_prop_en { TEXT_PROP_DEFAULT=0, /* default settings */ - TEXT_PROP_TITLE, /* properties for the title */ - TEXT_PROP_AXIS, /* for the numbers next to the axis */ - TEXT_PROP_UNIT, /* for the vertical unit description */ - TEXT_PROP_LEGEND, /* fot the legend below the graph */ - TEXT_PROP_LAST }; + VDEF_MAXIMUM = 0 /* like the MAX in (G)PRINT */ + , VDEF_MINIMUM /* like the MIN in (G)PRINT */ + , VDEF_AVERAGE /* like the AVERAGE in (G)PRINT */ + , VDEF_STDEV /* the standard deviation */ + , VDEF_PERCENT /* Nth percentile */ + , VDEF_TOTAL /* average multiplied by time */ + , VDEF_FIRST /* first non-unknown value and time */ + , VDEF_LAST /* last non-unknown value and time */ + , VDEF_LSLSLOPE /* least squares line slope */ + , VDEF_LSLINT /* least squares line y_intercept */ + , VDEF_LSLCORREL /* least squares line correlation coefficient */ + , VDEF_PERCENTNAN /* Nth percentile ignoring NAN*/ +}; +enum text_prop_en { + TEXT_PROP_DEFAULT = 0, /* default settings */ + TEXT_PROP_TITLE, /* properties for the title */ + TEXT_PROP_AXIS, /* for the numbers next to the axis */ + TEXT_PROP_UNIT, /* for the vertical unit description */ + TEXT_PROP_LEGEND, /* for the legend below the graph */ + TEXT_PROP_WATERMARK, /* for the little text to the side of the graph */ + TEXT_PROP_LAST +}; + +enum legend_pos{ NORTH = 0, WEST, SOUTH, EAST }; +enum legend_direction { TOP_DOWN = 0, BOTTOM_UP }; + +enum gfx_if_en { IF_PNG = 0, IF_SVG, IF_EPS, IF_PDF, + IF_XML=128, IF_CSV=129, IF_TSV=130, IF_SSV=131, IF_JSON=132, + IF_XMLENUM=133, IF_JSONTIME=134 +}; +enum gfx_en { GFX_LINE = 0, GFX_AREA, GFX_TEXT }; +enum gfx_h_align_en { GFX_H_NULL = 0, GFX_H_LEFT, GFX_H_RIGHT, GFX_H_CENTER }; +enum gfx_v_align_en { GFX_V_NULL = 0, GFX_V_TOP, GFX_V_BOTTOM, GFX_V_CENTER }; + +enum gfx_type_en {GTYPE_TIME=0,GTYPE_XY=1}; + +/* cairo color components */ +typedef struct gfx_color_t { + double red; + double green; + double blue; + double alpha; +} gfx_color_t; + typedef struct text_prop_t { - double size; - char font[1024]; + double size; + char font[1024]; + PangoFontDescription *font_desc; } text_prop_t; typedef struct vdef_t { - enum vdef_op_en op; - double param; /* parameter for function, if applicable */ - double val; /* resulting value */ - time_t when; /* timestamp, if applicable */ + enum vdef_op_en op; + double param; /* parameter for function, if applicable */ + double val; /* resulting value */ + time_t when; /* timestamp, if applicable */ + int never; /* boolean, indicate that when value mean never */ } vdef_t; typedef struct xlab_t { - long minsec; /* minimum sec per pix */ - long length; /* number of secs on the image */ - enum tmt_en gridtm; /* grid interval in what ?*/ - long gridst; /* how many whats per grid*/ - enum tmt_en mgridtm; /* label interval in what ?*/ - long mgridst; /* how many whats per label*/ - enum tmt_en labtm; /* label interval in what ?*/ - long labst; /* how many whats per label*/ - long precis; /* label precision -> label placement*/ - char *stst; /* strftime string*/ + long minsec; /* minimum sec per pix */ + long length; /* number of secs on the image */ + enum tmt_en gridtm; /* grid interval in what ? */ + long gridst; /* how many whats per grid */ + enum tmt_en mgridtm; /* label interval in what ? */ + long mgridst; /* how many whats per label */ + enum tmt_en labtm; /* label interval in what ? */ + long labst; /* how many whats per label */ + long precis; /* label precision -> label placement */ + char *stst; /* strftime string */ } xlab_t; typedef struct ygrid_scale_t { /* y axis grid scaling info */ - double gridstep; - int labfact; - char labfmt[64]; + double gridstep; + int labfact; + char labfmt[64]; } ygrid_scale_t; /* sensible y label intervals ...*/ typedef struct ylab_t { - double grid; /* grid spacing */ - int lfac[4]; /* associated label spacing*/ + double grid; /* grid spacing */ + int lfac[4]; /* associated label spacing */ } ylab_t; - /* this structure describes the elements which can make up a graph. because they are quite diverse, not all elements will use all the possible parts of the structure. */ @@ -104,160 +161,379 @@ typedef struct ylab_t { #define FMT_LEG_LEN 2000 #endif -typedef struct graph_desc_t { - enum gf_en gf; /* graphing function */ - int stack; /* boolean */ - int debug; /* boolean */ - char vname[MAX_VNAME_LEN+1]; /* name of the variable */ - long vidx; /* gdes reference */ - char rrd[1024]; /* name of the rrd_file containing data */ - char ds_nam[DS_NAM_SIZE]; /* data source name */ - long ds; /* data source number */ - enum cf_en cf; /* consolidation function */ - enum cf_en cf_reduce; /* consolidation function for reduce_data() */ - gfx_color_t col; /* graph color */ - char format[FMT_LEG_LEN+5]; /* format for PRINT AND GPRINT */ - char legend[FMT_LEG_LEN+5]; /* legend*/ - int strftm; /* should the VDEF legend be formated with strftime */ - double leg_x,leg_y; /* location of legend */ - double yrule; /* value for y rule line and for VDEF */ - time_t xrule; /* time for x rule line and for VDEF */ - vdef_t vf; /* instruction for VDEF function */ - rpnp_t *rpnp; /* instructions for CDEF function */ +typedef struct graph_desc_t { + enum gf_en gf; /* graphing function */ + int stack; /* boolean */ + int debug; /* boolean */ + char vname[MAX_VNAME_LEN + 1]; /* name of the variable */ + long vidx; /* gdes reference */ + char rrd[1024]; /* name of the rrd_file containing data */ + char ds_nam[DS_NAM_SIZE]; /* data source name */ + long ds; /* data source number */ + char daemon[256]; + enum cf_en cf; /* consolidation function */ + enum cf_en cf_reduce; /* consolidation function for reduce_data() */ + struct gfx_color_t col, col2; /* graph color */ + double gradheight; + char format[FMT_LEG_LEN + 5]; /* format for PRINT AND GPRINT */ + char legend[FMT_LEG_LEN + 5]; /* legend */ + int strftm; /* should the VDEF legend be formated with strftime */ + double leg_x, leg_y; /* location of legend */ + double yrule; /* value for y rule line and for VDEF */ + time_t xrule; /* time for x rule line and for VDEF */ + vdef_t vf; /* instruction for VDEF function */ + rpnp_t *rpnp; /* instructions for CDEF function */ /* SHIFT implementation */ - int shidx; /* gdes reference for offset (-1 --> constant) */ - time_t shval; /* offset if shidx is -1 */ - time_t shift; /* current shift applied */ + int shidx; /* gdes reference for offset (-1 --> constant) */ + time_t shval; /* offset if shidx is -1 */ + time_t shift; /* current shift applied */ /* description of data fetched for the graph element */ - time_t start,end; /* timestaps for first and last data element */ - time_t start_orig,end_orig; /* timestaps for first and last data element */ - unsigned long step; /* time between samples */ - unsigned long step_orig; /* time between samples */ - unsigned long ds_cnt; /* how many data sources are there in the fetch */ - long data_first; /* first pointer to this data */ - char **ds_namv; /* name of datasources in the fetch. */ - rrd_value_t *data; /* the raw data drawn from the rrd */ - rrd_value_t *p_data; /* processed data, xsize elments */ - double linewidth; /* linewideth */ + time_t start, end; /* timestaps for first and last data element */ + time_t start_orig, end_orig; /* timestaps for first and last data element */ + unsigned long step; /* time between samples */ + unsigned long step_orig; /* time between samples */ + unsigned long ds_cnt; /* how many data sources are there in the fetch */ + long data_first; /* first pointer to this data */ + char **ds_namv; /* name of datasources in the fetch. */ + rrd_value_t *data; /* the raw data drawn from the rrd */ + rrd_value_t *p_data; /* processed data, xsize elments */ + double linewidth; /* linewideth */ + + /* dashed line stuff */ + int dash; /* boolean, draw dashed line? */ + double *p_dashes; /* pointer do dash array which keeps the lengths of dashes */ + int ndash; /* number of dash segments */ + double offset; /* dash offset along the line */ + + enum txa_en txtalign; /* change default alignment strategy for text */ } graph_desc_t; typedef struct image_desc_t { /* configuration of graph */ + char graphfile[MAXPATH]; /* filename for graphic */ + enum gfx_type_en graph_type; /* type of the graph */ + long xsize, ysize; /* graph area size in pixels */ + struct gfx_color_t graph_col[__GRC_END__]; /* real colors for the graph */ + text_prop_t text_prop[TEXT_PROP_LAST]; /* text properties */ + char ylegend[210]; /* legend along the yaxis */ + char title[210]; /* title for graph */ + char watermark[110]; /* watermark for graph */ + int draw_x_grid; /* no x-grid at all */ + int draw_y_grid; /* no y-grid at all */ + unsigned int draw_3d_border; /* size of border in pixels, 0 for off */ + unsigned int dynamic_labels; /* pick the label shape according to the line drawn */ + double grid_dash_on, grid_dash_off; + xlab_t xlab_user; /* user defined labeling for xaxis */ + char xlab_form[210]; /* format for the label on the xaxis */ + double second_axis_scale; /* relative to the first axis (0 to disable) */ + double second_axis_shift; /* how much is it shifted vs the first axis */ + char second_axis_legend[210]; /* label to put on the seond axis */ + char second_axis_format[210]; /* format for the numbers on the scond axis */ + + double ygridstep; /* user defined step for y grid */ + int ylabfact; /* every how many y grid shall a label be written ? */ + double tabwidth; /* tabwdith */ + time_t start, end; /* what time does the graph cover */ + unsigned long step; /* any preference for the default step ? */ + rrd_value_t minval, maxval; /* extreme values in the data */ + int rigid; /* do not expand range even with + values outside */ + ygrid_scale_t ygrid_scale; /* calculated y axis grid info */ + int gridfit; /* adjust y-axis range etc so all + grindlines falls in integer pixel values */ + char *imginfo; /* construct an 0: + * gradient starts at top and goes down a fixed number of pixels (fire style) + * height < 0: + * gradient starts at bottom and goes up a fixed number of pixels (constant style) + * height == 0: + * gradient is stretched between two points + */ +void gfx_add_rect_fadey( + image_desc_t *im, + double x1,double y1, + double x2,double y2, + double py, + gfx_color_t color1, + gfx_color_t color2, + double height); + + + +/* close current path so it ends at the same point as it started */ +void gfx_close_path( + image_desc_t *im); + + +/* create a text node */ +void gfx_text( + image_desc_t *im, + double x, + double y, + gfx_color_t color, + PangoFontDescription *font_desc, + double tabwidth, + double angle, + enum gfx_h_align_en h_align, + enum gfx_v_align_en v_align, + const char *text); + +/* measure width of a text string */ +double gfx_get_text_width( + image_desc_t *im, + double start, + PangoFontDescription *font_desc, + double tabwidth, + char *text); + + +/* convert color */ +gfx_color_t gfx_hex_to_col( + long unsigned int); + +void gfx_line_fit( + image_desc_t *im, + double *x, + double *y); + +void gfx_area_fit( + image_desc_t *im, + double *x, + double *y); #endif + +void grinfo_push( + image_desc_t *im, + char *key, + rrd_info_type_t type, rrd_infoval_t value); + +