*
* Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
*
- * Contact: JongHyuk Choi <jhchoi.choi@samsung.com>, YeJin Cho <cho.yejin@samsung.com>, YoungHwan An <younghwan_.an@samsung.com>
+ * Contact: JongHyuk Choi <jhchoi.choi@samsung.com>, YeJin Cho <cho.yejin@samsung.com>,
+ * Seungbae Shin <seungbae.shin@samsung.com>, YoungHwan An <younghwan_.an@samsung.com>
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
extern "C" {
#endif
-/**
- @addtogroup PLAYER-INTERNAL
- @{
-
- @par
- <div><table>
- <tr>
- <td>PROPERTY</td>
- <td>TYPE</td>
- <td>VALID TYPE</td>
- <td>DEFAULT VALUE</td>
- </tr>
- <tr>
- <td>"display_roi_x"</td>
- <td>int</td>
- <td>range</td>
- <td>0</td>
- </tr>
- <tr>
- <td>"display_roi_y"</td>
- <td>int</td>
- <td>range</td>
- <td>0</td>
- </tr>
- <tr>
- <td>"display_roi_width"</td>
- <td>int</td>
- <td>range</td>
- <td>640</td>
- </tr>
- <tr>
- <td>"display_roi_height"</td>
- <td>int</td>
- <td>range</td>
- <td>480</td>
- </tr>
- <tr>
- <td>"display_method"</td>
- <td>int</td>
- <td>range</td>
- <td>MM_DISPLAY_METHOD_LETTER_BOX</td>
- </tr>
- <tr>
- <td>"sound_volume_type"</td>
- <td>int</td>
- <td>range</td>
- <td>MM_SOUND_VOLUME_TYPE_CALL</td>
- </tr>
- <tr>
- <td>"sound_route"</td>
- <td>int</td>
- <td>range</td>
- <td>MM_AUDIOROUTE_USE_EXTERNAL_SETTING</td>
- </tr>
- <tr>
- <td>"sound_stop_when_unplugged"</td>
- <td>int</td>
- <td>range</td>
- </tr>
- </table></div>
-
-*/
-
/*
* Enumerations of video colorspace
*/
typedef enum {
- MM_PLAYER_COLORSPACE_I420 = 0, /**< I420 format - planer */
- MM_PLAYER_COLORSPACE_RGB888, /**< RGB888 pixel format */
- MM_PLAYER_COLORSPACE_NV12_TILED, /**< Customized color format in s5pc110 */
-}MMPlayerVideoColorspace;
-
-typedef struct
-{
+ MM_PLAYER_COLORSPACE_I420 = 0, /**< I420 format - planer */
+ MM_PLAYER_COLORSPACE_RGB888, /**< RGB888 pixel format */
+ MM_PLAYER_COLORSPACE_NV12_TILED, /**< Customized color format */
+ MM_PLAYER_COLORSPACE_NV12,
+ MM_PLAYER_COLORSPACE_BGRx, /**< BGRx pixel format */
+ MM_PLAYER_COLORSPACE_MAX = 0x7FFFFFFF
+} mmplayer_video_color_space_e;
+
+typedef struct {
unsigned char *data; /* capture image buffer */
int size; /* capture image size */
- MMPlayerVideoColorspace fmt; /* color space type */
-} MMPlayerVideoCapture;
-
-/**
- * Buffer need data callback function type.
- *
- * @param size [in] size required for the buffer playback
- * @param user_param [in] User defined parameter which is passed when set
- * to need data callback
- *
- * @return This callback function have to return MM_ERROR_NONE.
- */
-typedef bool (*mm_player_buffer_need_data_callback) (unsigned int size, void *user_param);
+ mmplayer_video_color_space_e fmt; /* color space type */
+ unsigned int width; /* width of captured image */
+ unsigned int height; /* height of captured image */
+ unsigned int orientation; /* content orientation */
+} mmplayer_video_capture_t;
-/**
- * Buffer enough data callback function type.
- *
- * @param user_param [in] User defined parameter which is passed when set
- * to enough data callback
- *
- * @return This callback function have to return MM_ERROR_NONE.
- */
-typedef bool (*mm_player_buffer_enough_data_callback) (void *user_param);
+typedef struct {
+ void *data;
+ int data_size;
+ int channel;
+ int bitrate;
+ int depth;
+ bool is_little_endian;
+ guint64 channel_mask;
+} mmplayer_audio_decoded_data_info_t;
/**
- * Buffer seek data callback function type.
- *
- * @param offset [in] offset for the buffer playback
- * @param user_param [in] User defined parameter which is passed when set
- * to seek data callback
- *
- * @return This callback function have to return MM_ERROR_NONE.
- */
-typedef bool (*mm_player_buffer_seek_data_callback) (unsigned long long offset, void *user_param);
-
-/**
- * Video stream callback function type.
+ * Video decoded callback function type.
*
* @param stream [in] Reference pointer to video frame data
* @param stream_size [in] Size of video frame data
* @param user_param [in] User defined parameter which is passed when set
* video stream callback
* @param width [in] width of video frame
- * @param height [in] height of video frame
+ * @param height [in] height of video frame
*
* @return This callback function have to return MM_ERROR_NONE.
*/
-typedef bool (*mm_player_video_stream_callback) (void *stream, int stream_size, void *user_param, int width, int height);
+typedef bool (*mm_player_video_decoded_callback)(void *stream, void *user_param);
/**
* Audio stream callback function type.
*
* @return This callback function have to return MM_ERROR_NONE.
*/
-typedef bool (*mm_player_video_capture_callback) (void *stream, int stream_size, void *user_param);
+typedef bool (*mm_player_video_capture_callback)(void *stream, int stream_size, void *user_param);
/**
* Video frame render error callback function type.
*
* @return This callback function have to return MM_ERROR_NONE.
*/
-typedef bool (*mm_player_video_frame_render_error_callback) (void *error_id, void *user_param);
+typedef bool (*mm_player_video_frame_render_error_callback)(void *error_id, void *user_param);
/**
+ * Audio stream callback function type.
+ *
+ * @param stream [in] Reference pointer to audio frame data
+ * @param user_param [in] User defined parameter which is passed when set
+ * audio stream callback
+ *
+ * @return This callback function have to return MM_ERROR_NONE.
+ */
+typedef bool (*mm_player_audio_decoded_callback)(mmplayer_audio_decoded_data_info_t *stream, void *user_param);
+/**
* This function is to set play speed for playback.
*
* @param player [in] Handle of player.
* @param ratio [in] Speed for playback.
- *
+ * @param streaming [in] If @c true, rate value can be set even if it is streaming playback.
* @return This function returns zero on success, or negative value with error
* code
- * @remark The current supported range is from -64x to 64x.
- * But, the quailty is dependent on codec performance.
- * And, the sound is muted under normal speed and more than double speed.
+ * @remark The current supported range is from -64x to 64x.
+ * But, the quailty is dependent on codec performance.
+ * And, the sound is muted under normal speed and more than double speed.
* @see
* @since
*/
-int mm_player_set_play_speed(MMHandleType player, float rate);
+int mm_player_set_play_speed(MMHandleType player, float rate, bool streaming);
/**
* This function set callback function for receiving video stream from player.
* @return This function returns zero on success, or negative value with error
* code.
* @remark
- * @see mm_player_video_stream_callback mm_player_set_audio_stream_callback
* @since
*/
-int mm_player_set_video_stream_callback(MMHandleType player, mm_player_video_stream_callback callback, void *user_param);
-
-/**
- * This function set callback function for rendering error information of video render plug-in.
- *
- * @param player [in] Handle of player.
- * @param callback [in] Frame render error callback function.
- * @param user_param [in] User parameter which is passed to callback function.
- *
- * @return This function returns zero on success, or negative value with error code.
- * @see
- * @remark None
- * @par Example
- * @code
- * @endcode
- */
-int mm_player_set_video_frame_render_error_callback(MMHandleType player, mm_player_video_frame_render_error_callback callback, void *user_param);
+int mm_player_set_video_decoded_callback(MMHandleType player, mm_player_video_decoded_callback callback, void *user_param);
/**
* This function set callback function for receiving audio stream from player.
*
- * @param player [in] Handle of player.
- * @param callback [in] Audio buffer callback function.
- * @param user_param [in] User parameter.
- *
- * @return This function returns zero on success, or negative value with error
- * code.
- * @remark It can be used for audio playback only.
- * @see mm_player_audio_stream_callback
- * @since
- */
-int mm_player_set_audio_buffer_callback(MMHandleType player, mm_player_audio_stream_callback callback, void *user_param);
-
-/**
- * This function is to capture video frame.
- *
- * @param player [in] Handle of player.
- *
- * @return This function returns zero on success, or negative value with error
- * code.
- *
- * @remark Captured buffer is sent asynchronously through message callback with MM_MESSAGE_VIDEO_CAPTURED.
- * And, application should free the captured buffer directly.
- * @see MM_MESSAGE_VIDEO_CAPTURED
- * @since
- */
-int mm_player_do_video_capture(MMHandleType player);
-
-/**
- * This function set callback function for receiving need data message from player.
- *
* @param player [in] Handle of player.
- * @param callback [in] Need data callback function.
+ * @param opt [in] audio extract option.
+ * @param callback [in] audio stream callback function.
* @param user_param [in] User parameter.
*
* @return This function returns zero on success, or negative value with error
* code.
* @remark
- * @see mm_player_set_buffer_enough_data_callback
+ * @see mm_player_audio_decoded_callback
* @since
*/
-int mm_player_set_buffer_need_data_callback(MMHandleType player, mm_player_buffer_need_data_callback callback , void *user_param);
+int mm_player_set_audio_decoded_callback(MMHandleType player, mmplayer_audio_extract_opt_e opt, mm_player_audio_decoded_callback callback, void *user_param);
/**
- * This function set callback function for receiving enough data message from player.
+ * This function is to capture video frame.
*
* @param player [in] Handle of player.
- * @param callback [in] Enough data callback function.
- * @param user_param [in] User parameter.
*
* @return This function returns zero on success, or negative value with error
* code.
- * @remark
- * @see mm_player_set_buffer_need_data_callback
- * @since
- */
-int mm_player_set_buffer_enough_data_callback(MMHandleType player, mm_player_buffer_enough_data_callback callback, void *user_param);
-
-/**
- * This function set callback function for receiving seek data message from player.
*
- * @param player [in] Handle of player.
- * @param callback [in] Seek data callback function.
- * @param user_param [in] User parameter.
- *
- * @return This function returns zero on success, or negative value with error
- * code.
- * @remark
- * @see
- * @since
- */
-int mm_player_set_buffer_seek_data_callback(MMHandleType player, mm_player_buffer_seek_data_callback callback, void *user_param);
-
-/**
- * This function set callback function for putting data into player.
- *
- * @param player [in] Handle of player.
- * @param buf [in] data to push into player
- * @param size [in] buffer size to push
- *
- * @return This function returns zero on success, or negative value with error
- * code.
- * @remark
- * @see
+ * @remark Captured buffer is sent asynchronously through message callback with MM_MESSAGE_VIDEO_CAPTURED.
+ * And, application should free the captured buffer directly.
+ * @see MM_MESSAGE_VIDEO_CAPTURED
* @since
*/
-int mm_player_push_buffer(MMHandleType player, unsigned char *buf, int size);
+int mm_player_do_video_capture(MMHandleType player);
/**
* This function changes the previous videosink plugin for a new one
*
* @return This function returns zero on success, or negative value with error
* code.
- * @remark Not supported
+ * @remark
* @see
* @since
*/
projects / platform / core / multimedia / libmm-player.git / blobdiff