Merge branch 'upstream/1.16' into tizen_gst_1.16.2
[platform/upstream/gstreamer.git] / gst / gstutils.h
index dbb2e66..bf80996 100644 (file)
 
 G_BEGIN_DECLS
 
+GST_API
 void            gst_util_set_value_from_string  (GValue *value, const gchar *value_str);
+
+GST_API
 void            gst_util_set_object_arg         (GObject *object, const gchar *name, const gchar *value);
+
+GST_API
 gboolean        gst_util_set_object_array       (GObject * object, const gchar * name,
                                                  const GValueArray * array);
+GST_API
 gboolean        gst_util_get_object_array       (GObject * object, const gchar * name,
                                                  GValueArray ** array);
+GST_API
 void            gst_util_dump_mem               (const guchar *mem, guint size);
 
+GST_API
+void            gst_util_dump_buffer            (GstBuffer * buf);
+
+GST_API
 guint64         gst_util_gdouble_to_guint64     (gdouble value)  G_GNUC_CONST;
+
+GST_API
 gdouble         gst_util_guint64_to_gdouble     (guint64 value)  G_GNUC_CONST;
 
 /**
@@ -68,12 +81,22 @@ gdouble         gst_util_guint64_to_gdouble     (guint64 value)  G_GNUC_CONST;
 #define         gst_guint64_to_gdouble(value)   ((gdouble) (value))
 #endif
 
+GST_API
 guint64         gst_util_uint64_scale           (guint64 val, guint64 num, guint64 denom);
+
+GST_API
 guint64         gst_util_uint64_scale_round     (guint64 val, guint64 num, guint64 denom);
+
+GST_API
 guint64         gst_util_uint64_scale_ceil      (guint64 val, guint64 num, guint64 denom);
 
+GST_API
 guint64         gst_util_uint64_scale_int       (guint64 val, gint num, gint denom);
+
+GST_API
 guint64         gst_util_uint64_scale_int_round (guint64 val, gint num, gint denom);
+
+GST_API
 guint64         gst_util_uint64_scale_int_ceil  (guint64 val, gint num, gint denom);
 
 /**
@@ -87,7 +110,11 @@ guint64         gst_util_uint64_scale_int_ceil  (guint64 val, gint num, gint den
  * Since: 1.14
  */
 #define GST_SEQNUM_INVALID (0)
+
+GST_API
 guint32         gst_util_seqnum_next            (void);
+
+GST_API
 gint32          gst_util_seqnum_compare         (guint32 s1, guint32 s2);
 
 /**
@@ -102,6 +129,7 @@ gint32          gst_util_seqnum_compare         (guint32 s1, guint32 s2);
  */
 #define GST_GROUP_ID_INVALID (0)
 
+GST_API
 guint           gst_util_group_id_next          (void);
 
 /**
@@ -942,56 +970,90 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num)
 #define GST_ROUND_DOWN_N(num,align) (((num) & ~((align) - 1)))
 
 
+GST_API
 void                    gst_object_default_error        (GstObject    * source,
                                                          const GError * error,
                                                          const gchar  * debug);
 
 /* element functions */
+
+GST_API
 void                    gst_element_create_all_pads     (GstElement *element);
+
+GST_API
 GstPad*                 gst_element_get_compatible_pad  (GstElement *element, GstPad *pad,
                                                          GstCaps *caps);
-
+GST_API
 GstPadTemplate*         gst_element_get_compatible_pad_template (GstElement *element, GstPadTemplate *compattempl);
 
+GST_API
 const gchar*            gst_element_state_get_name      (GstState state);
+
+GST_API
 const gchar *           gst_element_state_change_return_get_name (GstStateChangeReturn state_ret);
 
+GST_API
+const gchar *           gst_state_change_get_name       (GstStateChange transition);
+
+GST_API
 gboolean                gst_element_link                (GstElement *src, GstElement *dest);
+
+GST_API
 gboolean                gst_element_link_many           (GstElement *element_1,
                                                          GstElement *element_2, ...) G_GNUC_NULL_TERMINATED;
+GST_API
 gboolean                gst_element_link_filtered       (GstElement * src,
                                                          GstElement * dest,
                                                          GstCaps *filter);
