Enumeration for display mode.

Since :

2.3.1

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

Enumeration for display rotation type.

Since :

2.3.1

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

Gets the video display mode.

Since :

2.3.1

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()

Gets the rotation of the video surface display.

Since :

2.3.1

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()

Gets the visibility of the video display.

Since :

2.3.1

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()

Sets the video display mode.

Since :

2.3.1

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()

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

Since :

3.0

Remarks:

If no display is set, no operation is performed.

Before set display ROI area, PLAYER_DISPLAY_MODE_DST_ROI must be set with player_set_display_mode(). The minimum value of width and height are 1.

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:

display_mode must be set to PLAYER_DISPLAY_MODE_DST_ROI.

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()

Sets the rotation settings of the video surface display.

Since :

2.3.1

Remarks:

If no display is set, no operation is performed.

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

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()

Sets the visibility of the video display.

Since :

2.3.1

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()