* @remarks You must release @a metadata using metadata_extractor_destroy().
*
* @param[in] metadata The handle to metadata
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OUT_OF_MEMORY Not enough memory is available
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @see metadata_extractor_destroy()
*/
int metadata_extractor_create(metadata_extractor_h *metadata);
/**
* @brief Sets the file path to extract.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ *
* @param [in] metadata The handle to metadata
* @param [in] path The path to extract metadata
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_FILE_EXISTS File does not exist
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Create a metadata handle by calling metadata_extractor_create().
* @see metadata_extractor_create()
* @see metadata_extractor_destroy()
/**
* @brief Sets the buffer to extract.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ *
* @param [in] metadata The handle to metadata
* @param [in] buffer The buffer to extract metadata
* @param [in] size The buffer size
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Create a metadata handle by calling metadata_extractor_create().
* @see metadata_extractor_create()
* @see metadata_extractor_destroy()
/**
* @brief Destroys metadata.
* @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ *
* @param [in] metadata The handle to metadata
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Create a metadata handle by calling metadata_extractor_create().
* @see metadata_extractor_create()
*/
* @param[in] metadata The handle to metadata
* @param[in] attribute The key attribute name to get
* @param[out] value The value of the attribute
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OUT_OF_MEMORY Not enough memory is available
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Set the path to extract by calling metadata_extractor_set_path().
* @see metadata_extractor_create()
* @see metadata_extractor_destroy()
* @param[out] artwork The encoded artwork image
* @param[out] size The encoded artwork size
* @param[out] mime_type The mime type of artwork
- * @return @c 0 on success,
- * otherwise a negative error value
+ * @return @c 0 on success, otherwise a negative error value
+ *
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OUT_OF_MEMORY Not enough memory is available
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Set the path to extract by calling metadata_extractor_set_path().
* @see metadata_extractor_create()
* @see metadata_extractor_destroy()
* @param[in] metadata The handle to metadata
* @param[out] frame The raw frame data in RGB888
* @param[out] size The frame data size
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OUT_OF_MEMORY Not enough memory is available
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Set the path to extract by calling metadata_extractor_set_path().
* @see metadata_extractor_create()
* @see metadata_extractor_destroy()
* @param[in] index The index of time/lyrics to set
* @param[out] time_stamp The time information of the index
* @param[out] lyrics The lyrics of the index
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Set the path to extract by calling metadata_extractor_set_path().
* @pre Get the time/lyrics set number by calling metadata_extractor_get_metadata(METADATA_SYNCLYRICS_NUM).
* @see metadata_extractor_create()
* otherwise @c false if the user can only get the nearest i-frame of the video rapidly
* @param[out] frame The raw frame data in RGB888
* @param[out] size The frame data size
- * @return @c 0 on success,
- * otherwise a negative error value
+ *
+ * @return @c 0 on success, otherwise a negative error value
* @retval #METADATA_EXTRACTOR_ERROR_NONE Successful
* @retval #METADATA_EXTRACTOR_ERROR_INVALID_PARAMETER Invalid parameter
* @retval #METADATA_EXTRACTOR_ERROR_OUT_OF_MEMORY Not enough memory is available
* @retval #METADATA_EXTRACTOR_ERROR_OPERATION_FAILED Internal operation failed
* @retval #METADATA_EXTRACTOR_ERROR_PERMISSION_DENIED Permission denied
+ *
* @pre Set the path to extract by calling metadata_extractor_set_path().
* @see metadata_extractor_create()
* @see metadata_extractor_destroy()