display.h File Reference

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

Go to the source code of this file.

Functions
void	D_update_conversions (void)
void	D_fit_d_to_u (void)
void	D_fit_u_to_d (void)
void	D_show_conversions (void)
void	D_do_conversions (const struct Cell_head *, double, double, double, double)
	initialize conversions
int	D_is_lat_lon (void)
double	D_get_d_to_a_xconv (void)
double	D_get_d_to_a_yconv (void)
double	D_get_d_to_u_xconv (void)
double	D_get_d_to_u_yconv (void)
double	D_get_a_to_u_xconv (void)
double	D_get_a_to_u_yconv (void)
double	D_get_a_to_d_xconv (void)
double	D_get_a_to_d_yconv (void)
double	D_get_u_to_d_xconv (void)
double	D_get_u_to_d_yconv (void)
double	D_get_u_to_a_xconv (void)
double	D_get_u_to_a_yconv (void)
double	D_get_ns_resolution (void)
double	D_get_ew_resolution (void)
double	D_get_u_west (void)
double	D_get_u_east (void)
double	D_get_u_north (void)
double	D_get_u_south (void)
double	D_get_a_west (void)
double	D_get_a_east (void)
double	D_get_a_north (void)
double	D_get_a_south (void)
double	D_get_d_west (void)
double	D_get_d_east (void)
double	D_get_d_north (void)
double	D_get_d_south (void)
void	D_set_region (const struct Cell_head *)
void	D_set_src (double, double, double, double)
void	D_get_src (double *, double *, double *, double *)
	returns frame bounds in source coordinate system
void	D_set_grid (int, int, int, int)
void	D_get_grid (int *, int *, int *, int *)
void	D_set_dst (double, double, double, double)
void	D_get_dst (double *, double *, double *, double *)
	returns frame bounds in destination coordinate system
void	D_get_u (double[2][2])
void	D_get_a (int[2][2])
void	D_get_d (double[2][2])
double	D_d_to_a_row (double)
	screen to array (y)
double	D_d_to_a_col (double)
	screen to array (x)
double	D_d_to_u_row (double)
	screen to earth (y)
double	D_d_to_u_col (double)
	screen to earth (x)
double	D_a_to_u_row (double)
	array to earth (row)
double	D_a_to_u_col (double)
	array to earth (column)
double	D_a_to_d_row (double)
	array to screen (row)
double	D_a_to_d_col (double)
	array to screen (column)
double	D_u_to_d_row (double)
	earth to screen (north)
double	D_u_to_d_col (double)
	earth to screen (east)
double	D_u_to_a_row (double)
	earth to array (north)
