docs/random/porting-to-1.0.txt

   1 GStreamer 0.10 to 1.0 porting guide
   2 -----------------------------------
   3
   4 * All deprecated methods were removed. Recompile against 0.10 with
   5   DISABLE_DEPRECATED and fix issues before attempting to port to 1.0.
   6
   7 * API changes are usually easy to spot, because the compiler will
   8   generate a warning, at least if number of arguments or types differ
   9
  10 * Other changes are a bit more subtle. See checklist at the bottom
  11   for some "soft" changes which the compiler will not warn about.
  12
  13 * GST_BOILERPLATE is gone, use G_DEFINE_TYPE instead.
  14
  15 * various methods take a gsize instead of a guint when talking about memory
  16   sizes.
  17
  18 * multifdsink, tcpclientsink, tcpclientsrc, tcpserversrc the protocol property
  19   is removed, use gdppay and gdpdepay.
  20
  21 * Presets and plugins moved to $XDG_DATA_HOME/gstreamer-1.0/ root
  22   directory. Registry moved to $XDG_CACHE_HOME/gstreamer-1.0/.
  23   XDG_CACHE_HOME usually points to $HOME/.cache and XDG_DATA_HOME
  24   usually is $HOME/.local/share/.
  25
  26 * GstObject:
  27     GST_OBJECT_DISPOSING flag removed
  28     GST_OBJECT_IS_DISPOSING removed
  29     GST_OBJECT_FLOATING flag remove, GstObject is now GInitiallyUnowned
  30     GST_OBJECT_IS_FLOATING removed, use g_object_is_floating()
  31
  32     GST_CLASS_GET_LOCK, GST_CLASS_LOCK, GST_CLASS_TRYLOCK, GST_CLASS_UNLOCK,
  33     used to be a workaround for thread-unsafe glib < 2.8
  34
  35     gst_object_ref_sink() has gpointer as result to make it more like the
  36     GObject version.
  37
  38     gst_object_sink() removed, use gst_object_ref_sink() instead.
  39
  40     gst_class_signal_connect() removed, was only used for XML
  41
  42     parent-set and parent-unset signals removed. Use notify:parent. Currently
  43     still disabled because of deep notify locking issues.
  44
  45 * GstElement:
  46     GstElementDetails is removed and replaced with more generic metadata.
  47
  48     gst_element_class_set_details_simple() -> gst_element_class_set_metadata()
  49     gst_element_class_set_documentation_uri -> gst_element_class_add_metadata
  50     gst_element_class_set_icon_name -> gst_element_class_add_metadata
  51     also gst_element_class_get_metadata()
  52
  53     gst_element_factory_get_longname -> gst_element_factory_get_metadata
  54     gst_element_factory_get_klass -> gst_element_factory_get_metadata
  55     gst_element_factory_get_description -> gst_element_factory_get_metadata
  56     gst_element_factory_get_author -> gst_element_factory_get_metadata
  57     gst_element_factory_get_documentation_uri -> gst_element_factory_get_metadata
  58     gst_element_factory_get_icon_name -> gst_element_factory_get_metadata
  59
  60     gstelementmetadata.h contains the keys for all standard metadata.
  61
  62     gst_element_factory_can_{src,sink}_caps() => gst_element_factory_can_{src,sink}_{any,all}_caps()
  63
  64     Element metadata and pad templates are inherited from parent classes and
  65     should be added in class_init instead of base_init.
  66
  67     gst_element_class_add_pad_template() takes ownership of the template
  68
  69     gst_element_class_add_static_pad_template (element_class, &src_template)
  70       => gst_element_class_add_pad_template (element_class,
  71              gst_static_pad_template_get (&src_template));
  72
  73     Elements that change the duration must post DURATION messages on the
  74     bus when the duration changes in PAUSED or PLAYING.
  75
  76     gst_element_lost_state_full() -> gst_element_lost_state()
  77     gst_element_lost_state() -> gst_element_lost_state(, TRUE)
  78
  79     request_new_pad_full() -> request_new_pad()
  80
  81     gst_element_found_tags() and gst_element_found_tags_for_pad() are gone, just
  82     push the tag event.
  83
  84 * GstPad:
  85     gst_pad_get_caps() was replaced by gst_pad_query_caps(), it
  86     does not return writable caps anymore and an explicit
  87     gst_caps_make_writable() needs to be performed. This was the functionality
  88     of gst_pad_get_caps_reffed(), which is removed now.
  89
  90     A similar change was done for gst_pad_peer_get_caps() and
  91     gst_pad_peer_get_caps_reffed()
  92
  93     gst_pad_set_bufferalloc_function(), gst_pad_alloc_buffer() and
  94     gst_pad_alloc_buffer_and_set_caps() are removed. Use the ALLOCATION query
  95     now when negotiating formats to obtain a reference to a bufferpool object
  96     that can be used to allocate buffers using gst_buffer_pool_acquire_buffer().
  97
  98     gst_pad_set_setcaps_function() => GST_EVENT_CAPS in event handler
  99
 100     gst_pad_set_getcaps_function() => GST_QUERY_CAPS in query handler
 101
 102     gst_pad_set_acceptcaps_function() => GST_QUERY_ACCEPT_CAPS in query handler
 103
 104     removed sched_private, it should not be used, use g_object_set_qdata() or
 105     use element_private.
 106
 107     Removed GST_PAD_CAPS() use gst_pad_get_current_caps() to get a handle to the
 108     currently configured caps.
 109
 110     gst_pad_get_pad_template_caps() and gst_pad_get_pad_template()
 111     return a new reference of the caps or template now and the return
 112     value needs to be unreffed after usage.
 113
 114     gst_pad_set_caps() now pushes a CAPS event for backward compatibility.
 115     Consider sending the CAPS event yourself. It is not possible anymore to set
 116     NULL caps.
 117
 118     gst_pad_set_checkgetrange_function() and gst_pad_check_pull_range() are
 119     gone, use the SCHEDULING query now.
 120
 121     gst_pad_set_blocked(), gst_pad_set_blocked_async(),
 122     gst_pad_set_blocked_async_full() are removed, use the gst_pad_add_probe()
 123     method with the GST_PAD_PROBE_TYPE_BLOCK to get the same result as the async
 124     blocking version. There is no more sync version of blocking, this is in
 125     general dangerous and can be implemented using the callbacks if needed.
 126
 127     gst_pad_add_data_probe(), gst_pad_add_data_probe_full(),
 128     gst_pad_remove_data_probe(), gst_pad_add_event_probe(),
 129     gst_pad_add_event_probe_full(), gst_pad_remove_event_probe(),
 130     gst_pad_add_buffer_probe(), gst_pad_add_buffer_probe_full(),
 131     gst_pad_remove_buffer_probe() are removed. Use gst_pad_add_probe() and
 132     gst_pad_remove_probe() for equivalent functionality.
 133
 134     The have-data signal was removed from pads, it was never supposed to be used
 135     without calling the _add_.*_probe() methods.
 136
 137     The request-link signal was removed. It was never used.
 138
 139     gst_pad_get_negotiated_caps() -> gst_pad_get_current_caps()
 140
 141     GST_FLOW_UNEXPECTED -> GST_FLOW_EOS
 142
 143     GST_FLOW_WRONG_STATE -> GST_FLOW_FLUSHING
 144
 145     GstActivateMode -> GstPadMode, GST_ACTIVATE_* -> GST_PAD_MODE_*
 146
 147     The GstPadAcceptCapsFunction was removed and replaced with a
 148     GST_QUERY_ACCEPT_CAPS query.
 149
 150     The GstPadFixateCapsFunction was removed. It has no replacement, you can
 151     simply do the fixation in the element or use a vmethod from the base class
 152     if appropriate.
 153
 154     The GstPadGetCapsFunction was removed and replaced with a GST_QUERY_CAPS
 155     query. The query takes a GstCaps* parameter to inform the other side about
 156     the possible caps and preferences.
 157
 158     gst_pad_proxy_getcaps() -> gst_pad_proxy_query_caps()
 159     gst_pad_get_caps() -> gst_pad_query_caps()
 160     gst_pad_peer_get_caps() -> gst_pad_peer_query_caps()
 161     gst_pad_accept_caps() -> gst_pad_query_accept_caps()
 162     gst_pad_peer_accept_caps() -> gst_pad_peer_query_accept_caps()
 163     gst_pad_query_peer_*() -> gst_pad_peer_query_*()
 164
 165     GstPadFlags: GST_PAD_* -> GST_PAD_FLAG_*
 166
 167 * GstPadTemplate
 168     gst_pad_template_get_caps() returns a new reference of the caps
 169     and the return value needs to be unreffed after usage.
 170
 171     gst_pad_template_new() does not take ownership of the caps anymore.
 172
 173     GstPadTemplate is now created with a floating ref and
 174     gst_element_class_add_pad_template() takes ownership of this floating ref.
 175
 176     GstPadTemplate instances are considered immutable and must not be
 177     changed.
 178
 179 * GstMiniObject
 180     A miniobject is now a simple refcounted structure holding the information
 181     common to buffers, events, messages, queries and caps.
 182
 183     There is no more GST_TYPE_MINIOBJECT as the type for subclasses.
 184     G_TYPE_BOXED can be used as the type of all GstMiniObject based types such
 185     as buffers, events, messages, caps, etc. Signals, for example, would use the
 186     boxed type if the argument include GstMiniObject derived types.
 187
 188     gst_mini_object_new() is removed. You would allocate memory with the the
 189     methods specific for the derived type.
 190
 191     GstParamSpecMiniObject is removed, use boxed param spec now with the GType
 192     of the specific GstMiniObject derived type. Also
 193     gst_param_spec_mini_object().
 194
 195     gst_param_spec_mini_object() -> g_param_spec_boxed()
 196
 197     The specific gst_value_*_mini_object() methods are removed, used the generic
 198     boxed methods instead.
 199
 200     gst_value_set_mini_object() -> g_value_set_boxed()
 201     gst_value_take_mini_object() -> g_value_take_boxed()
 202     gst_value_take_get_object() -> g_value_get_boxed()
 203     gst_value_take_dup_object() -> g_value_dup_boxed()
 204
 205     GST_VALUE_HOLDS_MINI_OBJECT() was removed, use G_VALUE_HOLDS_BOXED() or
 206     type-specific GST_VALUE_HOLDS_{BUFFER,CAPS,etc.}() instead.
 207
 208     The GST_MINI_OBJECT_READONLY flag was removed as it used to mark the
 209     memory in buffers as READONLY. Marking memory READONLY can now be done
 210     with the GstMemory API. Writability of miniobjects is now only done by using
 211     the refcount.
 212
 213 * GstBuffer
 214     A GstBuffer is now a simple boxed type this means that subclassing is not
 215     possible anymore.
 216
 217     To add data to the buffer you would now use gst_buffer_insert_memory() with
 218     a GstMemory object containing the data. Multiple memory blocks can added to
 219     a GstBuffer that can then be retrieved with gst_buffer_peek_memory().
 220
 221     GST_BUFFER_DATA(), GST_BUFFER_MALLOCDATA(), GST_BUFFER_FREE_FUNC() and
 222     GST_BUFFER_SIZE() are gone, along with the fields in GstBuffer. Use the
 223     memory API to get access to the buffer data. GST_BUFFER_SIZE() can be
 224     replaced with gst_buffer_get_size() but if also access to the data is
 225     required, gst_buffer_map() can return both the size and data in one go.
 226
 227     The most common way to access all the data in a buffer is by using
 228     gst_buffer_map() and gst_buffer_unmap(). These calls require you to specify
 229     the access mode required to the data and will automatically merge and return
 230     a writable copy of the data.
 231
 232     The buffer must be writable (gst_buffer_is_writable()) in order to modify
 233     the fields, metadata or buffer memory. gst_buffer_make_writable() will not
 234     automatically make a writable copy of the memory but will instead increase
 235     the refcount of the memory. The _map() and _peek_memory() methods will
 236     automatically create writable copies when needed.
 237
 238     gst_buffer_make_metadata_writable() is gone, you can replace this safely
 239     with gst_buffer_make_writable().
 240
 241     gst_buffer_copy_metadata() is gone, use gst_buffer_copy_into() instead and
 242     mind use GST_BUFFER_COPY_METADATA instead of the former GST_BUFFER_COPY_ALL.
 243
 244     gst_buffer_create_sub() is gone and can be safely replaced with
 245     gst_buffer_copy_region().
 246
 247     Changing the size of the buffer data can be done with gst_buffer_resize(),
 248     which will also update the metadata fields correctly. gst_buffer_set_size()
 249     is #defined to a special case of gst_buffer_resize() with a 0 offset.
 250
 251     gst_buffer_try_new_and_alloc() is replaced with gst_buffer_new_and_alloc(),
 252     which now returns NULL when memory allocation fails.
 253
 254     GST_BUFFER_CAPS() is gone, caps are not set on buffers anymore but are set
 255     on the pads where the buffer is pushed on. Likewise GST_BUFFER_COPY_CAPS is
 256     not needed anymore. gst_buffer_get/set_caps() are gone too.
 257
 258     GST_BUFFER_TIMESTAMP is gone, use GST_BUFFER_PTS or GST_BUFFER_DTS instead.
 259     Likewise GST_BUFFER_TIMESTAMP_IS_VALID() was changed to
 260     GST_BUFFER_PTS_IS_VALID and GST_BUFFER_DTS_IS_VALID
 261
 262     gst_buffer_join() was renamed to gst_buffer_append() and the memory is not
 263     directly merged but appended.
 264
 265     gst_buffer_merge() was removed, it is the same as gst_buffer_join() but
 266     without taking ownership of the arguments. Caller code should ref themselves
 267     when needed. Note that the extra refs might force slower paths in
 268     gst_buffer_join().
 269
 270     gst_buffer_is_span() and gst_buffer_span() are removed, use
 271     gst_buffer_merge() and gst_buffer_resize() for the same effect. Merging and
 272     spanning is delayed until the buffer is mapped and in some cases no merging
 273     of memory is needed at all when the element can deal with individual memory
 274     chunks.
 275
 276 * GstBufferList
 277     The GstBufferList object is much simplified because most of the
 278     functionality in the groups is now part of the GstMemory in buffers.
 279
 280     The object is reduced to encapsulating an array of buffers that you can send
 281     with the regular gst_pad_push_list. The iterator is not needed anymore
 282     because you can simply use gst_buffer_list_length() and gst_buffer_list_get()
 283     to iterate the array.
 284
 285     For dealing with the groups, it's now needed to add the memory blocks to
 286     GstBuffer and use the normal buffer API to get and merge the groups.
 287
 288     gst_buffer_list_sized_new() -> gst_buffer_list_new_sized()
 289     gst_buffer_list_len() -> gst_buffer_list_length()
 290
 291 * GstStructure
 292
 293     The GArray of the structure fields are moved to private part and are not
 294     accessible from the application anymore. Use the methods to retrieve and
 295     modify fields from the array.
 296
 297     gst_structure_empty_new() -> gst_structure_new_empty()
 298     gst_structure_id_empty_new() -> gst_structure_new_id_empty()
 299     gst_structure_id_new() -> gst_structure_new_id()
 300
 301 * GstEvent
 302     Boxed types derived from GstMiniObject.
 303
 304     GST_EVENT_SRC is removed. Don't use this anymore.
 305
 306     gst_event_new_qos_full() -> gst_event_new_qos()
 307     gst_event_parse_qos_full() -> gst_event_parse_qos()
 308
 309     The GstStructure is removed from the public API, use the getters to get
 310     a handle to a GstStructure.
 311
 312     GST_EVENT_NEWSEGMENT -> GST_EVENT_SEGMENT
 313
 314     gst_event_new_new_segment () -> gst_event_new_segment() and it takes a
 315     GstSegment structure as an argument.
 316     gst_event_parse_new_segment() -> gst_event_parse_segment() to retrieve the
 317     GstSegment structure from the event.
 318     gst_event_copy_segment() to fill a GstSegment structure.
 319
 320 * GstQuery
 321     Boxed types derived from GstMiniObject.
 322
 323     The GstStructure is removed from the public API, use the getters to get
 324     a handle to a GstStructure.
 325
 326     gst_query_new_application() -> gst_query_new_custom()
 327
 328     gst_query_parse_formats_length() -> gst_query_parse_n_formats()
 329     gst_query_parse_formats_nth() -> gst_query_parse_nth_format()
 330
 331     Some query utility functions no longer use an inout parameter for the
 332     destination/query format:
 333
 334       - gst_pad_query_position()
 335       - gst_pad_query_duration()
 336       - gst_pad_query_convert()
 337       - gst_pad_query_peer_position()
 338       - gst_pad_query_peer_duration()
 339       - gst_pad_query_peer_convert()
 340       - gst_element_query_position()
 341       - gst_element_query_duration()
 342       - gst_element_query_convert()
 343
 344     gst_element_get_query_types() and gst_pad_get_query_types() with associated
 345     functions were removed.
 346
 347 * GstBufferList
 348     Is now a boxed type derived from GstMiniObject.
 349
 350 * GstMessage
 351     Is now a boxed type derived from GstMiniObject
 352
 353     The GstStructure is removed from the public API, use the getters to get
 354     a handle to a GstStructure.
 355
 356     GST_MESSAGE_DURATION -> GST_MESSAGE_DURATION_CHANGED
 357
 358     gst_message_parse_duration() was removed (not needed any longer, do
 359     a duration query to query the updated duration)
 360
 361 * GstCaps
 362     Is now a boxed type derived from GstMiniObject.
 363
 364     GST_VIDEO_CAPS_xxx -> GST_VIDEO_CAPS_MAKE(xxx)
 365
 366     Some caps functions now take ownership of the input argument, for
 367     efficiency reasons (to avoid unnecessary copies to make them writable):
 368
 369       gst_caps_normalize (caps)          =>   caps = gst_caps_normalize (caps)
 370       gst_caps_do_simplify (caps)        =>   caps = gst_caps_simplify (caps)
 371       gst_caps_merge (caps,caps2)        =>   caps = gst_caps_merge (caps,caps2)
 372       gst_caps_merge_structure (caps,st) =>   caps = gst_caps_merge_structure (caps,st)
 373       gst_caps_truncate (caps)           =>   caps = gst_caps_truncate (caps)
 374
 375     The compiler should warn about unused return values from these functions,
 376     which may help find the places that need to be updated.
 377
 378     Removed functions:
 379
 380       gst_caps_union() -> gst_caps_merge():  Be careful because _merge takes
 381                  ownership of the arguments.
 382
 383 * GstClock
 384     gst_clock_id_wait_async_full() was renamed to gst_clock_id_wait_async() and
 385     the old gst_clock_id_wait_async() function was removed.
 386
 387 * GstSegment
 388     abs_rate was removed from the public fields, it can be trivially calculated
 389     from the rate field.
 390
 391     accum was renamed to base. last_stop was renamed to position.
 392
 393     The segment info now contains all the information needed to convert buffer
 394     timestamps to running_time and stream_time. There is no more segment
 395     accumulation, the GstSegment is completely self contained.
 396
 397     gst_segment_set_duration() and gst_segment_set_last_stop() are removed,
 398     simply modify the structure members duration and position respectively.
 399
 400     gst_segment_set_newsegment() is removed, it was used to accumulate segments
 401     and is not needed anymore, use gst_segment_copy_into() or modify the segment
 402     values directly.
 403
 404     gst_segment_set_seek() -> gst_segment_do_seek(). Updates the segment values
 405     with seek parameters.
 406
 407 * GstPluginFeature
 408     GST_PLUGIN_FEATURE_NAME() was removed, use GST_OBJECT_NAME() instead.
 409
 410 * GstTypeFind
 411     gst_type_find_peek() returns a const guint8 * now.
 412
 413 * GstTask
 414     gst_task_create() -> gst_task_new()
 415
 416 * GstAdapter
 417     gst_adapter_peek() is removed, use gst_adapter_map() and gst_adapter_unmap()
 418     to get access to raw data from the adapter.
 419
 420     Arguments changed from guint to gsize.
 421
 422     gst_adapter_prev_timestamp() is removed and should be replaced with
 423     gst_adapter_prev_pts() and gst_adapter_prev_dts().
 424
 425 * GstBitReader, GstByteReader, GstByteWriter
 426     gst_*_reader_new_from_buffer(), gst_*_reader_init_from_buffer() removed, get
 427     access to the buffer data with _map() and then use the _new() functions.
 428
 429     gst_byte_reader_new_from_buffer() and gst_byte_reader_init_from_buffer()
 430     removed, get access to the buffer data and then use the _new() functions.
 431
 432 * GstCollectPads
 433     gst_collect_pads_read() removed, use _read_buffer() or _take_buffer() and
 434     then use the memory API to get to the memory.
 435
 436 * GstBaseSrc, GstBaseTransform, GstBaseSink
 437     GstBaseSrc::get_caps(), GstBaseTransform::transform_caps() and
 438     GstBaseSink::get_caps() now take a filter GstCaps* parameter to
 439     filter the caps and allow better negotiation decisions.
 440
 441 * GstBaseTransform
 442     GstBaseTransform::transform_caps() now gets the complete caps passed
 443     instead of getting it passed structure by structure.
 444
 445     GstBaseTransform::event() was renamed to sink_event(). The old function
 446     uses the return value to determine if the event should be forwarded or not.
 447     The new function has a default implementation that always forwards the event
 448     and the return value is simply returned as a result from the event handler.
 449     The semantics of the sink_event are thus the same as those for the src_event
 450     function.
 451
 452 * GstImplementsInterface
 453     has been removed. Interfaces need to be updated to either have
 454     is_ready/usable/available() methods, or have GError arguments
 455     to their methods so we can return an appropriate error if a
 456     particular interface isn't supported for a particular device.
 457
 458 * GstIterator
 459     uses a GValue based API now that is similar to the 0.10 API but
 460     allows bindings to properly use GstIterator and prevents complex
 461     return value ownership issues.
 462
 463 * GstNavigationInterface
 464     Now part of the video library in gst-plugins-base, and the interfaces
 465     library no longer exists.
 466
 467 * GstMixerInterface / GstTunerInterface
 468     Removed - no replacement?
 469
 470 * GstXOverlay interface
 471     Renamed to GstVideoOverlay, and now part of the video library in
 472     gst-plugins-base, as the interfaces library no longer exists.
 473
 474 * GstPropertyProbe interface
 475     Removed - no replacement yet, but a more featureful replacement
 476     for device discovery and feature querying is planned, see
 477     https://bugzilla.gnome.org/show_bug.cgi?id=678402
 478
 479 * GstURIHandler
 480     gst_uri_handler_get_uri() and the get_uri vfunc now return a copy of
 481     the URI string
 482
 483     gst_uri_handler_set_uri() and the set_uri vfunc now take an additional
 484     GError argument so the handler can notify the caller why it didn't
 485     accept a particular URI.
 486
 487     gst_uri_handler_set_uri() now checks if the protocol of the URI passed
 488     is one of the protocols advertised by the uri handler, so set_uri vfunc
 489     implementations no longer need to check that as well.
 490
 491 * GstTagList
 492     is now an opaque mini object instead of being typedefed to a GstStructure.
 493
 494     While it was previously okay (and in some cases required because of
 495     missing taglist API) to cast a GstTagList to a GstStructure or use
 496     gst_structure_* API on taglists, you can no longer do that. Doing so will
 497     cause crashes.
 498
 499     Also, tag lists are refcounted now, and can therefore not be freely
 500     modified any longer. Make sure to call
 501
 502       taglist = gst_tag_list_make_writable (taglist);
 503
 504     before adding, removing or changing tags in the taglist.
 505
 506     gst_tag_list_new() has been renamed to gst_tag_list_new_empty().
 507     gst_tag_list_new_full*() have been renamed to gst_tag_list_new*().
 508     gst_tag_list_free() has been replaced by gst_tag_list_unref().
 509
 510     GST_TAG_IMAGE, GST_TAG_PREVIEW_IMAGE, GST_TAG_ATTACHMENT: many tags that
 511     used to be of type GstBuffer are now of type GstSample (which is basically
 512     a struct containing a buffer alongside caps and some other info).
 513
 514     gst_tag_list_get_buffer() => gst_tag_list_get_sample()
 515
 516     gst_is_tag_list() => GST_IS_TAG_LIST ()
 517
 518 * GstController:
 519     has now been merged into GstObject. It does not exists as a individual
 520     object anymore. In addition core contains a GstControlSource base class and
 521     the GstControlBinding. The actual control sources are in the controller
 522     library as before. The 2nd big change is that control sources generate
 523     a sequence of gdouble values and those are mapped to the property type and
 524     value range by GstControlBindings.
 525
 526     For plugins the effect is that gst_controller_init() is gone and
 527     gst_object_sync_values() is taking a GstObject * instead of GObject *.
 528
 529     For applications the effect is larger. The whole gst_controller_* API is
 530     gone and now available in simplified form under gst_object_*. ControlSources
 531     are now attached via GstControlBinding to properties. There are no GValue
 532     arguments used anymore when programming control sources.
 533
 534     gst_controller_new* -> gst_object_set_control_source
 535     gst_controller_add_properties -> gst_object_set_control_source
 536     gst_controller_set_control_source -> gst_object_set_control_source
 537     gst_controller_get_control_source -> gst_object_get_control_source
 538
 539     gst_controller_set_property_disabled -> gst_object_set_controlled_property_disabled
 540
 541     gst_object_get_value_arrays has been removed. Loop over the controlled
 542     properties fetch the value array. Also GstValueArray is gone. The fields of
 543     GstValueArray are now passed directly to gst_object_get_value_array as
 544     arguments.
 545
 546     GstInterpolationControlSource has been split. There is a new
 547     GstTimedValueControlSource baseclass and 2 sub classes:
 548     GstInterpolationControlSource and GstTriggerControlSource. The API for setting
 549     and getting the timestamps is in GstTimedValueControlSource.
 550
 551     gst_interpolation_control_source_set_interpolation_mode() has been removed.
 552     Set the "mode" gobject property on the control-source instead. The possible
 553     enum values have been renamed from GST_INTERPOLATE_XXX to
 554     GST_INTERPOLATION_MODE_XXX.
 555
 556 * GstRegistry
 557
 558     gst_registry_get_default() -> gst_registry_get()
 559     gst_default_registry_*(...) -> gst_registry_*(gst_registry_get(), ...)
 560
 561 * GstValue
 562
 563     GST_TYPE_DATE -> G_TYPE_DATE
 564     GST_VALUE_HOLDS_DATE(value) -> G_VALUE_HOLDS(value,G_TYPE_DATE)
 565     gst_value_set_date() -> g_value_set_boxed()
 566     gst_value_get_date() -> g_value_get_boxed()
 567
 568 * GError/GstGError
 569
 570     GstGError -> GError
 571     GST_TYPE_G_ERROR / gst_g_error_get_type() -> G_TYPE_ERROR
 572
 573 * GstVideo
 574
 575     GstXOverlay interface -> renamed to GstVideoOverlay, and now part of
 576     the video library in gst-plugins-base, as the interfaces library
 577     no longer exists.
 578
 579     gst_video_format_parse_caps() -> use gst_video_info_from_caps() and
 580         then GstVideoInfo.
 581
 582 * GstChildProxy
 583
 584     gst_child_proxy_lookup() can no longer be called on GObjects that
 585     do not implement the GstChildProxy interface. Use
 586       g_object_class_find_property (G_OBJECT_GET_CLASS (obj), "foo")
 587     instead for non-childproxy objects.
 588
 589 * "codec-data" and "streamheader" field in GstCaps (not implemented yet!)
 590
 591     codec-data and stream headers are no longer in GstCaps, but sent as
 592     part of a STREAM CONFIG event (which should be sent after the initial
 593     CAPS event if needed).
 594
 595 =============================================================================
 596   Porting checklist - "soft" API changes
 597 =============================================================================
 598
 599  * the "ffmpegcolorspace" element has been replaced by "videoconvert"
 600
 601  * "playbin2" has been renamed to "playbin", with similar API
 602
 603  * "decodebin2" has been renamed to "decodebin", with similar API. Note
 604    that there is no longer a "new-decoded-pad" signal, just use GstElement's
 605    "pad-added" signal instead (but don't forget to remove the 'gboolean last'
 606    argument from your old signal callback functino signature).
 607
 608  * the names of some "formatted" pad templates has been changed from e.g.
 609    "src%d" to "src%u" or "src_%u" or similar, since we don't want to see
 610    negative numbers in pad names. This mostly affects applications that
 611    create request pads from elements.
 612
 613  * some elements that used to have a single dynamic source pad have a
 614    static source pad now. Example: wavparse, id3demux, iceydemux, apedemux.
 615    (This does not affect applications using decodebin or playbin).
 616
 617  * the name of the GstXOverlay "prepare-xwindow-id" message has changed
 618    to "prepare-window-handle" (and GstXOverlay has been renamed to
 619    GstVideoOverlay). Code that checks for the string directly should be
 620    changed to use gst_is_video_overlay_prepare_window_handle_message(message)
 621    instead.
 622
 623  * playbin now proxies the GstVideoOverlay (former GstXOverlay) interface,
 624    so most applications can just remove the sync bus handler where they
 625    would set the window ID, and instead just set the window ID on playbin
 626    from the application thread before starting playback.
 627
 628  * playbin also proxies the GstColorBalance and GstNavigation interfaces,
 629    so applications that use this don't need to go fishing for elements
 630    that may implement those any more, but can just use them unconditionally.
 631
 632  * media type / caps changes:
 633
 634       audio/x-raw-int   -> audio/x-raw
 635       audio/x-raw-float -> audio/x-raw
 636
 637       video/x-raw-rgb   -> video/x-raw
 638       video/x-raw-yuv   -> video/x-raw
 639       video/x-raw-bayer -> video/x-bayer
 640
 641       video/x-dvd-subpicture -> subpicture/x-dvd
 642
 643       application/ogg  -> audio/ogg or video/ogg (or application/ogg)
 644
 645       video/x-matroska -> audio/x-matroska or video/x-matroska or video/x-matroska-3d
 646
 647       video/webm -> audio/webm or video/webm
 648