GRASS GIS 8 Programmer's Manual  8.4.0dev(2024)-112dd97adf
Functions
cnversions.c File Reference
#include <math.h>
#include <grass/gis.h>
#include <grass/display.h>
Include dependency graph for cnversions.c:

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 *window, double t, double b, double l, double r)
 initialize conversions More...
 
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 *window)
 
void D_set_src (double t, double b, double l, double r)
 
void D_get_src (double *t, double *b, double *l, double *r)
 returns frame bounds in source coordinate system More...
 
void D_set_grid (int t, int b, int l, int r)
 
void D_get_grid (int *t, int *b, int *l, int *r)
 
void D_set_dst (double t, double b, double l, double r)
 
void D_get_dst (double *t, double *b, double *l, double *r)
 returns frame bounds in destination coordinate system More...
 
void D_get_u (double x[2][2])
 
void D_get_a (int x[2][2])
 
void D_get_d (double x[2][2])
 
double D_d_to_a_row (double D_row)
 screen to array (y) More...
 
double D_d_to_a_col (double D_col)
 screen to array (x) More...
 
double D_d_to_u_row (double D_row)
 screen to earth (y) More...
 
double D_d_to_u_col (double D_col)
 screen to earth (x) More...
 
double D_a_to_u_row (double A_row)
 array to earth (row) More...
 
double D_a_to_u_col (double A_col)
 array to earth (column) More...
 
double D_a_to_d_row (double A_row)
 array to screen (row) More...
 
double D_a_to_d_col (double A_col)
 array to screen (column) More...
 
double D_u_to_d_row (double U_row)
 earth to screen (north) More...
 
double D_u_to_d_col (double U_col)
 earth to screen (east) More...
 
double D_u_to_a_row (double U_row)
 earth to array (north) More...
 
