This graph shows which files directly or indirectly include this file:

Functions
int	Nviz_resize_window (int, int)
	GL canvas resized.

int	Nviz_update_ranges (nv_data *)
	Update ranges.

int	Nviz_set_viewpoint_position (double, double)
	Change position of view.

void	Nviz_get_viewpoint_position (double , double )

int	Nviz_set_viewpoint_height (double)
	Change viewpoint height.

void	Nviz_get_viewpoint_height (double *)

int	Nviz_set_viewpoint_persp (int)
	Change viewpoint perspective (field of view)

int	Nviz_set_viewpoint_twist (int)
	Change viewpoint twist.

int	Nviz_change_exag (nv_data *, double)
	Change z-exag value.

int	Nviz_look_here (double, double)
	Change focused point.

void	Nviz_get_modelview (double *)
	Get current modelview matrix.

void	Nviz_set_rotation (double, double, double, double)
	Set rotation parameters.

void	Nviz_unset_rotation (void)
	Stop scene rotation.

void	Nviz_init_rotation (void)
	Stop scene rotation.

void	Nviz_flythrough (nv_data , float , int *, int)
	Fly through the scene.

int	Nviz_new_cplane (nv_data *, int)
	Creates a clip plane object.

int	Nviz_on_cplane (nv_data *, int)
	Turn on (make current) the given clip plane.

int	Nviz_off_cplane (nv_data *, int)
	Turn off (make inactive) the given clip plane.

int	Nviz_draw_cplane (nv_data *, int, int)
	Draw the clip plane.

int	Nviz_num_cplanes (nv_data *)
	Return the number of clip planes objects currently allocated.

int	Nviz_get_current_cplane (nv_data *)
	Get the current active cutplane.

int	Nviz_set_cplane_rotation (nv_data *, int, float, float, float)
	Set the rotation for the current clip plane.

int	Nviz_get_cplane_rotation (nv_data , int, float , float , float )
	Get the rotation values for the current clip plane.

int	Nviz_set_cplane_translation (nv_data *, int, float, float, float)
	Set the translation for the current clip plane.

int	Nviz_get_cplane_translation (nv_data , int, float , float , float )
	Get the translation values for the current clip plane.

int	Nviz_set_fence_color (nv_data *, int)
	Set appropriate fence color.

int	Nviz_set_cplane_here (nv_data *, int, float, float)

int	Nviz_draw_all_surf (nv_data *)
	Draw all loaded surfaces.

int	Nviz_draw_all_vect (void)
	Draw all loaded vector sets (lines)

int	Nviz_draw_all_site (void)
	Draw all loaded vector point sets.

int	Nviz_draw_all_vol (void)
	Draw all loaded volume sets.

int	Nviz_draw_all (nv_data *)
	Draw all map objects (in full resolution) and decorations.

int	Nviz_draw_quick (nv_data *, int)
	Draw all surfaces in wireframe (quick mode)

int	Nviz_load_image (GLubyte *, int, int, int)
	Load image into texture.

void	Nviz_draw_image (int, int, int, int, int)
	Draw image as texture.

void	Nviz_set_2D (int, int)
	Set ortho view for drawing images.

void	Nviz_del_texture (int)
	Delete texture.

void	Nviz_get_max_texture (int *)
	Get maximum texture size.

int	Nviz_get_exag_height (double , double , double *)
	Get view height.

double	Nviz_get_exag (void)
	Get view z-exag value.

int	Nviz_set_light_position (nv_data *, int, double, double, double, double)
	Set light position.

int	Nviz_set_light_bright (nv_data *, int, double)
	Set light brightness.

int	Nviz_set_light_color (nv_data *, int, int, int, int)
	Set light color.

int	Nviz_set_light_ambient (nv_data *, int, double)
	Set light ambient.

int	Nviz_init_light (nv_data *, int)
	Init new light.

int	Nviz_new_light (nv_data *)
	Define new light.

void	Nviz_draw_model (nv_data *)
	Draw lighting model.

int	Nviz_new_map_obj (int, const char , double, nv_data )
	Create a new map object which can be one of surf, vect, vol or site.

int	Nviz_set_attr (int, int, int, int, const char , double, nv_data )

void	Nviz_set_surface_attr_default (void)
	Set default surface attributes.

int	Nviz_set_vpoint_attr_default (int)
	Set default vector point attributes.

int	Nviz_set_volume_attr_default (int)
	Set default volume attributes.

int	Nviz_unset_attr (int, int, int)

void	Nviz_init_data (nv_data *)
	Initialize Nviz data.

void	Nviz_destroy_data (nv_data *)
	Free allocated space by nv_data struct.

void	Nviz_set_bgcolor (nv_data *, int)
	Set background color.

int	Nviz_get_bgcolor (nv_data *)
	Get background color.

int	Nviz_color_from_str (const char *)
	Get color value from color string (name or RGB triplet)

struct fringe_data *	Nviz_new_fringe (nv_data *, int, unsigned long, double, int, int, int, int)

struct fringe_data *	Nviz_set_fringe (nv_data *, int, unsigned long, double, int, int, int, int)

void	Nviz_draw_fringe (nv_data *data)

int	Nviz_draw_arrow (nv_data *)
	Draws the North Arrow.

int	Nviz_set_arrow (nv_data *, int, int, float, unsigned int)
	Sets the North Arrow position and return world coords.

void	Nviz_delete_arrow (nv_data *)
	Deletes the North Arrow.

struct scalebar_data *	Nviz_new_scalebar (nv_data , int, float , float, unsigned int)

