Tizen Native API  7.0

The Project API provides functions to manage project.

Required Header

#include <media_editor.h>

Overview

The Mediaeditor Project API allows you to:

  • create/save editorial cut information as project file
  • load editorial cut information from project file and user can edit clip again

Functions

int mediaeditor_create_project (mediaeditor_h editor, const char *path)
 Creates a project to path.
int mediaeditor_load_project (mediaeditor_h editor, const char *path, mediaeditor_project_loaded_cb callback, void *user_data)
 Loads a project from path, asynchronously.
int mediaeditor_save_project (mediaeditor_h editor)
 Saves the current editing information.

Typedefs

typedef void(* mediaeditor_project_loaded_cb )(void *user_data)
 Called when a timeline of the project is loaded.

Typedef Documentation

typedef void(* mediaeditor_project_loaded_cb)(void *user_data)

Called when a timeline of the project is loaded.

Since :
7.0
Parameters:
[in]user_dataThe user data passed from the callback registration function
See also:
mediaeditor_load_project()

Function Documentation

int mediaeditor_create_project ( mediaeditor_h  editor,
const char *  path 
)

Creates a project to path.

Since :
7.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediastorage
Privilege:
http://tizen.org/privilege/externalstorage
Remarks:
If you want to access only internal storage by using this function, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage by using this function, you should add privilege http://tizen.org/privilege/externalstorage.
If you want to access both storage, you must add both privileges.
Parameters:
[in]editorThe media editor handle
[in]pathThe path to create project
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIAEDITOR_ERROR_NONESuccessful
MEDIAEDITOR_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
MEDIAEDITOR_ERROR_INVALID_PARAMETERInvalid parameter
MEDIAEDITOR_ERROR_INVALID_OPERATIONInvalid operation
MEDIAEDITOR_ERROR_INVALID_STATEInvalid state
Precondition:
editor state must be set to MEDIAEDITOR_STATE_IDLE.
See also:
mediaeditor_save_project()
int mediaeditor_load_project ( mediaeditor_h  editor,
const char *  path,
mediaeditor_project_loaded_cb  callback,
void *  user_data 
)

Loads a project from path, asynchronously.

Since :
7.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/mediastorage
Privilege:
http://tizen.org/privilege/externalstorage
Remarks:
If you want to access only internal storage by using this function, you should add privilege http://tizen.org/privilege/mediastorage.
Or if you want to access only external storage by using this function, you should add privilege http://tizen.org/privilege/externalstorage.
If you want to access both storage, you must add both privileges.
Parameters:
[in]editorThe media editor handle
[in]pathThe path to the saved project
[in]callbackThe callback function to register
[in]user_dataThe user data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIAEDITOR_ERROR_NONESuccessful
MEDIAEDITOR_ERROR_PERMISSION_DENIEDThe access to the resources can not be granted
MEDIAEDITOR_ERROR_INVALID_PARAMETERInvalid parameter
MEDIAEDITOR_ERROR_INVALID_OPERATIONInvalid operation
MEDIAEDITOR_ERROR_INVALID_STATEInvalid state
Precondition:
editor state must be set to MEDIAEDITOR_STATE_IDLE.
Postcondition:
mediaeditor_project_loaded_cb() will be invoked.
See also:
mediaeditor_save_project()

Saves the current editing information.

Since :
7.0
Remarks:
The project will be saved to the project's path, which was set during creation or loading.
Parameters:
[in]editorThe media editor handle
Returns:
0 on success, otherwise a negative error value
Return values:
MEDIAEDITOR_ERROR_NONESuccessful
MEDIAEDITOR_ERROR_INVALID_PARAMETERInvalid parameter
MEDIAEDITOR_ERROR_INVALID_OPERATIONInvalid operation
MEDIAEDITOR_ERROR_INVALID_STATEInvalid state
Precondition:
editor state must be set to MEDIAEDITOR_STATE_IDLE.
The project must be created or loaded.
See also:
mediaeditor_create_project()
mediaeditor_load_project()