Coordinate Mapping Functions

Functions that are used to map coordinates from the canvas to the screen or the screen to the canvas. More...

Functions

Evas_Coord evas_coord_screen_x_to_world (const Evas *e, int x)
 Convert/scale an ouput screen co-ordinate into canvas co-ordinates. More...
 
Evas_Coord evas_coord_screen_y_to_world (const Evas *e, int y)
 Convert/scale an ouput screen co-ordinate into canvas co-ordinates. More...
 
int evas_coord_world_x_to_screen (const Evas *e, Evas_Coord x)
 Convert/scale a canvas co-ordinate into output screen co-ordinates. More...
 
int evas_coord_world_y_to_screen (const Evas *e, Evas_Coord y)
 Convert/scale a canvas co-ordinate into output screen co-ordinates. More...
 

Detailed Description

Functions that are used to map coordinates from the canvas to the screen or the screen to the canvas.

Function Documentation

Evas_Coord evas_coord_screen_x_to_world ( const Evas e,
int  x 
)

Convert/scale an ouput screen co-ordinate into canvas co-ordinates.

Parameters
eThe pointer to the Evas Canvas
xThe screen/output x co-ordinate
Returns
The screen co-ordinate translated to canvas unit co-ordinates

This function takes in a horizontal co-ordinate as the x parameter and converts it into canvas units, accounting for output size, viewport size and location, returning it as the function return value. If e is invalid, the results are undefined.

Example:

extern Evas *evas;
extern int screen_x;
Evas_Coord canvas_x;
canvas_x = evas_coord_screen_x_to_world(evas, screen_x);
Evas_Coord evas_coord_screen_y_to_world ( const Evas e,
int  y 
)

Convert/scale an ouput screen co-ordinate into canvas co-ordinates.

Parameters
eThe pointer to the Evas Canvas
yThe screen/output y co-ordinate
Returns
The screen co-ordinate translated to canvas unit co-ordinates

This function takes in a vertical co-ordinate as the y parameter and converts it into canvas units, accounting for output size, viewport size and location, returning it as the function return value. If e is invalid, the results are undefined.

Example:

extern Evas *evas;
extern int screen_y;
Evas_Coord canvas_y;
canvas_y = evas_coord_screen_y_to_world(evas, screen_y);
int evas_coord_world_x_to_screen ( const Evas e,
Evas_Coord  x 
)

Convert/scale a canvas co-ordinate into output screen co-ordinates.

Parameters
eThe pointer to the Evas Canvas
xThe canvas x co-ordinate
Returns
The output/screen co-ordinate translated to output co-ordinates

This function takes in a horizontal co-ordinate as the x parameter and converts it into output units, accounting for output size, viewport size and location, returning it as the function return value. If e is invalid, the results are undefined.

Example:

extern Evas *evas;
int screen_x;
extern Evas_Coord canvas_x;
screen_x = evas_coord_world_x_to_screen(evas, canvas_x);
int evas_coord_world_y_to_screen ( const Evas e,
Evas_Coord  y 
)

Convert/scale a canvas co-ordinate into output screen co-ordinates.

Parameters
eThe pointer to the Evas Canvas
yThe canvas y co-ordinate
Returns
The output/screen co-ordinate translated to output co-ordinates

This function takes in a vertical co-ordinate as the x parameter and converts it into output units, accounting for output size, viewport size and location, returning it as the function return value. If e is invalid, the results are undefined.

Example:

extern Evas *evas;
int screen_y;
extern Evas_Coord canvas_y;
screen_y = evas_coord_world_y_to_screen(evas, canvas_y);