The Display API provides functions to control the display.

Required Header

#include <player.h>

Overview

The API allows you to manage the display of the player. This API provides functions to set and get various display properties:

mode
rotation
visibility

Functions
int	player_set_display_mode (player_h player, player_display_mode_e mode)
	Sets the video display mode.
int	player_get_display_mode (player_h player, player_display_mode_e *mode)
	Gets the video display mode.
int	player_set_display_roi_area (player_h player, int x, int y, int width, int height)
	Sets the ROI(Region Of Interest) area of display.
int	player_set_display_visible (player_h player, bool visible)
	Sets the visibility of the video display.
int	player_is_display_visible (player_h player, bool *visible)
	Gets the visibility of the video display.
int	player_set_display_rotation (player_h player, player_display_rotation_e rotation)
	Sets the rotation settings of the video surface display.
int	player_get_display_rotation (player_h player, player_display_rotation_e *rotation)
	Gets the rotation of the video surface display.
Typedefs
typedef void *	player_display_h
	The player display handle.
Defines
#define	GET_DISPLAY(x) (void*)(x)
	Definition for a display handle from evas object.

Define Documentation

#define GET_DISPLAY ( x ) (void*)(x)

Definition for a display handle from evas object.

Since :: 2.3

Typedef Documentation

typedef void* player_display_h

The player display handle.

Since :: 2.3

Enumeration Type Documentation

enum player_display_mode_e

Enumeration for display mode.

Since :: 2.3

Enumerator:

PLAYER_DISPLAY_MODE_LETTER_BOX	Letter box
PLAYER_DISPLAY_MODE_ORIGIN_SIZE	Origin size
PLAYER_DISPLAY_MODE_FULL_SCREEN	Full-screen
PLAYER_DISPLAY_MODE_CROPPED_FULL	Cropped full-screen
PLAYER_DISPLAY_MODE_ORIGIN_OR_LETTER	Origin size (if surface size is larger than video size(width/height)) or Letter box (if video size(width/height) is larger than surface size)
PLAYER_DISPLAY_MODE_DST_ROI	Dst ROI mode

enum player_display_rotation_e

Enumeration for display rotation type.

Since :: 2.3

Enumerator:

PLAYER_DISPLAY_ROTATION_NONE	Display is not rotated
PLAYER_DISPLAY_ROTATION_90	Display is rotated 90 degrees
PLAYER_DISPLAY_ROTATION_180	Display is rotated 180 degrees
PLAYER_DISPLAY_ROTATION_270	Display is rotated 270 degrees

Function Documentation

int player_get_display_mode	(	player_h	player,
		player_display_mode_e *	mode
	)

Gets the video display mode.

Since :: 2.3

Remarks:: If no display is set, no operation is performed.

Parameters:

[in]	player	The handle to the media player
[out]	mode	The current display mode

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_display_mode_e; player_set_display_mode()

int player_get_display_rotation	(	player_h	player,
		player_display_rotation_e *	rotation
	)

Gets the rotation of the video surface display.

Since :: 2.3

Parameters:

[in]	player	The handle to the media player
[out]	rotation	The current rotation of the display

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_display_rotation_e; player_set_display_rotation()

int player_is_display_visible	(	player_h	player,
		bool *	visible
	)

Gets the visibility of the video display.

Since :: 2.3

Parameters:

[in]	player	The handle to the media player
[out]	visible	The current visibility of the display (`true` = visible, `false` = non-visible )

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_set_display_visible()

int player_set_display_mode	(	player_h	player,
		player_display_mode_e	mode
	)

Sets the video display mode.

Since :: 2.3

Remarks:: If no display is set, no operation is performed.

Parameters:

[in]	player	The handle to the media player
[in]	mode	The display mode

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation
PLAYER_ERROR_INVALID_STATE	Invalid state

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_display_mode_e; player_set_display(); player_get_display_mode()

int player_set_display_roi_area	(	player_h	player,
		int	x,
		int	y,
		int	width,
		int	height
	)

Sets the ROI(Region Of Interest) area of display.

Since :: 3.0

Remarks:: If no display is set, no operation is performed and the ROI area is valid only in PLAYER_DISPLAY_MODE_DST_ROI display mode.; The minimum value of width and height are 1.; ROI area can be set before setting ROI display mode. (since 4.0)

Parameters:

[in]	player	The handle to the media player
[in]	x	X coordinate of area
[in]	y	Y coordinate of area
[in]	width	Width of area
[in]	height	Height of area

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_set_display(); player_set_display_mode()

int player_set_display_rotation	(	player_h	player,
		player_display_rotation_e	rotation
	)

Sets the rotation settings of the video surface display.

Use this function to change the video orientation to portrait mode.

Since :: 2.3

Remarks:: If no display is set, no operation is performed.

Parameters:

[in]	player	The handle to the media player
[in]	rotation	The rotation of the display

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation
PLAYER_ERROR_INVALID_STATE	Invalid state

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_display_rotation_e; player_set_display; player_get_display_rotation()

int player_set_display_visible	(	player_h	player,
		bool	visible
	)

Sets the visibility of the video display.

Since :: 2.3

Remarks:: If no display is set, no operation is performed.; If you set visible before calling player_set_display, it will be applied on PLAYER_STATE_READY state.

Parameters:

[in]	player	The handle to the media player
[in]	visible	The visibility of the display (`true` = visible, `false` = non-visible )

Returns:: 0 on success, otherwise a negative error value

Return values:

PLAYER_ERROR_NONE	Successful
PLAYER_ERROR_INVALID_PARAMETER	Invalid parameter
PLAYER_ERROR_INVALID_OPERATION	Invalid operation
PLAYER_ERROR_INVALID_STATE	Invalid state

Precondition:: The player state must be one of PLAYER_STATE_IDLE, PLAYER_STATE_READY, PLAYER_STATE_PLAYING, or PLAYER_STATE_PAUSED.

See also:: player_set_display(); player_is_display_visible()

Required Header

Overview

Functions

Typedefs

Defines

Define Documentation

Typedef Documentation

Enumeration Type Documentation

Function Documentation