From 1cd4f318ea0b0eef14d2b62d28a48b9beb5d6da3 Mon Sep 17 00:00:00 2001 From: Jeongmo Yang Date: Tue, 16 Jun 2020 19:24:37 +0900 Subject: [PATCH] Code clean up - Replace tab by space in description [Version] 0.3.21 [Profile] Common [Issue Type] Clean up Change-Id: If4faf4b9c05f61e0cba469cf00187d940f3ebf88 Signed-off-by: Jeongmo Yang --- include/recorder.h | 432 ++++++++++++++++++------------------- packaging/capi-media-recorder.spec | 2 +- 2 files changed, 217 insertions(+), 217 deletions(-) diff --git a/include/recorder.h b/include/recorder.h index 308dbed..083cdea 100644 --- a/include/recorder.h +++ b/include/recorder.h @@ -200,13 +200,13 @@ typedef void (*recorder_recording_limit_reached_cb)(recorder_recording_limit_typ * @brief Called to indicate the recording status. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This callback function is repeatedly invoked during the #RECORDER_STATE_RECORDING state. - * @param[in] elapsed_time The time of the recording (milliseconds) - * @param[in] file_size The size of the recording file (KB) - * @param[in] user_data The user data passed from the callback registration function + * @param[in] elapsed_time The time of the recording (milliseconds) + * @param[in] file_size The size of the recording file (KB) + * @param[in] user_data The user data passed from the callback registration function * @pre recorder_start() will invoke this callback if you register it using recorder_set_recording_status_cb(). - * @see recorder_set_recording_status_cb() - * @see recorder_unset_recording_status_cb() - * @see recorder_start() + * @see recorder_set_recording_status_cb() + * @see recorder_unset_recording_status_cb() + * @see recorder_start() */ typedef void (*recorder_recording_status_cb)(unsigned long long elapsed_time, unsigned long long file_size, void *user_data); @@ -218,13 +218,13 @@ typedef void (*recorder_recording_status_cb)(unsigned long long elapsed_time, un * @param[in] by_policy @c true if the state is changed by policy, otherwise @c false if the state is not changed * @param[in] user_data The user data passed from the callback registration function * @pre This function is required to register a callback using recorder_set_state_changed_cb(). - * @see recorder_set_state_changed_cb() - * @see recorder_prepare() - * @see recorder_unprepare() - * @see recorder_start() - * @see recorder_pause() - * @see recorder_commit() - * @see recorder_cancel() + * @see recorder_set_state_changed_cb() + * @see recorder_prepare() + * @see recorder_unprepare() + * @see recorder_start() + * @see recorder_pause() + * @see recorder_commit() + * @see recorder_cancel() */ typedef void (*recorder_state_changed_cb)(recorder_state_e previous , recorder_state_e current , bool by_policy, void *user_data); @@ -234,7 +234,7 @@ typedef void (*recorder_state_changed_cb)(recorder_state_e previous , recorder_s * @param[in] type The recorder type * @param[in] state The state of the recorder device * @param[in] user_data The user data passed from the callback registration function - * @see recorder_add_device_state_changed_cb() + * @see recorder_add_device_state_changed_cb() */ typedef void (*recorder_device_state_changed_cb)(recorder_type_e type, recorder_device_state_e state, void *user_data); @@ -242,11 +242,11 @@ typedef void (*recorder_device_state_changed_cb)(recorder_type_e type, recorder_ * @brief Called when the recorder is interrupted by a policy. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks This callback is called after interrupt handling is completed. - * @param[in] policy The policy that interrupted the recorder - * @param[in] previous The previous state of the recorder - * @param[in] current The current state of the recorder - * @param[in] user_data The user data passed from the callback registration function - * @see recorder_set_interrupted_cb() + * @param[in] policy The policy that interrupted the recorder + * @param[in] previous The previous state of the recorder + * @param[in] current The current state of the recorder + * @param[in] user_data The user data passed from the callback registration function + * @see recorder_set_interrupted_cb() */ typedef void (*recorder_interrupted_cb)(recorder_policy_e policy, recorder_state_e previous, recorder_state_e current, void *user_data); @@ -254,10 +254,10 @@ typedef void (*recorder_interrupted_cb)(recorder_policy_e policy, recorder_state * @brief Called when the recorder interrupt is started by a policy. * @since_tizen 4.0 * @remarks This callback is called before interrupt handling is started. - * @param[in] policy The policy that is interrupting the recorder - * @param[in] state The current state of the recorder - * @param[in] user_data The user data passed from the callback registration function - * @see recorder_set_interrupt_started_cb() + * @param[in] policy The policy that is interrupting the recorder + * @param[in] state The current state of the recorder + * @param[in] user_data The user data passed from the callback registration function + * @see recorder_set_interrupt_started_cb() */ typedef void (*recorder_interrupt_started_cb)(recorder_policy_e policy, recorder_state_e state, void *user_data); @@ -294,12 +294,12 @@ typedef void (*recorder_muxed_stream_cb)(void *stream, int size, unsigned long l /** * @brief Called once for each supported video resolution. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] width The video image width - * @param[in] height The video image height - * @param[in] user_data The user data passed from the foreach function + * @param[in] width The video image width + * @param[in] height The video image height + * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop - * @pre recorder_foreach_supported_video_resolution() will invoke this callback. - * @see recorder_foreach_supported_video_resolution() + * @pre recorder_foreach_supported_video_resolution() will invoke this callback. + * @see recorder_foreach_supported_video_resolution() */ typedef bool (*recorder_supported_video_resolution_cb)(int width, int height, void *user_data); @@ -312,12 +312,12 @@ typedef bool (*recorder_supported_video_resolution_cb)(int width, int height, vo * #RECORDER_ERROR_DEVICE \n * #RECORDER_ERROR_INVALID_OPERATION \n * #RECORDER_ERROR_OUT_OF_MEMORY. - * @param[in] error The error code - * @param[in] current_state The current state of the recorder - * @param[in] user_data The user data passed from the callback registration function - * @pre This callback function is invoked if you register this callback using recorder_set_error_cb(). - * @see recorder_set_error_cb() - * @see recorder_unset_error_cb() + * @param[in] error The error code + * @param[in] current_state The current state of the recorder + * @param[in] user_data The user data passed from the callback registration function + * @pre This callback function is invoked if you register this callback using recorder_set_error_cb(). + * @see recorder_set_error_cb() + * @see recorder_unset_error_cb() */ typedef void (*recorder_error_cb)(recorder_error_e error, recorder_state_e current_state, void *user_data); @@ -337,7 +337,7 @@ typedef void (*recorder_error_cb)(recorder_error_e error, recorder_state_e curre * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop * @pre recorder_foreach_supported_file_format() will invoke this callback. - * @see recorder_foreach_supported_file_format() + * @see recorder_foreach_supported_file_format() */ typedef bool (*recorder_supported_file_format_cb)(recorder_file_format_e format, void *user_data); @@ -348,7 +348,7 @@ typedef bool (*recorder_supported_file_format_cb)(recorder_file_format_e format, * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop * @pre recorder_foreach_supported_audio_encoder() will invoke this callback. - * @see recorder_foreach_supported_audio_encoder() + * @see recorder_foreach_supported_audio_encoder() */ typedef bool (*recorder_supported_audio_encoder_cb)(recorder_audio_codec_e codec, void *user_data); @@ -359,7 +359,7 @@ typedef bool (*recorder_supported_audio_encoder_cb)(recorder_audio_codec_e codec * @param[in] user_data The user data passed from the foreach function * @return @c true to continue with the next iteration of the loop, \n otherwise @c false to break out of the loop * @pre recorder_foreach_supported_video_encoder() will invoke this callback. - * @see recorder_foreach_supported_video_encoder() + * @see recorder_foreach_supported_video_encoder() */ typedef bool (*recorder_supported_video_encoder_cb)(recorder_video_codec_e codec, void *user_data); @@ -386,8 +386,8 @@ typedef bool (*recorder_supported_video_encoder_cb)(recorder_video_codec_e codec * but it is required in all earlier versions. * @remarks Since 4.0, It's related to the following feature: %http://tizen.org/feature/media.video_recording \n * instead of using %http://tizen.org/feature/microphone - * @param[in] camera The handle to the camera - * @param[out] recorder A handle to the recorder + * @param[in] camera The handle to the camera + * @param[out] recorder A handle to the recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -409,7 +409,7 @@ int recorder_create_videorecorder(camera_h camera, recorder_h *recorder); * but it is required in all earlier versions. * @remarks Since 4.0, It's related to the following feature: %http://tizen.org/feature/media.audio_recording \n * instead of using %http://tizen.org/feature/microphone - * @param[out] recorder A handle to the recorder + * @param[out] recorder A handle to the recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -427,7 +427,7 @@ int recorder_create_audiorecorder(recorder_h *recorder); * @brief Destroys the recorder handle. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks The video recorder's camera handle is not released by this function. - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -435,11 +435,11 @@ int recorder_create_audiorecorder(recorder_h *recorder); * @retval #RECORDER_ERROR_INVALID_STATE Invalid state * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported - * @pre The recorder state should be #RECORDER_STATE_CREATED. + * @pre The recorder state should be #RECORDER_STATE_CREATED. * @post The recorder state will be #RECORDER_STATE_NONE. - * @see camera_destroy() - * @see recorder_create_videorecorder() - * @see recorder_create_audiorecorder() + * @see camera_destroy() + * @see recorder_create_videorecorder() + * @see recorder_create_audiorecorder() */ int recorder_destroy(recorder_h recorder); @@ -448,7 +448,7 @@ int recorder_destroy(recorder_h recorder); * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks Before calling the function, it is required to properly set audio encoder (recorder_set_audio_encoder()), * video encoder(recorder_set_video_encoder()) and file format (recorder_set_file_format()). - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -458,22 +458,22 @@ int recorder_destroy(recorder_h recorder); * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @pre The recorder state should be #RECORDER_STATE_CREATED by recorder_create_videorecorder(), recorder_create_audiorecorder() or recorder_unprepare(). + * @pre The recorder state should be #RECORDER_STATE_CREATED by recorder_create_videorecorder(), recorder_create_audiorecorder() or recorder_unprepare(). * @post The recorder state will be #RECORDER_STATE_READY. * @post If recorder handle is created by recorder_create_videorecorder(), the camera state will be changed to #CAMERA_STATE_PREVIEW. - * @see recorder_create_videorecorder() - * @see recorder_create_audiorecorder() - * @see recorder_unprepare() - * @see recorder_set_audio_encoder() - * @see recorder_set_video_encoder() - * @see recorder_set_file_format() + * @see recorder_create_videorecorder() + * @see recorder_create_audiorecorder() + * @see recorder_unprepare() + * @see recorder_set_audio_encoder() + * @see recorder_set_video_encoder() + * @see recorder_set_file_format() */ int recorder_prepare(recorder_h recorder); /** * @brief Resets the media recorder. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -482,12 +482,12 @@ int recorder_prepare(recorder_h recorder); * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @pre The recorder state should be #RECORDER_STATE_READY set by recorder_prepare(), recorder_cancel() or recorder_commit(). + * @pre The recorder state should be #RECORDER_STATE_READY set by recorder_prepare(), recorder_cancel() or recorder_commit(). * @post The recorder state will be #RECORDER_STATE_CREATED. * @post If the recorder handle is created by recorder_create_videorecorder(), camera state will be changed to #CAMERA_STATE_CREATED. - * @see recorder_prepare() - * @see recorder_cancel() - * @see recorder_commit() + * @see recorder_prepare() + * @see recorder_cancel() + * @see recorder_commit() */ int recorder_unprepare(recorder_h recorder); @@ -503,7 +503,7 @@ int recorder_unprepare(recorder_h recorder); * If you want to save contents to internal storage, you should add mediastorage privilege. \n * If you want to save contents to external storage, you should add externalstorage privilege. \n * The filename should be set before this function is invoked. - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -515,14 +515,14 @@ int recorder_unprepare(recorder_h recorder); * @pre The recorder state must be #RECORDER_STATE_READY by recorder_prepare() or #RECORDER_STATE_PAUSED by recorder_pause(). \n * The filename should be set by recorder_set_filename(). * @post The recorder state will be #RECORDER_STATE_RECORDING. - * @see recorder_pause() - * @see recorder_commit() - * @see recorder_cancel() - * @see recorder_set_audio_encoder() - * @see recorder_set_filename() - * @see recorder_set_file_format() - * @see recorder_recording_status_cb() - * @see recorder_set_filename() + * @see recorder_pause() + * @see recorder_commit() + * @see recorder_cancel() + * @see recorder_set_audio_encoder() + * @see recorder_set_filename() + * @see recorder_set_file_format() + * @see recorder_recording_status_cb() + * @see recorder_set_filename() */ int recorder_start(recorder_h recorder); @@ -532,7 +532,7 @@ int recorder_start(recorder_h recorder); * @privlevel public * @privilege %http://tizen.org/privilege/recorder * @remarks Recording can be resumed with recorder_start(). - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -557,7 +557,7 @@ int recorder_pause(recorder_h recorder); * @remarks When you want to record audio or video file, you need to add privilege according to rules below additionally. \n * If you want to save contents to internal storage, you should add mediastorage privilege. \n * If you want to save contents to external storage, you should add externalstorage privilege. - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -571,7 +571,7 @@ int recorder_pause(recorder_h recorder); * @see recorder_pause() * @see recorder_cancel() * @see recorder_set_filename() - * @see recorder_start() + * @see recorder_start() */ int recorder_commit(recorder_h recorder); @@ -584,7 +584,7 @@ int recorder_commit(recorder_h recorder); * @remarks When you want to record audio or video file, you need to add privilege according to rules below additionally. \n * If you want to save contents to internal storage, you should add mediastorage privilege. \n * If you want to save contents to external storage, you should add externalstorage privilege. - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -638,8 +638,8 @@ int recorder_get_audio_level(recorder_h recorder, double *dB); * @details This function sets file path which defines where newly recorded data should be stored. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks If the same file already exists in the file system, then old file will be overwritten. - * @param[in] recorder The handle to the media recorder - * @param[in] path The recording file path + * @param[in] recorder The handle to the media recorder + * @param[in] path The recording file path * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -648,7 +648,7 @@ int recorder_get_audio_level(recorder_h recorder, double *dB); * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_get_filename() + * @see recorder_get_filename() */ int recorder_set_filename(recorder_h recorder, const char *path); @@ -656,15 +656,15 @@ int recorder_set_filename(recorder_h recorder, const char *path); * @brief Gets the file path to record. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif * @remarks You must release @a path using free(). - * @param[in] recorder The handle to the media recorder - * @param[out] path The recording file path + * @param[in] recorder The handle to the media recorder + * @param[out] path The recording file path * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_filename() + * @see recorder_set_filename() */ int recorder_get_filename(recorder_h recorder, char **path); @@ -695,7 +695,7 @@ int recorder_set_file_format(recorder_h recorder, recorder_file_format_e format) /** * @brief Gets the file format for recording media stream. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @param[out] format The media file format * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful @@ -714,8 +714,8 @@ int recorder_get_file_format(recorder_h recorder, recorder_file_format_e *format * @since_tizen 3.0 * @remarks You can set sound stream information including audio routing. * For more details, please refer to @ref CAPI_MEDIA_SOUND_MANAGER_MODULE - * @param[in] recorder The handle to the media recorder - * @param[in] stream_info The sound manager info + * @param[in] recorder The handle to the media recorder + * @param[in] stream_info The sound manager info * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -750,7 +750,7 @@ int recorder_set_sound_stream_info(recorder_h recorder, sound_stream_info_h stre * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post recorder_supported_file_format_cb() will be invoked. + * @post recorder_supported_file_format_cb() will be invoked. * @see recorder_get_file_format() * @see recorder_set_file_format() * @see recorder_supported_file_format_cb() @@ -785,7 +785,7 @@ int recorder_foreach_supported_file_format(recorder_h recorder, recorder_support * @retval #RECORDER_ERROR_INVALID_OPERATION Invalid operation (Since 2.3.1) * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_get_audio_encoder() + * @see recorder_get_audio_encoder() * @see recorder_foreach_supported_audio_encoder() */ int recorder_set_audio_encoder(recorder_h recorder, recorder_audio_codec_e codec); @@ -793,15 +793,15 @@ int recorder_set_audio_encoder(recorder_h recorder, recorder_audio_codec_e codec /** * @brief Gets the audio codec for encoding an audio stream. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] codec The audio codec + * @param[in] recorder The handle to the media recorder + * @param[out] codec The audio codec * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_audio_encoder() + * @see recorder_set_audio_encoder() * @see recorder_foreach_supported_audio_encoder() */ int recorder_get_audio_encoder(recorder_h recorder, recorder_audio_codec_e *codec); @@ -827,10 +827,10 @@ int recorder_get_audio_encoder(recorder_h recorder, recorder_audio_codec_e *code * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post recorder_supported_audio_encoder_cb() will be invoked. - * @see recorder_set_audio_encoder() - * @see recorder_get_audio_encoder() - * @see recorder_supported_audio_encoder_cb() + * @post recorder_supported_audio_encoder_cb() will be invoked. + * @see recorder_set_audio_encoder() + * @see recorder_get_audio_encoder() + * @see recorder_supported_audio_encoder_cb() */ int recorder_foreach_supported_audio_encoder(recorder_h recorder, recorder_supported_audio_encoder_cb callback, void *user_data); @@ -857,17 +857,17 @@ int recorder_foreach_supported_audio_encoder(recorder_h recorder, recorder_suppo * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_start() - * @see recorder_get_video_resolution() - * @see recorder_foreach_supported_video_resolution() + * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. + * @see recorder_start() + * @see recorder_get_video_resolution() + * @see recorder_foreach_supported_video_resolution() */ int recorder_set_video_resolution(recorder_h recorder, int width, int height); /** * @brief Gets the resolution of the video recording. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @param[out] width The video width * @param[out] height The video height * @return @c 0 on success, otherwise a negative error value @@ -876,8 +876,8 @@ int recorder_set_video_resolution(recorder_h recorder, int width, int height); * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_video_resolution() - * @see recorder_foreach_supported_video_resolution() + * @see recorder_set_video_resolution() + * @see recorder_foreach_supported_video_resolution() */ int recorder_get_video_resolution(recorder_h recorder, int *width, int *height); @@ -893,19 +893,19 @@ int recorder_get_video_resolution(recorder_h recorder, int *width, int *height); /** * @brief Retrieves all supported video resolutions by invoking callback function once for each supported video resolution. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[in] foreach_cb The callback function to be invoked - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to the media recorder + * @param[in] foreach_cb The callback function to be invoked + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post This function invokes recorder_supported_video_resolution_cb() repeatedly to retrieve each supported video resolution. - * @see recorder_set_video_resolution() - * @see recorder_get_video_resolution() - * @see recorder_supported_video_resolution_cb() + * @post This function invokes recorder_supported_video_resolution_cb() repeatedly to retrieve each supported video resolution. + * @see recorder_set_video_resolution() + * @see recorder_get_video_resolution() + * @see recorder_supported_video_resolution_cb() */ int recorder_foreach_supported_video_resolution(recorder_h recorder, recorder_supported_video_resolution_cb foreach_cb, void *user_data); @@ -940,8 +940,8 @@ int recorder_set_video_encoder(recorder_h recorder, recorder_video_codec_e codec /** * @brief Gets the video codec for encoding video stream. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] codec The video codec + * @param[in] recorder The handle to the media recorder + * @param[out] codec The video codec * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -974,10 +974,10 @@ int recorder_get_video_encoder(recorder_h recorder, recorder_video_codec_e *code * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post recorder_supported_video_encoder_cb() will be invoked. + * @post recorder_supported_video_encoder_cb() will be invoked. * @see recorder_set_video_encoder() * @see recorder_get_video_encoder() - * @see recorder_supported_video_encoder_cb() + * @see recorder_supported_video_encoder_cb() */ int recorder_foreach_supported_video_encoder(recorder_h recorder, recorder_supported_video_encoder_cb callback, void *user_data); @@ -1002,7 +1002,7 @@ int recorder_foreach_supported_video_encoder(recorder_h recorder, recorder_suppo * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post recorder_state_changed_cb() will be invoked. + * @post recorder_state_changed_cb() will be invoked. * @see recorder_unset_state_changed_cb() * @see recorder_state_changed_cb() */ @@ -1011,7 +1011,7 @@ int recorder_set_state_changed_cb(recorder_h recorder, recorder_state_changed_cb /** * @brief Unregisters the callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1034,47 +1034,47 @@ int recorder_unset_state_changed_cb(recorder_h recorder); * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_unset_interrupted_cb() - * @see recorder_interrupted_cb() + * @see recorder_unset_interrupted_cb() + * @see recorder_interrupted_cb() */ int recorder_set_interrupted_cb(recorder_h recorder, recorder_interrupted_cb callback, void *user_data); /** * @brief Unregisters the callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_interrupted_cb() + * @see recorder_set_interrupted_cb() */ int recorder_unset_interrupted_cb(recorder_h recorder); /** * @brief Registers a callback function to be called when the media recorder interrupt is started according to a policy. * @since_tizen 4.0 - * @param[in] recorder The handle to the media recorder - * @param[in] callback The callback function to register - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to the media recorder + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter - * @see recorder_unset_interrupt_started_cb() - * @see recorder_interrupt_started_cb() + * @see recorder_unset_interrupt_started_cb() + * @see recorder_interrupt_started_cb() */ int recorder_set_interrupt_started_cb(recorder_h recorder, recorder_interrupt_started_cb callback, void *user_data); /** * @brief Unregisters the callback function. * @since_tizen 4.0 - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter - * @see recorder_set_interrupt_started_cb() + * @see recorder_set_interrupt_started_cb() */ int recorder_unset_interrupt_started_cb(recorder_h recorder); @@ -1086,25 +1086,25 @@ int recorder_unset_interrupt_started_cb(recorder_h recorder); * @remarks The callback is called via internal thread of Frameworks. Therefore do not invoke UI API, recorder_unprepare(), recorder_commit() and recorder_cancel() in callback.\n * This callback function to be called in #RECORDER_STATE_RECORDING and #RECORDER_STATE_PAUSED state. * - * @param[in] recorder The handle to the recorder - * @param[in] callback The callback function to register - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to the recorder + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED. - * @see recorder_unset_audio_stream_cb() - * @see recorder_audio_stream_cb() + * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED. + * @see recorder_unset_audio_stream_cb() + * @see recorder_audio_stream_cb() */ int recorder_set_audio_stream_cb(recorder_h recorder, recorder_audio_stream_cb callback, void *user_data); /** * @brief Unregisters the callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1120,97 +1120,97 @@ int recorder_unset_audio_stream_cb(recorder_h recorder); * @since_tizen 4.0 * @remarks This callback receives the data that will be recorded, \n * but any changes to this data will not affect the recorded file. - * @param[in] recorder The handle to the recorder - * @param[in] callback The callback function to register - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to the recorder + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_INVALID_OPERATION Invalid operation * @retval #RECORDER_ERROR_INVALID_STATE Invalid state - * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED. - * @see recorder_unset_muxed_stream_cb() - * @see recorder_muxed_stream_cb() + * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED. + * @see recorder_unset_muxed_stream_cb() + * @see recorder_muxed_stream_cb() */ int recorder_set_muxed_stream_cb(recorder_h recorder, recorder_muxed_stream_cb callback, void *user_data); /** * @brief Unregisters the callback function. * @since_tizen 4.0 - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_INVALID_OPERATION Invalid operation * @retval #RECORDER_ERROR_INVALID_STATE Invalid state - * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED. - * @see recorder_set_muxed_stream_cb() + * @pre The recorder state should be #RECORDER_STATE_READY or #RECORDER_STATE_CREATED. + * @see recorder_set_muxed_stream_cb() */ int recorder_unset_muxed_stream_cb(recorder_h recorder); /** * @brief Registers a callback function to be invoked when the recording information changes. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[in] callback The function pointer of user callback - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to the media recorder + * @param[in] callback The function pointer of user callback + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post recorder_recording_status_cb() will be invoked. - * @see recorder_unset_recording_status_cb() - * @see recorder_recording_status_cb() + * @post recorder_recording_status_cb() will be invoked. + * @see recorder_unset_recording_status_cb() + * @see recorder_recording_status_cb() */ int recorder_set_recording_status_cb(recorder_h recorder, recorder_recording_status_cb callback, void *user_data); /** * @brief Unregisters the callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_recording_status_cb() + * @see recorder_set_recording_status_cb() */ int recorder_unset_recording_status_cb(recorder_h recorder); /** * @brief Registers the callback function to be run when reached the recording limit. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to media recorder - * @param[in] callback The function pointer of user callback - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to media recorder + * @param[in] callback The function pointer of user callback + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post recorder_recording_limit_reached_cb() will be invoked. - * @see recorder_unset_recording_limit_reached_cb() - * @see recorder_attr_set_size_limit() - * @see recorder_attr_set_time_limit() - * @see recorder_recording_limit_reached_cb() + * @post recorder_recording_limit_reached_cb() will be invoked. + * @see recorder_unset_recording_limit_reached_cb() + * @see recorder_attr_set_size_limit() + * @see recorder_attr_set_time_limit() + * @see recorder_recording_limit_reached_cb() */ int recorder_set_recording_limit_reached_cb(recorder_h recorder, recorder_recording_limit_reached_cb callback, void *user_data); /** * @brief Unregisters the callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder + * @param[in] recorder The handle to the media recorder * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_recording_limit_reached_cb() + * @see recorder_set_recording_limit_reached_cb() */ int recorder_unset_recording_limit_reached_cb(recorder_h recorder); @@ -1223,18 +1223,18 @@ int recorder_unset_recording_limit_reached_cb(recorder_h recorder); * #RECORDER_ERROR_DEVICE \n * #RECORDER_ERROR_INVALID_OPERATION \n * #RECORDER_ERROR_OUT_OF_MEMORY - * @param[in] recorder The handle to the recorder - * @param[in] callback The callback function to register - * @param[in] user_data The user data to be passed to the callback function + * @param[in] recorder The handle to the recorder + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @post This function will invoke recorder_error_cb() when an asynchronous operation error occur. - * @see recorder_unset_error_cb() - * @see recorder_error_cb() + * @post This function will invoke recorder_error_cb() when an asynchronous operation error occur. + * @see recorder_unset_error_cb() + * @see recorder_error_cb() */ int recorder_set_error_cb(recorder_h recorder, recorder_error_cb callback, void *user_data); @@ -1242,14 +1242,14 @@ int recorder_set_error_cb(recorder_h recorder, recorder_error_cb callback, void /** * @brief Unregisters the callback function. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the recorder + * @param[in] recorder The handle to the recorder * @return @c on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_set_error_cb() + * @see recorder_set_error_cb() */ int recorder_unset_error_cb(recorder_h recorder); @@ -1257,8 +1257,8 @@ int recorder_unset_error_cb(recorder_h recorder); /** * @brief Gets the state of recorder device. * @since_tizen 3.0 - * @param[in] type The recorder type - * @param[out] state The current state of the device + * @param[in] type The recorder type + * @param[out] state The current state of the device * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1270,9 +1270,9 @@ int recorder_get_device_state(recorder_type_e type, recorder_device_state_e *sta /** * @brief Registers a callback function to be called when the recorder device state changes. * @since_tizen 3.0 - * @param[in] callback The callback function to register - * @param[in] user_data The user data to be passed to the callback function - * @param[out] cb_id The id of the registered callback + * @param[in] callback The callback function to register + * @param[in] user_data The user data to be passed to the callback function + * @param[out] cb_id The id of the registered callback * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1323,8 +1323,8 @@ int recorder_remove_device_state_changed_cb(int cb_id); * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_attr_get_size_limit() - * @see recorder_attr_set_time_limit() + * @see recorder_attr_get_size_limit() + * @see recorder_attr_set_time_limit() */ int recorder_attr_set_size_limit(recorder_h recorder, int kbyte); @@ -1340,8 +1340,8 @@ int recorder_attr_set_size_limit(recorder_h recorder, int kbyte); * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_size_limit() - * @see recorder_attr_get_time_limit() + * @see recorder_attr_set_size_limit() + * @see recorder_attr_get_time_limit() */ int recorder_attr_get_size_limit(recorder_h recorder, int *kbyte); @@ -1360,8 +1360,8 @@ int recorder_attr_get_size_limit(recorder_h recorder, int *kbyte); * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_attr_get_time_limit() - * @see recorder_attr_set_size_limit() + * @see recorder_attr_get_time_limit() + * @see recorder_attr_set_size_limit() */ int recorder_attr_set_time_limit(recorder_h recorder, int second); @@ -1369,17 +1369,17 @@ int recorder_attr_set_time_limit(recorder_h recorder, int second); /** * @brief Gets the time limit of a recording file. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] second The time limit of the recording file (in seconds) \n - * @c 0 means unlimited recording time. + * @param[in] recorder The handle to the media recorder + * @param[out] second The time limit of the recording file (in seconds) \n + * @c 0 means unlimited recording time. * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_time_limit() - * @see recorder_attr_get_size_limit() + * @see recorder_attr_set_time_limit() + * @see recorder_attr_get_size_limit() */ int recorder_attr_get_time_limit(recorder_h recorder, int *second); @@ -1397,7 +1397,7 @@ int recorder_attr_get_time_limit(recorder_h recorder, int *second); * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY (for video recorder only).\n * Since 2.3.1, this API also works for audio recorder when its state is #RECORDER_STATE_READY. - * @see recorder_attr_get_audio_device() + * @see recorder_attr_get_audio_device() */ int recorder_attr_set_audio_device(recorder_h recorder, recorder_audio_device_e device); @@ -1412,15 +1412,15 @@ int recorder_attr_set_audio_device(recorder_h recorder, recorder_audio_device_e * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_audio_device() + * @see recorder_attr_set_audio_device() */ int recorder_attr_get_audio_device(recorder_h recorder, recorder_audio_device_e *device); /** * @brief Sets the sampling rate of an audio stream. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[in] samplerate The sample rate in Hertz + * @param[in] recorder The handle to the media recorder + * @param[in] samplerate The sample rate in Hertz * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1430,30 +1430,30 @@ int recorder_attr_get_audio_device(recorder_h recorder, recorder_audio_device_e * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY (for video recorder only).\n * Since 2.3.1, this API also works for audio recorder when its state is #RECORDER_STATE_READY. - * @see recorder_attr_get_audio_samplerate() + * @see recorder_attr_get_audio_samplerate() */ int recorder_attr_set_audio_samplerate(recorder_h recorder, int samplerate); /** * @brief Gets the sampling rate of an audio stream. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] samplerate The sample rate in Hertz + * @param[in] recorder The handle to the media recorder + * @param[out] samplerate The sample rate in Hertz * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_audio_samplerate() + * @see recorder_attr_set_audio_samplerate() */ int recorder_attr_get_audio_samplerate(recorder_h recorder, int *samplerate); /** * @brief Sets the bitrate of an audio encoder. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[in] bitrate The bitrate (for mms : 12200[bps], normal : 288000[bps]) + * @param[in] recorder The handle to the media recorder + * @param[in] bitrate The bitrate (for mms : 12200[bps], normal : 288000[bps]) * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1462,15 +1462,15 @@ int recorder_attr_get_audio_samplerate(recorder_h recorder, int *samplerate); * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_attr_get_audio_encoder_bitrate() + * @see recorder_attr_get_audio_encoder_bitrate() */ int recorder_attr_set_audio_encoder_bitrate(recorder_h recorder, int bitrate); /** * @brief Sets the bitrate of a video encoder. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[in] bitrate The bitrate in bits per second + * @param[in] recorder The handle to the media recorder + * @param[in] bitrate The bitrate in bits per second * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1479,52 +1479,52 @@ int recorder_attr_set_audio_encoder_bitrate(recorder_h recorder, int bitrate); * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_attr_get_video_encoder_bitrate() + * @see recorder_attr_get_video_encoder_bitrate() */ int recorder_attr_set_video_encoder_bitrate(recorder_h recorder, int bitrate); /** * @brief Gets the bitrate of an audio encoder. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] bitrate The bitrate in bits per second + * @param[in] recorder The handle to the media recorder + * @param[out] bitrate The bitrate in bits per second * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_audio_encoder_bitrate() + * @see recorder_attr_set_audio_encoder_bitrate() */ int recorder_attr_get_audio_encoder_bitrate(recorder_h recorder, int *bitrate); /** * @brief Gets the bitrate of a video encoder. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] bitrate The bitrate in bits per second + * @param[in] recorder The handle to the media recorder + * @param[out] bitrate The bitrate in bits per second * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_audio_encoder_bitrate() + * @see recorder_attr_set_audio_encoder_bitrate() */ int recorder_attr_get_video_encoder_bitrate(recorder_h recorder, int *bitrate); /** * @brief Sets the mute state of a recorder. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[in] enable The mute state + * @param[in] recorder The handle to the media recorder + * @param[in] enable The mute state * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_is_muted() + * @see recorder_attr_is_muted() */ int recorder_attr_set_mute(recorder_h recorder, bool enable); @@ -1539,7 +1539,7 @@ int recorder_attr_set_mute(recorder_h recorder, bool enable); * @exception #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @exception #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @exception #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported - * @see recorder_attr_set_mute() + * @see recorder_attr_set_mute() */ bool recorder_attr_is_muted(recorder_h recorder); @@ -1562,7 +1562,7 @@ bool recorder_attr_is_muted(recorder_h recorder); * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY. - * @see recorder_attr_get_recording_motion_rate() + * @see recorder_attr_get_recording_motion_rate() */ int recorder_attr_set_recording_motion_rate(recorder_h recorder , double rate); @@ -1583,7 +1583,7 @@ int recorder_attr_set_recording_motion_rate(recorder_h recorder , double rate); * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_recording_motion_rate() + * @see recorder_attr_set_recording_motion_rate() */ int recorder_attr_get_recording_motion_rate(recorder_h recorder , double *rate); @@ -1593,8 +1593,8 @@ int recorder_attr_get_recording_motion_rate(recorder_h recorder , double *rate); * @remarks This attribute is applied only in RECORDER_STATE_CREATED state. \n * For mono recording, setting channel to @c 1. \n * For stereo recording, setting channel to @c 2. - * @param[in] recorder The handle to the media recorder - * @param[in] channel_count The number of the audio channel + * @param[in] recorder The handle to the media recorder + * @param[in] channel_count The number of the audio channel * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter @@ -1604,22 +1604,22 @@ int recorder_attr_get_recording_motion_rate(recorder_h recorder , double *rate); * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected * @pre The recorder state must be #RECORDER_STATE_CREATED or #RECORDER_STATE_READY (for video recorder only).\n * Since 2.3.1, this API also works for audio recorder when its state is #RECORDER_STATE_READY. - * @see recorder_attr_get_audio_channel() + * @see recorder_attr_get_audio_channel() */ int recorder_attr_set_audio_channel(recorder_h recorder, int channel_count); /** * @brief Gets the number of the audio channel. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to the media recorder - * @param[out] channel_count The number of the audio channel + * @param[in] recorder The handle to the media recorder + * @param[out] channel_count The number of the audio channel * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_audio_channel() + * @see recorder_attr_set_audio_channel() */ int recorder_attr_get_audio_channel(recorder_h recorder, int *channel_count); @@ -1627,30 +1627,30 @@ int recorder_attr_get_audio_channel(recorder_h recorder, int *channel_count); /** * @brief Sets the video orientation in a video metadata tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to a media recorder - * @param[in] orientation The information of the video orientation + * @param[in] recorder The handle to a media recorder + * @param[in] orientation The information of the video orientation * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_get_orientation_tag() + * @see recorder_attr_get_orientation_tag() */ int recorder_attr_set_orientation_tag(recorder_h recorder, recorder_rotation_e orientation); /** * @brief Gets the video orientation in a video metadata tag. * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif - * @param[in] recorder The handle to a media recorder - * @param[out] orientation The information of the video orientation + * @param[in] recorder The handle to a media recorder + * @param[out] orientation The information of the video orientation * @return @c 0 on success, otherwise a negative error value * @retval #RECORDER_ERROR_NONE Successful * @retval #RECORDER_ERROR_INVALID_PARAMETER Invalid parameter * @retval #RECORDER_ERROR_PERMISSION_DENIED The access to the resources can not be granted * @retval #RECORDER_ERROR_NOT_SUPPORTED The feature is not supported * @retval #RECORDER_ERROR_SERVICE_DISCONNECTED The socket to multimedia server is disconnected - * @see recorder_attr_set_orientation_tag() + * @see recorder_attr_set_orientation_tag() */ int recorder_attr_get_orientation_tag(recorder_h recorder, recorder_rotation_e *orientation); diff --git a/packaging/capi-media-recorder.spec b/packaging/capi-media-recorder.spec index 6a3b9f5..9f5c439 100644 --- a/packaging/capi-media-recorder.spec +++ b/packaging/capi-media-recorder.spec @@ -1,6 +1,6 @@ Name: capi-media-recorder Summary: A Recorder API -Version: 0.3.20 +Version: 0.3.21 Release: 0 Group: Multimedia/API License: Apache-2.0 -- 2.7.4