struct scalebar_data *	Nviz_set_scalebar (nv_data *, int, int, int, float, unsigned int)
	Sets the scale bar position and return world coords.

void	Nviz_draw_scalebar (nv_data *)
	Draws the Scale bar.

void	Nviz_delete_scalebar (nv_data *, int)
	Deletes scale bar.

void	Nviz_init_view (nv_data *)

int	Nviz_set_focus_state (int)
	Set focus state.

int	Nviz_set_focus_map (int, int)
	Set focus based on loaded map.

int	Nviz_has_focus (nv_data *)
	Test focus.

int	Nviz_set_focus (nv_data *, float, float, float)
	Set focus.

int	Nviz_get_focus (nv_data , float , float , float )
	Get focus.

float	Nviz_get_xyrange (nv_data *)
	Get xy range.

int	Nviz_get_zrange (nv_data , float , float *)
	Get z range.

float	Nviz_get_longdim (nv_data *)
	Get largest dimension.

struct render_window *	Nviz_new_render_window (void)
	Allocate memory for render window.

void	Nviz_init_render_window (struct render_window *)
	Initialize render window.

void	Nviz_destroy_render_window (struct render_window *)
	Free render window.

int	Nviz_create_render_window (struct render_window , void , int, int)
	Create render window.

int	Nviz_make_current_render_window (const struct render_window *)
	Make window current for rendering.

Function Documentation

◆ Nviz_change_exag()

int Nviz_change_exag	(	nv_data *	data,
		double	exag
	)

Change z-exag value.

Parameters

data	nviz data
exag	exag value

Returns: 1

Definition at line 238 of file change_view.c.

References G_debug(), GS_global_exag(), GS_set_global_exag(), and Nviz_update_ranges().

◆ Nviz_color_from_str()

int Nviz_color_from_str ( const char * color_str )

Get color value from color string (name or RGB triplet)

Parameters

color_str color string

Returns: color value

Definition at line 125 of file nviz.c.

References _, BLU_MASK, G_str_to_color(), G_warning(), GRN_MASK, and RED_MASK.

◆ Nviz_create_render_window()

int Nviz_create_render_window	(	struct render_window *	rwin,
		void *	display,
		int	width,
		int	height
	)

Create render window.

Parameters

rwin	pointer to render_window struct
display	display instance (NULL for offscreen) [unused]
width	window width
height	window height

Returns: 0 on success; -1 on error

Definition at line 157 of file nviz/render.c.

References _, G_fatal_error(), G_warning(), render_window::height, NULL, and render_window::width.

◆ Nviz_del_texture()

void Nviz_del_texture ( int texture_id )

Delete texture.

Parameters

texture_id texture id

Definition at line 408 of file nviz/draw.c.

References t.

◆ Nviz_delete_arrow()

void Nviz_delete_arrow ( nv_data * data )

Deletes the North Arrow.

Parameters

data nviz data

Definition at line 315 of file nviz.c.

References nv_data::draw_arrow.

◆ Nviz_delete_scalebar()

void Nviz_delete_scalebar	(	nv_data *	data,
		int	bar_id
	)

Deletes scale bar.

When scalebar is freed, array then contains NULL, which must be tested during drawing.

Parameters

data nviz data

Definition at line 435 of file nviz.c.

References G_free(), NULL, and nv_data::scalebar.

◆ Nviz_destroy_data()

void Nviz_destroy_data ( nv_data * data )

Free allocated space by nv_data struct.

Parameters

data nviz data

Definition at line 68 of file nviz.c.

References nv_data::arrow, nv_data::draw_arrow, nv_data::fringe, G_free(), NULL, nv_data::num_fringes, nv_data::num_scalebars, and nv_data::scalebar.

◆ Nviz_destroy_render_window()

void Nviz_destroy_render_window ( struct render_window * rwin )

Free render window.

Parameters

win	pointer to render_window struct

Definition at line 123 of file nviz/render.c.

References G_free().

◆ Nviz_draw_all()

int Nviz_draw_all ( nv_data * data )

Draw all map objects (in full resolution) and decorations.

Parameters

data nviz data

Definition at line 204 of file nviz/draw.c.

References nv_data::arrow, nv_data::bgcolor, fringe_data::color, scalebar_data::color, nv_data::draw_arrow, fringe_data::elev, nv_data::fringe, GS_clear(), GS_done_draw(), GS_draw_fringe(), GS_ready_draw(), GS_set_draw(), GSD_BACK, gsd_north_arrow(), gsd_scalebar_v2(), fringe_data::id, nv_data::num_fringes, nv_data::num_scalebars, Nviz_draw_all_site(), Nviz_draw_all_surf(), Nviz_draw_all_vect(), Nviz_draw_all_vol(), nv_data::scalebar, scalebar_data::size, scalebar_data::where, and fringe_data::where.

◆ Nviz_draw_all_site()

int Nviz_draw_all_site ( void )

Draw all loaded vector point sets.

Returns: 1

Definition at line 146 of file nviz/draw.c.

References G_free(), GP_draw_site(), GP_get_site_list(), GS_done_draw(), GS_ready_draw(), GS_set_draw(), GSD_BACK, and GSD_BOTH.

Referenced by Nviz_draw_all().

◆ Nviz_draw_all_surf()

int Nviz_draw_all_surf ( nv_data * dc )

Draw all loaded surfaces.

Parameters

dc nviz data

Returns: 1

Definition at line 32 of file nviz/draw.c.

