Tizen Native API
Snapshot

This provides APIs related to take snapshots.

Functions

int maps_view_capture_snapshot (maps_view_h view, maps_view_snapshot_format_type_e type, int quality, const char *path)
 Captures a snapshot of the Map View.
The request is synchronous.

Typedefs

typedef enum
_maps_view_snapshot_format_type_e 
maps_view_snapshot_format_type_e
 Enumerations of snapshot file format type.

Typedef Documentation

Enumerations of snapshot file format type.

Since :
2.3.2

Enumeration Type Documentation

Enumerations of snapshot file format type.

Since :
2.3.2
Enumerator:
MAPS_VIEW_SNAPSHOT_BMP 

Indicates the BMP format type

MAPS_VIEW_SNAPSHOT_JPEG 

Indicates the JPEG format type


Function Documentation

int maps_view_capture_snapshot ( maps_view_h  view,
maps_view_snapshot_format_type_e  type,
int  quality,
const char *  path 
)

Captures a snapshot of the Map View.
The request is synchronous.

This function retrieves an image of a map currently represented on the Map View.

Since :
2.3.2
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mapservice
Remarks:
To check if Maps Provider is capable of capturing snapshots use maps_service_provider_is_service_supported() with MAPS_SERVICE_VIEW_SNAPSHOT passed as service parameter.
It returns MAPS_ERROR_PERMISSION_DENIED if application doesn't have permission to write to the path.
Parameters:
[in]viewThe Map View handle
[in]typeThe type of file format
[in]qualityThe quality for encoding (1~100)
[in]pathThe file path to be created callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MAPS_ERROR_NONESuccessful
MAPS_ERROR_INVALID_PARAMETERInvalid parameter
MAPS_ERROR_SERVICE_NOT_AVAILABLEService not available
MAPS_ERROR_PERMISSION_DENIEDPermission Denied
MAPS_ERROR_INVALID_OPERATIONOperation is not valid
MAPS_ERROR_NOT_SUPPORTEDNot supported
Precondition:
Call maps_service_create() and map_view_create() to issue Maps Service and Map View handles respectively.
Postcondition:
It invokes map_view_snapshot_cb() to deliver requested snapshot.
See also:
maps_view_create()
maps_service_create()