Tizen Native API  5.5
EFL UTIL SCREENSHOT

Provides functions to capture screen shot.

Required Header

#include <efl_util.h>

Overview

The EFL UTIL SCREENSHOT API provides functions to capture screenshot. Client can get screenshot image by efl_util_screenshot_take_tbm_surface API with tbm_surface handler.

Functions

efl_util_screenshot_h efl_util_screenshot_initialize (int width, int height)
 Initializes the screenshot.
tbm_surface_h efl_util_screenshot_take_tbm_surface (efl_util_screenshot_h screenshot)
 Takes a screenshot and get a tbm_surface handle.
int efl_util_screenshot_deinitialize (efl_util_screenshot_h screenshot)
 Deinitializes the screenshot.

Typedefs

typedef struct
_efl_util_screenshot_h * 
efl_util_screenshot_h
 Definition for the screenshot handle.

Typedef Documentation

typedef struct _efl_util_screenshot_h* efl_util_screenshot_h

Definition for the screenshot handle.

Warning:
This is not for use by third-party applications.
Since :
3.0

Function Documentation

Deinitializes the screenshot.

Warning:
This is not for use by third-party applications.
Since :
3.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/screenshot
Parameters:
[in]screenshotefl_util_screenshot_h handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_PERMISSION_DENIEDNo permission for screenshot
See also:
efl_util_screenshot_initialize()
efl_util_screenshot_h efl_util_screenshot_initialize ( int  width,
int  height 
)

Initializes the screenshot.

Warning:
This is not for use by third-party applications.
Since :
3.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/screenshot
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]widthwidth of the screenshot surface
[in]heightheight of the screenshot surface
Returns:
efl_util_screenshot_h on success, otherwise NULL
Return values:
efl_util_screenshot_hThe screenshot handle
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_SCREENSHOT_INIT_FAILInitialization failure
EFL_UTIL_ERROR_PERMISSION_DENIEDNo permission for screenshot
See also:
efl_util_screenshot_deinitialize()

Takes a screenshot and get a tbm_surface handle.

Warning:
This is not for use by third-party applications.
Since :
3.0
Privilege Level:
platform
Privilege:
http://tizen.org/privilege/screenshot
Remarks:
The specific error code can be obtained using the get_last_result() The tbm_surface_h must be free by caller
Parameters:
[in]screenshotefl_util_screenshot_h handle
Returns:
tbm_surface_h on success, otherwise NULL
Return values:
tbm_surface_hThe TBM surface handle
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_SCREENSHOT_EXECUTION_FAILExecution failure
EFL_UTIL_ERROR_PERMISSION_DENIEDNo permission for screenshot
See also:
efl_util_screenshot_initialize()
efl_util_screenshot_deinitialize()