References G_free(), GS_draw_cplane_fence(), GS_draw_surf(), GS_get_surf_list(), GS_setlight_position(), MAX_CPLANES, MAX_SURFS, and x.

Referenced by Nviz_draw_all().

◆ Nviz_draw_all_vect()

int Nviz_draw_all_vect ( void )

Draw all loaded vector sets (lines)

Returns: 1

Definition at line 121 of file nviz/draw.c.

References GS_done_draw(), GS_ready_draw(), GS_set_draw(), GSD_BACK, GSD_BOTH, and GV_alldraw_vect().

Referenced by Nviz_draw_all().

◆ Nviz_draw_all_vol()

int Nviz_draw_all_vol ( void )

Draw all loaded volume sets.

Returns: 1

Definition at line 175 of file nviz/draw.c.

References G_free(), GS_done_draw(), GS_ready_draw(), GS_set_draw(), GSD_BACK, GSD_BOTH, GVL_draw_vol(), and GVL_get_vol_list().

Referenced by Nviz_draw_all().

◆ Nviz_draw_arrow()

int Nviz_draw_arrow ( nv_data * data )

Draws the North Arrow.

Parameters

data nviz data

Definition at line 298 of file nviz.c.

References nv_data::arrow, nv_data::draw_arrow, and gsd_north_arrow().

◆ Nviz_draw_cplane()

int Nviz_draw_cplane	(	nv_data *	data,
		int	bound1,
		int	bound2
	)

Draw the clip plane.

Parameters

data	nviz data
bound1
bound2

Definition at line 78 of file cplanes_obj.c.

References nv_data::cur_cplane.

◆ Nviz_draw_fringe()

void Nviz_draw_fringe ( nv_data * data )

Draw fringe

Parameters

data nviz data

Definition at line 234 of file nviz.c.

References fringe_data::color, fringe_data::elev, nv_data::fringe, GS_draw_fringe(), fringe_data::id, nv_data::num_fringes, and fringe_data::where.

◆ Nviz_draw_image()

void Nviz_draw_image	(	int	x,
		int	y,
		int	width,
		int	height,
		int	texture_id
	)

Draw image as texture.

Parameters

x,y	image coordinates
width,height	image size
texture_id	texture id

Definition at line 379 of file nviz/draw.c.

References GS_done_draw(), GS_set_draw(), GSD_FRONT, and x.

◆ Nviz_draw_model()

void Nviz_draw_model ( nv_data * data )

Draw lighting model.

Parameters

data	nviz data [unused]

Definition at line 186 of file lights.c.

References GS_done_draw(), GS_draw_lighting_model(), GS_ready_draw(), GS_set_draw(), GSD_BACK, and GSD_FRONT.

◆ Nviz_draw_quick()

int Nviz_draw_quick	(	nv_data *	data,
		int	draw_mode
	)

Draw all surfaces in wireframe (quick mode)

Draw modes:

DRAW_QUICK_SURFACE
DRAW_QUICK_VLINES
DRAW_QUICK_VPOINTS
DRAW_QUICK_VOLUME

Parameters

data	nviz data
draw_mode	draw mode

Returns: 1

Definition at line 281 of file nviz/draw.c.

References nv_data::bgcolor, DRAW_QUICK_SURFACE, DRAW_QUICK_VLINES, DRAW_QUICK_VOLUME, DRAW_QUICK_VPOINTS, GP_alldraw_site(), GS_alldraw_wire(), GS_clear(), GS_done_draw(), GS_ready_draw(), GS_set_draw(), GSD_BACK, GV_alldraw_vect(), and GVL_alldraw_wire().

◆ Nviz_draw_scalebar()

void Nviz_draw_scalebar ( nv_data * data )

Draws the Scale bar.

Parameters

data nviz data

Definition at line 412 of file nviz.c.

References scalebar_data::color, gsd_scalebar_v2(), nv_data::num_scalebars, nv_data::scalebar, scalebar_data::size, and scalebar_data::where.

◆ Nviz_flythrough()

void Nviz_flythrough	(	nv_data *	data,
		float *	fly_info,
		int *	scale,
		int	lateral
	)

Fly through the scene.

Computes parameters needed for moving scene. Changes viewpoint and viewdir. Based on visualization/nviz/src/togl_flythrough.c and simplified.

Parameters

data	nviz data [unused]
fly_info	values computed from mouse movement
scale	rate of movement
lateral	type of movement

Definition at line 324 of file change_view.c.

References GS_get_from(), GS_get_viewdir(), GS_moveto(), GS_set_viewdir(), M_PI, X, Y, and Z.

◆ Nviz_get_bgcolor()

int Nviz_get_bgcolor ( nv_data * data )

Get background color.

Parameters

data nviz data

Returns: color color value

Definition at line 113 of file nviz.c.

References nv_data::bgcolor.

◆ Nviz_get_cplane_rotation()

int Nviz_get_cplane_rotation	(	nv_data *	data,
		int	id,
		float *	dx,
		float *	dy,
		float *	dz
	)

Get the rotation values for the current clip plane.

Parameters

data	nviz data
id	id of current clip plane
dx,dy,dz	rotation parameters

Returns: 1

Definition at line 196 of file cplanes_obj.c.

References nv_data::cp_rot, X, Y, and Z.

◆ Nviz_get_cplane_translation()

int Nviz_get_cplane_translation	(	nv_data *	data,
		int	id,
		float *	dx,
		float *	dy,
		float *	dz
	)

Get the translation values for the current clip plane.

Parameters

data	nviz data
id	id of current clip plane
dx,dy,dz	translation parameters

Definition at line 236 of file cplanes_obj.c.

