This group provides functions that set and retrieve the output and viewport size of an evas.

Functions
void	evas_output_size_set (Evas *e, int w, int h)
	Sets the output size of the render engine of the given evas.
void	evas_output_size_get (const Evas e, int w, int *h)
	Gets the output size of the render engine of the given evas.
void	evas_output_viewport_set (Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h)
	Sets the output viewport of the given evas in evas units.
void	evas_output_viewport_get (const Evas e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord *h)
	Gets the render engine's output viewport co-ordinates in canvas units.
void	evas_output_framespace_set (Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h)
	Sets the output framespace size of the render engine of the given evas.
void	evas_output_framespace_get (const Evas e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord *h)
	Gets the render engine's output framespace co-ordinates in canvas units.

Function Documentation

void evas_output_framespace_get	(	const Evas *	e,
		Evas_Coord *	x,
		Evas_Coord *	y,
		Evas_Coord *	w,
		Evas_Coord *	h
	)

Gets the render engine's output framespace co-ordinates in canvas units.

Since (EFL) :: 1.1

Since :: 2.3.1

Parameters:

[in]	e	The pointer to the Evas Canvas
[out]	x	The pointer to the x variable to be filled in
[out]	y	The pointer to the y variable to be filled in
[out]	w	The pointer to the width variable to be filled in
[out]	h	The pointer to the height variable to be filled in

void evas_output_framespace_set	(	Evas *	e,
		Evas_Coord	x,
		Evas_Coord	y,
		Evas_Coord	w,
		Evas_Coord	h
	)

Sets the output framespace size of the render engine of the given evas.

Since (EFL) :: 1.1

Since :: 2.3.1

Remarks:: The framespace size is used in the Wayland engines to denote space where the output is not drawn. This is mainly used in ecore_evas to draw borders.; The units used for w and h depend on the engine used by the evas.

Parameters:

[in]	e	The given evas
[in]	x	The left coordinate in output units, usually pixels
[in]	y	The top coordinate in output units, usually pixels
[in]	w	The width in output units, usually pixels
[in]	h	The height in output units, usually pixels

void evas_output_size_get	(	const Evas *	e,
		int *	w,
		int *	h
	)

Gets the output size of the render engine of the given evas.

Since :: 2.3.1

Remarks:: The output size is in the output units for the engine.; If either w or h is NULL, then it is ignored. If e is invalid, the returned results are undefined.

Parameters:

[in]	e	The given evas
[out]	w	The pointer to an integer to store the width in
[out]	h	The pointer to an integer to store the height in

void evas_output_size_set	(	Evas *	e,
		int	w,
		int	h
	)

Sets the output size of the render engine of the given evas.

Since :: 2.3.1

Remarks:: The evas renders to a rectangle of the given size once this function is called. The output size is independent of the viewport size. The viewport is stretched to fill the given rectangle.; The units used for w and h depend on the engine used by the evas.

Parameters:

[in]	e	The given evas
[in]	w	The width in output units, usually pixels
[in]	h	The height in output units, usually pixels

void evas_output_viewport_get	(	const Evas *	e,
		Evas_Coord *	x,
		Evas_Coord *	y,
		Evas_Coord *	w,
		Evas_Coord *	h
	)

Gets the render engine's output viewport co-ordinates in canvas units.

Since :: 2.3.1

Remarks:

Calling this function writes the current canvas output viewport size and location values into the variables pointed to by x, y, w and h. On success, the variables have the output location and size values written to them in canvas units. Any of x, y, w or h that are NULL is not written to. If e is invalid, the results are undefined.

The following is an example.

 extern Evas *evas;
 Evas_Coord x, y, width, height;

 evas_output_viewport_get(evas, &x, &y, &w, &h);

Parameters:

[in]	e	The pointer to the Evas Canvas
[out]	x	The pointer to the x variable to be filled in
[out]	y	The pointer to the y variable to be filled in
[out]	w	The pointer to the width variable to be filled in
[out]	h	The pointer to the height variable to be filled in

void evas_output_viewport_set	(	Evas *	e,
		Evas_Coord	x,
		Evas_Coord	y,
		Evas_Coord	w,
		Evas_Coord	h
	)

Sets the output viewport of the given evas in evas units.

Since :: 2.3.1

Remarks:: The output viewport is the area of the evas that is visible to the viewer. The viewport is stretched to fit the output target of the evas when rendering is performed.; The coordinate values do not have to map 1-to-1 with the output target. However, it is generally advised that it is done for ease of use.

Parameters:

[in]	e	The given evas
[in]	x	The top-left corner x value of the viewport
[in]	y	The top-left corner y value of the viewport
[in]	w	The width of the viewport Must be greater than `0`.
[in]	h	The height of the viewport Must be greater than `0`.

Functions

Function Documentation