mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-14 20:36:32 +00:00
3f5042d74e
* Don't repeat what annotations are stating with respect to ownership transfer, nullability * Reword the warnings for caps nestability in light of the 1.20 improvements * Misc cleanup / typo fixes / addition of links Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/754>
2802 lines
77 KiB
C
2802 lines
77 KiB
C
/* GStreamer
|
|
* Copyright (C) <2003> David A. Schleef <ds@schleef.org>
|
|
*
|
|
* 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:gstcaps
|
|
* @title: GstCaps
|
|
* @short_description: Structure describing sets of media formats
|
|
* @see_also: #GstStructure, #GstMiniObject
|
|
*
|
|
* Caps (capabilities) are lightweight refcounted objects describing media types.
|
|
* They are composed of an array of #GstStructure.
|
|
*
|
|
* Caps are exposed on #GstPadTemplate to describe all possible types a
|
|
* given pad can handle. They are also stored in the #GstRegistry along with
|
|
* a description of the #GstElement.
|
|
*
|
|
* Caps are exposed on the element pads using the gst_pad_query_caps() pad
|
|
* function. This function describes the possible types that the pad can
|
|
* handle or produce at runtime.
|
|
*
|
|
* A #GstCaps can be constructed with the following code fragment:
|
|
*
|
|
* ``` C
|
|
* GstCaps *caps = gst_caps_new_simple ("video/x-raw",
|
|
* "format", G_TYPE_STRING, "I420",
|
|
* "framerate", GST_TYPE_FRACTION, 25, 1,
|
|
* "pixel-aspect-ratio", GST_TYPE_FRACTION, 1, 1,
|
|
* "width", G_TYPE_INT, 320,
|
|
* "height", G_TYPE_INT, 240,
|
|
* NULL);
|
|
* ```
|
|
*
|
|
* A #GstCaps is fixed when it has no fields with ranges or lists. Use
|
|
* gst_caps_is_fixed() to test for fixed caps. Fixed caps can be used in a
|
|
* caps event to notify downstream elements of the current media type.
|
|
*
|
|
* Various methods exist to work with the media types such as subtracting
|
|
* or intersecting.
|
|
*
|
|
* Be aware that until 1.20 the #GstCaps / #GstStructure serialization into string
|
|
* had limited support for nested #GstCaps / #GstStructure fields. It could only
|
|
* support one level of nesting. Using more levels would lead to unexpected
|
|
* behavior when using serialization features, such as gst_caps_to_string() or
|
|
* gst_value_serialize() and their counterparts.
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
#include <string.h>
|
|
#include <signal.h>
|
|
|
|
#define GST_DISABLE_MINIOBJECT_INLINE_FUNCTIONS
|
|
#include "gst_private.h"
|
|
#include <gst/gst.h>
|
|
#include <gobject/gvaluecollector.h>
|
|
|
|
#define DEBUG_REFCOUNT
|
|
|
|
typedef struct _GstCapsArrayElement
|
|
{
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
} GstCapsArrayElement;
|
|
|
|
typedef struct _GstCapsImpl
|
|
{
|
|
GstCaps caps;
|
|
|
|
GArray *array;
|
|
} GstCapsImpl;
|
|
|
|
#define GST_CAPS_ARRAY(c) (((GstCapsImpl *)(c))->array)
|
|
|
|
#define GST_CAPS_LEN(c) (GST_CAPS_ARRAY(c)->len)
|
|
|
|
#define IS_WRITABLE(caps) \
|
|
(GST_CAPS_REFCOUNT_VALUE (caps) == 1)
|
|
|
|
/* same as gst_caps_is_any () */
|
|
#define CAPS_IS_ANY(caps) \
|
|
(!!(GST_CAPS_FLAGS(caps) & GST_CAPS_FLAG_ANY))
|
|
|
|
/* same as gst_caps_is_empty () */
|
|
#define CAPS_IS_EMPTY(caps) \
|
|
(!CAPS_IS_ANY(caps) && CAPS_IS_EMPTY_SIMPLE(caps))
|
|
|
|
#define CAPS_IS_EMPTY_SIMPLE(caps) \
|
|
((GST_CAPS_ARRAY (caps) == NULL) || (GST_CAPS_LEN (caps) == 0))
|
|
|
|
#define gst_caps_features_copy_conditional(f) ((f && (gst_caps_features_is_any (f) || !gst_caps_features_is_equal (f, GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY))) ? gst_caps_features_copy (f) : NULL)
|
|
|
|
/* quick way to get a caps structure at an index without doing a type or array
|
|
* length check */
|
|
#define gst_caps_get_structure_unchecked(caps, index) \
|
|
(g_array_index (GST_CAPS_ARRAY (caps), GstCapsArrayElement, (index)).structure)
|
|
#define gst_caps_get_features_storage_unchecked(caps, index) \
|
|
(&g_array_index (GST_CAPS_ARRAY (caps), GstCapsArrayElement, (index)).features)
|
|
#define gst_caps_get_features_unchecked(caps, index) \
|
|
(g_atomic_pointer_get (gst_caps_get_features_storage_unchecked (caps, index)))
|
|
/* quick way to append a structure without checking the args */
|
|
#define gst_caps_append_structure_unchecked(caps, s, f) G_STMT_START{\
|
|
GstCapsArrayElement __e={s, f}; \
|
|
if (gst_structure_set_parent_refcount (__e.structure, &GST_MINI_OBJECT_REFCOUNT(caps)) && \
|
|
(!__e.features || gst_caps_features_set_parent_refcount (__e.features, &GST_MINI_OBJECT_REFCOUNT(caps)))) \
|
|
g_array_append_val (GST_CAPS_ARRAY (caps), __e); \
|
|
}G_STMT_END
|
|
|
|
/* lock to protect multiple invocations of static caps to caps conversion */
|
|
G_LOCK_DEFINE_STATIC (static_caps_lock);
|
|
|
|
static void gst_caps_transform_to_string (const GValue * src_value,
|
|
GValue * dest_value);
|
|
static gboolean gst_caps_from_string_inplace (GstCaps * caps,
|
|
const gchar * string);
|
|
|
|
GType _gst_caps_type = 0;
|
|
GstCaps *_gst_caps_any;
|
|
GstCaps *_gst_caps_none;
|
|
|
|
GST_DEFINE_MINI_OBJECT_TYPE (GstCaps, gst_caps);
|
|
|
|
void
|
|
_priv_gst_caps_initialize (void)
|
|
{
|
|
_gst_caps_type = gst_caps_get_type ();
|
|
|
|
_gst_caps_any = gst_caps_new_any ();
|
|
_gst_caps_none = gst_caps_new_empty ();
|
|
|
|
g_value_register_transform_func (_gst_caps_type,
|
|
G_TYPE_STRING, gst_caps_transform_to_string);
|
|
}
|
|
|
|
void
|
|
_priv_gst_caps_cleanup (void)
|
|
{
|
|
gst_caps_unref (_gst_caps_any);
|
|
_gst_caps_any = NULL;
|
|
gst_caps_unref (_gst_caps_none);
|
|
_gst_caps_none = NULL;
|
|
}
|
|
|
|
GstCapsFeatures *
|
|
__gst_caps_get_features_unchecked (const GstCaps * caps, guint idx)
|
|
{
|
|
return gst_caps_get_features_unchecked (caps, idx);
|
|
}
|
|
|
|
static GstCaps *
|
|
_gst_caps_copy (const GstCaps * caps)
|
|
{
|
|
GstCaps *newcaps;
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
guint i, n;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
newcaps = gst_caps_new_empty ();
|
|
GST_CAPS_FLAGS (newcaps) = GST_CAPS_FLAGS (caps);
|
|
n = GST_CAPS_LEN (caps);
|
|
|
|
GST_CAT_DEBUG (GST_CAT_PERFORMANCE, "doing copy %p -> %p", caps, newcaps);
|
|
|
|
for (i = 0; i < n; i++) {
|
|
structure = gst_caps_get_structure_unchecked (caps, i);
|
|
features = gst_caps_get_features_unchecked (caps, i);
|
|
gst_caps_append_structure_full (newcaps, gst_structure_copy (structure),
|
|
gst_caps_features_copy_conditional (features));
|
|
}
|
|
|
|
return newcaps;
|
|
}
|
|
|
|
/* creation/deletion */
|
|
static void
|
|
_gst_caps_free (GstCaps * caps)
|
|
{
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
guint i, len;
|
|
|
|
/* The refcount must be 0, but since we're only called by gst_caps_unref,
|
|
* don't bother testing. */
|
|
len = GST_CAPS_LEN (caps);
|
|
/* This can be used to get statistics about caps sizes */
|
|
/*GST_CAT_INFO (GST_CAT_CAPS, "caps size: %d", len); */
|
|
for (i = 0; i < len; i++) {
|
|
structure = gst_caps_get_structure_unchecked (caps, i);
|
|
gst_structure_set_parent_refcount (structure, NULL);
|
|
gst_structure_free (structure);
|
|
features = gst_caps_get_features_unchecked (caps, i);
|
|
if (features) {
|
|
gst_caps_features_set_parent_refcount (features, NULL);
|
|
gst_caps_features_free (features);
|
|
}
|
|
}
|
|
g_array_free (GST_CAPS_ARRAY (caps), TRUE);
|
|
|
|
#ifdef DEBUG_REFCOUNT
|
|
GST_CAT_TRACE (GST_CAT_CAPS, "freeing caps %p", caps);
|
|
#endif
|
|
|
|
#ifdef USE_POISONING
|
|
memset (caps, 0xff, sizeof (GstCapsImpl));
|
|
#endif
|
|
|
|
g_slice_free1 (sizeof (GstCapsImpl), caps);
|
|
}
|
|
|
|
static void
|
|
gst_caps_init (GstCaps * caps)
|
|
{
|
|
gst_mini_object_init (GST_MINI_OBJECT_CAST (caps), 0, _gst_caps_type,
|
|
(GstMiniObjectCopyFunction) _gst_caps_copy, NULL,
|
|
(GstMiniObjectFreeFunction) _gst_caps_free);
|
|
|
|
/* the 32 has been determined by logging caps sizes in _gst_caps_free
|
|
* but g_ptr_array uses 16 anyway if it expands once, so this does not help
|
|
* in practice
|
|
* GST_CAPS_ARRAY (caps) = g_ptr_array_sized_new (32);
|
|
*/
|
|
GST_CAPS_ARRAY (caps) =
|
|
g_array_new (FALSE, TRUE, sizeof (GstCapsArrayElement));
|
|
}
|
|
|
|
/**
|
|
* gst_caps_new_empty:
|
|
*
|
|
* Creates a new #GstCaps that is empty. That is, the returned
|
|
* #GstCaps contains no media formats.
|
|
* The #GstCaps is guaranteed to be writable.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_new_empty (void)
|
|
{
|
|
GstCaps *caps;
|
|
|
|
caps = (GstCaps *) g_slice_new (GstCapsImpl);
|
|
|
|
gst_caps_init (caps);
|
|
|
|
#ifdef DEBUG_REFCOUNT
|
|
GST_CAT_TRACE (GST_CAT_CAPS, "created caps %p", caps);
|
|
#endif
|
|
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_new_any:
|
|
*
|
|
* Creates a new #GstCaps that indicates that it is compatible with
|
|
* any media format.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_new_any (void)
|
|
{
|
|
GstCaps *caps = gst_caps_new_empty ();
|
|
|
|
GST_CAPS_FLAG_SET (caps, GST_CAPS_FLAG_ANY);
|
|
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_new_empty_simple:
|
|
* @media_type: the media type of the structure
|
|
*
|
|
* Creates a new #GstCaps that contains one #GstStructure with name
|
|
* @media_type.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_new_empty_simple (const char *media_type)
|
|
{
|
|
GstCaps *caps;
|
|
GstStructure *structure;
|
|
|
|
caps = gst_caps_new_empty ();
|
|
structure = gst_structure_new_empty (media_type);
|
|
if (structure)
|
|
gst_caps_append_structure_unchecked (caps, structure, NULL);
|
|
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_new_simple:
|
|
* @media_type: the media type of the structure
|
|
* @fieldname: first field to set
|
|
* @...: additional arguments
|
|
*
|
|
* Creates a new #GstCaps that contains one #GstStructure. The
|
|
* structure is defined by the arguments, which have the same format
|
|
* as gst_structure_new().
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_new_simple (const char *media_type, const char *fieldname, ...)
|
|
{
|
|
GstCaps *caps;
|
|
GstStructure *structure;
|
|
va_list var_args;
|
|
|
|
caps = gst_caps_new_empty ();
|
|
|
|
va_start (var_args, fieldname);
|
|
structure = gst_structure_new_valist (media_type, fieldname, var_args);
|
|
va_end (var_args);
|
|
|
|
if (structure)
|
|
gst_caps_append_structure_unchecked (caps, structure, NULL);
|
|
else
|
|
gst_caps_replace (&caps, NULL);
|
|
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_new_full:
|
|
* @struct1: the first structure to add
|
|
* @...: additional structures to add
|
|
*
|
|
* Creates a new #GstCaps and adds all the structures listed as
|
|
* arguments. The list must be %NULL-terminated. The structures
|
|
* are not copied; the returned #GstCaps owns the structures.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_new_full (GstStructure * struct1, ...)
|
|
{
|
|
GstCaps *caps;
|
|
va_list var_args;
|
|
|
|
va_start (var_args, struct1);
|
|
caps = gst_caps_new_full_valist (struct1, var_args);
|
|
va_end (var_args);
|
|
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_new_full_valist:
|
|
* @structure: the first structure to add
|
|
* @var_args: additional structures to add
|
|
*
|
|
* Creates a new #GstCaps and adds all the structures listed as
|
|
* arguments. The list must be %NULL-terminated. The structures
|
|
* are not copied; the returned #GstCaps owns the structures.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_new_full_valist (GstStructure * structure, va_list var_args)
|
|
{
|
|
GstCaps *caps;
|
|
|
|
caps = gst_caps_new_empty ();
|
|
|
|
while (structure) {
|
|
gst_caps_append_structure_unchecked (caps, structure, NULL);
|
|
structure = va_arg (var_args, GstStructure *);
|
|
}
|
|
|
|
return caps;
|
|
}
|
|
|
|
G_DEFINE_POINTER_TYPE (GstStaticCaps, gst_static_caps);
|
|
|
|
/**
|
|
* gst_static_caps_get:
|
|
* @static_caps: the #GstStaticCaps to convert
|
|
*
|
|
* Converts a #GstStaticCaps to a #GstCaps.
|
|
*
|
|
* Returns: (transfer full) (nullable): a pointer to the #GstCaps. Since the
|
|
* core holds an additional ref to the returned caps, use
|
|
* gst_caps_make_writable() on the returned caps to modify it.
|
|
*/
|
|
GstCaps *
|
|
gst_static_caps_get (GstStaticCaps * static_caps)
|
|
{
|
|
GstCaps **caps;
|
|
|
|
g_return_val_if_fail (static_caps != NULL, NULL);
|
|
|
|
caps = &static_caps->caps;
|
|
|
|
/* refcount is 0 when we need to convert */
|
|
if (G_UNLIKELY (*caps == NULL)) {
|
|
const char *string;
|
|
|
|
G_LOCK (static_caps_lock);
|
|
/* check if other thread already updated */
|
|
if (G_UNLIKELY (*caps != NULL))
|
|
goto done;
|
|
|
|
string = static_caps->string;
|
|
|
|
if (G_UNLIKELY (string == NULL))
|
|
goto no_string;
|
|
|
|
*caps = gst_caps_from_string (string);
|
|
|
|
/* convert to string */
|
|
if (G_UNLIKELY (*caps == NULL)) {
|
|
g_critical ("Could not convert static caps \"%s\"", string);
|
|
goto done;
|
|
}
|
|
|
|
/* Caps generated from static caps are usually leaked */
|
|
GST_MINI_OBJECT_FLAG_SET (*caps, GST_MINI_OBJECT_FLAG_MAY_BE_LEAKED);
|
|
|
|
GST_CAT_TRACE (GST_CAT_CAPS, "created %p from string %s", static_caps,
|
|
string);
|
|
done:
|
|
G_UNLOCK (static_caps_lock);
|
|
}
|
|
/* ref the caps, makes it not writable */
|
|
if (G_LIKELY (*caps != NULL))
|
|
gst_caps_ref (*caps);
|
|
|
|
return *caps;
|
|
|
|
/* ERRORS */
|
|
no_string:
|
|
{
|
|
G_UNLOCK (static_caps_lock);
|
|
g_warning ("static caps %p string is NULL", static_caps);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_static_caps_cleanup:
|
|
* @static_caps: the #GstStaticCaps to clean
|
|
*
|
|
* Cleans up the cached caps contained in @static_caps.
|
|
*/
|
|
void
|
|
gst_static_caps_cleanup (GstStaticCaps * static_caps)
|
|
{
|
|
G_LOCK (static_caps_lock);
|
|
gst_caps_replace (&static_caps->caps, NULL);
|
|
G_UNLOCK (static_caps_lock);
|
|
}
|
|
|
|
/* manipulation */
|
|
|
|
static void
|
|
gst_caps_remove_and_get_structure_and_features (GstCaps * caps, guint idx,
|
|
GstStructure ** s, GstCapsFeatures ** f)
|
|
{
|
|
GstStructure *s_;
|
|
GstCapsFeatures *f_;
|
|
|
|
s_ = gst_caps_get_structure_unchecked (caps, idx);
|
|
f_ = gst_caps_get_features_unchecked (caps, idx);
|
|
|
|
/* don't use index_fast, gst_caps_simplify relies on the order */
|
|
g_array_remove_index (GST_CAPS_ARRAY (caps), idx);
|
|
|
|
gst_structure_set_parent_refcount (s_, NULL);
|
|
if (f_) {
|
|
gst_caps_features_set_parent_refcount (f_, NULL);
|
|
}
|
|
|
|
*s = s_;
|
|
*f = f_;
|
|
}
|
|
|
|
static GstStructure *
|
|
gst_caps_remove_and_get_structure (GstCaps * caps, guint idx)
|
|
{
|
|
GstStructure *s;
|
|
GstCapsFeatures *f;
|
|
|
|
gst_caps_remove_and_get_structure_and_features (caps, idx, &s, &f);
|
|
|
|
if (f)
|
|
gst_caps_features_free (f);
|
|
|
|
return s;
|
|
}
|
|
|
|
static void
|
|
gst_caps_make_any (GstCaps * caps)
|
|
{
|
|
guint i;
|
|
GstStructure *s;
|
|
|
|
/* empty out residual structures */
|
|
for (i = GST_CAPS_LEN (caps); i; i--) {
|
|
s = gst_caps_remove_and_get_structure (caps, 0);
|
|
gst_structure_free (s);
|
|
}
|
|
GST_CAPS_FLAGS (caps) |= GST_CAPS_FLAG_ANY;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_steal_structure:
|
|
* @caps: the #GstCaps to retrieve from
|
|
* @index: Index of the structure to retrieve
|
|
*
|
|
* Retrieves the structure with the given index from the list of structures
|
|
* contained in @caps. The caller becomes the owner of the returned structure.
|
|
*
|
|
* Returns: (transfer full) (nullable): a pointer to the #GstStructure
|
|
* corresponding to @index.
|
|
*/
|
|
GstStructure *
|
|
gst_caps_steal_structure (GstCaps * caps, guint index)
|
|
{
|
|
g_return_val_if_fail (caps != NULL, NULL);
|
|
g_return_val_if_fail (IS_WRITABLE (caps), NULL);
|
|
|
|
if (G_UNLIKELY (index >= GST_CAPS_LEN (caps)))
|
|
return NULL;
|
|
|
|
return gst_caps_remove_and_get_structure (caps, index);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_append:
|
|
* @caps1: the #GstCaps that will be appended to
|
|
* @caps2: (transfer full): the #GstCaps to append
|
|
*
|
|
* Appends the structures contained in @caps2 to @caps1. The structures in
|
|
* @caps2 are not copied -- they are transferred to @caps1, and then @caps2 is
|
|
* freed. If either caps is ANY, the resulting caps will be ANY.
|
|
*/
|
|
void
|
|
gst_caps_append (GstCaps * caps1, GstCaps * caps2)
|
|
{
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
int i;
|
|
|
|
g_return_if_fail (GST_IS_CAPS (caps1));
|
|
g_return_if_fail (GST_IS_CAPS (caps2));
|
|
g_return_if_fail (IS_WRITABLE (caps1));
|
|
|
|
if (G_UNLIKELY (CAPS_IS_ANY (caps1) || CAPS_IS_ANY (caps2))) {
|
|
gst_caps_make_any (caps1);
|
|
gst_caps_unref (caps2);
|
|
} else {
|
|
caps2 = gst_caps_make_writable (caps2);
|
|
|
|
for (i = GST_CAPS_LEN (caps2); i; i--) {
|
|
gst_caps_remove_and_get_structure_and_features (caps2, 0, &structure,
|
|
&features);
|
|
gst_caps_append_structure_unchecked (caps1, structure, features);
|
|
}
|
|
gst_caps_unref (caps2); /* guaranteed to free it */
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_merge:
|
|
* @caps1: (transfer full): the #GstCaps that will take the new entries
|
|
* @caps2: (transfer full): the #GstCaps to merge in
|
|
*
|
|
* Appends the structures contained in @caps2 to @caps1 if they are not yet
|
|
* expressed by @caps1. The structures in @caps2 are not copied -- they are
|
|
* transferred to a writable copy of @caps1, and then @caps2 is freed.
|
|
* If either caps is ANY, the resulting caps will be ANY.
|
|
*
|
|
* Returns: (transfer full): the merged caps.
|
|
*/
|
|
GstCaps *
|
|
gst_caps_merge (GstCaps * caps1, GstCaps * caps2)
|
|
{
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
int i;
|
|
GstCaps *result;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps1), NULL);
|
|
g_return_val_if_fail (GST_IS_CAPS (caps2), NULL);
|
|
|
|
if (G_UNLIKELY (CAPS_IS_ANY (caps1))) {
|
|
gst_caps_unref (caps2);
|
|
result = caps1;
|
|
} else if (G_UNLIKELY (CAPS_IS_ANY (caps2))) {
|
|
gst_caps_unref (caps1);
|
|
result = caps2;
|
|
} else {
|
|
caps2 = gst_caps_make_writable (caps2);
|
|
|
|
for (i = GST_CAPS_LEN (caps2); i; i--) {
|
|
gst_caps_remove_and_get_structure_and_features (caps2, 0, &structure,
|
|
&features);
|
|
caps1 = gst_caps_merge_structure_full (caps1, structure, features);
|
|
}
|
|
gst_caps_unref (caps2);
|
|
result = caps1;
|
|
|
|
/* this is too naive
|
|
GstCaps *com = gst_caps_intersect (caps1, caps2);
|
|
GstCaps *add = gst_caps_subtract (caps2, com);
|
|
|
|
GST_DEBUG ("common : %d", gst_caps_get_size (com));
|
|
GST_DEBUG ("adding : %d", gst_caps_get_size (add));
|
|
gst_caps_append (caps1, add);
|
|
gst_caps_unref (com);
|
|
*/
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_append_structure:
|
|
* @caps: the #GstCaps that will be appended to
|
|
* @structure: (transfer full): the #GstStructure to append
|
|
*
|
|
* Appends @structure to @caps. The structure is not copied; @caps
|
|
* becomes the owner of @structure.
|
|
*/
|
|
void
|
|
gst_caps_append_structure (GstCaps * caps, GstStructure * structure)
|
|
{
|
|
g_return_if_fail (GST_IS_CAPS (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
if (CAPS_IS_ANY (caps)) {
|
|
/* ANY caps will stay as ANY caps */
|
|
if (structure)
|
|
gst_structure_free (structure);
|
|
return;
|
|
}
|
|
|
|
if (G_LIKELY (structure)) {
|
|
gst_caps_append_structure_unchecked (caps, structure, NULL);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_append_structure_full:
|
|
* @caps: the #GstCaps that will be appended to
|
|
* @structure: (transfer full): the #GstStructure to append
|
|
* @features: (transfer full) (allow-none): the #GstCapsFeatures to append
|
|
*
|
|
* Appends @structure with @features to @caps. The structure is not copied; @caps
|
|
* becomes the owner of @structure.
|
|
*
|
|
* Since: 1.2
|
|
*/
|
|
void
|
|
gst_caps_append_structure_full (GstCaps * caps, GstStructure * structure,
|
|
GstCapsFeatures * features)
|
|
{
|
|
g_return_if_fail (GST_IS_CAPS (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
if (CAPS_IS_ANY (caps)) {
|
|
/* ANY caps will stay as ANY caps */
|
|
if (structure)
|
|
gst_structure_free (structure);
|
|
if (features)
|
|
gst_caps_features_free (features);
|
|
return;
|
|
}
|
|
|
|
if (G_LIKELY (structure)) {
|
|
gst_caps_append_structure_unchecked (caps, structure, features);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_remove_structure:
|
|
* @caps: the #GstCaps to remove from
|
|
* @idx: Index of the structure to remove
|
|
*
|
|
* Removes the structure with the given index from the list of structures
|
|
* contained in @caps.
|
|
*/
|
|
void
|
|
gst_caps_remove_structure (GstCaps * caps, guint idx)
|
|
{
|
|
GstStructure *structure;
|
|
|
|
g_return_if_fail (caps != NULL);
|
|
g_return_if_fail (idx < gst_caps_get_size (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
structure = gst_caps_remove_and_get_structure (caps, idx);
|
|
gst_structure_free (structure);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_merge_structure:
|
|
* @caps: (transfer full): the #GstCaps to merge into
|
|
* @structure: (transfer full): the #GstStructure to merge
|
|
*
|
|
* Appends @structure to @caps if it is not already expressed by @caps.
|
|
*
|
|
* Returns: (transfer full): the merged caps.
|
|
*/
|
|
GstCaps *
|
|
gst_caps_merge_structure (GstCaps * caps, GstStructure * structure)
|
|
{
|
|
GstStructure *structure1;
|
|
GstCapsFeatures *features1;
|
|
int i;
|
|
gboolean unique = TRUE;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
if (G_UNLIKELY (structure == NULL))
|
|
return caps;
|
|
|
|
if (CAPS_IS_ANY (caps)) {
|
|
/* ANY caps will stay as ANY caps */
|
|
gst_structure_free (structure);
|
|
return caps;
|
|
}
|
|
|
|
/* check each structure */
|
|
for (i = GST_CAPS_LEN (caps) - 1; i >= 0; i--) {
|
|
structure1 = gst_caps_get_structure_unchecked (caps, i);
|
|
features1 = gst_caps_get_features_unchecked (caps, i);
|
|
if (!features1)
|
|
features1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
/* if structure is a subset of structure1 and the
|
|
* there are no existing features, then skip it */
|
|
if (gst_caps_features_is_equal (features1,
|
|
GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY)
|
|
&& gst_structure_is_subset (structure, structure1)) {
|
|
unique = FALSE;
|
|
break;
|
|
}
|
|
}
|
|
if (unique) {
|
|
caps = gst_caps_make_writable (caps);
|
|
gst_caps_append_structure_unchecked (caps, structure, NULL);
|
|
} else {
|
|
gst_structure_free (structure);
|
|
}
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_merge_structure_full:
|
|
* @caps: (transfer full): the #GstCaps to merge into
|
|
* @structure: (transfer full): the #GstStructure to merge
|
|
* @features: (transfer full) (allow-none): the #GstCapsFeatures to merge
|
|
*
|
|
* Appends @structure with @features to @caps if its not already expressed by @caps.
|
|
*
|
|
* Returns: (transfer full): the merged caps.
|
|
*
|
|
* Since: 1.2
|
|
*/
|
|
GstCaps *
|
|
gst_caps_merge_structure_full (GstCaps * caps, GstStructure * structure,
|
|
GstCapsFeatures * features)
|
|
{
|
|
GstStructure *structure1;
|
|
GstCapsFeatures *features1, *features_tmp;
|
|
int i;
|
|
gboolean unique = TRUE;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
if (G_UNLIKELY (structure == NULL))
|
|
return caps;
|
|
|
|
if (CAPS_IS_ANY (caps)) {
|
|
/* ANY caps will stay as ANY caps */
|
|
gst_structure_free (structure);
|
|
if (features)
|
|
gst_caps_features_free (features);
|
|
return caps;
|
|
}
|
|
|
|
/* To make comparisons easier below */
|
|
features_tmp = features ? features : GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
/* check each structure */
|
|
for (i = GST_CAPS_LEN (caps) - 1; i >= 0; i--) {
|
|
structure1 = gst_caps_get_structure_unchecked (caps, i);
|
|
features1 = gst_caps_get_features_unchecked (caps, i);
|
|
if (!features1)
|
|
features1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
/* if structure is a subset of structure1 and the
|
|
* the features are a subset, then skip it */
|
|
/* FIXME: We only skip if none of the features are
|
|
* ANY and are still equal. That way all ANY structures
|
|
* show up in the caps and no non-ANY structures are
|
|
* swallowed by ANY structures
|
|
*/
|
|
if (((!gst_caps_features_is_any (features_tmp)
|
|
|| gst_caps_features_is_any (features1))
|
|
&& gst_caps_features_is_equal (features_tmp, features1))
|
|
&& gst_structure_is_subset (structure, structure1)) {
|
|
unique = FALSE;
|
|
break;
|
|
}
|
|
}
|
|
if (unique) {
|
|
caps = gst_caps_make_writable (caps);
|
|
gst_caps_append_structure_unchecked (caps, structure, features);
|
|
} else {
|
|
gst_structure_free (structure);
|
|
if (features)
|
|
gst_caps_features_free (features);
|
|
}
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_get_size:
|
|
* @caps: a #GstCaps
|
|
*
|
|
* Gets the number of structures contained in @caps.
|
|
*
|
|
* Returns: the number of structures that @caps contains
|
|
*/
|
|
guint
|
|
gst_caps_get_size (const GstCaps * caps)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), 0);
|
|
|
|
return GST_CAPS_LEN (caps);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_get_structure:
|
|
* @caps: a #GstCaps
|
|
* @index: the index of the structure
|
|
*
|
|
* Finds the structure in @caps at @index, and returns it.
|
|
*
|
|
* WARNING: This function takes a `const GstCaps *`, but returns a
|
|
* non-const `GstStructure *`. This is for programming convenience --
|
|
* the caller should be aware that structures inside a constant
|
|
* #GstCaps should not be modified. However, if you know the caps
|
|
* are writable, either because you have just copied them or made
|
|
* them writable with gst_caps_make_writable(), you may modify the
|
|
* structure returned in the usual way, e.g. with functions like
|
|
* gst_structure_set().
|
|
*
|
|
* Returns: (transfer none): a pointer to the #GstStructure corresponding
|
|
* to @index
|
|
*/
|
|
GstStructure *
|
|
gst_caps_get_structure (const GstCaps * caps, guint index)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
g_return_val_if_fail (index < GST_CAPS_LEN (caps), NULL);
|
|
|
|
return gst_caps_get_structure_unchecked (caps, index);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_get_features:
|
|
* @caps: a #GstCaps
|
|
* @index: the index of the structure
|
|
*
|
|
* Finds the features in @caps at @index, and returns it.
|
|
*
|
|
* WARNING: This function takes a `const GstCaps *`, but returns a
|
|
* non-const `GstCapsFeatures *`. This is for programming convenience --
|
|
* the caller should be aware that features inside a constant
|
|
* #GstCaps should not be modified. However, if you know the caps
|
|
* are writable, either because you have just copied them or made
|
|
* them writable with gst_caps_make_writable(), you may modify the
|
|
* features returned in the usual way, e.g. with functions like
|
|
* gst_caps_features_add().
|
|
*
|
|
* Returns: (transfer none) (nullable): a pointer to the #GstCapsFeatures
|
|
* corresponding to @index
|
|
*
|
|
* Since: 1.2
|
|
*/
|
|
GstCapsFeatures *
|
|
gst_caps_get_features (const GstCaps * caps, guint index)
|
|
{
|
|
GstCapsFeatures *features;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
g_return_val_if_fail (index < GST_CAPS_LEN (caps), NULL);
|
|
|
|
features = gst_caps_get_features_unchecked (caps, index);
|
|
if (!features) {
|
|
GstCapsFeatures **storage;
|
|
|
|
/* We have to do some atomic pointer magic here as the caps
|
|
* might not be writable and someone else calls this function
|
|
* at the very same time */
|
|
features = gst_caps_features_copy (GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY);
|
|
gst_caps_features_set_parent_refcount (features, &GST_CAPS_REFCOUNT (caps));
|
|
|
|
storage = gst_caps_get_features_storage_unchecked (caps, index);
|
|
if (!g_atomic_pointer_compare_and_exchange (storage,
|
|
(GstCapsFeatures *) NULL, features)) {
|
|
/* Someone did the same we just tried in the meantime */
|
|
gst_caps_features_set_parent_refcount (features, NULL);
|
|
gst_caps_features_free (features);
|
|
|
|
features = gst_caps_get_features_unchecked (caps, index);
|
|
g_assert (features != NULL);
|
|
}
|
|
}
|
|
|
|
return features;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_set_features:
|
|
* @caps: a #GstCaps
|
|
* @index: the index of the structure
|
|
* @features: (allow-none) (transfer full): the #GstCapsFeatures to set
|
|
*
|
|
* Sets the @features for the structure at @index.
|
|
*
|
|
* Since: 1.2
|
|
*/
|
|
void
|
|
gst_caps_set_features (GstCaps * caps, guint index, GstCapsFeatures * features)
|
|
{
|
|
GstCapsFeatures **storage, *old;
|
|
|
|
g_return_if_fail (caps != NULL);
|
|
g_return_if_fail (index < gst_caps_get_size (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
storage = gst_caps_get_features_storage_unchecked (caps, index);
|
|
/* Not much problem here as caps are writable */
|
|
old = g_atomic_pointer_get (storage);
|
|
g_atomic_pointer_set (storage, features);
|
|
|
|
if (features)
|
|
gst_caps_features_set_parent_refcount (features, &GST_CAPS_REFCOUNT (caps));
|
|
|
|
if (old) {
|
|
gst_caps_features_set_parent_refcount (old, NULL);
|
|
gst_caps_features_free (old);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_set_features_simple:
|
|
* @caps: a #GstCaps
|
|
* @features: (allow-none) (transfer full): the #GstCapsFeatures to set
|
|
*
|
|
* Sets the @features for all the structures of @caps.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
void
|
|
gst_caps_set_features_simple (GstCaps * caps, GstCapsFeatures * features)
|
|
{
|
|
guint i;
|
|
guint n;
|
|
|
|
g_return_if_fail (caps != NULL);
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
n = gst_caps_get_size (caps);
|
|
|
|
if (n == 0) {
|
|
/* features will not be set on any structure */
|
|
if (features)
|
|
gst_caps_features_free (features);
|
|
return;
|
|
}
|
|
|
|
for (i = 0; i < n; i++) {
|
|
GstCapsFeatures *f;
|
|
|
|
/* Transfer ownership of @features to the last structure */
|
|
if (features && i < n - 1)
|
|
f = gst_caps_features_copy (features);
|
|
else
|
|
f = features;
|
|
|
|
gst_caps_set_features (caps, i, f);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_copy_nth:
|
|
* @caps: the #GstCaps to copy
|
|
* @nth: the nth structure to copy
|
|
*
|
|
* Creates a new #GstCaps and appends a copy of the nth structure
|
|
* contained in @caps.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
GstCaps *
|
|
gst_caps_copy_nth (const GstCaps * caps, guint nth)
|
|
{
|
|
GstCaps *newcaps;
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
newcaps = gst_caps_new_empty ();
|
|
GST_CAPS_FLAGS (newcaps) = GST_CAPS_FLAGS (caps);
|
|
|
|
if (G_LIKELY (GST_CAPS_LEN (caps) > nth)) {
|
|
structure = gst_caps_get_structure_unchecked (caps, nth);
|
|
features = gst_caps_get_features_unchecked (caps, nth);
|
|
gst_caps_append_structure_unchecked (newcaps,
|
|
gst_structure_copy (structure),
|
|
gst_caps_features_copy_conditional (features));
|
|
}
|
|
|
|
return newcaps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_truncate:
|
|
* @caps: (transfer full): the #GstCaps to truncate
|
|
*
|
|
* Discards all but the first structure from @caps. Useful when
|
|
* fixating.
|
|
*
|
|
* This function takes ownership of @caps and will call gst_caps_make_writable()
|
|
* on it if necessary, so you must not use @caps afterwards unless you keep an
|
|
* additional reference to it with gst_caps_ref().
|
|
*
|
|
* Note that it is not guaranteed that the returned caps have exactly one
|
|
* structure. If @caps is any or empty caps then the returned caps will be
|
|
* the same and contain no structure at all.
|
|
*
|
|
* Returns: (transfer full): truncated caps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_truncate (GstCaps * caps)
|
|
{
|
|
gint i;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
/* Nothing to truncate here */
|
|
if (GST_CAPS_LEN (caps) == 0)
|
|
return caps;
|
|
|
|
i = GST_CAPS_LEN (caps) - 1;
|
|
|
|
/* Already truncated */
|
|
if (i == 0)
|
|
return caps;
|
|
|
|
caps = gst_caps_make_writable (caps);
|
|
while (i > 0)
|
|
gst_caps_remove_structure (caps, i--);
|
|
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_set_value:
|
|
* @caps: a writable caps
|
|
* @field: name of the field to set
|
|
* @value: value to set the field to
|
|
*
|
|
* Sets the given @field on all structures of @caps to the given @value.
|
|
* This is a convenience function for calling gst_structure_set_value() on
|
|
* all structures of @caps.
|
|
**/
|
|
void
|
|
gst_caps_set_value (GstCaps * caps, const char *field, const GValue * value)
|
|
{
|
|
guint i, len;
|
|
|
|
g_return_if_fail (GST_IS_CAPS (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
g_return_if_fail (field != NULL);
|
|
g_return_if_fail (G_IS_VALUE (value));
|
|
|
|
len = GST_CAPS_LEN (caps);
|
|
for (i = 0; i < len; i++) {
|
|
GstStructure *structure = gst_caps_get_structure_unchecked (caps, i);
|
|
gst_structure_set_value (structure, field, value);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_set_simple_valist:
|
|
* @caps: the #GstCaps to set
|
|
* @field: first field to set
|
|
* @varargs: additional parameters
|
|
*
|
|
* Sets fields in a #GstCaps. The arguments must be passed in the same
|
|
* manner as gst_structure_set(), and be %NULL-terminated.
|
|
*/
|
|
void
|
|
gst_caps_set_simple_valist (GstCaps * caps, const char *field, va_list varargs)
|
|
{
|
|
GValue value = { 0, };
|
|
|
|
g_return_if_fail (GST_IS_CAPS (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
while (field) {
|
|
GType type;
|
|
char *err;
|
|
|
|
type = va_arg (varargs, GType);
|
|
|
|
G_VALUE_COLLECT_INIT (&value, type, varargs, 0, &err);
|
|
if (G_UNLIKELY (err)) {
|
|
g_critical ("%s", err);
|
|
g_free (err);
|
|
return;
|
|
}
|
|
|
|
gst_caps_set_value (caps, field, &value);
|
|
|
|
g_value_unset (&value);
|
|
|
|
field = va_arg (varargs, const gchar *);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_set_simple:
|
|
* @caps: the #GstCaps to set
|
|
* @field: first field to set
|
|
* @...: additional parameters
|
|
*
|
|
* Sets fields in a #GstCaps. The arguments must be passed in the same
|
|
* manner as gst_structure_set(), and be %NULL-terminated.
|
|
*/
|
|
void
|
|
gst_caps_set_simple (GstCaps * caps, const char *field, ...)
|
|
{
|
|
va_list var_args;
|
|
|
|
g_return_if_fail (GST_IS_CAPS (caps));
|
|
g_return_if_fail (IS_WRITABLE (caps));
|
|
|
|
va_start (var_args, field);
|
|
gst_caps_set_simple_valist (caps, field, var_args);
|
|
va_end (var_args);
|
|
}
|
|
|
|
/* tests */
|
|
|
|
/**
|
|
* gst_caps_is_any:
|
|
* @caps: the #GstCaps to test
|
|
*
|
|
* Determines if @caps represents any media format.
|
|
*
|
|
* Returns: %TRUE if @caps represents any format.
|
|
*/
|
|
gboolean
|
|
gst_caps_is_any (const GstCaps * caps)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), FALSE);
|
|
|
|
return (CAPS_IS_ANY (caps));
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_empty:
|
|
* @caps: the #GstCaps to test
|
|
*
|
|
* Determines if @caps represents no media formats.
|
|
*
|
|
* Returns: %TRUE if @caps represents no formats.
|
|
*/
|
|
gboolean
|
|
gst_caps_is_empty (const GstCaps * caps)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), FALSE);
|
|
|
|
if (CAPS_IS_ANY (caps))
|
|
return FALSE;
|
|
|
|
return CAPS_IS_EMPTY_SIMPLE (caps);
|
|
}
|
|
|
|
static gboolean
|
|
gst_caps_is_fixed_foreach (GQuark field_id, const GValue * value,
|
|
gpointer unused)
|
|
{
|
|
return gst_value_is_fixed (value);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_fixed:
|
|
* @caps: the #GstCaps to test
|
|
*
|
|
* Fixed #GstCaps describe exactly one format, that is, they have exactly
|
|
* one structure, and each field in the structure describes a fixed type.
|
|
* Examples of non-fixed types are GST_TYPE_INT_RANGE and GST_TYPE_LIST.
|
|
*
|
|
* Returns: %TRUE if @caps is fixed
|
|
*/
|
|
gboolean
|
|
gst_caps_is_fixed (const GstCaps * caps)
|
|
{
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), FALSE);
|
|
|
|
if (GST_CAPS_LEN (caps) != 1)
|
|
return FALSE;
|
|
|
|
/* double check not ANY, even though ANY caps should have 0 length */
|
|
if (CAPS_IS_ANY (caps))
|
|
return FALSE;
|
|
|
|
features = gst_caps_get_features_unchecked (caps, 0);
|
|
if (features && gst_caps_features_is_any (features))
|
|
return FALSE;
|
|
|
|
structure = gst_caps_get_structure_unchecked (caps, 0);
|
|
|
|
return gst_structure_foreach (structure, gst_caps_is_fixed_foreach, NULL);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_equal_fixed:
|
|
* @caps1: the #GstCaps to test
|
|
* @caps2: the #GstCaps to test
|
|
*
|
|
* Tests if two #GstCaps are equal. This function only works on fixed
|
|
* #GstCaps.
|
|
*
|
|
* Returns: %TRUE if the arguments represent the same format
|
|
*/
|
|
gboolean
|
|
gst_caps_is_equal_fixed (const GstCaps * caps1, const GstCaps * caps2)
|
|
{
|
|
GstStructure *struct1, *struct2;
|
|
GstCapsFeatures *features1, *features2;
|
|
|
|
g_return_val_if_fail (gst_caps_is_fixed (caps1), FALSE);
|
|
g_return_val_if_fail (gst_caps_is_fixed (caps2), FALSE);
|
|
|
|
struct1 = gst_caps_get_structure_unchecked (caps1, 0);
|
|
features1 = gst_caps_get_features_unchecked (caps1, 0);
|
|
if (!features1)
|
|
features1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
struct2 = gst_caps_get_structure_unchecked (caps2, 0);
|
|
features2 = gst_caps_get_features_unchecked (caps2, 0);
|
|
if (!features2)
|
|
features2 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
return gst_structure_is_equal (struct1, struct2) &&
|
|
gst_caps_features_is_equal (features1, features2);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_always_compatible:
|
|
* @caps1: the #GstCaps to test
|
|
* @caps2: the #GstCaps to test
|
|
*
|
|
* A given #GstCaps structure is always compatible with another if
|
|
* every media format that is in the first is also contained in the
|
|
* second. That is, @caps1 is a subset of @caps2.
|
|
*
|
|
* Returns: %TRUE if @caps1 is a subset of @caps2.
|
|
*/
|
|
gboolean
|
|
gst_caps_is_always_compatible (const GstCaps * caps1, const GstCaps * caps2)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps1), FALSE);
|
|
g_return_val_if_fail (GST_IS_CAPS (caps2), FALSE);
|
|
|
|
return gst_caps_is_subset (caps1, caps2);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_subset:
|
|
* @subset: a #GstCaps
|
|
* @superset: a potentially greater #GstCaps
|
|
*
|
|
* Checks if all caps represented by @subset are also represented by @superset.
|
|
*
|
|
* Returns: %TRUE if @subset is a subset of @superset
|
|
*/
|
|
gboolean
|
|
gst_caps_is_subset (const GstCaps * subset, const GstCaps * superset)
|
|
{
|
|
GstStructure *s1, *s2;
|
|
GstCapsFeatures *f1, *f2;
|
|
gboolean ret = TRUE;
|
|
gint i, j;
|
|
|
|
g_return_val_if_fail (subset != NULL, FALSE);
|
|
g_return_val_if_fail (superset != NULL, FALSE);
|
|
|
|
if (CAPS_IS_EMPTY (subset) || CAPS_IS_ANY (superset))
|
|
return TRUE;
|
|
if (CAPS_IS_ANY (subset) || CAPS_IS_EMPTY (superset))
|
|
return FALSE;
|
|
|
|
for (i = GST_CAPS_LEN (subset) - 1; i >= 0; i--) {
|
|
s1 = gst_caps_get_structure_unchecked (subset, i);
|
|
f1 = gst_caps_get_features_unchecked (subset, i);
|
|
if (!f1)
|
|
f1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
for (j = GST_CAPS_LEN (superset) - 1; j >= 0; j--) {
|
|
s2 = gst_caps_get_structure_unchecked (superset, j);
|
|
f2 = gst_caps_get_features_unchecked (superset, j);
|
|
if (!f2)
|
|
f2 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if ((!gst_caps_features_is_any (f1) || gst_caps_features_is_any (f2)) &&
|
|
gst_caps_features_is_equal (f1, f2)
|
|
&& gst_structure_is_subset (s1, s2)) {
|
|
/* If we found a superset, continue with the next
|
|
* subset structure */
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* If we found no superset for this subset structure
|
|
* we return FALSE immediately */
|
|
if (j == -1) {
|
|
ret = FALSE;
|
|
break;
|
|
}
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_subset_structure:
|
|
* @caps: a #GstCaps
|
|
* @structure: a potential #GstStructure subset of @caps
|
|
*
|
|
* Checks if @structure is a subset of @caps. See gst_caps_is_subset()
|
|
* for more information.
|
|
*
|
|
* Returns: %TRUE if @structure is a subset of @caps
|
|
*/
|
|
gboolean
|
|
gst_caps_is_subset_structure (const GstCaps * caps,
|
|
const GstStructure * structure)
|
|
{
|
|
GstStructure *s;
|
|
gint i;
|
|
|
|
g_return_val_if_fail (caps != NULL, FALSE);
|
|
g_return_val_if_fail (structure != NULL, FALSE);
|
|
|
|
if (CAPS_IS_ANY (caps))
|
|
return TRUE;
|
|
if (CAPS_IS_EMPTY (caps))
|
|
return FALSE;
|
|
|
|
for (i = GST_CAPS_LEN (caps) - 1; i >= 0; i--) {
|
|
s = gst_caps_get_structure_unchecked (caps, i);
|
|
if (gst_structure_is_subset (structure, s)) {
|
|
/* If we found a superset return TRUE */
|
|
return TRUE;
|
|
}
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_subset_structure_full:
|
|
* @caps: a #GstCaps
|
|
* @structure: a potential #GstStructure subset of @caps
|
|
* @features: (allow-none): a #GstCapsFeatures for @structure
|
|
*
|
|
* Checks if @structure is a subset of @caps. See gst_caps_is_subset()
|
|
* for more information.
|
|
*
|
|
* Returns: %TRUE if @structure is a subset of @caps
|
|
*
|
|
* Since: 1.2
|
|
*/
|
|
gboolean
|
|
gst_caps_is_subset_structure_full (const GstCaps * caps,
|
|
const GstStructure * structure, const GstCapsFeatures * features)
|
|
{
|
|
GstStructure *s;
|
|
GstCapsFeatures *f;
|
|
gint i;
|
|
|
|
g_return_val_if_fail (caps != NULL, FALSE);
|
|
g_return_val_if_fail (structure != NULL, FALSE);
|
|
|
|
if (CAPS_IS_ANY (caps))
|
|
return TRUE;
|
|
if (CAPS_IS_EMPTY (caps))
|
|
return FALSE;
|
|
|
|
if (!features)
|
|
features = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
for (i = GST_CAPS_LEN (caps) - 1; i >= 0; i--) {
|
|
s = gst_caps_get_structure_unchecked (caps, i);
|
|
f = gst_caps_get_features_unchecked (caps, i);
|
|
if (!f)
|
|
f = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if ((!gst_caps_features_is_any (features) || gst_caps_features_is_any (f))
|
|
&& gst_caps_features_is_equal (features, f)
|
|
&& gst_structure_is_subset (structure, s)) {
|
|
/* If we found a superset return TRUE */
|
|
return TRUE;
|
|
}
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_equal:
|
|
* @caps1: a #GstCaps
|
|
* @caps2: another #GstCaps
|
|
*
|
|
* Checks if the given caps represent the same set of caps.
|
|
*
|
|
* Returns: %TRUE if both caps are equal.
|
|
*/
|
|
gboolean
|
|
gst_caps_is_equal (const GstCaps * caps1, const GstCaps * caps2)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps1), FALSE);
|
|
g_return_val_if_fail (GST_IS_CAPS (caps2), FALSE);
|
|
|
|
if (G_UNLIKELY (caps1 == caps2))
|
|
return TRUE;
|
|
|
|
if (G_UNLIKELY (gst_caps_is_fixed (caps1) && gst_caps_is_fixed (caps2)))
|
|
return gst_caps_is_equal_fixed (caps1, caps2);
|
|
|
|
return gst_caps_is_subset (caps1, caps2) && gst_caps_is_subset (caps2, caps1);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_is_strictly_equal:
|
|
* @caps1: a #GstCaps
|
|
* @caps2: another #GstCaps
|
|
*
|
|
* Checks if the given caps are exactly the same set of caps.
|
|
*
|
|
* Returns: %TRUE if both caps are strictly equal.
|
|
*/
|
|
gboolean
|
|
gst_caps_is_strictly_equal (const GstCaps * caps1, const GstCaps * caps2)
|
|
{
|
|
int i;
|
|
GstStructure *s1, *s2;
|
|
GstCapsFeatures *f1, *f2;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps1), FALSE);
|
|
g_return_val_if_fail (GST_IS_CAPS (caps2), FALSE);
|
|
|
|
if (G_UNLIKELY (caps1 == caps2))
|
|
return TRUE;
|
|
|
|
/* if both are ANY caps, consider them strictly equal */
|
|
if (CAPS_IS_ANY (caps1))
|
|
return (CAPS_IS_ANY (caps2));
|
|
else if (CAPS_IS_ANY (caps2))
|
|
return FALSE;
|
|
|
|
if (GST_CAPS_LEN (caps1) != GST_CAPS_LEN (caps2))
|
|
return FALSE;
|
|
|
|
for (i = 0; i < GST_CAPS_LEN (caps1); i++) {
|
|
s1 = gst_caps_get_structure_unchecked (caps1, i);
|
|
f1 = gst_caps_get_features_unchecked (caps1, i);
|
|
if (!f1)
|
|
f1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
s2 = gst_caps_get_structure_unchecked (caps2, i);
|
|
f2 = gst_caps_get_features_unchecked (caps2, i);
|
|
if (!f2)
|
|
f2 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
if (gst_caps_features_is_any (f1) != gst_caps_features_is_any (f2) ||
|
|
!gst_caps_features_is_equal (f1, f2) ||
|
|
!gst_structure_is_equal (s1, s2))
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/* intersect operation */
|
|
|
|
/**
|
|
* gst_caps_can_intersect:
|
|
* @caps1: a #GstCaps to intersect
|
|
* @caps2: a #GstCaps to intersect
|
|
*
|
|
* Tries intersecting @caps1 and @caps2 and reports whether the result would not
|
|
* be empty
|
|
*
|
|
* Returns: %TRUE if intersection would be not empty
|
|
*/
|
|
gboolean
|
|
gst_caps_can_intersect (const GstCaps * caps1, const GstCaps * caps2)
|
|
{
|
|
guint64 i; /* index can be up to 2 * G_MAX_UINT */
|
|
guint j, k, len1, len2;
|
|
GstStructure *struct1;
|
|
GstStructure *struct2;
|
|
GstCapsFeatures *features1;
|
|
GstCapsFeatures *features2;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps1), FALSE);
|
|
g_return_val_if_fail (GST_IS_CAPS (caps2), FALSE);
|
|
|
|
/* caps are exactly the same pointers */
|
|
if (G_UNLIKELY (caps1 == caps2))
|
|
return TRUE;
|
|
|
|
/* empty caps on either side, return empty */
|
|
if (G_UNLIKELY (CAPS_IS_EMPTY (caps1) || CAPS_IS_EMPTY (caps2)))
|
|
return FALSE;
|
|
|
|
/* one of the caps is any */
|
|
if (G_UNLIKELY (CAPS_IS_ANY (caps1) || CAPS_IS_ANY (caps2)))
|
|
return TRUE;
|
|
|
|
/* run zigzag on top line then right line, this preserves the caps order
|
|
* much better than a simple loop.
|
|
*
|
|
* This algorithm zigzags over the caps structures as demonstrated in
|
|
* the following matrix:
|
|
*
|
|
* caps1 0 1 2 3
|
|
* +------------- total distance: +-------------
|
|
* | 1 2 4 7 0 | 0 1 2 3
|
|
* caps2 | 3 5 8 10 1 | 1 2 3 4
|
|
* | 6 9 11 12 2 | 2 3 4 5
|
|
*
|
|
* First we iterate over the caps1 structures (top line) intersecting
|
|
* the structures diagonally down, then we iterate over the caps2
|
|
* structures. The result is that the intersections are ordered based on the
|
|
* sum of the indexes in the list.
|
|
*/
|
|
len1 = GST_CAPS_LEN (caps1);
|
|
len2 = GST_CAPS_LEN (caps2);
|
|
for (i = 0; i < len1 + len2 - 1; i++) {
|
|
/* superset index goes from 0 to superset->structs->len-1 */
|
|
j = MIN (i, len1 - 1);
|
|
/* subset index stays 0 until i reaches superset->structs->len, then it
|
|
* counts up from 1 to subset->structs->len - 1 */
|
|
k = (i > j) ? (i - j) : 0; /* MAX (0, i - j) */
|
|
/* now run the diagonal line, end condition is the left or bottom
|
|
* border */
|
|
while (k < len2) {
|
|
struct1 = gst_caps_get_structure_unchecked (caps1, j);
|
|
features1 = gst_caps_get_features_unchecked (caps1, j);
|
|
if (!features1)
|
|
features1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
struct2 = gst_caps_get_structure_unchecked (caps2, k);
|
|
features2 = gst_caps_get_features_unchecked (caps2, k);
|
|
if (!features2)
|
|
features2 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if (gst_caps_features_is_equal (features1, features2) &&
|
|
gst_structure_can_intersect (struct1, struct2)) {
|
|
return TRUE;
|
|
}
|
|
/* move down left */
|
|
k++;
|
|
if (G_UNLIKELY (j == 0))
|
|
break; /* so we don't roll back to G_MAXUINT */
|
|
j--;
|
|
}
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
static GstCaps *
|
|
gst_caps_intersect_zig_zag (GstCaps * caps1, GstCaps * caps2)
|
|
{
|
|
guint64 i; /* index can be up to 2 * G_MAX_UINT */
|
|
guint j, k, len1, len2;
|
|
GstStructure *struct1;
|
|
GstStructure *struct2;
|
|
GstCapsFeatures *features1;
|
|
GstCapsFeatures *features2;
|
|
GstCaps *dest;
|
|
GstStructure *istruct;
|
|
|
|
dest = gst_caps_new_empty ();
|
|
/* run zigzag on top line then right line, this preserves the caps order
|
|
* much better than a simple loop.
|
|
*
|
|
* This algorithm zigzags over the caps structures as demonstrated in
|
|
* the following matrix:
|
|
*
|
|
* caps1
|
|
* +-------------
|
|
* | 1 2 4 7
|
|
* caps2 | 3 5 8 10
|
|
* | 6 9 11 12
|
|
*
|
|
* First we iterate over the caps1 structures (top line) intersecting
|
|
* the structures diagonally down, then we iterate over the caps2
|
|
* structures.
|
|
*/
|
|
len1 = GST_CAPS_LEN (caps1);
|
|
len2 = GST_CAPS_LEN (caps2);
|
|
for (i = 0; i < len1 + len2 - 1; i++) {
|
|
/* caps1 index goes from 0 to GST_CAPS_LEN (caps1)-1 */
|
|
j = MIN (i, len1 - 1);
|
|
/* caps2 index stays 0 until i reaches GST_CAPS_LEN (caps1), then it counts
|
|
* up from 1 to GST_CAPS_LEN (caps2) - 1 */
|
|
k = (i > j) ? (i - j) : 0; /* MAX (0, i - j) */
|
|
/* now run the diagonal line, end condition is the left or bottom
|
|
* border */
|
|
while (k < len2) {
|
|
struct1 = gst_caps_get_structure_unchecked (caps1, j);
|
|
features1 = gst_caps_get_features_unchecked (caps1, j);
|
|
if (!features1)
|
|
features1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
struct2 = gst_caps_get_structure_unchecked (caps2, k);
|
|
features2 = gst_caps_get_features_unchecked (caps2, k);
|
|
if (!features2)
|
|
features2 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if (gst_caps_features_is_equal (features1, features2)) {
|
|
istruct = gst_structure_intersect (struct1, struct2);
|
|
if (istruct) {
|
|
if (gst_caps_features_is_any (features1))
|
|
dest =
|
|
gst_caps_merge_structure_full (dest, istruct,
|
|
gst_caps_features_copy_conditional (features2));
|
|
else
|
|
dest =
|
|
gst_caps_merge_structure_full (dest, istruct,
|
|
gst_caps_features_copy_conditional (features1));
|
|
}
|
|
}
|
|
/* move down left */
|
|
k++;
|
|
if (G_UNLIKELY (j == 0))
|
|
break; /* so we don't roll back to G_MAXUINT */
|
|
j--;
|
|
}
|
|
}
|
|
return dest;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_intersect_first:
|
|
* @caps1: a #GstCaps to intersect
|
|
* @caps2: a #GstCaps to intersect
|
|
*
|
|
* Creates a new #GstCaps that contains all the formats that are common
|
|
* to both @caps1 and @caps2.
|
|
*
|
|
* Unlike @gst_caps_intersect, the returned caps will be ordered in a similar
|
|
* fashion as @caps1.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
static GstCaps *
|
|
gst_caps_intersect_first (GstCaps * caps1, GstCaps * caps2)
|
|
{
|
|
guint i;
|
|
guint j, len1, len2;
|
|
GstStructure *struct1;
|
|
GstStructure *struct2;
|
|
GstCapsFeatures *features1;
|
|
GstCapsFeatures *features2;
|
|
GstCaps *dest;
|
|
GstStructure *istruct;
|
|
|
|
dest = gst_caps_new_empty ();
|
|
len1 = GST_CAPS_LEN (caps1);
|
|
len2 = GST_CAPS_LEN (caps2);
|
|
for (i = 0; i < len1; i++) {
|
|
struct1 = gst_caps_get_structure_unchecked (caps1, i);
|
|
features1 = gst_caps_get_features_unchecked (caps1, i);
|
|
if (!features1)
|
|
features1 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
for (j = 0; j < len2; j++) {
|
|
struct2 = gst_caps_get_structure_unchecked (caps2, j);
|
|
features2 = gst_caps_get_features_unchecked (caps2, j);
|
|
if (!features2)
|
|
features2 = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if (gst_caps_features_is_equal (features1, features2)) {
|
|
istruct = gst_structure_intersect (struct1, struct2);
|
|
if (istruct) {
|
|
if (gst_caps_features_is_any (features1))
|
|
dest =
|
|
gst_caps_merge_structure_full (dest, istruct,
|
|
gst_caps_features_copy_conditional (features2));
|
|
else
|
|
dest =
|
|
gst_caps_merge_structure_full (dest, istruct,
|
|
gst_caps_features_copy_conditional (features1));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return dest;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_intersect_full:
|
|
* @caps1: a #GstCaps to intersect
|
|
* @caps2: a #GstCaps to intersect
|
|
* @mode: The intersection algorithm/mode to use
|
|
*
|
|
* Creates a new #GstCaps that contains all the formats that are common
|
|
* to both @caps1 and @caps2, the order is defined by the #GstCapsIntersectMode
|
|
* used.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_intersect_full (GstCaps * caps1, GstCaps * caps2,
|
|
GstCapsIntersectMode mode)
|
|
{
|
|
g_return_val_if_fail (GST_IS_CAPS (caps1), NULL);
|
|
g_return_val_if_fail (GST_IS_CAPS (caps2), NULL);
|
|
|
|
/* Common fast-path */
|
|
/* caps are exactly the same pointers, just copy one caps */
|
|
if (G_UNLIKELY (caps1 == caps2))
|
|
return gst_caps_ref (caps1);
|
|
|
|
/* empty caps on either side, return empty */
|
|
if (G_UNLIKELY (CAPS_IS_EMPTY (caps1) || CAPS_IS_EMPTY (caps2)))
|
|
return gst_caps_ref (GST_CAPS_NONE);
|
|
|
|
/* one of the caps is any, just copy the other caps */
|
|
if (G_UNLIKELY (CAPS_IS_ANY (caps1)))
|
|
return gst_caps_ref (caps2);
|
|
|
|
if (G_UNLIKELY (CAPS_IS_ANY (caps2)))
|
|
return gst_caps_ref (caps1);
|
|
|
|
switch (mode) {
|
|
case GST_CAPS_INTERSECT_FIRST:
|
|
return gst_caps_intersect_first (caps1, caps2);
|
|
default:
|
|
g_warning ("Unknown caps intersect mode: %d", mode);
|
|
/* fallthrough */
|
|
case GST_CAPS_INTERSECT_ZIG_ZAG:
|
|
return gst_caps_intersect_zig_zag (caps1, caps2);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_intersect:
|
|
* @caps1: a #GstCaps to intersect
|
|
* @caps2: a #GstCaps to intersect
|
|
*
|
|
* Creates a new #GstCaps that contains all the formats that are common
|
|
* to both @caps1 and @caps2. Defaults to %GST_CAPS_INTERSECT_ZIG_ZAG mode.
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_intersect (GstCaps * caps1, GstCaps * caps2)
|
|
{
|
|
return gst_caps_intersect_full (caps1, caps2, GST_CAPS_INTERSECT_ZIG_ZAG);
|
|
}
|
|
|
|
/* subtract operation */
|
|
|
|
typedef struct
|
|
{
|
|
const GstStructure *subtract_from;
|
|
GSList *put_into;
|
|
} SubtractionEntry;
|
|
|
|
static gboolean
|
|
gst_caps_structure_subtract_field (GQuark field_id, const GValue * value,
|
|
gpointer user_data)
|
|
{
|
|
SubtractionEntry *e = user_data;
|
|
GValue subtraction = { 0, };
|
|
const GValue *other;
|
|
GstStructure *structure;
|
|
|
|
other = gst_structure_id_get_value (e->subtract_from, field_id);
|
|
|
|
if (!other) {
|
|
return FALSE;
|
|
}
|
|
|
|
if (!gst_value_subtract (&subtraction, other, value))
|
|
return TRUE;
|
|
|
|
if (gst_value_compare (&subtraction, other) == GST_VALUE_EQUAL) {
|
|
g_value_unset (&subtraction);
|
|
return FALSE;
|
|
} else {
|
|
structure = gst_structure_copy (e->subtract_from);
|
|
gst_structure_id_take_value (structure, field_id, &subtraction);
|
|
e->put_into = g_slist_prepend (e->put_into, structure);
|
|
return TRUE;
|
|
}
|
|
}
|
|
|
|
static gboolean
|
|
gst_caps_structure_subtract (GSList ** into, const GstStructure * minuend,
|
|
const GstStructure * subtrahend)
|
|
{
|
|
SubtractionEntry e;
|
|
gboolean ret;
|
|
|
|
e.subtract_from = minuend;
|
|
e.put_into = NULL;
|
|
ret = gst_structure_foreach ((GstStructure *) subtrahend,
|
|
gst_caps_structure_subtract_field, &e);
|
|
|
|
if (ret) {
|
|
*into = e.put_into;
|
|
} else {
|
|
GSList *walk;
|
|
|
|
for (walk = e.put_into; walk; walk = g_slist_next (walk)) {
|
|
gst_structure_free (walk->data);
|
|
}
|
|
g_slist_free (e.put_into);
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_subtract:
|
|
* @minuend: #GstCaps to subtract from
|
|
* @subtrahend: #GstCaps to subtract
|
|
*
|
|
* Subtracts the @subtrahend from the @minuend.
|
|
* > This function does not work reliably if optional properties for caps
|
|
* > are included on one caps and omitted on the other.
|
|
*
|
|
* Returns: (transfer full): the resulting caps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_subtract (GstCaps * minuend, GstCaps * subtrahend)
|
|
{
|
|
guint i, j, sublen;
|
|
GstStructure *min;
|
|
GstStructure *sub;
|
|
GstCapsFeatures *min_f, *sub_f;
|
|
GstCaps *dest = NULL, *src;
|
|
|
|
g_return_val_if_fail (minuend != NULL, NULL);
|
|
g_return_val_if_fail (subtrahend != NULL, NULL);
|
|
|
|
if (CAPS_IS_EMPTY (minuend) || CAPS_IS_ANY (subtrahend)) {
|
|
return gst_caps_new_empty ();
|
|
}
|
|
|
|
if (CAPS_IS_EMPTY_SIMPLE (subtrahend))
|
|
return gst_caps_ref (minuend);
|
|
|
|
/* FIXME: Do we want this here or above?
|
|
The reason we need this is that there is no definition about what
|
|
ANY means for specific types, so it's not possible to reduce ANY partially
|
|
You can only remove everything or nothing and that is done above.
|
|
Note: there's a test that checks this behaviour. */
|
|
|
|
g_return_val_if_fail (!CAPS_IS_ANY (minuend), NULL);
|
|
sublen = GST_CAPS_LEN (subtrahend);
|
|
g_assert (sublen > 0);
|
|
|
|
src = _gst_caps_copy (minuend);
|
|
for (i = 0; i < sublen; i++) {
|
|
guint srclen;
|
|
|
|
sub = gst_caps_get_structure_unchecked (subtrahend, i);
|
|
sub_f = gst_caps_get_features_unchecked (subtrahend, i);
|
|
if (!sub_f)
|
|
sub_f = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if (dest) {
|
|
gst_caps_unref (src);
|
|
src = dest;
|
|
}
|
|
dest = gst_caps_new_empty ();
|
|
srclen = GST_CAPS_LEN (src);
|
|
for (j = 0; j < srclen; j++) {
|
|
min = gst_caps_get_structure_unchecked (src, j);
|
|
min_f = gst_caps_get_features_unchecked (src, j);
|
|
if (!min_f)
|
|
min_f = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
|
|
/* Same reason as above for ANY caps */
|
|
g_return_val_if_fail (!gst_caps_features_is_any (min_f), NULL);
|
|
|
|
if (gst_structure_get_name_id (min) == gst_structure_get_name_id (sub) &&
|
|
gst_caps_features_is_equal (min_f, sub_f)) {
|
|
GSList *list;
|
|
|
|
if (gst_caps_structure_subtract (&list, min, sub)) {
|
|
GSList *walk;
|
|
|
|
for (walk = list; walk; walk = g_slist_next (walk)) {
|
|
gst_caps_append_structure_unchecked (dest,
|
|
(GstStructure *) walk->data,
|
|
gst_caps_features_copy_conditional (min_f));
|
|
}
|
|
g_slist_free (list);
|
|
} else {
|
|
gst_caps_append_structure_unchecked (dest, gst_structure_copy (min),
|
|
gst_caps_features_copy_conditional (min_f));
|
|
}
|
|
} else {
|
|
gst_caps_append_structure_unchecked (dest, gst_structure_copy (min),
|
|
gst_caps_features_copy_conditional (min_f));
|
|
}
|
|
}
|
|
|
|
if (CAPS_IS_EMPTY_SIMPLE (dest)) {
|
|
gst_caps_unref (src);
|
|
return dest;
|
|
}
|
|
}
|
|
|
|
gst_caps_unref (src);
|
|
dest = gst_caps_simplify (dest);
|
|
|
|
return dest;
|
|
}
|
|
|
|
/* normalize/simplify operations */
|
|
|
|
typedef struct _NormalizeForeach
|
|
{
|
|
GstCaps *caps;
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
} NormalizeForeach;
|
|
|
|
static gboolean
|
|
gst_caps_normalize_foreach (GQuark field_id, const GValue * value, gpointer ptr)
|
|
{
|
|
NormalizeForeach *nf = (NormalizeForeach *) ptr;
|
|
GValue val = { 0 };
|
|
guint i;
|
|
|
|
if (G_VALUE_TYPE (value) == GST_TYPE_LIST) {
|
|
guint len = gst_value_list_get_size (value);
|
|
|
|
for (i = 1; i < len; i++) {
|
|
const GValue *v = gst_value_list_get_value (value, i);
|
|
GstStructure *structure = gst_structure_copy (nf->structure);
|
|
|
|
gst_structure_id_set_value (structure, field_id, v);
|
|
gst_caps_append_structure_unchecked (nf->caps, structure,
|
|
gst_caps_features_copy_conditional (nf->features));
|
|
}
|
|
|
|
gst_value_init_and_copy (&val, gst_value_list_get_value (value, 0));
|
|
gst_structure_id_take_value (nf->structure, field_id, &val);
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_normalize:
|
|
* @caps: (transfer full): a #GstCaps to normalize
|
|
*
|
|
* Returns a #GstCaps that represents the same set of formats as
|
|
* @caps, but contains no lists. Each list is expanded into separate
|
|
* #GstStructure.
|
|
*
|
|
* This function takes ownership of @caps and will call gst_caps_make_writable()
|
|
* on it so you must not use @caps afterwards unless you keep an additional
|
|
* reference to it with gst_caps_ref().
|
|
*
|
|
* Returns: (transfer full): the normalized #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_normalize (GstCaps * caps)
|
|
{
|
|
NormalizeForeach nf;
|
|
guint i;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
caps = gst_caps_make_writable (caps);
|
|
nf.caps = caps;
|
|
|
|
for (i = 0; i < gst_caps_get_size (nf.caps); i++) {
|
|
nf.structure = gst_caps_get_structure_unchecked (nf.caps, i);
|
|
nf.features = gst_caps_get_features_unchecked (nf.caps, i);
|
|
while (!gst_structure_foreach (nf.structure,
|
|
gst_caps_normalize_foreach, &nf));
|
|
}
|
|
|
|
return nf.caps;
|
|
}
|
|
|
|
static gint
|
|
gst_caps_compare_structures (gconstpointer one, gconstpointer two)
|
|
{
|
|
gint ret;
|
|
const GstStructure *struct1 = ((const GstCapsArrayElement *) one)->structure;
|
|
const GstStructure *struct2 = ((const GstCapsArrayElement *) two)->structure;
|
|
|
|
/* FIXME: this orders alphabetically, but ordering the quarks might be faster
|
|
So what's the best way? */
|
|
ret = strcmp (gst_structure_get_name (struct1),
|
|
gst_structure_get_name (struct2));
|
|
|
|
if (ret)
|
|
return ret;
|
|
|
|
return gst_structure_n_fields (struct2) - gst_structure_n_fields (struct1);
|
|
}
|
|
|
|
typedef struct
|
|
{
|
|
GQuark name;
|
|
GValue value;
|
|
GstStructure *compare;
|
|
} UnionField;
|
|
|
|
static gboolean
|
|
gst_caps_structure_figure_out_union (GQuark field_id, const GValue * value,
|
|
gpointer user_data)
|
|
{
|
|
UnionField *u = user_data;
|
|
const GValue *val = gst_structure_id_get_value (u->compare, field_id);
|
|
|
|
if (!val) {
|
|
if (u->name)
|
|
g_value_unset (&u->value);
|
|
return FALSE;
|
|
}
|
|
|
|
if (gst_value_compare (val, value) == GST_VALUE_EQUAL)
|
|
return TRUE;
|
|
|
|
if (u->name) {
|
|
g_value_unset (&u->value);
|
|
return FALSE;
|
|
}
|
|
|
|
u->name = field_id;
|
|
gst_value_union (&u->value, val, value);
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
static gboolean
|
|
gst_caps_structure_simplify (GstStructure ** result,
|
|
GstStructure * simplify, GstStructure * compare)
|
|
{
|
|
GSList *list;
|
|
UnionField field = { 0, {0,}, NULL };
|
|
|
|
/* try to subtract to get a real subset */
|
|
if (gst_caps_structure_subtract (&list, simplify, compare)) {
|
|
if (list == NULL) { /* no result */
|
|
*result = NULL;
|
|
return TRUE;
|
|
} else if (list->next == NULL) { /* one result */
|
|
*result = list->data;
|
|
g_slist_free (list);
|
|
return TRUE;
|
|
} else { /* multiple results */
|
|
g_slist_foreach (list, (GFunc) gst_structure_free, NULL);
|
|
g_slist_free (list);
|
|
list = NULL;
|
|
}
|
|
}
|
|
|
|
/* try to union both structs */
|
|
field.compare = compare;
|
|
if (gst_structure_foreach (simplify,
|
|
gst_caps_structure_figure_out_union, &field)) {
|
|
gboolean ret = FALSE;
|
|
|
|
/* now we know all of simplify's fields are the same in compare
|
|
* but at most one field: field.name */
|
|
if (G_IS_VALUE (&field.value)) {
|
|
if (gst_structure_n_fields (simplify) == gst_structure_n_fields (compare)) {
|
|
gst_structure_id_take_value (compare, field.name, &field.value);
|
|
*result = NULL;
|
|
ret = TRUE;
|
|
} else {
|
|
g_value_unset (&field.value);
|
|
}
|
|
} else
|
|
if (gst_structure_n_fields (simplify) <=
|
|
gst_structure_n_fields (compare)) {
|
|
/* compare is just more specific, will be optimized away later */
|
|
/* FIXME: do this here? */
|
|
GST_LOG ("found a case that will be optimized later.");
|
|
} else {
|
|
gchar *one = gst_structure_to_string (simplify);
|
|
gchar *two = gst_structure_to_string (compare);
|
|
|
|
GST_ERROR
|
|
("caps mismatch: structures %s and %s claim to be possible to unify, but aren't",
|
|
one, two);
|
|
g_free (one);
|
|
g_free (two);
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
static void
|
|
gst_caps_switch_structures (GstCaps * caps, GstStructure * old,
|
|
GstStructure * new, gint i)
|
|
{
|
|
gst_structure_set_parent_refcount (old, NULL);
|
|
gst_structure_free (old);
|
|
gst_structure_set_parent_refcount (new, &GST_CAPS_REFCOUNT (caps));
|
|
g_array_index (GST_CAPS_ARRAY (caps), GstCapsArrayElement, i).structure = new;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_simplify:
|
|
* @caps: (transfer full): a #GstCaps to simplify
|
|
*
|
|
* Converts the given @caps into a representation that represents the
|
|
* same set of formats, but in a simpler form. Component structures that are
|
|
* identical are merged. Component structures that have values that can be
|
|
* merged are also merged.
|
|
*
|
|
* This function takes ownership of @caps and will call gst_caps_make_writable()
|
|
* on it if necessary, so you must not use @caps afterwards unless you keep an
|
|
* additional reference to it with gst_caps_ref().
|
|
*
|
|
* This method does not preserve the original order of @caps.
|
|
*
|
|
* Returns: (transfer full): The simplified caps.
|
|
*/
|
|
GstCaps *
|
|
gst_caps_simplify (GstCaps * caps)
|
|
{
|
|
GstStructure *simplify, *compare, *result = NULL;
|
|
GstCapsFeatures *simplify_f, *compare_f;
|
|
gint i, j, start;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
|
|
/* empty/any caps are as simple as can be */
|
|
if (GST_CAPS_LEN (caps) == 0)
|
|
return caps;
|
|
|
|
start = GST_CAPS_LEN (caps) - 1;
|
|
/* one caps, already as simple as can be */
|
|
if (start == 0)
|
|
return caps;
|
|
|
|
caps = gst_caps_make_writable (caps);
|
|
|
|
g_array_sort (GST_CAPS_ARRAY (caps), gst_caps_compare_structures);
|
|
|
|
for (i = start; i >= 0; i--) {
|
|
simplify = gst_caps_get_structure_unchecked (caps, i);
|
|
simplify_f = gst_caps_get_features_unchecked (caps, i);
|
|
if (!simplify_f)
|
|
simplify_f = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
compare = gst_caps_get_structure_unchecked (caps, start);
|
|
compare_f = gst_caps_get_features_unchecked (caps, start);
|
|
if (!compare_f)
|
|
compare_f = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if (gst_structure_get_name_id (simplify) !=
|
|
gst_structure_get_name_id (compare) ||
|
|
!gst_caps_features_is_equal (simplify_f, compare_f))
|
|
start = i;
|
|
for (j = start; j >= 0; j--) {
|
|
if (j == i)
|
|
continue;
|
|
compare = gst_caps_get_structure_unchecked (caps, j);
|
|
compare_f = gst_caps_get_features_unchecked (caps, j);
|
|
if (!compare_f)
|
|
compare_f = GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY;
|
|
if (gst_structure_get_name_id (simplify) !=
|
|
gst_structure_get_name_id (compare) ||
|
|
!gst_caps_features_is_equal (simplify_f, compare_f)) {
|
|
break;
|
|
}
|
|
if (gst_caps_structure_simplify (&result, simplify, compare)) {
|
|
if (result) {
|
|
gst_caps_switch_structures (caps, simplify, result, i);
|
|
simplify = result;
|
|
} else {
|
|
gst_caps_remove_structure (caps, i);
|
|
start--;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return caps;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_fixate:
|
|
* @caps: (transfer full): a #GstCaps to fixate
|
|
*
|
|
* Modifies the given @caps into a representation with only fixed
|
|
* values. First the caps will be truncated and then the first structure will be
|
|
* fixated with gst_structure_fixate().
|
|
*
|
|
* This function takes ownership of @caps and will call gst_caps_make_writable()
|
|
* on it so you must not use @caps afterwards unless you keep an additional
|
|
* reference to it with gst_caps_ref().
|
|
*
|
|
* Note that it is not guaranteed that the returned caps have exactly one
|
|
* structure. If @caps are empty caps then the returned caps will be
|
|
* the empty too and contain no structure at all.
|
|
*
|
|
* Calling this function with ANY caps is not allowed.
|
|
*
|
|
* Returns: (transfer full): the fixated caps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_fixate (GstCaps * caps)
|
|
{
|
|
GstStructure *s;
|
|
GstCapsFeatures *f;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), NULL);
|
|
g_return_val_if_fail (!CAPS_IS_ANY (caps), NULL);
|
|
|
|
/* default fixation */
|
|
caps = gst_caps_truncate (caps);
|
|
caps = gst_caps_make_writable (caps);
|
|
|
|
/* need to return early here because empty caps have no structure
|
|
* but must return after make_writable() because the documentation
|
|
* specifies that it will call make_writable() on the return value
|
|
* and callers might assume writable caps.
|
|
*/
|
|
if (CAPS_IS_EMPTY (caps))
|
|
return caps;
|
|
|
|
s = gst_caps_get_structure (caps, 0);
|
|
gst_structure_fixate (s);
|
|
|
|
/* Set features to sysmem if they're still ANY */
|
|
f = gst_caps_get_features_unchecked (caps, 0);
|
|
if (f && gst_caps_features_is_any (f)) {
|
|
f = gst_caps_features_new_empty ();
|
|
gst_caps_set_features (caps, 0, f);
|
|
}
|
|
|
|
return caps;
|
|
}
|
|
|
|
/* utility */
|
|
|
|
static gchar *
|
|
caps_serialize (const GstCaps * caps, GstSerializeFlags flags)
|
|
{
|
|
guint i, slen, clen;
|
|
GString *s;
|
|
gboolean nested_structs_brackets =
|
|
!(flags & GST_SERIALIZE_FLAG_BACKWARD_COMPAT);
|
|
|
|
/* NOTE: This function is potentially called by the debug system,
|
|
* so any calls to gst_log() (and GST_DEBUG(), GST_LOG(), etc.)
|
|
* should be careful to avoid recursion. This includes any functions
|
|
* called by gst_caps_to_string. In particular, calls should
|
|
* not use the GST_PTR_FORMAT extension. */
|
|
|
|
if (caps == NULL) {
|
|
return g_strdup ("NULL");
|
|
}
|
|
if (CAPS_IS_ANY (caps)) {
|
|
return g_strdup ("ANY");
|
|
}
|
|
if (CAPS_IS_EMPTY_SIMPLE (caps)) {
|
|
return g_strdup ("EMPTY");
|
|
}
|
|
|
|
/* estimate a rough string length to avoid unnecessary reallocs in GString */
|
|
slen = 0;
|
|
clen = GST_CAPS_LEN (caps);
|
|
for (i = 0; i < clen; i++) {
|
|
GstCapsFeatures *f;
|
|
|
|
slen +=
|
|
STRUCTURE_ESTIMATED_STRING_LEN (gst_caps_get_structure_unchecked
|
|
(caps, i));
|
|
f = gst_caps_get_features_unchecked (caps, i);
|
|
if (f)
|
|
slen += FEATURES_ESTIMATED_STRING_LEN (f);
|
|
}
|
|
|
|
s = g_string_sized_new (slen);
|
|
for (i = 0; i < clen; i++) {
|
|
GstStructure *structure;
|
|
GstCapsFeatures *features;
|
|
|
|
if (i > 0) {
|
|
/* ';' is now added by gst_structure_to_string */
|
|
g_string_append_c (s, ' ');
|
|
}
|
|
|
|
structure = gst_caps_get_structure_unchecked (caps, i);
|
|
features = gst_caps_get_features_unchecked (caps, i);
|
|
|
|
g_string_append (s, gst_structure_get_name (structure));
|
|
if (features && (gst_caps_features_is_any (features)
|
|
|| !gst_caps_features_is_equal (features,
|
|
GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY))) {
|
|
g_string_append_c (s, '(');
|
|
priv_gst_caps_features_append_to_gstring (features, s);
|
|
g_string_append_c (s, ')');
|
|
}
|
|
priv_gst_structure_append_to_gstring (structure, s,
|
|
nested_structs_brackets);
|
|
}
|
|
if (s->len && s->str[s->len - 1] == ';') {
|
|
/* remove latest ';' */
|
|
s->str[--s->len] = '\0';
|
|
}
|
|
return g_string_free (s, FALSE);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_to_string:
|
|
* @caps: a #GstCaps
|
|
*
|
|
* Converts @caps to a string representation. This string representation
|
|
* can be converted back to a #GstCaps by gst_caps_from_string().
|
|
*
|
|
* For debugging purposes its easier to do something like this:
|
|
*
|
|
* ``` C
|
|
* GST_LOG ("caps are %" GST_PTR_FORMAT, caps);
|
|
* ```
|
|
*
|
|
* This prints the caps in human readable form.
|
|
*
|
|
* The implementation of serialization up to 1.20 would lead to unexpected results
|
|
* when there were nested #GstCaps / #GstStructure deeper than one level.
|
|
*
|
|
* Returns: (transfer full): a newly allocated string representing @caps.
|
|
*/
|
|
gchar *
|
|
gst_caps_to_string (const GstCaps * caps)
|
|
{
|
|
return caps_serialize (caps, GST_SERIALIZE_FLAG_BACKWARD_COMPAT);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_serialize:
|
|
* @caps: a #GstCaps
|
|
* @flags: a #GstSerializeFlags
|
|
*
|
|
* Converts @caps to a string representation. This string representation can be
|
|
* converted back to a #GstCaps by gst_caps_from_string().
|
|
*
|
|
* This prints the caps in human readable form.
|
|
*
|
|
* This version of the caps serialization function introduces support for nested
|
|
* structures and caps but the resulting strings won't be parsable with
|
|
* GStreamer prior to 1.20 unless #GST_SERIALIZE_FLAG_BACKWARD_COMPAT is passed
|
|
* as @flag.
|
|
*
|
|
* Returns: (transfer full): a newly allocated string representing @caps.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
gchar *
|
|
gst_caps_serialize (const GstCaps * caps, GstSerializeFlags flags)
|
|
{
|
|
return caps_serialize (caps, flags);
|
|
}
|
|
|
|
static gboolean
|
|
gst_caps_from_string_inplace (GstCaps * caps, const gchar * string)
|
|
{
|
|
GstStructure *structure;
|
|
gchar *s, *copy, *end, *next, save;
|
|
|
|
if (strcmp ("ANY", string) == 0) {
|
|
GST_CAPS_FLAGS (caps) = GST_CAPS_FLAG_ANY;
|
|
return TRUE;
|
|
}
|
|
|
|
if (strcmp ("EMPTY", string) == 0 || strcmp ("NONE", string) == 0) {
|
|
return TRUE;
|
|
}
|
|
|
|
copy = s = g_strdup (string);
|
|
do {
|
|
GstCapsFeatures *features = NULL;
|
|
|
|
while (g_ascii_isspace (*s))
|
|
s++;
|
|
if (*s == '\0') {
|
|
break;
|
|
}
|
|
|
|
if (!priv_gst_structure_parse_name (s, &s, &end, &next, FALSE)) {
|
|
g_free (copy);
|
|
return FALSE;
|
|
}
|
|
|
|
save = *end;
|
|
*end = '\0';
|
|
structure = gst_structure_new_empty (s);
|
|
*end = save;
|
|
|
|
if (structure == NULL) {
|
|
g_free (copy);
|
|
return FALSE;
|
|
}
|
|
|
|
s = next;
|
|
|
|
if (*s == '\0') {
|
|
goto append;
|
|
}
|
|
|
|
if (*s == '(') {
|
|
s++;
|
|
end = s;
|
|
|
|
while (TRUE) {
|
|
if (*end == '\0') {
|
|
break;
|
|
} else if (*end == ')') {
|
|
break;
|
|
} else {
|
|
end++;
|
|
}
|
|
}
|
|
|
|
save = *end;
|
|
*end = '\0';
|
|
features = gst_caps_features_from_string (s);
|
|
if (!features) {
|
|
gst_structure_free (structure);
|
|
g_free (copy);
|
|
return FALSE;
|
|
}
|
|
*end = save;
|
|
s = end;
|
|
if (save == ')')
|
|
s++;
|
|
}
|
|
|
|
if (*s == '\0') {
|
|
goto append;
|
|
}
|
|
|
|
if (!priv_gst_structure_parse_fields (s, &s, structure)) {
|
|
gst_structure_free (structure);
|
|
if (features)
|
|
gst_caps_features_free (features);
|
|
g_free (copy);
|
|
return FALSE;
|
|
}
|
|
|
|
append:
|
|
gst_caps_append_structure_unchecked (caps, structure, features);
|
|
features = NULL;
|
|
if (*s == '\0')
|
|
break;
|
|
} while (TRUE);
|
|
|
|
g_free (copy);
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_from_string:
|
|
* @string: a string to convert to #GstCaps
|
|
*
|
|
* Converts @caps from a string representation.
|
|
*
|
|
* The implementation of serialization up to 1.20 would lead to unexpected results
|
|
* when there were nested #GstCaps / #GstStructure deeper than one level.
|
|
*
|
|
* Returns: (transfer full) (nullable): a newly allocated #GstCaps
|
|
*/
|
|
GstCaps *
|
|
gst_caps_from_string (const gchar * string)
|
|
{
|
|
GstCaps *caps;
|
|
|
|
g_return_val_if_fail (string, FALSE);
|
|
|
|
caps = gst_caps_new_empty ();
|
|
if (gst_caps_from_string_inplace (caps, string)) {
|
|
return caps;
|
|
} else {
|
|
gst_caps_unref (caps);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gst_caps_transform_to_string (const GValue * src_value, GValue * dest_value)
|
|
{
|
|
g_return_if_fail (G_IS_VALUE (src_value));
|
|
g_return_if_fail (G_IS_VALUE (dest_value));
|
|
g_return_if_fail (G_VALUE_HOLDS (src_value, GST_TYPE_CAPS));
|
|
g_return_if_fail (G_VALUE_HOLDS (dest_value, G_TYPE_STRING)
|
|
|| G_VALUE_HOLDS (dest_value, G_TYPE_POINTER));
|
|
|
|
g_value_take_string (dest_value,
|
|
gst_caps_to_string (gst_value_get_caps (src_value)));
|
|
}
|
|
|
|
/**
|
|
* gst_caps_foreach:
|
|
* @caps: a #GstCaps
|
|
* @func: (scope call): a function to call for each field
|
|
* @user_data: (closure): private data
|
|
*
|
|
* Calls the provided function once for each structure and caps feature in the
|
|
* #GstCaps. The function must not modify the fields.
|
|
* Also see gst_caps_map_in_place() and gst_caps_filter_and_map_in_place().
|
|
*
|
|
* Returns: %TRUE if the supplied function returns %TRUE for each call,
|
|
* %FALSE otherwise.
|
|
*
|
|
* Since: 1.6
|
|
*/
|
|
gboolean
|
|
gst_caps_foreach (const GstCaps * caps, GstCapsForeachFunc func,
|
|
gpointer user_data)
|
|
{
|
|
guint i, n;
|
|
GstCapsFeatures *features;
|
|
GstStructure *structure;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), FALSE);
|
|
g_return_val_if_fail (func != NULL, FALSE);
|
|
|
|
n = GST_CAPS_LEN (caps);
|
|
|
|
for (i = 0; i < n; i++) {
|
|
features = gst_caps_get_features_unchecked (caps, i);
|
|
structure = gst_caps_get_structure_unchecked (caps, i);
|
|
|
|
ret = func (features, structure, user_data);
|
|
if (G_UNLIKELY (!ret))
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_map_in_place:
|
|
* @caps: a #GstCaps
|
|
* @func: (scope call): a function to call for each field
|
|
* @user_data: (closure): private data
|
|
*
|
|
* Calls the provided function once for each structure and caps feature in the
|
|
* #GstCaps. In contrast to gst_caps_foreach(), the function may modify but not
|
|
* delete the structures and features. The caps must be mutable.
|
|
*
|
|
* Returns: %TRUE if the supplied function returns %TRUE for each call,
|
|
* %FALSE otherwise.
|
|
*
|
|
* Since: 1.6
|
|
*/
|
|
gboolean
|
|
gst_caps_map_in_place (GstCaps * caps, GstCapsMapFunc func, gpointer user_data)
|
|
{
|
|
guint i, n;
|
|
GstCapsFeatures *features;
|
|
GstStructure *structure;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (GST_IS_CAPS (caps), FALSE);
|
|
g_return_val_if_fail (gst_caps_is_writable (caps), FALSE);
|
|
g_return_val_if_fail (func != NULL, FALSE);
|
|
|
|
n = GST_CAPS_LEN (caps);
|
|
|
|
for (i = 0; i < n; i++) {
|
|
features = gst_caps_get_features_unchecked (caps, i);
|
|
structure = gst_caps_get_structure_unchecked (caps, i);
|
|
|
|
/* Provide sysmem features if there are none yet */
|
|
if (!features) {
|
|
features =
|
|
gst_caps_features_copy (GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY);
|
|
gst_caps_set_features (caps, i, features);
|
|
}
|
|
|
|
ret = func (features, structure, user_data);
|
|
if (G_UNLIKELY (!ret))
|
|
return FALSE;
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* gst_caps_filter_and_map_in_place:
|
|
* @caps: a #GstCaps
|
|
* @func: (scope call): a function to call for each field
|
|
* @user_data: (closure): private data
|
|
*
|
|
* Calls the provided function once for each structure and caps feature in the
|
|
* #GstCaps. In contrast to gst_caps_foreach(), the function may modify the
|
|
* structure and features. In contrast to gst_caps_filter_and_map_in_place(),
|
|
* the structure and features are removed from the caps if %FALSE is returned
|
|
* from the function.
|
|
* The caps must be mutable.
|
|
*
|
|
* Since: 1.6
|
|
*/
|
|
void
|
|
gst_caps_filter_and_map_in_place (GstCaps * caps, GstCapsFilterMapFunc func,
|
|
gpointer user_data)
|
|
{
|
|
guint i, n;
|
|
GstCapsFeatures *features;
|
|
GstStructure *structure;
|
|
gboolean ret;
|
|
|
|
g_return_if_fail (GST_IS_CAPS (caps));
|
|
g_return_if_fail (gst_caps_is_writable (caps));
|
|
g_return_if_fail (func != NULL);
|
|
|
|
n = GST_CAPS_LEN (caps);
|
|
|
|
for (i = 0; i < n;) {
|
|
features = gst_caps_get_features_unchecked (caps, i);
|
|
structure = gst_caps_get_structure_unchecked (caps, i);
|
|
|
|
/* Provide sysmem features if there are none yet */
|
|
if (!features) {
|
|
features =
|
|
gst_caps_features_copy (GST_CAPS_FEATURES_MEMORY_SYSTEM_MEMORY);
|
|
gst_caps_set_features (caps, i, features);
|
|
}
|
|
|
|
ret = func (features, structure, user_data);
|
|
if (!ret) {
|
|
GST_CAPS_ARRAY (caps) = g_array_remove_index (GST_CAPS_ARRAY (caps), i);
|
|
|
|
gst_structure_set_parent_refcount (structure, NULL);
|
|
gst_structure_free (structure);
|
|
if (features) {
|
|
gst_caps_features_set_parent_refcount (features, NULL);
|
|
gst_caps_features_free (features);
|
|
}
|
|
|
|
n = GST_CAPS_LEN (caps);
|
|
} else {
|
|
i++;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gst_caps_copy:
|
|
* @caps: a #GstCaps.
|
|
*
|
|
* Creates a new #GstCaps as a copy of the old @caps. The new caps will have a
|
|
* refcount of 1, owned by the caller. The structures are copied as well.
|
|
*
|
|
* Note that this function is the semantic equivalent of a gst_caps_ref()
|
|
* followed by a gst_caps_make_writable(). If you only want to hold on to a
|
|
* reference to the data, you should use gst_caps_ref().
|
|
*
|
|
* Returns: (transfer full): the new #GstCaps
|
|
*/
|
|
GstCaps *(gst_caps_copy) (const GstCaps * caps)
|
|
{
|
|
return GST_CAPS (gst_mini_object_copy (GST_MINI_OBJECT_CAST (caps)));
|
|
}
|
|
|
|
/**
|
|
* gst_caps_ref: (skip)
|
|
* @caps: the #GstCaps to reference
|
|
*
|
|
* Adds a reference to a #GstCaps object.
|
|
*
|
|
* From this point on, until the caller calls gst_caps_unref() or
|
|
* gst_caps_make_writable(), it is guaranteed that the caps object will not
|
|
* change. This means its structures won't change, etc. To use a #GstCaps
|
|
* object, you must always have a refcount on it -- either the one made
|
|
* implicitly by e.g. gst_caps_new_simple(), or via taking one explicitly with
|
|
* this function.
|
|
*
|
|
* Returns: the same #GstCaps object.
|
|
*/
|
|
GstCaps *
|
|
gst_caps_ref (GstCaps * caps)
|
|
{
|
|
return (GstCaps *) gst_mini_object_ref (GST_MINI_OBJECT_CAST (caps));
|
|
}
|
|
|
|
/**
|
|
* gst_caps_unref: (skip)
|
|
* @caps: a #GstCaps.
|
|
*
|
|
* Unrefs a #GstCaps and frees all its structures and the
|
|
* structures' values when the refcount reaches 0.
|
|
*/
|
|
void
|
|
gst_caps_unref (GstCaps * caps)
|
|
{
|
|
gst_mini_object_unref (GST_MINI_OBJECT_CAST (caps));
|
|
}
|
|
|
|
/**
|
|
* gst_clear_caps: (skip)
|
|
* @caps_ptr: a pointer to a #GstCaps reference
|
|
*
|
|
* Clears a reference to a #GstCaps.
|
|
*
|
|
* @caps_ptr must not be %NULL.
|
|
*
|
|
* If the reference is %NULL then this function does nothing. Otherwise, the
|
|
* reference count of the caps is decreased and the pointer is set to %NULL.
|
|
*
|
|
* Since: 1.16
|
|
*/
|
|
void
|
|
gst_clear_caps (GstCaps ** caps_ptr)
|
|
{
|
|
gst_clear_mini_object ((GstMiniObject **) caps_ptr);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_replace: (skip)
|
|
* @old_caps: (inout) (transfer full) (nullable): pointer to a pointer
|
|
* to a #GstCaps to be replaced.
|
|
* @new_caps: (transfer none) (allow-none): pointer to a #GstCaps that will
|
|
* replace the caps pointed to by @old_caps.
|
|
*
|
|
* Modifies a pointer to a #GstCaps to point to a different #GstCaps. The
|
|
* modification is done atomically (so this is useful for ensuring thread safety
|
|
* in some cases), and the reference counts are updated appropriately (the old
|
|
* caps is unreffed, the new is reffed).
|
|
*
|
|
* Either @new_caps or the #GstCaps pointed to by @old_caps may be %NULL.
|
|
*
|
|
* Returns: %TRUE if @new_caps was different from @old_caps
|
|
*/
|
|
gboolean
|
|
gst_caps_replace (GstCaps ** old_caps, GstCaps * new_caps)
|
|
{
|
|
return gst_mini_object_replace ((GstMiniObject **) old_caps,
|
|
(GstMiniObject *) new_caps);
|
|
}
|
|
|
|
/**
|
|
* gst_caps_take: (skip)
|
|
* @old_caps: (inout) (transfer full): pointer to a pointer to a #GstCaps to be
|
|
* replaced.
|
|
* @new_caps: (transfer full) (allow-none): pointer to a #GstCaps that will
|
|
* replace the caps pointed to by @old_caps.
|
|
*
|
|
* Modifies a pointer to a #GstCaps to point to a different #GstCaps. This
|
|
* function is similar to gst_caps_replace() except that it takes ownership
|
|
* of @new_caps.
|
|
*
|
|
* Returns: %TRUE if @new_caps was different from @old_caps
|
|
*/
|
|
gboolean
|
|
gst_caps_take (GstCaps ** old_caps, GstCaps * new_caps)
|
|
{
|
|
return gst_mini_object_take ((GstMiniObject **) old_caps,
|
|
(GstMiniObject *) new_caps);
|
|
}
|