References nv_data::cp_trans, X, Y, and Z.

Referenced by Nviz_set_cplane_here().

◆ Nviz_get_current_cplane()

int Nviz_get_current_cplane ( nv_data * data )

Get the current active cutplane.

Parameters

data nviz data

Definition at line 157 of file cplanes_obj.c.

References nv_data::cur_cplane.

◆ Nviz_get_exag()

double Nviz_get_exag ( void )

Get view z-exag value.

Call after initial data has been loaded

Returns: value

Definition at line 79 of file exag.c.

References G_debug(), G_free(), GS_get_exag_guess(), GS_get_surf_list(), and NULL.

◆ Nviz_get_exag_height()

int Nviz_get_exag_height	(	double *	val,
		double *	min,
		double *	max
	)

Get view height.

Call after initial data has been loaded

Parameters

[out]	val	height value
[out]	min	min value (or NULL)
[out]	max	max value (or NULL)

Returns: 1

Definition at line 29 of file exag.c.

References G_debug(), G_free(), GS_get_exag_guess(), GS_get_longdim(), GS_get_surf_list(), GS_get_zrange_nz(), max, min, and NULL.

◆ Nviz_get_focus()

int Nviz_get_focus	(	nv_data *	data,
		float *	x,
		float *	y,
		float *	z
	)

Get focus.

Parameters

data	nviz data [unused]
x,y,z	focus coordinates

Definition at line 120 of file position.c.

References GS_get_focus(), and x.

◆ Nviz_get_longdim()

float Nviz_get_longdim ( nv_data * data )

Get largest dimension.

Parameters

data	nviz data [unused]

Definition at line 197 of file position.c.

References GS_get_longdim().

◆ Nviz_get_max_texture()

void Nviz_get_max_texture ( int * size )

Get maximum texture size.

Definition at line 420 of file nviz/draw.c.

References scalebar_data::size.

◆ Nviz_get_modelview()

void Nviz_get_modelview ( double * modelMatrix )

Get current modelview matrix.

Definition at line 272 of file change_view.c.

◆ Nviz_get_viewpoint_height()

void Nviz_get_viewpoint_height ( double * height )

Definition at line 181 of file change_view.c.

References G_debug(), GS_get_from_real(), and Z.

◆ Nviz_get_viewpoint_position()

void Nviz_get_viewpoint_position	(	double *	x_pos,
		double *	y_pos
	)

Definition at line 131 of file change_view.c.

References G_debug(), GS_get_from(), RANGE, RANGE_OFFSET, X, and Y.

◆ Nviz_get_xyrange()

float Nviz_get_xyrange ( nv_data * data )

Get xy range.

Parameters

data nviz data

Definition at line 175 of file position.c.

References nv_data::xyrange.

◆ Nviz_get_zrange()

int Nviz_get_zrange	(	nv_data *	data,
		float *	min,
		float *	max
	)

Get z range.

Parameters

data	nviz data [unused]
min,max	z range

Definition at line 186 of file position.c.

References GS_get_zrange_nz(), max, and min.

◆ Nviz_has_focus()

int Nviz_has_focus ( nv_data * data )

Test focus.

Parameters

data	nviz data [unused]

Definition at line 160 of file position.c.

References GS_get_focus().

◆ Nviz_init_data()

void Nviz_init_data ( nv_data * data )

Initialize Nviz data.

Parameters

data nviz data

Definition at line 26 of file nviz.c.

References nv_data::arrow, nv_data::cur_cplane, nv_data::draw_arrow, nv_data::fringe, GS_set_light_reset(), MAX_CPLANES, MAX_LIGHTS, NULL, nv_data::num_cplanes, nv_data::num_fringes, nv_data::num_scalebars, Nviz_new_cplane(), Nviz_new_light(), Nviz_off_cplane(), nv_data::scalebar, nv_data::xyrange, and nv_data::zrange.

◆ Nviz_init_light()

int Nviz_init_light	(	nv_data *	data,
		int	num
	)

Init new light.

Parameters

data	nviz data
num	light num (starts at 1)

Definition at line 134 of file lights.c.

References light_data::ab, light_data::ag, light_data::ar, light_data::b, light_data::brt, light_data::g, G_debug(), light_data::id, nv_data::light, MAX_LIGHTS, light_data::r, light_data::w, light_data::x, light_data::y, and light_data::z.

Referenced by Nviz_new_light().

◆ Nviz_init_render_window()

void Nviz_init_render_window ( struct render_window * rwin )

Initialize render window.

Parameters

rwin	pointer to render_window struct

Definition at line 94 of file nviz/render.c.

References NULL.

◆ Nviz_init_rotation()

void Nviz_init_rotation ( void )

Stop scene rotation.

Definition at line 306 of file change_view.c.

References GS_init_rotation().

◆ Nviz_init_view()

void Nviz_init_view ( nv_data * data )

Initialize view, position, lighting settings (focus)

Set position to center of view

Definition at line 24 of file position.c.

References GS_init_view(), Nviz_set_focus_state(), Nviz_set_light_ambient(), Nviz_set_light_bright(), Nviz_set_light_color(), and Nviz_set_light_position().

◆ Nviz_load_image()

int Nviz_load_image	(	GLubyte *	image_data,
		int	width,
		int	height,
		int	alpha
	)

Load image into texture.

Parameters

image_data	image data
width,height	image screen size
alpha	has alpha channel

Definition at line 318 of file nviz/draw.c.

References GL_CLAMP_TO_EDGE.

◆ Nviz_look_here()

