gnuplotC/gnuplotc.h at main · ferxinii/gnuplotC · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
#ifndef PLOT_H
#define PLOT_H

/* -----------------------------------------
 *              GNUPLOTC
 *
 *  Description: C Interface to gnuplot.
 *  Author: Fernando Muñoz.
 *  Github: ferxinii/gnuplotC
 *  License: MIT
 * --------------------------------------- */

typedef struct s_gnuplot s_gnuplot;  // Interface to gnuplot

enum gnuplot_type {
    PNG_2D,
    PDF_2D,
    EPS_2D,
    VIDEO_2D,
    PNG_3D,
    PDF_3D,
    VIDEO_3D
};

enum element_type {
    LINES,
    POINTS,
    LINESPOINTS,
    POLYGONS,
    PM3D
};

extern int GNUPLOTC_FRAMERATE;

// BASIC
s_gnuplot *gnuplot_start(enum gnuplot_type type, const char *file_name, const int size[2], int font_size, ...);
void gnuplot_config(s_gnuplot *interface, ...);
void gnuplot_end(s_gnuplot *interface);
void next_subplot(s_gnuplot *interface);

// VIDEO
void activate_parallel_video_processing(int num_threads);
void next_frame(s_gnuplot *interface, ...);
void video_to_gif(const char *file_video, const char *file_gif, const int size[2], int framerate);

// GENERIC ELEMENTS
void add_datablock_from_file(s_gnuplot *interface, const char *filename, int header_lines_skip, const char *datablock_name);
void draw_datablock(s_gnuplot *interface, const char *datablock_name, enum element_type type, const char *config);
void draw_file(s_gnuplot *interface, const char *file_name, int header_lines_skip, enum element_type type, const char *config);
void draw_command(s_gnuplot *interface, const char *command);

// 2D ELEMENTS:
void draw_point_2d(s_gnuplot *interface, double x, double y, const char *config);
void draw_2d(s_gnuplot *interface, const double *x, const double *y, int N, enum element_type type, const char *config);
void draw_array_2d(s_gnuplot *interface, const double **coords, int N, enum element_type type, const char *config);
void draw_arrows_from_array_2d(s_gnuplot *interface, const double **coords, int N, int spacing, int offset, const char *config);  // Recall size command for head size (and fixed keyword), ex: size 0.2,20 fixed
void draw_errorbars_2d(s_gnuplot *interface, const double *x, const double *mean, const double *err, int N, const char *config);
void draw_segment_2d(s_gnuplot *interface, double x0, double xf, double y0, double yf, const char *config);
void draw_function_2d(s_gnuplot *interface, double x0, double xf, int N, double (*fun)(double), enum element_type type, const char *config);

// 3D ELEMENTS:
void draw_sphere_3d(s_gnuplot *interface, double x, double y, double z, double r, enum element_type type, const char *config);
void draw_solid_triangle_3d(s_gnuplot *interface, const double v0[3], const double v1[3], const double v2[3], const char *config);


/* ---------------------------------
    PRIVATE DECLARATIONS (IGNORE)
  --------------------------------- */

#define FRAMES_DIR "GNUPLOTC_FRAMES_TMP"  // Only created in parallel frame processing mode

#define GNUPLOTC_ARRAY_MARKER  ((char*) -1)

#define GNUPLOTC_ARRAY(arr) \
        GNUPLOTC_ARRAY_MARKER, arr

#define gnuplot_start(obj, ...) \
        gnuplot_start_impl(obj, __VA_OPT__(__VA_ARGS__,) NULL)

s_gnuplot *gnuplot_start_impl(enum gnuplot_type type, const char *file_name, const int size[2], int font_size, ...);

#define gnuplot_config(obj, ...) \
        gnuplot_config_impl(obj, __VA_OPT__(__VA_ARGS__,) NULL)

void gnuplot_config_impl(s_gnuplot *interface, ...);

#define next_subplot(obj, ...) \
        next_subplot_impl(obj, __VA_OPT__(__VA_ARGS__,) NULL)

void next_subplot_impl(s_gnuplot *interface, ...);

#define next_frame(obj, ...) \
        next_frame_impl(obj, __VA_OPT__(__VA_ARGS__,) NULL)

void next_frame_impl(s_gnuplot *interface, ...);

#endif