| /* GStreamer |
| * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu> |
| * 2000 Wim Taymans <wtay@chello.be> |
| * 2002 Thomas Vander Stichele <thomas@apestaart.org> |
| * |
| * gstutils.c: Utility functions |
| * |
| * This library is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU Library General Public |
| * License as published by the Free Software Foundation; either |
| * version 2 of the License, or (at your option) any later version. |
| * |
| * This library is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| * Library General Public License for more details. |
| * |
| * 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., 51 Franklin St, Fifth Floor, |
| * Boston, MA 02110-1301, USA. |
| */ |
| |
| /** |
| * SECTION:gstutils |
| * @short_description: Various utility functions |
| * |
| */ |
| |
| #include "gst_private.h" |
| #include <stdio.h> |
| #include <string.h> |
| |
| #include "gstghostpad.h" |
| #include "gstutils.h" |
| #include "gsterror.h" |
| #include "gstinfo.h" |
| #include "gstparse.h" |
| #include "gstvalue.h" |
| #include "gst-i18n-lib.h" |
| #include "glib-compat-private.h" |
| #include <math.h> |
| |
| /** |
| * gst_util_dump_mem: |
| * @mem: a pointer to the memory to dump |
| * @size: the size of the memory block to dump |
| * |
| * Dumps the memory block into a hex representation. Useful for debugging. |
| */ |
| void |
| gst_util_dump_mem (const guchar * mem, guint size) |
| { |
| guint i, j; |
| GString *string = g_string_sized_new (50); |
| GString *chars = g_string_sized_new (18); |
| |
| i = j = 0; |
| while (i < size) { |
| if (g_ascii_isprint (mem[i])) |
| g_string_append_c (chars, mem[i]); |
| else |
| g_string_append_c (chars, '.'); |
| |
| g_string_append_printf (string, "%02x ", mem[i]); |
| |
| j++; |
| i++; |
| |
| if (j == 16 || i == size) { |
| g_print ("%08x (%p): %-48.48s %-16.16s\n", i - j, mem + i - j, |
| string->str, chars->str); |
| g_string_set_size (string, 0); |
| g_string_set_size (chars, 0); |
| j = 0; |
| } |
| } |
| g_string_free (string, TRUE); |
| g_string_free (chars, TRUE); |
| } |
| |
| |
| /** |
| * gst_util_set_value_from_string: |
| * @value: (out caller-allocates): the value to set |
| * @value_str: the string to get the value from |
| * |
| * Converts the string to the type of the value and |
| * sets the value with it. |
| * |
| * Note that this function is dangerous as it does not return any indication |
| * if the conversion worked or not. |
| */ |
| void |
| gst_util_set_value_from_string (GValue * value, const gchar * value_str) |
| { |
| gboolean res; |
| |
| g_return_if_fail (value != NULL); |
| g_return_if_fail (value_str != NULL); |
| |
| GST_CAT_DEBUG (GST_CAT_PARAMS, "parsing '%s' to type %s", value_str, |
| g_type_name (G_VALUE_TYPE (value))); |
| |
| res = gst_value_deserialize (value, value_str); |
| if (!res && G_VALUE_TYPE (value) == G_TYPE_BOOLEAN) { |
| /* backwards compat, all booleans that fail to parse are false */ |
| g_value_set_boolean (value, FALSE); |
| res = TRUE; |
| } |
| g_return_if_fail (res); |
| } |
| |
| /** |
| * gst_util_set_object_arg: |
| * @object: the object to set the argument of |
| * @name: the name of the argument to set |
| * @value: the string value to set |
| * |
| * Converts the string value to the type of the objects argument and |
| * sets the argument with it. |
| * |
| * Note that this function silently returns if @object has no property named |
| * @name or when @value cannot be converted to the type of the property. |
| */ |
| void |
| gst_util_set_object_arg (GObject * object, const gchar * name, |
| const gchar * value) |
| { |
| GParamSpec *pspec; |
| GType value_type; |
| GValue v = { 0, }; |
| |
| g_return_if_fail (G_IS_OBJECT (object)); |
| g_return_if_fail (name != NULL); |
| g_return_if_fail (value != NULL); |
| |
| pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (object), name); |
| if (!pspec) |
| return; |
| |
| value_type = pspec->value_type; |
| |
| GST_DEBUG ("pspec->flags is %d, pspec->value_type is %s", |
| pspec->flags, g_type_name (value_type)); |
| |
| if (!(pspec->flags & G_PARAM_WRITABLE)) |
| return; |
| |
| g_value_init (&v, value_type); |
| |
| /* special case for element <-> xml (de)serialisation */ |
| if (value_type == GST_TYPE_STRUCTURE && strcmp (value, "NULL") == 0) { |
| g_value_set_boxed (&v, NULL); |
| goto done; |
| } |
| |
| if (!gst_value_deserialize (&v, value)) |
| return; |
| |
| done: |
| |
| g_object_set_property (object, pspec->name, &v); |
| g_value_unset (&v); |
| } |
| |
| /* work around error C2520: conversion from unsigned __int64 to double |
| * not implemented, use signed __int64 |
| * |
| * These are implemented as functions because on some platforms a 64bit int to |
| * double conversion is not defined/implemented. |
| */ |
| |
| gdouble |
| gst_util_guint64_to_gdouble (guint64 value) |
| { |
| if (value & G_GINT64_CONSTANT (0x8000000000000000)) |
| return (gdouble) ((gint64) value) + (gdouble) 18446744073709551616.; |
| else |
| return (gdouble) ((gint64) value); |
| } |
| |
| guint64 |
| gst_util_gdouble_to_guint64 (gdouble value) |
| { |
| if (value < (gdouble) 9223372036854775808.) /* 1 << 63 */ |
| return ((guint64) ((gint64) value)); |
| |
| value -= (gdouble) 18446744073709551616.; |
| return ((guint64) ((gint64) value)); |
| } |
| |
| #ifndef HAVE_UINT128_T |
| /* convenience struct for getting high and low uint32 parts of |
| * a guint64 */ |
| typedef union |
| { |
| guint64 ll; |
| struct |
| { |
| #if G_BYTE_ORDER == G_BIG_ENDIAN |
| guint32 high, low; |
| #else |
| guint32 low, high; |
| #endif |
| } l; |
| } GstUInt64; |
| |
| #if defined (__x86_64__) && defined (__GNUC__) |
| static inline void |
| gst_util_uint64_mul_uint64 (GstUInt64 * c1, GstUInt64 * c0, guint64 arg1, |
| guint64 arg2) |
| { |
| __asm__ __volatile__ ("mulq %3":"=a" (c0->ll), "=d" (c1->ll) |
| :"a" (arg1), "g" (arg2) |
| ); |
| } |
| #else /* defined (__x86_64__) */ |
| /* multiply two 64-bit unsigned ints into a 128-bit unsigned int. the high |
| * and low 64 bits of the product are placed in c1 and c0 respectively. |
| * this operation cannot overflow. */ |
| static inline void |
| gst_util_uint64_mul_uint64 (GstUInt64 * c1, GstUInt64 * c0, guint64 arg1, |
| guint64 arg2) |
| { |
| GstUInt64 a1, b0; |
| GstUInt64 v, n; |
| |
| /* prepare input */ |
| v.ll = arg1; |
| n.ll = arg2; |
| |
| /* do 128 bits multiply |
| * nh nl |
| * * vh vl |
| * ---------- |
| * a0 = vl * nl |
| * a1 = vl * nh |
| * b0 = vh * nl |
| * b1 = + vh * nh |
| * ------------------- |
| * c1h c1l c0h c0l |
| * |
| * "a0" is optimized away, result is stored directly in c0. "b1" is |
| * optimized away, result is stored directly in c1. |
| */ |
| c0->ll = (guint64) v.l.low * n.l.low; |
| a1.ll = (guint64) v.l.low * n.l.high; |
| b0.ll = (guint64) v.l.high * n.l.low; |
| |
| /* add the high word of a0 to the low words of a1 and b0 using c1 as |
| * scrach space to capture the carry. the low word of the result becomes |
| * the final high word of c0 */ |
| c1->ll = (guint64) c0->l.high + a1.l.low + b0.l.low; |
| c0->l.high = c1->l.low; |
| |
| /* add the carry from the result above (found in the high word of c1) and |
| * the high words of a1 and b0 to b1, the result is c1. */ |
| c1->ll = (guint64) v.l.high * n.l.high + c1->l.high + a1.l.high + b0.l.high; |
| } |
| #endif /* defined (__x86_64__) */ |
| |
| #if defined (__x86_64__) && defined (__GNUC__) |
| static inline guint64 |
| gst_util_div128_64 (GstUInt64 c1, GstUInt64 c0, guint64 denom) |
| { |
| guint64 res; |
| |
| __asm__ __volatile__ ("divq %3":"=a" (res) |
| :"d" (c1.ll), "a" (c0.ll), "g" (denom) |
| ); |
| |
| return res; |
| } |
| #else |
| /* count leading zeros */ |
| static inline guint |
| gst_util_clz (guint32 val) |
| { |
| guint s; |
| |
| s = val | (val >> 1); |
| s |= (s >> 2); |
| s |= (s >> 4); |
| s |= (s >> 8); |
| s = ~(s | (s >> 16)); |
| s = s - ((s >> 1) & 0x55555555); |
| s = (s & 0x33333333) + ((s >> 2) & 0x33333333); |
| s = (s + (s >> 4)) & 0x0f0f0f0f; |
| s += (s >> 8); |
| s = (s + (s >> 16)) & 0x3f; |
| |
| return s; |
| } |
| |
| /* based on Hacker's Delight p152 */ |
| static inline guint64 |
| gst_util_div128_64 (GstUInt64 c1, GstUInt64 c0, guint64 denom) |
| { |
| GstUInt64 q1, q0, rhat; |
| GstUInt64 v, cmp1, cmp2; |
| guint s; |
| |
| v.ll = denom; |
| |
| /* count number of leading zeroes, we know they must be in the high |
| * part of denom since denom > G_MAXUINT32. */ |
| s = gst_util_clz (v.l.high); |
| |
| if (s > 0) { |
| /* normalize divisor and dividend */ |
| v.ll <<= s; |
| c1.ll = (c1.ll << s) | (c0.l.high >> (32 - s)); |
| c0.ll <<= s; |
| } |
| |
| q1.ll = c1.ll / v.l.high; |
| rhat.ll = c1.ll - q1.ll * v.l.high; |
| |
| cmp1.l.high = rhat.l.low; |
| cmp1.l.low = c0.l.high; |
| cmp2.ll = q1.ll * v.l.low; |
| |
| while (q1.l.high || cmp2.ll > cmp1.ll) { |
| q1.ll--; |
| rhat.ll += v.l.high; |
| if (rhat.l.high) |
| break; |
| cmp1.l.high = rhat.l.low; |
| cmp2.ll -= v.l.low; |
| } |
| c1.l.high = c1.l.low; |
| c1.l.low = c0.l.high; |
| c1.ll -= q1.ll * v.ll; |
| q0.ll = c1.ll / v.l.high; |
| rhat.ll = c1.ll - q0.ll * v.l.high; |
| |
| cmp1.l.high = rhat.l.low; |
| cmp1.l.low = c0.l.low; |
| cmp2.ll = q0.ll * v.l.low; |
| |
| while (q0.l.high || cmp2.ll > cmp1.ll) { |
| q0.ll--; |
| rhat.ll += v.l.high; |
| if (rhat.l.high) |
| break; |
| cmp1.l.high = rhat.l.low; |
| cmp2.ll -= v.l.low; |
| } |
| q0.l.high += q1.l.low; |
| |
| return q0.ll; |
| } |
| #endif /* defined (__GNUC__) */ |
| |
| /* This always gives the correct result because: |
| * a) val <= G_MAXUINT64-1 |
| * b) (c0,c1) <= G_MAXUINT64 * (G_MAXUINT64-1) |
| * or |
| * (c0,c1) == G_MAXUINT64 * G_MAXUINT64 and denom < G_MAXUINT64 |
| * (note: num==denom case is handled by short path) |
| * This means that (c0,c1) either has enough space for val |
| * or that the overall result will overflow anyway. |
| */ |
| |
| /* add correction with carry */ |
| #define CORRECT(c0,c1,val) \ |
| if (val) { \ |
| if (G_MAXUINT64 - c0.ll < val) { \ |
| if (G_UNLIKELY (c1.ll == G_MAXUINT64)) \ |
| /* overflow */ \ |
| return G_MAXUINT64; \ |
| c1.ll++; \ |
| } \ |
| c0.ll += val; \ |
| } |
| |
| static guint64 |
| gst_util_uint64_scale_uint64_unchecked (guint64 val, guint64 num, |
| guint64 denom, guint64 correct) |
| { |
| GstUInt64 c1, c0; |
| |
| /* compute 128-bit numerator product */ |
| gst_util_uint64_mul_uint64 (&c1, &c0, val, num); |
| |
| /* perform rounding correction */ |
| CORRECT (c0, c1, correct); |
| |
| /* high word as big as or bigger than denom --> overflow */ |
| if (G_UNLIKELY (c1.ll >= denom)) |
| return G_MAXUINT64; |
| |
| /* compute quotient, fits in 64 bits */ |
| return gst_util_div128_64 (c1, c0, denom); |
| } |
| #else |
| |
| #define GST_MAXUINT128 ((__uint128_t) -1) |
| static guint64 |
| gst_util_uint64_scale_uint64_unchecked (guint64 val, guint64 num, |
| guint64 denom, guint64 correct) |
| { |
| __uint128_t tmp; |
| |
| /* Calculate val * num */ |
| tmp = ((__uint128_t) val) * ((__uint128_t) num); |
| |
| /* overflow checks */ |
| if (G_UNLIKELY (GST_MAXUINT128 - correct < tmp)) |
| return G_MAXUINT64; |
| |
| /* perform rounding correction */ |
| tmp += correct; |
| |
| /* Divide by denom */ |
| tmp /= denom; |
| |
| /* if larger than G_MAXUINT64 --> overflow */ |
| if (G_UNLIKELY (tmp > G_MAXUINT64)) |
| return G_MAXUINT64; |
| |
| /* compute quotient, fits in 64 bits */ |
| return (guint64) tmp; |
| } |
| |
| #endif |
| |
| #if !defined (__x86_64__) && !defined (HAVE_UINT128_T) |
| static inline void |
| gst_util_uint64_mul_uint32 (GstUInt64 * c1, GstUInt64 * c0, guint64 arg1, |
| guint32 arg2) |
| { |
| GstUInt64 a; |
| |
| a.ll = arg1; |
| |
| c0->ll = (guint64) a.l.low * arg2; |
| c1->ll = (guint64) a.l.high * arg2 + c0->l.high; |
| c0->l.high = 0; |
| } |
| |
| /* divide a 96-bit unsigned int by a 32-bit unsigned int when we know the |
| * quotient fits into 64 bits. the high 64 bits and low 32 bits of the |
| * numerator are expected in c1 and c0 respectively. */ |
| static inline guint64 |
| gst_util_div96_32 (guint64 c1, guint64 c0, guint32 denom) |
| { |
| c0 += (c1 % denom) << 32; |
| return ((c1 / denom) << 32) + (c0 / denom); |
| } |
| |
| static inline guint64 |
| gst_util_uint64_scale_uint32_unchecked (guint64 val, guint32 num, |
| guint32 denom, guint32 correct) |
| { |
| GstUInt64 c1, c0; |
| |
| /* compute 96-bit numerator product */ |
| gst_util_uint64_mul_uint32 (&c1, &c0, val, num); |
| |
| /* condition numerator based on rounding mode */ |
| CORRECT (c0, c1, correct); |
| |
| /* high 32 bits as big as or bigger than denom --> overflow */ |
| if (G_UNLIKELY (c1.l.high >= denom)) |
| return G_MAXUINT64; |
| |
| /* compute quotient, fits in 64 bits */ |
| return gst_util_div96_32 (c1.ll, c0.ll, denom); |
| } |
| #endif |
| |
| /* the guts of the gst_util_uint64_scale() variants */ |
| static guint64 |
| _gst_util_uint64_scale (guint64 val, guint64 num, guint64 denom, |
| guint64 correct) |
| { |
| g_return_val_if_fail (denom != 0, G_MAXUINT64); |
| |
| if (G_UNLIKELY (num == 0)) |
| return 0; |
| |
| if (G_UNLIKELY (num == denom)) |
| return val; |
| |
| /* on 64bits we always use a full 128bits multiply/division */ |
| #if !defined (__x86_64__) && !defined (HAVE_UINT128_T) |
| /* denom is low --> try to use 96 bit muldiv */ |
| if (G_LIKELY (denom <= G_MAXUINT32)) { |
| /* num is low --> use 96 bit muldiv */ |
| if (G_LIKELY (num <= G_MAXUINT32)) |
| return gst_util_uint64_scale_uint32_unchecked (val, (guint32) num, |
| (guint32) denom, correct); |
| |
| /* num is high but val is low --> swap and use 96-bit muldiv */ |
| if (G_LIKELY (val <= G_MAXUINT32)) |
| return gst_util_uint64_scale_uint32_unchecked (num, (guint32) val, |
| (guint32) denom, correct); |
| } |
| #endif /* !defined (__x86_64__) && !defined (HAVE_UINT128_T) */ |
| |
| /* val is high and num is high --> use 128-bit muldiv */ |
| return gst_util_uint64_scale_uint64_unchecked (val, num, denom, correct); |
| } |
| |
| /** |
| * gst_util_uint64_scale: |
| * @val: the number to scale |
| * @num: the numerator of the scale ratio |
| * @denom: the denominator of the scale ratio |
| * |
| * Scale @val by the rational number @num / @denom, avoiding overflows and |
| * underflows and without loss of precision. |
| * |
| * This function can potentially be very slow if val and num are both |
| * greater than G_MAXUINT32. |
| * |
| * Returns: @val * @num / @denom. In the case of an overflow, this |
| * function returns G_MAXUINT64. If the result is not exactly |
| * representable as an integer it is truncated. See also |
| * gst_util_uint64_scale_round(), gst_util_uint64_scale_ceil(), |
| * gst_util_uint64_scale_int(), gst_util_uint64_scale_int_round(), |
| * gst_util_uint64_scale_int_ceil(). |
| */ |
| guint64 |
| gst_util_uint64_scale (guint64 val, guint64 num, guint64 denom) |
| { |
| return _gst_util_uint64_scale (val, num, denom, 0); |
| } |
| |
| /** |
| * gst_util_uint64_scale_round: |
| * @val: the number to scale |
| * @num: the numerator of the scale ratio |
| * @denom: the denominator of the scale ratio |
| * |
| * Scale @val by the rational number @num / @denom, avoiding overflows and |
| * underflows and without loss of precision. |
| * |
| * This function can potentially be very slow if val and num are both |
| * greater than G_MAXUINT32. |
| * |
| * Returns: @val * @num / @denom. In the case of an overflow, this |
| * function returns G_MAXUINT64. If the result is not exactly |
| * representable as an integer, it is rounded to the nearest integer |
| * (half-way cases are rounded up). See also gst_util_uint64_scale(), |
| * gst_util_uint64_scale_ceil(), gst_util_uint64_scale_int(), |
| * gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil(). |
| */ |
| guint64 |
| gst_util_uint64_scale_round (guint64 val, guint64 num, guint64 denom) |
| { |
| return _gst_util_uint64_scale (val, num, denom, denom >> 1); |
| } |
| |
| /** |
| * gst_util_uint64_scale_ceil: |
| * @val: the number to scale |
| * @num: the numerator of the scale ratio |
| * @denom: the denominator of the scale ratio |
| * |
| * Scale @val by the rational number @num / @denom, avoiding overflows and |
| * underflows and without loss of precision. |
| * |
| * This function can potentially be very slow if val and num are both |
| * greater than G_MAXUINT32. |
| * |
| * Returns: @val * @num / @denom. In the case of an overflow, this |
| * function returns G_MAXUINT64. If the result is not exactly |
| * representable as an integer, it is rounded up. See also |
| * gst_util_uint64_scale(), gst_util_uint64_scale_round(), |
| * gst_util_uint64_scale_int(), gst_util_uint64_scale_int_round(), |
| * gst_util_uint64_scale_int_ceil(). |
| */ |
| guint64 |
| gst_util_uint64_scale_ceil (guint64 val, guint64 num, guint64 denom) |
| { |
| return _gst_util_uint64_scale (val, num, denom, denom - 1); |
| } |
| |
| /* the guts of the gst_util_uint64_scale_int() variants */ |
| static guint64 |
| _gst_util_uint64_scale_int (guint64 val, gint num, gint denom, gint correct) |
| { |
| g_return_val_if_fail (denom > 0, G_MAXUINT64); |
| g_return_val_if_fail (num >= 0, G_MAXUINT64); |
| |
| if (G_UNLIKELY (num == 0)) |
| return 0; |
| |
| if (G_UNLIKELY (num == denom)) |
| return val; |
| |
| if (val <= G_MAXUINT32) { |
| /* simple case. num and denom are not negative so casts are OK. when |
| * not truncating, the additions to the numerator cannot overflow |
| * because val*num <= G_MAXUINT32 * G_MAXINT32 < G_MAXUINT64 - |
| * G_MAXINT32, so there's room to add another gint32. */ |
| val *= (guint64) num; |
| /* add rounding correction */ |
| val += correct; |
| |
| return val / (guint64) denom; |
| } |
| #if !defined (__x86_64__) && !defined (HAVE_UINT128_T) |
| /* num and denom are not negative so casts are OK */ |
| return gst_util_uint64_scale_uint32_unchecked (val, (guint32) num, |
| (guint32) denom, (guint32) correct); |
| #else |
| /* always use full 128bits scale */ |
| return gst_util_uint64_scale_uint64_unchecked (val, num, denom, correct); |
| #endif |
| } |
| |
| /** |
| * gst_util_uint64_scale_int: |
| * @val: guint64 (such as a #GstClockTime) to scale. |
| * @num: numerator of the scale factor. |
| * @denom: denominator of the scale factor. |
| * |
| * Scale @val by the rational number @num / @denom, avoiding overflows and |
| * underflows and without loss of precision. @num must be non-negative and |
| * @denom must be positive. |
| * |
| * Returns: @val * @num / @denom. In the case of an overflow, this |
| * function returns G_MAXUINT64. If the result is not exactly |
| * representable as an integer, it is truncated. See also |
| * gst_util_uint64_scale_int_round(), gst_util_uint64_scale_int_ceil(), |
| * gst_util_uint64_scale(), gst_util_uint64_scale_round(), |
| * gst_util_uint64_scale_ceil(). |
| */ |
| guint64 |
| gst_util_uint64_scale_int (guint64 val, gint num, gint denom) |
| { |
| return _gst_util_uint64_scale_int (val, num, denom, 0); |
| } |
| |
| /** |
| * gst_util_uint64_scale_int_round: |
| * @val: guint64 (such as a #GstClockTime) to scale. |
| * @num: numerator of the scale factor. |
| * @denom: denominator of the scale factor. |
| * |
| * Scale @val by the rational number @num / @denom, avoiding overflows and |
| * underflows and without loss of precision. @num must be non-negative and |
| * @denom must be positive. |
| * |
| * Returns: @val * @num / @denom. In the case of an overflow, this |
| * function returns G_MAXUINT64. If the result is not exactly |
| * representable as an integer, it is rounded to the nearest integer |
| * (half-way cases are rounded up). See also gst_util_uint64_scale_int(), |
| * gst_util_uint64_scale_int_ceil(), gst_util_uint64_scale(), |
| * gst_util_uint64_scale_round(), gst_util_uint64_scale_ceil(). |
| */ |
| guint64 |
| gst_util_uint64_scale_int_round (guint64 val, gint num, gint denom) |
| { |
| /* we can use a shift to divide by 2 because denom is required to be |
| * positive. */ |
| return _gst_util_uint64_scale_int (val, num, denom, denom >> 1); |
| } |
| |
| /** |
| * gst_util_uint64_scale_int_ceil: |
| * @val: guint64 (such as a #GstClockTime) to scale. |
| * @num: numerator of the scale factor. |
| * @denom: denominator of the scale factor. |
| * |
| * Scale @val by the rational number @num / @denom, avoiding overflows and |
| * underflows and without loss of precision. @num must be non-negative and |
| * @denom must be positive. |
| * |
| * Returns: @val * @num / @denom. In the case of an overflow, this |
| * function returns G_MAXUINT64. If the result is not exactly |
| * representable as an integer, it is rounded up. See also |
| * gst_util_uint64_scale_int(), gst_util_uint64_scale_int_round(), |
| * gst_util_uint64_scale(), gst_util_uint64_scale_round(), |
| * gst_util_uint64_scale_ceil(). |
| */ |
| guint64 |
| gst_util_uint64_scale_int_ceil (guint64 val, gint num, gint denom) |
| { |
| return _gst_util_uint64_scale_int (val, num, denom, denom - 1); |
| } |
| |
| /** |
| * gst_util_seqnum_next: |
| * |
| * Return a constantly incrementing sequence number. |
| * |
| * This function is used internally to GStreamer to be able to determine which |
| * events and messages are "the same". For example, elements may set the seqnum |
| * on a segment-done message to be the same as that of the last seek event, to |
| * indicate that event and the message correspond to the same segment. |
| * |
| * Returns: A constantly incrementing 32-bit unsigned integer, which might |
| * overflow back to 0 at some point. Use gst_util_seqnum_compare() to make sure |
| * you handle wraparound correctly. |
| */ |
| guint32 |
| gst_util_seqnum_next (void) |
| { |
| static gint counter = 0; |
| return g_atomic_int_add (&counter, 1); |
| } |
| |
| /** |
| * gst_util_seqnum_compare: |
| * @s1: A sequence number. |
| * @s2: Another sequence number. |
| * |
| * Compare two sequence numbers, handling wraparound. |
| * |
| * The current implementation just returns (gint32)(@s1 - @s2). |
| * |
| * Returns: A negative number if @s1 is before @s2, 0 if they are equal, or a |
| * positive number if @s1 is after @s2. |
| */ |
| gint32 |
| gst_util_seqnum_compare (guint32 s1, guint32 s2) |
| { |
| return (gint32) (s1 - s2); |
| } |
| |
| /* ----------------------------------------------------- |
| * |
| * The following code will be moved out of the main |
| * gstreamer library someday. |
| */ |
| |
| #include "gstpad.h" |
| |
| /** |
| * gst_element_create_all_pads: |
| * @element: (transfer none): a #GstElement to create pads for |
| * |
| * Creates a pad for each pad template that is always available. |
| * This function is only useful during object initialization of |
| * subclasses of #GstElement. |
| */ |
| void |
| gst_element_create_all_pads (GstElement * element) |
| { |
| GList *padlist; |
| |
| /* FIXME: lock element */ |
| |
| padlist = |
| gst_element_class_get_pad_template_list (GST_ELEMENT_CLASS |
| (G_OBJECT_GET_CLASS (element))); |
| |
| while (padlist) { |
| GstPadTemplate *padtempl = (GstPadTemplate *) padlist->data; |
| |
| if (padtempl->presence == GST_PAD_ALWAYS) { |
| GstPad *pad; |
| |
| pad = gst_pad_new_from_template (padtempl, padtempl->name_template); |
| |
| gst_element_add_pad (element, pad); |
| } |
| padlist = padlist->next; |
| } |
| } |
| |
| /** |
| * gst_element_get_compatible_pad_template: |
| * @element: (transfer none): a #GstElement to get a compatible pad template for |
| * @compattempl: (transfer none): the #GstPadTemplate to find a compatible |
| * template for |
| * |
| * Retrieves a pad template from @element that is compatible with @compattempl. |
| * Pads from compatible templates can be linked together. |
| * |
| * Returns: (transfer none) (nullable): a compatible #GstPadTemplate, |
| * or %NULL if none was found. No unreferencing is necessary. |
| */ |
| GstPadTemplate * |
| gst_element_get_compatible_pad_template (GstElement * element, |
| GstPadTemplate * compattempl) |
| { |
| GstPadTemplate *newtempl = NULL; |
| GList *padlist; |
| GstElementClass *class; |
| gboolean compatible; |
| |
| g_return_val_if_fail (element != NULL, NULL); |
| g_return_val_if_fail (GST_IS_ELEMENT (element), NULL); |
| g_return_val_if_fail (compattempl != NULL, NULL); |
| |
| class = GST_ELEMENT_GET_CLASS (element); |
| |
| padlist = gst_element_class_get_pad_template_list (class); |
| |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "Looking for a suitable pad template in %s out of %d templates...", |
| GST_ELEMENT_NAME (element), g_list_length (padlist)); |
| |
| while (padlist) { |
| GstPadTemplate *padtempl = (GstPadTemplate *) padlist->data; |
| |
| /* Ignore name |
| * Ignore presence |
| * Check direction (must be opposite) |
| * Check caps |
| */ |
| GST_CAT_LOG (GST_CAT_CAPS, |
| "checking pad template %s", padtempl->name_template); |
| if (padtempl->direction != compattempl->direction) { |
| GST_CAT_DEBUG (GST_CAT_CAPS, |
| "compatible direction: found %s pad template \"%s\"", |
| padtempl->direction == GST_PAD_SRC ? "src" : "sink", |
| padtempl->name_template); |
| |
| GST_CAT_DEBUG (GST_CAT_CAPS, |
| "intersecting %" GST_PTR_FORMAT, GST_PAD_TEMPLATE_CAPS (compattempl)); |
| GST_CAT_DEBUG (GST_CAT_CAPS, |
| "..and %" GST_PTR_FORMAT, GST_PAD_TEMPLATE_CAPS (padtempl)); |
| |
| compatible = gst_caps_can_intersect (GST_PAD_TEMPLATE_CAPS (compattempl), |
| GST_PAD_TEMPLATE_CAPS (padtempl)); |
| |
| GST_CAT_DEBUG (GST_CAT_CAPS, "caps are %scompatible", |
| (compatible ? "" : "not ")); |
| |
| if (compatible) { |
| newtempl = padtempl; |
| break; |
| } |
| } |
| |
| padlist = g_list_next (padlist); |
| } |
| if (newtempl) |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "Returning new pad template %p", newtempl); |
| else |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "No compatible pad template found"); |
| |
| return newtempl; |
| } |
| |
| /** |
| * gst_element_get_pad_from_template: |
| * @element: (transfer none): a #GstElement. |
| * @templ: (transfer none): a #GstPadTemplate belonging to @element. |
| * |
| * Gets a pad from @element described by @templ. If the presence of @templ is |
| * #GST_PAD_REQUEST, requests a new pad. Can return %NULL for #GST_PAD_SOMETIMES |
| * templates. |
| * |
| * Returns: (transfer full) (nullable): the #GstPad, or %NULL if one |
| * could not be found or created. |
| */ |
| static GstPad * |
| gst_element_get_pad_from_template (GstElement * element, GstPadTemplate * templ) |
| { |
| GstPad *ret = NULL; |
| GstPadPresence presence; |
| |
| /* If this function is ever exported, we need check the validity of `element' |
| * and `templ', and to make sure the template actually belongs to the |
| * element. */ |
| |
| presence = GST_PAD_TEMPLATE_PRESENCE (templ); |
| |
| switch (presence) { |
| case GST_PAD_ALWAYS: |
| case GST_PAD_SOMETIMES: |
| ret = gst_element_get_static_pad (element, templ->name_template); |
| if (!ret && presence == GST_PAD_ALWAYS) |
| g_warning |
| ("Element %s has an ALWAYS template %s, but no pad of the same name", |
| GST_OBJECT_NAME (element), templ->name_template); |
| break; |
| |
| case GST_PAD_REQUEST: |
| ret = gst_element_request_pad (element, templ, NULL, NULL); |
| break; |
| } |
| |
| return ret; |
| } |
| |
| /* |
| * gst_element_request_compatible_pad: |
| * @element: a #GstElement. |
| * @templ: the #GstPadTemplate to which the new pad should be able to link. |
| * |
| * Requests a pad from @element. The returned pad should be unlinked and |
| * compatible with @templ. Might return an existing pad, or request a new one. |
| * |
| * Returns: (nullable): a #GstPad, or %NULL if one could not be found |
| * or created. |
| */ |
| static GstPad * |
| gst_element_request_compatible_pad (GstElement * element, |
| GstPadTemplate * templ) |
| { |
| GstPadTemplate *templ_new; |
| GstPad *pad = NULL; |
| |
| g_return_val_if_fail (GST_IS_ELEMENT (element), NULL); |
| g_return_val_if_fail (GST_IS_PAD_TEMPLATE (templ), NULL); |
| |
| /* FIXME: should really loop through the templates, testing each for |
| * compatibility and pad availability. */ |
| templ_new = gst_element_get_compatible_pad_template (element, templ); |
| if (templ_new) |
| pad = gst_element_get_pad_from_template (element, templ_new); |
| |
| /* This can happen for non-request pads. No need to unref. */ |
| if (pad && GST_PAD_PEER (pad)) |
| pad = NULL; |
| |
| return pad; |
| } |
| |
| /* |
| * Checks if the source pad and the sink pad can be linked. |
| * Both @srcpad and @sinkpad must be unlinked and have a parent. |
| */ |
| static gboolean |
| gst_pad_check_link (GstPad * srcpad, GstPad * sinkpad) |
| { |
| /* generic checks */ |
| g_return_val_if_fail (GST_IS_PAD (srcpad), FALSE); |
| g_return_val_if_fail (GST_IS_PAD (sinkpad), FALSE); |
| |
| GST_CAT_INFO (GST_CAT_PADS, "trying to link %s:%s and %s:%s", |
| GST_DEBUG_PAD_NAME (srcpad), GST_DEBUG_PAD_NAME (sinkpad)); |
| |
| if (GST_PAD_PEER (srcpad) != NULL) { |
| GST_CAT_INFO (GST_CAT_PADS, "Source pad %s:%s has a peer, failed", |
| GST_DEBUG_PAD_NAME (srcpad)); |
| return FALSE; |
| } |
| if (GST_PAD_PEER (sinkpad) != NULL) { |
| GST_CAT_INFO (GST_CAT_PADS, "Sink pad %s:%s has a peer, failed", |
| GST_DEBUG_PAD_NAME (sinkpad)); |
| return FALSE; |
| } |
| if (!GST_PAD_IS_SRC (srcpad)) { |
| GST_CAT_INFO (GST_CAT_PADS, "Src pad %s:%s is not source pad, failed", |
| GST_DEBUG_PAD_NAME (srcpad)); |
| return FALSE; |
| } |
| if (!GST_PAD_IS_SINK (sinkpad)) { |
| GST_CAT_INFO (GST_CAT_PADS, "Sink pad %s:%s is not sink pad, failed", |
| GST_DEBUG_PAD_NAME (sinkpad)); |
| return FALSE; |
| } |
| if (GST_PAD_PARENT (srcpad) == NULL) { |
| GST_CAT_INFO (GST_CAT_PADS, "Src pad %s:%s has no parent, failed", |
| GST_DEBUG_PAD_NAME (srcpad)); |
| return FALSE; |
| } |
| if (GST_PAD_PARENT (sinkpad) == NULL) { |
| GST_CAT_INFO (GST_CAT_PADS, "Sink pad %s:%s has no parent, failed", |
| GST_DEBUG_PAD_NAME (srcpad)); |
| return FALSE; |
| } |
| |
| return TRUE; |
| } |
| |
| /** |
| * gst_element_get_compatible_pad: |
| * @element: (transfer none): a #GstElement in which the pad should be found. |
| * @pad: (transfer none): the #GstPad to find a compatible one for. |
| * @caps: (allow-none): the #GstCaps to use as a filter. |
| * |
| * Looks for an unlinked pad to which the given pad can link. It is not |
| * guaranteed that linking the pads will work, though it should work in most |
| * cases. |
| * |
| * This function will first attempt to find a compatible unlinked ALWAYS pad, |
| * and if none can be found, it will request a compatible REQUEST pad by looking |
| * at the templates of @element. |
| * |
| * Returns: (transfer full) (nullable): the #GstPad to which a link |
| * can be made, or %NULL if one cannot be found. gst_object_unref() |
| * after usage. |
| */ |
| GstPad * |
| gst_element_get_compatible_pad (GstElement * element, GstPad * pad, |
| GstCaps * caps) |
| { |
| GstIterator *pads; |
| GstPadTemplate *templ; |
| GstCaps *templcaps; |
| GstPad *foundpad = NULL; |
| gboolean done; |
| GValue padptr = { 0, }; |
| |
| g_return_val_if_fail (GST_IS_ELEMENT (element), NULL); |
| g_return_val_if_fail (GST_IS_PAD (pad), NULL); |
| |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "finding pad in %s compatible with %s:%s", |
| GST_ELEMENT_NAME (element), GST_DEBUG_PAD_NAME (pad)); |
| |
| g_return_val_if_fail (GST_PAD_PEER (pad) == NULL, NULL); |
| |
| done = FALSE; |
| |
| /* try to get an existing unlinked pad */ |
| if (GST_PAD_IS_SRC (pad)) { |
| pads = gst_element_iterate_sink_pads (element); |
| } else if (GST_PAD_IS_SINK (pad)) { |
| pads = gst_element_iterate_src_pads (element); |
| } else { |
| pads = gst_element_iterate_pads (element); |
| } |
| |
| while (!done) { |
| switch (gst_iterator_next (pads, &padptr)) { |
| case GST_ITERATOR_OK: |
| { |
| GstPad *peer; |
| GstPad *current; |
| GstPad *srcpad; |
| GstPad *sinkpad; |
| |
| current = g_value_get_object (&padptr); |
| |
| GST_CAT_LOG (GST_CAT_ELEMENT_PADS, "examining pad %s:%s", |
| GST_DEBUG_PAD_NAME (current)); |
| |
| if (GST_PAD_IS_SRC (current)) { |
| srcpad = current; |
| sinkpad = pad; |
| } else { |
| srcpad = pad; |
| sinkpad = current; |
| } |
| peer = gst_pad_get_peer (current); |
| |
| if (peer == NULL && gst_pad_check_link (srcpad, sinkpad)) { |
| GstCaps *temp, *intersection; |
| gboolean compatible; |
| |
| /* Now check if the two pads' caps are compatible */ |
| temp = gst_pad_query_caps (pad, NULL); |
| if (caps) { |
| intersection = gst_caps_intersect (temp, caps); |
| gst_caps_unref (temp); |
| } else { |
| intersection = temp; |
| } |
| |
| temp = gst_pad_query_caps (current, NULL); |
| compatible = gst_caps_can_intersect (temp, intersection); |
| gst_caps_unref (temp); |
| gst_caps_unref (intersection); |
| |
| if (compatible) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "found existing unlinked compatible pad %s:%s", |
| GST_DEBUG_PAD_NAME (current)); |
| gst_iterator_free (pads); |
| |
| current = gst_object_ref (current); |
| g_value_unset (&padptr); |
| |
| return current; |
| } else { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "incompatible pads"); |
| } |
| } else { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "already linked or cannot be linked (peer = %p)", peer); |
| } |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "unreffing pads"); |
| |
| g_value_reset (&padptr); |
| if (peer) |
| gst_object_unref (peer); |
| break; |
| } |
| case GST_ITERATOR_DONE: |
| done = TRUE; |
| break; |
| case GST_ITERATOR_RESYNC: |
| gst_iterator_resync (pads); |
| break; |
| case GST_ITERATOR_ERROR: |
| g_assert_not_reached (); |
| break; |
| } |
| } |
| g_value_unset (&padptr); |
| gst_iterator_free (pads); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_ELEMENT_PADS, element, |
| "Could not find a compatible unlinked always pad to link to %s:%s, now checking request pads", |
| GST_DEBUG_PAD_NAME (pad)); |
| |
| /* try to create a new one */ |
| /* requesting is a little crazy, we need a template. Let's create one */ |
| /* FIXME: why not gst_pad_get_pad_template (pad); */ |
| templcaps = gst_pad_query_caps (pad, NULL); |
| templ = gst_pad_template_new ((gchar *) GST_PAD_NAME (pad), |
| GST_PAD_DIRECTION (pad), GST_PAD_ALWAYS, templcaps); |
| gst_caps_unref (templcaps); |
| |
| foundpad = gst_element_request_compatible_pad (element, templ); |
| gst_object_unref (templ); |
| |
| if (foundpad) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "found existing request pad %s:%s", GST_DEBUG_PAD_NAME (foundpad)); |
| return foundpad; |
| } |
| |
| GST_CAT_INFO_OBJECT (GST_CAT_ELEMENT_PADS, element, |
| "Could not find a compatible pad to link to %s:%s", |
| GST_DEBUG_PAD_NAME (pad)); |
| return NULL; |
| } |
| |
| /** |
| * gst_element_state_get_name: |
| * @state: a #GstState to get the name of. |
| * |
| * Gets a string representing the given state. |
| * |
| * Returns: (transfer none): a string with the name of the state. |
| */ |
| const gchar * |
| gst_element_state_get_name (GstState state) |
| { |
| switch (state) { |
| case GST_STATE_VOID_PENDING: |
| return "VOID_PENDING"; |
| case GST_STATE_NULL: |
| return "NULL"; |
| case GST_STATE_READY: |
| return "READY"; |
| case GST_STATE_PLAYING: |
| return "PLAYING"; |
| case GST_STATE_PAUSED: |
| return "PAUSED"; |
| default: |
| /* This is a memory leak */ |
| return g_strdup_printf ("UNKNOWN!(%d)", state); |
| } |
| } |
| |
| /** |
| * gst_element_state_change_return_get_name: |
| * @state_ret: a #GstStateChangeReturn to get the name of. |
| * |
| * Gets a string representing the given state change result. |
| * |
| * Returns: (transfer none): a string with the name of the state |
| * result. |
| */ |
| const gchar * |
| gst_element_state_change_return_get_name (GstStateChangeReturn state_ret) |
| { |
| switch (state_ret) { |
| case GST_STATE_CHANGE_FAILURE: |
| return "FAILURE"; |
| case GST_STATE_CHANGE_SUCCESS: |
| return "SUCCESS"; |
| case GST_STATE_CHANGE_ASYNC: |
| return "ASYNC"; |
| case GST_STATE_CHANGE_NO_PREROLL: |
| return "NO PREROLL"; |
| default: |
| /* This is a memory leak */ |
| return g_strdup_printf ("UNKNOWN!(%d)", state_ret); |
| } |
| } |
| |
| |
| static gboolean |
| gst_element_factory_can_accept_all_caps_in_direction (GstElementFactory * |
| factory, const GstCaps * caps, GstPadDirection direction) |
| { |
| GList *templates; |
| |
| g_return_val_if_fail (factory != NULL, FALSE); |
| g_return_val_if_fail (caps != NULL, FALSE); |
| |
| templates = factory->staticpadtemplates; |
| |
| while (templates) { |
| GstStaticPadTemplate *template = (GstStaticPadTemplate *) templates->data; |
| |
| if (template->direction == direction) { |
| GstCaps *templcaps = gst_static_caps_get (&template->static_caps); |
| |
| if (gst_caps_is_always_compatible (caps, templcaps)) { |
| gst_caps_unref (templcaps); |
| return TRUE; |
| } |
| gst_caps_unref (templcaps); |
| } |
| templates = g_list_next (templates); |
| } |
| |
| return FALSE; |
| } |
| |
| static gboolean |
| gst_element_factory_can_accept_any_caps_in_direction (GstElementFactory * |
| factory, const GstCaps * caps, GstPadDirection direction) |
| { |
| GList *templates; |
| |
| g_return_val_if_fail (factory != NULL, FALSE); |
| g_return_val_if_fail (caps != NULL, FALSE); |
| |
| templates = factory->staticpadtemplates; |
| |
| while (templates) { |
| GstStaticPadTemplate *template = (GstStaticPadTemplate *) templates->data; |
| |
| if (template->direction == direction) { |
| GstCaps *templcaps = gst_static_caps_get (&template->static_caps); |
| |
| if (gst_caps_can_intersect (caps, templcaps)) { |
| gst_caps_unref (templcaps); |
| return TRUE; |
| } |
| gst_caps_unref (templcaps); |
| } |
| templates = g_list_next (templates); |
| } |
| |
| return FALSE; |
| } |
| |
| /** |
| * gst_element_factory_can_sink_all_caps: |
| * @factory: factory to query |
| * @caps: the caps to check |
| * |
| * Checks if the factory can sink all possible capabilities. |
| * |
| * Returns: %TRUE if the caps are fully compatible. |
| */ |
| gboolean |
| gst_element_factory_can_sink_all_caps (GstElementFactory * factory, |
| const GstCaps * caps) |
| { |
| return gst_element_factory_can_accept_all_caps_in_direction (factory, caps, |
| GST_PAD_SINK); |
| } |
| |
| /** |
| * gst_element_factory_can_src_all_caps: |
| * @factory: factory to query |
| * @caps: the caps to check |
| * |
| * Checks if the factory can src all possible capabilities. |
| * |
| * Returns: %TRUE if the caps are fully compatible. |
| */ |
| gboolean |
| gst_element_factory_can_src_all_caps (GstElementFactory * factory, |
| const GstCaps * caps) |
| { |
| return gst_element_factory_can_accept_all_caps_in_direction (factory, caps, |
| GST_PAD_SRC); |
| } |
| |
| /** |
| * gst_element_factory_can_sink_any_caps: |
| * @factory: factory to query |
| * @caps: the caps to check |
| * |
| * Checks if the factory can sink any possible capability. |
| * |
| * Returns: %TRUE if the caps have a common subset. |
| */ |
| gboolean |
| gst_element_factory_can_sink_any_caps (GstElementFactory * factory, |
| const GstCaps * caps) |
| { |
| return gst_element_factory_can_accept_any_caps_in_direction (factory, caps, |
| GST_PAD_SINK); |
| } |
| |
| /** |
| * gst_element_factory_can_src_any_caps: |
| * @factory: factory to query |
| * @caps: the caps to check |
| * |
| * Checks if the factory can src any possible capability. |
| * |
| * Returns: %TRUE if the caps have a common subset. |
| */ |
| gboolean |
| gst_element_factory_can_src_any_caps (GstElementFactory * factory, |
| const GstCaps * caps) |
| { |
| return gst_element_factory_can_accept_any_caps_in_direction (factory, caps, |
| GST_PAD_SRC); |
| } |
| |
| /* if return val is true, *direct_child is a caller-owned ref on the direct |
| * child of ancestor that is part of object's ancestry */ |
| static gboolean |
| object_has_ancestor (GstObject * object, GstObject * ancestor, |
| GstObject ** direct_child) |
| { |
| GstObject *child, *parent; |
| |
| if (direct_child) |
| *direct_child = NULL; |
| |
| child = gst_object_ref (object); |
| parent = gst_object_get_parent (object); |
| |
| while (parent) { |
| if (ancestor == parent) { |
| if (direct_child) |
| *direct_child = child; |
| else |
| gst_object_unref (child); |
| gst_object_unref (parent); |
| return TRUE; |
| } |
| |
| gst_object_unref (child); |
| child = parent; |
| parent = gst_object_get_parent (parent); |
| } |
| |
| gst_object_unref (child); |
| |
| return FALSE; |
| } |
| |
| /* caller owns return */ |
| static GstObject * |
| find_common_root (GstObject * o1, GstObject * o2) |
| { |
| GstObject *top = o1; |
| GstObject *kid1, *kid2; |
| GstObject *root = NULL; |
| |
| while (GST_OBJECT_PARENT (top)) |
| top = GST_OBJECT_PARENT (top); |
| |
| /* the itsy-bitsy spider... */ |
| |
| if (!object_has_ancestor (o2, top, &kid2)) |
| return NULL; |
| |
| root = gst_object_ref (top); |
| while (TRUE) { |
| if (!object_has_ancestor (o1, kid2, &kid1)) { |
| gst_object_unref (kid2); |
| return root; |
| } |
| root = kid2; |
| if (!object_has_ancestor (o2, kid1, &kid2)) { |
| gst_object_unref (kid1); |
| return root; |
| } |
| root = kid1; |
| } |
| } |
| |
| /* caller does not own return */ |
| static GstPad * |
| ghost_up (GstElement * e, GstPad * pad) |
| { |
| static gint ghost_pad_index = 0; |
| GstPad *gpad; |
| gchar *name; |
| GstState current; |
| GstState next; |
| GstObject *parent = GST_OBJECT_PARENT (e); |
| |
| name = g_strdup_printf ("ghost%d", ghost_pad_index++); |
| gpad = gst_ghost_pad_new (name, pad); |
| g_free (name); |
| |
| GST_STATE_LOCK (e); |
| gst_element_get_state (e, ¤t, &next, 0); |
| |
| if (current > GST_STATE_READY || next == GST_STATE_PAUSED) |
| gst_pad_set_active (gpad, TRUE); |
| |
| if (!gst_element_add_pad ((GstElement *) parent, gpad)) { |
| g_warning ("Pad named %s already exists in element %s\n", |
| GST_OBJECT_NAME (gpad), GST_OBJECT_NAME (parent)); |
| gst_object_unref ((GstObject *) gpad); |
| GST_STATE_UNLOCK (e); |
| return NULL; |
| } |
| GST_STATE_UNLOCK (e); |
| |
| return gpad; |
| } |
| |
| static void |
| remove_pad (gpointer ppad, gpointer unused) |
| { |
| GstPad *pad = ppad; |
| |
| if (!gst_element_remove_pad ((GstElement *) GST_OBJECT_PARENT (pad), pad)) |
| g_warning ("Couldn't remove pad %s from element %s", |
| GST_OBJECT_NAME (pad), GST_OBJECT_NAME (GST_OBJECT_PARENT (pad))); |
| } |
| |
| static gboolean |
| prepare_link_maybe_ghosting (GstPad ** src, GstPad ** sink, |
| GSList ** pads_created) |
| { |
| GstObject *root; |
| GstObject *e1, *e2; |
| GSList *pads_created_local = NULL; |
| |
| g_assert (pads_created); |
| |
| e1 = GST_OBJECT_PARENT (*src); |
| e2 = GST_OBJECT_PARENT (*sink); |
| |
| if (G_UNLIKELY (e1 == NULL)) { |
| GST_WARNING ("Trying to ghost a pad that doesn't have a parent: %" |
| GST_PTR_FORMAT, *src); |
| return FALSE; |
| } |
| if (G_UNLIKELY (e2 == NULL)) { |
| GST_WARNING ("Trying to ghost a pad that doesn't have a parent: %" |
| GST_PTR_FORMAT, *sink); |
| return FALSE; |
| } |
| |
| if (GST_OBJECT_PARENT (e1) == GST_OBJECT_PARENT (e2)) { |
| GST_CAT_INFO (GST_CAT_PADS, "%s and %s in same bin, no need for ghost pads", |
| GST_OBJECT_NAME (e1), GST_OBJECT_NAME (e2)); |
| return TRUE; |
| } |
| |
| GST_CAT_INFO (GST_CAT_PADS, "%s and %s not in same bin, making ghost pads", |
| GST_OBJECT_NAME (e1), GST_OBJECT_NAME (e2)); |
| |
| /* we need to setup some ghost pads */ |
| root = find_common_root (e1, e2); |
| if (!root) { |
| if (GST_OBJECT_PARENT (e1) == NULL) |
| g_warning ("Trying to link elements %s and %s that don't share a common " |
| "ancestor: %s hasn't been added to a bin or pipeline, but %s is in %s", |
| GST_ELEMENT_NAME (e1), GST_ELEMENT_NAME (e2), |
| GST_ELEMENT_NAME (e1), GST_ELEMENT_NAME (e2), |
| GST_ELEMENT_NAME (GST_OBJECT_PARENT (e2))); |
| else if (GST_OBJECT_PARENT (e2) == NULL) |
| g_warning ("Trying to link elements %s and %s that don't share a common " |
| "ancestor: %s hasn't been added to a bin or pipeline, and %s is in %s", |
| GST_ELEMENT_NAME (e1), GST_ELEMENT_NAME (e2), |
| GST_ELEMENT_NAME (e2), GST_ELEMENT_NAME (e1), |
| GST_ELEMENT_NAME (GST_OBJECT_PARENT (e1))); |
| else |
| g_warning ("Trying to link elements %s and %s that don't share a common " |
| "ancestor: %s is in %s, and %s is in %s", |
| GST_ELEMENT_NAME (e1), GST_ELEMENT_NAME (e2), |
| GST_ELEMENT_NAME (e1), GST_ELEMENT_NAME (GST_OBJECT_PARENT (e1)), |
| GST_ELEMENT_NAME (e2), GST_ELEMENT_NAME (GST_OBJECT_PARENT (e2))); |
| return FALSE; |
| } |
| |
| while (GST_OBJECT_PARENT (e1) != root) { |
| *src = ghost_up ((GstElement *) e1, *src); |
| if (!*src) |
| goto cleanup_fail; |
| e1 = GST_OBJECT_PARENT (*src); |
| pads_created_local = g_slist_prepend (pads_created_local, *src); |
| } |
| while (GST_OBJECT_PARENT (e2) != root) { |
| *sink = ghost_up ((GstElement *) e2, *sink); |
| if (!*sink) |
| goto cleanup_fail; |
| e2 = GST_OBJECT_PARENT (*sink); |
| pads_created_local = g_slist_prepend (pads_created_local, *sink); |
| } |
| |
| gst_object_unref (root); |
| *pads_created = g_slist_concat (*pads_created, pads_created_local); |
| return TRUE; |
| |
| cleanup_fail: |
| gst_object_unref (root); |
| g_slist_foreach (pads_created_local, remove_pad, NULL); |
| g_slist_free (pads_created_local); |
| return FALSE; |
| } |
| |
| static gboolean |
| pad_link_maybe_ghosting (GstPad * src, GstPad * sink, GstPadLinkCheck flags) |
| { |
| GSList *pads_created = NULL; |
| gboolean ret; |
| |
| if (!prepare_link_maybe_ghosting (&src, &sink, &pads_created)) { |
| ret = FALSE; |
| } else { |
| ret = (gst_pad_link_full (src, sink, flags) == GST_PAD_LINK_OK); |
| } |
| |
| if (!ret) { |
| g_slist_foreach (pads_created, remove_pad, NULL); |
| } |
| g_slist_free (pads_created); |
| |
| return ret; |
| } |
| |
| static void |
| release_and_unref_pad (GstElement * element, GstPad * pad, gboolean requestpad) |
| { |
| if (pad) { |
| if (requestpad) |
| gst_element_release_request_pad (element, pad); |
| gst_object_unref (pad); |
| } |
| } |
| |
| /** |
| * gst_element_link_pads_full: |
| * @src: a #GstElement containing the source pad. |
| * @srcpadname: (allow-none): the name of the #GstPad in source element |
| * or %NULL for any pad. |
| * @dest: (transfer none): the #GstElement containing the destination pad. |
| * @destpadname: (allow-none): the name of the #GstPad in destination element, |
| * or %NULL for any pad. |
| * @flags: the #GstPadLinkCheck to be performed when linking pads. |
| * |
| * Links the two named pads of the source and destination elements. |
| * Side effect is that if one of the pads has no parent, it becomes a |
| * child of the parent of the other element. If they have different |
| * parents, the link fails. |
| * |
| * Calling gst_element_link_pads_full() with @flags == %GST_PAD_LINK_CHECK_DEFAULT |
| * is the same as calling gst_element_link_pads() and the recommended way of |
| * linking pads with safety checks applied. |
| * |
| * This is a convenience function for gst_pad_link_full(). |
| * |
| * Returns: %TRUE if the pads could be linked, %FALSE otherwise. |
| */ |
| gboolean |
| gst_element_link_pads_full (GstElement * src, const gchar * srcpadname, |
| GstElement * dest, const gchar * destpadname, GstPadLinkCheck flags) |
| { |
| const GList *srcpads, *destpads, *srctempls, *desttempls, *l; |
| GstPad *srcpad, *destpad; |
| GstPadTemplate *srctempl, *desttempl; |
| GstElementClass *srcclass, *destclass; |
| gboolean srcrequest, destrequest; |
| |
| /* checks */ |
| g_return_val_if_fail (GST_IS_ELEMENT (src), FALSE); |
| g_return_val_if_fail (GST_IS_ELEMENT (dest), FALSE); |
| |
| GST_CAT_INFO (GST_CAT_ELEMENT_PADS, |
| "trying to link element %s:%s to element %s:%s", GST_ELEMENT_NAME (src), |
| srcpadname ? srcpadname : "(any)", GST_ELEMENT_NAME (dest), |
| destpadname ? destpadname : "(any)"); |
| |
| srcrequest = FALSE; |
| destrequest = FALSE; |
| |
| /* get a src pad */ |
| if (srcpadname) { |
| /* name specified, look it up */ |
| if (!(srcpad = gst_element_get_static_pad (src, srcpadname))) { |
| if ((srcpad = gst_element_get_request_pad (src, srcpadname))) |
| srcrequest = TRUE; |
| } |
| if (!srcpad) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "no pad %s:%s", |
| GST_ELEMENT_NAME (src), srcpadname); |
| return FALSE; |
| } else { |
| if (!(GST_PAD_DIRECTION (srcpad) == GST_PAD_SRC)) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "pad %s:%s is no src pad", |
| GST_DEBUG_PAD_NAME (srcpad)); |
| release_and_unref_pad (src, srcpad, srcrequest); |
| return FALSE; |
| } |
| if (GST_PAD_PEER (srcpad) != NULL) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "pad %s:%s is already linked to %s:%s", GST_DEBUG_PAD_NAME (srcpad), |
| GST_DEBUG_PAD_NAME (GST_PAD_PEER (srcpad))); |
| /* already linked request pads look like static pads, so the request pad |
| * was never requested a second time above, so no need to release it */ |
| gst_object_unref (srcpad); |
| return FALSE; |
| } |
| } |
| srcpads = NULL; |
| } else { |
| /* no name given, get the first available pad */ |
| GST_OBJECT_LOCK (src); |
| srcpads = GST_ELEMENT_PADS (src); |
| srcpad = srcpads ? GST_PAD_CAST (srcpads->data) : NULL; |
| if (srcpad) |
| gst_object_ref (srcpad); |
| GST_OBJECT_UNLOCK (src); |
| } |
| |
| /* get a destination pad */ |
| if (destpadname) { |
| /* name specified, look it up */ |
| if (!(destpad = gst_element_get_static_pad (dest, destpadname))) { |
| if ((destpad = gst_element_get_request_pad (dest, destpadname))) |
| destrequest = TRUE; |
| } |
| if (!destpad) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "no pad %s:%s", |
| GST_ELEMENT_NAME (dest), destpadname); |
| release_and_unref_pad (src, srcpad, srcrequest); |
| return FALSE; |
| } else { |
| if (!(GST_PAD_DIRECTION (destpad) == GST_PAD_SINK)) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "pad %s:%s is no sink pad", |
| GST_DEBUG_PAD_NAME (destpad)); |
| release_and_unref_pad (src, srcpad, srcrequest); |
| release_and_unref_pad (dest, destpad, destrequest); |
| return FALSE; |
| } |
| if (GST_PAD_PEER (destpad) != NULL) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "pad %s:%s is already linked to %s:%s", |
| GST_DEBUG_PAD_NAME (destpad), |
| GST_DEBUG_PAD_NAME (GST_PAD_PEER (destpad))); |
| release_and_unref_pad (src, srcpad, srcrequest); |
| /* already linked request pads look like static pads, so the request pad |
| * was never requested a second time above, so no need to release it */ |
| gst_object_unref (destpad); |
| return FALSE; |
| } |
| } |
| destpads = NULL; |
| } else { |
| /* no name given, get the first available pad */ |
| GST_OBJECT_LOCK (dest); |
| destpads = GST_ELEMENT_PADS (dest); |
| destpad = destpads ? GST_PAD_CAST (destpads->data) : NULL; |
| if (destpad) |
| gst_object_ref (destpad); |
| GST_OBJECT_UNLOCK (dest); |
| } |
| |
| if (srcpadname && destpadname) { |
| gboolean result; |
| |
| /* two explicitly specified pads */ |
| result = pad_link_maybe_ghosting (srcpad, destpad, flags); |
| |
| if (result) { |
| gst_object_unref (srcpad); |
| gst_object_unref (destpad); |
| } else { |
| release_and_unref_pad (src, srcpad, srcrequest); |
| release_and_unref_pad (dest, destpad, destrequest); |
| } |
| return result; |
| } |
| |
| if (srcpad) { |
| /* loop through the allowed pads in the source, trying to find a |
| * compatible destination pad */ |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "looping through allowed src and dest pads"); |
| do { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "trying src pad %s:%s", |
| GST_DEBUG_PAD_NAME (srcpad)); |
| if ((GST_PAD_DIRECTION (srcpad) == GST_PAD_SRC) && |
| (GST_PAD_PEER (srcpad) == NULL)) { |
| gboolean temprequest = FALSE; |
| GstPad *temp; |
| |
| if (destpadname) { |
| temp = destpad; |
| gst_object_ref (temp); |
| } else { |
| temp = gst_element_get_compatible_pad (dest, srcpad, NULL); |
| if (temp && GST_PAD_PAD_TEMPLATE (temp) |
| && GST_PAD_TEMPLATE_PRESENCE (GST_PAD_PAD_TEMPLATE (temp)) == |
| GST_PAD_REQUEST) { |
| temprequest = TRUE; |
| } |
| } |
| |
| if (temp && pad_link_maybe_ghosting (srcpad, temp, flags)) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "linked pad %s:%s to pad %s:%s", |
| GST_DEBUG_PAD_NAME (srcpad), GST_DEBUG_PAD_NAME (temp)); |
| if (destpad) |
| gst_object_unref (destpad); |
| gst_object_unref (srcpad); |
| gst_object_unref (temp); |
| return TRUE; |
| } |
| |
| if (temp) { |
| if (temprequest) |
| gst_element_release_request_pad (dest, temp); |
| gst_object_unref (temp); |
| } |
| } |
| /* find a better way for this mess */ |
| if (srcpads) { |
| srcpads = g_list_next (srcpads); |
| if (srcpads) { |
| gst_object_unref (srcpad); |
| srcpad = GST_PAD_CAST (srcpads->data); |
| gst_object_ref (srcpad); |
| } |
| } |
| } while (srcpads); |
| } |
| if (srcpadname) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "no link possible from %s:%s to %s", |
| GST_DEBUG_PAD_NAME (srcpad), GST_ELEMENT_NAME (dest)); |
| /* no need to release any request pad as both src- and destpadname must be |
| * set to end up here, but this case has already been taken care of above */ |
| if (destpad) |
| gst_object_unref (destpad); |
| destpad = NULL; |
| } |
| if (srcpad) { |
| release_and_unref_pad (src, srcpad, srcrequest); |
| srcpad = NULL; |
| } |
| |
| if (destpad) { |
| /* loop through the existing pads in the destination */ |
| do { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "trying dest pad %s:%s", |
| GST_DEBUG_PAD_NAME (destpad)); |
| if ((GST_PAD_DIRECTION (destpad) == GST_PAD_SINK) && |
| (GST_PAD_PEER (destpad) == NULL)) { |
| GstPad *temp = gst_element_get_compatible_pad (src, destpad, NULL); |
| gboolean temprequest = FALSE; |
| |
| if (temp && GST_PAD_PAD_TEMPLATE (temp) |
| && GST_PAD_TEMPLATE_PRESENCE (GST_PAD_PAD_TEMPLATE (temp)) == |
| GST_PAD_REQUEST) { |
| temprequest = TRUE; |
| } |
| |
| if (temp && pad_link_maybe_ghosting (temp, destpad, flags)) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "linked pad %s:%s to pad %s:%s", |
| GST_DEBUG_PAD_NAME (temp), GST_DEBUG_PAD_NAME (destpad)); |
| gst_object_unref (temp); |
| gst_object_unref (destpad); |
| return TRUE; |
| } |
| |
| release_and_unref_pad (src, temp, temprequest); |
| } |
| if (destpads) { |
| destpads = g_list_next (destpads); |
| if (destpads) { |
| gst_object_unref (destpad); |
| destpad = GST_PAD_CAST (destpads->data); |
| gst_object_ref (destpad); |
| } |
| } |
| } while (destpads); |
| } |
| |
| if (destpadname) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "no link possible from %s to %s:%s", |
| GST_ELEMENT_NAME (src), GST_DEBUG_PAD_NAME (destpad)); |
| release_and_unref_pad (dest, destpad, destrequest); |
| return FALSE; |
| } else { |
| /* no need to release any request pad as the case of unset destpatname and |
| * destpad being a requst pad has already been taken care of when looking |
| * though the destination pads above */ |
| if (destpad) { |
| gst_object_unref (destpad); |
| } |
| destpad = NULL; |
| } |
| |
| srcclass = GST_ELEMENT_GET_CLASS (src); |
| destclass = GST_ELEMENT_GET_CLASS (dest); |
| |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "we might have request pads on both sides, checking..."); |
| srctempls = gst_element_class_get_pad_template_list (srcclass); |
| desttempls = gst_element_class_get_pad_template_list (destclass); |
| |
| if (srctempls && desttempls) { |
| while (srctempls) { |
| srctempl = (GstPadTemplate *) srctempls->data; |
| if (srctempl->presence == GST_PAD_REQUEST) { |
| for (l = desttempls; l; l = l->next) { |
| desttempl = (GstPadTemplate *) l->data; |
| if (desttempl->presence == GST_PAD_REQUEST && |
| desttempl->direction != srctempl->direction) { |
| GstCaps *srccaps, *destcaps; |
| |
| srccaps = gst_pad_template_get_caps (srctempl); |
| destcaps = gst_pad_template_get_caps (desttempl); |
| if (gst_caps_is_always_compatible (srccaps, destcaps)) { |
| srcpad = |
| gst_element_request_pad (src, srctempl, |
| srctempl->name_template, NULL); |
| destpad = |
| gst_element_request_pad (dest, desttempl, |
| desttempl->name_template, NULL); |
| if (srcpad && destpad |
| && pad_link_maybe_ghosting (srcpad, destpad, flags)) { |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "linked pad %s:%s to pad %s:%s", |
| GST_DEBUG_PAD_NAME (srcpad), GST_DEBUG_PAD_NAME (destpad)); |
| gst_object_unref (srcpad); |
| gst_object_unref (destpad); |
| gst_caps_unref (srccaps); |
| gst_caps_unref (destcaps); |
| return TRUE; |
| } |
| /* it failed, so we release the request pads */ |
| if (srcpad) { |
| gst_element_release_request_pad (src, srcpad); |
| gst_object_unref (srcpad); |
| } |
| if (destpad) { |
| gst_element_release_request_pad (dest, destpad); |
| gst_object_unref (destpad); |
| } |
| } |
| gst_caps_unref (srccaps); |
| gst_caps_unref (destcaps); |
| } |
| } |
| } |
| srctempls = srctempls->next; |
| } |
| } |
| |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "no link possible from %s to %s", |
| GST_ELEMENT_NAME (src), GST_ELEMENT_NAME (dest)); |
| return FALSE; |
| } |
| |
| /** |
| * gst_element_link_pads: |
| * @src: a #GstElement containing the source pad. |
| * @srcpadname: (allow-none): the name of the #GstPad in source element |
| * or %NULL for any pad. |
| * @dest: (transfer none): the #GstElement containing the destination pad. |
| * @destpadname: (allow-none): the name of the #GstPad in destination element, |
| * or %NULL for any pad. |
| * |
| * Links the two named pads of the source and destination elements. |
| * Side effect is that if one of the pads has no parent, it becomes a |
| * child of the parent of the other element. If they have different |
| * parents, the link fails. |
| * |
| * Returns: %TRUE if the pads could be linked, %FALSE otherwise. |
| */ |
| gboolean |
| gst_element_link_pads (GstElement * src, const gchar * srcpadname, |
| GstElement * dest, const gchar * destpadname) |
| { |
| return gst_element_link_pads_full (src, srcpadname, dest, destpadname, |
| GST_PAD_LINK_CHECK_DEFAULT); |
| } |
| |
| /** |
| * gst_element_link_pads_filtered: |
| * @src: a #GstElement containing the source pad. |
| * @srcpadname: (allow-none): the name of the #GstPad in source element |
| * or %NULL for any pad. |
| * @dest: (transfer none): the #GstElement containing the destination pad. |
| * @destpadname: (allow-none): the name of the #GstPad in destination element |
| * or %NULL for any pad. |
| * @filter: (transfer none) (allow-none): the #GstCaps to filter the link, |
| * or %NULL for no filter. |
| * |
| * Links the two named pads of the source and destination elements. Side effect |
| * is that if one of the pads has no parent, it becomes a child of the parent of |
| * the other element. If they have different parents, the link fails. If @caps |
| * is not %NULL, makes sure that the caps of the link is a subset of @caps. |
| * |
| * Returns: %TRUE if the pads could be linked, %FALSE otherwise. |
| */ |
| gboolean |
| gst_element_link_pads_filtered (GstElement * src, const gchar * srcpadname, |
| GstElement * dest, const gchar * destpadname, GstCaps * filter) |
| { |
| /* checks */ |
| g_return_val_if_fail (GST_IS_ELEMENT (src), FALSE); |
| g_return_val_if_fail (GST_IS_ELEMENT (dest), FALSE); |
| g_return_val_if_fail (filter == NULL || GST_IS_CAPS (filter), FALSE); |
| |
| if (filter) { |
| GstElement *capsfilter; |
| GstObject *parent; |
| GstState state, pending; |
| gboolean lr1, lr2; |
| |
| capsfilter = gst_element_factory_make ("capsfilter", NULL); |
| if (!capsfilter) { |
| GST_ERROR ("Could not make a capsfilter"); |
| return FALSE; |
| } |
| |
| parent = gst_object_get_parent (GST_OBJECT (src)); |
| g_return_val_if_fail (GST_IS_BIN (parent), FALSE); |
| |
| gst_element_get_state (GST_ELEMENT_CAST (parent), &state, &pending, 0); |
| |
| if (!gst_bin_add (GST_BIN (parent), capsfilter)) { |
| GST_ERROR ("Could not add capsfilter"); |
| gst_object_unref (capsfilter); |
| gst_object_unref (parent); |
| return FALSE; |
| } |
| |
| if (pending != GST_STATE_VOID_PENDING) |
| state = pending; |
| |
| gst_element_set_state (capsfilter, state); |
| |
| gst_object_unref (parent); |
| |
| g_object_set (capsfilter, "caps", filter, NULL); |
| |
| lr1 = gst_element_link_pads (src, srcpadname, capsfilter, "sink"); |
| lr2 = gst_element_link_pads (capsfilter, "src", dest, destpadname); |
| if (lr1 && lr2) { |
| return TRUE; |
| } else { |
| if (!lr1) { |
| GST_INFO ("Could not link pads: %s:%s - capsfilter:sink", |
| GST_ELEMENT_NAME (src), srcpadname); |
| } else { |
| GST_INFO ("Could not link pads: capsfilter:src - %s:%s", |
| GST_ELEMENT_NAME (dest), destpadname); |
| } |
| gst_element_set_state (capsfilter, GST_STATE_NULL); |
| /* this will unlink and unref as appropriate */ |
| gst_bin_remove (GST_BIN (GST_OBJECT_PARENT (capsfilter)), capsfilter); |
| return FALSE; |
| } |
| } else { |
| if (gst_element_link_pads (src, srcpadname, dest, destpadname)) { |
| return TRUE; |
| } else { |
| GST_INFO ("Could not link pads: %s:%s - %s:%s", GST_ELEMENT_NAME (src), |
| srcpadname, GST_ELEMENT_NAME (dest), destpadname); |
| return FALSE; |
| } |
| } |
| } |
| |
| /** |
| * gst_element_link: |
| * @src: (transfer none): a #GstElement containing the source pad. |
| * @dest: (transfer none): the #GstElement containing the destination pad. |
| * |
| * Links @src to @dest. The link must be from source to |
| * destination; the other direction will not be tried. The function looks for |
| * existing pads that aren't linked yet. It will request new pads if necessary. |
| * Such pads need to be released manually when unlinking. |
| * If multiple links are possible, only one is established. |
| * |
| * Make sure you have added your elements to a bin or pipeline with |
| * gst_bin_add() before trying to link them. |
| * |
| * Returns: %TRUE if the elements could be linked, %FALSE otherwise. |
| */ |
| gboolean |
| gst_element_link (GstElement * src, GstElement * dest) |
| { |
| return gst_element_link_pads (src, NULL, dest, NULL); |
| } |
| |
| /** |
| * gst_element_link_many: |
| * @element_1: (transfer none): the first #GstElement in the link chain. |
| * @element_2: (transfer none): the second #GstElement in the link chain. |
| * @...: the %NULL-terminated list of elements to link in order. |
| * |
| * Chain together a series of elements. Uses gst_element_link(). |
| * Make sure you have added your elements to a bin or pipeline with |
| * gst_bin_add() before trying to link them. |
| * |
| * Returns: %TRUE on success, %FALSE otherwise. |
| */ |
| gboolean |
| gst_element_link_many (GstElement * element_1, GstElement * element_2, ...) |
| { |
| gboolean res = TRUE; |
| va_list args; |
| |
| g_return_val_if_fail (GST_IS_ELEMENT (element_1), FALSE); |
| g_return_val_if_fail (GST_IS_ELEMENT (element_2), FALSE); |
| |
| va_start (args, element_2); |
| |
| while (element_2) { |
| if (!gst_element_link (element_1, element_2)) { |
| res = FALSE; |
| break; |
| } |
| |
| element_1 = element_2; |
| element_2 = va_arg (args, GstElement *); |
| } |
| |
| va_end (args); |
| |
| return res; |
| } |
| |
| /** |
| * gst_element_link_filtered: |
| * @src: a #GstElement containing the source pad. |
| * @dest: (transfer none): the #GstElement containing the destination pad. |
| * @filter: (transfer none) (allow-none): the #GstCaps to filter the link, |
| * or %NULL for no filter. |
| * |
| * Links @src to @dest using the given caps as filtercaps. |
| * The link must be from source to |
| * destination; the other direction will not be tried. The function looks for |
| * existing pads that aren't linked yet. It will request new pads if necessary. |
| * If multiple links are possible, only one is established. |
| * |
| * Make sure you have added your elements to a bin or pipeline with |
| * gst_bin_add() before trying to link them. |
| * |
| * Returns: %TRUE if the pads could be linked, %FALSE otherwise. |
| */ |
| gboolean |
| gst_element_link_filtered (GstElement * src, GstElement * dest, |
| GstCaps * filter) |
| { |
| return gst_element_link_pads_filtered (src, NULL, dest, NULL, filter); |
| } |
| |
| /** |
| * gst_element_unlink_pads: |
| * @src: a (transfer none): #GstElement containing the source pad. |
| * @srcpadname: the name of the #GstPad in source element. |
| * @dest: (transfer none): a #GstElement containing the destination pad. |
| * @destpadname: the name of the #GstPad in destination element. |
| * |
| * Unlinks the two named pads of the source and destination elements. |
| * |
| * This is a convenience function for gst_pad_unlink(). |
| */ |
| void |
| gst_element_unlink_pads (GstElement * src, const gchar * srcpadname, |
| GstElement * dest, const gchar * destpadname) |
| { |
| GstPad *srcpad, *destpad; |
| gboolean srcrequest, destrequest; |
| |
| srcrequest = destrequest = FALSE; |
| |
| g_return_if_fail (src != NULL); |
| g_return_if_fail (GST_IS_ELEMENT (src)); |
| g_return_if_fail (srcpadname != NULL); |
| g_return_if_fail (dest != NULL); |
| g_return_if_fail (GST_IS_ELEMENT (dest)); |
| g_return_if_fail (destpadname != NULL); |
| |
| /* obtain the pads requested */ |
| if (!(srcpad = gst_element_get_static_pad (src, srcpadname))) |
| if ((srcpad = gst_element_get_request_pad (src, srcpadname))) |
| srcrequest = TRUE; |
| if (srcpad == NULL) { |
| GST_WARNING_OBJECT (src, "source element has no pad \"%s\"", srcpadname); |
| return; |
| } |
| if (!(destpad = gst_element_get_static_pad (dest, destpadname))) |
| if ((destpad = gst_element_get_request_pad (dest, destpadname))) |
| destrequest = TRUE; |
| if (destpad == NULL) { |
| GST_WARNING_OBJECT (dest, "destination element has no pad \"%s\"", |
| destpadname); |
| goto free_src; |
| } |
| |
| /* we're satisfied they can be unlinked, let's do it */ |
| gst_pad_unlink (srcpad, destpad); |
| |
| if (destrequest) |
| gst_element_release_request_pad (dest, destpad); |
| gst_object_unref (destpad); |
| |
| free_src: |
| if (srcrequest) |
| gst_element_release_request_pad (src, srcpad); |
| gst_object_unref (srcpad); |
| } |
| |
| /** |
| * gst_element_unlink_many: |
| * @element_1: (transfer none): the first #GstElement in the link chain. |
| * @element_2: (transfer none): the second #GstElement in the link chain. |
| * @...: the %NULL-terminated list of elements to unlink in order. |
| * |
| * Unlinks a series of elements. Uses gst_element_unlink(). |
| */ |
| void |
| gst_element_unlink_many (GstElement * element_1, GstElement * element_2, ...) |
| { |
| va_list args; |
| |
| g_return_if_fail (element_1 != NULL && element_2 != NULL); |
| g_return_if_fail (GST_IS_ELEMENT (element_1) && GST_IS_ELEMENT (element_2)); |
| |
| va_start (args, element_2); |
| |
| while (element_2) { |
| gst_element_unlink (element_1, element_2); |
| |
| element_1 = element_2; |
| element_2 = va_arg (args, GstElement *); |
| } |
| |
| va_end (args); |
| } |
| |
| /** |
| * gst_element_unlink: |
| * @src: (transfer none): the source #GstElement to unlink. |
| * @dest: (transfer none): the sink #GstElement to unlink. |
| * |
| * Unlinks all source pads of the source element with all sink pads |
| * of the sink element to which they are linked. |
| * |
| * If the link has been made using gst_element_link(), it could have created an |
| * requestpad, which has to be released using gst_element_release_request_pad(). |
| */ |
| void |
| gst_element_unlink (GstElement * src, GstElement * dest) |
| { |
| GstIterator *pads; |
| gboolean done = FALSE; |
| GValue data = { 0, }; |
| |
| g_return_if_fail (GST_IS_ELEMENT (src)); |
| g_return_if_fail (GST_IS_ELEMENT (dest)); |
| |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, "unlinking \"%s\" and \"%s\"", |
| GST_ELEMENT_NAME (src), GST_ELEMENT_NAME (dest)); |
| |
| pads = gst_element_iterate_pads (src); |
| while (!done) { |
| switch (gst_iterator_next (pads, &data)) { |
| case GST_ITERATOR_OK: |
| { |
| GstPad *pad = g_value_get_object (&data); |
| |
| if (GST_PAD_IS_SRC (pad)) { |
| GstPad *peerpad = gst_pad_get_peer (pad); |
| |
| /* see if the pad is linked and is really a pad of dest */ |
| if (peerpad) { |
| GstElement *peerelem; |
| |
| peerelem = gst_pad_get_parent_element (peerpad); |
| |
| if (peerelem == dest) { |
| gst_pad_unlink (pad, peerpad); |
| } |
| if (peerelem) |
| gst_object_unref (peerelem); |
| |
| gst_object_unref (peerpad); |
| } |
| } |
| g_value_reset (&data); |
| break; |
| } |
| case GST_ITERATOR_RESYNC: |
| gst_iterator_resync (pads); |
| break; |
| case GST_ITERATOR_DONE: |
| done = TRUE; |
| break; |
| default: |
| g_assert_not_reached (); |
| break; |
| } |
| } |
| g_value_unset (&data); |
| gst_iterator_free (pads); |
| } |
| |
| /** |
| * gst_element_query_position: |
| * @element: a #GstElement to invoke the position query on. |
| * @format: the #GstFormat requested |
| * @cur: (out) (allow-none): a location in which to store the current |
| * position, or %NULL. |
| * |
| * Queries an element (usually top-level pipeline or playbin element) for the |
| * stream position in nanoseconds. This will be a value between 0 and the |
| * stream duration (if the stream duration is known). This query will usually |
| * only work once the pipeline is prerolled (i.e. reached PAUSED or PLAYING |
| * state). The application will receive an ASYNC_DONE message on the pipeline |
| * bus when that is the case. |
| * |
| * If one repeatedly calls this function one can also create a query and reuse |
| * it in gst_element_query(). |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_element_query_position (GstElement * element, GstFormat format, |
| gint64 * cur) |
| { |
| GstQuery *query; |
| gboolean ret; |
| |
| g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE); |
| g_return_val_if_fail (format != GST_FORMAT_UNDEFINED, FALSE); |
| |
| query = gst_query_new_position (format); |
| ret = gst_element_query (element, query); |
| |
| if (ret) |
| gst_query_parse_position (query, NULL, cur); |
| |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_element_query_duration: |
| * @element: a #GstElement to invoke the duration query on. |
| * @format: the #GstFormat requested |
| * @duration: (out) (allow-none): A location in which to store the total duration, or %NULL. |
| * |
| * Queries an element (usually top-level pipeline or playbin element) for the |
| * total stream duration in nanoseconds. This query will only work once the |
| * pipeline is prerolled (i.e. reached PAUSED or PLAYING state). The application |
| * will receive an ASYNC_DONE message on the pipeline bus when that is the case. |
| * |
| * If the duration changes for some reason, you will get a DURATION_CHANGED |
| * message on the pipeline bus, in which case you should re-query the duration |
| * using this function. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_element_query_duration (GstElement * element, GstFormat format, |
| gint64 * duration) |
| { |
| GstQuery *query; |
| gboolean ret; |
| |
| g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE); |
| g_return_val_if_fail (format != GST_FORMAT_UNDEFINED, FALSE); |
| |
| query = gst_query_new_duration (format); |
| ret = gst_element_query (element, query); |
| |
| if (ret) |
| gst_query_parse_duration (query, NULL, duration); |
| |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_element_query_convert: |
| * @element: a #GstElement to invoke the convert query on. |
| * @src_format: (inout): a #GstFormat to convert from. |
| * @src_val: a value to convert. |
| * @dest_format: the #GstFormat to convert to. |
| * @dest_val: (out): a pointer to the result. |
| * |
| * Queries an element to convert @src_val in @src_format to @dest_format. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_element_query_convert (GstElement * element, GstFormat src_format, |
| gint64 src_val, GstFormat dest_format, gint64 * dest_val) |
| { |
| GstQuery *query; |
| gboolean ret; |
| |
| g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE); |
| g_return_val_if_fail (dest_format != GST_FORMAT_UNDEFINED, FALSE); |
| g_return_val_if_fail (dest_val != NULL, FALSE); |
| |
| if (dest_format == src_format || src_val == -1) { |
| *dest_val = src_val; |
| return TRUE; |
| } |
| |
| query = gst_query_new_convert (src_format, src_val, dest_format); |
| ret = gst_element_query (element, query); |
| |
| if (ret) |
| gst_query_parse_convert (query, NULL, NULL, NULL, dest_val); |
| |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_element_seek_simple: |
| * @element: a #GstElement to seek on |
| * @format: a #GstFormat to execute the seek in, such as #GST_FORMAT_TIME |
| * @seek_flags: seek options; playback applications will usually want to use |
| * GST_SEEK_FLAG_FLUSH | GST_SEEK_FLAG_KEY_UNIT here |
| * @seek_pos: position to seek to (relative to the start); if you are doing |
| * a seek in #GST_FORMAT_TIME this value is in nanoseconds - |
| * multiply with #GST_SECOND to convert seconds to nanoseconds or |
| * with #GST_MSECOND to convert milliseconds to nanoseconds. |
| * |
| * Simple API to perform a seek on the given element, meaning it just seeks |
| * to the given position relative to the start of the stream. For more complex |
| * operations like segment seeks (e.g. for looping) or changing the playback |
| * rate or seeking relative to the last configured playback segment you should |
| * use gst_element_seek(). |
| * |
| * In a completely prerolled PAUSED or PLAYING pipeline, seeking is always |
| * guaranteed to return %TRUE on a seekable media type or %FALSE when the media |
| * type is certainly not seekable (such as a live stream). |
| * |
| * Some elements allow for seeking in the READY state, in this |
| * case they will store the seek event and execute it when they are put to |
| * PAUSED. If the element supports seek in READY, it will always return %TRUE when |
| * it receives the event in the READY state. |
| * |
| * Returns: %TRUE if the seek operation succeeded. Flushing seeks will trigger a |
| * preroll, which will emit %GST_MESSAGE_ASYNC_DONE. |
| */ |
| gboolean |
| gst_element_seek_simple (GstElement * element, GstFormat format, |
| GstSeekFlags seek_flags, gint64 seek_pos) |
| { |
| g_return_val_if_fail (GST_IS_ELEMENT (element), FALSE); |
| g_return_val_if_fail (seek_pos >= 0, FALSE); |
| |
| return gst_element_seek (element, 1.0, format, seek_flags, |
| GST_SEEK_TYPE_SET, seek_pos, GST_SEEK_TYPE_NONE, 0); |
| } |
| |
| /** |
| * gst_pad_use_fixed_caps: |
| * @pad: the pad to use |
| * |
| * A helper function you can use that sets the FIXED_CAPS flag |
| * This way the default CAPS query will always return the negotiated caps |
| * or in case the pad is not negotiated, the padtemplate caps. |
| * |
| * The negotiated caps are the caps of the last CAPS event that passed on the |
| * pad. Use this function on a pad that, once it negotiated to a CAPS, cannot |
| * be renegotiated to something else. |
| */ |
| void |
| gst_pad_use_fixed_caps (GstPad * pad) |
| { |
| GST_OBJECT_FLAG_SET (pad, GST_PAD_FLAG_FIXED_CAPS); |
| } |
| |
| /** |
| * gst_pad_get_parent_element: |
| * @pad: a pad |
| * |
| * Gets the parent of @pad, cast to a #GstElement. If a @pad has no parent or |
| * its parent is not an element, return %NULL. |
| * |
| * Returns: (transfer full) (nullable): the parent of the pad. The |
| * caller has a reference on the parent, so unref when you're finished |
| * with it. |
| * |
| * MT safe. |
| */ |
| GstElement * |
| gst_pad_get_parent_element (GstPad * pad) |
| { |
| GstObject *p; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), NULL); |
| |
| p = gst_object_get_parent (GST_OBJECT_CAST (pad)); |
| |
| if (p && !GST_IS_ELEMENT (p)) { |
| gst_object_unref (p); |
| p = NULL; |
| } |
| return GST_ELEMENT_CAST (p); |
| } |
| |
| /** |
| * gst_object_default_error: |
| * @source: the #GstObject that initiated the error. |
| * @error: (in): the GError. |
| * @debug: (in) (allow-none): an additional debug information string, or %NULL |
| * |
| * A default error function that uses g_printerr() to display the error message |
| * and the optional debug sting.. |
| * |
| * The default handler will simply print the error string using g_print. |
| */ |
| void |
| gst_object_default_error (GstObject * source, const GError * error, |
| const gchar * debug) |
| { |
| gchar *name = gst_object_get_path_string (source); |
| |
| g_printerr (_("ERROR: from element %s: %s\n"), name, error->message); |
| if (debug) |
| g_printerr (_("Additional debug info:\n%s\n"), debug); |
| |
| g_free (name); |
| } |
| |
| /** |
| * gst_bin_add_many: |
| * @bin: a #GstBin |
| * @element_1: (transfer full): the #GstElement element to add to the bin |
| * @...: (transfer full): additional elements to add to the bin |
| * |
| * Adds a %NULL-terminated list of elements to a bin. This function is |
| * equivalent to calling gst_bin_add() for each member of the list. The return |
| * value of each gst_bin_add() is ignored. |
| */ |
| void |
| gst_bin_add_many (GstBin * bin, GstElement * element_1, ...) |
| { |
| va_list args; |
| |
| g_return_if_fail (GST_IS_BIN (bin)); |
| g_return_if_fail (GST_IS_ELEMENT (element_1)); |
| |
| va_start (args, element_1); |
| |
| while (element_1) { |
| gst_bin_add (bin, element_1); |
| |
| element_1 = va_arg (args, GstElement *); |
| } |
| |
| va_end (args); |
| } |
| |
| /** |
| * gst_bin_remove_many: |
| * @bin: a #GstBin |
| * @element_1: (transfer none): the first #GstElement to remove from the bin |
| * @...: (transfer none): %NULL-terminated list of elements to remove from the bin |
| * |
| * Remove a list of elements from a bin. This function is equivalent |
| * to calling gst_bin_remove() with each member of the list. |
| */ |
| void |
| gst_bin_remove_many (GstBin * bin, GstElement * element_1, ...) |
| { |
| va_list args; |
| |
| g_return_if_fail (GST_IS_BIN (bin)); |
| g_return_if_fail (GST_IS_ELEMENT (element_1)); |
| |
| va_start (args, element_1); |
| |
| while (element_1) { |
| gst_bin_remove (bin, element_1); |
| |
| element_1 = va_arg (args, GstElement *); |
| } |
| |
| va_end (args); |
| } |
| |
| typedef struct |
| { |
| GstQuery *query; |
| gboolean ret; |
| } QueryAcceptCapsData; |
| |
| static gboolean |
| query_accept_caps_func (GstPad * pad, QueryAcceptCapsData * data) |
| { |
| if (G_LIKELY (gst_pad_peer_query (pad, data->query))) { |
| gboolean result; |
| |
| gst_query_parse_accept_caps_result (data->query, &result); |
| data->ret &= result; |
| } |
| return FALSE; |
| } |
| |
| /** |
| * gst_pad_proxy_query_accept_caps: |
| * @pad: a #GstPad to proxy. |
| * @query: an ACCEPT_CAPS #GstQuery. |
| * |
| * Checks if all internally linked pads of @pad accepts the caps in @query and |
| * returns the intersection of the results. |
| * |
| * This function is useful as a default accept caps query function for an element |
| * that can handle any stream format, but requires caps that are acceptable for |
| * all opposite pads. |
| * |
| * Returns: %TRUE if @query could be executed |
| */ |
| gboolean |
| gst_pad_proxy_query_accept_caps (GstPad * pad, GstQuery * query) |
| { |
| QueryAcceptCapsData data; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (GST_IS_QUERY (query), FALSE); |
| g_return_val_if_fail (GST_QUERY_TYPE (query) == GST_QUERY_ACCEPT_CAPS, FALSE); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_PADS, pad, |
| "proxying accept caps query for %s:%s", GST_DEBUG_PAD_NAME (pad)); |
| |
| data.query = query; |
| /* value to hold the return, by default it holds TRUE */ |
| /* FIXME: TRUE is wrong when there are no pads */ |
| data.ret = TRUE; |
| |
| gst_pad_forward (pad, (GstPadForwardFunction) query_accept_caps_func, &data); |
| gst_query_set_accept_caps_result (query, data.ret); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_PADS, pad, "proxying accept caps query: %d", |
| data.ret); |
| |
| return data.ret; |
| } |
| |
| typedef struct |
| { |
| GstQuery *query; |
| GstCaps *ret; |
| } QueryCapsData; |
| |
| static gboolean |
| query_caps_func (GstPad * pad, QueryCapsData * data) |
| { |
| gboolean empty = FALSE; |
| |
| if (G_LIKELY (gst_pad_peer_query (pad, data->query))) { |
| GstCaps *peercaps, *intersection; |
| |
| gst_query_parse_caps_result (data->query, &peercaps); |
| GST_DEBUG_OBJECT (pad, "intersect with result %" GST_PTR_FORMAT, peercaps); |
| intersection = gst_caps_intersect (data->ret, peercaps); |
| GST_DEBUG_OBJECT (pad, "intersected %" GST_PTR_FORMAT, intersection); |
| |
| gst_caps_unref (data->ret); |
| data->ret = intersection; |
| |
| /* stop when empty */ |
| empty = gst_caps_is_empty (intersection); |
| } |
| return empty; |
| } |
| |
| /** |
| * gst_pad_proxy_query_caps: |
| * @pad: a #GstPad to proxy. |
| * @query: a CAPS #GstQuery. |
| * |
| * Calls gst_pad_query_caps() for all internally linked pads of @pad and returns |
| * the intersection of the results. |
| * |
| * This function is useful as a default caps query function for an element |
| * that can handle any stream format, but requires all its pads to have |
| * the same caps. Two such elements are tee and adder. |
| * |
| * Returns: %TRUE if @query could be executed |
| */ |
| gboolean |
| gst_pad_proxy_query_caps (GstPad * pad, GstQuery * query) |
| { |
| GstCaps *filter, *templ, *result; |
| QueryCapsData data; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (GST_IS_QUERY (query), FALSE); |
| g_return_val_if_fail (GST_QUERY_TYPE (query) == GST_QUERY_CAPS, FALSE); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_PADS, pad, "proxying caps query for %s:%s", |
| GST_DEBUG_PAD_NAME (pad)); |
| |
| data.query = query; |
| |
| /* value to hold the return, by default it holds the filter or ANY */ |
| gst_query_parse_caps (query, &filter); |
| data.ret = filter ? gst_caps_ref (filter) : gst_caps_new_any (); |
| |
| gst_pad_forward (pad, (GstPadForwardFunction) query_caps_func, &data); |
| |
| templ = gst_pad_get_pad_template_caps (pad); |
| result = gst_caps_intersect (data.ret, templ); |
| gst_caps_unref (data.ret); |
| gst_caps_unref (templ); |
| |
| gst_query_set_caps_result (query, result); |
| gst_caps_unref (result); |
| |
| /* FIXME: return something depending on the processing */ |
| return TRUE; |
| } |
| |
| /** |
| * gst_pad_query_position: |
| * @pad: a #GstPad to invoke the position query on. |
| * @format: the #GstFormat requested |
| * @cur: (out) (allow-none): A location in which to store the current position, or %NULL. |
| * |
| * Queries a pad for the stream position. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_pad_query_position (GstPad * pad, GstFormat format, gint64 * cur) |
| { |
| GstQuery *query; |
| gboolean ret; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (format != GST_FORMAT_UNDEFINED, FALSE); |
| |
| query = gst_query_new_position (format); |
| if ((ret = gst_pad_query (pad, query))) |
| gst_query_parse_position (query, NULL, cur); |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_pad_peer_query_position: |
| * @pad: a #GstPad on whose peer to invoke the position query on. |
| * Must be a sink pad. |
| * @format: the #GstFormat requested |
| * @cur: (out) (allow-none): a location in which to store the current |
| * position, or %NULL. |
| * |
| * Queries the peer of a given sink pad for the stream position. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_pad_peer_query_position (GstPad * pad, GstFormat format, gint64 * cur) |
| { |
| GstQuery *query; |
| gboolean ret = FALSE; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (format != GST_FORMAT_UNDEFINED, FALSE); |
| |
| query = gst_query_new_position (format); |
| if ((ret = gst_pad_peer_query (pad, query))) |
| gst_query_parse_position (query, NULL, cur); |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_pad_query_duration: |
| * @pad: a #GstPad to invoke the duration query on. |
| * @format: the #GstFormat requested |
| * @duration: (out) (allow-none): a location in which to store the total |
| * duration, or %NULL. |
| * |
| * Queries a pad for the total stream duration. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_pad_query_duration (GstPad * pad, GstFormat format, gint64 * duration) |
| { |
| GstQuery *query; |
| gboolean ret; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (format != GST_FORMAT_UNDEFINED, FALSE); |
| |
| query = gst_query_new_duration (format); |
| if ((ret = gst_pad_query (pad, query))) |
| gst_query_parse_duration (query, NULL, duration); |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_pad_peer_query_duration: |
| * @pad: a #GstPad on whose peer pad to invoke the duration query on. |
| * Must be a sink pad. |
| * @format: the #GstFormat requested |
| * @duration: (out) (allow-none): a location in which to store the total |
| * duration, or %NULL. |
| * |
| * Queries the peer pad of a given sink pad for the total stream duration. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_pad_peer_query_duration (GstPad * pad, GstFormat format, gint64 * duration) |
| { |
| GstQuery *query; |
| gboolean ret = FALSE; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (GST_PAD_IS_SINK (pad), FALSE); |
| g_return_val_if_fail (format != GST_FORMAT_UNDEFINED, FALSE); |
| |
| query = gst_query_new_duration (format); |
| if ((ret = gst_pad_peer_query (pad, query))) |
| gst_query_parse_duration (query, NULL, duration); |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_pad_query_convert: |
| * @pad: a #GstPad to invoke the convert query on. |
| * @src_format: a #GstFormat to convert from. |
| * @src_val: a value to convert. |
| * @dest_format: the #GstFormat to convert to. |
| * @dest_val: (out): a pointer to the result. |
| * |
| * Queries a pad to convert @src_val in @src_format to @dest_format. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_pad_query_convert (GstPad * pad, GstFormat src_format, gint64 src_val, |
| GstFormat dest_format, gint64 * dest_val) |
| { |
| GstQuery *query; |
| gboolean ret; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (dest_format != GST_FORMAT_UNDEFINED, FALSE); |
| g_return_val_if_fail (dest_val != NULL, FALSE); |
| |
| if (dest_format == src_format || src_val == -1) { |
| *dest_val = src_val; |
| return TRUE; |
| } |
| |
| query = gst_query_new_convert (src_format, src_val, dest_format); |
| if ((ret = gst_pad_query (pad, query))) |
| gst_query_parse_convert (query, NULL, NULL, NULL, dest_val); |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_pad_peer_query_convert: |
| * @pad: a #GstPad, on whose peer pad to invoke the convert query on. |
| * Must be a sink pad. |
| * @src_format: a #GstFormat to convert from. |
| * @src_val: a value to convert. |
| * @dest_format: the #GstFormat to convert to. |
| * @dest_val: (out): a pointer to the result. |
| * |
| * Queries the peer pad of a given sink pad to convert @src_val in @src_format |
| * to @dest_format. |
| * |
| * Returns: %TRUE if the query could be performed. |
| */ |
| gboolean |
| gst_pad_peer_query_convert (GstPad * pad, GstFormat src_format, gint64 src_val, |
| GstFormat dest_format, gint64 * dest_val) |
| { |
| GstQuery *query; |
| gboolean ret = FALSE; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (GST_PAD_IS_SINK (pad), FALSE); |
| g_return_val_if_fail (dest_format != GST_FORMAT_UNDEFINED, FALSE); |
| g_return_val_if_fail (dest_val != NULL, FALSE); |
| |
| query = gst_query_new_convert (src_format, src_val, dest_format); |
| if ((ret = gst_pad_peer_query (pad, query))) |
| gst_query_parse_convert (query, NULL, NULL, NULL, dest_val); |
| gst_query_unref (query); |
| |
| return ret; |
| } |
| |
| /** |
| * gst_pad_query_caps: |
| * @pad: a #GstPad to get the capabilities of. |
| * @filter: (allow-none): suggested #GstCaps, or %NULL |
| * |
| * Gets the capabilities this pad can produce or consume. |
| * Note that this method doesn't necessarily return the caps set by sending a |
| * gst_event_new_caps() - use gst_pad_get_current_caps() for that instead. |
| * gst_pad_query_caps returns all possible caps a pad can operate with, using |
| * the pad's CAPS query function, If the query fails, this function will return |
| * @filter, if not %NULL, otherwise ANY. |
| * |
| * When called on sinkpads @filter contains the caps that |
| * upstream could produce in the order preferred by upstream. When |
| * called on srcpads @filter contains the caps accepted by |
| * downstream in the preferred order. @filter might be %NULL but |
| * if it is not %NULL the returned caps will be a subset of @filter. |
| * |
| * Note that this function does not return writable #GstCaps, use |
| * gst_caps_make_writable() before modifying the caps. |
| * |
| * Returns: (transfer full): the caps of the pad with incremented ref-count. |
| */ |
| GstCaps * |
| gst_pad_query_caps (GstPad * pad, GstCaps * filter) |
| { |
| GstCaps *result = NULL; |
| GstQuery *query; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), NULL); |
| g_return_val_if_fail (filter == NULL || GST_IS_CAPS (filter), NULL); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_CAPS, pad, |
| "get pad caps with filter %" GST_PTR_FORMAT, filter); |
| |
| query = gst_query_new_caps (filter); |
| if (gst_pad_query (pad, query)) { |
| gst_query_parse_caps_result (query, &result); |
| gst_caps_ref (result); |
| GST_CAT_DEBUG_OBJECT (GST_CAT_CAPS, pad, |
| "query returned %" GST_PTR_FORMAT, result); |
| } else if (filter) { |
| result = gst_caps_ref (filter); |
| } else { |
| result = gst_caps_new_any (); |
| } |
| gst_query_unref (query); |
| |
| return result; |
| } |
| |
| /** |
| * gst_pad_peer_query_caps: |
| * @pad: a #GstPad to get the capabilities of. |
| * @filter: (allow-none): a #GstCaps filter, or %NULL. |
| * |
| * Gets the capabilities of the peer connected to this pad. Similar to |
| * gst_pad_query_caps(). |
| * |
| * When called on srcpads @filter contains the caps that |
| * upstream could produce in the order preferred by upstream. When |
| * called on sinkpads @filter contains the caps accepted by |
| * downstream in the preferred order. @filter might be %NULL but |
| * if it is not %NULL the returned caps will be a subset of @filter. |
| * |
| * Returns: the caps of the peer pad with incremented ref-count. When there is |
| * no peer pad, this function returns @filter or, when @filter is %NULL, ANY |
| * caps. |
| */ |
| GstCaps * |
| gst_pad_peer_query_caps (GstPad * pad, GstCaps * filter) |
| { |
| GstCaps *result = NULL; |
| GstQuery *query; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), NULL); |
| g_return_val_if_fail (filter == NULL || GST_IS_CAPS (filter), NULL); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_CAPS, pad, |
| "get pad peer caps with filter %" GST_PTR_FORMAT, filter); |
| |
| query = gst_query_new_caps (filter); |
| if (gst_pad_peer_query (pad, query)) { |
| gst_query_parse_caps_result (query, &result); |
| gst_caps_ref (result); |
| GST_CAT_DEBUG_OBJECT (GST_CAT_CAPS, pad, |
| "peer query returned %" GST_PTR_FORMAT, result); |
| } else if (filter) { |
| result = gst_caps_ref (filter); |
| } else { |
| result = gst_caps_new_any (); |
| } |
| gst_query_unref (query); |
| |
| return result; |
| } |
| |
| /** |
| * gst_pad_query_accept_caps: |
| * @pad: a #GstPad to check |
| * @caps: a #GstCaps to check on the pad |
| * |
| * Check if the given pad accepts the caps. |
| * |
| * Returns: %TRUE if the pad can accept the caps. |
| */ |
| gboolean |
| gst_pad_query_accept_caps (GstPad * pad, GstCaps * caps) |
| { |
| gboolean res = TRUE; |
| GstQuery *query; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (GST_IS_CAPS (caps), FALSE); |
| |
| GST_CAT_DEBUG_OBJECT (GST_CAT_CAPS, pad, "accept caps of %" |
| GST_PTR_FORMAT, caps); |
| |
| query = gst_query_new_accept_caps (caps); |
| if (gst_pad_query (pad, query)) { |
| gst_query_parse_accept_caps_result (query, &res); |
| GST_DEBUG_OBJECT (pad, "query returned %d", res); |
| } |
| gst_query_unref (query); |
| |
| return res; |
| } |
| |
| /** |
| * gst_pad_peer_query_accept_caps: |
| * @pad: a #GstPad to check the peer of |
| * @caps: a #GstCaps to check on the pad |
| * |
| * Check if the peer of @pad accepts @caps. If @pad has no peer, this function |
| * returns %TRUE. |
| * |
| * Returns: %TRUE if the peer of @pad can accept the caps or @pad has no peer. |
| */ |
| gboolean |
| gst_pad_peer_query_accept_caps (GstPad * pad, GstCaps * caps) |
| { |
| gboolean res = TRUE; |
| GstQuery *query; |
| |
| g_return_val_if_fail (GST_IS_PAD (pad), FALSE); |
| g_return_val_if_fail (GST_IS_CAPS (caps), FALSE); |
| |
| query = gst_query_new_accept_caps (caps); |
| if (gst_pad_peer_query (pad, query)) { |
| gst_query_parse_accept_caps_result (query, &res); |
| GST_DEBUG_OBJECT (pad, "query returned %d", res); |
| } |
| gst_query_unref (query); |
| |
| return res; |
| } |
| |
| static GstPad * |
| element_find_unlinked_pad (GstElement * element, GstPadDirection direction) |
| { |
| GstIterator *iter; |
| GstPad *unlinked_pad = NULL; |
| gboolean done; |
| GValue data = { 0, }; |
| |
| switch (direction) { |
| case GST_PAD_SRC: |
| iter = gst_element_iterate_src_pads (element); |
| break; |
| case GST_PAD_SINK: |
| iter = gst_element_iterate_sink_pads (element); |
| break; |
| default: |
| g_return_val_if_reached (NULL); |
| } |
| |
| done = FALSE; |
| while (!done) { |
| switch (gst_iterator_next (iter, &data)) { |
| case GST_ITERATOR_OK:{ |
| GstPad *peer; |
| GstPad *pad = g_value_get_object (&data); |
| |
| GST_CAT_LOG (GST_CAT_ELEMENT_PADS, "examining pad %s:%s", |
| GST_DEBUG_PAD_NAME (pad)); |
| |
| peer = gst_pad_get_peer (pad); |
| if (peer == NULL) { |
| unlinked_pad = gst_object_ref (pad); |
| done = TRUE; |
| GST_CAT_DEBUG (GST_CAT_ELEMENT_PADS, |
| "found existing unlinked pad %s:%s", |
| GST_DEBUG_PAD_NAME (unlinked_pad)); |
| } else { |
| gst_object_unref (peer); |
| } |
| g_value_reset (&data); |
| break; |
| } |
| case GST_ITERATOR_DONE: |
| done = TRUE; |
| break; |
| case GST_ITERATOR_RESYNC: |
| gst_iterator_resync (iter); |
| break; |
| case GST_ITERATOR_ERROR: |
| g_return_val_if_reached (NULL); |
| break; |
| } |
| } |
| g_value_unset (&data); |
| gst_iterator_free (iter); |
| |
| return unlinked_pad; |
| } |
| |
| /** |
| * gst_bin_find_unlinked_pad: |
| * @bin: bin in which to look for elements with unlinked pads |
| * @direction: whether to look for an unlinked source or sink pad |
| * |
| * Recursively looks for elements with an unlinked pad of the given |
| * direction within the specified bin and returns an unlinked pad |
| * if one is found, or %NULL otherwise. If a pad is found, the caller |
| * owns a reference to it and should use gst_object_unref() on the |
| * pad when it is not needed any longer. |
| * |
| * Returns: (transfer full) (nullable): unlinked pad of the given |
| * direction, %NULL. |
| */ |
| GstPad * |
| gst_bin_find_unlinked_pad (GstBin * bin, GstPadDirection direction) |
| { |
| GstIterator *iter; |
| gboolean done; |
| GstPad *pad = NULL; |
| GValue data = { 0, }; |
| |
| g_return_val_if_fail (GST_IS_BIN (bin), NULL); |
| g_return_val_if_fail (direction != GST_PAD_UNKNOWN, NULL); |
| |
| done = FALSE; |
| iter = gst_bin_iterate_recurse (bin); |
| while (!done) { |
| switch (gst_iterator_next (iter, &data)) { |
| case GST_ITERATOR_OK:{ |
| GstElement *element = g_value_get_object (&data); |
| |
| pad = element_find_unlinked_pad (element, direction); |
| if (pad != NULL) |
| done = TRUE; |
| g_value_reset (&data); |
| break; |
| } |
| case GST_ITERATOR_DONE: |
| done = TRUE; |
| break; |
| case GST_ITERATOR_RESYNC: |
| gst_iterator_resync (iter); |
| break; |
| case GST_ITERATOR_ERROR: |
| g_return_val_if_reached (NULL); |
| break; |
| } |
| } |
| g_value_unset (&data); |
| gst_iterator_free (iter); |
| |
| return pad; |
| } |
| |
| static void |
| gst_bin_sync_children_states_foreach (const GValue * value, gpointer user_data) |
| { |
| gboolean *success = user_data; |
| GstElement *element = g_value_get_object (value); |
| |
| if (gst_element_is_locked_state (element)) { |
| *success = TRUE; |
| } else { |
| *success = *success && gst_element_sync_state_with_parent (element); |
| |
| if (GST_IS_BIN (element)) |
| *success = *success |
| && gst_bin_sync_children_states (GST_BIN_CAST (element)); |
| } |
| } |
| |
| /** |
| * gst_bin_sync_children_states: |
| * @bin: a #GstBin |
| * |
| * Synchronizes the state of every child of @bin with the state |
| * of @bin. See also gst_element_sync_state_with_parent(). |
| * |
| * Returns: %TRUE if syncing the state was successful for all children, |
| * otherwise %FALSE. |
| * |
| * Since: 1.6 |
| */ |
| gboolean |
| gst_bin_sync_children_states (GstBin * bin) |
| { |
| GstIterator *it; |
| GstIteratorResult res = GST_ITERATOR_OK; |
| gboolean success = TRUE; |
| |
| it = gst_bin_iterate_sorted (bin); |
| |
| do { |
| if (res == GST_ITERATOR_RESYNC) { |
| success = TRUE; |
| gst_iterator_resync (it); |
| } |
| res = |
| gst_iterator_foreach (it, gst_bin_sync_children_states_foreach, |
| &success); |
| } while (res == GST_ITERATOR_RESYNC); |
| gst_iterator_free (it); |
| |
| return success; |
| } |
| |
| /** |
| * gst_parse_bin_from_description: |
| * @bin_description: command line describing the bin |
| * @ghost_unlinked_pads: whether to automatically create ghost pads |
| * for unlinked source or sink pads within the bin |
| * @err: where to store the error message in case of an error, or %NULL |
| * |
| * This is a convenience wrapper around gst_parse_launch() to create a |
| * #GstBin from a gst-launch-style pipeline description. See |
| * gst_parse_launch() and the gst-launch man page for details about the |
| * syntax. Ghost pads on the bin for unlinked source or sink pads |
| * within the bin can automatically be created (but only a maximum of |
| * one ghost pad for each direction will be created; if you expect |
| * multiple unlinked source pads or multiple unlinked sink pads |
| * and want them all ghosted, you will have to create the ghost pads |
| * yourself). |
| * |
| * Returns: (transfer floating) (type Gst.Bin) (nullable): a |
| * newly-created bin, or %NULL if an error occurred. |
| */ |
| GstElement * |
| gst_parse_bin_from_description (const gchar * bin_description, |
| gboolean ghost_unlinked_pads, GError ** err) |
| { |
| return gst_parse_bin_from_description_full (bin_description, |
| ghost_unlinked_pads, NULL, GST_PARSE_FLAG_NONE, err); |
| } |
| |
| /** |
| * gst_parse_bin_from_description_full: |
| * @bin_description: command line describing the bin |
| * @ghost_unlinked_pads: whether to automatically create ghost pads |
| * for unlinked source or sink pads within the bin |
| * @context: (transfer none) (allow-none): a parse context allocated with |
| * gst_parse_context_new(), or %NULL |
| * @flags: parsing options, or #GST_PARSE_FLAG_NONE |
| * @err: where to store the error message in case of an error, or %NULL |
| * |
| * This is a convenience wrapper around gst_parse_launch() to create a |
| * #GstBin from a gst-launch-style pipeline description. See |
| * gst_parse_launch() and the gst-launch man page for details about the |
| * syntax. Ghost pads on the bin for unlinked source or sink pads |
| * within the bin can automatically be created (but only a maximum of |
| * one ghost pad for each direction will be created; if you expect |
| * multiple unlinked source pads or multiple unlinked sink pads |
| * and want them all ghosted, you will have to create the ghost pads |
| * yourself). |
| * |
| * Returns: (transfer floating) (type Gst.Element): a newly-created |
| * element, which is guaranteed to be a bin unless |
| * GST_FLAG_NO_SINGLE_ELEMENT_BINS was passed, or %NULL if an error |
| * occurred. |
| */ |
| GstElement * |
| gst_parse_bin_from_description_full (const gchar * bin_description, |
| gboolean ghost_unlinked_pads, GstParseContext * context, |
| GstParseFlags flags, GError ** err) |
| { |
| #ifndef GST_DISABLE_PARSE |
| GstPad *pad = NULL; |
| GstElement *element; |
| GstBin *bin; |
| gchar *desc; |
| |
| g_return_val_if_fail (bin_description != NULL, NULL); |
| g_return_val_if_fail (err == NULL || *err == NULL, NULL); |
| |
| GST_DEBUG ("Making bin from description '%s'", bin_description); |
| |
| /* parse the pipeline to a bin */ |
| if (flags & GST_PARSE_FLAG_NO_SINGLE_ELEMENT_BINS) { |
| element = gst_parse_launch_full (bin_description, context, flags, err); |
| } else { |
| desc = g_strdup_printf ("bin.( %s )", bin_description); |
| element = gst_parse_launch_full (desc, context, flags, err); |
| g_free (desc); |
| } |
| |
| if (element == NULL || (err && *err != NULL)) { |
| if (element) |
| gst_object_unref (element); |
| return NULL; |
| } |
| |
| if (GST_IS_BIN (element)) { |
| bin = GST_BIN (element); |
| } else { |
| return element; |
| } |
| |
| /* find pads and ghost them if necessary */ |
| if (ghost_unlinked_pads) { |
| if ((pad = gst_bin_find_unlinked_pad (bin, GST_PAD_SRC))) { |
| gst_element_add_pad (GST_ELEMENT (bin), gst_ghost_pad_new ("src", pad)); |
| gst_object_unref (pad); |
| } |
| if ((pad = gst_bin_find_unlinked_pad (bin, GST_PAD_SINK))) { |
| gst_element_add_pad (GST_ELEMENT (bin), gst_ghost_pad_new ("sink", pad)); |
| gst_object_unref (pad); |
| } |
| } |
| |
| return GST_ELEMENT (bin); |
| #else |
| gchar *msg; |
| |
| GST_WARNING ("Disabled API called"); |
| |
| msg = gst_error_get_message (GST_CORE_ERROR, GST_CORE_ERROR_DISABLED); |
| g_set_error (err, GST_CORE_ERROR, GST_CORE_ERROR_DISABLED, "%s", msg); |
| g_free (msg); |
| |
| return NULL; |
| #endif |
| } |
| |
| /** |
| * gst_util_get_timestamp: |
| * |
| * Get a timestamp as GstClockTime to be used for interval measurements. |
| * The timestamp should not be interpreted in any other way. |
| * |
| * Returns: the timestamp |
| */ |
| GstClockTime |
| gst_util_get_timestamp (void) |
| { |
| #if defined (HAVE_POSIX_TIMERS) && defined(HAVE_MONOTONIC_CLOCK) &&\ |
| defined (HAVE_CLOCK_GETTIME) |
| struct timespec now; |
| |
| clock_gettime (CLOCK_MONOTONIC, &now); |
| return GST_TIMESPEC_TO_TIME (now); |
| #else |
| GTimeVal now; |
| |
| g_get_current_time (&now); |
| return GST_TIMEVAL_TO_TIME (now); |
| #endif |
| } |
| |
| /** |
| * gst_util_array_binary_search: |
| * @array: the sorted input array |
| * @num_elements: number of elements in the array |
| * @element_size: size of every element in bytes |
| * @search_func: (scope call): function to compare two elements, @search_data will always be passed as second argument |
| * @mode: search mode that should be used |
| * @search_data: element that should be found |
| * @user_data: (closure): data to pass to @search_func |
| * |
| * Searches inside @array for @search_data by using the comparison function |
| * @search_func. @array must be sorted ascending. |
| * |
| * As @search_data is always passed as second argument to @search_func it's |
| * not required that @search_data has the same type as the array elements. |
| * |
| * The complexity of this search function is O(log (num_elements)). |
| * |
| * Returns: (transfer none) (nullable): The address of the found |
| * element or %NULL if nothing was found |
| */ |
| 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) |
| { |
| glong left = 0, right = num_elements - 1, m; |
| gint ret; |
| guint8 *data = (guint8 *) array; |
| |
| g_return_val_if_fail (array != NULL, NULL); |
| g_return_val_if_fail (element_size > 0, NULL); |
| g_return_val_if_fail (search_func != NULL, NULL); |
| |
| /* 0. No elements => return NULL */ |
| if (num_elements == 0) |
| return NULL; |
| |
| /* 1. If search_data is before the 0th element return the 0th element */ |
| ret = search_func (data, search_data, user_data); |
| if ((ret >= 0 && mode == GST_SEARCH_MODE_AFTER) || ret == 0) |
| return data; |
| else if (ret > 0) |
| return NULL; |
| |
| /* 2. If search_data is after the last element return the last element */ |
| ret = |
| search_func (data + (num_elements - 1) * element_size, search_data, |
| user_data); |
| if ((ret <= 0 && mode == GST_SEARCH_MODE_BEFORE) || ret == 0) |
| return data + (num_elements - 1) * element_size; |
| else if (ret < 0) |
| return NULL; |
| |
| /* 3. else binary search */ |
| while (TRUE) { |
| m = left + (right - left) / 2; |
| |
| ret = search_func (data + m * element_size, search_data, user_data); |
| |
| if (ret == 0) { |
| return data + m * element_size; |
| } else if (ret < 0) { |
| left = m + 1; |
| } else { |
| right = m - 1; |
| } |
| |
| /* No exact match found */ |
| if (right < left) { |
| if (mode == GST_SEARCH_MODE_EXACT) { |
| return NULL; |
| } else if (mode == GST_SEARCH_MODE_AFTER) { |
| if (ret < 0) |
| return (m < num_elements) ? data + (m + 1) |