int Nviz_look_here	(	double	sx,
		double	sy
	)

Change focused point.

Parameters

sx,sy screen coordinates

Returns: 1

Definition at line 262 of file change_view.c.

References G_debug(), and GS_look_here().

◆ Nviz_make_current_render_window()

int Nviz_make_current_render_window ( const struct render_window * rwin )

Make window current for rendering.

Parameters

rwin	pointer to render_window struct

Returns: 1 on success; 0 on failure

Definition at line 325 of file nviz/render.c.

References _, and G_warning().

◆ Nviz_new_cplane()

int Nviz_new_cplane	(	nv_data *	data,
		int	id
	)

Creates a clip plane object.

The number of clip planes is fixed (MAX_CPLANES) and we'll create them all ahead of time anyway we just let the user decide on the id for each.

Parameters

data	nviz data
id	cplane id

Definition at line 31 of file cplanes_obj.c.

References nv_data::cp_on, nv_data::cp_rot, nv_data::cp_trans, nv_data::num_cplanes, X, Y, and Z.

Referenced by Nviz_init_data().

◆ Nviz_new_fringe()

struct fringe_data * Nviz_new_fringe	(	nv_data *	data,
		int	id,
		unsigned long	color,
		double	elev,
		int	nw,
		int	ne,
		int	sw,
		int	se
	)

Add new fringe

Parameters

data	nviz data
id	surface id
color	color
elev	fringe elevation
nw,ne,sw,se	1 (turn on) 0 (turn off)

Returns: pointer to allocated fringe_data structure; NULL on error

Definition at line 150 of file nviz.c.

References fringe_data::color, fringe_data::elev, nv_data::fringe, G_free(), G_malloc, G_realloc, GS_get_surf_list(), GS_surf_exists(), fringe_data::id, NULL, nv_data::num_fringes, and fringe_data::where.

Referenced by Nviz_set_fringe().

◆ Nviz_new_light()

int Nviz_new_light ( nv_data * data )

Define new light.

Parameters

data nviz data

Returns: 1 on success; 0 on failure

Definition at line 165 of file lights.c.

References _, G_warning(), GS_new_light(), and Nviz_init_light().

Referenced by Nviz_init_data().

◆ Nviz_new_map_obj()

int Nviz_new_map_obj	(	int	type,
		const char *	name,
		double	value,
		nv_data *	data
	)

Create a new map object which can be one of surf, vect, vol or site.

This routine creates the object internally in the gsf libraryb. Optionally, a logical name may be specified for the new map object. If no name is specified, a logical name is assigned to the new object automatically. Note that maintaining unique logical names is not the responsibility of the library (currently).

Initially map objects contain no data, use the attribute commands to set attributes such as topology, color, etc.

Parameters

type	map object type
name	map name (NULL for constant)
value	constant (used if name is NULL)
data	nviz data

Returns: map object id; -1 on error

Definition at line 46 of file map_obj.c.

References _, ATT_TOPO, CONST_ATT, G_free(), G_warning(), GP_delete_site(), GP_load_site(), GP_new_site(), GP_num_sites(), GP_select_surf(), GP_set_style(), GS_get_surf_list(), GS_new_surface(), GS_num_surfs(), GV_delete_vector(), GV_load_vector(), GV_new_vector(), GV_num_vects(), GV_select_surf(), GV_set_style(), GVL_delete_vol(), GVL_load_vol(), GVL_new_vol(), GVL_num_vols(), MAP_ATT, MAP_OBJ_SITE, MAP_OBJ_SURF, MAP_OBJ_VECT, MAP_OBJ_VOL, MAX_SITES, MAX_SURFS, MAX_VECTS, MAX_VOLS, name, NULL, Nviz_set_attr(), Nviz_set_volume_attr_default(), Nviz_set_vpoint_attr_default(), and ST_X.

◆ Nviz_new_render_window()

struct render_window * Nviz_new_render_window ( void )

Allocate memory for render window.

Returns: pointer to render_window struct; NULL on failure

Definition at line 79 of file nviz/render.c.

References G_malloc.

◆ Nviz_new_scalebar()

struct scalebar_data * Nviz_new_scalebar	(	nv_data *	data,
		int	bar_id,
		float *	coords,
		float	size,
		unsigned int	color
	)

Add new scalebar

Parameters

data	nviz data
bar_id	scale bar id
coords	real(?) coordinates
size	scale bar length
color	scalebar/text color

Returns: pointer to allocated scalebar_data structure; NULL on error

Definition at line 333 of file nviz.c.

References scalebar_data::color, G_malloc, G_realloc, scalebar_data::id, nv_data::num_scalebars, nv_data::scalebar, scalebar_data::size, and scalebar_data::where.

Referenced by Nviz_set_scalebar().

◆ Nviz_num_cplanes()

int Nviz_num_cplanes ( nv_data * data )

Return the number of clip planes objects currently allocated.

Parameters

data nviz data

Definition at line 147 of file cplanes_obj.c.

References nv_data::num_cplanes.

◆ Nviz_off_cplane()

int Nviz_off_cplane	(	nv_data *	data,
		int	id
	)

Turn off (make inactive) the given clip plane.

Parameters

data	nviz data
id	cplane id

Definition at line 63 of file cplanes_obj.c.

References nv_data::cp_on, and GS_unset_cplane().

Referenced by Nviz_init_data().

◆ Nviz_on_cplane()

int Nviz_on_cplane	(	nv_data *	data,
		int	id
	)

Turn on (make current) the given clip plane.

Parameters

data	nviz data
id	cplane id

