docs/random/porting-to-1.0.txt

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