+GST_API
 void                    gst_element_unlink              (GstElement *src, GstElement *dest);
+
+GST_API
 void                    gst_element_unlink_many         (GstElement *element_1,
                                                          GstElement *element_2, ...) G_GNUC_NULL_TERMINATED;
-
+GST_API
 gboolean                gst_element_link_pads           (GstElement *src, const gchar *srcpadname,
                                                          GstElement *dest, const gchar *destpadname);
+GST_API
 gboolean                gst_element_link_pads_full      (GstElement *src, const gchar *srcpadname,
                                                          GstElement *dest, const gchar *destpadname,
                                                          GstPadLinkCheck flags);
+GST_API
 void                    gst_element_unlink_pads         (GstElement *src, const gchar *srcpadname,
                                                          GstElement *dest, const gchar *destpadname);
-
+GST_API
 gboolean                gst_element_link_pads_filtered  (GstElement * src, const gchar * srcpadname,
                                                          GstElement * dest, const gchar * destpadname,
                                                          GstCaps *filter);
-
+GST_API
 gboolean                gst_element_seek_simple         (GstElement   *element,
                                                          GstFormat     format,
                                                          GstSeekFlags  seek_flags,
                                                          gint64        seek_pos);
 
 /* util elementfactory functions */
+
+GST_API
 gboolean gst_element_factory_can_sink_all_caps (GstElementFactory *factory, const GstCaps *caps);
+
+GST_API
 gboolean gst_element_factory_can_src_all_caps  (GstElementFactory *factory, const GstCaps *caps);
+
+GST_API
 gboolean gst_element_factory_can_sink_any_caps (GstElementFactory *factory, const GstCaps *caps);
+
+GST_API
 gboolean gst_element_factory_can_src_any_caps  (GstElementFactory *factory, const GstCaps *caps);
 
 /* util query functions */
+
+GST_API
 gboolean                gst_element_query_position      (GstElement *element, GstFormat format, gint64 *cur);
+
+GST_API
 gboolean                gst_element_query_duration      (GstElement *element, GstFormat format, gint64 *duration);
+
+GST_API
 gboolean                gst_element_query_convert       (GstElement *element, GstFormat src_format, gint64 src_val,
                                                          GstFormat dest_format, gint64 *dest_val);
 #ifdef TIZEN_PROFILE_TV