double D_u_to_a_col (double U_col)
 earth to array (east More...
 

Function Documentation

◆ 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_colcolumn
Returns
double

Definition at line 503 of file cnversions.c.

◆ 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_rowrow
Returns
double

Definition at line 487 of file cnversions.c.

◆ 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_colcolumn
Returns
double

Definition at line 472 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_rowrow
Returns
double

Definition at line 456 of file cnversions.c.

◆ 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_colx
Returns
double

Definition at line 411 of file cnversions.c.

◆ 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_rowy
Returns
double

Definition at line 396 of file cnversions.c.

◆ 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_colx
Returns
double

Definition at line 441 of file cnversions.c.

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_rowy
Returns
double

Definition at line 426 of file cnversions.c.

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
windowregion
ttop
bbottom
lleft
rright
Returns
none

Definition at line 152 of file cnversions.c.

◆ D_fit_d_to_u()

void D_fit_d_to_u ( void  )

Definition at line 97 of file cnversions.c.

Referenced by D_setup2().

◆ D_fit_u_to_d()

void D_fit_u_to_d ( void  )

Definition at line 102 of file cnversions.c.

◆ D_get_a()

void D_get_a ( int  x[2][2])

Definition at line 370 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 248 of file cnversions.c.

◆ D_get_a_north()

double D_get_a_north ( void  )

Definition at line 252 of file cnversions.c.

◆ D_get_a_south()

double D_get_a_south ( void  )

Definition at line 256 of file cnversions.c.

◆ D_get_a_to_d_xconv()

double D_get_a_to_d_xconv ( void  )

Definition at line 193 of file cnversions.c.

◆ D_get_a_to_d_yconv()

double D_get_a_to_d_yconv ( void  )

Definition at line 197 of file cnversions.c.

◆ D_get_a_to_u_xconv()

double D_get_a_to_u_xconv ( void  )

Definition at line 185 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 189 of file cnversions.c.

Referenced by D_get_ns_resolution().

◆ D_get_a_west()

double D_get_a_west ( void  )

Definition at line 244 of file cnversions.c.

◆ D_get_d()

void D_get_d ( double  x[2][2])

Definition at line 378 of file cnversions.c.

References x.

◆ D_get_d_east()

double D_get_d_east ( void  )

Definition at line 265 of file cnversions.c.

Referenced by D_set_clip_window_to_map_window().

◆ D_get_d_north()

double D_get_d_north ( void  )

Definition at line 269 of file cnversions.c.

Referenced by D_set_clip_window_to_map_window().

◆ D_get_d_south()

double D_get_d_south ( void  )

Definition at line 273 of file cnversions.c.

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 169 of file cnversions.c.

◆ D_get_d_to_a_yconv()

double D_get_d_to_a_yconv ( void  )

Definition at line 173 of file cnversions.c.

◆ D_get_d_to_u_xconv()

double D_get_d_to_u_xconv ( void  )

Definition at line 177 of file cnversions.c.

◆ D_get_d_to_u_yconv()

double D_get_d_to_u_yconv ( void  )

Definition at line 181 of file cnversions.c.

◆ D_get_d_west()

double D_get_d_west ( void  )

Definition at line 261 of file cnversions.c.

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
ttop
bbottom
lleft
rright
Returns
none

Definition at line 354 of file cnversions.c.

References t.

Referenced by D_erase().

◆ D_get_ew_resolution()

double D_get_ew_resolution ( void  )

Definition at line 222 of file cnversions.c.

References D_get_a_to_u_xconv().

◆ D_get_grid()

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

Definition at line 323 of file cnversions.c.

References t.

◆ D_get_ns_resolution()

double D_get_ns_resolution ( void  )

Definition at line 218 of file cnversions.c.

References D_get_a_to_u_yconv().

◆ 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
ttop
bbottom
lleft
rright
Returns
void

Definition at line 306 of file cnversions.c.

References t.

Referenced by D_clip_to_map().

◆ D_get_u()

void D_get_u ( double  x[2][2])

Definition at line 362 of file cnversions.c.

References x.

◆ D_get_u_east()

double D_get_u_east ( void  )

Definition at line 231 of file cnversions.c.

◆ D_get_u_north()

double D_get_u_north ( void  )

Definition at line 235 of file cnversions.c.

◆ D_get_u_south()

double D_get_u_south ( void  )

Definition at line 239 of file cnversions.c.

◆ D_get_u_to_a_xconv()

double D_get_u_to_a_xconv ( void  )

Definition at line 209 of file cnversions.c.

◆ D_get_u_to_a_yconv()

double D_get_u_to_a_yconv ( void  )

Definition at line 213 of file cnversions.c.

◆ D_get_u_to_d_xconv()

double D_get_u_to_d_xconv ( void  )

Definition at line 201 of file cnversions.c.

◆ D_get_u_to_d_yconv()

double D_get_u_to_d_yconv ( void  )

Definition at line 205 of file cnversions.c.

◆ D_get_u_west()

double D_get_u_west ( void  )

Definition at line 227 of file cnversions.c.

◆ D_is_lat_lon()

int D_is_lat_lon ( void  )

Definition at line 164 of file cnversions.c.

◆ D_set_dst()

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

Definition at line 331 of file cnversions.c.

Referenced by D_setup2(), and D_setup_unity().

◆ D_set_grid()

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

Definition at line 314 of file cnversions.c.

◆ D_set_region()

void D_set_region ( const struct Cell_head *  window)

Definition at line 278 of file cnversions.c.

◆ D_set_src()

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

Definition at line 285 of file cnversions.c.

Referenced by D_setup2(), and D_setup_unity().

◆ D_show_conversions()

void D_show_conversions ( void  )

Definition at line 107 of file cnversions.c.

◆ 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_coleast
Returns
double

Definition at line 563 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_rownorth
Returns
double

Definition at line 548 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_coleast
Returns
double

Definition at line 533 of file cnversions.c.

◆ 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_rownorth
Returns
double

Definition at line 518 of file cnversions.c.

◆ D_update_conversions()

void D_update_conversions ( void  )

Definition at line 90 of file cnversions.c.

Referenced by D_setup2(), and D_setup_unity().