gnuplot/src/pm3d.h at 5.5 · gnuplot/gnuplot · GitHub

Repository navigation

History

181 lines (151 loc) · 5.71 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

/* GNUPLOT - pm3d.h */

/*[

* Petr Mikulik, since December 1998

* Copyright: open source as much as possible

* What is here: #defines, global variables and declaration of routines for

* the pm3d plotting mode

]*/

/* avoid multiple includes */

#ifdef HAVE_CONFIG_H

# include "config.h"

#endif

#ifndef TERM_HELP

#ifndef PM3D_H

#define PM3D_H

#include "axis.h" /* only for NONLINEAR_AXES */

#include "graph3d.h" /* struct surface_points */

/****

Global options for pm3d algorithm (to be accessed by set / show)

****/

where to plot pm3d: base or top (color map) or surface (color surface)

The string pm3d.where can be any combination of the #defines below.

For instance, "b" plot at bottom only, "st" plots firstly surface, then top, etc.

#define PM3D_AT_BASE 'b'

#define PM3D_AT_TOP 't'

#define PM3D_AT_SURFACE 's'

options for flushing scans (for pm3d.flush)

Note: new terminology compared to my pm3d program; in gnuplot it became

begin and right instead of left and right

#define PM3D_FLUSH_BEGIN 'b'

#define PM3D_FLUSH_END 'r'

#define PM3D_FLUSH_CENTER 'c'

direction of taking the scans: forward = as the scans are stored in the

file; backward = opposite direction, i.e. like from the end of the file

typedef enum {

PM3D_SCANS_AUTOMATIC,

PM3D_SCANS_FORWARD,

PM3D_SCANS_BACKWARD,

PM3D_DEPTH

} pm3d_scandir;

clipping method:

PM3D_CLIP_1IN: all 4 points of the quadrangle must be defined and at least

1 point of the quadrangle must be in the x and y ranges

PM3D_CLIP_4IN: all 4 points of the quadrangle must be in the x and y ranges

PM3D_CLIP_Z: smooth clip to current zrange

#define PM3D_CLIP_Z 0

#define PM3D_CLIP_1IN '1'

#define PM3D_CLIP_4IN '4'

is pm3d plotting style implicit or explicit?

typedef enum {

PM3D_EXPLICIT = 0,

PM3D_IMPLICIT = 1

} PM3D_IMPL_MODE;

from which corner take the color?

typedef enum {

/* keep the following order of PM3D_WHICHCORNER_C1 .. _C4 */

PM3D_WHICHCORNER_C1 = 0, /* corner 1: first scan, first point */

PM3D_WHICHCORNER_C2 = 1, /* corner 2: first scan, second point */

PM3D_WHICHCORNER_C3 = 2, /* corner 3: second scan, first point */

PM3D_WHICHCORNER_C4 = 3, /* corner 4: second scan, second point */

/* the rest can be in any order */

PM3D_WHICHCORNER_MEAN = 4, /* average z-value from all 4 corners */

PM3D_WHICHCORNER_GEOMEAN = 5, /* geometrical mean of 4 corners */

PM3D_WHICHCORNER_HARMEAN = 6, /* harmonic mean of 4 corners */

PM3D_WHICHCORNER_MEDIAN = 7, /* median of 4 corners */

PM3D_WHICHCORNER_RMS = 8, /* root mean square of 4 corners*/

PM3D_WHICHCORNER_MIN = 9, /* minimum of 4 corners */

PM3D_WHICHCORNER_MAX = 10,/* maximum of 4 corners */

PM3D_COLOR_BY_NORMAL = 11 /* derive color from surface normal (not currently used) */

} PM3D_WHICH_CORNERS2COLOR;

structure defining all properties of pm3d plotting mode

(except for the properties of the smooth color box, see color_box instead)

typedef struct {

char where[7]; /* base, top, surface */

char flush; /* left, right, center */

char ftriangles; /* 0/1 (don't) draw flushing triangles */

char clip; /* 1in, 4in */

TBOOLEAN no_clipcb; /* FALSE: out-of-range cb treated as 0 TRUE: treated as NaN */

pm3d_scandir direction;

/* If direction is "depth" sort by max z of 4 corners unless ... */

TBOOLEAN base_sort; /* use z values of projection to baseplane */

TBOOLEAN zmean_sort; /* sort on mean z rather than max z */

PM3D_IMPL_MODE implicit;

/* 1: [default] draw ALL surfaces with pm3d

0: only surfaces specified with 'with pm3d' */

PM3D_WHICH_CORNERS2COLOR which_corner_color;

/* default: average color from all 4 points */

int interp_i; /* # of interpolation steps along scanline */

int interp_j; /* # of interpolation steps between scanlines */

lp_style_type border; /* LT_NODRAW to disable. From `set pm3d border <linespec> */

} pm3d_struct;

extern pm3d_struct pm3d;

typedef struct lighting_model {

double strength; /* 0 = no lighting model; 1 = full shading */

double spec; /* specular component 0-1 */

double ambient; /* ambient component 0-1 */

double Phong; /* Phong exponent */

int rot_z; /* illumination angle */

int rot_x; /* illumination angle */

TBOOLEAN fixed; /* TRUE means the light does not rotate */

double spec2; /* 2nd specular contribution from red spotlight on opposite side */

double spec2_rot_x;

double spec2_rot_z;

double spec2_Phong;

unsigned long spec2_rgb;

} lighting_model;

extern lighting_model pm3d_shade;

/* Used to initialize `set pm3d border` */

extern struct lp_style_type default_pm3d_border;

/* Set by plot styles that use pm3d quadrangles even in non-pm3d mode */

extern TBOOLEAN track_pm3d_quadrangles;

/****

Declaration of routines

****/

int get_pm3d_at_option(char *pm3d_where);

void pm3d_depth_queue_clear(void);

void pm3d_depth_queue_flush(void);

void pm3d_reset(void);

void pm3d_draw_one(struct surface_points* plots);

void pm3d_add_quadrangle(struct surface_points* plot, gpdPoint *corners);

void pm3d_add_polygon(struct surface_points* plot, gpdPoint *corners, int vertices);

void pm3d_init_lighting_model(void);

int pm3d_side( struct coordinate *p0, struct coordinate *p1, struct coordinate *p2);

double cb2gray(double cb);

void pm3d_rearrange_scan_array(struct surface_points* this_plot,

struct iso_curve*** first_ptr, int* first_n, int* first_invert,

struct iso_curve*** second_ptr, int* second_n, int* second_invert);

void set_plot_with_palette(int plot_num, int plot_mode);

void pm3d_reset_after_error(void);

TBOOLEAN is_plot_with_palette(void);

TBOOLEAN is_plot_with_colorbox(void);

#endif /* PM3D_H */

#endif /* TERM_HELP */

/* eof pm3d.h */

gnuplot/src/pm3d.h at 5.5 · gnuplot/gnuplot · GitHub

Repository navigation

Expand file tree

Breadcrumbs

pm3d.h

Latest commit

History

Breadcrumbs

pm3d.h

File metadata and controls