X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gst%2Fgstutils.h;h=2c89c288c548c2275a09e4f753dea086f7f1a742;hb=ce4698487e2650ee9b365d6cf41a254483349bc0;hp=7bdc35038fb9d33cb63e5c18f3fd173d74c7c28f;hpb=f746174c1063b7200fb71d7e2fd76974897f066b;p=platform%2Fupstream%2Fgstreamer.git diff --git a/gst/gstutils.h b/gst/gstutils.h index 7bdc350..2c89c28 100644 --- a/gst/gstutils.h +++ b/gst/gstutils.h @@ -17,8 +17,8 @@ * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the - * Free Software Foundation, Inc., 59 Temple Place - Suite 330, - * Boston, MA 02111-1307, USA. + * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, + * Boston, MA 02110-1301, USA. */ @@ -26,16 +26,34 @@ #define __GST_UTILS_H__ #include +#include #include #include 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; /** @@ -63,20 +81,56 @@ 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); +/** + * GST_SEQNUM_INVALID: + * + * A value which is guaranteed to never be returned by + * gst_util_seqnum_next(). + * + * Can be used as a default value in variables used to store seqnum. + * + * 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); -void gst_print_pad_caps (GString *buf, gint indent, GstPad *pad); -void gst_print_element_args (GString *buf, gint indent, GstElement *element); +/** + * GST_GROUP_ID_INVALID: + * + * A value which is guaranteed to never be returned by + * gst_util_group_id_next(). + * + * Can be used as a default value in variables used to store group_id. + * + * Since: 1.14 + */ +#define GST_GROUP_ID_INVALID (0) +GST_API +guint gst_util_group_id_next (void); /** * GST_CALL_PARENT: @@ -114,20 +168,59 @@ void gst_print_element_args (GString *buf, gint indent, GstE #define _GST_PUT(__data, __idx, __size, __shift, __num) \ (((guint8 *) (__data))[__idx] = (((guint##__size) (__num)) >> (__shift)) & 0xff) +#ifndef __GTK_DOC_IGNORE__ +#if GST_HAVE_UNALIGNED_ACCESS +static inline guint16 __gst_fast_read16(const guint8 *v) { + return *(const guint16*)(const void*)(v); +} +static inline guint32 __gst_fast_read32(const guint8 *v) { + return *(const guint32*)(const void*)(v); +} +static inline guint64 __gst_fast_read64(const guint8 *v) { + return *(const guint64*)(const void*)(v); +} +static inline guint16 __gst_fast_read_swap16(const guint8 *v) { + return GUINT16_SWAP_LE_BE(*(const guint16*)(const void*)(v)); +} +static inline guint32 __gst_fast_read_swap32(const guint8 *v) { + return GUINT32_SWAP_LE_BE(*(const guint32*)(const void*)(v)); +} +static inline guint64 __gst_fast_read_swap64(const guint8 *v) { + return GUINT64_SWAP_LE_BE(*(const guint64*)(const void*)(v)); +} +# define _GST_FAST_READ(s, d) __gst_fast_read##s((const guint8 *)(d)) +# define _GST_FAST_READ_SWAP(s, d) __gst_fast_read_swap##s((const guint8 *)(d)) + +static inline void __gst_fast_write16 (guint8 *p, guint16 v) { + *(guint16*)(void*)(p) = v; +} +static inline void __gst_fast_write32 (guint8 *p, guint32 v) { + *(guint32*)(void*)(p) = v; +} +static inline void __gst_fast_write64 (guint8 *p, guint64 v) { + *(guint64*)(void*)(p) = v; +} +static inline void __gst_fast_write_swap16 (guint8 *p, guint16 v) { + *(guint16*)(void*)(p) = GUINT16_SWAP_LE_BE (v); +} +static inline void __gst_fast_write_swap32 (guint8 *p, guint32 v) { + *(guint32*)(void*)(p) = GUINT32_SWAP_LE_BE (v); +} +static inline void __gst_fast_write_swap64 (guint8 *p, guint64 v) { + *(guint64*)(void*)(p) = GUINT64_SWAP_LE_BE (v); +} +# define _GST_FAST_WRITE(s, d, v) __gst_fast_write##s((guint8 *)(d), (v)) +# define _GST_FAST_WRITE_SWAP(s, d, v) __gst_fast_write_swap##s((guint8 *)(d), (v)) +#endif +#endif + + /** * GST_READ_UINT64_BE: * @data: memory location * * Read a 64 bit unsigned integer value in big endian format from the memory buffer. */ -#define GST_READ_UINT64_BE(data) (_GST_GET (data, 0, 64, 56) | \ - _GST_GET (data, 1, 64, 48) | \ - _GST_GET (data, 2, 64, 40) | \ - _GST_GET (data, 3, 64, 32) | \ - _GST_GET (data, 4, 64, 24) | \ - _GST_GET (data, 5, 64, 16) | \ - _GST_GET (data, 6, 64, 8) | \ - _GST_GET (data, 7, 64, 0)) /** * GST_READ_UINT64_LE: @@ -135,14 +228,42 @@ void gst_print_element_args (GString *buf, gint indent, GstE * * Read a 64 bit unsigned integer value in little endian format from the memory buffer. */ -#define GST_READ_UINT64_LE(data) (_GST_GET (data, 7, 64, 56) | \ - _GST_GET (data, 6, 64, 48) | \ - _GST_GET (data, 5, 64, 40) | \ - _GST_GET (data, 4, 64, 32) | \ - _GST_GET (data, 3, 64, 24) | \ - _GST_GET (data, 2, 64, 16) | \ - _GST_GET (data, 1, 64, 8) | \ - _GST_GET (data, 0, 64, 0)) +#if GST_HAVE_UNALIGNED_ACCESS +# if (G_BYTE_ORDER == G_BIG_ENDIAN) +# define GST_READ_UINT64_BE(data) _GST_FAST_READ (64, data) +# define GST_READ_UINT64_LE(data) _GST_FAST_READ_SWAP (64, data) +# else +# define GST_READ_UINT64_BE(data) _GST_FAST_READ_SWAP (64, data) +# define GST_READ_UINT64_LE(data) _GST_FAST_READ (64, data) +# endif +#else +#define _GST_READ_UINT64_BE(data) (_GST_GET (data, 0, 64, 56) | \ + _GST_GET (data, 1, 64, 48) | \ + _GST_GET (data, 2, 64, 40) | \ + _GST_GET (data, 3, 64, 32) | \ + _GST_GET (data, 4, 64, 24) | \ + _GST_GET (data, 5, 64, 16) | \ + _GST_GET (data, 6, 64, 8) | \ + _GST_GET (data, 7, 64, 0)) + +#define _GST_READ_UINT64_LE(data) (_GST_GET (data, 7, 64, 56) | \ + _GST_GET (data, 6, 64, 48) | \ + _GST_GET (data, 5, 64, 40) | \ + _GST_GET (data, 4, 64, 32) | \ + _GST_GET (data, 3, 64, 24) | \ + _GST_GET (data, 2, 64, 16) | \ + _GST_GET (data, 1, 64, 8) | \ + _GST_GET (data, 0, 64, 0)) + +#define GST_READ_UINT64_BE(data) __gst_slow_read64_be((const guint8 *)(data)) +static inline guint64 __gst_slow_read64_be (const guint8 * data) { + return _GST_READ_UINT64_BE (data); +} +#define GST_READ_UINT64_LE(data) __gst_slow_read64_le((const guint8 *)(data)) +static inline guint64 __gst_slow_read64_le (const guint8 * data) { + return _GST_READ_UINT64_LE (data); +} +#endif /** * GST_READ_UINT32_BE: @@ -150,10 +271,6 @@ void gst_print_element_args (GString *buf, gint indent, GstE * * Read a 32 bit unsigned integer value in big endian format from the memory buffer. */ -#define GST_READ_UINT32_BE(data) (_GST_GET (data, 0, 32, 24) | \ - _GST_GET (data, 1, 32, 16) | \ - _GST_GET (data, 2, 32, 8) | \ - _GST_GET (data, 3, 32, 0)) /** * GST_READ_UINT32_LE: @@ -161,52 +278,101 @@ void gst_print_element_args (GString *buf, gint indent, GstE * * Read a 32 bit unsigned integer value in little endian format from the memory buffer. */ -#define GST_READ_UINT32_LE(data) (_GST_GET (data, 3, 32, 24) | \ - _GST_GET (data, 2, 32, 16) | \ - _GST_GET (data, 1, 32, 8) | \ - _GST_GET (data, 0, 32, 0)) +#if GST_HAVE_UNALIGNED_ACCESS +# if (G_BYTE_ORDER == G_BIG_ENDIAN) +# define GST_READ_UINT32_BE(data) _GST_FAST_READ (32, data) +# define GST_READ_UINT32_LE(data) _GST_FAST_READ_SWAP (32, data) +# else +# define GST_READ_UINT32_BE(data) _GST_FAST_READ_SWAP (32, data) +# define GST_READ_UINT32_LE(data) _GST_FAST_READ (32, data) +# endif +#else +#define _GST_READ_UINT32_BE(data) (_GST_GET (data, 0, 32, 24) | \ + _GST_GET (data, 1, 32, 16) | \ + _GST_GET (data, 2, 32, 8) | \ + _GST_GET (data, 3, 32, 0)) + +#define _GST_READ_UINT32_LE(data) (_GST_GET (data, 3, 32, 24) | \ + _GST_GET (data, 2, 32, 16) | \ + _GST_GET (data, 1, 32, 8) | \ + _GST_GET (data, 0, 32, 0)) + +#define GST_READ_UINT32_BE(data) __gst_slow_read32_be((const guint8 *)(data)) +static inline guint32 __gst_slow_read32_be (const guint8 * data) { + return _GST_READ_UINT32_BE (data); +} +#define GST_READ_UINT32_LE(data) __gst_slow_read32_le((const guint8 *)(data)) +static inline guint32 __gst_slow_read32_le (const guint8 * data) { + return _GST_READ_UINT32_LE (data); +} +#endif /** * GST_READ_UINT24_BE: * @data: memory location * * Read a 24 bit unsigned integer value in big endian format from the memory buffer. - * - * Since: 0.10.22 */ -#define GST_READ_UINT24_BE(data) (_GST_GET (data, 0, 32, 16) | \ +#define _GST_READ_UINT24_BE(data) (_GST_GET (data, 0, 32, 16) | \ _GST_GET (data, 1, 32, 8) | \ _GST_GET (data, 2, 32, 0)) +#define GST_READ_UINT24_BE(data) __gst_slow_read24_be((const guint8 *)(data)) +static inline guint32 __gst_slow_read24_be (const guint8 * data) { + return _GST_READ_UINT24_BE (data); +} + /** * GST_READ_UINT24_LE: * @data: memory location * * Read a 24 bit unsigned integer value in little endian format from the memory buffer. - * - * Since: 0.10.22 */ -#define GST_READ_UINT24_LE(data) (_GST_GET (data, 2, 32, 16) | \ +#define _GST_READ_UINT24_LE(data) (_GST_GET (data, 2, 32, 16) | \ _GST_GET (data, 1, 32, 8) | \ _GST_GET (data, 0, 32, 0)) +#define GST_READ_UINT24_LE(data) __gst_slow_read24_le((const guint8 *)(data)) +static inline guint32 __gst_slow_read24_le (const guint8 * data) { + return _GST_READ_UINT24_LE (data); +} + /** * GST_READ_UINT16_BE: * @data: memory location * * Read a 16 bit unsigned integer value in big endian format from the memory buffer. */ -#define GST_READ_UINT16_BE(data) (_GST_GET (data, 0, 16, 8) | \ - _GST_GET (data, 1, 16, 0)) - /** * GST_READ_UINT16_LE: * @data: memory location * * Read a 16 bit unsigned integer value in little endian format from the memory buffer. */ -#define GST_READ_UINT16_LE(data) (_GST_GET (data, 1, 16, 8) | \ - _GST_GET (data, 0, 16, 0)) +#if GST_HAVE_UNALIGNED_ACCESS +# if (G_BYTE_ORDER == G_BIG_ENDIAN) +# define GST_READ_UINT16_BE(data) _GST_FAST_READ (16, data) +# define GST_READ_UINT16_LE(data) _GST_FAST_READ_SWAP (16, data) +# else +# define GST_READ_UINT16_BE(data) _GST_FAST_READ_SWAP (16, data) +# define GST_READ_UINT16_LE(data) _GST_FAST_READ (16, data) +# endif +#else +#define _GST_READ_UINT16_BE(data) (_GST_GET (data, 0, 16, 8) | \ + _GST_GET (data, 1, 16, 0)) + +#define _GST_READ_UINT16_LE(data) (_GST_GET (data, 1, 16, 8) | \ + _GST_GET (data, 0, 16, 0)) + +#define GST_READ_UINT16_BE(data) __gst_slow_read16_be((const guint8 *)(data)) +static inline guint16 __gst_slow_read16_be (const guint8 * data) { + return _GST_READ_UINT16_BE (data); +} +#define GST_READ_UINT16_LE(data) __gst_slow_read16_le((const guint8 *)(data)) +static inline guint16 __gst_slow_read16_le (const guint8 * data) { + return _GST_READ_UINT16_LE (data); +} +#endif /** * GST_READ_UINT8: @@ -219,80 +385,108 @@ void gst_print_element_args (GString *buf, gint indent, GstE /** * GST_WRITE_UINT64_BE: * @data: memory location - * @num: value to store + * @val: value to store * * Store a 64 bit unsigned integer value in big endian format into the memory buffer. */ -#define GST_WRITE_UINT64_BE(data, num) do { \ - _GST_PUT (data, 0, 64, 56, num); \ - _GST_PUT (data, 1, 64, 48, num); \ - _GST_PUT (data, 2, 64, 40, num); \ - _GST_PUT (data, 3, 64, 32, num); \ - _GST_PUT (data, 4, 64, 24, num); \ - _GST_PUT (data, 5, 64, 16, num); \ - _GST_PUT (data, 6, 64, 8, num); \ - _GST_PUT (data, 7, 64, 0, num); \ - } while (0) - /** * GST_WRITE_UINT64_LE: * @data: memory location - * @num: value to store + * @val: value to store * * Store a 64 bit unsigned integer value in little endian format into the memory buffer. */ -#define GST_WRITE_UINT64_LE(data, num) do { \ - _GST_PUT (data, 0, 64, 0, num); \ - _GST_PUT (data, 1, 64, 8, num); \ - _GST_PUT (data, 2, 64, 16, num); \ - _GST_PUT (data, 3, 64, 24, num); \ - _GST_PUT (data, 4, 64, 32, num); \ - _GST_PUT (data, 5, 64, 40, num); \ - _GST_PUT (data, 6, 64, 48, num); \ - _GST_PUT (data, 7, 64, 56, num); \ +#if GST_HAVE_UNALIGNED_ACCESS +# if (G_BYTE_ORDER == G_BIG_ENDIAN) +# define GST_WRITE_UINT64_BE(data,val) _GST_FAST_WRITE(64,data,val) +# define GST_WRITE_UINT64_LE(data,val) _GST_FAST_WRITE_SWAP(64,data,val) +# else +# define GST_WRITE_UINT64_BE(data,val) _GST_FAST_WRITE_SWAP(64,data,val) +# define GST_WRITE_UINT64_LE(data,val) _GST_FAST_WRITE(64,data,val) +# endif +#else +#define GST_WRITE_UINT64_BE(data,val) do { \ + gpointer __put_data = data; \ + guint64 __put_val = val; \ + _GST_PUT (__put_data, 0, 64, 56, __put_val); \ + _GST_PUT (__put_data, 1, 64, 48, __put_val); \ + _GST_PUT (__put_data, 2, 64, 40, __put_val); \ + _GST_PUT (__put_data, 3, 64, 32, __put_val); \ + _GST_PUT (__put_data, 4, 64, 24, __put_val); \ + _GST_PUT (__put_data, 5, 64, 16, __put_val); \ + _GST_PUT (__put_data, 6, 64, 8, __put_val); \ + _GST_PUT (__put_data, 7, 64, 0, __put_val); \ } while (0) +#define GST_WRITE_UINT64_LE(data,val) do { \ + gpointer __put_data = data; \ + guint64 __put_val = val; \ + _GST_PUT (__put_data, 0, 64, 0, __put_val); \ + _GST_PUT (__put_data, 1, 64, 8, __put_val); \ + _GST_PUT (__put_data, 2, 64, 16, __put_val); \ + _GST_PUT (__put_data, 3, 64, 24, __put_val); \ + _GST_PUT (__put_data, 4, 64, 32, __put_val); \ + _GST_PUT (__put_data, 5, 64, 40, __put_val); \ + _GST_PUT (__put_data, 6, 64, 48, __put_val); \ + _GST_PUT (__put_data, 7, 64, 56, __put_val); \ + } while (0) +#endif /* !GST_HAVE_UNALIGNED_ACCESS */ + /** * GST_WRITE_UINT32_BE: * @data: memory location - * @num: value to store + * @val: value to store * * Store a 32 bit unsigned integer value in big endian format into the memory buffer. */ -#define GST_WRITE_UINT32_BE(data, num) do { \ - _GST_PUT (data, 0, 32, 24, num); \ - _GST_PUT (data, 1, 32, 16, num); \ - _GST_PUT (data, 2, 32, 8, num); \ - _GST_PUT (data, 3, 32, 0, num); \ - } while (0) - /** * GST_WRITE_UINT32_LE: * @data: memory location - * @num: value to store + * @val: value to store * * Store a 32 bit unsigned integer value in little endian format into the memory buffer. */ -#define GST_WRITE_UINT32_LE(data, num) do { \ - _GST_PUT (data, 0, 32, 0, num); \ - _GST_PUT (data, 1, 32, 8, num); \ - _GST_PUT (data, 2, 32, 16, num); \ - _GST_PUT (data, 3, 32, 24, num); \ +#if GST_HAVE_UNALIGNED_ACCESS +# if (G_BYTE_ORDER == G_BIG_ENDIAN) +# define GST_WRITE_UINT32_BE(data,val) _GST_FAST_WRITE(32,data,val) +# define GST_WRITE_UINT32_LE(data,val) _GST_FAST_WRITE_SWAP(32,data,val) +# else +# define GST_WRITE_UINT32_BE(data,val) _GST_FAST_WRITE_SWAP(32,data,val) +# define GST_WRITE_UINT32_LE(data,val) _GST_FAST_WRITE(32,data,val) +# endif +#else +#define GST_WRITE_UINT32_BE(data,val) do { \ + gpointer __put_data = data; \ + guint32 __put_val = val; \ + _GST_PUT (__put_data, 0, 32, 24, __put_val); \ + _GST_PUT (__put_data, 1, 32, 16, __put_val); \ + _GST_PUT (__put_data, 2, 32, 8, __put_val); \ + _GST_PUT (__put_data, 3, 32, 0, __put_val); \ } while (0) +#define GST_WRITE_UINT32_LE(data,val) do { \ + gpointer __put_data = data; \ + guint32 __put_val = val; \ + _GST_PUT (__put_data, 0, 32, 0, __put_val); \ + _GST_PUT (__put_data, 1, 32, 8, __put_val); \ + _GST_PUT (__put_data, 2, 32, 16, __put_val); \ + _GST_PUT (__put_data, 3, 32, 24, __put_val); \ + } while (0) +#endif /* !GST_HAVE_UNALIGNED_ACCESS */ + /** * GST_WRITE_UINT24_BE: * @data: memory location * @num: value to store * * Store a 24 bit unsigned integer value in big endian format into the memory buffer. - * - * Since: 0.10.22 */ #define GST_WRITE_UINT24_BE(data, num) do { \ - _GST_PUT (data, 0, 32, 16, num); \ - _GST_PUT (data, 1, 32, 8, num); \ - _GST_PUT (data, 2, 32, 0, num); \ + gpointer __put_data = data; \ + guint32 __put_val = num; \ + _GST_PUT (__put_data, 0, 32, 16, __put_val); \ + _GST_PUT (__put_data, 1, 32, 8, __put_val); \ + _GST_PUT (__put_data, 2, 32, 0, __put_val); \ } while (0) /** @@ -301,39 +495,53 @@ void gst_print_element_args (GString *buf, gint indent, GstE * @num: value to store * * Store a 24 bit unsigned integer value in little endian format into the memory buffer. - * - * Since: 0.10.22 */ #define GST_WRITE_UINT24_LE(data, num) do { \ - _GST_PUT (data, 0, 32, 0, num); \ - _GST_PUT (data, 1, 32, 8, num); \ - _GST_PUT (data, 2, 32, 16, num); \ + gpointer __put_data = data; \ + guint32 __put_val = num; \ + _GST_PUT (__put_data, 0, 32, 0, __put_val); \ + _GST_PUT (__put_data, 1, 32, 8, __put_val); \ + _GST_PUT (__put_data, 2, 32, 16, __put_val); \ } while (0) /** * GST_WRITE_UINT16_BE: * @data: memory location - * @num: value to store + * @val: value to store * * Store a 16 bit unsigned integer value in big endian format into the memory buffer. */ -#define GST_WRITE_UINT16_BE(data, num) do { \ - _GST_PUT (data, 0, 16, 8, num); \ - _GST_PUT (data, 1, 16, 0, num); \ - } while (0) - /** * GST_WRITE_UINT16_LE: * @data: memory location - * @num: value to store + * @val: value to store * * Store a 16 bit unsigned integer value in little endian format into the memory buffer. */ -#define GST_WRITE_UINT16_LE(data, num) do { \ - _GST_PUT (data, 0, 16, 0, num); \ - _GST_PUT (data, 1, 16, 8, num); \ +#if GST_HAVE_UNALIGNED_ACCESS +# if (G_BYTE_ORDER == G_BIG_ENDIAN) +# define GST_WRITE_UINT16_BE(data,val) _GST_FAST_WRITE(16,data,val) +# define GST_WRITE_UINT16_LE(data,val) _GST_FAST_WRITE_SWAP(16,data,val) +# else +# define GST_WRITE_UINT16_BE(data,val) _GST_FAST_WRITE_SWAP(16,data,val) +# define GST_WRITE_UINT16_LE(data,val) _GST_FAST_WRITE(16,data,val) +# endif +#else +#define GST_WRITE_UINT16_BE(data,val) do { \ + gpointer __put_data = data; \ + guint16 __put_val = val; \ + _GST_PUT (__put_data, 0, 16, 8, __put_val); \ + _GST_PUT (__put_data, 1, 16, 0, __put_val); \ } while (0) +#define GST_WRITE_UINT16_LE(data,val) do { \ + gpointer __put_data = data; \ + guint16 __put_val = val; \ + _GST_PUT (__put_data, 0, 16, 0, __put_val); \ + _GST_PUT (__put_data, 1, 16, 8, __put_val); \ + } while (0) +#endif /* !GST_HAVE_UNALIGNED_ACCESS */ + /** * GST_WRITE_UINT8: * @data: memory location @@ -356,15 +564,8 @@ void gst_print_element_args (GString *buf, gint indent, GstE * Swap byte order of a 32-bit floating point value (float). * * Returns: @in byte-swapped. - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC gfloat GFLOAT_SWAP_LE_BE (gfloat in); -#endif - -inline static gfloat +static inline gfloat GFLOAT_SWAP_LE_BE(gfloat in) { union @@ -385,15 +586,8 @@ GFLOAT_SWAP_LE_BE(gfloat in) * Swap byte order of a 64-bit floating point value (double). * * Returns: @in byte-swapped. - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC gdouble GDOUBLE_SWAP_LE_BE (gdouble in); -#endif - -inline static gdouble +static inline gdouble GDOUBLE_SWAP_LE_BE(gdouble in) { union @@ -413,9 +607,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 64-bit floating point value (double) from native byte order into * little endian byte order. - * - * Since: 0.10.22 - * */ /** * GDOUBLE_TO_BE: @@ -423,9 +614,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 64-bit floating point value (double) from native byte order into * big endian byte order. - * - * Since: 0.10.22 - * */ /** * GDOUBLE_FROM_LE: @@ -433,9 +621,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 64-bit floating point value (double) from little endian byte order * into native byte order. - * - * Since: 0.10.22 - * */ /** * GDOUBLE_FROM_BE: @@ -443,9 +628,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 64-bit floating point value (double) from big endian byte order * into native byte order. - * - * Since: 0.10.22 - * */ /** @@ -454,9 +636,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 32-bit floating point value (float) from native byte order into * little endian byte order. - * - * Since: 0.10.22 - * */ /** * GFLOAT_TO_BE: @@ -464,9 +643,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 32-bit floating point value (float) from native byte order into * big endian byte order. - * - * Since: 0.10.22 - * */ /** * GFLOAT_FROM_LE: @@ -474,9 +650,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 32-bit floating point value (float) from little endian byte order * into native byte order. - * - * Since: 0.10.22 - * */ /** * GFLOAT_FROM_BE: @@ -484,9 +657,6 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * * Convert 32-bit floating point value (float) from big endian byte order * into native byte order. - * - * Since: 0.10.22 - * */ #if G_BYTE_ORDER == G_LITTLE_ENDIAN @@ -519,15 +689,8 @@ GDOUBLE_SWAP_LE_BE(gdouble in) * Read a 32 bit float value in little endian format from the memory buffer. * * Returns: The floating point value read from @data - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC gfloat GST_READ_FLOAT_LE (const guint8 *data); -#endif - -inline static gfloat +static inline gfloat GST_READ_FLOAT_LE(const guint8 *data) { union @@ -547,15 +710,8 @@ GST_READ_FLOAT_LE(const guint8 *data) * Read a 32 bit float value in big endian format from the memory buffer. * * Returns: The floating point value read from @data - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC gfloat GST_READ_FLOAT_BE (const guint8 *data); -#endif - -inline static gfloat +static inline gfloat GST_READ_FLOAT_BE(const guint8 *data) { union @@ -575,15 +731,8 @@ GST_READ_FLOAT_BE(const guint8 *data) * Read a 64 bit double value in little endian format from the memory buffer. * * Returns: The double-precision floating point value read from @data - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC gdouble GST_READ_DOUBLE_LE (const guint8 *data); -#endif - -inline static gdouble +static inline gdouble GST_READ_DOUBLE_LE(const guint8 *data) { union @@ -603,15 +752,8 @@ GST_READ_DOUBLE_LE(const guint8 *data) * Read a 64 bit double value in big endian format from the memory buffer. * * Returns: The double-precision floating point value read from @data - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC gdouble GST_READ_DOUBLE_BE (const guint8 *data); -#endif - -inline static gdouble +static inline gdouble GST_READ_DOUBLE_BE(const guint8 *data) { union @@ -630,15 +772,8 @@ GST_READ_DOUBLE_BE(const guint8 *data) * @num: value to store * * Store a 32 bit float value in little endian format into the memory buffer. - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC void GST_WRITE_FLOAT_LE (guint8 *data, gfloat num); -#endif - -inline static void +static inline void GST_WRITE_FLOAT_LE(guint8 *data, gfloat num) { union @@ -657,15 +792,8 @@ GST_WRITE_FLOAT_LE(guint8 *data, gfloat num) * @num: value to store * * Store a 32 bit float value in big endian format into the memory buffer. - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC void GST_WRITE_FLOAT_BE (guint8 *data, gfloat num); -#endif - -inline static void +static inline void GST_WRITE_FLOAT_BE(guint8 *data, gfloat num) { union @@ -684,15 +812,8 @@ GST_WRITE_FLOAT_BE(guint8 *data, gfloat num) * @num: value to store * * Store a 64 bit double value in little endian format into the memory buffer. - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC void GST_WRITE_DOUBLE_LE (guint8 *data, gdouble num); -#endif - -inline static void +static inline void GST_WRITE_DOUBLE_LE(guint8 *data, gdouble num) { union @@ -711,15 +832,8 @@ GST_WRITE_DOUBLE_LE(guint8 *data, gdouble num) * @num: value to store * * Store a 64 bit double value in big endian format into the memory buffer. - * - * Since: 0.10.22 - * */ -#ifdef _FOOL_GTK_DOC_ -G_INLINE_FUNC void GST_WRITE_DOUBLE_BE (guint8 *data, gdouble num); -#endif - -inline static void +static inline void GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) { union @@ -776,14 +890,30 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) * Rounds an integer value up to the next multiple of 64. */ #define GST_ROUND_UP_64(num) (((num)+63)&~63) +/** + * GST_ROUND_UP_128: + * @num: integer value to round up + * + * Rounds an integer value up to the next multiple of 128. + * Since: 1.4 + */ +#define GST_ROUND_UP_128(num) (((num)+127)&~127) +/** + * GST_ROUND_UP_N: + * @num: integrer value to round up + * @align: a power of two to round up to + * + * Rounds an integer value up to the next multiple of @align. @align MUST be a + * power of two. + */ +#define GST_ROUND_UP_N(num,align) ((((num) + ((align) - 1)) & ~((align) - 1))) + /** * GST_ROUND_DOWN_2: * @num: integer value to round down * * Rounds an integer value down to the next multiple of 2. - * - * Since: 0.10.12 */ #define GST_ROUND_DOWN_2(num) ((num)&(~1)) /** @@ -791,8 +921,6 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) * @num: integer value to round down * * Rounds an integer value down to the next multiple of 4. - * - * Since: 0.10.12 */ #define GST_ROUND_DOWN_4(num) ((num)&(~3)) /** @@ -800,8 +928,6 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) * @num: integer value to round down * * Rounds an integer value down to the next multiple of 8. - * - * Since: 0.10.12 */ #define GST_ROUND_DOWN_8(num) ((num)&(~7)) /** @@ -809,8 +935,6 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) * @num: integer value to round down * * Rounds an integer value down to the next multiple of 16. - * - * Since: 0.10.12 */ #define GST_ROUND_DOWN_16(num) ((num)&(~15)) /** @@ -818,8 +942,6 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) * @num: integer value to round down * * Rounds an integer value down to the next multiple of 32. - * - * Since: 0.10.12 */ #define GST_ROUND_DOWN_32(num) ((num)&(~31)) /** @@ -827,111 +949,209 @@ GST_WRITE_DOUBLE_BE(guint8 *data, gdouble num) * @num: integer value to round down * * Rounds an integer value down to the next multiple of 64. - * - * Since: 0.10.12 */ #define GST_ROUND_DOWN_64(num) ((num)&(~63)) +/** + * GST_ROUND_DOWN_128: + * @num: integer value to round down + * + * Rounds an integer value down to the next multiple of 128. + * Since: 1.4 + */ +#define GST_ROUND_DOWN_128(num) ((num)&(~127)) +/** + * GST_ROUND_DOWN_N: + * @num: integrer value to round down + * @align: a power of two to round down to + * + * Rounds an integer value down to the next multiple of @align. @align MUST be a + * power of two. + */ +#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); -GstPad* gst_element_get_compatible_pad (GstElement *element, GstPad *pad, - const GstCaps *caps); +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); -/* element class functions */ -void gst_element_class_install_std_props (GstElementClass * klass, - const gchar * first_name, ...) G_GNUC_NULL_TERMINATED; - /* 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); -gboolean gst_pad_query_accept_caps (GstPad *pad, GstCaps *caps); +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); -/* buffer functions */ -GstBuffer * gst_buffer_merge (GstBuffer * buf1, GstBuffer * buf2); -GstBuffer * gst_buffer_join (GstBuffer * buf1, GstBuffer * buf2); +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); /** @@ -941,8 +1161,6 @@ GstClockTime gst_util_get_timestamp (void); * @GST_SEARCH_MODE_AFTER : Search for an exact match or the element just after. * * The different search modes. - * - * Since: 0.10.23 */ typedef enum { GST_SEARCH_MODE_EXACT = 0, @@ -950,23 +1168,42 @@ 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, + GstClockTime * b, GstClockTime * xbase, + gdouble * r_squared); + G_END_DECLS