Definition at line 48 of file cplanes_obj.c.

References nv_data::cp_on, nv_data::cur_cplane, and GS_set_cplane().

◆ Nviz_resize_window()

int Nviz_resize_window	(	int	width,
		int	height
	)

GL canvas resized.

Parameters

width	window width
height	window height

Returns: 1 on success; 0 on failure (window resized by default to 20x20 px)

Definition at line 30 of file change_view.c.

References G_debug(), GS_alldraw_wire(), GS_done_draw(), GS_ready_draw(), GS_set_draw(), GS_set_viewport(), and GSD_BACK.

◆ Nviz_set_2D()

void Nviz_set_2D	(	int	width,
		int	height
	)

Set ortho view for drawing images.

Parameters

width,height image screen size

Definition at line 355 of file nviz/draw.c.

◆ Nviz_set_arrow()

int Nviz_set_arrow	(	nv_data *	data,
		int	sx,
		int	sy,
		float	size,
		unsigned int	color
	)

Sets the North Arrow position and return world coords.

Parameters

data	nviz data
sx,sy	screen coordinates
size	arrow length
color	arrow/text color

Definition at line 253 of file nviz.c.

References nv_data::arrow, arrow_data::color, G_free(), G_malloc, GS_get_surf_list(), GS_num_surfs(), GS_set_Narrow(), fringe_data::id, and arrow_data::size.

◆ Nviz_set_attr()

int Nviz_set_attr	(	int	id,
		int	type,
		int	desc,
		int	src,
		const char *	str_value,
		double	num_value,
		nv_data *	data
	)

Set map object attribute

Parameters

id	map object id
type	map object type (MAP_OBJ_SURF, MAP_OBJ_VECT, ...)
desc	attribute descriptor
src	attribute source
str_value	attribute value as string (if NULL, check for num_value)
num_value	attribute value as double

Returns: 1 on success; 0 on failure

Definition at line 182 of file map_obj.c.

References ATT_COLOR, ATT_TOPO, CONST_ATT, DM_GOURAUD, DM_GRID_SURF, DM_POLY, FALLTHROUGH, GS_get_dims(), GS_load_att_map(), GS_set_att_const(), GS_set_drawmode(), GS_set_drawres(), MAP_ATT, MAP_OBJ_SURF, max, and Nviz_update_ranges().

Referenced by Nviz_new_map_obj().

◆ Nviz_set_bgcolor()

void Nviz_set_bgcolor	(	nv_data *	data,
		int	color
	)

Set background color.

Parameters

data	nviz data
color	color value

Definition at line 99 of file nviz.c.

References nv_data::bgcolor.

◆ Nviz_set_cplane_here()

int Nviz_set_cplane_here	(	nv_data *	data,
		int	cplane,
		float	sx,
		float	sy
	)

Definition at line 258 of file cplanes_obj.c.

References FROM, GS_distance(), GS_get_region(), GS_get_selected_point_on_surface(), gs_get_surf(), GS_v3dir(), GS_v3mult(), gsd_get_los(), Nviz_get_cplane_translation(), Nviz_set_cplane_translation(), TO, X, x, Y, and Z.

◆ Nviz_set_cplane_rotation()

int Nviz_set_cplane_rotation	(	nv_data *	data,
		int	id,
		float	dx,
		float	dy,
		float	dz
	)

Set the rotation for the current clip plane.

Parameters

data	nviz data
id	id of current clip plane
dx,dy,dz	rotation parameters

Returns: 1

Definition at line 172 of file cplanes_obj.c.

References nv_data::cp_rot, nv_data::cur_cplane, GS_set_cplane_rot(), X, Y, and Z.

◆ Nviz_set_cplane_translation()

int Nviz_set_cplane_translation	(	nv_data *	data,
		int	id,
		float	dx,
		float	dy,
		float	dz
	)

Set the translation for the current clip plane.

Parameters

data	nviz data
id	id of current clip plane
dx,dy,dz	values for setting translation

Returns: 1

Definition at line 215 of file cplanes_obj.c.

References nv_data::cp_trans, nv_data::cur_cplane, GS_set_cplane_trans(), X, Y, and Z.

Referenced by Nviz_set_cplane_here().

◆ Nviz_set_fence_color()

int Nviz_set_fence_color	(	nv_data *	data,
		int	type
	)

Set appropriate fence color.

Parameters

type	type of fence (FC_ABOVE, FC_BELOW, FC_BLEND, FC_GREY, FC_OFF)

Definition at line 251 of file cplanes_obj.c.

References GS_set_fencecolor().

◆ Nviz_set_focus()

int Nviz_set_focus	(	nv_data *	data,
		float	x,
		float	y,
		float	z
	)

Set focus.

Parameters

data	nviz data [unused]
x,y,z	focus coordinates

Definition at line 141 of file position.c.

References GS_set_focus(), and x.

◆ Nviz_set_focus_map()

int Nviz_set_focus_map	(	int	type,
		int	id
	)

Set focus based on loaded map.

If map is MAP_OBJ_UNDEFINED, set focus from first surface/volume in the list.

Parameters

type	map object type
id	map object id

Returns: 0 on no focus; id id of map object used for setting focus

Definition at line 76 of file position.c.

References G_free(), GS_get_surf_list(), GS_num_surfs(), GS_set_focus_center_map(), GS_set_nofocus(), GVL_get_vol_list(), GVL_num_vols(), GVL_set_focus_center_map(), MAP_OBJ_SURF, MAP_OBJ_UNDEFINED, and MAP_OBJ_VOL.

