Tizen Native API
Display

The Display API provides functions to control the display status.

Required Header

#include <device/display.h>
#include <device/callback.h>

Overview

The Display API provides the way to get supported display count and the display brightness. It also supports the API to set the display brightness. Application can receive the display event by callback function from the system.

Functions

int device_display_get_numbers (int *device_number)
 Gets the number of display devices.
int device_display_get_max_brightness (int display_index, int *max_brightness)
 Gets the maximum brightness value that can be set.
int device_display_get_brightness (int display_index, int *brightness)
 Gets the display brightness value.
int device_display_set_brightness (int display_index, int brightness)
 Sets the display brightness value.
int device_display_get_state (display_state_e *state)
 Gets the current display state.
int device_display_change_state (display_state_e state) TIZEN_DEPRECATED_API
 Changes the display state by force.

Enumeration Type Documentation

Enumeration for the available display states.

Since :
2.3
Enumerator:
DISPLAY_STATE_NORMAL 

Normal state

DISPLAY_STATE_SCREEN_DIM 

Screen dim state

DISPLAY_STATE_SCREEN_OFF 

Screen off state


Function Documentation

Changes the display state by force.

Deprecated:
Deprecated Since 2.4
Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/display
Remarks:
This API triggers display change process and then updates the status when it completes. While the operation is on-going, the device_display_get_state() function returns previous display state.
Parameters:
[in]stateThe display state
Returns:
0 on success, otherwise a negative error value
Return values:
DEVICE_ERROR_NONESuccessful
DEVICE_ERROR_INVALID_PARAMETERInvalid parameter
DEVICE_ERROR_PERMISSION_DENIEDPermission denied
DEVICE_ERROR_OPERATION_FAILEDOperation failed
See also:
device_power_request_lock()
device_power_release_lock()
device_add_callback
device_remove_callback
DEVICE_CALLBACK_DISPLAY_STATE
Example
  ...
  result = device_display_change_state(DISPLAY_STATE_SCREEN_OFF);
  if (result < 0)
      dlog_print(DLOG_ERROR, LOG_TAG, "[ERROR] return value result =%d, \n",result);
  else
      dlog_print(DLOG_DEBUG, LOG_TAG, "[SUCCESS] return value result =%d \n",result);
  ...
int device_display_get_brightness ( int  display_index,
int *  brightness 
)

Gets the display brightness value.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/display
Parameters:
[in]display_indexThe index of the display
It can be greater than or equal to 0 and less than the number of displays returned by device_display_get_numbers().
The index zero is always assigned to the main display
[out]brightnessThe current brightness value of the display
Returns:
0 on success, otherwise a negative error value
Return values:
DEVICE_ERROR_NONESuccessful
DEVICE_ERROR_INVALID_PARAMETERInvalid parameter
DEVICE_ERROR_PERMISSION_DENIEDPermission denied
DEVICE_ERROR_OPERATION_FAILEDOperation failed
See also:
device_display_get_numbers()
device_display_set_brightness()
device_display_get_max_brightness()
int device_display_get_max_brightness ( int  display_index,
int *  max_brightness 
)

Gets the maximum brightness value that can be set.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/display
Parameters:
[in]display_indexThe index of the display
It can be greater than or equal to 0 and less than the number of displays returned by device_display_get_numbers().
The index zero is always assigned to the main display
[out]max_brightnessThe maximum brightness value of the display
Returns:
0 on success, otherwise a negative error value
Return values:
DEVICE_ERROR_NONESuccessful
DEVICE_ERROR_INVALID_PARAMETERInvalid parameter
DEVICE_ERROR_PERMISSION_DENIEDPermission denied
DEVICE_ERROR_OPERATION_FAILEDOperation failed
See also:
device_display_get_numbers()
device_display_set_brightness()
device_display_get_brightness()
int device_display_get_numbers ( int *  device_number)

Gets the number of display devices.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/display
Parameters:
[out]device_numberThe total number of displays
Returns:
0 on success, otherwise a negative error value
Return values:
DEVICE_ERROR_NONESuccessful
DEVICE_ERROR_INVALID_PARAMETERInvalid parameter
DEVICE_ERROR_PERMISSION_DENIEDPermission denied
DEVICE_ERROR_OPERATION_FAILEDOperation failed
See also:
device_display_get_brightness()
device_display_set_brightness()
device_display_get_max_brightness()

Gets the current display state.

Since :
2.3
Parameters:
[out]stateThe display state
Returns:
0 on success, otherwise a negative error value
Return values:
DEVICE_ERROR_NONESuccessful
DEVICE_ERROR_INVALID_PARAMETERInvalid parameter
DEVICE_ERROR_OPERATION_FAILEDOperation failed
See also:
device_add_callback
device_remove_callback
DEVICE_CALLBACK_DISPLAY_STATE
int device_display_set_brightness ( int  display_index,
int  brightness 
)

Sets the display brightness value.

Since :
2.3
Privilege Level:
public
Privilege:
http://tizen.org/privilege/display
Parameters:
[in]display_indexThe index of the display
It can be greater than or equal to 0 and less than the number of displays returned by device_display_get_numbers().
The index zero is always assigned to the main display
[in]brightnessThe new brightness value to set
The maximum value can be represented by device_display_get_max_brightness()
Returns:
0 on success, otherwise a negative error value
Return values:
DEVICE_ERROR_NONESuccessful
DEVICE_ERROR_INVALID_PARAMETERInvalid parameter
DEVICE_ERROR_PERMISSION_DENIEDPermission denied
DEVICE_ERROR_OPERATION_FAILEDOperation failed
See also:
device_display_get_numbers()
device_display_get_max_brightness()
device_display_get_brightness()