@@ -1000,58 +1062,100 @@ gboolean                gst_element_query_resource      (GstElement *element, GL
 
 
 /* pad functions */
+
+GST_API
 void                    gst_pad_use_fixed_caps          (GstPad *pad);
+
+GST_API
 GstElement*             gst_pad_get_parent_element      (GstPad *pad);
 
 /* util query functions */
+
+GST_API
 gboolean                gst_pad_proxy_query_accept_caps (GstPad *pad, GstQuery *query);
+
+GST_API
 gboolean                gst_pad_proxy_query_caps        (GstPad *pad, GstQuery *query);
 
+GST_API
 gboolean                gst_pad_query_position          (GstPad *pad, GstFormat format, gint64 *cur);
+
+GST_API
 gboolean                gst_pad_query_duration          (GstPad *pad, GstFormat format, gint64 *duration);
+
+GST_API
 gboolean                gst_pad_query_convert           (GstPad *pad, GstFormat src_format, gint64 src_val,
                                                          GstFormat dest_format, gint64 *dest_val);
+GST_API
 GstCaps *               gst_pad_query_caps              (GstPad *pad, GstCaps *filter);
+
+GST_API
 gboolean                gst_pad_query_accept_caps       (GstPad *pad, GstCaps *caps);
 
+GST_API
 gboolean                gst_pad_link_maybe_ghosting      (GstPad            *src,
                                                           GstPad            *sink);
+GST_API
 gboolean                gst_pad_link_maybe_ghosting_full (GstPad            *src,
                                                           GstPad            *sink,
                                                           GstPadLinkCheck   flags);
-
+GST_API
 gboolean                gst_pad_peer_query_position     (GstPad *pad, GstFormat format, gint64 *cur);
+
+GST_API
 gboolean                gst_pad_peer_query_duration     (GstPad *pad, GstFormat format, gint64 *duration);
+
+GST_API
 gboolean                gst_pad_peer_query_convert      (GstPad *pad, GstFormat src_format, gint64 src_val,
                                                          GstFormat dest_format, gint64 *dest_val);
+GST_API
 GstCaps *               gst_pad_peer_query_caps         (GstPad * pad, GstCaps *filter);
+
+GST_API
 gboolean                gst_pad_peer_query_accept_caps  (GstPad * pad, GstCaps *caps);
 
+GST_API
 gchar *                 gst_pad_create_stream_id               (GstPad * pad, GstElement * parent, const gchar *stream_id) G_GNUC_MALLOC;
+
+GST_API
 gchar *                 gst_pad_create_stream_id_printf        (GstPad * pad, GstElement * parent, const gchar *stream_id, ...) G_GNUC_PRINTF (3, 4) G_GNUC_MALLOC;
+
+GST_API
 gchar *                 gst_pad_create_stream_id_printf_valist (GstPad * pad, GstElement * parent, const gchar *stream_id, va_list var_args) G_GNUC_PRINTF (3, 0) G_GNUC_MALLOC;
 
+GST_API
 gchar *                 gst_pad_get_stream_id           (GstPad * pad);
+
+GST_API
 GstStream *             gst_pad_get_stream              (GstPad * pad);
 
 /* bin functions */
+
+GST_API
 void                    gst_bin_add_many                (GstBin *bin, GstElement *element_1, ...) G_GNUC_NULL_TERMINATED;
+
+GST_API
 void                    gst_bin_remove_many             (GstBin *bin, GstElement *element_1, ...) G_GNUC_NULL_TERMINATED;
+
+GST_API
 GstPad *                gst_bin_find_unlinked_pad       (GstBin *bin, GstPadDirection direction);
 
+GST_API
 gboolean                gst_bin_sync_children_states    (GstBin *bin);
 
 /* parse utility functions */
+
+GST_API
 GstElement *            gst_parse_bin_from_description      (const gchar     * bin_description,
                                                              gboolean          ghost_unlinked_pads,
                                                              GError         ** err);
-
+GST_API
 GstElement *            gst_parse_bin_from_description_full (const gchar     * bin_description,
                                                              gboolean          ghost_unlinked_pads,
                                                              GstParseContext * context,
                                                              GstParseFlags     flags,
                                                              GError         ** err);
-
+GST_API
 GstClockTime            gst_util_get_timestamp          (void);
 
 /**
@@ -1068,24 +1172,36 @@ typedef enum {
   GST_SEARCH_MODE_AFTER
 } GstSearchMode;
 
+GST_API
 gpointer      gst_util_array_binary_search      (gpointer array, guint num_elements,
                                                  gsize element_size, GCompareDataFunc search_func,
                                                  GstSearchMode mode, gconstpointer search_data,
                                                  gpointer user_data);
 
 /* fraction operations */
+
+GST_API
 gint          gst_util_greatest_common_divisor  (gint a, gint b);
+
+GST_API
 gint64        gst_util_greatest_common_divisor_int64 (gint64 a, gint64 b);
 
+GST_API
 void          gst_util_fraction_to_double       (gint src_n, gint src_d, gdouble *dest);
+
+GST_API
 void          gst_util_double_to_fraction       (gdouble src, gint *dest_n, gint *dest_d);
 
+GST_API
 gboolean      gst_util_fraction_multiply        (gint a_n, gint a_d, gint b_n, gint b_d,
                                                  gint *res_n, gint *res_d);
+GST_API
 gboolean      gst_util_fraction_add             (gint a_n, gint a_d, gint b_n, gint b_d,
                                                  gint *res_n, gint *res_d);
+GST_API
 gint          gst_util_fraction_compare         (gint a_n, gint a_d, gint b_n, gint b_d);
 
+GST_API
 gboolean      gst_calculate_linear_regression   (const GstClockTime * xy,
                                                  GstClockTime * temp, guint n,
                                                  GstClockTime * m_num, GstClockTime * m_denom,