◆ Nviz_set_focus_state()

int Nviz_set_focus_state ( int state_flag )

Set focus state.

Parameters

state_flag 1 for center view, 0 use viewdir

Returns: 1 on success; 0 on failure

Definition at line 50 of file position.c.

References _, G_warning(), GS_set_infocus(), and GS_set_nofocus().

Referenced by Nviz_init_view().

◆ Nviz_set_fringe()

struct fringe_data * Nviz_set_fringe	(	nv_data *	data,
		int	id,
		unsigned long	color,
		double	elev,
		int	nw,
		int	ne,
		int	sw,
		int	se
	)

Set fringe

Parameters

data	nviz data
id	surface id
color	color
elev	fringe elevation
nw,ne,sw,se	1 (turn on) 0 (turn off)

Returns: pointer to allocated fringe_data structure; NULL on error

Definition at line 194 of file nviz.c.

References fringe_data::color, fringe_data::elev, nv_data::fringe, G_free(), GS_get_surf_list(), GS_surf_exists(), fringe_data::id, NULL, nv_data::num_fringes, Nviz_new_fringe(), and fringe_data::where.

◆ Nviz_set_light_ambient()

int Nviz_set_light_ambient	(	nv_data *	data,
		int	num,
		double	value
	)

Set light ambient.

Parameters

data	nviz data
num	light num (starts at 1)
value	ambient value (same for R/G/B) (0-1)

Definition at line 116 of file lights.c.

References light_data::ab, light_data::ag, light_data::ar, G_debug(), GS_setlight_ambient(), and nv_data::light.

Referenced by Nviz_init_view().

◆ Nviz_set_light_bright()

int Nviz_set_light_bright	(	nv_data *	data,
		int	num,
		double	value
	)

Set light brightness.

Parameters

data	nviz data
num	light num (starts at 1)
value	brightness value

Definition at line 65 of file lights.c.

References light_data::b, b, light_data::brt, light_data::g, g, G_debug(), GS_setlight_color(), nv_data::light, light_data::r, and r.

Referenced by Nviz_init_view().

◆ Nviz_set_light_color()

int Nviz_set_light_color	(	nv_data *	data,
		int	num,
		int	red,
		int	green,
		int	blue
	)

Set light color.

Parameters

data	nviz data
num	light num (starts at 1)
red,green,blue	RGB values (0-255)

Definition at line 90 of file lights.c.

References light_data::b, b, light_data::brt, light_data::g, g, G_debug(), GS_setlight_color(), nv_data::light, light_data::r, and r.

Referenced by Nviz_init_view().

◆ Nviz_set_light_position()

int Nviz_set_light_position	(	nv_data *	data,
		int	num,
		double	x,
		double	y,
		double	z,
		double	w
	)

Set light position.

Parameters

data	nviz data
num	light num (starts at 1)
x,y,z,w	position, model coordinates

Returns: 1

Definition at line 28 of file lights.c.

References G_debug(), GS_setlight_position(), light_data::id, nv_data::light, light_data::w, light_data::x, x, light_data::y, and light_data::z.

Referenced by Nviz_init_view().

◆ Nviz_set_rotation()

void Nviz_set_rotation	(	double	angle,
		double	x,
		double	y,
		double	z
	)

Set rotation parameters.

Rotate scene by given parameters related to mouse drag event (difference from current state). Coordinates determine the second point of rotation axis, the first point is (0, 0, 0).

Parameters

angle	angle
x,y,z	axis coordinate

Definition at line 288 of file change_view.c.

References G_debug(), GS_set_rotation(), and x.

◆ Nviz_set_scalebar()

struct scalebar_data * Nviz_set_scalebar	(	nv_data *	data,
		int	bar_id,
		int	sx,
		int	sy,
		float	size,
		unsigned int	color
	)

Sets the scale bar position and return world coords.

Parameters

data	nviz data
bar_id	scale bar id
sx,sy	screen coordinates
size	scale bar length
color	scalebar/text color

Returns: pointer to allocated scalebar_data structure; NULL when there's no surface

Definition at line 367 of file nviz.c.

References scalebar_data::color, G_free(), GS_get_surf_list(), GS_num_surfs(), GS_set_Narrow(), scalebar_data::id, NULL, nv_data::num_scalebars, Nviz_new_scalebar(), nv_data::scalebar, scalebar_data::size, and scalebar_data::where.

◆ Nviz_set_surface_attr_default()

void Nviz_set_surface_attr_default ( void )

Set default surface attributes.

Definition at line 279 of file map_obj.c.

References ATT_COLOR, ATT_EMIT, ATT_MASK, ATT_SHINE, ATT_TOPO, ATT_TRANSP, DEFAULT_SURF_COLOR, GS_set_att_defaults(), and MAX_ATTS.

◆ Nviz_set_viewpoint_height()

int Nviz_set_viewpoint_height ( double height )

Change viewpoint height.

Parameters

height height value (world coordinates)

Returns: 1

Definition at line 157 of file change_view.c.

References G_debug(), GS_get_from_real(), GS_moveto_real(), and Z.

◆ Nviz_set_viewpoint_persp()

int Nviz_set_viewpoint_persp ( int persp )

Change viewpoint perspective (field of view)

Parameters

persp perspective value (0-100, in degrees)

Returns: 1

Definition at line 199 of file change_view.c.

References G_debug(), and GS_set_fov().

◆ Nviz_set_viewpoint_position()

int Nviz_set_viewpoint_position	(	double	x_pos,
		double	y_pos
	)

Change position of view.

