Coordinate Mapping Functions

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

Functions

EAPI 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...
 
EAPI 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...
 
EAPI 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...
 
EAPI 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

EAPI 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);
*
EAPI 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);
*
EAPI 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);
*
EAPI 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);
*