double	D_u_to_a_col (double)
	earth to array (east
void	D_set_clip (double, double, double, double)
	set clipping window
void	D_clip_to_map (void)
	set clipping window to map window
void	D_set_clip_mode (int)
void	D_set_reduction (double)
void	D_line_width (double)
void	D_get_text_box (const char *, double *, double *, double *, double *)
void	D_pos_abs (double, double)
void	D_pos_rel (double, double)
void	D_move_abs (double, double)
void	D_move_rel (double, double)
void	D_cont_abs (double, double)
void	D_cont_rel (double, double)
void	D_line_abs (double, double, double, double)
void	D_line_rel (double, double, double, double)
void	D_polydots_abs (const double *, const double *, int)
void	D_polydots_rel (const double *, const double *, int)
void	D_polyline_abs (const double *, const double *, int)
void	D_polyline_rel (const double *, const double *, int)
void	D_polygon_abs (const double *, const double *, int)
void	D_polygon_rel (const double *, const double *, int)
void	D_box_abs (double, double, double, double)
void	D_box_rel (double, double)
void	D_begin (void)
void	D_end (void)
void	D_close (void)
void	D_stroke (void)
void	D_fill (void)
void	D_dots (void)
void	D_plot_icon (double, double, int, double, double)
	Plot icon.
int	D_draw_raster (int, const void *, struct Colors *, RASTER_MAP_TYPE)
	Draw raster row.
int	D_draw_d_raster (int, const DCELL *, struct Colors *)
	Draw raster row (DCELL)
int	D_draw_f_raster (int, const FCELL *, struct Colors *)
	Draw raster row (FCELL)
int	D_draw_c_raster (int, const CELL *, struct Colors *)
	Draw raster row (CELL)
void	D_raster_draw_begin (void)
	Prepare for raster graphic.
int	D_draw_raster_RGB (int, const void *, const void *, const void *, struct Colors *, struct Colors *, struct Colors *, RASTER_MAP_TYPE, RASTER_MAP_TYPE, RASTER_MAP_TYPE)
	Draw raster row in RGB mode.
void	D_raster_draw_end (void)
	Finish raster rendering.
int	D_set_overlay_mode (int)
	Configure raster overlay mode.
int	D_color (CELL, struct Colors *)
	this routine modifies the hardware colormap provided that we are not using fixed mode colors.
int	D_c_color (CELL, struct Colors *)
int	D_d_color (DCELL, struct Colors *)
	select color for line drawing
int	D_f_color (FCELL, struct Colors *)
	select color for line drawing
int	D_color_of_type (const void *, struct Colors *, RASTER_MAP_TYPE)
	If the data_type is CELL_TYPE, calls D_color((CELL *value, colors); If the data_type is FCELL_TYPE, calls D_f_color((FCELL *value, colors); If the data_type is DCELL_TYPE, calls D_d_color((DCELL *value, colors);.
void	D_setup (int)
	Graphics frame setup.
void	D_setup_unity (int)
	Graphics frame setup.
void	D_setup2 (int, int, double, double, double, double)
	Sets source coordinate system.
void	D_symbol (const SYMBOL *, double, double, const RGBA_Color *, const RGBA_Color *)
	draw a symbol at pixel coordinates
void	D_symbol2 (const SYMBOL *, double, double, const RGBA_Color *, const RGBA_Color *)
	draw a symbol at pixel coordinates (alternate)
int	D_translate_color (const char *)
	color name to number
int	D_parse_color (const char *, int)
	color option text to usable color number
int	D_use_color (int)
	draw with a color from D_parse_color
int	D_color_number_to_RGB (int, int *, int *, int *)
	get RGB values from color number
void	D_RGB_color (int, int, int)
void	D_erase (const char *)
int	D_open_driver (void)
	Open display driver.
void	D_close_driver (void)
	Close display driver.
int	D_save_command (const char *)
	Append command to the cmd file (unused)
void	D__erase (void)
	Erase display (internal use only)
void	D_text_size (double, double)
	Set text size (width and height)
void	D_text_rotation (double)
	Set text rotation.
void	D_text (const char *)
	Draw text.
void	D_font (const char *)
	Choose font.
void	D_encoding (const char *)
	Set encoding.
void	D_font_list (char ***, int *)
	Get font list.
void	D_font_info (char ***, int *)
	Get font info.
void	D_get_clip_window (double *, double *, double *, double *)
	get graphical clipping window
void	D_set_clip_window (double, double, double, double)
	set graphical clipping window
void	D_get_frame (double *, double *, double *, double *)
	get graphical window (frame)
void	D_get_screen (double *, double *, double *, double *)
	get screen bounds
void	D_set_clip_window_to_map_window (void)
	set graphical clipping window to map window
void	D_set_clip_window_to_screen_window (void)
	set clipping window to screen window
const char *	D_get_file (void)
	Get driver output file.

Function Documentation

D__erase()

void D__erase

(

void

)

Erase display (internal use only)

Definition at line 186 of file r_raster.c.

References COM_Erase().

D_a_to_d_col()

double D_a_to_d_col

(

double

A_col

)

array to screen (column)

Returns an x value in the screen coordinate system when provided the corresponding column value in the array coordinate system.

Parameters

A_col

column

Returns

double

Definition at line 486 of file cnversions.c.

References D.

D_a_to_d_row()

double D_a_to_d_row

(

double

A_row

)

array to screen (row)

Returns a y value in the screen coordinate system when provided the corresponding row value in the array coordinate system.

Parameters

A_row

row

Returns

double

Definition at line 471 of file cnversions.c.

References D.

D_a_to_u_col()

double D_a_to_u_col

(

double

A_col

)

array to earth (column)

Returns an x value in the earth coordinate system when provided the corresponding column value in the array coordinate system.

Parameters

A_col

column

Returns

double

Definition at line 457 of file cnversions.c.

D_a_to_u_row()

double D_a_to_u_row

(

double

A_row

)

array to earth (row)

Returns a y value in the earth coordinate system when provided the corresponding row value in the array coordinate system.

Parameters

A_row

row

Returns

double

Definition at line 442 of file cnversions.c.

D_begin()

void D_begin

(

void

)

Definition at line 292 of file draw2.c.

References path_begin().

Referenced by D_box_abs(), and D_line_abs().

D_box_abs()

void D_box_abs	(	double	x1,
		double	y1,
		double	x2,
		double	y2
	)

Definition at line 409 of file draw2.c.

References D_begin(), D_close(), D_cont_abs(), D_end(), D_fill(), and D_move_abs().

Referenced by D_box_rel().

D_box_rel()

void D_box_rel	(	double	x2,
		double	y2
	)

Definition at line 486 of file draw2.c.

References D_box_abs().

D_c_color()

int D_c_color	(	CELL	cat,
		struct Colors *	colors
	)

Definition at line 71 of file raster2.c.

References CELL_TYPE, and D_color_of_type().

Referenced by D_color().

D_clip_to_map()

void D_clip_to_map

(

void

)

set clipping window to map window

Sets the clipping window to the pixel window that corresponds to the current database region. This is the default.

Parameters

~

Definition at line 168 of file draw2.c.

References b, D_get_src(), D_set_clip(), l, r, and t.

Referenced by D_dots().

D_close()

void D_close

(

void

)

Definition at line 319 of file draw2.c.

References path_close().

Referenced by D_box_abs(), D_polygon_abs(), and D_polygon_rel().

D_close_driver()

void D_close_driver

(

void

)

Close display driver.

If GRASS_NOTIFY is defined, run notifier.

Definition at line 163 of file r_raster.c.

References _, COM_Graph_close(), and G_warning().

D_color()

int D_color	(	CELL	cat,
		struct Colors *	colors
	)

this routine modifies the hardware colormap provided that we are not using fixed mode colors.

For use by programs such as d.colors.

Parameters

cat
colors

Returns

Definition at line 65 of file raster2.c.

References D_c_color().

D_color_number_to_RGB()

int D_color_number_to_RGB	(	int	color,
		int *	r,
		int *	g,
		int *	b
	)

get RGB values from color number

Translates the color number provided by D_parse_color into 0-255 RGB values.

Returns 1 if color can be used to draw (is good and isn't 'none'), 0 otherwise.

Parameters

color	The color number provided by D_parse_color to convert into 0-255 RGB values.
r	Pointer to an integer where the red component will be stored.
g	Pointer to an integer where the green component will be stored.
b	Pointer to an integer where the blue component will be stored.

Returns

Returns 1 if color can be used to draw (is good and isn't 'none'), 0 otherwise.

Definition at line 179 of file tran_colr.c.

References color_rgb::b, b, color_rgb::g, g, G_num_standard_colors(), G_standard_color_rgb(), color_rgb::r, and r.

D_color_of_type()

int D_color_of_type	(	const void *	raster,
		struct Colors *	colors,
		RASTER_MAP_TYPE	data_type
	)

If the data_type is CELL_TYPE, calls D_color((CELL *value, colors); If the data_type is FCELL_TYPE, calls D_f_color((FCELL *value, colors); If the data_type is DCELL_TYPE, calls D_d_color((DCELL *value, colors);.

Parameters

raster
colors
data_type

Returns

int

Definition at line 124 of file raster2.c.

References b, D_RGB_color(), g, r, and Rast_get_color().

Referenced by D_c_color(), D_d_color(), and D_f_color().

D_cont_abs()

void D_cont_abs	(	double	x,
		double	y
	)

Definition at line 311 of file draw2.c.

References path_cont(), vertex::x, and vertex::y.

Referenced by D_box_abs(), D_cont_rel(), and D_line_abs().

D_cont_rel()

void D_cont_rel	(	double	x,
		double	y
	)

Definition at line 445 of file draw2.c.

References D_cont_abs(), and x.

D_d_color()

int D_d_color	(	DCELL	val,
		struct Colors *	colors
	)

select color for line drawing

Same functionality as D_color() except that the value is type DCELL. This implies that the floating-point interfaces to the colors are used by this routine.

Parameters

val	Value
colors

Returns

int

Definition at line 87 of file raster2.c.

References D_color_of_type(), and DCELL_TYPE.

D_d_to_a_col()

double D_d_to_a_col

(

double

D_col

)

screen to array (x)

Returns a column value in the array coordinate system when provided the corresponding x value in the screen coordinate system.

Parameters

D_col

x

Returns

double

Definition at line 400 of file cnversions.c.

References D.

D_d_to_a_row()

double D_d_to_a_row

(

double

D_row

)

screen to array (y)

Returns a row value in the array coordinate system when provided the corresponding y value in the screen coordinate system.

Parameters

D_row

y

Returns

double

Definition at line 386 of file cnversions.c.

References D.

D_d_to_u_col()

double D_d_to_u_col

(

double

D_col

)

screen to earth (x)

Returns an east value in the earth coordinate system when provided the corresponding x value in the screen coordinate system.

Parameters

D_col

x

Returns

double

Definition at line 428 of file cnversions.c.

References D.

Referenced by D_get_text_box().

D_d_to_u_row()

double D_d_to_u_row

(

double

D_row

)

screen to earth (y)

Returns a north value in the earth coordinate system when provided the corresponding y value in the screen coordinate system.

Parameters

D_row

y

Returns

double

Definition at line 414 of file cnversions.c.

References D.

Referenced by D_get_text_box().

D_do_conversions()

void D_do_conversions	(	const struct Cell_head *	window,
		double	t,
		double	b,
		double	l,
		double	r
	)

initialize conversions

The relationship between the earth region and the top, bottom, left, and right screen coordinates is established, which then allows conversions between all three coordinate systems to be performed. Note this routine is called by D_setup.

Parameters

window	region
t	top
b	bottom
l	left
r	right

Returns

none

Definition at line 143 of file cnversions.c.

References b, D_fit_d_to_u(), D_set_dst(), D_set_region(), D_show_conversions(), D_update_conversions(), l, r, and t.

Referenced by D_setup().

D_dots()

void D_dots

(

void

)

Definition at line 336 of file draw2.c.

References COM_Point(), path::count, D_clip_to_map(), D_is_lat_lon(), D_u_to_d_col(), D_u_to_d_row(), M_NONE, clip::top, path::vertices, vertex::x, and vertex::y.

Referenced by D_polydots_abs(), and D_polydots_rel().

D_draw_c_raster()

int D_draw_c_raster	(	int	A_row,
		const CELL *	carray,
		struct Colors *	colors
	)

Draw raster row (CELL)

The row gives the map array row. The carray array provides the categories for each raster value in that row. This routine is called consecutively with the information necessary to draw a raster image from north to south. No rows can be skipped. All screen pixel rows which represent the current map array row are rendered. The routine returns the map array row which is needed to draw the next screen pixel row.

Parameters

A_row	row number (starts at 0)
carray	data buffer
colors	pointer to Colors structure

Returns

row number needed for next pixel row

-1 nothing to draw (on error or end of raster)

Definition at line 104 of file display/raster.c.

References CELL_TYPE.

D_draw_d_raster()

int D_draw_d_raster	(	int	A_row,
		const DCELL *	darray,
		struct Colors *	colors
	)

Draw raster row (DCELL)

Parameters

A_row	row number (starts at 0)
darray	data buffer
colors	pointer to Colors structure

Returns

Definition at line 66 of file display/raster.c.

References DCELL_TYPE.

D_draw_f_raster()

int D_draw_f_raster	(	int	A_row,
		const FCELL *	farray,
		struct Colors *	colors
	)

Draw raster row (FCELL)

Parameters

A_row	row number (starts at 0)
farray	data buffer
colors	pointer to Colors structure

Returns

row number needed for next pixel row

-1 nothing to draw (on error or end of raster)

Definition at line 81 of file display/raster.c.

References FCELL_TYPE.

D_draw_raster()

int D_draw_raster	(	int	A_row,
		const void *	array,
		struct Colors *	colors,
		RASTER_MAP_TYPE	data_type
	)

Draw raster row.

• determine which pixel row gets the data
• resamples the data to create a pixel array
• determines best way to draw the array a - for single cat array, a move and a draw b - otherwise, a call to D_raster()

Presumes the map is drawn from north to south.

If overlay mode is desired, then call D_set_overlay_mode() first.

Parameters

A_row	row number (starts at 0)
array	data buffer
colors	pointer to Colors structure
data_type	raster type (CELL, FCELL, DCELL)

Returns

row number needed for next pixel row

-1 nothing to draw (on error or end of raster)

Definition at line 51 of file display/raster.c.

D_draw_raster_RGB()

int D_draw_raster_RGB	(	int	A_row,
		const void *	r_raster,
		const void *	g_raster,
		const void *	b_raster,
		struct Colors *	r_colors,
		struct Colors *	g_colors,
		struct Colors *	b_colors,
		RASTER_MAP_TYPE	r_type,
		RASTER_MAP_TYPE	g_type,
		RASTER_MAP_TYPE	b_type
	)

Draw raster row in RGB mode.

Parameters

A_row	row number (starts at 0)
r_raster	red data buffer
g_raster	green data buffer
b_raster	blue data buffer
r_colors	colors used for red channel
g_colors	colors used for green channel
b_colors	colors used for blue channel
r_type	raster type used for red channel
g_type	raster type used for red channel
b_type	raster type used for red channel

Returns

row number needed for next pixel row

-1 nothing to draw (on error or end of raster)

Definition at line 173 of file display/raster.c.

References COM_raster(), D__overlay_mode, G_incr_void_ptr, G_realloc, NULL, Rast_cell_size(), Rast_is_null_value(), and Rast_lookup_colors().

D_encoding()

void D_encoding

(

const char *

name

)

Set encoding.

Parameters

name	encoding name

Definition at line 242 of file r_raster.c.

References COM_Set_encoding(), and name.

D_end()

void D_end

(

void

)

Definition at line 297 of file draw2.c.

Referenced by D_box_abs(), and D_line_abs().

D_erase()

void D_erase

(

const char *

color

)

Definition at line 12 of file display/window.c.

References b, COM_Begin(), COM_Close(), COM_Cont(), COM_Fill(), COM_Move(), D_get_dst(), D_parse_color(), D_use_color(), l, r, and t.

Referenced by D_setup(), D_setup2(), and D_setup_unity().

D_f_color()

int D_f_color	(	FCELL	val,
		struct Colors *	colors
	)

select color for line drawing

Same functionality as D_color() except that the value is type FCELL. This implies that the floating-point interfaces to the colors are used by this routine.

Parameters

val
colors

Returns

int

Definition at line 104 of file raster2.c.

References D_color_of_type(), and FCELL_TYPE.

D_fill()

void D_fill

(

void

)

Definition at line 330 of file draw2.c.

References COM_Fill().

Referenced by D_box_abs(), D_polygon_abs(), and D_polygon_rel().

D_fit_d_to_u()

void D_fit_d_to_u

(

void

)

Definition at line 97 of file cnversions.c.

References D.

Referenced by D_do_conversions(), and D_setup2().

D_fit_u_to_d()

void D_fit_u_to_d

(

void

)

Definition at line 102 of file cnversions.c.

References D.

D_font()

void D_font

(

const char *

name

)

Choose font.

Set current font to font name.

Parameters

name

font name

Definition at line 232 of file r_raster.c.

References COM_Set_font(), and name.

D_font_info()

void D_font_info	(	char ***	list,
		int *	count
	)

Get font info.

Parameters

[out]	list	list of font info
[out]	count	of items in the list

Definition at line 264 of file r_raster.c.

References COM_Font_info(), and count.

D_font_list()

void D_font_list	(	char ***	list,
		int *	count
	)

Get font list.

Parameters

[out]	list	list of font names
[out]	count	of items in the list

Definition at line 253 of file r_raster.c.

References COM_Font_list(), and count.

D_get_a()

void D_get_a

(

int

x[2][2]

)

Definition at line 361 of file cnversions.c.

References x.

Referenced by D_raster_draw_begin().

D_get_a_east()

double D_get_a_east

(

void

)

Definition at line 239 of file cnversions.c.

D_get_a_north()

double D_get_a_north

(

void

)

Definition at line 243 of file cnversions.c.

D_get_a_south()

double D_get_a_south

(

void

)

Definition at line 247 of file cnversions.c.

D_get_a_to_d_xconv()

double D_get_a_to_d_xconv

(

void

)

Definition at line 184 of file cnversions.c.

D_get_a_to_d_yconv()

double D_get_a_to_d_yconv

(

void

)

Definition at line 188 of file cnversions.c.

D_get_a_to_u_xconv()

double D_get_a_to_u_xconv

(

void

)

Definition at line 176 of file cnversions.c.

Referenced by D_get_ew_resolution().

D_get_a_to_u_yconv()

double D_get_a_to_u_yconv

(

void

)

Definition at line 180 of file cnversions.c.

Referenced by D_get_ns_resolution().

D_get_a_west()

double D_get_a_west

(

void

)

Definition at line 235 of file cnversions.c.

D_get_clip_window()

void D_get_clip_window	(	double *	t,
		double *	b,
		double *	l,
		double *	r
	)

get graphical clipping window

Queries the graphical clipping window (origin is top right)

Parameters

[out]	t	top edge of clip window
[out]	b	bottom edge of clip window
[out]	l	left edge of clip window
[out]	r	right edge of clip window

Returns

~

Definition at line 280 of file r_raster.c.

References b, COM_Get_window(), l, r, and t.

D_get_d()

void D_get_d

(

double

x[2][2]

)

Definition at line 369 of file cnversions.c.

References D, and x.

Referenced by D_raster_draw_begin().

D_get_d_east()

double D_get_d_east

(

void

)

Definition at line 256 of file cnversions.c.

References D.

Referenced by D_set_clip_window_to_map_window().

D_get_d_north()

double D_get_d_north

(

void

)

Definition at line 260 of file cnversions.c.

References D.

Referenced by D_set_clip_window_to_map_window().

D_get_d_south()

double D_get_d_south

(

void

)

Definition at line 264 of file cnversions.c.

References D.

Referenced by D_set_clip_window_to_map_window().

D_get_d_to_a_xconv()

double D_get_d_to_a_xconv

(

void

)

Definition at line 160 of file cnversions.c.

D_get_d_to_a_yconv()

double D_get_d_to_a_yconv

(

void

)

Definition at line 164 of file cnversions.c.

D_get_d_to_u_xconv()

double D_get_d_to_u_xconv

(

void

)

Definition at line 168 of file cnversions.c.

D_get_d_to_u_yconv()

double D_get_d_to_u_yconv

(

void

)

Definition at line 172 of file cnversions.c.

D_get_d_west()

double D_get_d_west

(

void

)

Definition at line 252 of file cnversions.c.

References D.

Referenced by D_set_clip_window_to_map_window().

D_get_dst()

void D_get_dst	(	double *	t,
		double *	b,
		double *	l,
		double *	r
	)

returns frame bounds in destination coordinate system

D_get_dst() returns the frame bounds in the destination coordinate system (used by R_* commands). The various D_setup() commands all set the destination coordinate system to the current frame reported by R_get_window().

Parameters

t	top
b	bottom
l	left
r	right

Returns

none

Definition at line 345 of file cnversions.c.

References b, D, l, r, and t.

Referenced by D_erase().

D_get_ew_resolution()

double D_get_ew_resolution

(

void

)

Definition at line 213 of file cnversions.c.

References D_get_a_to_u_xconv().

D_get_file()

const char * D_get_file

(

void

)

Get driver output file.

Returns

file name or NULL if not defined

Definition at line 141 of file display/setup.c.

References COM_Graph_get_file().

D_get_frame()

void D_get_frame	(	double *	t,
		double *	b,
		double *	l,
		double *	r
	)

get graphical window (frame)

Queries the graphical frame (origin is top right)

Parameters

[out]	t	top edge of frame
[out]	b	bottom edge of frame
[out]	l	left edge of frame
[out]	r	right edge of frame

Returns

~

Definition at line 322 of file r_raster.c.

References b, l, r, and t.

Referenced by D_setup(), D_setup2(), and D_setup_unity().

D_get_grid()

void D_get_grid	(	int *	t,
		int *	b,
		int *	l,
		int *	r
	)

Definition at line 314 of file cnversions.c.

References b, l, r, and t.

D_get_ns_resolution()

double D_get_ns_resolution

(

void

)

Definition at line 209 of file cnversions.c.

References D_get_a_to_u_yconv().

D_get_screen()

void D_get_screen	(	double *	t,
		double *	b,
		double *	l,
		double *	r
	)

get screen bounds

Queries the screen bounds (origin is top right)

Parameters

[out]	t	top edge of screen
[out]	b	bottom edge of screen
[out]	l	left edge of screen
[out]	r	right edge of screen

Returns

~

Definition at line 341 of file r_raster.c.

References b, l, r, and t.

D_get_src()

void D_get_src	(	double *	t,
		double *	b,
		double *	l,
		double *	r
	)

returns frame bounds in source coordinate system

D_get_src() returns the frame bounds in the source coordinate system (used by D_* functions)

Parameters

t	top
b	bottom
l	left
r	right

Returns

void

Definition at line 297 of file cnversions.c.

References b, l, r, and t.

Referenced by D_clip_to_map().

D_get_text_box()

void D_get_text_box	(	const char *	text,
		double *	t,
		double *	b,
		double *	l,
		double *	r
	)

Definition at line 191 of file draw2.c.

References b, COM_Get_text_box(), D_d_to_u_col(), D_d_to_u_row(), l, r, and t.

D_get_u()

void D_get_u

(

double

x[2][2]

)

Definition at line 353 of file cnversions.c.

References x.

D_get_u_east()

double D_get_u_east

(

void

)

Definition at line 222 of file cnversions.c.

D_get_u_north()

double D_get_u_north

(

void

)

Definition at line 226 of file cnversions.c.

D_get_u_south()

double D_get_u_south

(

void

)

Definition at line 230 of file cnversions.c.

D_get_u_to_a_xconv()

double D_get_u_to_a_xconv

(

void

)

Definition at line 200 of file cnversions.c.

D_get_u_to_a_yconv()

double D_get_u_to_a_yconv

(

void

)

Definition at line 204 of file cnversions.c.

D_get_u_to_d_xconv()

double D_get_u_to_d_xconv

(

void

)

Definition at line 192 of file cnversions.c.

D_get_u_to_d_yconv()

double D_get_u_to_d_yconv

(

void

)

Definition at line 196 of file cnversions.c.

D_get_u_west()

double D_get_u_west

(

void

)

Definition at line 218 of file cnversions.c.

D_is_lat_lon()

int D_is_lat_lon

(

void

)

Definition at line 155 of file cnversions.c.

Referenced by D_dots().

D_line_abs()

void D_line_abs	(	double	x1,
		double	y1,
		double	x2,
		double	y2
	)

Definition at line 400 of file draw2.c.

References D_begin(), D_cont_abs(), D_end(), D_move_abs(), and D_stroke().

Referenced by D_line_rel().

D_line_rel()

void D_line_rel	(	double	x1,
		double	y1,
		double	x2,
		double	y2
	)

Definition at line 469 of file draw2.c.

References D_line_abs().

D_line_width()

void D_line_width

(

double

d

)

Definition at line 186 of file draw2.c.

References COM_Line_width().

D_move_abs()

void D_move_abs	(	double	x,
		double	y
	)

Definition at line 303 of file draw2.c.

References path_move(), vertex::x, and vertex::y.

Referenced by D_box_abs(), D_line_abs(), and D_move_rel().

D_move_rel()

void D_move_rel	(	double	x,
		double	y
	)

Definition at line 440 of file draw2.c.

References D_move_abs(), and x.

D_open_driver()

int D_open_driver

(

void

)

Open display driver.

Default display driver is Cairo, if not available PNG is used.

Returns

0 on success

Definition at line 82 of file r_raster.c.

References _, Cairo_Driver(), G_debug(), G_fatal_error(), G_file_name(), G_free(), G_getenv_nofatal(), G_mapset(), G_recreate_command(), G_spawn_ex(), G_strcasecmp(), G_temp_element(), G_verbose_message(), G_warning(), GPATH_MAX, HTML_Driver(), init(), LIB_init(), AMI_STREAM< T >::name(), NULL, PNG_Driver(), and PS_Driver().

D_parse_color()

int D_parse_color	(	const char *	str,
		int	none_acceptable
	)

color option text to usable color number

Converts or looks up the color provided in the string. Returns a color number usable by D_use_color. If the color does not exist exits with a fatal error and message. If the color is none and none_acceptable is not true exits with a fatal error and message.

Parameters

str	Color name or color code, as a string
none_acceptable

Returns

int Returns a color number usable by D_use_color.

Definition at line 103 of file tran_colr.c.

References _, and G_fatal_error().

Referenced by D_erase(), and D_translate_color().

D_plot_icon()

void D_plot_icon	(	double	xc,
		double	yc,
		int	type,
		double	angle,
		double	scale
	)

Plot icon.

Supported types:

• G_ICON_CROSS
• G_ICON_BOX
• G_ICON_ARROW

Parameters

xc,yc	icon coordinates
type	icon type
angle	rotation angle [rad]
scale	scale factor

Definition at line 43 of file icon.c.

References _, G_debug(), G_ICON_ARROW, G_ICON_BOX, G_ICON_CROSS, and G_warning().

D_polydots_abs()

void D_polydots_abs	(	const double *	x,
		const double *	y,
		int	n
	)

Definition at line 394 of file draw2.c.

References D_dots(), vertex::x, and vertex::y.

D_polydots_rel()

void D_polydots_rel	(	const double *	x,
		const double *	y,
		int	n
	)

Definition at line 450 of file draw2.c.

References D_dots(), and x.

D_polygon_abs()

void D_polygon_abs	(	const double *	x,
		const double *	y,
		int	n
	)

Definition at line 387 of file draw2.c.

References D_close(), D_fill(), vertex::x, and vertex::y.

D_polygon_rel()

void D_polygon_rel	(	const double *	x,
		const double *	y,
		int	n
	)

Definition at line 462 of file draw2.c.

References D_close(), D_fill(), and x.

D_polyline_abs()

void D_polyline_abs	(	const double *	x,
		const double *	y,
		int	n
	)

Definition at line 381 of file draw2.c.

References D_stroke(), vertex::x, and vertex::y.

D_polyline_rel()

void D_polyline_rel	(	const double *	x,
		const double *	y,
		int	n
	)

Definition at line 456 of file draw2.c.

References D_stroke(), and x.

D_pos_abs()

void D_pos_abs	(	double	x,
		double	y
	)

Definition at line 220 of file draw2.c.

References COM_Pos_abs(), D_u_to_d_col(), D_u_to_d_row(), vertex::x, and vertex::y.

Referenced by D_pos_rel().

D_pos_rel()

void D_pos_rel	(	double	x,
		double	y
	)

Definition at line 231 of file draw2.c.

References D_pos_abs(), vertex::x, and vertex::y.

D_raster_draw_begin()

void D_raster_draw_begin

(

void

)

Prepare for raster graphic.

The raster display subsystem establishes conversion parameters based on the screen extent defined by top, bottom, left, and right, all of which are obtainable from D_get_dst() for the current frame.

Definition at line 148 of file display/raster.c.

References COM_begin_raster(), D__overlay_mode, D_get_a(), and D_get_d().

D_raster_draw_end()

void D_raster_draw_end

(

void

)

Finish raster rendering.

Definition at line 225 of file display/raster.c.

References COM_end_raster().

D_RGB_color()

void D_RGB_color	(	int	red,
		int	grn,
		int	blu
	)

Definition at line 213 of file tran_colr.c.

References COM_Color_RGB().

Referenced by D_color_of_type(), and D_use_color().

D_save_command()

int D_save_command

(

const char *

cmd

)

Append command to the cmd file (unused)

Todo:

To be removed

Definition at line 178 of file r_raster.c.

D_set_clip()

void D_set_clip	(	double	t,
		double	b,
		double	l,
		double	r
	)

set clipping window

Sets the clipping window to the pixel window that corresponds to the current database region. This is the default.

Parameters

t	top
b	bottom
l	left
r	right

Definition at line 150 of file draw2.c.

References b, l, max, min, r, t, and clip::top.

Referenced by D_clip_to_map().

D_set_clip_mode()

void D_set_clip_mode

(

int

mode

)

Definition at line 176 of file draw2.c.

References vertex::mode.

D_set_clip_window()

void D_set_clip_window	(	double	t,
		double	b,
		double	l,
		double	r
	)

set graphical clipping window

Sets the graphical clipping window to the specified rectangle (origin is top right)

Parameters

t	top edge of clip window
b	bottom edge of clip window
l	left edge of clip window
r	right edge of clip window

Returns

~

Definition at line 297 of file r_raster.c.

References b, COM_Set_window(), l, r, and t.

Referenced by D_set_clip_window_to_map_window().

D_set_clip_window_to_map_window()

void D_set_clip_window_to_map_window

(

void

)

set graphical clipping window to map window

Sets the graphical clipping window to the pixel window that corresponds to the current database region.

Parameters

~

Returns

~

Definition at line 358 of file r_raster.c.

References D_get_d_east(), D_get_d_north(), D_get_d_south(), D_get_d_west(), and D_set_clip_window().

Referenced by D_setup(), D_setup2(), and D_setup_unity().

D_set_clip_window_to_screen_window()

void D_set_clip_window_to_screen_window

(

void

)

set clipping window to screen window

Sets the clipping window to the pixel window that corresponds to the full screen window. Off screen rendering is still clipped.

Parameters

~

Returns

~

Definition at line 373 of file r_raster.c.

References COM_Set_window().

Referenced by D_setup(), D_setup2(), and D_setup_unity().

D_set_dst()

void D_set_dst	(	double	t,
		double	b,
		double	l,
		double	r
	)

Definition at line 322 of file cnversions.c.

References b, D, l, r, and t.

Referenced by D_do_conversions(), D_setup2(), and D_setup_unity().

D_set_grid()

void D_set_grid	(	int	t,
		int	b,
		int	l,
		int	r
	)

Definition at line 305 of file cnversions.c.

References b, l, r, and t.

Referenced by D_set_region().

D_set_overlay_mode()

int D_set_overlay_mode

(

int

n

)

Configure raster overlay mode.

This routine determines if D_draw_raster() draws in overlay mode (locations with category 0 are left untouched) or not (colored with the color for category 0).

Parameters

n	1 (TRUE) for overlay mode; 0 (FALSE) otherwise

Returns

0

Definition at line 48 of file raster2.c.

References D__overlay_mode.

D_set_reduction()

void D_set_reduction

(

double

e

)

Definition at line 181 of file draw2.c.

D_set_region()

void D_set_region

(

const struct Cell_head *

window

)

Definition at line 269 of file cnversions.c.

References Cell_head::cols, D_set_grid(), D_set_src(), Cell_head::east, Cell_head::north, Cell_head::proj, PROJECTION_LL, Cell_head::rows, Cell_head::south, and Cell_head::west.

Referenced by D_do_conversions().

D_set_src()

void D_set_src	(	double	t,
		double	b,
		double	l,
		double	r
	)

Definition at line 276 of file cnversions.c.

References b, l, r, and t.

Referenced by D_set_region(), D_setup2(), and D_setup_unity().

D_setup()

void D_setup

(

int

clear

)

Graphics frame setup.

This is a high level D call. It does a full setup for the current graphics frame.

Note: Connection to driver must already be made.

Sets the source coordinate system to the current region, and adjusts the destination coordinate system to preserve the aspect ratio.

Performs a full setup for the current graphics frame:

• Makes sure there is a current graphics frame (will create a full-screen one, if not);
• Sets the region coordinates so that the graphics frame and the active module region agree (may change active module region to do this); and
• Performs graphic frame/region coordinate conversion initialization.

If clear is true, the frame is cleared (same as running d.erase.) Otherwise, it is not cleared.

Parameters

clear

1 to clear frame (visually and coordinates)

Definition at line 46 of file display/setup.c.

References D_do_conversions(), D_erase(), D_get_frame(), D_set_clip_window_to_map_window(), D_set_clip_window_to_screen_window(), DEFAULT_BG_COLOR, G_get_set_window(), and Rast_set_window().

D_setup2()

void D_setup2	(	int	clear,
		int	fit,
		double	st,
		double	sb,
		double	sl,
		double	sr
	)

Sets source coordinate system.

Sets the source coordinate system to its arguments, and if the fit argument is non-zero, adjusts the destination coordinate system to preserve the aspect ratio.

If clear is true, the frame is cleared (same as running d.erase). Otherwise, it is not cleared.

Parameters

clear	non-zero code to clear the frame
fit	non-zero code to adjust destination coordinate system
st	top
sb	bottom
sl	left
sr	right

Definition at line 114 of file display/setup.c.

References D_erase(), D_fit_d_to_u(), D_get_frame(), D_set_clip_window_to_map_window(), D_set_clip_window_to_screen_window(), D_set_dst(), D_set_src(), D_update_conversions(), DEFAULT_BG_COLOR, and st.

D_setup_unity()

void D_setup_unity

(

int

clear

)

Graphics frame setup.

Sets the source coordinate system to match the destination coordinate system, so that D_* functions use the same coordinate system as R_* functions.

If clear is true, the frame is cleared (same as running d.erase). Otherwise, it is not cleared.

Parameters

clear

non-zero code to clear the frame

Definition at line 78 of file display/setup.c.

References D_erase(), D_get_frame(), D_set_clip_window_to_map_window(), D_set_clip_window_to_screen_window(), D_set_dst(), D_set_src(), D_update_conversions(), and DEFAULT_BG_COLOR.

D_show_conversions()

void D_show_conversions

(

void

)

Definition at line 107 of file cnversions.c.

References D.

Referenced by D_do_conversions().

D_stroke()

void D_stroke

(

void

)

Definition at line 324 of file draw2.c.

References COM_Stroke().

Referenced by D_line_abs(), D_polyline_abs(), and D_polyline_rel().

D_symbol()

void D_symbol	(	const SYMBOL *	Symb,
		double	x0,
		double	y0,
		const RGBA_Color *	line_color,
		const RGBA_Color *	fill_color
	)

draw a symbol at pixel coordinates

Draws a symbol (one of $GISBASE/etc/symbols/) to the active display. The starting x0,y0 coordinate corresponds to the center of the icon. The symbol must be pre-processed with S_stroke() before being sent to this function.

Example

#include <grass/display.h>
#include <grass/symbol.h>
...
SYMBOL *Symb;
Symb = S_read( symbol_name );
S_stroke( Symb, size, rotation, tolerance );
D_symbol( Symb, x0, y0, line_color, fill_color );

Parameters

Symb	The symbol name (e.g. basic/circle)
x0	The starting x display coordinate (pixel)
y0	The starting y display coordinate (pixel)
line_color	Outline color
fill_color	Fill color

Returns

void

Definition at line 149 of file symbol.c.

D_symbol2()

void D_symbol2	(	const SYMBOL *	Symb,
		double	x0,
		double	y0,
		const RGBA_Color *	primary_color,
		const RGBA_Color *	secondary_color
	)

draw a symbol at pixel coordinates (alternate)

Draws a symbol (one of $GISBASE/etc/symbols/) to the active display. The same as D_symbol(), but it uses a primary and secondary color instead of line and fill color. The primary color is used to draw stroke lines (STRINGs) and as the fill color for polygons. The secondary color is used for polygon outlines.

Parameters

Symb	The symbol name (e.g. basic/circle)
x0	The starting x display coordinate (pixel)
y0	The starting y display coordinate (pixel)
primary_color	Primary draw color
secondary_color	Secondary draw color

Returns

void

Definition at line 171 of file symbol.c.

D_text()

void D_text

(

const char *

text

)

Draw text.

Writes text in the current color and font, at the current text width and height, starting at the current screen location.

Parameters

text	text to be drawn

Definition at line 220 of file r_raster.c.

References COM_Text().

D_text_rotation()

void D_text_rotation

(

double

rotation

)

Set text rotation.

Parameters

rotation

value

Definition at line 207 of file r_raster.c.

References COM_Text_rotation().

D_text_size()

void D_text_size	(	double	width,
		double	height
	)

Set text size (width and height)

Parameters

width	text pixel width
height	text pixel height

Definition at line 197 of file r_raster.c.

References COM_Text_size().

D_translate_color()

int D_translate_color

(

const char *

str

)

color name to number

Takes a color name in ascii and returns the color number for that color. Returns 0 if color is not known. The color number returned is for lines and text, not raster graphics.

Parameters

str	Color name as an ASCII string

Returns

int

Definition at line 126 of file tran_colr.c.

References D_parse_color().

D_u_to_a_col()

double D_u_to_a_col

(

double

U_col

)

earth to array (east

Returns a column value in the array coordinate system when provided the corresponding east value in the earth coordinate system.

Parameters

U_col

east

Returns

double

Definition at line 542 of file cnversions.c.

D_u_to_a_row()

double D_u_to_a_row

(

double

U_row

)

earth to array (north)

Returns a row value in the array coordinate system when provided the corresponding north value in the earth coordinate system.

Parameters

U_row

north

Returns

double

Definition at line 528 of file cnversions.c.

D_u_to_d_col()

double D_u_to_d_col

(

double

U_col

)

earth to screen (east)

Returns an x value in the screen coordinate system when provided the corresponding east value in the earth coordinate system.

Parameters

U_col

east

Returns

double

Definition at line 514 of file cnversions.c.

References D.

Referenced by D_dots(), and D_pos_abs().

D_u_to_d_row()

double D_u_to_d_row

(

double

U_row

)

earth to screen (north)

Returns a y value in the screen coordinate system when provided the corresponding north value in the earth coordinate system.

Parameters

U_row

north

Returns

double

Definition at line 500 of file cnversions.c.

References D.

Referenced by D_dots(), and D_pos_abs().

D_update_conversions()

void D_update_conversions

(

void

)

Definition at line 90 of file cnversions.c.

References D.

Referenced by D_do_conversions(), D_setup2(), and D_setup_unity().

D_use_color()

int D_use_color

(

int

color

)

draw with a color from D_parse_color

Calls R_color or R_standard_color to use the color provided by D_parse_color. Returns 1 if color can be used to draw (is good and isn't none), 0 otherwise.

Parameters

color

Returns

int

Definition at line 141 of file tran_colr.c.

References color_rgb::b, COM_Standard_color(), D_RGB_color(), color_rgb::g, G_num_standard_colors(), and color_rgb::r.

Referenced by D_erase().