gst/gstvalue.c

   1 /* GStreamer
   2  * Copyright (C) <2003> David A. Schleef <ds@schleef.org>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /**
  21  * SECTION:gstvalue
  22  * @short_description: GValue implementations specific
  23  * to GStreamer
  24  *
  25  * GValue implementations specific to GStreamer.
  26  *
  27  * Note that operations on the same #GValue from multiple threads may lead to
  28  * undefined behaviour.
  29  *
  30  * Last reviewed on 2008-03-11 (0.10.18)
  31  */
  32
  33 #ifdef HAVE_CONFIG_H
  34 #include "config.h"
  35 #endif
  36 #include <math.h>
  37 #include <stdio.h>
  38 #include <stdlib.h>
  39 #include <string.h>
  40 #include <ctype.h>
  41
  42 #include "gst_private.h"
  43 #include "glib-compat-private.h"
  44 #include <gst/gst.h>
  45 #include <gobject/gvaluecollector.h>
  46 #include "gstutils.h"
  47
  48 /* GstValueUnionFunc:
  49  * @dest: a #GValue for the result
  50  * @value1: a #GValue operand
  51  * @value2: a #GValue operand
  52  *
  53  * Used by gst_value_union() to perform unification for a specific #GValue
  54  * type. Register a new implementation with gst_value_register_union_func().
  55  *
  56  * Returns: %TRUE if a union was successful
  57  */
  58 typedef gboolean (*GstValueUnionFunc) (GValue * dest,
  59     const GValue * value1, const GValue * value2);
  60
  61 /* GstValueIntersectFunc:
  62  * @dest: (out caller-allocates): a #GValue for the result
  63  * @value1: a #GValue operand
  64  * @value2: a #GValue operand
  65  *
  66  * Used by gst_value_intersect() to perform intersection for a specific #GValue
  67  * type. If the intersection is non-empty, the result is
  68  * placed in @dest and TRUE is returned.  If the intersection is
  69  * empty, @dest is unmodified and FALSE is returned.
  70  * Register a new implementation with gst_value_register_intersect_func().
  71  *
  72  * Returns: %TRUE if the values can intersect
  73  */
  74 typedef gboolean (*GstValueIntersectFunc) (GValue * dest,
  75     const GValue * value1, const GValue * value2);
  76
  77 /* GstValueSubtractFunc:
  78  * @dest: (out caller-allocates): a #GValue for the result
  79  * @minuend: a #GValue operand
  80  * @subtrahend: a #GValue operand
  81  *
  82  * Used by gst_value_subtract() to perform subtraction for a specific #GValue
  83  * type. Register a new implementation with gst_value_register_subtract_func().
  84  *
  85  * Returns: %TRUE if the subtraction is not empty
  86  */
  87 typedef gboolean (*GstValueSubtractFunc) (GValue * dest,
  88     const GValue * minuend, const GValue * subtrahend);
  89
  90 static void gst_value_register_union_func (GType type1,
  91     GType type2, GstValueUnionFunc func);
  92 static void gst_value_register_intersect_func (GType type1,
  93     GType type2, GstValueIntersectFunc func);
  94 static void gst_value_register_subtract_func (GType minuend_type,
  95     GType subtrahend_type, GstValueSubtractFunc func);
  96
  97 typedef struct _GstValueUnionInfo GstValueUnionInfo;
  98 struct _GstValueUnionInfo
  99 {
 100   GType type1;
 101   GType type2;
 102   GstValueUnionFunc func;
 103 };
 104
 105 typedef struct _GstValueIntersectInfo GstValueIntersectInfo;
 106 struct _GstValueIntersectInfo
 107 {
 108   GType type1;
 109   GType type2;
 110   GstValueIntersectFunc func;
 111 };
 112
 113 typedef struct _GstValueSubtractInfo GstValueSubtractInfo;
 114 struct _GstValueSubtractInfo
 115 {
 116   GType minuend;
 117   GType subtrahend;
 118   GstValueSubtractFunc func;
 119 };
 120
 121 #define FUNDAMENTAL_TYPE_ID_MAX \
 122     (G_TYPE_FUNDAMENTAL_MAX >> G_TYPE_FUNDAMENTAL_SHIFT)
 123 #define FUNDAMENTAL_TYPE_ID(type) \
 124     ((type) >> G_TYPE_FUNDAMENTAL_SHIFT)
 125
 126 #define VALUE_LIST_SIZE(v) (((GArray *) (v)->data[0].v_pointer)->len)
 127 #define VALUE_LIST_GET_VALUE(v, index) ((const GValue *) &g_array_index ((GArray *) (v)->data[0].v_pointer, GValue, (index)))
 128
 129 static GArray *gst_value_table;
 130 static GHashTable *gst_value_hash;
 131 static GstValueTable *gst_value_tables_fundamental[FUNDAMENTAL_TYPE_ID_MAX + 1];
 132 static GArray *gst_value_union_funcs;
 133 static GArray *gst_value_intersect_funcs;
 134 static GArray *gst_value_subtract_funcs;
 135
 136 /* Forward declarations */
 137 static gchar *gst_value_serialize_fraction (const GValue * value);
 138
 139 static GstValueCompareFunc gst_value_get_compare_func (const GValue * value1);
 140 static gint gst_value_compare_with_func (const GValue * value1,
 141     const GValue * value2, GstValueCompareFunc compare);
 142
 143 static gchar *gst_string_wrap (const gchar * s);
 144 static gchar *gst_string_take_and_wrap (gchar * s);
 145 static gchar *gst_string_unwrap (const gchar * s);
 146
 147 static inline GstValueTable *
 148 gst_value_hash_lookup_type (GType type)
 149 {
 150   if (G_LIKELY (G_TYPE_IS_FUNDAMENTAL (type)))
 151     return gst_value_tables_fundamental[FUNDAMENTAL_TYPE_ID (type)];
 152   else
 153     return g_hash_table_lookup (gst_value_hash, (gpointer) type);
 154 }
 155
 156 static void
 157 gst_value_hash_add_type (GType type, const GstValueTable * table)
 158 {
 159   if (G_TYPE_IS_FUNDAMENTAL (type))
 160     gst_value_tables_fundamental[FUNDAMENTAL_TYPE_ID (type)] = (gpointer) table;
 161
 162   g_hash_table_insert (gst_value_hash, (gpointer) type, (gpointer) table);
 163 }
 164
 165 /********
 166  * list *
 167  ********/
 168
 169 /* two helper functions to serialize/stringify any type of list
 170  * regular lists are done with { }, arrays with < >
 171  */
 172 static gchar *
 173 gst_value_serialize_any_list (const GValue * value, const gchar * begin,
 174     const gchar * end)
 175 {
 176   guint i;
 177   GArray *array = value->data[0].v_pointer;
 178   GString *s;
 179   GValue *v;
 180   gchar *s_val;
 181   guint alen = array->len;
 182
 183   /* estimate minimum string length to minimise re-allocs in GString */
 184   s = g_string_sized_new (2 + (6 * alen) + 2);
 185   g_string_append (s, begin);
 186   for (i = 0; i < alen; i++) {
 187     v = &g_array_index (array, GValue, i);
 188     s_val = gst_value_serialize (v);
 189     g_string_append (s, s_val);
 190     g_free (s_val);
 191     if (i < alen - 1) {
 192       g_string_append_len (s, ", ", 2);
 193     }
 194   }
 195   g_string_append (s, end);
 196   return g_string_free (s, FALSE);
 197 }
 198
 199 static void
 200 gst_value_transform_any_list_string (const GValue * src_value,
 201     GValue * dest_value, const gchar * begin, const gchar * end)
 202 {
 203   GValue *list_value;
 204   GArray *array;
 205   GString *s;
 206   guint i;
 207   gchar *list_s;
 208   guint alen;
 209
 210   array = src_value->data[0].v_pointer;
 211   alen = array->len;
 212
 213   /* estimate minimum string length to minimise re-allocs in GString */
 214   s = g_string_sized_new (2 + (10 * alen) + 2);
 215   g_string_append (s, begin);
 216   for (i = 0; i < alen; i++) {
 217     list_value = &g_array_index (array, GValue, i);
 218
 219     if (i != 0) {
 220       g_string_append_len (s, ", ", 2);
 221     }
 222     list_s = g_strdup_value_contents (list_value);
 223     g_string_append (s, list_s);
 224     g_free (list_s);
 225   }
 226   g_string_append (s, end);
 227
 228   dest_value->data[0].v_pointer = g_string_free (s, FALSE);
 229 }
 230
 231 /*
 232  * helper function to see if a type is fixed. Is used internally here and
 233  * there. Do not export, since it doesn't work for types where the content
 234  * decides the fixedness (e.g. GST_TYPE_ARRAY).
 235  */
 236 static gboolean
 237 gst_type_is_fixed (GType type)
 238 {
 239   /* the basic int, string, double types */
 240   if (type <= G_TYPE_MAKE_FUNDAMENTAL (G_TYPE_RESERVED_GLIB_LAST)) {
 241     return TRUE;
 242   }
 243   /* our fundamental types that are certainly not fixed */
 244   if (type == GST_TYPE_INT_RANGE || type == GST_TYPE_DOUBLE_RANGE ||
 245       type == GST_TYPE_INT64_RANGE ||
 246       type == GST_TYPE_LIST || type == GST_TYPE_FRACTION_RANGE) {
 247     return FALSE;
 248   }
 249   /* other (boxed) types that are fixed */
 250   if (type == GST_TYPE_BUFFER) {
 251     return TRUE;
 252   }
 253   /* heavy checks */
 254   if (G_TYPE_IS_FUNDAMENTAL (type) || G_TYPE_FUNDAMENTAL (type) <=
 255       G_TYPE_MAKE_FUNDAMENTAL (G_TYPE_RESERVED_GLIB_LAST)) {
 256     return TRUE;
 257   }
 258
 259   return FALSE;
 260 }
 261
 262 /* GValue functions usable for both regular lists and arrays */
 263 static void
 264 gst_value_init_list_or_array (GValue * value)
 265 {
 266   value->data[0].v_pointer = g_array_new (FALSE, TRUE, sizeof (GValue));
 267 }
 268
 269 static GArray *
 270 copy_garray_of_gstvalue (const GArray * src)
 271 {
 272   GArray *dest;
 273   guint i, len;
 274
 275   len = src->len;
 276   dest = g_array_sized_new (FALSE, TRUE, sizeof (GValue), len);
 277   g_array_set_size (dest, len);
 278   for (i = 0; i < len; i++) {
 279     gst_value_init_and_copy (&g_array_index (dest, GValue, i),
 280         &g_array_index (src, GValue, i));
 281   }
 282
 283   return dest;
 284 }
 285
 286 static void
 287 gst_value_copy_list_or_array (const GValue * src_value, GValue * dest_value)
 288 {
 289   dest_value->data[0].v_pointer =
 290       copy_garray_of_gstvalue ((GArray *) src_value->data[0].v_pointer);
 291 }
 292
 293 static void
 294 gst_value_free_list_or_array (GValue * value)
 295 {
 296   guint i, len;
 297   GArray *src = (GArray *) value->data[0].v_pointer;
 298   len = src->len;
 299
 300   if ((value->data[1].v_uint & G_VALUE_NOCOPY_CONTENTS) == 0) {
 301     for (i = 0; i < len; i++) {
 302       g_value_unset (&g_array_index (src, GValue, i));
 303     }
 304     g_array_free (src, TRUE);
 305   }
 306 }
 307
 308 static gpointer
 309 gst_value_list_or_array_peek_pointer (const GValue * value)
 310 {
 311   return value->data[0].v_pointer;
 312 }
 313
 314 static gchar *
 315 gst_value_collect_list_or_array (GValue * value, guint n_collect_values,
 316     GTypeCValue * collect_values, guint collect_flags)
 317 {
 318   if (collect_flags & G_VALUE_NOCOPY_CONTENTS) {
 319     value->data[0].v_pointer = collect_values[0].v_pointer;
 320     value->data[1].v_uint = G_VALUE_NOCOPY_CONTENTS;
 321   } else {
 322     value->data[0].v_pointer =
 323         copy_garray_of_gstvalue ((GArray *) collect_values[0].v_pointer);
 324   }
 325   return NULL;
 326 }
 327
 328 static gchar *
 329 gst_value_lcopy_list_or_array (const GValue * value, guint n_collect_values,
 330     GTypeCValue * collect_values, guint collect_flags)
 331 {
 332   GArray **dest = collect_values[0].v_pointer;
 333
 334   if (!dest)
 335     return g_strdup_printf ("value location for `%s' passed as NULL",
 336         G_VALUE_TYPE_NAME (value));
 337   if (!value->data[0].v_pointer)
 338     return g_strdup_printf ("invalid value given for `%s'",
 339         G_VALUE_TYPE_NAME (value));
 340   if (collect_flags & G_VALUE_NOCOPY_CONTENTS) {
 341     *dest = (GArray *) value->data[0].v_pointer;
 342   } else {
 343     *dest = copy_garray_of_gstvalue ((GArray *) value->data[0].v_pointer);
 344   }
 345   return NULL;
 346 }
 347
 348 static gboolean
 349 gst_value_list_or_array_get_basic_type (const GValue * value, GType * type)
 350 {
 351   if (G_UNLIKELY (value == NULL))
 352     return FALSE;
 353
 354   if (GST_VALUE_HOLDS_LIST (value)) {
 355     if (VALUE_LIST_SIZE (value) == 0)
 356       return FALSE;
 357     return gst_value_list_or_array_get_basic_type (VALUE_LIST_GET_VALUE (value,
 358             0), type);
 359   }
 360   if (GST_VALUE_HOLDS_ARRAY (value)) {
 361     const GArray *array = (const GArray *) value->data[0].v_pointer;
 362     if (array->len == 0)
 363       return FALSE;
 364     return gst_value_list_or_array_get_basic_type (&g_array_index (array,
 365             GValue, 0), type);
 366   }
 367
 368   *type = G_VALUE_TYPE (value);
 369
 370   return TRUE;
 371 }
 372
 373 #define IS_RANGE_COMPAT(type1,type2,t1,t2) \
 374   (((t1) == (type1) && (t2) == (type2)) || ((t2) == (type1) && (t1) == (type2)))
 375
 376 static gboolean
 377 gst_value_list_or_array_are_compatible (const GValue * value1,
 378     const GValue * value2)
 379 {
 380   GType basic_type1, basic_type2;
 381
 382   /* empty or same type is OK */
 383   if (!gst_value_list_or_array_get_basic_type (value1, &basic_type1) ||
 384       !gst_value_list_or_array_get_basic_type (value2, &basic_type2) ||
 385       basic_type1 == basic_type2)
 386     return TRUE;
 387
 388   /* ranges are distinct types for each bound type... */
 389   if (IS_RANGE_COMPAT (G_TYPE_INT, GST_TYPE_INT_RANGE, basic_type1,
 390           basic_type2))
 391     return TRUE;
 392   if (IS_RANGE_COMPAT (G_TYPE_INT64, GST_TYPE_INT64_RANGE, basic_type1,
 393           basic_type2))
 394     return TRUE;
 395   if (IS_RANGE_COMPAT (G_TYPE_DOUBLE, GST_TYPE_DOUBLE_RANGE, basic_type1,
 396           basic_type2))
 397     return TRUE;
 398   if (IS_RANGE_COMPAT (GST_TYPE_FRACTION, GST_TYPE_FRACTION_RANGE, basic_type1,
 399           basic_type2))
 400     return TRUE;
 401
 402   return FALSE;
 403 }
 404
 405 /**
 406  * gst_value_list_append_value:
 407  * @value: a #GValue of type #GST_TYPE_LIST
 408  * @append_value: the value to append
 409  *
 410  * Appends @append_value to the GstValueList in @value.
 411  */
 412 void
 413 gst_value_list_append_value (GValue * value, const GValue * append_value)
 414 {
 415   GValue val = { 0, };
 416
 417   g_return_if_fail (GST_VALUE_HOLDS_LIST (value));
 418   g_return_if_fail (G_IS_VALUE (append_value));
 419   g_return_if_fail (gst_value_list_or_array_are_compatible (value,
 420           append_value));
 421
 422   gst_value_init_and_copy (&val, append_value);
 423   g_array_append_vals ((GArray *) value->data[0].v_pointer, &val, 1);
 424 }
 425
 426 /**
 427  * gst_value_list_prepend_value:
 428  * @value: a #GValue of type #GST_TYPE_LIST
 429  * @prepend_value: the value to prepend
 430  *
 431  * Prepends @prepend_value to the GstValueList in @value.
 432  */
 433 void
 434 gst_value_list_prepend_value (GValue * value, const GValue * prepend_value)
 435 {
 436   GValue val = { 0, };
 437
 438   g_return_if_fail (GST_VALUE_HOLDS_LIST (value));
 439   g_return_if_fail (G_IS_VALUE (prepend_value));
 440   g_return_if_fail (gst_value_list_or_array_are_compatible (value,
 441           prepend_value));
 442
 443   gst_value_init_and_copy (&val, prepend_value);
 444   g_array_prepend_vals ((GArray *) value->data[0].v_pointer, &val, 1);
 445 }
 446
 447 /**
 448  * gst_value_list_concat:
 449  * @dest: (out caller-allocates): an uninitialized #GValue to take the result
 450  * @value1: a #GValue
 451  * @value2: a #GValue
 452  *
 453  * Concatenates copies of @value1 and @value2 into a list.  Values that are not
 454  * of type #GST_TYPE_LIST are treated as if they were lists of length 1.
 455  * @dest will be initialized to the type #GST_TYPE_LIST.
 456  */
 457 void
 458 gst_value_list_concat (GValue * dest, const GValue * value1,
 459     const GValue * value2)
 460 {
 461   guint i, value1_length, value2_length;
 462   GArray *array;
 463
 464   g_return_if_fail (dest != NULL);
 465   g_return_if_fail (G_VALUE_TYPE (dest) == 0);
 466   g_return_if_fail (G_IS_VALUE (value1));
 467   g_return_if_fail (G_IS_VALUE (value2));
 468   g_return_if_fail (gst_value_list_or_array_are_compatible (value1, value2));
 469
 470   value1_length =
 471       (GST_VALUE_HOLDS_LIST (value1) ? VALUE_LIST_SIZE (value1) : 1);
 472   value2_length =
 473       (GST_VALUE_HOLDS_LIST (value2) ? VALUE_LIST_SIZE (value2) : 1);
 474   g_value_init (dest, GST_TYPE_LIST);
 475   array = (GArray *) dest->data[0].v_pointer;
 476   g_array_set_size (array, value1_length + value2_length);
 477
 478   if (GST_VALUE_HOLDS_LIST (value1)) {
 479     for (i = 0; i < value1_length; i++) {
 480       gst_value_init_and_copy (&g_array_index (array, GValue, i),
 481           VALUE_LIST_GET_VALUE (value1, i));
 482     }
 483   } else {
 484     gst_value_init_and_copy (&g_array_index (array, GValue, 0), value1);
 485   }
 486
 487   if (GST_VALUE_HOLDS_LIST (value2)) {
 488     for (i = 0; i < value2_length; i++) {
 489       gst_value_init_and_copy (&g_array_index (array, GValue,
 490               i + value1_length), VALUE_LIST_GET_VALUE (value2, i));
 491     }
 492   } else {
 493     gst_value_init_and_copy (&g_array_index (array, GValue, value1_length),
 494         value2);
 495   }
 496 }
 497
 498 /**
 499  * gst_value_list_merge:
 500  * @dest: (out caller-allocates): an uninitialized #GValue to take the result
 501  * @value1: a #GValue
 502  * @value2: a #GValue
 503  *
 504  * Merges copies of @value1 and @value2.  Values that are not
 505  * of type #GST_TYPE_LIST are treated as if they were lists of length 1.
 506  *
 507  * The result will be put into @dest and will either be a list that will not
 508  * contain any duplicates, or a non-list type (if @value1 and @value2
 509  * were equal).
 510  *
 511  * Since: 0.10.32
 512  */
 513 void
 514 gst_value_list_merge (GValue * dest, const GValue * value1,
 515     const GValue * value2)
 516 {
 517   guint i, j, k, value1_length, value2_length, skipped;
 518   const GValue *src;
 519   gboolean skip;
 520   GArray *array;
 521
 522   g_return_if_fail (dest != NULL);
 523   g_return_if_fail (G_VALUE_TYPE (dest) == 0);
 524   g_return_if_fail (G_IS_VALUE (value1));
 525   g_return_if_fail (G_IS_VALUE (value2));
 526   g_return_if_fail (gst_value_list_or_array_are_compatible (value1, value2));
 527
 528   value1_length =
 529       (GST_VALUE_HOLDS_LIST (value1) ? VALUE_LIST_SIZE (value1) : 1);
 530   value2_length =
 531       (GST_VALUE_HOLDS_LIST (value2) ? VALUE_LIST_SIZE (value2) : 1);
 532   g_value_init (dest, GST_TYPE_LIST);
 533   array = (GArray *) dest->data[0].v_pointer;
 534   g_array_set_size (array, value1_length + value2_length);
 535
 536   if (GST_VALUE_HOLDS_LIST (value1)) {
 537     for (i = 0; i < value1_length; i++) {
 538       gst_value_init_and_copy (&g_array_index (array, GValue, i),
 539           VALUE_LIST_GET_VALUE (value1, i));
 540     }
 541   } else {
 542     gst_value_init_and_copy (&g_array_index (array, GValue, 0), value1);
 543   }
 544
 545   j = value1_length;
 546   skipped = 0;
 547   if (GST_VALUE_HOLDS_LIST (value2)) {
 548     for (i = 0; i < value2_length; i++) {
 549       skip = FALSE;
 550       src = VALUE_LIST_GET_VALUE (value2, i);
 551       for (k = 0; k < value1_length; k++) {
 552         if (gst_value_compare (&g_array_index (array, GValue, k),
 553                 src) == GST_VALUE_EQUAL) {
 554           skip = TRUE;
 555           skipped++;
 556           break;
 557         }
 558       }
 559       if (!skip) {
 560         gst_value_init_and_copy (&g_array_index (array, GValue, j), src);
 561         j++;
 562       }
 563     }
 564   } else {
 565     skip = FALSE;
 566     for (k = 0; k < value1_length; k++) {
 567       if (gst_value_compare (&g_array_index (array, GValue, k),
 568               value2) == GST_VALUE_EQUAL) {
 569         skip = TRUE;
 570         skipped++;
 571         break;
 572       }
 573     }
 574     if (!skip) {
 575       gst_value_init_and_copy (&g_array_index (array, GValue, j), value2);
 576     }
 577   }
 578   if (skipped) {
 579     guint new_size = value1_length + (value2_length - skipped);
 580
 581     if (new_size > 1) {
 582       /* shrink list */
 583       g_array_set_size (array, new_size);
 584     } else {
 585       GValue single_dest;
 586
 587       /* size is 1, take single value in list and make it new dest */
 588       single_dest = g_array_index (array, GValue, 0);
 589
 590       /* clean up old value allocations: must set array size to 0, because
 591        * allocated values are not inited meaning g_value_unset() will not
 592        * work on them */
 593       g_array_set_size (array, 0);
 594       g_value_unset (dest);
 595
 596       /* the single value is our new result */
 597       *dest = single_dest;
 598     }
 599   }
 600 }
 601
 602 /**
 603  * gst_value_list_get_size:
 604  * @value: a #GValue of type #GST_TYPE_LIST
 605  *
 606  * Gets the number of values contained in @value.
 607  *
 608  * Returns: the number of values
 609  */
 610 guint
 611 gst_value_list_get_size (const GValue * value)
 612 {
 613   g_return_val_if_fail (GST_VALUE_HOLDS_LIST (value), 0);
 614
 615   return ((GArray *) value->data[0].v_pointer)->len;
 616 }
 617
 618 /**
 619  * gst_value_list_get_value:
 620  * @value: a #GValue of type #GST_TYPE_LIST
 621  * @index: index of value to get from the list
 622  *
 623  * Gets the value that is a member of the list contained in @value and
 624  * has the index @index.
 625  *
 626  * Returns: (transfer none): the value at the given index
 627  */
 628 const GValue *
 629 gst_value_list_get_value (const GValue * value, guint index)
 630 {
 631   g_return_val_if_fail (GST_VALUE_HOLDS_LIST (value), NULL);
 632   g_return_val_if_fail (index < VALUE_LIST_SIZE (value), NULL);
 633
 634   return (const GValue *) &g_array_index ((GArray *) value->data[0].v_pointer,
 635       GValue, index);
 636 }
 637
 638 /**
 639  * gst_value_array_append_value:
 640  * @value: a #GValue of type #GST_TYPE_ARRAY
 641  * @append_value: the value to append
 642  *
 643  * Appends @append_value to the GstValueArray in @value.
 644  */
 645 void
 646 gst_value_array_append_value (GValue * value, const GValue * append_value)
 647 {
 648   GValue val = { 0, };
 649
 650   g_return_if_fail (GST_VALUE_HOLDS_ARRAY (value));
 651   g_return_if_fail (G_IS_VALUE (append_value));
 652   g_return_if_fail (gst_value_list_or_array_are_compatible (value,
 653           append_value));
 654
 655   gst_value_init_and_copy (&val, append_value);
 656   g_array_append_vals ((GArray *) value->data[0].v_pointer, &val, 1);
 657 }
 658
 659 /**
 660  * gst_value_array_prepend_value:
 661  * @value: a #GValue of type #GST_TYPE_ARRAY
 662  * @prepend_value: the value to prepend
 663  *
 664  * Prepends @prepend_value to the GstValueArray in @value.
 665  */
 666 void
 667 gst_value_array_prepend_value (GValue * value, const GValue * prepend_value)
 668 {
 669   GValue val = { 0, };
 670
 671   g_return_if_fail (GST_VALUE_HOLDS_ARRAY (value));
 672   g_return_if_fail (G_IS_VALUE (prepend_value));
 673   g_return_if_fail (gst_value_list_or_array_are_compatible (value,
 674           prepend_value));
 675
 676   gst_value_init_and_copy (&val, prepend_value);
 677   g_array_prepend_vals ((GArray *) value->data[0].v_pointer, &val, 1);
 678 }
 679
 680 /**
 681  * gst_value_array_get_size:
 682  * @value: a #GValue of type #GST_TYPE_ARRAY
 683  *
 684  * Gets the number of values contained in @value.
 685  *
 686  * Returns: the number of values
 687  */
 688 guint
 689 gst_value_array_get_size (const GValue * value)
 690 {
 691   g_return_val_if_fail (GST_VALUE_HOLDS_ARRAY (value), 0);
 692
 693   return ((GArray *) value->data[0].v_pointer)->len;
 694 }
 695
 696 /**
 697  * gst_value_array_get_value:
 698  * @value: a #GValue of type #GST_TYPE_ARRAY
 699  * @index: index of value to get from the array
 700  *
 701  * Gets the value that is a member of the array contained in @value and
 702  * has the index @index.
 703  *
 704  * Returns: (transfer none): the value at the given index
 705  */
 706 const GValue *
 707 gst_value_array_get_value (const GValue * value, guint index)
 708 {
 709   g_return_val_if_fail (GST_VALUE_HOLDS_ARRAY (value), NULL);
 710   g_return_val_if_fail (index < gst_value_array_get_size (value), NULL);
 711
 712   return (const GValue *) &g_array_index ((GArray *) value->data[0].v_pointer,
 713       GValue, index);
 714 }
 715
 716 static void
 717 gst_value_transform_list_string (const GValue * src_value, GValue * dest_value)
 718 {
 719   gst_value_transform_any_list_string (src_value, dest_value, "{ ", " }");
 720 }
 721
 722 static void
 723 gst_value_transform_array_string (const GValue * src_value, GValue * dest_value)
 724 {
 725   gst_value_transform_any_list_string (src_value, dest_value, "< ", " >");
 726 }
 727
 728 /* Do an unordered compare of the contents of a list */
 729 static gint
 730 gst_value_compare_list (const GValue * value1, const GValue * value2)
 731 {
 732   guint i, j;
 733   GArray *array1 = value1->data[0].v_pointer;
 734   GArray *array2 = value2->data[0].v_pointer;
 735   GValue *v1;
 736   GValue *v2;
 737   gint len, to_remove;
 738   guint8 *removed;
 739   GstValueCompareFunc compare;
 740
 741   /* get length and do initial length check. */
 742   len = array1->len;
 743   if (len != array2->len)
 744     return GST_VALUE_UNORDERED;
 745
 746   /* place to mark removed value indices of array2 */
 747   removed = g_newa (guint8, len);
 748   memset (removed, 0, len);
 749   to_remove = len;
 750
 751   /* loop over array1, all items should be in array2. When we find an
 752    * item in array2, remove it from array2 by marking it as removed */
 753   for (i = 0; i < len; i++) {
 754     v1 = &g_array_index (array1, GValue, i);
 755     if ((compare = gst_value_get_compare_func (v1))) {
 756       for (j = 0; j < len; j++) {
 757         /* item is removed, we can skip it */
 758         if (removed[j])
 759           continue;
 760         v2 = &g_array_index (array2, GValue, j);
 761         if (gst_value_compare_with_func (v1, v2, compare) == GST_VALUE_EQUAL) {
 762           /* mark item as removed now that we found it in array2 and
 763            * decrement the number of remaining items in array2. */
 764           removed[j] = 1;
 765           to_remove--;
 766           break;
 767         }
 768       }
 769       /* item in array1 and not in array2, UNORDERED */
 770       if (j == len)
 771         return GST_VALUE_UNORDERED;
 772     } else
 773       return GST_VALUE_UNORDERED;
 774   }
 775   /* if not all items were removed, array2 contained something not in array1 */
 776   if (to_remove != 0)
 777     return GST_VALUE_UNORDERED;
 778
 779   /* arrays are equal */
 780   return GST_VALUE_EQUAL;
 781 }
 782
 783 /* Perform an ordered comparison of the contents of an array */
 784 static gint
 785 gst_value_compare_array (const GValue * value1, const GValue * value2)
 786 {
 787   guint i;
 788   GArray *array1 = value1->data[0].v_pointer;
 789   GArray *array2 = value2->data[0].v_pointer;
 790   guint len = array1->len;
 791   GValue *v1;
 792   GValue *v2;
 793
 794   if (len != array2->len)
 795     return GST_VALUE_UNORDERED;
 796
 797   for (i = 0; i < len; i++) {
 798     v1 = &g_array_index (array1, GValue, i);
 799     v2 = &g_array_index (array2, GValue, i);
 800     if (gst_value_compare (v1, v2) != GST_VALUE_EQUAL)
 801       return GST_VALUE_UNORDERED;
 802   }
 803
 804   return GST_VALUE_EQUAL;
 805 }
 806
 807 static gchar *
 808 gst_value_serialize_list (const GValue * value)
 809 {
 810   return gst_value_serialize_any_list (value, "{ ", " }");
 811 }
 812
 813 static gboolean
 814 gst_value_deserialize_list (GValue * dest, const gchar * s)
 815 {
 816   g_warning ("gst_value_deserialize_list: unimplemented");
 817   return FALSE;
 818 }
 819
 820 static gchar *
 821 gst_value_serialize_array (const GValue * value)
 822 {
 823   return gst_value_serialize_any_list (value, "< ", " >");
 824 }
 825
 826 static gboolean
 827 gst_value_deserialize_array (GValue * dest, const gchar * s)
 828 {
 829   g_warning ("gst_value_deserialize_array: unimplemented");
 830   return FALSE;
 831 }
 832
 833 /*************
 834  * int range *
 835  *
 836  * Values in the range are defined as any value greater or equal
 837  * to min*step, AND lesser or equal to max*step.
 838  * For step == 1, this falls back to the traditional range semantics.
 839  *************/
 840
 841 #define INT_RANGE_MIN(v) (((gint *)((v)->data[0].v_pointer))[0])
 842 #define INT_RANGE_MAX(v) (((gint *)((v)->data[0].v_pointer))[1])
 843 #define INT_RANGE_STEP(v) (((gint *)((v)->data[0].v_pointer))[2])
 844
 845 static void
 846 gst_value_init_int_range (GValue * value)
 847 {
 848   gint *vals = g_slice_alloc0 (3 * sizeof (gint));
 849   value->data[0].v_pointer = vals;
 850   INT_RANGE_MIN (value) = 0;
 851   INT_RANGE_MAX (value) = 0;
 852   INT_RANGE_STEP (value) = 1;
 853 }
 854
 855 static void
 856 gst_value_free_int_range (GValue * value)
 857 {
 858   g_return_if_fail (GST_VALUE_HOLDS_INT_RANGE (value));
 859   g_slice_free1 (3 * sizeof (gint), value->data[0].v_pointer);
 860   value->data[0].v_pointer = NULL;
 861 }
 862
 863 static void
 864 gst_value_copy_int_range (const GValue * src_value, GValue * dest_value)
 865 {
 866   gint *vals = (gint *) dest_value->data[0].v_pointer;
 867   gint *src_vals = (gint *) src_value->data[0].v_pointer;
 868
 869   if (vals == NULL) {
 870     gst_value_init_int_range (dest_value);
 871   }
 872   if (src_vals != NULL) {
 873     INT_RANGE_MIN (dest_value) = INT_RANGE_MIN (src_value);
 874     INT_RANGE_MAX (dest_value) = INT_RANGE_MAX (src_value);
 875     INT_RANGE_STEP (dest_value) = INT_RANGE_STEP (src_value);
 876   }
 877 }
 878
 879 static gchar *
 880 gst_value_collect_int_range (GValue * value, guint n_collect_values,
 881     GTypeCValue * collect_values, guint collect_flags)
 882 {
 883   gint *vals = value->data[0].v_pointer;
 884
 885   if (n_collect_values != 2)
 886     return g_strdup_printf ("not enough value locations for `%s' passed",
 887         G_VALUE_TYPE_NAME (value));
 888   if (collect_values[0].v_int >= collect_values[1].v_int)
 889     return g_strdup_printf ("range start is not smaller than end for `%s'",
 890         G_VALUE_TYPE_NAME (value));
 891
 892   if (vals == NULL) {
 893     gst_value_init_int_range (value);
 894   }
 895
 896   gst_value_set_int_range_step (value, collect_values[0].v_int,
 897       collect_values[1].v_int, 1);
 898
 899   return NULL;
 900 }
 901
 902 static gchar *
 903 gst_value_lcopy_int_range (const GValue * value, guint n_collect_values,
 904     GTypeCValue * collect_values, guint collect_flags)
 905 {
 906   guint32 *int_range_start = collect_values[0].v_pointer;
 907   guint32 *int_range_end = collect_values[1].v_pointer;
 908   guint32 *int_range_step = collect_values[2].v_pointer;
 909   gint *vals = (gint *) value->data[0].v_pointer;
 910
 911   if (!int_range_start)
 912     return g_strdup_printf ("start value location for `%s' passed as NULL",
 913         G_VALUE_TYPE_NAME (value));
 914   if (!int_range_end)
 915     return g_strdup_printf ("end value location for `%s' passed as NULL",
 916         G_VALUE_TYPE_NAME (value));
 917   if (!int_range_step)
 918     return g_strdup_printf ("step value location for `%s' passed as NULL",
 919         G_VALUE_TYPE_NAME (value));
 920
 921   if (G_UNLIKELY (vals == NULL)) {
 922     return g_strdup_printf ("Uninitialised `%s' passed",
 923         G_VALUE_TYPE_NAME (value));
 924   }
 925
 926   *int_range_start = INT_RANGE_MIN (value);
 927   *int_range_end = INT_RANGE_MAX (value);
 928   *int_range_step = INT_RANGE_STEP (value);
 929
 930   return NULL;
 931 }
 932
 933 /**
 934  * gst_value_set_int_range_step:
 935  * @value: a GValue initialized to GST_TYPE_INT_RANGE
 936  * @start: the start of the range
 937  * @end: the end of the range
 938  * @step: the step of the range
 939  *
 940  * Sets @value to the range specified by @start, @end and @step.
 941  */
 942 void
 943 gst_value_set_int_range_step (GValue * value, gint start, gint end, gint step)
 944 {
 945   g_return_if_fail (GST_VALUE_HOLDS_INT_RANGE (value));
 946   g_return_if_fail (start < end);
 947   g_return_if_fail (step > 0);
 948   g_return_if_fail (start % step == 0);
 949   g_return_if_fail (end % step == 0);
 950
 951   INT_RANGE_MIN (value) = start / step;
 952   INT_RANGE_MAX (value) = end / step;
 953   INT_RANGE_STEP (value) = step;
 954 }
 955
 956 /**
 957  * gst_value_set_int_range:
 958  * @value: a GValue initialized to GST_TYPE_INT_RANGE
 959  * @start: the start of the range
 960  * @end: the end of the range
 961  *
 962  * Sets @value to the range specified by @start and @end.
 963  */
 964 void
 965 gst_value_set_int_range (GValue * value, gint start, gint end)
 966 {
 967   gst_value_set_int_range_step (value, start, end, 1);
 968 }
 969
 970 /**
 971  * gst_value_get_int_range_min:
 972  * @value: a GValue initialized to GST_TYPE_INT_RANGE
 973  *
 974  * Gets the minimum of the range specified by @value.
 975  *
 976  * Returns: the minimum of the range
 977  */
 978 gint
 979 gst_value_get_int_range_min (const GValue * value)
 980 {
 981   g_return_val_if_fail (GST_VALUE_HOLDS_INT_RANGE (value), 0);
 982
 983   return INT_RANGE_MIN (value) * INT_RANGE_STEP (value);
 984 }
 985
 986 /**
 987  * gst_value_get_int_range_max:
 988  * @value: a GValue initialized to GST_TYPE_INT_RANGE
 989  *
 990  * Gets the maximum of the range specified by @value.
 991  *
 992  * Returns: the maxumum of the range
 993  */
 994 gint
 995 gst_value_get_int_range_max (const GValue * value)
 996 {
 997   g_return_val_if_fail (GST_VALUE_HOLDS_INT_RANGE (value), 0);
 998
 999   return INT_RANGE_MAX (value) * INT_RANGE_STEP (value);
1000 }
1001
1002 /**
1003  * gst_value_get_int_range_step:
1004  * @value: a GValue initialized to GST_TYPE_INT_RANGE
1005  *
1006  * Gets the step of the range specified by @value.
1007  *
1008  * Returns: the step of the range
1009  */
1010 gint
1011 gst_value_get_int_range_step (const GValue * value)
1012 {
1013   g_return_val_if_fail (GST_VALUE_HOLDS_INT_RANGE (value), 0);
1014
1015   return INT_RANGE_STEP (value);
1016 }
1017
1018 static void
1019 gst_value_transform_int_range_string (const GValue * src_value,
1020     GValue * dest_value)
1021 {
1022   if (INT_RANGE_STEP (src_value) == 1)
1023     dest_value->data[0].v_pointer = g_strdup_printf ("[%d,%d]",
1024         INT_RANGE_MIN (src_value), INT_RANGE_MAX (src_value));
1025   else
1026     dest_value->data[0].v_pointer = g_strdup_printf ("[%d,%d,%d]",
1027         INT_RANGE_MIN (src_value) * INT_RANGE_STEP (src_value),
1028         INT_RANGE_MAX (src_value) * INT_RANGE_STEP (src_value),
1029         INT_RANGE_STEP (src_value));
1030 }
1031
1032 static gint
1033 gst_value_compare_int_range (const GValue * value1, const GValue * value2)
1034 {
1035   /* calculate the number of values in each range */
1036   gint n1 = INT_RANGE_MAX (value1) - INT_RANGE_MIN (value1) + 1;
1037   gint n2 = INT_RANGE_MAX (value2) - INT_RANGE_MIN (value2) + 1;
1038
1039   /* they must be equal */
1040   if (n1 != n2)
1041     return GST_VALUE_UNORDERED;
1042
1043   /* if empty, equal */
1044   if (n1 == 0)
1045     return GST_VALUE_EQUAL;
1046
1047   /* if more than one value, then it is only equal if the step is equal
1048      and bounds lie on the same value */
1049   if (n1 > 1) {
1050     if (INT_RANGE_STEP (value1) == INT_RANGE_STEP (value2) &&
1051         INT_RANGE_STEP (value1) == INT_RANGE_STEP (value2) &&
1052         INT_RANGE_STEP (value1) == INT_RANGE_STEP (value2)) {
1053       return GST_VALUE_EQUAL;
1054     }
1055     return GST_VALUE_UNORDERED;
1056   } else {
1057     /* if just one, only if the value is equal */
1058     if (INT_RANGE_MIN (value1) == INT_RANGE_MIN (value2))
1059       return GST_VALUE_EQUAL;
1060     return GST_VALUE_UNORDERED;
1061   }
1062 }
1063
1064 static gchar *
1065 gst_value_serialize_int_range (const GValue * value)
1066 {
1067   if (INT_RANGE_STEP (value) == 1)
1068     return g_strdup_printf ("[ %d, %d ]", INT_RANGE_MIN (value),
1069         INT_RANGE_MAX (value));
1070   else
1071     return g_strdup_printf ("[ %d, %d, %d ]",
1072         INT_RANGE_MIN (value) * INT_RANGE_STEP (value),
1073         INT_RANGE_MAX (value) * INT_RANGE_STEP (value), INT_RANGE_STEP (value));
1074 }
1075
1076 static gboolean
1077 gst_value_deserialize_int_range (GValue * dest, const gchar * s)
1078 {
1079   g_warning ("unimplemented");
1080   return FALSE;
1081 }
1082
1083 /***************
1084  * int64 range *
1085  *
1086  * Values in the range are defined as any value greater or equal
1087  * to min*step, AND lesser or equal to max*step.
1088  * For step == 1, this falls back to the traditional range semantics.
1089  ***************/
1090
1091 #define INT64_RANGE_MIN(v) (((gint64 *)((v)->data[0].v_pointer))[0])
1092 #define INT64_RANGE_MAX(v) (((gint64 *)((v)->data[0].v_pointer))[1])
1093 #define INT64_RANGE_STEP(v) (((gint64 *)((v)->data[0].v_pointer))[2])
1094
1095 static void
1096 gst_value_init_int64_range (GValue * value)
1097 {
1098   gint64 *vals = g_slice_alloc0 (3 * sizeof (gint64));
1099   value->data[0].v_pointer = vals;
1100   INT64_RANGE_MIN (value) = 0;
1101   INT64_RANGE_MAX (value) = 0;
1102   INT64_RANGE_STEP (value) = 1;
1103 }
1104
1105 static void
1106 gst_value_free_int64_range (GValue * value)
1107 {
1108   g_return_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value));
1109   g_slice_free1 (3 * sizeof (gint64), value->data[0].v_pointer);
1110   value->data[0].v_pointer = NULL;
1111 }
1112
1113 static void
1114 gst_value_copy_int64_range (const GValue * src_value, GValue * dest_value)
1115 {
1116   gint64 *vals = (gint64 *) dest_value->data[0].v_pointer;
1117   gint64 *src_vals = (gint64 *) src_value->data[0].v_pointer;
1118
1119   if (vals == NULL) {
1120     gst_value_init_int64_range (dest_value);
1121   }
1122
1123   if (src_vals != NULL) {
1124     INT64_RANGE_MIN (dest_value) = INT64_RANGE_MIN (src_value);
1125     INT64_RANGE_MAX (dest_value) = INT64_RANGE_MAX (src_value);
1126     INT64_RANGE_STEP (dest_value) = INT64_RANGE_STEP (src_value);
1127   }
1128 }
1129
1130 static gchar *
1131 gst_value_collect_int64_range (GValue * value, guint n_collect_values,
1132     GTypeCValue * collect_values, guint collect_flags)
1133 {
1134   gint64 *vals = value->data[0].v_pointer;
1135
1136   if (n_collect_values != 2)
1137     return g_strdup_printf ("not enough value locations for `%s' passed",
1138         G_VALUE_TYPE_NAME (value));
1139   if (collect_values[0].v_int64 >= collect_values[1].v_int64)
1140     return g_strdup_printf ("range start is not smaller than end for `%s'",
1141         G_VALUE_TYPE_NAME (value));
1142
1143   if (vals == NULL) {
1144     gst_value_init_int64_range (value);
1145   }
1146
1147   gst_value_set_int64_range_step (value, collect_values[0].v_int64,
1148       collect_values[1].v_int64, 1);
1149
1150   return NULL;
1151 }
1152
1153 static gchar *
1154 gst_value_lcopy_int64_range (const GValue * value, guint n_collect_values,
1155     GTypeCValue * collect_values, guint collect_flags)
1156 {
1157   guint64 *int_range_start = collect_values[0].v_pointer;
1158   guint64 *int_range_end = collect_values[1].v_pointer;
1159   guint64 *int_range_step = collect_values[2].v_pointer;
1160   gint64 *vals = (gint64 *) value->data[0].v_pointer;
1161
1162   if (!int_range_start)
1163     return g_strdup_printf ("start value location for `%s' passed as NULL",
1164         G_VALUE_TYPE_NAME (value));
1165   if (!int_range_end)
1166     return g_strdup_printf ("end value location for `%s' passed as NULL",
1167         G_VALUE_TYPE_NAME (value));
1168   if (!int_range_step)
1169     return g_strdup_printf ("step value location for `%s' passed as NULL",
1170         G_VALUE_TYPE_NAME (value));
1171
1172   if (G_UNLIKELY (vals == NULL)) {
1173     return g_strdup_printf ("Uninitialised `%s' passed",
1174         G_VALUE_TYPE_NAME (value));
1175   }
1176
1177   *int_range_start = INT64_RANGE_MIN (value);
1178   *int_range_end = INT64_RANGE_MAX (value);
1179   *int_range_step = INT64_RANGE_STEP (value);
1180
1181   return NULL;
1182 }
1183
1184 /**
1185  * gst_value_set_int64_range_step:
1186  * @value: a GValue initialized to GST_TYPE_INT64_RANGE
1187  * @start: the start of the range
1188  * @end: the end of the range
1189  * @step: the step of the range
1190  *
1191  * Sets @value to the range specified by @start, @end and @step.
1192  *
1193  * Since: 0.11.0
1194  */
1195 void
1196 gst_value_set_int64_range_step (GValue * value, gint64 start, gint64 end,
1197     gint64 step)
1198 {
1199   g_return_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value));
1200   g_return_if_fail (start < end);
1201   g_return_if_fail (step > 0);
1202   g_return_if_fail (start % step == 0);
1203   g_return_if_fail (end % step == 0);
1204
1205   INT64_RANGE_MIN (value) = start / step;
1206   INT64_RANGE_MAX (value) = end / step;
1207   INT64_RANGE_STEP (value) = step;
1208 }
1209
1210 /**
1211  * gst_value_set_int64_range:
1212  * @value: a GValue initialized to GST_TYPE_INT64_RANGE
1213  * @start: the start of the range
1214  * @end: the end of the range
1215  *
1216  * Sets @value to the range specified by @start and @end.
1217  *
1218  * Since: 0.10.31
1219  */
1220 void
1221 gst_value_set_int64_range (GValue * value, gint64 start, gint64 end)
1222 {
1223   gst_value_set_int64_range_step (value, start, end, 1);
1224 }
1225
1226 /**
1227  * gst_value_get_int64_range_min:
1228  * @value: a GValue initialized to GST_TYPE_INT64_RANGE
1229  *
1230  * Gets the minimum of the range specified by @value.
1231  *
1232  * Returns: the minimum of the range
1233  *
1234  * Since: 0.10.31
1235  */
1236 gint64
1237 gst_value_get_int64_range_min (const GValue * value)
1238 {
1239   g_return_val_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value), 0);
1240
1241   return INT64_RANGE_MIN (value) * INT64_RANGE_STEP (value);
1242 }
1243
1244 /**
1245  * gst_value_get_int64_range_max:
1246  * @value: a GValue initialized to GST_TYPE_INT64_RANGE
1247  *
1248  * Gets the maximum of the range specified by @value.
1249  *
1250  * Returns: the maxumum of the range
1251  *
1252  * Since: 0.10.31
1253  */
1254 gint64
1255 gst_value_get_int64_range_max (const GValue * value)
1256 {
1257   g_return_val_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value), 0);
1258
1259   return INT64_RANGE_MAX (value) * INT64_RANGE_STEP (value);
1260 }
1261
1262 /**
1263  * gst_value_get_int64_range_step:
1264  * @value: a GValue initialized to GST_TYPE_INT64_RANGE
1265  *
1266  * Gets the step of the range specified by @value.
1267  *
1268  * Returns: the step of the range
1269  *
1270  * Since: 0.11.0
1271  */
1272 gint64
1273 gst_value_get_int64_range_step (const GValue * value)
1274 {
1275   g_return_val_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value), 0);
1276
1277   return INT64_RANGE_STEP (value);
1278 }
1279
1280 static void
1281 gst_value_transform_int64_range_string (const GValue * src_value,
1282     GValue * dest_value)
1283 {
1284   if (INT64_RANGE_STEP (src_value) == 1)
1285     dest_value->data[0].v_pointer =
1286         g_strdup_printf ("(gint64)[%" G_GINT64_FORMAT ",%" G_GINT64_FORMAT "]",
1287         INT64_RANGE_MIN (src_value), INT64_RANGE_MAX (src_value));
1288   else
1289     dest_value->data[0].v_pointer =
1290         g_strdup_printf ("(gint64)[%" G_GINT64_FORMAT ",%" G_GINT64_FORMAT
1291         ",%" G_GINT64_FORMAT "]",
1292         INT64_RANGE_MIN (src_value) * INT64_RANGE_STEP (src_value),
1293         INT64_RANGE_MAX (src_value) * INT64_RANGE_STEP (src_value),
1294         INT64_RANGE_STEP (src_value));
1295 }
1296
1297 static gint
1298 gst_value_compare_int64_range (const GValue * value1, const GValue * value2)
1299 {
1300   /* calculate the number of values in each range */
1301   gint64 n1 = INT64_RANGE_MAX (value1) - INT64_RANGE_MIN (value1) + 1;
1302   gint64 n2 = INT64_RANGE_MAX (value2) - INT64_RANGE_MIN (value2) + 1;
1303
1304   /* they must be equal */
1305   if (n1 != n2)
1306     return GST_VALUE_UNORDERED;
1307
1308   /* if empty, equal */
1309   if (n1 == 0)
1310     return GST_VALUE_EQUAL;
1311
1312   /* if more than one value, then it is only equal if the step is equal
1313      and bounds lie on the same value */
1314   if (n1 > 1) {
1315     if (INT64_RANGE_STEP (value1) == INT64_RANGE_STEP (value2) &&
1316         INT64_RANGE_STEP (value1) == INT64_RANGE_STEP (value2) &&
1317         INT64_RANGE_STEP (value1) == INT64_RANGE_STEP (value2)) {
1318       return GST_VALUE_EQUAL;
1319     }
1320     return GST_VALUE_UNORDERED;
1321   } else {
1322     /* if just one, only if the value is equal */
1323     if (INT64_RANGE_MIN (value1) == INT64_RANGE_MIN (value2))
1324       return GST_VALUE_EQUAL;
1325     return GST_VALUE_UNORDERED;
1326   }
1327 }
1328
1329 static gchar *
1330 gst_value_serialize_int64_range (const GValue * value)
1331 {
1332   if (INT64_RANGE_STEP (value) == 1)
1333     return g_strdup_printf ("[ %" G_GINT64_FORMAT ", %" G_GINT64_FORMAT " ]",
1334         INT64_RANGE_MIN (value), INT64_RANGE_MAX (value));
1335   else
1336     return g_strdup_printf ("[ %" G_GINT64_FORMAT ", %" G_GINT64_FORMAT ", %"
1337         G_GINT64_FORMAT " ]",
1338         INT64_RANGE_MIN (value) * INT64_RANGE_STEP (value),
1339         INT64_RANGE_MAX (value) * INT64_RANGE_STEP (value),
1340         INT64_RANGE_STEP (value));
1341 }
1342
1343 static gboolean
1344 gst_value_deserialize_int64_range (GValue * dest, const gchar * s)
1345 {
1346   g_warning ("unimplemented");
1347   return FALSE;
1348 }
1349
1350 /****************
1351  * double range *
1352  ****************/
1353
1354 static void
1355 gst_value_init_double_range (GValue * value)
1356 {
1357   value->data[0].v_double = 0;
1358   value->data[1].v_double = 0;
1359 }
1360
1361 static void
1362 gst_value_copy_double_range (const GValue * src_value, GValue * dest_value)
1363 {
1364   dest_value->data[0].v_double = src_value->data[0].v_double;
1365   dest_value->data[1].v_double = src_value->data[1].v_double;
1366 }
1367
1368 static gchar *
1369 gst_value_collect_double_range (GValue * value, guint n_collect_values,
1370     GTypeCValue * collect_values, guint collect_flags)
1371 {
1372   if (n_collect_values != 2)
1373     return g_strdup_printf ("not enough value locations for `%s' passed",
1374         G_VALUE_TYPE_NAME (value));
1375   if (collect_values[0].v_double >= collect_values[1].v_double)
1376     return g_strdup_printf ("range start is not smaller than end for `%s'",
1377         G_VALUE_TYPE_NAME (value));
1378
1379   value->data[0].v_double = collect_values[0].v_double;
1380   value->data[1].v_double = collect_values[1].v_double;
1381
1382   return NULL;
1383 }
1384
1385 static gchar *
1386 gst_value_lcopy_double_range (const GValue * value, guint n_collect_values,
1387     GTypeCValue * collect_values, guint collect_flags)
1388 {
1389   gdouble *double_range_start = collect_values[0].v_pointer;
1390   gdouble *double_range_end = collect_values[1].v_pointer;
1391
1392   if (!double_range_start)
1393     return g_strdup_printf ("start value location for `%s' passed as NULL",
1394         G_VALUE_TYPE_NAME (value));
1395   if (!double_range_end)
1396     return g_strdup_printf ("end value location for `%s' passed as NULL",
1397         G_VALUE_TYPE_NAME (value));
1398
1399   *double_range_start = value->data[0].v_double;
1400   *double_range_end = value->data[1].v_double;
1401
1402   return NULL;
1403 }
1404
1405 /**
1406  * gst_value_set_double_range:
1407  * @value: a GValue initialized to GST_TYPE_DOUBLE_RANGE
1408  * @start: the start of the range
1409  * @end: the end of the range
1410  *
1411  * Sets @value to the range specified by @start and @end.
1412  */
1413 void
1414 gst_value_set_double_range (GValue * value, gdouble start, gdouble end)
1415 {
1416   g_return_if_fail (GST_VALUE_HOLDS_DOUBLE_RANGE (value));
1417   g_return_if_fail (start < end);
1418
1419   value->data[0].v_double = start;
1420   value->data[1].v_double = end;
1421 }
1422
1423 /**
1424  * gst_value_get_double_range_min:
1425  * @value: a GValue initialized to GST_TYPE_DOUBLE_RANGE
1426  *
1427  * Gets the minimum of the range specified by @value.
1428  *
1429  * Returns: the minimum of the range
1430  */
1431 gdouble
1432 gst_value_get_double_range_min (const GValue * value)
1433 {
1434   g_return_val_if_fail (GST_VALUE_HOLDS_DOUBLE_RANGE (value), 0);
1435
1436   return value->data[0].v_double;
1437 }
1438
1439 /**
1440  * gst_value_get_double_range_max:
1441  * @value: a GValue initialized to GST_TYPE_DOUBLE_RANGE
1442  *
1443  * Gets the maximum of the range specified by @value.
1444  *
1445  * Returns: the maxumum of the range
1446  */
1447 gdouble
1448 gst_value_get_double_range_max (const GValue * value)
1449 {
1450   g_return_val_if_fail (GST_VALUE_HOLDS_DOUBLE_RANGE (value), 0);
1451
1452   return value->data[1].v_double;
1453 }
1454
1455 static void
1456 gst_value_transform_double_range_string (const GValue * src_value,
1457     GValue * dest_value)
1458 {
1459   gchar s1[G_ASCII_DTOSTR_BUF_SIZE], s2[G_ASCII_DTOSTR_BUF_SIZE];
1460
1461   dest_value->data[0].v_pointer = g_strdup_printf ("[%s,%s]",
1462       g_ascii_dtostr (s1, G_ASCII_DTOSTR_BUF_SIZE,
1463           src_value->data[0].v_double),
1464       g_ascii_dtostr (s2, G_ASCII_DTOSTR_BUF_SIZE,
1465           src_value->data[1].v_double));
1466 }
1467
1468 static gint
1469 gst_value_compare_double_range (const GValue * value1, const GValue * value2)
1470 {
1471   if (value2->data[0].v_double == value1->data[0].v_double &&
1472       value2->data[0].v_double == value1->data[0].v_double)
1473     return GST_VALUE_EQUAL;
1474   return GST_VALUE_UNORDERED;
1475 }
1476
1477 static gchar *
1478 gst_value_serialize_double_range (const GValue * value)
1479 {
1480   gchar d1[G_ASCII_DTOSTR_BUF_SIZE];
1481   gchar d2[G_ASCII_DTOSTR_BUF_SIZE];
1482
1483   g_ascii_dtostr (d1, G_ASCII_DTOSTR_BUF_SIZE, value->data[0].v_double);
1484   g_ascii_dtostr (d2, G_ASCII_DTOSTR_BUF_SIZE, value->data[1].v_double);
1485   return g_strdup_printf ("[ %s, %s ]", d1, d2);
1486 }
1487
1488 static gboolean
1489 gst_value_deserialize_double_range (GValue * dest, const gchar * s)
1490 {
1491   g_warning ("unimplemented");
1492   return FALSE;
1493 }
1494
1495 /****************
1496  * fraction range *
1497  ****************/
1498
1499 static void
1500 gst_value_init_fraction_range (GValue * value)
1501 {
1502   GValue *vals;
1503   GType ftype;
1504
1505   ftype = GST_TYPE_FRACTION;
1506
1507   value->data[0].v_pointer = vals = g_slice_alloc0 (2 * sizeof (GValue));
1508   g_value_init (&vals[0], ftype);
1509   g_value_init (&vals[1], ftype);
1510 }
1511
1512 static void
1513 gst_value_free_fraction_range (GValue * value)
1514 {
1515   GValue *vals = (GValue *) value->data[0].v_pointer;
1516
1517   if (vals != NULL) {
1518     /* we know the two values contain fractions without internal allocs */
1519     /* g_value_unset (&vals[0]); */
1520     /* g_value_unset (&vals[1]); */
1521     g_slice_free1 (2 * sizeof (GValue), vals);
1522     value->data[0].v_pointer = NULL;
1523   }
1524 }
1525
1526 static void
1527 gst_value_copy_fraction_range (const GValue * src_value, GValue * dest_value)
1528 {
1529   GValue *vals = (GValue *) dest_value->data[0].v_pointer;
1530   GValue *src_vals = (GValue *) src_value->data[0].v_pointer;
1531
1532   if (vals == NULL) {
1533     gst_value_init_fraction_range (dest_value);
1534     vals = dest_value->data[0].v_pointer;
1535   }
1536   if (src_vals != NULL) {
1537     g_value_copy (&src_vals[0], &vals[0]);
1538     g_value_copy (&src_vals[1], &vals[1]);
1539   }
1540 }
1541
1542 static gchar *
1543 gst_value_collect_fraction_range (GValue * value, guint n_collect_values,
1544     GTypeCValue * collect_values, guint collect_flags)
1545 {
1546   GValue *vals = (GValue *) value->data[0].v_pointer;
1547
1548   if (n_collect_values != 4)
1549     return g_strdup_printf ("not enough value locations for `%s' passed",
1550         G_VALUE_TYPE_NAME (value));
1551   if (collect_values[1].v_int == 0)
1552     return g_strdup_printf ("passed '0' as first denominator for `%s'",
1553         G_VALUE_TYPE_NAME (value));
1554   if (collect_values[3].v_int == 0)
1555     return g_strdup_printf ("passed '0' as second denominator for `%s'",
1556         G_VALUE_TYPE_NAME (value));
1557   if (gst_util_fraction_compare (collect_values[0].v_int,
1558           collect_values[1].v_int, collect_values[2].v_int,
1559           collect_values[3].v_int) >= 0)
1560     return g_strdup_printf ("range start is not smaller than end for `%s'",
1561         G_VALUE_TYPE_NAME (value));
1562
1563   if (vals == NULL) {
1564     gst_value_init_fraction_range (value);
1565     vals = value->data[0].v_pointer;
1566   }
1567
1568   gst_value_set_fraction (&vals[0], collect_values[0].v_int,
1569       collect_values[1].v_int);
1570   gst_value_set_fraction (&vals[1], collect_values[2].v_int,
1571       collect_values[3].v_int);
1572
1573   return NULL;
1574 }
1575
1576 static gchar *
1577 gst_value_lcopy_fraction_range (const GValue * value, guint n_collect_values,
1578     GTypeCValue * collect_values, guint collect_flags)
1579 {
1580   gint i;
1581   gint *dest_values[4];
1582   GValue *vals = (GValue *) value->data[0].v_pointer;
1583
1584   if (G_UNLIKELY (n_collect_values != 4))
1585     return g_strdup_printf ("not enough value locations for `%s' passed",
1586         G_VALUE_TYPE_NAME (value));
1587
1588   for (i = 0; i < 4; i++) {
1589     if (G_UNLIKELY (collect_values[i].v_pointer == NULL)) {
1590       return g_strdup_printf ("value location for `%s' passed as NULL",
1591           G_VALUE_TYPE_NAME (value));
1592     }
1593     dest_values[i] = collect_values[i].v_pointer;
1594   }
1595
1596   if (G_UNLIKELY (vals == NULL)) {
1597     return g_strdup_printf ("Uninitialised `%s' passed",
1598         G_VALUE_TYPE_NAME (value));
1599   }
1600
1601   dest_values[0][0] = gst_value_get_fraction_numerator (&vals[0]);
1602   dest_values[1][0] = gst_value_get_fraction_denominator (&vals[0]);
1603   dest_values[2][0] = gst_value_get_fraction_numerator (&vals[1]);
1604   dest_values[3][0] = gst_value_get_fraction_denominator (&vals[1]);
1605   return NULL;
1606 }
1607
1608 /**
1609  * gst_value_set_fraction_range:
1610  * @value: a GValue initialized to GST_TYPE_FRACTION_RANGE
1611  * @start: the start of the range (a GST_TYPE_FRACTION GValue)
1612  * @end: the end of the range (a GST_TYPE_FRACTION GValue)
1613  *
1614  * Sets @value to the range specified by @start and @end.
1615  */
1616 void
1617 gst_value_set_fraction_range (GValue * value, const GValue * start,
1618     const GValue * end)
1619 {
1620   GValue *vals;
1621
1622   g_return_if_fail (GST_VALUE_HOLDS_FRACTION_RANGE (value));
1623   g_return_if_fail (GST_VALUE_HOLDS_FRACTION (start));
1624   g_return_if_fail (GST_VALUE_HOLDS_FRACTION (end));
1625   g_return_if_fail (gst_util_fraction_compare (start->data[0].v_int,
1626           start->data[1].v_int, end->data[0].v_int, end->data[1].v_int) < 0);
1627
1628   vals = (GValue *) value->data[0].v_pointer;
1629   if (vals == NULL) {
1630     gst_value_init_fraction_range (value);
1631     vals = value->data[0].v_pointer;
1632   }
1633   g_value_copy (start, &vals[0]);
1634   g_value_copy (end, &vals[1]);
1635 }
1636
1637 /**
1638  * gst_value_set_fraction_range_full:
1639  * @value: a GValue initialized to GST_TYPE_FRACTION_RANGE
1640  * @numerator_start: the numerator start of the range
1641  * @denominator_start: the denominator start of the range
1642  * @numerator_end: the numerator end of the range
1643  * @denominator_end: the denominator end of the range
1644  *
1645  * Sets @value to the range specified by @numerator_start/@denominator_start
1646  * and @numerator_end/@denominator_end.
1647  */
1648 void
1649 gst_value_set_fraction_range_full (GValue * value,
1650     gint numerator_start, gint denominator_start,
1651     gint numerator_end, gint denominator_end)
1652 {
1653   GValue start = { 0 };
1654   GValue end = { 0 };
1655
1656   g_return_if_fail (value != NULL);
1657   g_return_if_fail (denominator_start != 0);
1658   g_return_if_fail (denominator_end != 0);
1659   g_return_if_fail (gst_util_fraction_compare (numerator_start,
1660           denominator_start, numerator_end, denominator_end) < 0);
1661
1662   g_value_init (&start, GST_TYPE_FRACTION);
1663   g_value_init (&end, GST_TYPE_FRACTION);
1664
1665   gst_value_set_fraction (&start, numerator_start, denominator_start);
1666   gst_value_set_fraction (&end, numerator_end, denominator_end);
1667   gst_value_set_fraction_range (value, &start, &end);
1668
1669   /* we know the two values contain fractions without internal allocs */
1670   /* g_value_unset (&start); */
1671   /* g_value_unset (&end);   */
1672 }
1673
1674 /**
1675  * gst_value_get_fraction_range_min:
1676  * @value: a GValue initialized to GST_TYPE_FRACTION_RANGE
1677  *
1678  * Gets the minimum of the range specified by @value.
1679  *
1680  * Returns: the minimum of the range
1681  */
1682 const GValue *
1683 gst_value_get_fraction_range_min (const GValue * value)
1684 {
1685   GValue *vals;
1686
1687   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION_RANGE (value), NULL);
1688
1689   vals = (GValue *) value->data[0].v_pointer;
1690   if (vals != NULL) {
1691     return &vals[0];
1692   }
1693
1694   return NULL;
1695 }
1696
1697 /**
1698  * gst_value_get_fraction_range_max:
1699  * @value: a GValue initialized to GST_TYPE_FRACTION_RANGE
1700  *
1701  * Gets the maximum of the range specified by @value.
1702  *
1703  * Returns: the maximum of the range
1704  */
1705 const GValue *
1706 gst_value_get_fraction_range_max (const GValue * value)
1707 {
1708   GValue *vals;
1709
1710   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION_RANGE (value), NULL);
1711
1712   vals = (GValue *) value->data[0].v_pointer;
1713   if (vals != NULL) {
1714     return &vals[1];
1715   }
1716
1717   return NULL;
1718 }
1719
1720 static gchar *
1721 gst_value_serialize_fraction_range (const GValue * value)
1722 {
1723   GValue *vals = (GValue *) value->data[0].v_pointer;
1724   gchar *retval;
1725
1726   if (vals == NULL) {
1727     retval = g_strdup ("[ 0/1, 0/1 ]");
1728   } else {
1729     gchar *start, *end;
1730
1731     start = gst_value_serialize_fraction (&vals[0]);
1732     end = gst_value_serialize_fraction (&vals[1]);
1733
1734     retval = g_strdup_printf ("[ %s, %s ]", start, end);
1735     g_free (start);
1736     g_free (end);
1737   }
1738
1739   return retval;
1740 }
1741
1742 static void
1743 gst_value_transform_fraction_range_string (const GValue * src_value,
1744     GValue * dest_value)
1745 {
1746   dest_value->data[0].v_pointer =
1747       gst_value_serialize_fraction_range (src_value);
1748 }
1749
1750 static gint
1751 gst_value_compare_fraction_range (const GValue * value1, const GValue * value2)
1752 {
1753   GValue *vals1, *vals2;
1754   GstValueCompareFunc compare;
1755
1756   if (value2->data[0].v_pointer == value1->data[0].v_pointer)
1757     return GST_VALUE_EQUAL;     /* Only possible if both are NULL */
1758
1759   if (value2->data[0].v_pointer == NULL || value1->data[0].v_pointer == NULL)
1760     return GST_VALUE_UNORDERED;
1761
1762   vals1 = (GValue *) value1->data[0].v_pointer;
1763   vals2 = (GValue *) value2->data[0].v_pointer;
1764   if ((compare = gst_value_get_compare_func (&vals1[0]))) {
1765     if (gst_value_compare_with_func (&vals1[0], &vals2[0], compare) ==
1766         GST_VALUE_EQUAL &&
1767         gst_value_compare_with_func (&vals1[1], &vals2[1], compare) ==
1768         GST_VALUE_EQUAL)
1769       return GST_VALUE_EQUAL;
1770   }
1771   return GST_VALUE_UNORDERED;
1772 }
1773
1774 static gboolean
1775 gst_value_deserialize_fraction_range (GValue * dest, const gchar * s)
1776 {
1777   g_warning ("unimplemented");
1778   return FALSE;
1779 }
1780
1781 /***********
1782  * GstCaps *
1783  ***********/
1784
1785 /**
1786  * gst_value_set_caps:
1787  * @value: a GValue initialized to GST_TYPE_CAPS
1788  * @caps: (transfer none): the caps to set the value to
1789  *
1790  * Sets the contents of @value to @caps. A reference to the
1791  * provided @caps will be taken by the @value.
1792  */
1793 void
1794 gst_value_set_caps (GValue * value, const GstCaps * caps)
1795 {
1796   g_return_if_fail (G_IS_VALUE (value));
1797   g_return_if_fail (G_VALUE_TYPE (value) == GST_TYPE_CAPS);
1798   g_return_if_fail (caps == NULL || GST_IS_CAPS (caps));
1799
1800   g_value_set_boxed (value, caps);
1801 }
1802
1803 /**
1804  * gst_value_get_caps:
1805  * @value: a GValue initialized to GST_TYPE_CAPS
1806  *
1807  * Gets the contents of @value. The reference count of the returned
1808  * #GstCaps will not be modified, therefore the caller must take one
1809  * before getting rid of the @value.
1810  *
1811  * Returns: (transfer none): the contents of @value
1812  */
1813 const GstCaps *
1814 gst_value_get_caps (const GValue * value)
1815 {
1816   g_return_val_if_fail (G_IS_VALUE (value), NULL);
1817   g_return_val_if_fail (G_VALUE_TYPE (value) == GST_TYPE_CAPS, NULL);
1818
1819   return (GstCaps *) g_value_get_boxed (value);
1820 }
1821
1822 static gchar *
1823 gst_value_serialize_caps (const GValue * value)
1824 {
1825   GstCaps *caps = g_value_get_boxed (value);
1826
1827   return gst_caps_to_string (caps);
1828 }
1829
1830 static gboolean
1831 gst_value_deserialize_caps (GValue * dest, const gchar * s)
1832 {
1833   GstCaps *caps;
1834
1835   caps = gst_caps_from_string (s);
1836
1837   if (caps) {
1838     g_value_take_boxed (dest, caps);
1839     return TRUE;
1840   }
1841   return FALSE;
1842 }
1843
1844 /****************
1845  * GstStructure *
1846  ****************/
1847
1848 /**
1849  * gst_value_set_structure:
1850  * @value: a GValue initialized to GST_TYPE_STRUCTURE
1851  * @structure: the structure to set the value to
1852  *
1853  * Sets the contents of @value to @structure.  The actual
1854  *
1855  * Since: 0.10.15
1856  */
1857 void
1858 gst_value_set_structure (GValue * value, const GstStructure * structure)
1859 {
1860   g_return_if_fail (G_IS_VALUE (value));
1861   g_return_if_fail (G_VALUE_TYPE (value) == GST_TYPE_STRUCTURE);
1862   g_return_if_fail (structure == NULL || GST_IS_STRUCTURE (structure));
1863
1864   g_value_set_boxed (value, structure);
1865 }
1866
1867 /**
1868  * gst_value_get_structure:
1869  * @value: a GValue initialized to GST_TYPE_STRUCTURE
1870  *
1871  * Gets the contents of @value.
1872  *
1873  * Returns: (transfer none): the contents of @value
1874  *
1875  * Since: 0.10.15
1876  */
1877 const GstStructure *
1878 gst_value_get_structure (const GValue * value)
1879 {
1880   g_return_val_if_fail (G_IS_VALUE (value), NULL);
1881   g_return_val_if_fail (G_VALUE_TYPE (value) == GST_TYPE_STRUCTURE, NULL);
1882
1883   return (GstStructure *) g_value_get_boxed (value);
1884 }
1885
1886 static gchar *
1887 gst_value_serialize_structure (const GValue * value)
1888 {
1889   GstStructure *structure = g_value_get_boxed (value);
1890
1891   return gst_string_take_and_wrap (gst_structure_to_string (structure));
1892 }
1893
1894 static gboolean
1895 gst_value_deserialize_structure (GValue * dest, const gchar * s)
1896 {
1897   GstStructure *structure;
1898
1899   if (*s != '"') {
1900     structure = gst_structure_from_string (s, NULL);
1901   } else {
1902     gchar *str = gst_string_unwrap (s);
1903
1904     if (G_UNLIKELY (!str))
1905       return FALSE;
1906
1907     structure = gst_structure_from_string (str, NULL);
1908     g_free (str);
1909   }
1910
1911   if (G_LIKELY (structure)) {
1912     g_value_take_boxed (dest, structure);
1913     return TRUE;
1914   }
1915   return FALSE;
1916 }
1917
1918 /*************
1919  * GstBuffer *
1920  *************/
1921
1922 static gint
1923 gst_value_compare_buffer (const GValue * value1, const GValue * value2)
1924 {
1925   GstBuffer *buf1 = gst_value_get_buffer (value1);
1926   GstBuffer *buf2 = gst_value_get_buffer (value2);
1927   gsize size1, size2;
1928   GstMapInfo info1, info2;
1929   gint result = GST_VALUE_UNORDERED;
1930
1931   size1 = gst_buffer_get_size (buf1);
1932   size2 = gst_buffer_get_size (buf2);
1933
1934   if (size1 != size2)
1935     return GST_VALUE_UNORDERED;
1936
1937   if (size1 == 0)
1938     return GST_VALUE_EQUAL;
1939
1940   if (!gst_buffer_map (buf1, &info1, GST_MAP_READ))
1941     return GST_VALUE_UNORDERED;
1942
1943   if (!gst_buffer_map (buf2, &info2, GST_MAP_READ)) {
1944     gst_buffer_unmap (buf1, &info2);
1945     return GST_VALUE_UNORDERED;
1946   }
1947
1948   if (memcmp (info1.data, info2.data, info1.size) == 0)
1949     result = GST_VALUE_EQUAL;
1950
1951   gst_buffer_unmap (buf2, &info1);
1952   gst_buffer_unmap (buf1, &info2);
1953
1954   return result;
1955 }
1956
1957 static gchar *
1958 gst_value_serialize_buffer (const GValue * value)
1959 {
1960   GstMapInfo info;
1961   guint8 *data;
1962   gint i;
1963   gchar *string;
1964   GstBuffer *buffer;
1965
1966   buffer = gst_value_get_buffer (value);
1967   if (buffer == NULL)
1968     return NULL;
1969
1970   if (!gst_buffer_map (buffer, &info, GST_MAP_READ))
1971     return NULL;
1972
1973   data = info.data;
1974
1975   string = g_malloc (info.size * 2 + 1);
1976   for (i = 0; i < info.size; i++) {
1977     sprintf (string + i * 2, "%02x", data[i]);
1978   }
1979   string[info.size * 2] = 0;
1980
1981   gst_buffer_unmap (buffer, &info);
1982
1983   return string;
1984 }
1985
1986 static gboolean
1987 gst_value_deserialize_buffer (GValue * dest, const gchar * s)
1988 {
1989   GstBuffer *buffer;
1990   gint len;
1991   gchar ts[3];
1992   GstMapInfo info;
1993   guint8 *data;
1994   gint i;
1995
1996   len = strlen (s);
1997   if (len & 1)
1998     goto wrong_length;
1999
2000   buffer = gst_buffer_new_allocate (NULL, len / 2, NULL);
2001   if (!gst_buffer_map (buffer, &info, GST_MAP_WRITE))
2002     goto map_failed;
2003   data = info.data;
2004
2005   for (i = 0; i < len / 2; i++) {
2006     if (!isxdigit ((int) s[i * 2]) || !isxdigit ((int) s[i * 2 + 1]))
2007       goto wrong_char;
2008
2009     ts[0] = s[i * 2 + 0];
2010     ts[1] = s[i * 2 + 1];
2011     ts[2] = 0;
2012
2013     data[i] = (guint8) strtoul (ts, NULL, 16);
2014   }
2015   gst_buffer_unmap (buffer, &info);
2016
2017   gst_value_take_buffer (dest, buffer);
2018
2019   return TRUE;
2020
2021   /* ERRORS */
2022 wrong_length:
2023   {
2024     return FALSE;
2025   }
2026 map_failed:
2027   {
2028     return FALSE;
2029   }
2030 wrong_char:
2031   {
2032     gst_buffer_unref (buffer);
2033     gst_buffer_unmap (buffer, &info);
2034     return FALSE;
2035   }
2036 }
2037
2038
2039 /***********
2040  * boolean *
2041  ***********/
2042
2043 static gint
2044 gst_value_compare_boolean (const GValue * value1, const GValue * value2)
2045 {
2046   if ((value1->data[0].v_int != 0) == (value2->data[0].v_int != 0))
2047     return GST_VALUE_EQUAL;
2048   return GST_VALUE_UNORDERED;
2049 }
2050
2051 static gchar *
2052 gst_value_serialize_boolean (const GValue * value)
2053 {
2054   if (value->data[0].v_int) {
2055     return g_strdup ("true");
2056   }
2057   return g_strdup ("false");
2058 }
2059
2060 static gboolean
2061 gst_value_deserialize_boolean (GValue * dest, const gchar * s)
2062 {
2063   gboolean ret = FALSE;
2064
2065   if (g_ascii_strcasecmp (s, "true") == 0 ||
2066       g_ascii_strcasecmp (s, "yes") == 0 ||
2067       g_ascii_strcasecmp (s, "t") == 0 || strcmp (s, "1") == 0) {
2068     g_value_set_boolean (dest, TRUE);
2069     ret = TRUE;
2070   } else if (g_ascii_strcasecmp (s, "false") == 0 ||
2071       g_ascii_strcasecmp (s, "no") == 0 ||
2072       g_ascii_strcasecmp (s, "f") == 0 || strcmp (s, "0") == 0) {
2073     g_value_set_boolean (dest, FALSE);
2074     ret = TRUE;
2075   }
2076
2077   return ret;
2078 }
2079
2080 #define CREATE_SERIALIZATION_START(_type,_macro)                        \
2081 static gint                                                             \
2082 gst_value_compare_ ## _type                                             \
2083 (const GValue * value1, const GValue * value2)                          \
2084 {                                                                       \
2085   g ## _type val1 = g_value_get_ ## _type (value1);                     \
2086   g ## _type val2 = g_value_get_ ## _type (value2);                     \
2087   if (val1 > val2)                                                      \
2088     return GST_VALUE_GREATER_THAN;                                      \
2089   if (val1 < val2)                                                      \
2090     return GST_VALUE_LESS_THAN;                                         \
2091   return GST_VALUE_EQUAL;                                               \
2092 }                                                                       \
2093                                                                         \
2094 static gchar *                                                          \
2095 gst_value_serialize_ ## _type (const GValue * value)                    \
2096 {                                                                       \
2097   GValue val = { 0, };                                                  \
2098   g_value_init (&val, G_TYPE_STRING);                                   \
2099   if (!g_value_transform (value, &val))                                 \
2100     g_assert_not_reached ();                                            \
2101   /* NO_COPY_MADNESS!!! */                                              \
2102   return (char *) g_value_get_string (&val);                            \
2103 }
2104
2105 /* deserialize the given s into to as a gint64.
2106  * check if the result is actually storeable in the given size number of
2107  * bytes.
2108  */
2109 static gboolean
2110 gst_value_deserialize_int_helper (gint64 * to, const gchar * s,
2111     gint64 min, gint64 max, gint size)
2112 {
2113   gboolean ret = FALSE;
2114   gchar *end;
2115   gint64 mask = -1;
2116
2117   errno = 0;
2118   *to = g_ascii_strtoull (s, &end, 0);
2119   /* a range error is a definitive no-no */
2120   if (errno == ERANGE) {
2121     return FALSE;
2122   }
2123
2124   if (*end == 0) {
2125     ret = TRUE;
2126   } else {
2127     if (g_ascii_strcasecmp (s, "little_endian") == 0) {
2128       *to = G_LITTLE_ENDIAN;
2129       ret = TRUE;
2130     } else if (g_ascii_strcasecmp (s, "big_endian") == 0) {
2131       *to = G_BIG_ENDIAN;
2132       ret = TRUE;
2133     } else if (g_ascii_strcasecmp (s, "byte_order") == 0) {
2134       *to = G_BYTE_ORDER;
2135       ret = TRUE;
2136     } else if (g_ascii_strcasecmp (s, "min") == 0) {
2137       *to = min;
2138       ret = TRUE;
2139     } else if (g_ascii_strcasecmp (s, "max") == 0) {
2140       *to = max;
2141       ret = TRUE;
2142     }
2143   }
2144   if (ret) {
2145     /* by definition, a gint64 fits into a gint64; so ignore those */
2146     if (size != sizeof (mask)) {
2147       if (*to >= 0) {
2148         /* for positive numbers, we create a mask of 1's outside of the range
2149          * and 0's inside the range.  An and will thus keep only 1 bits
2150          * outside of the range */
2151         mask <<= (size * 8);
2152         if ((mask & *to) != 0) {
2153           ret = FALSE;
2154         }
2155       } else {
2156         /* for negative numbers, we do a 2's complement version */
2157         mask <<= ((size * 8) - 1);
2158         if ((mask & *to) != mask) {
2159           ret = FALSE;
2160         }
2161       }
2162     }
2163   }
2164   return ret;
2165 }
2166
2167 #define CREATE_SERIALIZATION(_type,_macro)                              \
2168 CREATE_SERIALIZATION_START(_type,_macro)                                \
2169                                                                         \
2170 static gboolean                                                         \
2171 gst_value_deserialize_ ## _type (GValue * dest, const gchar *s)         \
2172 {                                                                       \
2173   gint64 x;                                                             \
2174                                                                         \
2175   if (gst_value_deserialize_int_helper (&x, s, G_MIN ## _macro,         \
2176       G_MAX ## _macro, sizeof (g ## _type))) {                          \
2177     g_value_set_ ## _type (dest, /*(g ## _type)*/ x);                   \
2178     return TRUE;                                                        \
2179   } else {                                                              \
2180     return FALSE;                                                       \
2181   }                                                                     \
2182 }
2183
2184 #define CREATE_USERIALIZATION(_type,_macro)                             \
2185 CREATE_SERIALIZATION_START(_type,_macro)                                \
2186                                                                         \
2187 static gboolean                                                         \
2188 gst_value_deserialize_ ## _type (GValue * dest, const gchar *s)         \
2189 {                                                                       \
2190   gint64 x;                                                             \
2191   gchar *end;                                                           \
2192   gboolean ret = FALSE;                                                 \
2193                                                                         \
2194   errno = 0;                                                            \
2195   x = g_ascii_strtoull (s, &end, 0);                                    \
2196   /* a range error is a definitive no-no */                             \
2197   if (errno == ERANGE) {                                                \
2198     return FALSE;                                                       \
2199   }                                                                     \
2200   /* the cast ensures the range check later on makes sense */           \
2201   x = (g ## _type) x;                                                   \
2202   if (*end == 0) {                                                      \
2203     ret = TRUE;                                                         \
2204   } else {                                                              \
2205     if (g_ascii_strcasecmp (s, "little_endian") == 0) {                 \
2206       x = G_LITTLE_ENDIAN;                                              \
2207       ret = TRUE;                                                       \
2208     } else if (g_ascii_strcasecmp (s, "big_endian") == 0) {             \
2209       x = G_BIG_ENDIAN;                                                 \
2210       ret = TRUE;                                                       \
2211     } else if (g_ascii_strcasecmp (s, "byte_order") == 0) {             \
2212       x = G_BYTE_ORDER;                                                 \
2213       ret = TRUE;                                                       \
2214     } else if (g_ascii_strcasecmp (s, "min") == 0) {                    \
2215       x = 0;                                                            \
2216       ret = TRUE;                                                       \
2217     } else if (g_ascii_strcasecmp (s, "max") == 0) {                    \
2218       x = G_MAX ## _macro;                                              \
2219       ret = TRUE;                                                       \
2220     }                                                                   \
2221   }                                                                     \
2222   if (ret) {                                                            \
2223     if (x > G_MAX ## _macro) {                                          \
2224       ret = FALSE;                                                      \
2225     } else {                                                            \
2226       g_value_set_ ## _type (dest, x);                                  \
2227     }                                                                   \
2228   }                                                                     \
2229   return ret;                                                           \
2230 }
2231
2232 #define REGISTER_SERIALIZATION(_gtype, _type)                           \
2233 G_STMT_START {                                                          \
2234   static const GstValueTable gst_value = {                              \
2235     _gtype,                                                             \
2236     gst_value_compare_ ## _type,                                        \
2237     gst_value_serialize_ ## _type,                                      \
2238     gst_value_deserialize_ ## _type,                                    \
2239   };                                                                    \
2240                                                                         \
2241   gst_value_register (&gst_value);                                      \
2242 } G_STMT_END
2243
2244 CREATE_SERIALIZATION (int, INT);
2245 CREATE_SERIALIZATION (int64, INT64);
2246 CREATE_SERIALIZATION (long, LONG);
2247
2248 CREATE_USERIALIZATION (uint, UINT);
2249 CREATE_USERIALIZATION (uint64, UINT64);
2250 CREATE_USERIALIZATION (ulong, ULONG);
2251
2252 /* FIXME 0.11: remove this again, plugins shouldn't have uchar properties */
2253 #ifndef G_MAXUCHAR
2254 #define G_MAXUCHAR 255
2255 #endif
2256 CREATE_USERIALIZATION (uchar, UCHAR);
2257
2258 /**********
2259  * double *
2260  **********/
2261 static gint
2262 gst_value_compare_double (const GValue * value1, const GValue * value2)
2263 {
2264   if (value1->data[0].v_double > value2->data[0].v_double)
2265     return GST_VALUE_GREATER_THAN;
2266   if (value1->data[0].v_double < value2->data[0].v_double)
2267     return GST_VALUE_LESS_THAN;
2268   if (value1->data[0].v_double == value2->data[0].v_double)
2269     return GST_VALUE_EQUAL;
2270   return GST_VALUE_UNORDERED;
2271 }
2272
2273 static gchar *
2274 gst_value_serialize_double (const GValue * value)
2275 {
2276   gchar d[G_ASCII_DTOSTR_BUF_SIZE];
2277
2278   g_ascii_dtostr (d, G_ASCII_DTOSTR_BUF_SIZE, value->data[0].v_double);
2279   return g_strdup (d);
2280 }
2281
2282 static gboolean
2283 gst_value_deserialize_double (GValue * dest, const gchar * s)
2284 {
2285   gdouble x;
2286   gboolean ret = FALSE;
2287   gchar *end;
2288
2289   x = g_ascii_strtod (s, &end);
2290   if (*end == 0) {
2291     ret = TRUE;
2292   } else {
2293     if (g_ascii_strcasecmp (s, "min") == 0) {
2294       x = -G_MAXDOUBLE;
2295       ret = TRUE;
2296     } else if (g_ascii_strcasecmp (s, "max") == 0) {
2297       x = G_MAXDOUBLE;
2298       ret = TRUE;
2299     }
2300   }
2301   if (ret) {
2302     g_value_set_double (dest, x);
2303   }
2304   return ret;
2305 }
2306
2307 /*********
2308  * float *
2309  *********/
2310
2311 static gint
2312 gst_value_compare_float (const GValue * value1, const GValue * value2)
2313 {
2314   if (value1->data[0].v_float > value2->data[0].v_float)
2315     return GST_VALUE_GREATER_THAN;
2316   if (value1->data[0].v_float < value2->data[0].v_float)
2317     return GST_VALUE_LESS_THAN;
2318   if (value1->data[0].v_float == value2->data[0].v_float)
2319     return GST_VALUE_EQUAL;
2320   return GST_VALUE_UNORDERED;
2321 }
2322
2323 static gchar *
2324 gst_value_serialize_float (const GValue * value)
2325 {
2326   gchar d[G_ASCII_DTOSTR_BUF_SIZE];
2327
2328   g_ascii_dtostr (d, G_ASCII_DTOSTR_BUF_SIZE, value->data[0].v_float);
2329   return g_strdup (d);
2330 }
2331
2332 static gboolean
2333 gst_value_deserialize_float (GValue * dest, const gchar * s)
2334 {
2335   gdouble x;
2336   gboolean ret = FALSE;
2337   gchar *end;
2338
2339   x = g_ascii_strtod (s, &end);
2340   if (*end == 0) {
2341     ret = TRUE;
2342   } else {
2343     if (g_ascii_strcasecmp (s, "min") == 0) {
2344       x = -G_MAXFLOAT;
2345       ret = TRUE;
2346     } else if (g_ascii_strcasecmp (s, "max") == 0) {
2347       x = G_MAXFLOAT;
2348       ret = TRUE;
2349     }
2350   }
2351   if (x > G_MAXFLOAT || x < -G_MAXFLOAT)
2352     ret = FALSE;
2353   if (ret) {
2354     g_value_set_float (dest, (float) x);
2355   }
2356   return ret;
2357 }
2358
2359 /**********
2360  * string *
2361  **********/
2362
2363 static gint
2364 gst_value_compare_string (const GValue * value1, const GValue * value2)
2365 {
2366   if (G_UNLIKELY (!value1->data[0].v_pointer || !value2->data[0].v_pointer)) {
2367     /* if only one is NULL, no match - otherwise both NULL == EQUAL */
2368     if (value1->data[0].v_pointer != value2->data[0].v_pointer)
2369       return GST_VALUE_UNORDERED;
2370   } else {
2371     gint x = strcmp (value1->data[0].v_pointer, value2->data[0].v_pointer);
2372
2373     if (x < 0)
2374       return GST_VALUE_LESS_THAN;
2375     if (x > 0)
2376       return GST_VALUE_GREATER_THAN;
2377   }
2378
2379   return GST_VALUE_EQUAL;
2380 }
2381
2382 static gint
2383 gst_string_measure_wrapping (const gchar * s)
2384 {
2385   gint len;
2386   gboolean wrap = FALSE;
2387
2388   if (G_UNLIKELY (s == NULL))
2389     return -1;
2390
2391   /* Special case: the actual string NULL needs wrapping */
2392   if (G_UNLIKELY (strcmp (s, "NULL") == 0))
2393     return 4;
2394
2395   len = 0;
2396   while (*s) {
2397     if (GST_ASCII_IS_STRING (*s)) {
2398       len++;
2399     } else if (*s < 0x20 || *s >= 0x7f) {
2400       wrap = TRUE;
2401       len += 4;
2402     } else {
2403       wrap = TRUE;
2404       len += 2;
2405     }
2406     s++;
2407   }
2408
2409   /* Wrap the string if we found something that needs
2410    * wrapping, or the empty string (len == 0) */
2411   return (wrap || len == 0) ? len : -1;
2412 }
2413
2414 static gchar *
2415 gst_string_wrap_inner (const gchar * s, gint len)
2416 {
2417   gchar *d, *e;
2418
2419   e = d = g_malloc (len + 3);
2420
2421   *e++ = '\"';
2422   while (*s) {
2423     if (GST_ASCII_IS_STRING (*s)) {
2424       *e++ = *s++;
2425     } else if (*s < 0x20 || *s >= 0x7f) {
2426       *e++ = '\\';
2427       *e++ = '0' + ((*(guchar *) s) >> 6);
2428       *e++ = '0' + (((*s) >> 3) & 0x7);
2429       *e++ = '0' + ((*s++) & 0x7);
2430     } else {
2431       *e++ = '\\';
2432       *e++ = *s++;
2433     }
2434   }
2435   *e++ = '\"';
2436   *e = 0;
2437
2438   g_assert (e - d <= len + 3);
2439   return d;
2440 }
2441
2442 /* Do string wrapping/escaping */
2443 static gchar *
2444 gst_string_wrap (const gchar * s)
2445 {
2446   gint len = gst_string_measure_wrapping (s);
2447
2448   if (G_LIKELY (len < 0))
2449     return g_strdup (s);
2450
2451   return gst_string_wrap_inner (s, len);
2452 }
2453
2454 /* Same as above, but take ownership of the string */
2455 static gchar *
2456 gst_string_take_and_wrap (gchar * s)
2457 {
2458   gchar *out;
2459   gint len = gst_string_measure_wrapping (s);
2460
2461   if (G_LIKELY (len < 0))
2462     return s;
2463
2464   out = gst_string_wrap_inner (s, len);
2465   g_free (s);
2466
2467   return out;
2468 }
2469
2470 /*
2471  * This function takes a string delimited with double quotes (")
2472  * and unescapes any \xxx octal numbers.
2473  *
2474  * If sequences of \y are found where y is not in the range of
2475  * 0->3, y is copied unescaped.
2476  *
2477  * If \xyy is found where x is an octal number but y is not, an
2478  * error is encountered and NULL is returned.
2479  *
2480  * the input string must be \0 terminated.
2481  */
2482 static gchar *
2483 gst_string_unwrap (const gchar * s)
2484 {
2485   gchar *ret;
2486   gchar *read, *write;
2487
2488   /* NULL string returns NULL */
2489   if (s == NULL)
2490     return NULL;
2491
2492   /* strings not starting with " are invalid */
2493   if (*s != '"')
2494     return NULL;
2495
2496   /* make copy of original string to hold the result. This
2497    * string will always be smaller than the original */
2498   ret = g_strdup (s);
2499   read = ret;
2500   write = ret;
2501
2502   /* need to move to the next position as we parsed the " */
2503   read++;
2504
2505   while (*read) {
2506     if (GST_ASCII_IS_STRING (*read)) {
2507       /* normal chars are just copied */
2508       *write++ = *read++;
2509     } else if (*read == '"') {
2510       /* quote marks end of string */
2511       break;
2512     } else if (*read == '\\') {
2513       /* got an escape char, move to next position to read a tripplet
2514        * of octal numbers */
2515       read++;
2516       /* is the next char a possible first octal number? */
2517       if (*read >= '0' && *read <= '3') {
2518         /* parse other 2 numbers, if one of them is not in the range of
2519          * an octal number, we error. We also catch the case where a zero
2520          * byte is found here. */
2521         if (read[1] < '0' || read[1] > '7' || read[2] < '0' || read[2] > '7')
2522           goto beach;
2523
2524         /* now convert the octal number to a byte again. */
2525         *write++ = ((read[0] - '0') << 6) +
2526             ((read[1] - '0') << 3) + (read[2] - '0');
2527
2528         read += 3;
2529       } else {
2530         /* if we run into a \0 here, we definitely won't get a quote later */
2531         if (*read == 0)
2532           goto beach;
2533
2534         /* else copy \X sequence */
2535         *write++ = *read++;
2536       }
2537     } else {
2538       /* weird character, error */
2539       goto beach;
2540     }
2541   }
2542   /* if the string is not ending in " and zero terminated, we error */
2543   if (*read != '"' || read[1] != '\0')
2544     goto beach;
2545
2546   /* null terminate result string and return */
2547   *write = '\0';
2548   return ret;
2549
2550 beach:
2551   g_free (ret);
2552   return NULL;
2553 }
2554
2555 static gchar *
2556 gst_value_serialize_string (const GValue * value)
2557 {
2558   return gst_string_wrap (value->data[0].v_pointer);
2559 }
2560
2561 static gboolean
2562 gst_value_deserialize_string (GValue * dest, const gchar * s)
2563 {
2564   if (G_UNLIKELY (strcmp (s, "NULL") == 0)) {
2565     g_value_set_string (dest, NULL);
2566     return TRUE;
2567   } else if (G_LIKELY (*s != '"')) {
2568     if (!g_utf8_validate (s, -1, NULL))
2569       return FALSE;
2570     g_value_set_string (dest, s);
2571     return TRUE;
2572   } else {
2573     gchar *str = gst_string_unwrap (s);
2574     if (G_UNLIKELY (!str))
2575       return FALSE;
2576     g_value_take_string (dest, str);
2577   }
2578
2579   return TRUE;
2580 }
2581
2582 /********
2583  * enum *
2584  ********/
2585
2586 static gint
2587 gst_value_compare_enum (const GValue * value1, const GValue * value2)
2588 {
2589   GEnumValue *en1, *en2;
2590   GEnumClass *klass1 = (GEnumClass *) g_type_class_ref (G_VALUE_TYPE (value1));
2591   GEnumClass *klass2 = (GEnumClass *) g_type_class_ref (G_VALUE_TYPE (value2));
2592
2593   g_return_val_if_fail (klass1, GST_VALUE_UNORDERED);
2594   g_return_val_if_fail (klass2, GST_VALUE_UNORDERED);
2595   en1 = g_enum_get_value (klass1, g_value_get_enum (value1));
2596   en2 = g_enum_get_value (klass2, g_value_get_enum (value2));
2597   g_type_class_unref (klass1);
2598   g_type_class_unref (klass2);
2599   g_return_val_if_fail (en1, GST_VALUE_UNORDERED);
2600   g_return_val_if_fail (en2, GST_VALUE_UNORDERED);
2601   if (en1->value < en2->value)
2602     return GST_VALUE_LESS_THAN;
2603   if (en1->value > en2->value)
2604     return GST_VALUE_GREATER_THAN;
2605
2606   return GST_VALUE_EQUAL;
2607 }
2608
2609 static gchar *
2610 gst_value_serialize_enum (const GValue * value)
2611 {
2612   GEnumValue *en;
2613   GEnumClass *klass = (GEnumClass *) g_type_class_ref (G_VALUE_TYPE (value));
2614
2615   g_return_val_if_fail (klass, NULL);
2616   en = g_enum_get_value (klass, g_value_get_enum (value));
2617   g_type_class_unref (klass);
2618
2619   /* might be one of the custom formats registered later */
2620   if (G_UNLIKELY (en == NULL && G_VALUE_TYPE (value) == GST_TYPE_FORMAT)) {
2621     const GstFormatDefinition *format_def;
2622
2623     format_def = gst_format_get_details ((GstFormat) g_value_get_enum (value));
2624     g_return_val_if_fail (format_def != NULL, NULL);
2625     return g_strdup (format_def->description);
2626   }
2627
2628   g_return_val_if_fail (en, NULL);
2629   return g_strdup (en->value_name);
2630 }
2631
2632 static gint
2633 gst_value_deserialize_enum_iter_cmp (const GValue * format_def_value,
2634     const gchar * s)
2635 {
2636   const GstFormatDefinition *format_def =
2637       g_value_get_pointer (format_def_value);
2638
2639   if (g_ascii_strcasecmp (s, format_def->nick) == 0)
2640     return 0;
2641
2642   return g_ascii_strcasecmp (s, format_def->description);
2643 }
2644
2645 static gboolean
2646 gst_value_deserialize_enum (GValue * dest, const gchar * s)
2647 {
2648   GEnumValue *en;
2649   gchar *endptr = NULL;
2650   GEnumClass *klass = (GEnumClass *) g_type_class_ref (G_VALUE_TYPE (dest));
2651
2652   g_return_val_if_fail (klass, FALSE);
2653   if (!(en = g_enum_get_value_by_name (klass, s))) {
2654     if (!(en = g_enum_get_value_by_nick (klass, s))) {
2655       gint i = strtol (s, &endptr, 0);
2656
2657       if (endptr && *endptr == '\0') {
2658         en = g_enum_get_value (klass, i);
2659       }
2660     }
2661   }
2662   g_type_class_unref (klass);
2663
2664   /* might be one of the custom formats registered later */
2665   if (G_UNLIKELY (en == NULL && G_VALUE_TYPE (dest) == GST_TYPE_FORMAT)) {
2666     GValue res = { 0, };
2667     const GstFormatDefinition *format_def;
2668     GstIterator *iter;
2669     gboolean found;
2670
2671     iter = gst_format_iterate_definitions ();
2672
2673     found = gst_iterator_find_custom (iter,
2674         (GCompareFunc) gst_value_deserialize_enum_iter_cmp, &res, (gpointer) s);
2675
2676     g_return_val_if_fail (found, FALSE);
2677     format_def = g_value_get_pointer (&res);
2678     g_return_val_if_fail (format_def != NULL, FALSE);
2679     g_value_set_enum (dest, (gint) format_def->value);
2680     g_value_unset (&res);
2681     gst_iterator_free (iter);
2682     return TRUE;
2683   }
2684
2685   g_return_val_if_fail (en, FALSE);
2686   g_value_set_enum (dest, en->value);
2687   return TRUE;
2688 }
2689
2690 /********
2691  * flags *
2692  ********/
2693
2694 /* we just compare the value here */
2695 static gint
2696 gst_value_compare_flags (const GValue * value1, const GValue * value2)
2697 {
2698   guint fl1, fl2;
2699   GFlagsClass *klass1 =
2700       (GFlagsClass *) g_type_class_ref (G_VALUE_TYPE (value1));
2701   GFlagsClass *klass2 =
2702       (GFlagsClass *) g_type_class_ref (G_VALUE_TYPE (value2));
2703
2704   g_return_val_if_fail (klass1, GST_VALUE_UNORDERED);
2705   g_return_val_if_fail (klass2, GST_VALUE_UNORDERED);
2706   fl1 = g_value_get_flags (value1);
2707   fl2 = g_value_get_flags (value2);
2708   g_type_class_unref (klass1);
2709   g_type_class_unref (klass2);
2710   if (fl1 < fl2)
2711     return GST_VALUE_LESS_THAN;
2712   if (fl1 > fl2)
2713     return GST_VALUE_GREATER_THAN;
2714
2715   return GST_VALUE_EQUAL;
2716 }
2717
2718 /* the different flags are serialized separated with a + */
2719 static gchar *
2720 gst_value_serialize_flags (const GValue * value)
2721 {
2722   guint flags;
2723   GFlagsValue *fl;
2724   GFlagsClass *klass = (GFlagsClass *) g_type_class_ref (G_VALUE_TYPE (value));
2725   gchar *result, *tmp;
2726   gboolean first = TRUE;
2727
2728   g_return_val_if_fail (klass, NULL);
2729
2730   flags = g_value_get_flags (value);
2731
2732   /* if no flags are set, try to serialize to the _NONE string */
2733   if (!flags) {
2734     fl = g_flags_get_first_value (klass, flags);
2735     return g_strdup (fl->value_name);
2736   }
2737
2738   /* some flags are set, so serialize one by one */
2739   result = g_strdup ("");
2740   while (flags) {
2741     fl = g_flags_get_first_value (klass, flags);
2742     if (fl != NULL) {
2743       tmp = g_strconcat (result, (first ? "" : "+"), fl->value_name, NULL);
2744       g_free (result);
2745       result = tmp;
2746       first = FALSE;
2747
2748       /* clear flag */
2749       flags &= ~fl->value;
2750     }
2751   }
2752   g_type_class_unref (klass);
2753
2754   return result;
2755 }
2756
2757 static gboolean
2758 gst_value_deserialize_flags (GValue * dest, const gchar * s)
2759 {
2760   GFlagsValue *fl;
2761   gchar *endptr = NULL;
2762   GFlagsClass *klass = (GFlagsClass *) g_type_class_ref (G_VALUE_TYPE (dest));
2763   gchar **split;
2764   guint flags;
2765   gint i;
2766
2767   g_return_val_if_fail (klass, FALSE);
2768
2769   /* split into parts delimited with + */
2770   split = g_strsplit (s, "+", 0);
2771
2772   flags = 0;
2773   i = 0;
2774   /* loop over each part */
2775   while (split[i]) {
2776     if (!(fl = g_flags_get_value_by_name (klass, split[i]))) {
2777       if (!(fl = g_flags_get_value_by_nick (klass, split[i]))) {
2778         gint val = strtol (split[i], &endptr, 0);
2779
2780         /* just or numeric value */
2781         if (endptr && *endptr == '\0') {
2782           flags |= val;
2783         }
2784       }
2785     }
2786     if (fl) {
2787       flags |= fl->value;
2788     }
2789     i++;
2790   }
2791   g_strfreev (split);
2792   g_type_class_unref (klass);
2793   g_value_set_flags (dest, flags);
2794
2795   return TRUE;
2796 }
2797
2798 /****************
2799  * subset *
2800  ****************/
2801
2802 static gboolean
2803 gst_value_is_subset_int_range_int_range (const GValue * value1,
2804     const GValue * value2)
2805 {
2806   gint gcd;
2807
2808   g_return_val_if_fail (GST_VALUE_HOLDS_INT_RANGE (value1), FALSE);
2809   g_return_val_if_fail (GST_VALUE_HOLDS_INT_RANGE (value2), FALSE);
2810
2811   if (INT_RANGE_MIN (value1) * INT_RANGE_STEP (value1) <
2812       INT_RANGE_MIN (value2) * INT_RANGE_STEP (value2))
2813     return FALSE;
2814   if (INT_RANGE_MAX (value1) * INT_RANGE_STEP (value1) >
2815       INT_RANGE_MAX (value2) * INT_RANGE_STEP (value2))
2816     return FALSE;
2817
2818   if (INT_RANGE_MIN (value2) == INT_RANGE_MAX (value2)) {
2819     if ((INT_RANGE_MIN (value2) * INT_RANGE_STEP (value2)) %
2820         INT_RANGE_STEP (value1))
2821       return FALSE;
2822     return TRUE;
2823   }
2824
2825   gcd =
2826       gst_util_greatest_common_divisor (INT_RANGE_STEP (value1),
2827       INT_RANGE_STEP (value2));
2828   if (gcd != MIN (INT_RANGE_STEP (value1), INT_RANGE_STEP (value2)))
2829     return FALSE;
2830
2831   return TRUE;
2832 }
2833
2834 static gboolean
2835 gst_value_is_subset_int64_range_int64_range (const GValue * value1,
2836     const GValue * value2)
2837 {
2838   gint64 gcd;
2839
2840   g_return_val_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value1), FALSE);
2841   g_return_val_if_fail (GST_VALUE_HOLDS_INT64_RANGE (value2), FALSE);
2842
2843   if (INT64_RANGE_MIN (value1) < INT64_RANGE_MIN (value2))
2844     return FALSE;
2845   if (INT64_RANGE_MAX (value1) > INT64_RANGE_MAX (value2))
2846     return FALSE;
2847
2848   if (INT64_RANGE_MIN (value2) == INT64_RANGE_MAX (value2)) {
2849     if ((INT64_RANGE_MIN (value2) * INT64_RANGE_STEP (value2)) %
2850         INT64_RANGE_STEP (value1))
2851       return FALSE;
2852     return TRUE;
2853   }
2854
2855   gcd =
2856       gst_util_greatest_common_divisor_int64 (INT64_RANGE_STEP (value1),
2857       INT64_RANGE_STEP (value2));
2858   if (gcd != MIN (INT64_RANGE_STEP (value1), INT64_RANGE_STEP (value2)))
2859     return FALSE;
2860
2861   return TRUE;
2862 }
2863
2864 gboolean
2865 gst_value_is_subset (const GValue * value1, const GValue * value2)
2866 {
2867   /* special case for int/int64 ranges, since we cannot compute
2868      the difference for those when they have different steps,
2869      and it's actually a lot simpler to compute whether a range
2870      is a subset of another. */
2871   if (GST_VALUE_HOLDS_INT_RANGE (value1) && GST_VALUE_HOLDS_INT_RANGE (value2)) {
2872     return gst_value_is_subset_int_range_int_range (value1, value2);
2873   } else if (GST_VALUE_HOLDS_INT64_RANGE (value1)
2874       && GST_VALUE_HOLDS_INT64_RANGE (value2)) {
2875     return gst_value_is_subset_int64_range_int64_range (value1, value2);
2876   }
2877
2878   /*
2879    * 1 - [1,2] = empty
2880    * -> !subset
2881    *
2882    * [1,2] - 1 = 2
2883    *  -> 1 - [1,2] = empty
2884    *  -> subset
2885    *
2886    * [1,3] - [1,2] = 3
2887    * -> [1,2] - [1,3] = empty
2888    * -> subset
2889    *
2890    * {1,2} - {1,3} = 2
2891    * -> {1,3} - {1,2} = 3
2892    * -> !subset
2893    *
2894    *  First caps subtraction needs to return a non-empty set, second
2895    *  subtractions needs to give en empty set.
2896    *  Both substractions are switched below, as it's faster that way.
2897    */
2898   if (!gst_value_subtract (NULL, value1, value2)) {
2899     if (gst_value_subtract (NULL, value2, value1)) {
2900       return TRUE;
2901     }
2902   }
2903   return FALSE;
2904 }
2905
2906 /*********
2907  * union *
2908  *********/
2909
2910 static gboolean
2911 gst_value_union_int_int_range (GValue * dest, const GValue * src1,
2912     const GValue * src2)
2913 {
2914   gint v = src1->data[0].v_int;
2915
2916   /* check if it's already in the range */
2917   if (INT_RANGE_MIN (src2) * INT_RANGE_STEP (src2) <= v &&
2918       INT_RANGE_MAX (src2) * INT_RANGE_STEP (src2) >= v &&
2919       v % INT_RANGE_STEP (src2) == 0) {
2920     if (dest)
2921       gst_value_init_and_copy (dest, src2);
2922     return TRUE;
2923   }
2924
2925   /* check if it extends the range */
2926   if (v == (INT_RANGE_MIN (src2) - 1) * INT_RANGE_STEP (src2)) {
2927     if (dest) {
2928       gst_value_init_and_copy (dest, src2);
2929       --INT_RANGE_MIN (src2);
2930     }
2931     return TRUE;
2932   }
2933   if (v == (INT_RANGE_MAX (src2) + 1) * INT_RANGE_STEP (src2)) {
2934     if (dest) {
2935       gst_value_init_and_copy (dest, src2);
2936       ++INT_RANGE_MAX (src2);
2937     }
2938     return TRUE;
2939   }
2940
2941   return FALSE;
2942 }
2943
2944 static gboolean
2945 gst_value_union_int_range_int_range (GValue * dest, const GValue * src1,
2946     const GValue * src2)
2947 {
2948   /* We can union in several special cases:
2949      1 - one is a subset of another
2950      2 - same step and not disjoint
2951      3 - different step, at least one with one value which matches a 'next' or 'previous'
2952      - anything else ?
2953    */
2954
2955   /* 1 - subset */
2956   if (gst_value_is_subset_int_range_int_range (src1, src2)) {
2957     if (dest)
2958       gst_value_init_and_copy (dest, src2);
2959     return TRUE;
2960   }
2961   if (gst_value_is_subset_int_range_int_range (src2, src1)) {
2962     if (dest)
2963       gst_value_init_and_copy (dest, src1);
2964     return TRUE;
2965   }
2966
2967   /* 2 - same step and not disjoint */
2968   if (INT_RANGE_STEP (src1) == INT_RANGE_STEP (src2)) {
2969     if ((INT_RANGE_MIN (src1) <= INT_RANGE_MAX (src2) + 1 &&
2970             INT_RANGE_MAX (src1) >= INT_RANGE_MIN (src2) - 1) ||
2971         (INT_RANGE_MIN (src2) <= INT_RANGE_MAX (src1) + 1 &&
2972             INT_RANGE_MAX (src2) >= INT_RANGE_MIN (src1) - 1)) {
2973       if (dest) {
2974         gint step = INT_RANGE_STEP (src1);
2975         gint min = step * MIN (INT_RANGE_MIN (src1), INT_RANGE_MIN (src2));
2976         gint max = step * MAX (INT_RANGE_MAX (src1), INT_RANGE_MAX (src2));
2977         g_value_init (dest, GST_TYPE_INT_RANGE);
2978         gst_value_set_int_range_step (dest, min, max, step);
2979       }
2980       return TRUE;
2981     }
2982   }
2983
2984   /* 3 - single value matches next or previous */
2985   if (INT_RANGE_STEP (src1) != INT_RANGE_STEP (src2)) {
2986     gint n1 = INT_RANGE_MAX (src1) - INT_RANGE_MIN (src1) + 1;
2987     gint n2 = INT_RANGE_MAX (src2) - INT_RANGE_MIN (src2) + 1;
2988     if (n1 == 1 || n2 == 1) {
2989       const GValue *range_value = NULL;
2990       gint scalar = 0;
2991       if (n1 == 1) {
2992         range_value = src2;
2993         scalar = INT_RANGE_MIN (src1) * INT_RANGE_STEP (src1);
2994       } else if (n2 == 1) {
2995         range_value = src1;
2996         scalar = INT_RANGE_MIN (src2) * INT_RANGE_STEP (src2);
2997       }
2998
2999       if (scalar ==
3000           (INT_RANGE_MIN (range_value) - 1) * INT_RANGE_STEP (range_value)) {
3001         if (dest) {
3002           gst_value_init_and_copy (dest, range_value);
3003           --INT_RANGE_MIN (range_value);
3004         }
3005         return TRUE;
3006       } else if (scalar ==
3007           (INT_RANGE_MAX (range_value) + 1) * INT_RANGE_STEP (range_value)) {
3008         if (dest) {
3009           gst_value_init_and_copy (dest, range_value);
3010           ++INT_RANGE_MIN (range_value);
3011         }
3012         return TRUE;
3013       }
3014     }
3015   }
3016
3017   /* If we get there, we did not find a way to make a union that can be
3018      represented with our simplistic model. */
3019   return FALSE;
3020 }
3021
3022 /****************
3023  * intersection *
3024  ****************/
3025
3026 static gboolean
3027 gst_value_intersect_int_int_range (GValue * dest, const GValue * src1,
3028     const GValue * src2)
3029 {
3030   if (INT_RANGE_MIN (src2) * INT_RANGE_STEP (src2) <= src1->data[0].v_int &&
3031       INT_RANGE_MAX (src2) * INT_RANGE_STEP (src2) >= src1->data[0].v_int &&
3032       src1->data[0].v_int % INT_RANGE_STEP (src2) == 0) {
3033     if (dest)
3034       gst_value_init_and_copy (dest, src1);
3035     return TRUE;
3036   }
3037
3038   return FALSE;
3039 }
3040
3041 static gboolean
3042 gst_value_intersect_int_range_int_range (GValue * dest, const GValue * src1,
3043     const GValue * src2)
3044 {
3045   gint min;
3046   gint max;
3047   gint step;
3048
3049   step =
3050       INT_RANGE_STEP (src1) /
3051       gst_util_greatest_common_divisor (INT_RANGE_STEP (src1),
3052       INT_RANGE_STEP (src2));
3053   if (G_MAXINT32 / INT_RANGE_STEP (src2) < step)
3054     return FALSE;
3055   step *= INT_RANGE_STEP (src2);
3056
3057   min =
3058       MAX (INT_RANGE_MIN (src1) * INT_RANGE_STEP (src1),
3059       INT_RANGE_MIN (src2) * INT_RANGE_STEP (src2));
3060   min = (min + step - 1) / step * step;
3061   max =
3062       MIN (INT_RANGE_MAX (src1) * INT_RANGE_STEP (src1),
3063       INT_RANGE_MAX (src2) * INT_RANGE_STEP (src2));
3064   max = max / step * step;
3065
3066   if (min < max) {
3067     if (dest) {
3068       g_value_init (dest, GST_TYPE_INT_RANGE);
3069       gst_value_set_int_range_step (dest, min, max, step);
3070     }
3071     return TRUE;
3072   }
3073   if (min == max) {
3074     if (dest) {
3075       g_value_init (dest, G_TYPE_INT);
3076       g_value_set_int (dest, min);
3077     }
3078     return TRUE;
3079   }
3080
3081   return FALSE;
3082 }
3083
3084 static gboolean
3085 gst_value_intersect_int64_int64_range (GValue * dest, const GValue * src1,
3086     const GValue * src2)
3087 {
3088   if (INT64_RANGE_MIN (src2) * INT64_RANGE_STEP (src2) <= src1->data[0].v_int &&
3089       INT64_RANGE_MAX (src2) * INT64_RANGE_STEP (src2) >= src1->data[0].v_int &&
3090       src1->data[0].v_int % INT64_RANGE_STEP (src2) == 0) {
3091     if (dest)
3092       gst_value_init_and_copy (dest, src1);
3093     return TRUE;
3094   }
3095
3096   return FALSE;
3097 }
3098
3099 static gboolean
3100 gst_value_intersect_int64_range_int64_range (GValue * dest, const GValue * src1,
3101     const GValue * src2)
3102 {
3103   gint64 min;
3104   gint64 max;
3105   gint64 step;
3106
3107   step =
3108       INT64_RANGE_STEP (src1) /
3109       gst_util_greatest_common_divisor_int64 (INT64_RANGE_STEP (src1),
3110       INT64_RANGE_STEP (src2));
3111   if (G_MAXINT64 / INT64_RANGE_STEP (src2) < step)
3112     return FALSE;
3113   step *= INT64_RANGE_STEP (src2);
3114
3115   min =
3116       MAX (INT64_RANGE_MIN (src1) * INT64_RANGE_STEP (src1),
3117       INT64_RANGE_MIN (src2) * INT64_RANGE_STEP (src2));
3118   min = (min + step - 1) / step * step;
3119   max =
3120       MIN (INT64_RANGE_MAX (src1) * INT64_RANGE_STEP (src1),
3121       INT64_RANGE_MAX (src2) * INT64_RANGE_STEP (src2));
3122   max = max / step * step;
3123
3124   if (min < max) {
3125     if (dest) {
3126       g_value_init (dest, GST_TYPE_INT64_RANGE);
3127       gst_value_set_int64_range_step (dest, min, max, step);
3128     }
3129     return TRUE;
3130   }
3131   if (min == max) {
3132     if (dest) {
3133       g_value_init (dest, G_TYPE_INT64);
3134       g_value_set_int64 (dest, min);
3135     }
3136     return TRUE;
3137   }
3138
3139   return FALSE;
3140 }
3141
3142 static gboolean
3143 gst_value_intersect_double_double_range (GValue * dest, const GValue * src1,
3144     const GValue * src2)
3145 {
3146   if (src2->data[0].v_double <= src1->data[0].v_double &&
3147       src2->data[1].v_double >= src1->data[0].v_double) {
3148     if (dest)
3149       gst_value_init_and_copy (dest, src1);
3150     return TRUE;
3151   }
3152
3153   return FALSE;
3154 }
3155
3156 static gboolean
3157 gst_value_intersect_double_range_double_range (GValue * dest,
3158     const GValue * src1, const GValue * src2)
3159 {
3160   gdouble min;
3161   gdouble max;
3162
3163   min = MAX (src1->data[0].v_double, src2->data[0].v_double);
3164   max = MIN (src1->data[1].v_double, src2->data[1].v_double);
3165
3166   if (min < max) {
3167     if (dest) {
3168       g_value_init (dest, GST_TYPE_DOUBLE_RANGE);
3169       gst_value_set_double_range (dest, min, max);
3170     }
3171     return TRUE;
3172   }
3173   if (min == max) {
3174     if (dest) {
3175       g_value_init (dest, G_TYPE_DOUBLE);
3176       g_value_set_int (dest, (int) min);
3177     }
3178     return TRUE;
3179   }
3180
3181   return FALSE;
3182 }
3183
3184 static gboolean
3185 gst_value_intersect_list (GValue * dest, const GValue * value1,
3186     const GValue * value2)
3187 {
3188   guint i, size;
3189   GValue intersection = { 0, };
3190   gboolean ret = FALSE;
3191
3192   size = VALUE_LIST_SIZE (value1);
3193   for (i = 0; i < size; i++) {
3194     const GValue *cur = VALUE_LIST_GET_VALUE (value1, i);
3195
3196     /* quicker version when we don't need the resulting set */
3197     if (!dest) {
3198       if (gst_value_intersect (NULL, cur, value2)) {
3199         ret = TRUE;
3200         break;
3201       }
3202       continue;
3203     }
3204
3205     if (gst_value_intersect (&intersection, cur, value2)) {
3206       /* append value */
3207       if (!ret) {
3208         gst_value_init_and_copy (dest, &intersection);
3209         ret = TRUE;
3210       } else if (GST_VALUE_HOLDS_LIST (dest)) {
3211         gst_value_list_append_value (dest, &intersection);
3212       } else {
3213         GValue temp = { 0, };
3214
3215         gst_value_init_and_copy (&temp, dest);
3216         g_value_unset (dest);
3217         gst_value_list_concat (dest, &temp, &intersection);
3218         g_value_unset (&temp);
3219       }
3220       g_value_unset (&intersection);
3221     }
3222   }
3223
3224   return ret;
3225 }
3226
3227 static gboolean
3228 gst_value_intersect_array (GValue * dest, const GValue * src1,
3229     const GValue * src2)
3230 {
3231   guint size;
3232   guint n;
3233   GValue val = { 0 };
3234
3235   /* only works on similar-sized arrays */
3236   size = gst_value_array_get_size (src1);
3237   if (size != gst_value_array_get_size (src2))
3238     return FALSE;
3239
3240   /* quicker value when we don't need the resulting set */
3241   if (!dest) {
3242     for (n = 0; n < size; n++) {
3243       if (!gst_value_intersect (NULL, gst_value_array_get_value (src1, n),
3244               gst_value_array_get_value (src2, n))) {
3245         return FALSE;
3246       }
3247     }
3248     return TRUE;
3249   }
3250
3251   g_value_init (dest, GST_TYPE_ARRAY);
3252
3253   for (n = 0; n < size; n++) {
3254     if (!gst_value_intersect (&val, gst_value_array_get_value (src1, n),
3255             gst_value_array_get_value (src2, n))) {
3256       g_value_unset (dest);
3257       return FALSE;
3258     }
3259     gst_value_array_append_value (dest, &val);
3260     g_value_unset (&val);
3261   }
3262
3263   return TRUE;
3264 }
3265
3266 static gboolean
3267 gst_value_intersect_fraction_fraction_range (GValue * dest, const GValue * src1,
3268     const GValue * src2)
3269 {
3270   gint res1, res2;
3271   GValue *vals;
3272   GstValueCompareFunc compare;
3273
3274   vals = src2->data[0].v_pointer;
3275
3276   if (vals == NULL)
3277     return FALSE;
3278
3279   if ((compare = gst_value_get_compare_func (src1))) {
3280     res1 = gst_value_compare_with_func (&vals[0], src1, compare);
3281     res2 = gst_value_compare_with_func (&vals[1], src1, compare);
3282
3283     if ((res1 == GST_VALUE_EQUAL || res1 == GST_VALUE_LESS_THAN) &&
3284         (res2 == GST_VALUE_EQUAL || res2 == GST_VALUE_GREATER_THAN)) {
3285       if (dest)
3286         gst_value_init_and_copy (dest, src1);
3287       return TRUE;
3288     }
3289   }
3290
3291   return FALSE;
3292 }
3293
3294 static gboolean
3295 gst_value_intersect_fraction_range_fraction_range (GValue * dest,
3296     const GValue * src1, const GValue * src2)
3297 {
3298   GValue *min;
3299   GValue *max;
3300   gint res;
3301   GValue *vals1, *vals2;
3302   GstValueCompareFunc compare;
3303
3304   vals1 = src1->data[0].v_pointer;
3305   vals2 = src2->data[0].v_pointer;
3306   g_return_val_if_fail (vals1 != NULL && vals2 != NULL, FALSE);
3307
3308   if ((compare = gst_value_get_compare_func (&vals1[0]))) {
3309     /* min = MAX (src1.start, src2.start) */
3310     res = gst_value_compare_with_func (&vals1[0], &vals2[0], compare);
3311     g_return_val_if_fail (res != GST_VALUE_UNORDERED, FALSE);
3312     if (res == GST_VALUE_LESS_THAN)
3313       min = &vals2[0];          /* Take the max of the 2 */
3314     else
3315       min = &vals1[0];
3316
3317     /* max = MIN (src1.end, src2.end) */
3318     res = gst_value_compare_with_func (&vals1[1], &vals2[1], compare);
3319     g_return_val_if_fail (res != GST_VALUE_UNORDERED, FALSE);
3320     if (res == GST_VALUE_GREATER_THAN)
3321       max = &vals2[1];          /* Take the min of the 2 */
3322     else
3323       max = &vals1[1];
3324
3325     res = gst_value_compare_with_func (min, max, compare);
3326     g_return_val_if_fail (res != GST_VALUE_UNORDERED, FALSE);
3327     if (res == GST_VALUE_LESS_THAN) {
3328       if (dest) {
3329         g_value_init (dest, GST_TYPE_FRACTION_RANGE);
3330         vals1 = dest->data[0].v_pointer;
3331         g_value_copy (min, &vals1[0]);
3332         g_value_copy (max, &vals1[1]);
3333       }
3334       return TRUE;
3335     }
3336     if (res == GST_VALUE_EQUAL) {
3337       if (dest)
3338         gst_value_init_and_copy (dest, min);
3339       return TRUE;
3340     }
3341   }
3342
3343   return FALSE;
3344 }
3345
3346 /***************
3347  * subtraction *
3348  ***************/
3349
3350 static gboolean
3351 gst_value_subtract_int_int_range (GValue * dest, const GValue * minuend,
3352     const GValue * subtrahend)
3353 {
3354   gint min = gst_value_get_int_range_min (subtrahend);
3355   gint max = gst_value_get_int_range_max (subtrahend);
3356   gint step = gst_value_get_int_range_step (subtrahend);
3357   gint val = g_value_get_int (minuend);
3358
3359   /* subtracting a range from an int only works if the int is not in the
3360    * range */
3361   if (val < min || val > max || val % step) {
3362     /* and the result is the int */
3363     if (dest)
3364       gst_value_init_and_copy (dest, minuend);
3365     return TRUE;
3366   }
3367   return FALSE;
3368 }
3369
3370 /* creates a new int range based on input values.
3371  */
3372 static gboolean
3373 gst_value_create_new_range (GValue * dest, gint min1, gint max1, gint min2,
3374     gint max2, gint step)
3375 {
3376   GValue v1 = { 0, };
3377   GValue v2 = { 0, };
3378   GValue *pv1, *pv2;            /* yeah, hungarian! */
3379
3380   g_return_val_if_fail (step > 0, FALSE);
3381   g_return_val_if_fail (min1 % step == 0, FALSE);
3382   g_return_val_if_fail (max1 % step == 0, FALSE);
3383   g_return_val_if_fail (min2 % step == 0, FALSE);
3384   g_return_val_if_fail (max2 % step == 0, FALSE);
3385
3386   if (min1 <= max1 && min2 <= max2) {
3387     pv1 = &v1;
3388     pv2 = &v2;
3389   } else if (min1 <= max1) {
3390     pv1 = dest;
3391     pv2 = NULL;
3392   } else if (min2 <= max2) {
3393     pv1 = NULL;
3394     pv2 = dest;
3395   } else {
3396     return FALSE;
3397   }
3398
3399   if (!dest)
3400     return TRUE;
3401
3402   if (min1 < max1) {
3403     g_value_init (pv1, GST_TYPE_INT_RANGE);
3404     gst_value_set_int_range_step (pv1, min1, max1, step);
3405   } else if (min1 == max1) {
3406     g_value_init (pv1, G_TYPE_INT);
3407     g_value_set_int (pv1, min1);
3408   }
3409   if (min2 < max2) {
3410     g_value_init (pv2, GST_TYPE_INT_RANGE);
3411     gst_value_set_int_range_step (pv2, min2, max2, step);
3412   } else if (min2 == max2) {
3413     g_value_init (pv2, G_TYPE_INT);
3414     g_value_set_int (pv2, min2);
3415   }
3416
3417   if (min1 <= max1 && min2 <= max2) {
3418     gst_value_list_concat (dest, pv1, pv2);
3419     g_value_unset (pv1);
3420     g_value_unset (pv2);
3421   }
3422   return TRUE;
3423 }
3424
3425 static gboolean
3426 gst_value_subtract_int_range_int (GValue * dest, const GValue * minuend,
3427     const GValue * subtrahend)
3428 {
3429   gint min = gst_value_get_int_range_min (minuend);
3430   gint max = gst_value_get_int_range_max (minuend);
3431   gint step = gst_value_get_int_range_step (minuend);
3432   gint val = g_value_get_int (subtrahend);
3433
3434   g_return_val_if_fail (min < max, FALSE);
3435
3436   /* value is outside of the range, return range unchanged */
3437   if (val < min || val > max || val % step) {
3438     if (dest)
3439       gst_value_init_and_copy (dest, minuend);
3440     return TRUE;
3441   } else {
3442     /* max must be MAXINT too as val <= max */
3443     if (val >= G_MAXINT - step + 1) {
3444       max -= step;
3445       val -= step;
3446     }
3447     /* min must be MININT too as val >= max */
3448     if (val <= G_MININT + step - 1) {
3449       min += step;
3450       val += step;
3451     }
3452     if (dest)
3453       gst_value_create_new_range (dest, min, val - step, val + step, max, step);
3454   }
3455   return TRUE;
3456 }
3457
3458 static gboolean
3459 gst_value_subtract_int_range_int_range (GValue * dest, const GValue * minuend,
3460     const GValue * subtrahend)
3461 {
3462   gint min1 = gst_value_get_int_range_min (minuend);
3463   gint max1 = gst_value_get_int_range_max (minuend);
3464   gint step1 = gst_value_get_int_range_step (minuend);
3465   gint min2 = gst_value_get_int_range_min (subtrahend);
3466   gint max2 = gst_value_get_int_range_max (subtrahend);
3467   gint step2 = gst_value_get_int_range_step (subtrahend);
3468   gint step;
3469
3470   if (step1 != step2) {
3471     /* ENOIMPL */
3472     g_assert (FALSE);
3473     return FALSE;
3474   }
3475   step = step1;
3476
3477   if (max2 >= max1 && min2 <= min1) {
3478     return FALSE;
3479   } else if (max2 >= max1) {
3480     return gst_value_create_new_range (dest, min1, MIN (min2 - step, max1),
3481         step, 0, step);
3482   } else if (min2 <= min1) {
3483     return gst_value_create_new_range (dest, MAX (max2 + step, min1), max1,
3484         step, 0, step);
3485   } else {
3486     return gst_value_create_new_range (dest, min1, MIN (min2 - step, max1),
3487         MAX (max2 + step, min1), max1, step);
3488   }
3489 }
3490
3491 static gboolean
3492 gst_value_subtract_int64_int64_range (GValue * dest, const GValue * minuend,
3493     const GValue * subtrahend)
3494 {
3495   gint64 min = gst_value_get_int64_range_min (subtrahend);
3496   gint64 max = gst_value_get_int64_range_max (subtrahend);
3497   gint64 step = gst_value_get_int64_range_step (subtrahend);
3498   gint64 val = g_value_get_int64 (minuend);
3499
3500   /* subtracting a range from an int64 only works if the int64 is not in the
3501    * range */
3502   if (val < min || val > max || val % step) {
3503     /* and the result is the int64 */
3504     if (dest)
3505       gst_value_init_and_copy (dest, minuend);
3506     return TRUE;
3507   }
3508   return FALSE;
3509 }
3510
3511 /* creates a new int64 range based on input values.
3512  */
3513 static gboolean
3514 gst_value_create_new_int64_range (GValue * dest, gint64 min1, gint64 max1,
3515     gint64 min2, gint64 max2, gint64 step)
3516 {
3517   GValue v1 = { 0, };
3518   GValue v2 = { 0, };
3519   GValue *pv1, *pv2;            /* yeah, hungarian! */
3520
3521   g_return_val_if_fail (step > 0, FALSE);
3522   g_return_val_if_fail (min1 % step == 0, FALSE);
3523   g_return_val_if_fail (max1 % step == 0, FALSE);
3524   g_return_val_if_fail (min2 % step == 0, FALSE);
3525   g_return_val_if_fail (max2 % step == 0, FALSE);
3526
3527   if (min1 <= max1 && min2 <= max2) {
3528     pv1 = &v1;
3529     pv2 = &v2;
3530   } else if (min1 <= max1) {
3531     pv1 = dest;
3532     pv2 = NULL;
3533   } else if (min2 <= max2) {
3534     pv1 = NULL;
3535     pv2 = dest;
3536   } else {
3537     return FALSE;
3538   }
3539
3540   if (!dest)
3541     return TRUE;
3542
3543   if (min1 < max1) {
3544     g_value_init (pv1, GST_TYPE_INT64_RANGE);
3545     gst_value_set_int64_range_step (pv1, min1, max1, step);
3546   } else if (min1 == max1) {
3547     g_value_init (pv1, G_TYPE_INT64);
3548     g_value_set_int64 (pv1, min1);
3549   }
3550   if (min2 < max2) {
3551     g_value_init (pv2, GST_TYPE_INT64_RANGE);
3552     gst_value_set_int64_range_step (pv2, min2, max2, step);
3553   } else if (min2 == max2) {
3554     g_value_init (pv2, G_TYPE_INT64);
3555     g_value_set_int64 (pv2, min2);
3556   }
3557
3558   if (min1 <= max1 && min2 <= max2) {
3559     gst_value_list_concat (dest, pv1, pv2);
3560     g_value_unset (pv1);
3561     g_value_unset (pv2);
3562   }
3563   return TRUE;
3564 }
3565
3566 static gboolean
3567 gst_value_subtract_int64_range_int64 (GValue * dest, const GValue * minuend,
3568     const GValue * subtrahend)
3569 {
3570   gint64 min = gst_value_get_int64_range_min (minuend);
3571   gint64 max = gst_value_get_int64_range_max (minuend);
3572   gint64 step = gst_value_get_int64_range_step (minuend);
3573   gint64 val = g_value_get_int64 (subtrahend);
3574
3575   g_return_val_if_fail (min < max, FALSE);
3576
3577   /* value is outside of the range, return range unchanged */
3578   if (val < min || val > max || val % step) {
3579     if (dest)
3580       gst_value_init_and_copy (dest, minuend);
3581     return TRUE;
3582   } else {
3583     /* max must be MAXINT64 too as val <= max */
3584     if (val >= G_MAXINT64 - step + 1) {
3585       max -= step;
3586       val -= step;
3587     }
3588     /* min must be MININT64 too as val >= max */
3589     if (val <= G_MININT64 + step - 1) {
3590       min += step;
3591       val += step;
3592     }
3593     if (dest)
3594       gst_value_create_new_int64_range (dest, min, val - step, val + step, max,
3595           step);
3596   }
3597   return TRUE;
3598 }
3599
3600 static gboolean
3601 gst_value_subtract_int64_range_int64_range (GValue * dest,
3602     const GValue * minuend, const GValue * subtrahend)
3603 {
3604   gint64 min1 = gst_value_get_int64_range_min (minuend);
3605   gint64 max1 = gst_value_get_int64_range_max (minuend);
3606   gint64 step1 = gst_value_get_int64_range_step (minuend);
3607   gint64 min2 = gst_value_get_int64_range_min (subtrahend);
3608   gint64 max2 = gst_value_get_int64_range_max (subtrahend);
3609   gint64 step2 = gst_value_get_int64_range_step (subtrahend);
3610   gint64 step;
3611
3612   if (step1 != step2) {
3613     /* ENOIMPL */
3614     g_assert (FALSE);
3615     return FALSE;
3616   }
3617   step = step1;
3618
3619   if (max2 >= max1 && min2 <= min1) {
3620     return FALSE;
3621   } else if (max2 >= max1) {
3622     return gst_value_create_new_int64_range (dest, min1, MIN (min2 - step,
3623             max1), step, 0, step);
3624   } else if (min2 <= min1) {
3625     return gst_value_create_new_int64_range (dest, MAX (max2 + step, min1),
3626         max1, step, 0, step);
3627   } else {
3628     return gst_value_create_new_int64_range (dest, min1, MIN (min2 - step,
3629             max1), MAX (max2 + step, min1), max1, step);
3630   }
3631 }
3632
3633 static gboolean
3634 gst_value_subtract_double_double_range (GValue * dest, const GValue * minuend,
3635     const GValue * subtrahend)
3636 {
3637   gdouble min = gst_value_get_double_range_min (subtrahend);
3638   gdouble max = gst_value_get_double_range_max (subtrahend);
3639   gdouble val = g_value_get_double (minuend);
3640
3641   if (val < min || val > max) {
3642     if (dest)
3643       gst_value_init_and_copy (dest, minuend);
3644     return TRUE;
3645   }
3646   return FALSE;
3647 }
3648
3649 static gboolean
3650 gst_value_subtract_double_range_double (GValue * dest, const GValue * minuend,
3651     const GValue * subtrahend)
3652 {
3653   /* since we don't have open ranges, we cannot create a hole in
3654    * a double range. We return the original range */
3655   if (dest)
3656     gst_value_init_and_copy (dest, minuend);
3657   return TRUE;
3658 }
3659
3660 static gboolean
3661 gst_value_subtract_double_range_double_range (GValue * dest,
3662     const GValue * minuend, const GValue * subtrahend)
3663 {
3664   /* since we don't have open ranges, we have to approximate */
3665   /* done like with ints */
3666   gdouble min1 = gst_value_get_double_range_min (minuend);
3667   gdouble max2 = gst_value_get_double_range_max (minuend);
3668   gdouble max1 = MIN (gst_value_get_double_range_min (subtrahend), max2);
3669   gdouble min2 = MAX (gst_value_get_double_range_max (subtrahend), min1);
3670   GValue v1 = { 0, };
3671   GValue v2 = { 0, };
3672   GValue *pv1, *pv2;            /* yeah, hungarian! */
3673
3674   if (min1 < max1 && min2 < max2) {
3675     pv1 = &v1;
3676     pv2 = &v2;
3677   } else if (min1 < max1) {
3678     pv1 = dest;
3679     pv2 = NULL;
3680   } else if (min2 < max2) {
3681     pv1 = NULL;
3682     pv2 = dest;
3683   } else {
3684     return FALSE;
3685   }
3686
3687   if (!dest)
3688     return TRUE;
3689
3690   if (min1 < max1) {
3691     g_value_init (pv1, GST_TYPE_DOUBLE_RANGE);
3692     gst_value_set_double_range (pv1, min1, max1);
3693   }
3694   if (min2 < max2) {
3695     g_value_init (pv2, GST_TYPE_DOUBLE_RANGE);
3696     gst_value_set_double_range (pv2, min2, max2);
3697   }
3698
3699   if (min1 < max1 && min2 < max2) {
3700     gst_value_list_concat (dest, pv1, pv2);
3701     g_value_unset (pv1);
3702     g_value_unset (pv2);
3703   }
3704   return TRUE;
3705 }
3706
3707 static gboolean
3708 gst_value_subtract_from_list (GValue * dest, const GValue * minuend,
3709     const GValue * subtrahend)
3710 {
3711   guint i, size;
3712   GValue subtraction = { 0, };
3713   gboolean ret = FALSE;
3714   GType ltype;
3715
3716   ltype = gst_value_list_get_type ();
3717
3718   size = VALUE_LIST_SIZE (minuend);
3719   for (i = 0; i < size; i++) {
3720     const GValue *cur = VALUE_LIST_GET_VALUE (minuend, i);
3721
3722     /* quicker version when we can discard the result */
3723     if (!dest) {
3724       if (gst_value_subtract (NULL, cur, subtrahend)) {
3725         ret = TRUE;
3726         break;
3727       }
3728       continue;
3729     }
3730
3731     if (gst_value_subtract (&subtraction, cur, subtrahend)) {
3732       if (!ret) {
3733         gst_value_init_and_copy (dest, &subtraction);
3734         ret = TRUE;
3735       } else if (G_VALUE_HOLDS (dest, ltype)
3736           && !G_VALUE_HOLDS (&subtraction, ltype)) {
3737         gst_value_list_append_value (dest, &subtraction);
3738       } else {
3739         GValue temp = { 0, };
3740
3741         gst_value_init_and_copy (&temp, dest);
3742         g_value_unset (dest);
3743         gst_value_list_concat (dest, &temp, &subtraction);
3744         g_value_unset (&temp);
3745       }
3746       g_value_unset (&subtraction);
3747     }
3748   }
3749   return ret;
3750 }
3751
3752 static gboolean
3753 gst_value_subtract_list (GValue * dest, const GValue * minuend,
3754     const GValue * subtrahend)
3755 {
3756   guint i, size;
3757   GValue data[2] = { {0,}, {0,} };
3758   GValue *subtraction = &data[0], *result = &data[1];
3759
3760   gst_value_init_and_copy (result, minuend);
3761   size = VALUE_LIST_SIZE (subtrahend);
3762   for (i = 0; i < size; i++) {
3763     const GValue *cur = VALUE_LIST_GET_VALUE (subtrahend, i);
3764
3765     if (gst_value_subtract (subtraction, result, cur)) {
3766       GValue *temp = result;
3767
3768       result = subtraction;
3769       subtraction = temp;
3770       g_value_unset (subtraction);
3771     } else {
3772       g_value_unset (result);
3773       return FALSE;
3774     }
3775   }
3776   if (dest)
3777     gst_value_init_and_copy (dest, result);
3778   g_value_unset (result);
3779   return TRUE;
3780 }
3781
3782 static gboolean
3783 gst_value_subtract_fraction_fraction_range (GValue * dest,
3784     const GValue * minuend, const GValue * subtrahend)
3785 {
3786   const GValue *min = gst_value_get_fraction_range_min (subtrahend);
3787   const GValue *max = gst_value_get_fraction_range_max (subtrahend);
3788   GstValueCompareFunc compare;
3789
3790   if ((compare = gst_value_get_compare_func (minuend))) {
3791     /* subtracting a range from an fraction only works if the fraction
3792      * is not in the range */
3793     if (gst_value_compare_with_func (minuend, min, compare) ==
3794         GST_VALUE_LESS_THAN ||
3795         gst_value_compare_with_func (minuend, max, compare) ==
3796         GST_VALUE_GREATER_THAN) {
3797       /* and the result is the value */
3798       if (dest)
3799         gst_value_init_and_copy (dest, minuend);
3800       return TRUE;
3801     }
3802   }
3803   return FALSE;
3804 }
3805
3806 static gboolean
3807 gst_value_subtract_fraction_range_fraction (GValue * dest,
3808     const GValue * minuend, const GValue * subtrahend)
3809 {
3810   /* since we don't have open ranges, we cannot create a hole in
3811    * a range. We return the original range */
3812   if (dest)
3813     gst_value_init_and_copy (dest, minuend);
3814   return TRUE;
3815 }
3816
3817 static gboolean
3818 gst_value_subtract_fraction_range_fraction_range (GValue * dest,
3819     const GValue * minuend, const GValue * subtrahend)
3820 {
3821   /* since we don't have open ranges, we have to approximate */
3822   /* done like with ints and doubles. Creates a list of 2 fraction ranges */
3823   const GValue *min1 = gst_value_get_fraction_range_min (minuend);
3824   const GValue *max2 = gst_value_get_fraction_range_max (minuend);
3825   const GValue *max1 = gst_value_get_fraction_range_min (subtrahend);
3826   const GValue *min2 = gst_value_get_fraction_range_max (subtrahend);
3827   gint cmp1, cmp2;
3828   GValue v1 = { 0, };
3829   GValue v2 = { 0, };
3830   GValue *pv1, *pv2;            /* yeah, hungarian! */
3831   GstValueCompareFunc compare;
3832
3833   g_return_val_if_fail (min1 != NULL && max1 != NULL, FALSE);
3834   g_return_val_if_fail (min2 != NULL && max2 != NULL, FALSE);
3835
3836   compare = gst_value_get_compare_func (min1);
3837   g_return_val_if_fail (compare, FALSE);
3838
3839   cmp1 = gst_value_compare_with_func (max2, max1, compare);
3840   g_return_val_if_fail (cmp1 != GST_VALUE_UNORDERED, FALSE);
3841   if (cmp1 == GST_VALUE_LESS_THAN)
3842     max1 = max2;
3843   cmp1 = gst_value_compare_with_func (min1, min2, compare);
3844   g_return_val_if_fail (cmp1 != GST_VALUE_UNORDERED, FALSE);
3845   if (cmp1 == GST_VALUE_GREATER_THAN)
3846     min2 = min1;
3847
3848   cmp1 = gst_value_compare_with_func (min1, max1, compare);
3849   cmp2 = gst_value_compare_with_func (min2, max2, compare);
3850
3851   if (cmp1 == GST_VALUE_LESS_THAN && cmp2 == GST_VALUE_LESS_THAN) {
3852     pv1 = &v1;
3853     pv2 = &v2;
3854   } else if (cmp1 == GST_VALUE_LESS_THAN) {
3855     pv1 = dest;
3856     pv2 = NULL;
3857   } else if (cmp2 == GST_VALUE_LESS_THAN) {
3858     pv1 = NULL;
3859     pv2 = dest;
3860   } else {
3861     return FALSE;
3862   }
3863
3864   if (!dest)
3865     return TRUE;
3866
3867   if (cmp1 == GST_VALUE_LESS_THAN) {
3868     g_value_init (pv1, GST_TYPE_FRACTION_RANGE);
3869     gst_value_set_fraction_range (pv1, min1, max1);
3870   }
3871   if (cmp2 == GST_VALUE_LESS_THAN) {
3872     g_value_init (pv2, GST_TYPE_FRACTION_RANGE);
3873     gst_value_set_fraction_range (pv2, min2, max2);
3874   }
3875
3876   if (cmp1 == GST_VALUE_LESS_THAN && cmp2 == GST_VALUE_LESS_THAN) {
3877     gst_value_list_concat (dest, pv1, pv2);
3878     g_value_unset (pv1);
3879     g_value_unset (pv2);
3880   }
3881   return TRUE;
3882 }
3883
3884
3885 /**************
3886  * comparison *
3887  **************/
3888
3889 /*
3890  * gst_value_get_compare_func:
3891  * @value1: a value to get the compare function for
3892  *
3893  * Determines the compare function to be used with values of the same type as
3894  * @value1. The function can be given to gst_value_compare_with_func().
3895  *
3896  * Returns: A #GstValueCompareFunc value
3897  */
3898 static GstValueCompareFunc
3899 gst_value_get_compare_func (const GValue * value1)
3900 {
3901   GstValueTable *table, *best = NULL;
3902   guint i;
3903   GType type1;
3904
3905   type1 = G_VALUE_TYPE (value1);
3906
3907   /* this is a fast check */
3908   best = gst_value_hash_lookup_type (type1);
3909
3910   /* slower checks */
3911   if (G_UNLIKELY (!best || !best->compare)) {
3912     guint len = gst_value_table->len;
3913
3914     best = NULL;
3915     for (i = 0; i < len; i++) {
3916       table = &g_array_index (gst_value_table, GstValueTable, i);
3917       if (table->compare && g_type_is_a (type1, table->type)) {
3918         if (!best || g_type_is_a (table->type, best->type))
3919           best = table;
3920       }
3921     }
3922   }
3923   if (G_LIKELY (best))
3924     return best->compare;
3925
3926   return NULL;
3927 }
3928
3929 /**
3930  * gst_value_can_compare:
3931  * @value1: a value to compare
3932  * @value2: another value to compare
3933  *
3934  * Determines if @value1 and @value2 can be compared.
3935  *
3936  * Returns: TRUE if the values can be compared
3937  */
3938 gboolean
3939 gst_value_can_compare (const GValue * value1, const GValue * value2)
3940 {
3941   g_return_val_if_fail (G_IS_VALUE (value1), FALSE);
3942   g_return_val_if_fail (G_IS_VALUE (value2), FALSE);
3943
3944   if (G_VALUE_TYPE (value1) != G_VALUE_TYPE (value2))
3945     return FALSE;
3946
3947   return gst_value_get_compare_func (value1) != NULL;
3948 }
3949
3950 static gboolean
3951 gst_value_list_equals_range (const GValue * list, const GValue * value)
3952 {
3953   const GValue *first;
3954   guint list_size, n;
3955
3956   g_return_val_if_fail (G_IS_VALUE (list), FALSE);
3957   g_return_val_if_fail (G_IS_VALUE (value), FALSE);
3958   g_return_val_if_fail (GST_VALUE_HOLDS_LIST (list), FALSE);
3959
3960   /* TODO: compare against an empty list ? No type though... */
3961   list_size = VALUE_LIST_SIZE (list);
3962   if (list_size == 0)
3963     return FALSE;
3964
3965   /* compare the basic types - they have to match */
3966   first = VALUE_LIST_GET_VALUE (list, 0);
3967 #define CHECK_TYPES(type,prefix) \
3968   (prefix##_VALUE_HOLDS_##type(first) && GST_VALUE_HOLDS_##type##_RANGE (value))
3969   if (CHECK_TYPES (INT, G)) {
3970     const gint rmin = gst_value_get_int_range_min (value);
3971     const gint rmax = gst_value_get_int_range_max (value);
3972     const gint rstep = gst_value_get_int_range_step (value);
3973     /* note: this will overflow for min 0 and max INT_MAX, but this
3974        would only be equal to a list of INT_MAX elements, which seems
3975        very unlikely */
3976     if (list_size != rmax / rstep - rmin / rstep + 1)
3977       return FALSE;
3978     for (n = 0; n < list_size; ++n) {
3979       gint v = g_value_get_int (VALUE_LIST_GET_VALUE (list, n));
3980       if (v < rmin || v > rmax || v % rstep) {
3981         return FALSE;
3982       }
3983     }
3984     return TRUE;
3985   } else if (CHECK_TYPES (INT64, G)) {
3986     const gint64 rmin = gst_value_get_int64_range_min (value);
3987     const gint64 rmax = gst_value_get_int64_range_max (value);
3988     const gint64 rstep = gst_value_get_int64_range_step (value);
3989     GST_DEBUG ("List/range of int64s");
3990     if (list_size != rmax / rstep - rmin / rstep + 1)
3991       return FALSE;
3992     for (n = 0; n < list_size; ++n) {
3993       gint64 v = g_value_get_int64 (VALUE_LIST_GET_VALUE (list, n));
3994       if (v < rmin || v > rmax || v % rstep)
3995         return FALSE;
3996     }
3997     return TRUE;
3998   }
3999 #undef CHECK_TYPES
4000
4001   /* other combinations don't make sense for equality */
4002   return FALSE;
4003 }
4004
4005 /**
4006  * gst_value_compare:
4007  * @value1: a value to compare
4008  * @value2: another value to compare
4009  *
4010  * Compares @value1 and @value2.  If @value1 and @value2 cannot be
4011  * compared, the function returns GST_VALUE_UNORDERED.  Otherwise,
4012  * if @value1 is greater than @value2, GST_VALUE_GREATER_THAN is returned.
4013  * If @value1 is less than @value2, GST_VALUE_LESS_THAN is returned.
4014  * If the values are equal, GST_VALUE_EQUAL is returned.
4015  *
4016  * Returns: comparison result
4017  */
4018 gint
4019 gst_value_compare (const GValue * value1, const GValue * value2)
4020 {
4021   GstValueCompareFunc compare;
4022   GType ltype;
4023
4024   g_return_val_if_fail (G_IS_VALUE (value1), GST_VALUE_LESS_THAN);
4025   g_return_val_if_fail (G_IS_VALUE (value2), GST_VALUE_GREATER_THAN);
4026
4027   /* Special cases: lists and scalar values ("{ 1 }" and "1" are equal),
4028      as well as lists and ranges ("{ 1, 2 }" and "[ 1, 2 ]" are equal) */
4029   ltype = gst_value_list_get_type ();
4030   if (G_VALUE_HOLDS (value1, ltype) && !G_VALUE_HOLDS (value2, ltype)) {
4031
4032     if (gst_value_list_equals_range (value1, value2)) {
4033       return GST_VALUE_EQUAL;
4034     } else if (gst_value_list_get_size (value1) == 1) {
4035       const GValue *elt;
4036
4037       elt = gst_value_list_get_value (value1, 0);
4038       return gst_value_compare (elt, value2);
4039     }
4040   } else if (G_VALUE_HOLDS (value2, ltype) && !G_VALUE_HOLDS (value1, ltype)) {
4041     if (gst_value_list_equals_range (value2, value1)) {
4042       return GST_VALUE_EQUAL;
4043     } else if (gst_value_list_get_size (value2) == 1) {
4044       const GValue *elt;
4045
4046       elt = gst_value_list_get_value (value2, 0);
4047       return gst_value_compare (elt, value1);
4048     }
4049   }
4050
4051   if (G_VALUE_TYPE (value1) != G_VALUE_TYPE (value2))
4052     return GST_VALUE_UNORDERED;
4053
4054   compare = gst_value_get_compare_func (value1);
4055   if (compare) {
4056     return compare (value1, value2);
4057   }
4058
4059   g_critical ("unable to compare values of type %s\n",
4060       g_type_name (G_VALUE_TYPE (value1)));
4061   return GST_VALUE_UNORDERED;
4062 }
4063
4064 /*
4065  * gst_value_compare_with_func:
4066  * @value1: a value to compare
4067  * @value2: another value to compare
4068  * @compare: compare function
4069  *
4070  * Compares @value1 and @value2 using the @compare function. Works like
4071  * gst_value_compare() but allows to save time determining the compare function
4072  * a multiple times.
4073  *
4074  * Returns: comparison result
4075  */
4076 static gint
4077 gst_value_compare_with_func (const GValue * value1, const GValue * value2,
4078     GstValueCompareFunc compare)
4079 {
4080   g_assert (compare);
4081
4082   if (G_VALUE_TYPE (value1) != G_VALUE_TYPE (value2))
4083     return GST_VALUE_UNORDERED;
4084
4085   return compare (value1, value2);
4086 }
4087
4088 /* union */
4089
4090 /**
4091  * gst_value_can_union:
4092  * @value1: a value to union
4093  * @value2: another value to union
4094  *
4095  * Determines if @value1 and @value2 can be non-trivially unioned.
4096  * Any two values can be trivially unioned by adding both of them
4097  * to a GstValueList.  However, certain types have the possibility
4098  * to be unioned in a simpler way.  For example, an integer range
4099  * and an integer can be unioned if the integer is a subset of the
4100  * integer range.  If there is the possibility that two values can
4101  * be unioned, this function returns TRUE.
4102  *
4103  * Returns: TRUE if there is a function allowing the two values to
4104  * be unioned.
4105  */
4106 gboolean
4107 gst_value_can_union (const GValue * value1, const GValue * value2)
4108 {
4109   GstValueUnionInfo *union_info;
4110   guint i, len;
4111
4112   g_return_val_if_fail (G_IS_VALUE (value1), FALSE);
4113   g_return_val_if_fail (G_IS_VALUE (value2), FALSE);
4114
4115   len = gst_value_union_funcs->len;
4116
4117   for (i = 0; i < len; i++) {
4118     union_info = &g_array_index (gst_value_union_funcs, GstValueUnionInfo, i);
4119     if (union_info->type1 == G_VALUE_TYPE (value1) &&
4120         union_info->type2 == G_VALUE_TYPE (value2))
4121       return TRUE;
4122     if (union_info->type1 == G_VALUE_TYPE (value2) &&
4123         union_info->type2 == G_VALUE_TYPE (value1))
4124       return TRUE;
4125   }
4126
4127   return FALSE;
4128 }
4129
4130 /**
4131  * gst_value_union:
4132  * @dest: (out caller-allocates): the destination value
4133  * @value1: a value to union
4134  * @value2: another value to union
4135  *
4136  * Creates a GValue corresponding to the union of @value1 and @value2.
4137  *
4138  * Returns: TRUE if the union suceeded.
4139  */
4140 gboolean
4141 gst_value_union (GValue * dest, const GValue * value1, const GValue * value2)
4142 {
4143   const GstValueUnionInfo *union_info;
4144   guint i, len;
4145   GType type1, type2;
4146
4147   g_return_val_if_fail (dest != NULL, FALSE);
4148   g_return_val_if_fail (G_IS_VALUE (value1), FALSE);
4149   g_return_val_if_fail (G_IS_VALUE (value2), FALSE);
4150   g_return_val_if_fail (gst_value_list_or_array_are_compatible (value1, value2),
4151       FALSE);
4152
4153   len = gst_value_union_funcs->len;
4154   type1 = G_VALUE_TYPE (value1);
4155   type2 = G_VALUE_TYPE (value2);
4156
4157   for (i = 0; i < len; i++) {
4158     union_info = &g_array_index (gst_value_union_funcs, GstValueUnionInfo, i);
4159     if (union_info->type1 == type1 && union_info->type2 == type2) {
4160       return union_info->func (dest, value1, value2);
4161     }
4162     if (union_info->type1 == type2 && union_info->type2 == type1) {
4163       return union_info->func (dest, value2, value1);
4164     }
4165   }
4166
4167   gst_value_list_concat (dest, value1, value2);
4168   return TRUE;
4169 }
4170
4171 /* gst_value_register_union_func: (skip)
4172  * @type1: a type to union
4173  * @type2: another type to union
4174  * @func: a function that implements creating a union between the two types
4175  *
4176  * Registers a union function that can create a union between #GValue items
4177  * of the type @type1 and @type2.
4178  *
4179  * Union functions should be registered at startup before any pipelines are
4180  * started, as gst_value_register_union_func() is not thread-safe and cannot
4181  * be used at the same time as gst_value_union() or gst_value_can_union().
4182  */
4183 static void
4184 gst_value_register_union_func (GType type1, GType type2, GstValueUnionFunc func)
4185 {
4186   GstValueUnionInfo union_info;
4187
4188   union_info.type1 = type1;
4189   union_info.type2 = type2;
4190   union_info.func = func;
4191
4192   g_array_append_val (gst_value_union_funcs, union_info);
4193 }
4194
4195 /* intersection */
4196
4197 /**
4198  * gst_value_can_intersect:
4199  * @value1: a value to intersect
4200  * @value2: another value to intersect
4201  *
4202  * Determines if intersecting two values will produce a valid result.
4203  * Two values will produce a valid intersection if they have the same
4204  * type, or if there is a method (registered by
4205  * gst_value_register_intersect_func()) to calculate the intersection.
4206  *
4207  * Returns: TRUE if the values can intersect
4208  */
4209 gboolean
4210 gst_value_can_intersect (const GValue * value1, const GValue * value2)
4211 {
4212   GstValueIntersectInfo *intersect_info;
4213   guint i, len;
4214   GType ltype, type1, type2;
4215
4216   g_return_val_if_fail (G_IS_VALUE (value1), FALSE);
4217   g_return_val_if_fail (G_IS_VALUE (value2), FALSE);
4218
4219   ltype = gst_value_list_get_type ();
4220
4221   /* special cases */
4222   if (G_VALUE_HOLDS (value1, ltype) || G_VALUE_HOLDS (value2, ltype))
4223     return TRUE;
4224
4225   type1 = G_VALUE_TYPE (value1);
4226   type2 = G_VALUE_TYPE (value2);
4227
4228   /* practically all GstValue types have a compare function (_can_compare=TRUE)
4229    * GstStructure and GstCaps have npot, but are intersectable */
4230   if (type1 == type2)
4231     return TRUE;
4232
4233   /* check registered intersect functions */
4234   len = gst_value_intersect_funcs->len;
4235   for (i = 0; i < len; i++) {
4236     intersect_info = &g_array_index (gst_value_intersect_funcs,
4237         GstValueIntersectInfo, i);
4238     if ((intersect_info->type1 == type1 && intersect_info->type2 == type2) ||
4239         (intersect_info->type1 == type2 && intersect_info->type2 == type1))
4240       return TRUE;
4241   }
4242
4243   return gst_value_can_compare (value1, value2);
4244 }
4245
4246 /**
4247  * gst_value_intersect:
4248  * @dest: (out caller-allocates) (transfer full): a uninitialized #GValue that will hold the calculated
4249  * intersection value. May be NULL if the resulting set if not needed.
4250  * @value1: a value to intersect
4251  * @value2: another value to intersect
4252  *
4253  * Calculates the intersection of two values.  If the values have
4254  * a non-empty intersection, the value representing the intersection
4255  * is placed in @dest, unless NULL.  If the intersection is non-empty,
4256  * @dest is not modified.
4257  *
4258  * Returns: TRUE if the intersection is non-empty
4259  */
4260 gboolean
4261 gst_value_intersect (GValue * dest, const GValue * value1,
4262     const GValue * value2)
4263 {
4264   GstValueIntersectInfo *intersect_info;
4265   guint i, len;
4266   GType ltype, type1, type2;
4267
4268   g_return_val_if_fail (G_IS_VALUE (value1), FALSE);
4269   g_return_val_if_fail (G_IS_VALUE (value2), FALSE);
4270
4271   ltype = gst_value_list_get_type ();
4272
4273   /* special cases first */
4274   if (G_VALUE_HOLDS (value1, ltype))
4275     return gst_value_intersect_list (dest, value1, value2);
4276   if (G_VALUE_HOLDS (value2, ltype))
4277     return gst_value_intersect_list (dest, value2, value1);
4278
4279   if (gst_value_compare (value1, value2) == GST_VALUE_EQUAL) {
4280     if (dest)
4281       gst_value_init_and_copy (dest, value1);
4282     return TRUE;
4283   }
4284
4285   type1 = G_VALUE_TYPE (value1);
4286   type2 = G_VALUE_TYPE (value2);
4287
4288   len = gst_value_intersect_funcs->len;
4289   for (i = 0; i < len; i++) {
4290     intersect_info = &g_array_index (gst_value_intersect_funcs,
4291         GstValueIntersectInfo, i);
4292     if (intersect_info->type1 == type1 && intersect_info->type2 == type2) {
4293       return intersect_info->func (dest, value1, value2);
4294     }
4295     if (intersect_info->type1 == type2 && intersect_info->type2 == type1) {
4296       return intersect_info->func (dest, value2, value1);
4297     }
4298   }
4299   return FALSE;
4300 }
4301
4302
4303
4304 /* gst_value_register_intersect_func: (skip)
4305  * @type1: the first type to intersect
4306  * @type2: the second type to intersect
4307  * @func: the intersection function
4308  *
4309  * Registers a function that is called to calculate the intersection
4310  * of the values having the types @type1 and @type2.
4311  *
4312  * Intersect functions should be registered at startup before any pipelines are
4313  * started, as gst_value_register_intersect_func() is not thread-safe and
4314  * cannot be used at the same time as gst_value_intersect() or
4315  * gst_value_can_intersect().
4316  */
4317 static void
4318 gst_value_register_intersect_func (GType type1, GType type2,
4319     GstValueIntersectFunc func)
4320 {
4321   GstValueIntersectInfo intersect_info;
4322
4323   intersect_info.type1 = type1;
4324   intersect_info.type2 = type2;
4325   intersect_info.func = func;
4326
4327   g_array_append_val (gst_value_intersect_funcs, intersect_info);
4328 }
4329
4330
4331 /* subtraction */
4332
4333 /**
4334  * gst_value_subtract:
4335  * @dest: (out caller-allocates): the destination value for the result if the
4336  *     subtraction is not empty. May be NULL, in which case the resulting set
4337  *     will not be computed, which can give a fair speedup.
4338  * @minuend: the value to subtract from
4339  * @subtrahend: the value to subtract
4340  *
4341  * Subtracts @subtrahend from @minuend and stores the result in @dest.
4342  * Note that this means subtraction as in sets, not as in mathematics.
4343  *
4344  * Returns: %TRUE if the subtraction is not empty
4345  */
4346 gboolean
4347 gst_value_subtract (GValue * dest, const GValue * minuend,
4348     const GValue * subtrahend)
4349 {
4350   GstValueSubtractInfo *info;
4351   guint i, len;
4352   GType ltype, mtype, stype;
4353
4354   g_return_val_if_fail (G_IS_VALUE (minuend), FALSE);
4355   g_return_val_if_fail (G_IS_VALUE (subtrahend), FALSE);
4356
4357   ltype = gst_value_list_get_type ();
4358
4359   /* special cases first */
4360   if (G_VALUE_HOLDS (minuend, ltype))
4361     return gst_value_subtract_from_list (dest, minuend, subtrahend);
4362   if (G_VALUE_HOLDS (subtrahend, ltype))
4363     return gst_value_subtract_list (dest, minuend, subtrahend);
4364
4365   mtype = G_VALUE_TYPE (minuend);
4366   stype = G_VALUE_TYPE (subtrahend);
4367
4368   len = gst_value_subtract_funcs->len;
4369   for (i = 0; i < len; i++) {
4370     info = &g_array_index (gst_value_subtract_funcs, GstValueSubtractInfo, i);
4371     if (info->minuend == mtype && info->subtrahend == stype) {
4372       return info->func (dest, minuend, subtrahend);
4373     }
4374   }
4375
4376   if (gst_value_compare (minuend, subtrahend) != GST_VALUE_EQUAL) {
4377     if (dest)
4378       gst_value_init_and_copy (dest, minuend);
4379     return TRUE;
4380   }
4381
4382   return FALSE;
4383 }
4384
4385 #if 0
4386 gboolean
4387 gst_value_subtract (GValue * dest, const GValue * minuend,
4388     const GValue * subtrahend)
4389 {
4390   gboolean ret = gst_value_subtract2 (dest, minuend, subtrahend);
4391
4392   g_printerr ("\"%s\"  -  \"%s\"  =  \"%s\"\n", gst_value_serialize (minuend),
4393       gst_value_serialize (subtrahend),
4394       ret ? gst_value_serialize (dest) : "---");
4395   return ret;
4396 }
4397 #endif
4398
4399 /**
4400  * gst_value_can_subtract:
4401  * @minuend: the value to subtract from
4402  * @subtrahend: the value to subtract
4403  *
4404  * Checks if it's possible to subtract @subtrahend from @minuend.
4405  *
4406  * Returns: TRUE if a subtraction is possible
4407  */
4408 gboolean
4409 gst_value_can_subtract (const GValue * minuend, const GValue * subtrahend)
4410 {
4411   GstValueSubtractInfo *info;
4412   guint i, len;
4413   GType ltype, mtype, stype;
4414
4415   g_return_val_if_fail (G_IS_VALUE (minuend), FALSE);
4416   g_return_val_if_fail (G_IS_VALUE (subtrahend), FALSE);
4417
4418   ltype = gst_value_list_get_type ();
4419
4420   /* special cases */
4421   if (G_VALUE_HOLDS (minuend, ltype) || G_VALUE_HOLDS (subtrahend, ltype))
4422     return TRUE;
4423
4424   mtype = G_VALUE_TYPE (minuend);
4425   stype = G_VALUE_TYPE (subtrahend);
4426
4427   len = gst_value_subtract_funcs->len;
4428   for (i = 0; i < len; i++) {
4429     info = &g_array_index (gst_value_subtract_funcs, GstValueSubtractInfo, i);
4430     if (info->minuend == mtype && info->subtrahend == stype)
4431       return TRUE;
4432   }
4433
4434   return gst_value_can_compare (minuend, subtrahend);
4435 }
4436
4437 /* gst_value_register_subtract_func: (skip)
4438  * @minuend_type: type of the minuend
4439  * @subtrahend_type: type of the subtrahend
4440  * @func: function to use
4441  *
4442  * Registers @func as a function capable of subtracting the values of
4443  * @subtrahend_type from values of @minuend_type.
4444  *
4445  * Subtract functions should be registered at startup before any pipelines are
4446  * started, as gst_value_register_subtract_func() is not thread-safe and
4447  * cannot be used at the same time as gst_value_subtract().
4448  */
4449 static void
4450 gst_value_register_subtract_func (GType minuend_type, GType subtrahend_type,
4451     GstValueSubtractFunc func)
4452 {
4453   GstValueSubtractInfo info;
4454
4455   /* one type must be unfixed, other subtractions can be done as comparisons,
4456    * special case: bitmasks */
4457   if (minuend_type != GST_TYPE_BITMASK)
4458     g_return_if_fail (!gst_type_is_fixed (minuend_type)
4459         || !gst_type_is_fixed (subtrahend_type));
4460
4461   info.minuend = minuend_type;
4462   info.subtrahend = subtrahend_type;
4463   info.func = func;
4464
4465   g_array_append_val (gst_value_subtract_funcs, info);
4466 }
4467
4468 /**
4469  * gst_value_register:
4470  * @table: structure containing functions to register
4471  *
4472  * Registers functions to perform calculations on #GValue items of a given
4473  * type. Each type can only be added once.
4474  */
4475 void
4476 gst_value_register (const GstValueTable * table)
4477 {
4478   GstValueTable *found;
4479
4480   g_return_if_fail (table != NULL);
4481
4482   g_array_append_val (gst_value_table, *table);
4483
4484   found = gst_value_hash_lookup_type (table->type);
4485   if (found)
4486     g_warning ("adding type %s multiple times", g_type_name (table->type));
4487
4488   /* FIXME: we're not really doing the const justice, we assume the table is
4489    * static */
4490   gst_value_hash_add_type (table->type, table);
4491 }
4492
4493 /**
4494  * gst_value_init_and_copy:
4495  * @dest: (out caller-allocates): the target value
4496  * @src: the source value
4497  *
4498  * Initialises the target value to be of the same type as source and then copies
4499  * the contents from source to target.
4500  */
4501 void
4502 gst_value_init_and_copy (GValue * dest, const GValue * src)
4503 {
4504   g_return_if_fail (G_IS_VALUE (src));
4505   g_return_if_fail (dest != NULL);
4506
4507   g_value_init (dest, G_VALUE_TYPE (src));
4508   g_value_copy (src, dest);
4509 }
4510
4511 /**
4512  * gst_value_serialize:
4513  * @value: a #GValue to serialize
4514  *
4515  * tries to transform the given @value into a string representation that allows
4516  * getting back this string later on using gst_value_deserialize().
4517  *
4518  * Free-function: g_free
4519  *
4520  * Returns: (transfer full): the serialization for @value or NULL if none exists
4521  */
4522 gchar *
4523 gst_value_serialize (const GValue * value)
4524 {
4525   guint i, len;
4526   GValue s_val = { 0 };
4527   GstValueTable *table, *best;
4528   gchar *s;
4529   GType type;
4530
4531   g_return_val_if_fail (G_IS_VALUE (value), NULL);
4532
4533   type = G_VALUE_TYPE (value);
4534
4535   best = gst_value_hash_lookup_type (type);
4536
4537   if (G_UNLIKELY (!best || !best->serialize)) {
4538     len = gst_value_table->len;
4539     best = NULL;
4540     for (i = 0; i < len; i++) {
4541       table = &g_array_index (gst_value_table, GstValueTable, i);
4542       if (table->serialize && g_type_is_a (type, table->type)) {
4543         if (!best || g_type_is_a (table->type, best->type))
4544           best = table;
4545       }
4546     }
4547   }
4548   if (G_LIKELY (best))
4549     return best->serialize (value);
4550
4551   g_value_init (&s_val, G_TYPE_STRING);
4552   if (g_value_transform (value, &s_val)) {
4553     s = gst_string_wrap (g_value_get_string (&s_val));
4554   } else {
4555     s = NULL;
4556   }
4557   g_value_unset (&s_val);
4558
4559   return s;
4560 }
4561
4562 /**
4563  * gst_value_deserialize:
4564  * @dest: (out caller-allocates): #GValue to fill with contents of
4565  *     deserialization
4566  * @src: string to deserialize
4567  *
4568  * Tries to deserialize a string into the type specified by the given GValue.
4569  * If the operation succeeds, TRUE is returned, FALSE otherwise.
4570  *
4571  * Returns: TRUE on success
4572  */
4573 gboolean
4574 gst_value_deserialize (GValue * dest, const gchar * src)
4575 {
4576   GstValueTable *table, *best;
4577   guint i, len;
4578   GType type;
4579
4580   g_return_val_if_fail (src != NULL, FALSE);
4581   g_return_val_if_fail (G_IS_VALUE (dest), FALSE);
4582
4583   type = G_VALUE_TYPE (dest);
4584
4585   best = gst_value_hash_lookup_type (type);
4586   if (G_UNLIKELY (!best || !best->deserialize)) {
4587     len = gst_value_table->len;
4588     best = NULL;
4589     for (i = 0; i < len; i++) {
4590       table = &g_array_index (gst_value_table, GstValueTable, i);
4591       if (table->deserialize && g_type_is_a (type, table->type)) {
4592         if (!best || g_type_is_a (table->type, best->type))
4593           best = table;
4594       }
4595     }
4596   }
4597   if (G_LIKELY (best))
4598     return best->deserialize (dest, src);
4599
4600   return FALSE;
4601 }
4602
4603 /**
4604  * gst_value_is_fixed:
4605  * @value: the #GValue to check
4606  *
4607  * Tests if the given GValue, if available in a GstStructure (or any other
4608  * container) contains a "fixed" (which means: one value) or an "unfixed"
4609  * (which means: multiple possible values, such as data lists or data
4610  * ranges) value.
4611  *
4612  * Returns: true if the value is "fixed".
4613  */
4614
4615 gboolean
4616 gst_value_is_fixed (const GValue * value)
4617 {
4618   GType type;
4619
4620   g_return_val_if_fail (G_IS_VALUE (value), FALSE);
4621
4622   type = G_VALUE_TYPE (value);
4623
4624   /* the most common types are just basic plain glib types */
4625   if (type <= G_TYPE_MAKE_FUNDAMENTAL (G_TYPE_RESERVED_GLIB_LAST)) {
4626     return TRUE;
4627   }
4628
4629   if (type == GST_TYPE_ARRAY) {
4630     gint size, n;
4631     const GValue *kid;
4632
4633     /* check recursively */
4634     size = gst_value_array_get_size (value);
4635     for (n = 0; n < size; n++) {
4636       kid = gst_value_array_get_value (value, n);
4637       if (!gst_value_is_fixed (kid))
4638         return FALSE;
4639     }
4640     return TRUE;
4641   }
4642   return gst_type_is_fixed (type);
4643 }
4644
4645 /**
4646  * gst_value_fixate:
4647  * @dest: the #GValue destination
4648  * @src: the #GValue to fixate
4649  *
4650  * Fixate @src into a new value @dest.
4651  * For ranges, the first element is taken. For lists and arrays, the
4652  * first item is fixated and returned.
4653  * If @src is already fixed, this function returns FALSE.
4654  *
4655  * Returns: true if @dest contains a fixated version of @src.
4656  */
4657 gboolean
4658 gst_value_fixate (GValue * dest, const GValue * src)
4659 {
4660   g_return_val_if_fail (G_IS_VALUE (src), FALSE);
4661   g_return_val_if_fail (dest != NULL, FALSE);
4662
4663   if (G_VALUE_TYPE (src) == GST_TYPE_INT_RANGE) {
4664     g_value_init (dest, G_TYPE_INT);
4665     g_value_set_int (dest, gst_value_get_int_range_min (src));
4666   } else if (G_VALUE_TYPE (src) == GST_TYPE_DOUBLE_RANGE) {
4667     g_value_init (dest, G_TYPE_DOUBLE);
4668     g_value_set_double (dest, gst_value_get_double_range_min (src));
4669   } else if (G_VALUE_TYPE (src) == GST_TYPE_FRACTION_RANGE) {
4670     gst_value_init_and_copy (dest, gst_value_get_fraction_range_min (src));
4671   } else if (G_VALUE_TYPE (src) == GST_TYPE_LIST) {
4672     GValue temp = { 0 };
4673
4674     /* list could be empty */
4675     if (gst_value_list_get_size (src) <= 0)
4676       return FALSE;
4677
4678     gst_value_init_and_copy (&temp, gst_value_list_get_value (src, 0));
4679
4680     if (!gst_value_fixate (dest, &temp))
4681       gst_value_init_and_copy (dest, &temp);
4682     g_value_unset (&temp);
4683   } else if (G_VALUE_TYPE (src) == GST_TYPE_ARRAY) {
4684     gboolean res = FALSE;
4685     guint n, len;
4686
4687     len = gst_value_array_get_size (src);
4688     g_value_init (dest, GST_TYPE_ARRAY);
4689     for (n = 0; n < len; n++) {
4690       GValue kid = { 0 };
4691       const GValue *orig_kid = gst_value_array_get_value (src, n);
4692
4693       if (!gst_value_fixate (&kid, orig_kid))
4694         gst_value_init_and_copy (&kid, orig_kid);
4695       else
4696         res = TRUE;
4697       gst_value_array_append_value (dest, &kid);
4698       g_value_unset (&kid);
4699     }
4700
4701     if (!res)
4702       g_value_unset (dest);
4703
4704     return res;
4705   } else {
4706     return FALSE;
4707   }
4708   return TRUE;
4709 }
4710
4711
4712 /************
4713  * fraction *
4714  ************/
4715
4716 /* helper functions */
4717 static void
4718 gst_value_init_fraction (GValue * value)
4719 {
4720   value->data[0].v_int = 0;
4721   value->data[1].v_int = 1;
4722 }
4723
4724 static void
4725 gst_value_copy_fraction (const GValue * src_value, GValue * dest_value)
4726 {
4727   dest_value->data[0].v_int = src_value->data[0].v_int;
4728   dest_value->data[1].v_int = src_value->data[1].v_int;
4729 }
4730
4731 static gchar *
4732 gst_value_collect_fraction (GValue * value, guint n_collect_values,
4733     GTypeCValue * collect_values, guint collect_flags)
4734 {
4735   if (n_collect_values != 2)
4736     return g_strdup_printf ("not enough value locations for `%s' passed",
4737         G_VALUE_TYPE_NAME (value));
4738   if (collect_values[1].v_int == 0)
4739     return g_strdup_printf ("passed '0' as denominator for `%s'",
4740         G_VALUE_TYPE_NAME (value));
4741   if (collect_values[0].v_int < -G_MAXINT)
4742     return
4743         g_strdup_printf
4744         ("passed value smaller than -G_MAXINT as numerator for `%s'",
4745         G_VALUE_TYPE_NAME (value));
4746   if (collect_values[1].v_int < -G_MAXINT)
4747     return
4748         g_strdup_printf
4749         ("passed value smaller than -G_MAXINT as denominator for `%s'",
4750         G_VALUE_TYPE_NAME (value));
4751
4752   gst_value_set_fraction (value,
4753       collect_values[0].v_int, collect_values[1].v_int);
4754
4755   return NULL;
4756 }
4757
4758 static gchar *
4759 gst_value_lcopy_fraction (const GValue * value, guint n_collect_values,
4760     GTypeCValue * collect_values, guint collect_flags)
4761 {
4762   gint *numerator = collect_values[0].v_pointer;
4763   gint *denominator = collect_values[1].v_pointer;
4764
4765   if (!numerator)
4766     return g_strdup_printf ("numerator for `%s' passed as NULL",
4767         G_VALUE_TYPE_NAME (value));
4768   if (!denominator)
4769     return g_strdup_printf ("denominator for `%s' passed as NULL",
4770         G_VALUE_TYPE_NAME (value));
4771
4772   *numerator = value->data[0].v_int;
4773   *denominator = value->data[1].v_int;
4774
4775   return NULL;
4776 }
4777
4778 /**
4779  * gst_value_set_fraction:
4780  * @value: a GValue initialized to #GST_TYPE_FRACTION
4781  * @numerator: the numerator of the fraction
4782  * @denominator: the denominator of the fraction
4783  *
4784  * Sets @value to the fraction specified by @numerator over @denominator.
4785  * The fraction gets reduced to the smallest numerator and denominator,
4786  * and if necessary the sign is moved to the numerator.
4787  */
4788 void
4789 gst_value_set_fraction (GValue * value, gint numerator, gint denominator)
4790 {
4791   gint gcd = 0;
4792
4793   g_return_if_fail (GST_VALUE_HOLDS_FRACTION (value));
4794   g_return_if_fail (denominator != 0);
4795   g_return_if_fail (denominator >= -G_MAXINT);
4796   g_return_if_fail (numerator >= -G_MAXINT);
4797
4798   /* normalize sign */
4799   if (denominator < 0) {
4800     numerator = -numerator;
4801     denominator = -denominator;
4802   }
4803
4804   /* check for reduction */
4805   gcd = gst_util_greatest_common_divisor (numerator, denominator);
4806   if (gcd) {
4807     numerator /= gcd;
4808     denominator /= gcd;
4809   }
4810
4811   g_assert (denominator > 0);
4812
4813   value->data[0].v_int = numerator;
4814   value->data[1].v_int = denominator;
4815 }
4816
4817 /**
4818  * gst_value_get_fraction_numerator:
4819  * @value: a GValue initialized to #GST_TYPE_FRACTION
4820  *
4821  * Gets the numerator of the fraction specified by @value.
4822  *
4823  * Returns: the numerator of the fraction.
4824  */
4825 gint
4826 gst_value_get_fraction_numerator (const GValue * value)
4827 {
4828   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION (value), 0);
4829
4830   return value->data[0].v_int;
4831 }
4832
4833 /**
4834  * gst_value_get_fraction_denominator:
4835  * @value: a GValue initialized to #GST_TYPE_FRACTION
4836  *
4837  * Gets the denominator of the fraction specified by @value.
4838  *
4839  * Returns: the denominator of the fraction.
4840  */
4841 gint
4842 gst_value_get_fraction_denominator (const GValue * value)
4843 {
4844   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION (value), 1);
4845
4846   return value->data[1].v_int;
4847 }
4848
4849 /**
4850  * gst_value_fraction_multiply:
4851  * @product: a GValue initialized to #GST_TYPE_FRACTION
4852  * @factor1: a GValue initialized to #GST_TYPE_FRACTION
4853  * @factor2: a GValue initialized to #GST_TYPE_FRACTION
4854  *
4855  * Multiplies the two #GValue items containing a #GST_TYPE_FRACTION and sets
4856  * @product to the product of the two fractions.
4857  *
4858  * Returns: FALSE in case of an error (like integer overflow), TRUE otherwise.
4859  */
4860 gboolean
4861 gst_value_fraction_multiply (GValue * product, const GValue * factor1,
4862     const GValue * factor2)
4863 {
4864   gint n1, n2, d1, d2;
4865   gint res_n, res_d;
4866
4867   g_return_val_if_fail (product != NULL, FALSE);
4868   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION (factor1), FALSE);
4869   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION (factor2), FALSE);
4870
4871   n1 = factor1->data[0].v_int;
4872   n2 = factor2->data[0].v_int;
4873   d1 = factor1->data[1].v_int;
4874   d2 = factor2->data[1].v_int;
4875
4876   if (!gst_util_fraction_multiply (n1, d1, n2, d2, &res_n, &res_d))
4877     return FALSE;
4878
4879   gst_value_set_fraction (product, res_n, res_d);
4880
4881   return TRUE;
4882 }
4883
4884 /**
4885  * gst_value_fraction_subtract:
4886  * @dest: a GValue initialized to #GST_TYPE_FRACTION
4887  * @minuend: a GValue initialized to #GST_TYPE_FRACTION
4888  * @subtrahend: a GValue initialized to #GST_TYPE_FRACTION
4889  *
4890  * Subtracts the @subtrahend from the @minuend and sets @dest to the result.
4891  *
4892  * Returns: FALSE in case of an error (like integer overflow), TRUE otherwise.
4893  */
4894 gboolean
4895 gst_value_fraction_subtract (GValue * dest,
4896     const GValue * minuend, const GValue * subtrahend)
4897 {
4898   gint n1, n2, d1, d2;
4899   gint res_n, res_d;
4900
4901   g_return_val_if_fail (dest != NULL, FALSE);
4902   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION (minuend), FALSE);
4903   g_return_val_if_fail (GST_VALUE_HOLDS_FRACTION (subtrahend), FALSE);
4904
4905   n1 = minuend->data[0].v_int;
4906   n2 = subtrahend->data[0].v_int;
4907   d1 = minuend->data[1].v_int;
4908   d2 = subtrahend->data[1].v_int;
4909
4910   if (!gst_util_fraction_add (n1, d1, -n2, d2, &res_n, &res_d))
4911     return FALSE;
4912   gst_value_set_fraction (dest, res_n, res_d);
4913
4914   return TRUE;
4915 }
4916
4917 static gchar *
4918 gst_value_serialize_fraction (const GValue * value)
4919 {
4920   gint32 numerator = value->data[0].v_int;
4921   gint32 denominator = value->data[1].v_int;
4922   gboolean positive = TRUE;
4923
4924   /* get the sign and make components absolute */
4925   if (numerator < 0) {
4926     numerator = -numerator;
4927     positive = !positive;
4928   }
4929   if (denominator < 0) {
4930     denominator = -denominator;
4931     positive = !positive;
4932   }
4933
4934   return g_strdup_printf ("%s%d/%d",
4935       positive ? "" : "-", numerator, denominator);
4936 }
4937
4938 static gboolean
4939 gst_value_deserialize_fraction (GValue * dest, const gchar * s)
4940 {
4941   gint num, den;
4942   gint num_chars;
4943
4944   if (G_UNLIKELY (s == NULL))
4945     return FALSE;
4946
4947   if (G_UNLIKELY (dest == NULL || !GST_VALUE_HOLDS_FRACTION (dest)))
4948     return FALSE;
4949
4950   if (sscanf (s, "%d/%d%n", &num, &den, &num_chars) >= 2) {
4951     if (s[num_chars] != 0)
4952       return FALSE;
4953     if (den == 0)
4954       return FALSE;
4955
4956     gst_value_set_fraction (dest, num, den);
4957     return TRUE;
4958   } else if (g_ascii_strcasecmp (s, "1/max") == 0) {
4959     gst_value_set_fraction (dest, 1, G_MAXINT);
4960     return TRUE;
4961   } else if (sscanf (s, "%d%n", &num, &num_chars) >= 1) {
4962     if (s[num_chars] != 0)
4963       return FALSE;
4964     gst_value_set_fraction (dest, num, 1);
4965     return TRUE;
4966   } else if (g_ascii_strcasecmp (s, "min") == 0) {
4967     gst_value_set_fraction (dest, -G_MAXINT, 1);
4968     return TRUE;
4969   } else if (g_ascii_strcasecmp (s, "max") == 0) {
4970     gst_value_set_fraction (dest, G_MAXINT, 1);
4971     return TRUE;
4972   }
4973
4974   return FALSE;
4975 }
4976
4977 static void
4978 gst_value_transform_fraction_string (const GValue * src_value,
4979     GValue * dest_value)
4980 {
4981   dest_value->data[0].v_pointer = gst_value_serialize_fraction (src_value);
4982 }
4983
4984 static void
4985 gst_value_transform_string_fraction (const GValue * src_value,
4986     GValue * dest_value)
4987 {
4988   if (!gst_value_deserialize_fraction (dest_value,
4989           src_value->data[0].v_pointer))
4990     /* If the deserialize fails, ensure we leave the fraction in a
4991      * valid, if incorrect, state */
4992     gst_value_set_fraction (dest_value, 0, 1);
4993 }
4994
4995 static void
4996 gst_value_transform_double_fraction (const GValue * src_value,
4997     GValue * dest_value)
4998 {
4999   gdouble src = g_value_get_double (src_value);
5000   gint n, d;
5001
5002   gst_util_double_to_fraction (src, &n, &d);
5003   gst_value_set_fraction (dest_value, n, d);
5004 }
5005
5006 static void
5007 gst_value_transform_float_fraction (const GValue * src_value,
5008     GValue * dest_value)
5009 {
5010   gfloat src = g_value_get_float (src_value);
5011   gint n, d;
5012
5013   gst_util_double_to_fraction (src, &n, &d);
5014   gst_value_set_fraction (dest_value, n, d);
5015 }
5016
5017 static void
5018 gst_value_transform_fraction_double (const GValue * src_value,
5019     GValue * dest_value)
5020 {
5021   dest_value->data[0].v_double = ((double) src_value->data[0].v_int) /
5022       ((double) src_value->data[1].v_int);
5023 }
5024
5025 static void
5026 gst_value_transform_fraction_float (const GValue * src_value,
5027     GValue * dest_value)
5028 {
5029   dest_value->data[0].v_float = ((float) src_value->data[0].v_int) /
5030       ((float) src_value->data[1].v_int);
5031 }
5032
5033 static gint
5034 gst_value_compare_fraction (const GValue * value1, const GValue * value2)
5035 {
5036   gint n1, n2;
5037   gint d1, d2;
5038   gint ret;
5039
5040   n1 = value1->data[0].v_int;
5041   n2 = value2->data[0].v_int;
5042   d1 = value1->data[1].v_int;
5043   d2 = value2->data[1].v_int;
5044
5045   /* fractions are reduced when set, so we can quickly see if they're equal */
5046   if (n1 == n2 && d1 == d2)
5047     return GST_VALUE_EQUAL;
5048
5049   if (d1 == 0 && d2 == 0)
5050     return GST_VALUE_UNORDERED;
5051   else if (d1 == 0)
5052     return GST_VALUE_GREATER_THAN;
5053   else if (d2 == 0)
5054     return GST_VALUE_LESS_THAN;
5055
5056   ret = gst_util_fraction_compare (n1, d1, n2, d2);
5057   if (ret == -1)
5058     return GST_VALUE_LESS_THAN;
5059   else if (ret == 1)
5060     return GST_VALUE_GREATER_THAN;
5061
5062   /* Equality can't happen here because we check for that
5063    * first already */
5064   g_return_val_if_reached (GST_VALUE_UNORDERED);
5065 }
5066
5067 /*********
5068  * GDate *
5069  *********/
5070
5071 static gint
5072 gst_value_compare_date (const GValue * value1, const GValue * value2)
5073 {
5074   const GDate *date1 = (const GDate *) g_value_get_boxed (value1);
5075   const GDate *date2 = (const GDate *) g_value_get_boxed (value2);
5076   guint32 j1, j2;
5077
5078   if (date1 == date2)
5079     return GST_VALUE_EQUAL;
5080
5081   if ((date1 == NULL || !g_date_valid (date1))
5082       && (date2 != NULL && g_date_valid (date2))) {
5083     return GST_VALUE_LESS_THAN;
5084   }
5085
5086   if ((date2 == NULL || !g_date_valid (date2))
5087       && (date1 != NULL && g_date_valid (date1))) {
5088     return GST_VALUE_GREATER_THAN;
5089   }
5090
5091   if (date1 == NULL || date2 == NULL || !g_date_valid (date1)
5092       || !g_date_valid (date2)) {
5093     return GST_VALUE_UNORDERED;
5094   }
5095
5096   j1 = g_date_get_julian (date1);
5097   j2 = g_date_get_julian (date2);
5098
5099   if (j1 == j2)
5100     return GST_VALUE_EQUAL;
5101   else if (j1 < j2)
5102     return GST_VALUE_LESS_THAN;
5103   else
5104     return GST_VALUE_GREATER_THAN;
5105 }
5106
5107 static gchar *
5108 gst_value_serialize_date (const GValue * val)
5109 {
5110   const GDate *date = (const GDate *) g_value_get_boxed (val);
5111
5112   if (date == NULL || !g_date_valid (date))
5113     return g_strdup ("9999-99-99");
5114
5115   return g_strdup_printf ("%04u-%02u-%02u", g_date_get_year (date),
5116       g_date_get_month (date), g_date_get_day (date));
5117 }
5118
5119 static gboolean
5120 gst_value_deserialize_date (GValue * dest, const gchar * s)
5121 {
5122   guint year, month, day;
5123
5124   if (!s || sscanf (s, "%04u-%02u-%02u", &year, &month, &day) != 3)
5125     return FALSE;
5126
5127   if (!g_date_valid_dmy (day, month, year))
5128     return FALSE;
5129
5130   g_value_take_boxed (dest, g_date_new_dmy (day, month, year));
5131   return TRUE;
5132 }
5133
5134 /*************
5135  * GstDateTime *
5136  *************/
5137
5138 static gint
5139 gst_value_compare_date_time (const GValue * value1, const GValue * value2)
5140 {
5141   const GstDateTime *date1 = (const GstDateTime *) g_value_get_boxed (value1);
5142   const GstDateTime *date2 = (const GstDateTime *) g_value_get_boxed (value2);
5143   gint ret;
5144
5145   if (date1 == date2)
5146     return GST_VALUE_EQUAL;
5147
5148   if ((date1 == NULL) && (date2 != NULL)) {
5149     return GST_VALUE_LESS_THAN;
5150   }
5151   if ((date2 == NULL) && (date1 != NULL)) {
5152     return GST_VALUE_LESS_THAN;
5153   }
5154
5155   ret = priv_gst_date_time_compare (date1, date2);
5156
5157   if (ret == 0)
5158     return GST_VALUE_EQUAL;
5159   else if (ret < 0)
5160     return GST_VALUE_LESS_THAN;
5161   else
5162     return GST_VALUE_GREATER_THAN;
5163 }
5164
5165 static gchar *
5166 gst_value_serialize_date_time (const GValue * val)
5167 {
5168   GstDateTime *date = (GstDateTime *) g_value_get_boxed (val);
5169   gfloat offset;
5170   gint tzhour, tzminute;
5171
5172   if (date == NULL)
5173     return g_strdup ("null");
5174
5175   offset = gst_date_time_get_time_zone_offset (date);
5176
5177   tzhour = (gint) ABS (offset);
5178   tzminute = (gint) ((ABS (offset) - tzhour) * 60);
5179
5180   return g_strdup_printf ("\"%04d-%02d-%02dT%02d:%02d:%02d.%06d"
5181       "%c%02d%02d\"", gst_date_time_get_year (date),
5182       gst_date_time_get_month (date), gst_date_time_get_day (date),
5183       gst_date_time_get_hour (date), gst_date_time_get_minute (date),
5184       gst_date_time_get_second (date), gst_date_time_get_microsecond (date),
5185       offset >= 0 ? '+' : '-', tzhour, tzminute);
5186 }
5187
5188 static gboolean
5189 gst_value_deserialize_date_time (GValue * dest, const gchar * s)
5190 {
5191   gint year, month, day, hour, minute, second, usecond;
5192   gchar signal;
5193   gint offset = 0;
5194   gfloat tzoffset = 0;
5195   gint ret;
5196
5197   if (!s || strcmp (s, "null") == 0) {
5198     return FALSE;
5199   }
5200
5201   ret = sscanf (s, "%04d-%02d-%02dT%02d:%02d:%02d.%06d%c%04d",
5202       &year, &month, &day, &hour, &minute, &second, &usecond, &signal, &offset);
5203   if (ret >= 9) {
5204     tzoffset = (offset / 100) + ((offset % 100) / 60.0);
5205     if (signal == '-')
5206       tzoffset = -tzoffset;
5207   } else
5208     return FALSE;
5209
5210   g_value_take_boxed (dest, gst_date_time_new (tzoffset, year, month, day, hour,
5211           minute, second + (usecond / 1000000.0)));
5212   return TRUE;
5213 }
5214
5215 static void
5216 gst_value_transform_date_string (const GValue * src_value, GValue * dest_value)
5217 {
5218   dest_value->data[0].v_pointer = gst_value_serialize_date (src_value);
5219 }
5220
5221 static void
5222 gst_value_transform_string_date (const GValue * src_value, GValue * dest_value)
5223 {
5224   gst_value_deserialize_date (dest_value, src_value->data[0].v_pointer);
5225 }
5226
5227
5228 /************
5229  * bitmask *
5230  ************/
5231
5232 /* helper functions */
5233 static void
5234 gst_value_init_bitmask (GValue * value)
5235 {
5236   value->data[0].v_uint64 = 0;
5237 }
5238
5239 static void
5240 gst_value_copy_bitmask (const GValue * src_value, GValue * dest_value)
5241 {
5242   dest_value->data[0].v_uint64 = src_value->data[0].v_uint64;
5243 }
5244
5245 static gchar *
5246 gst_value_collect_bitmask (GValue * value, guint n_collect_values,
5247     GTypeCValue * collect_values, guint collect_flags)
5248 {
5249   if (n_collect_values != 1)
5250     return g_strdup_printf ("not enough value locations for `%s' passed",
5251         G_VALUE_TYPE_NAME (value));
5252
5253   gst_value_set_bitmask (value, (guint64) collect_values[0].v_int64);
5254
5255   return NULL;
5256 }
5257
5258 static gchar *
5259 gst_value_lcopy_bitmask (const GValue * value, guint n_collect_values,
5260     GTypeCValue * collect_values, guint collect_flags)
5261 {
5262   guint64 *bitmask = collect_values[0].v_pointer;
5263
5264   if (!bitmask)
5265     return g_strdup_printf ("value for `%s' passed as NULL",
5266         G_VALUE_TYPE_NAME (value));
5267
5268   *bitmask = value->data[0].v_uint64;
5269
5270   return NULL;
5271 }
5272
5273 /**
5274  * gst_value_set_bitmask:
5275  * @value: a GValue initialized to #GST_TYPE_FRACTION
5276  * @bitmask: the bitmask
5277  *
5278  * Sets @value to the bitmask specified by @bitmask.
5279  */
5280 void
5281 gst_value_set_bitmask (GValue * value, guint64 bitmask)
5282 {
5283   g_return_if_fail (GST_VALUE_HOLDS_BITMASK (value));
5284
5285   value->data[0].v_uint64 = bitmask;
5286 }
5287
5288 /**
5289  * gst_value_get_bitmask:
5290  * @value: a GValue initialized to #GST_TYPE_FRACTION
5291  *
5292  * Gets the bitmask specified by @value.
5293  *
5294  * Returns: the bitmask.
5295  */
5296 guint64
5297 gst_value_get_bitmask (const GValue * value)
5298 {
5299   g_return_val_if_fail (GST_VALUE_HOLDS_BITMASK (value), 0);
5300
5301   return value->data[0].v_uint64;
5302 }
5303
5304 static gchar *
5305 gst_value_serialize_bitmask (const GValue * value)
5306 {
5307   guint64 bitmask = value->data[0].v_uint64;
5308
5309   return g_strdup_printf ("0x%016" G_GINT64_MODIFIER "x", bitmask);
5310 }
5311
5312 static gboolean
5313 gst_value_deserialize_bitmask (GValue * dest, const gchar * s)
5314 {
5315   gchar *endptr = NULL;
5316   guint64 val;
5317
5318   if (G_UNLIKELY (s == NULL))
5319     return FALSE;
5320
5321   if (G_UNLIKELY (dest == NULL || !GST_VALUE_HOLDS_BITMASK (dest)))
5322     return FALSE;
5323
5324   val = g_ascii_strtoull (s, &endptr, 16);
5325   if (val == G_MAXUINT64 && (errno == ERANGE || errno == EINVAL))
5326     return FALSE;
5327   if (val == 0 && endptr == s)
5328     return FALSE;
5329
5330   gst_value_set_bitmask (dest, val);
5331
5332   return TRUE;
5333 }
5334
5335 static void
5336 gst_value_transform_bitmask_string (const GValue * src_value,
5337     GValue * dest_value)
5338 {
5339   dest_value->data[0].v_pointer = gst_value_serialize_bitmask (src_value);
5340 }
5341
5342 static void
5343 gst_value_transform_string_bitmask (const GValue * src_value,
5344     GValue * dest_value)
5345 {
5346   if (!gst_value_deserialize_bitmask (dest_value, src_value->data[0].v_pointer))
5347     gst_value_set_bitmask (dest_value, 0);
5348 }
5349
5350 static void
5351 gst_value_transform_uint64_bitmask (const GValue * src_value,
5352     GValue * dest_value)
5353 {
5354   dest_value->data[0].v_uint64 = src_value->data[0].v_uint64;
5355 }
5356
5357 static void
5358 gst_value_transform_bitmask_uint64 (const GValue * src_value,
5359     GValue * dest_value)
5360 {
5361   dest_value->data[0].v_uint64 = src_value->data[0].v_uint64;
5362 }
5363
5364 static gboolean
5365 gst_value_intersect_bitmask_bitmask (GValue * dest, const GValue * src1,
5366     const GValue * src2)
5367 {
5368   guint64 s1, s2;
5369
5370   s1 = gst_value_get_bitmask (src1);
5371   s2 = gst_value_get_bitmask (src2);
5372
5373   if (dest) {
5374     g_value_init (dest, GST_TYPE_BITMASK);
5375     gst_value_set_bitmask (dest, s1 & s2);
5376   }
5377
5378   return TRUE;
5379 }
5380
5381 static gboolean
5382 gst_value_union_bitmask_bitmask (GValue * dest, const GValue * src1,
5383     const GValue * src2)
5384 {
5385   guint64 s1, s2;
5386
5387   s1 = gst_value_get_bitmask (src1);
5388   s2 = gst_value_get_bitmask (src2);
5389
5390   g_value_init (dest, GST_TYPE_BITMASK);
5391   gst_value_set_bitmask (dest, s1 | s2);
5392
5393   return TRUE;
5394 }
5395
5396 static gboolean
5397 gst_value_subtract_bitmask_bitmask (GValue * dest,
5398     const GValue * minuend, const GValue * subtrahend)
5399 {
5400   guint64 m, s, r;
5401
5402   g_return_val_if_fail (GST_VALUE_HOLDS_BITMASK (minuend), FALSE);
5403   g_return_val_if_fail (GST_VALUE_HOLDS_BITMASK (subtrahend), FALSE);
5404
5405   m = minuend->data[0].v_uint64;
5406   s = subtrahend->data[0].v_uint64;
5407   r = m & (~s);
5408
5409   if (dest) {
5410     g_value_init (dest, GST_TYPE_BITMASK);
5411     gst_value_set_bitmask (dest, r);
5412   }
5413   return (r != 0);
5414 }
5415
5416 static gint
5417 gst_value_compare_bitmask (const GValue * value1, const GValue * value2)
5418 {
5419   guint64 v1, v2;
5420
5421   v1 = value1->data[0].v_uint64;
5422   v2 = value2->data[0].v_uint64;
5423
5424   if (v1 == v2)
5425     return GST_VALUE_EQUAL;
5426
5427   return GST_VALUE_UNORDERED;
5428 }
5429
5430 static void
5431 gst_value_transform_object_string (const GValue * src_value,
5432     GValue * dest_value)
5433 {
5434   GstObject *obj;
5435   gchar *str;
5436
5437   obj = g_value_get_object (src_value);
5438   if (obj) {
5439     str =
5440         g_strdup_printf ("(%s) %s", G_OBJECT_TYPE_NAME (obj),
5441         GST_OBJECT_NAME (obj));
5442   } else {
5443     str = g_strdup ("NULL");
5444   }
5445
5446   dest_value->data[0].v_pointer = str;
5447 }
5448
5449 static GTypeInfo _info = {
5450   0,
5451   NULL,
5452   NULL,
5453   NULL,
5454   NULL,
5455   NULL,
5456   0,
5457   0,
5458   NULL,
5459   NULL,
5460 };
5461
5462 static GTypeFundamentalInfo _finfo = {
5463   0
5464 };
5465
5466 #define FUNC_VALUE_GET_TYPE(type, name)                         \
5467 GType gst_ ## type ## _get_type (void)                          \
5468 {                                                               \
5469   static volatile GType gst_ ## type ## _type = 0;                       \
5470                                                                 \
5471   if (g_once_init_enter (&gst_ ## type ## _type)) {             \
5472     GType _type;                                        \
5473     _info.value_table = & _gst_ ## type ## _value_table;        \
5474     _type = g_type_register_fundamental (       \
5475         g_type_fundamental_next (),                             \
5476         name, &_info, &_finfo, 0);                              \
5477     g_once_init_leave(&gst_ ## type ## _type, _type);   \
5478   }                                                             \
5479                                                                 \
5480   return gst_ ## type ## _type;                                 \
5481 }
5482
5483 static const GTypeValueTable _gst_int_range_value_table = {
5484   gst_value_init_int_range,
5485   gst_value_free_int_range,
5486   gst_value_copy_int_range,
5487   NULL,
5488   (char *) "ii",
5489   gst_value_collect_int_range,
5490   (char *) "pp",
5491   gst_value_lcopy_int_range
5492 };
5493
5494 FUNC_VALUE_GET_TYPE (int_range, "GstIntRange");
5495
5496 static const GTypeValueTable _gst_int64_range_value_table = {
5497   gst_value_init_int64_range,
5498   gst_value_free_int64_range,
5499   gst_value_copy_int64_range,
5500   NULL,
5501   (char *) "qq",
5502   gst_value_collect_int64_range,
5503   (char *) "pp",
5504   gst_value_lcopy_int64_range
5505 };
5506
5507 FUNC_VALUE_GET_TYPE (int64_range, "GstInt64Range");
5508
5509 static const GTypeValueTable _gst_double_range_value_table = {
5510   gst_value_init_double_range,
5511   NULL,
5512   gst_value_copy_double_range,
5513   NULL,
5514   (char *) "dd",
5515   gst_value_collect_double_range,
5516   (char *) "pp",
5517   gst_value_lcopy_double_range
5518 };
5519
5520 FUNC_VALUE_GET_TYPE (double_range, "GstDoubleRange");
5521
5522 static const GTypeValueTable _gst_fraction_range_value_table = {
5523   gst_value_init_fraction_range,
5524   gst_value_free_fraction_range,
5525   gst_value_copy_fraction_range,
5526   NULL,
5527   (char *) "iiii",
5528   gst_value_collect_fraction_range,
5529   (char *) "pppp",
5530   gst_value_lcopy_fraction_range
5531 };
5532
5533 FUNC_VALUE_GET_TYPE (fraction_range, "GstFractionRange");
5534
5535 static const GTypeValueTable _gst_value_list_value_table = {
5536   gst_value_init_list_or_array,
5537   gst_value_free_list_or_array,
5538   gst_value_copy_list_or_array,
5539   gst_value_list_or_array_peek_pointer,
5540   (char *) "p",
5541   gst_value_collect_list_or_array,
5542   (char *) "p",
5543   gst_value_lcopy_list_or_array
5544 };
5545
5546 FUNC_VALUE_GET_TYPE (value_list, "GstValueList");
5547
5548 static const GTypeValueTable _gst_value_array_value_table = {
5549   gst_value_init_list_or_array,
5550   gst_value_free_list_or_array,
5551   gst_value_copy_list_or_array,
5552   gst_value_list_or_array_peek_pointer,
5553   (char *) "p",
5554   gst_value_collect_list_or_array,
5555   (char *) "p",
5556   gst_value_lcopy_list_or_array
5557 };
5558
5559 FUNC_VALUE_GET_TYPE (value_array, "GstValueArray");
5560
5561 static const GTypeValueTable _gst_fraction_value_table = {
5562   gst_value_init_fraction,
5563   NULL,
5564   gst_value_copy_fraction,
5565   NULL,
5566   (char *) "ii",
5567   gst_value_collect_fraction,
5568   (char *) "pp",
5569   gst_value_lcopy_fraction
5570 };
5571
5572 FUNC_VALUE_GET_TYPE (fraction, "GstFraction");
5573
5574 G_DEFINE_BOXED_TYPE (GstDateTime, gst_date_time,
5575     (GBoxedCopyFunc) gst_date_time_ref, (GBoxedFreeFunc) gst_date_time_unref);
5576
5577 static const GTypeValueTable _gst_bitmask_value_table = {
5578   gst_value_init_bitmask,
5579   NULL,
5580   gst_value_copy_bitmask,
5581   NULL,
5582   (char *) "q",
5583   gst_value_collect_bitmask,
5584   (char *) "p",
5585   gst_value_lcopy_bitmask
5586 };
5587
5588 FUNC_VALUE_GET_TYPE (bitmask, "GstBitmask");
5589
5590
5591 void
5592 _priv_gst_value_initialize (void)
5593 {
5594   gst_value_table = g_array_new (FALSE, FALSE, sizeof (GstValueTable));
5595   gst_value_hash = g_hash_table_new (NULL, NULL);
5596   gst_value_union_funcs = g_array_new (FALSE, FALSE,
5597       sizeof (GstValueUnionInfo));
5598   gst_value_intersect_funcs = g_array_new (FALSE, FALSE,
5599       sizeof (GstValueIntersectInfo));
5600   gst_value_subtract_funcs = g_array_new (FALSE, FALSE,
5601       sizeof (GstValueSubtractInfo));
5602
5603   {
5604     static GstValueTable gst_value = {
5605       0,
5606       gst_value_compare_int_range,
5607       gst_value_serialize_int_range,
5608       gst_value_deserialize_int_range,
5609     };
5610
5611     gst_value.type = gst_int_range_get_type ();
5612     gst_value_register (&gst_value);
5613   }
5614
5615   {
5616     static GstValueTable gst_value = {
5617       0,
5618       gst_value_compare_int64_range,
5619       gst_value_serialize_int64_range,
5620       gst_value_deserialize_int64_range,
5621     };
5622
5623     gst_value.type = gst_int64_range_get_type ();
5624     gst_value_register (&gst_value);
5625   }
5626
5627   {
5628     static GstValueTable gst_value = {
5629       0,
5630       gst_value_compare_double_range,
5631       gst_value_serialize_double_range,
5632       gst_value_deserialize_double_range,
5633     };
5634
5635     gst_value.type = gst_double_range_get_type ();
5636     gst_value_register (&gst_value);
5637   }
5638
5639   {
5640     static GstValueTable gst_value = {
5641       0,
5642       gst_value_compare_fraction_range,
5643       gst_value_serialize_fraction_range,
5644       gst_value_deserialize_fraction_range,
5645     };
5646
5647     gst_value.type = gst_fraction_range_get_type ();
5648     gst_value_register (&gst_value);
5649   }
5650
5651   {
5652     static GstValueTable gst_value = {
5653       0,
5654       gst_value_compare_list,
5655       gst_value_serialize_list,
5656       gst_value_deserialize_list,
5657     };
5658
5659     gst_value.type = gst_value_list_get_type ();
5660     gst_value_register (&gst_value);
5661   }
5662
5663   {
5664     static GstValueTable gst_value = {
5665       0,
5666       gst_value_compare_array,
5667       gst_value_serialize_array,
5668       gst_value_deserialize_array,
5669     };
5670
5671     gst_value.type = gst_value_array_get_type ();
5672     gst_value_register (&gst_value);
5673   }
5674
5675   {
5676 #if 0
5677     static const GTypeValueTable value_table = {
5678       gst_value_init_buffer,
5679       NULL,
5680       gst_value_copy_buffer,
5681       NULL,
5682       "i",
5683       NULL,                     /*gst_value_collect_buffer, */
5684       "p",
5685       NULL                      /*gst_value_lcopy_buffer */
5686     };
5687 #endif
5688     static GstValueTable gst_value = {
5689       0,
5690       gst_value_compare_buffer,
5691       gst_value_serialize_buffer,
5692       gst_value_deserialize_buffer,
5693     };
5694
5695     gst_value.type = GST_TYPE_BUFFER;
5696     gst_value_register (&gst_value);
5697   }
5698   {
5699     static GstValueTable gst_value = {
5700       0,
5701       gst_value_compare_fraction,
5702       gst_value_serialize_fraction,
5703       gst_value_deserialize_fraction,
5704     };
5705
5706     gst_value.type = gst_fraction_get_type ();
5707     gst_value_register (&gst_value);
5708   }
5709   {
5710     static GstValueTable gst_value = {
5711       0,
5712       NULL,
5713       gst_value_serialize_caps,
5714       gst_value_deserialize_caps,
5715     };
5716
5717     gst_value.type = GST_TYPE_CAPS;
5718     gst_value_register (&gst_value);
5719   }
5720   {
5721     static GstValueTable gst_value = {
5722       0,
5723       NULL,
5724       gst_value_serialize_structure,
5725       gst_value_deserialize_structure,
5726     };
5727
5728     gst_value.type = GST_TYPE_STRUCTURE;
5729     gst_value_register (&gst_value);
5730   }
5731   {
5732     static GstValueTable gst_value = {
5733       0,
5734       gst_value_compare_date,
5735       gst_value_serialize_date,
5736       gst_value_deserialize_date,
5737     };
5738
5739     gst_value.type = G_TYPE_DATE;
5740     gst_value_register (&gst_value);
5741   }
5742   {
5743     static GstValueTable gst_value = {
5744       0,
5745       gst_value_compare_date_time,
5746       gst_value_serialize_date_time,
5747       gst_value_deserialize_date_time,
5748     };
5749
5750     gst_value.type = gst_date_time_get_type ();
5751     gst_value_register (&gst_value);
5752   }
5753
5754   {
5755     static GstValueTable gst_value = {
5756       0,
5757       gst_value_compare_bitmask,
5758       gst_value_serialize_bitmask,
5759       gst_value_deserialize_bitmask,
5760     };
5761
5762     gst_value.type = gst_bitmask_get_type ();
5763     gst_value_register (&gst_value);
5764   }
5765
5766   REGISTER_SERIALIZATION (G_TYPE_DOUBLE, double);
5767   REGISTER_SERIALIZATION (G_TYPE_FLOAT, float);
5768
5769   REGISTER_SERIALIZATION (G_TYPE_STRING, string);
5770   REGISTER_SERIALIZATION (G_TYPE_BOOLEAN, boolean);
5771   REGISTER_SERIALIZATION (G_TYPE_ENUM, enum);
5772
5773   REGISTER_SERIALIZATION (G_TYPE_FLAGS, flags);
5774
5775   REGISTER_SERIALIZATION (G_TYPE_INT, int);
5776
5777   REGISTER_SERIALIZATION (G_TYPE_INT64, int64);
5778   REGISTER_SERIALIZATION (G_TYPE_LONG, long);
5779
5780   REGISTER_SERIALIZATION (G_TYPE_UINT, uint);
5781   REGISTER_SERIALIZATION (G_TYPE_UINT64, uint64);
5782   REGISTER_SERIALIZATION (G_TYPE_ULONG, ulong);
5783
5784   REGISTER_SERIALIZATION (G_TYPE_UCHAR, uchar);
5785
5786   g_value_register_transform_func (GST_TYPE_INT_RANGE, G_TYPE_STRING,
5787       gst_value_transform_int_range_string);
5788   g_value_register_transform_func (GST_TYPE_INT64_RANGE, G_TYPE_STRING,
5789       gst_value_transform_int64_range_string);
5790   g_value_register_transform_func (GST_TYPE_DOUBLE_RANGE, G_TYPE_STRING,
5791       gst_value_transform_double_range_string);
5792   g_value_register_transform_func (GST_TYPE_FRACTION_RANGE, G_TYPE_STRING,
5793       gst_value_transform_fraction_range_string);
5794   g_value_register_transform_func (GST_TYPE_LIST, G_TYPE_STRING,
5795       gst_value_transform_list_string);
5796   g_value_register_transform_func (GST_TYPE_ARRAY, G_TYPE_STRING,
5797       gst_value_transform_array_string);
5798   g_value_register_transform_func (GST_TYPE_FRACTION, G_TYPE_STRING,
5799       gst_value_transform_fraction_string);
5800   g_value_register_transform_func (G_TYPE_STRING, GST_TYPE_FRACTION,
5801       gst_value_transform_string_fraction);
5802   g_value_register_transform_func (GST_TYPE_FRACTION, G_TYPE_DOUBLE,
5803       gst_value_transform_fraction_double);
5804   g_value_register_transform_func (GST_TYPE_FRACTION, G_TYPE_FLOAT,
5805       gst_value_transform_fraction_float);
5806   g_value_register_transform_func (G_TYPE_DOUBLE, GST_TYPE_FRACTION,
5807       gst_value_transform_double_fraction);
5808   g_value_register_transform_func (G_TYPE_FLOAT, GST_TYPE_FRACTION,
5809       gst_value_transform_float_fraction);
5810   g_value_register_transform_func (G_TYPE_DATE, G_TYPE_STRING,
5811       gst_value_transform_date_string);
5812   g_value_register_transform_func (G_TYPE_STRING, G_TYPE_DATE,
5813       gst_value_transform_string_date);
5814   g_value_register_transform_func (GST_TYPE_OBJECT, G_TYPE_STRING,
5815       gst_value_transform_object_string);
5816   g_value_register_transform_func (GST_TYPE_BITMASK, G_TYPE_UINT64,
5817       gst_value_transform_bitmask_uint64);
5818   g_value_register_transform_func (GST_TYPE_BITMASK, G_TYPE_STRING,
5819       gst_value_transform_bitmask_string);
5820   g_value_register_transform_func (G_TYPE_UINT64, GST_TYPE_BITMASK,
5821       gst_value_transform_uint64_bitmask);
5822   g_value_register_transform_func (G_TYPE_STRING, GST_TYPE_BITMASK,
5823       gst_value_transform_string_bitmask);
5824
5825   gst_value_register_intersect_func (G_TYPE_INT, GST_TYPE_INT_RANGE,
5826       gst_value_intersect_int_int_range);
5827   gst_value_register_intersect_func (GST_TYPE_INT_RANGE, GST_TYPE_INT_RANGE,
5828       gst_value_intersect_int_range_int_range);
5829   gst_value_register_intersect_func (G_TYPE_INT64, GST_TYPE_INT64_RANGE,
5830       gst_value_intersect_int64_int64_range);
5831   gst_value_register_intersect_func (GST_TYPE_INT64_RANGE, GST_TYPE_INT64_RANGE,
5832       gst_value_intersect_int64_range_int64_range);
5833   gst_value_register_intersect_func (G_TYPE_DOUBLE, GST_TYPE_DOUBLE_RANGE,
5834       gst_value_intersect_double_double_range);
5835   gst_value_register_intersect_func (GST_TYPE_DOUBLE_RANGE,
5836       GST_TYPE_DOUBLE_RANGE, gst_value_intersect_double_range_double_range);
5837   gst_value_register_intersect_func (GST_TYPE_ARRAY,
5838       GST_TYPE_ARRAY, gst_value_intersect_array);
5839   gst_value_register_intersect_func (GST_TYPE_FRACTION, GST_TYPE_FRACTION_RANGE,
5840       gst_value_intersect_fraction_fraction_range);
5841   gst_value_register_intersect_func (GST_TYPE_FRACTION_RANGE,
5842       GST_TYPE_FRACTION_RANGE,
5843       gst_value_intersect_fraction_range_fraction_range);
5844   gst_value_register_intersect_func (GST_TYPE_BITMASK,
5845       GST_TYPE_BITMASK, gst_value_intersect_bitmask_bitmask);
5846
5847   gst_value_register_subtract_func (G_TYPE_INT, GST_TYPE_INT_RANGE,
5848       gst_value_subtract_int_int_range);
5849   gst_value_register_subtract_func (GST_TYPE_INT_RANGE, G_TYPE_INT,
5850       gst_value_subtract_int_range_int);
5851   gst_value_register_subtract_func (GST_TYPE_INT_RANGE, GST_TYPE_INT_RANGE,
5852       gst_value_subtract_int_range_int_range);
5853   gst_value_register_subtract_func (G_TYPE_INT64, GST_TYPE_INT64_RANGE,
5854       gst_value_subtract_int64_int64_range);
5855   gst_value_register_subtract_func (GST_TYPE_INT64_RANGE, G_TYPE_INT64,
5856       gst_value_subtract_int64_range_int64);
5857   gst_value_register_subtract_func (GST_TYPE_INT64_RANGE, GST_TYPE_INT64_RANGE,
5858       gst_value_subtract_int64_range_int64_range);
5859   gst_value_register_subtract_func (G_TYPE_DOUBLE, GST_TYPE_DOUBLE_RANGE,
5860       gst_value_subtract_double_double_range);
5861   gst_value_register_subtract_func (GST_TYPE_DOUBLE_RANGE, G_TYPE_DOUBLE,
5862       gst_value_subtract_double_range_double);
5863   gst_value_register_subtract_func (GST_TYPE_DOUBLE_RANGE,
5864       GST_TYPE_DOUBLE_RANGE, gst_value_subtract_double_range_double_range);
5865   gst_value_register_subtract_func (GST_TYPE_FRACTION, GST_TYPE_FRACTION_RANGE,
5866       gst_value_subtract_fraction_fraction_range);
5867   gst_value_register_subtract_func (GST_TYPE_FRACTION_RANGE, GST_TYPE_FRACTION,
5868       gst_value_subtract_fraction_range_fraction);
5869   gst_value_register_subtract_func (GST_TYPE_FRACTION_RANGE,
5870       GST_TYPE_FRACTION_RANGE,
5871       gst_value_subtract_fraction_range_fraction_range);
5872   gst_value_register_subtract_func (GST_TYPE_BITMASK,
5873       GST_TYPE_BITMASK, gst_value_subtract_bitmask_bitmask);
5874
5875   /* see bug #317246, #64994, #65041 */
5876   {
5877     volatile GType date_type = G_TYPE_DATE;
5878
5879     g_type_name (date_type);
5880   }
5881
5882   gst_value_register_union_func (G_TYPE_INT, GST_TYPE_INT_RANGE,
5883       gst_value_union_int_int_range);
5884   gst_value_register_union_func (GST_TYPE_INT_RANGE, GST_TYPE_INT_RANGE,
5885       gst_value_union_int_range_int_range);
5886   gst_value_register_union_func (GST_TYPE_BITMASK,
5887       GST_TYPE_BITMASK, gst_value_union_bitmask_bitmask);
5888
5889 #if 0
5890   /* Implement these if needed */
5891   gst_value_register_union_func (GST_TYPE_FRACTION, GST_TYPE_FRACTION_RANGE,
5892       gst_value_union_fraction_fraction_range);
5893   gst_value_register_union_func (GST_TYPE_FRACTION_RANGE,
5894       GST_TYPE_FRACTION_RANGE, gst_value_union_fraction_range_fraction_range);
5895 #endif
5896 }