Parameters

x_pos	x position (model coordinates)
y_pos	y position (model coordinates)

Returns: 1

Definition at line 97 of file change_view.c.

References G_debug(), GS_get_from(), GS_moveto(), RANGE, RANGE_OFFSET, X, and Y.

◆ Nviz_set_viewpoint_twist()

int Nviz_set_viewpoint_twist ( int twist )

Change viewpoint twist.

Parameters

twist persp twist value (-180-180, in degrees)

Returns: 1

Definition at line 220 of file change_view.c.

References G_debug(), and GS_set_twist().

◆ Nviz_set_volume_attr_default()

int Nviz_set_volume_attr_default ( int id )

Set default volume attributes.

Parameters

id	volume set id

Returns: 1 on success; 0 on failure

Definition at line 323 of file map_obj.c.

References DM_GOURAUD, DM_POLY, GVL_get_dims(), GVL_isosurf_set_drawmode(), GVL_isosurf_set_drawres(), GVL_slice_set_drawmode(), GVL_slice_set_drawres(), and max.

Referenced by Nviz_new_map_obj().

◆ Nviz_set_vpoint_attr_default()

int Nviz_set_vpoint_attr_default ( int id )

Set default vector point attributes.

Parameters

id	vector point set id

Returns: 1 on success; 0 on failure

Definition at line 303 of file map_obj.c.

References gp_get_site().

Referenced by Nviz_new_map_obj().

◆ Nviz_unset_attr()

int Nviz_unset_attr	(	int	id,
		int	type,
		int	desc
	)

Unset map object attribute

Parameters

id	map object id
type	map object type (MAP_OBJ_SURF, MAP_OBJ_VECT, ...)
desc	attribute descriptor

Returns: 1 on success; 0 on failure

Definition at line 363 of file map_obj.c.

References GS_unset_att(), and MAP_OBJ_SURF.

◆ Nviz_unset_rotation()

void Nviz_unset_rotation ( void )

Stop scene rotation.

Definition at line 298 of file change_view.c.

References GS_unset_rotation().

◆ Nviz_update_ranges()

int Nviz_update_ranges ( nv_data * dc )

Update ranges.

Call whenever a new surface is added, deleted, or exag changes

Returns: 1

Definition at line 61 of file change_view.c.

References GS_get_longdim(), GS_get_zrange_nz(), and GS_global_exag().

Referenced by Nviz_change_exag(), and Nviz_set_attr().

Functions

Function Documentation

◆ Nviz_change_exag()

◆ Nviz_color_from_str()

◆ Nviz_create_render_window()

◆ Nviz_del_texture()

◆ Nviz_delete_arrow()

◆ Nviz_delete_scalebar()

◆ Nviz_destroy_data()

◆ Nviz_destroy_render_window()

◆ Nviz_draw_all()

◆ Nviz_draw_all_site()

◆ Nviz_draw_all_surf()

◆ Nviz_draw_all_vect()

◆ Nviz_draw_all_vol()

◆ Nviz_draw_arrow()

◆ Nviz_draw_cplane()

◆ Nviz_draw_fringe()

◆ Nviz_draw_image()

◆ Nviz_draw_model()

◆ Nviz_draw_quick()

◆ Nviz_draw_scalebar()

◆ Nviz_flythrough()

◆ Nviz_get_bgcolor()

◆ Nviz_get_cplane_rotation()

◆ Nviz_get_cplane_translation()

◆ Nviz_get_current_cplane()

◆ Nviz_get_exag()

◆ Nviz_get_exag_height()

◆ Nviz_get_focus()

◆ Nviz_get_longdim()

◆ Nviz_get_max_texture()

◆ Nviz_get_modelview()

◆ Nviz_get_viewpoint_height()

◆ Nviz_get_viewpoint_position()

◆ Nviz_get_xyrange()

◆ Nviz_get_zrange()

◆ Nviz_has_focus()

◆ Nviz_init_data()

◆ Nviz_init_light()

◆ Nviz_init_render_window()

◆ Nviz_init_rotation()

◆ Nviz_init_view()

◆ Nviz_load_image()

◆ Nviz_look_here()

◆ Nviz_make_current_render_window()

◆ Nviz_new_cplane()

◆ Nviz_new_fringe()

◆ Nviz_new_light()

◆ Nviz_new_map_obj()

◆ Nviz_new_render_window()

◆ Nviz_new_scalebar()

◆ Nviz_num_cplanes()

◆ Nviz_off_cplane()

◆ Nviz_on_cplane()

◆ Nviz_resize_window()

◆ Nviz_set_2D()

◆ Nviz_set_arrow()

◆ Nviz_set_attr()

◆ Nviz_set_bgcolor()

◆ Nviz_set_cplane_here()

◆ Nviz_set_cplane_rotation()

◆ Nviz_set_cplane_translation()

◆ Nviz_set_fence_color()

◆ Nviz_set_focus()

◆ Nviz_set_focus_map()

◆ Nviz_set_focus_state()

◆ Nviz_set_fringe()

◆ Nviz_set_light_ambient()

◆ Nviz_set_light_bright()

◆ Nviz_set_light_color()

◆ Nviz_set_light_position()

◆ Nviz_set_rotation()

◆ Nviz_set_scalebar()

◆ Nviz_set_surface_attr_default()

◆ Nviz_set_viewpoint_height()

◆ Nviz_set_viewpoint_persp()

◆ Nviz_set_viewpoint_position()

◆ Nviz_set_viewpoint_twist()

◆ Nviz_set_volume_attr_default()