122 lines
3.5 KiB
Markdown
122 lines
3.5 KiB
Markdown
# AqDiagram
|
|
|
|
Library to create simple diagrams. Work in progress.
|
|
|
|
A diagram can contain multiple curves.
|
|
|
|
## Example Graphs
|
|
|
|
### Example 1
|
|
|
|
|
|
|
|
## Building AqDiagram
|
|
|
|
Download and unpack tar.gz file, CD into the unpacked folder and build like this:
|
|
|
|
```
|
|
mkdir build
|
|
cd build
|
|
gwbuild -s ..
|
|
gwbuild -p
|
|
gwbuild -Btm2builder (not needed with newer versions of gwenbuild)
|
|
gwbuild -jNN (with NN number of parallel processes, e.g. 4 for quadcore cpu)
|
|
sudo gwbuild -i
|
|
```
|
|
|
|
## Structure of AqDiagram
|
|
|
|
AqDiagram consists of 4 parts:
|
|
- data:
|
|
Library for data manipulation (accumulate, negate, diff, average, floating average, sums for days and months)
|
|
- draw:
|
|
Library for drawing text and simple figures (points, lines, rectangles), current implementation for libcairo).
|
|
- placement:
|
|
Library for placement of objects in a plane.
|
|
- graph:
|
|
Library for drawing graphs using the other libraries.
|
|
|
|
|
|
## Code Examples
|
|
|
|
### Simple Graph with a Single Curve
|
|
|
|
```
|
|
AQDG_GRAPH *g;
|
|
AQDG_GRAPH_DATAPAIR_LIST *dpList;
|
|
AQDG_DRAW_CONTEXT *dc;
|
|
AQDG_OBJECT *graphObject;
|
|
|
|
g=AQDG_TimeGraph_new("Title", "Subtitle", "Value", "mm", 0);
|
|
|
|
/* get data to be shown (insert your function here) */
|
|
dpList=CREATE_DATA_FOR_GRAPH();
|
|
|
|
/* add single curve as line graph */
|
|
AQDG_TimeGraph_AddCurve(g, "Testdata", AQDG_GRAPH_TYPE_LINE, dpList);
|
|
|
|
/* setup ticks for X and Y axis (use auto-calculated upper and lower limit) */
|
|
AQDG_TimeGraph_SetupTicks(g, 0, 0.0, 0.0);
|
|
|
|
/* draw graph as PNG file (here with 800x600 pixels) */
|
|
dc=AQDG_Draw_ContextCairo_Png_new("/tmp/testgraph.png", 800, 600);
|
|
graphObject=AQDG_GraphWidget_new(NULL, AQDG_OBJECT_OPTIONS_STRETCHX | AQDG_OBJECT_OPTIONS_STRETCHY, dc);
|
|
AQDG_Object_SetWidth(graphObject, 800);
|
|
AQDG_Object_SetHeight(graphObject, 600);
|
|
|
|
/* use default pens and fonts */
|
|
AQDG_GraphWidget_SetupDefaultPens(graphObject);
|
|
AQDG_GraphWidget_SetupDefaultFonts(graphObject);
|
|
|
|
/* finish creating the PNG file */
|
|
AQDG_GraphWidget_FinishWithGraph(graphObject, g);
|
|
|
|
return 0;
|
|
```
|
|
|
|
|
|
|
|
### Graph with a Bar Graph and a Derived Line Curve
|
|
|
|
```
|
|
AQDG_GRAPH *g;
|
|
AQDG_GRAPH_DATAPAIR_LIST *dpList;
|
|
AQDG_GRAPH_DATAPAIR_LIST *derivedDpList;
|
|
AQDG_DRAW_CONTEXT *dc;
|
|
AQDG_OBJECT *graphObject;
|
|
|
|
g=AQDG_TimeGraph_new("Title", "Subtitle", "Value", "mm", 0);
|
|
|
|
/* get data to be shown (insert your function here) */
|
|
dpList=CREATE_DATA_FOR_GRAPH();
|
|
|
|
/* add first curve as bar graph */
|
|
AQDG_TimeGraph_AddCurve(g, "Testdata", AQDG_GRAPH_TYPE_BARS, dpList);
|
|
|
|
/* use a data modification function on initial data (here: accumulate) */
|
|
derivedDpList=AQDG_Data_Accumulate(dpList);
|
|
|
|
/* add 2nd curve with accumulated data as line graph */
|
|
AQDG_TimeGraph_AddCurve(g, "Accumulated", AQDG_GRAPH_TYPE_LINE, derivedDpList);
|
|
|
|
/* setup ticks for X and Y axis (use auto-calculated upper and lower limit) */
|
|
AQDG_TimeGraph_SetupTicks(g, 0, 0.0, 0.0);
|
|
|
|
/* draw graph as PNG file (here with 800x600 pixels) */
|
|
dc=AQDG_Draw_ContextCairo_Png_new("/tmp/testgraph.png", 800, 600);
|
|
graphObject=AQDG_GraphWidget_new(NULL, AQDG_OBJECT_OPTIONS_STRETCHX | AQDG_OBJECT_OPTIONS_STRETCHY, dc);
|
|
AQDG_Object_SetWidth(graphObject, 800);
|
|
AQDG_Object_SetHeight(graphObject, 600);
|
|
|
|
/* use default pens and fonts */
|
|
AQDG_GraphWidget_SetupDefaultPens(graphObject);
|
|
AQDG_GraphWidget_SetupDefaultFonts(graphObject);
|
|
|
|
/* finish creating the PNG file */
|
|
AQDG_GraphWidget_FinishWithGraph(graphObject, g);
|
|
|
|
return 0;
|
|
```
|
|
|
|
|