Merge branch 'master' into 0.11
[platform/upstream/gstreamer.git] / docs / random / porting-to-0.11.txt
1 The 0.11 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 0.11.
6
7 * multifdsink, tcpclientsink, tcpclientsrc, tcpserversrc the protocol property
8   is removed, use gdppay and gdpdepay.
9
10 * GstObject:
11     GST_OBJECT_DISPOSING flag removed
12     GST_OBJECT_IS_DISPOSING removed
13     GST_OBJECT_FLOATING flag remove, GstObject is now GInitiallyUnowned
14     GST_OBJECT_IS_FLOATING removed, use g_object_is_floating()
15
16     GST_CLASS_GET_LOCK, GST_CLASS_LOCK, GST_CLASS_TRYLOCK, GST_CLASS_UNLOCK,
17     used to be a workaround for thread-unsafe glib < 2.8
18
19     gst_object_ref_sink() has gpointer as result to make it more like the
20     GObject version.
21
22     gst_object_sink() removed, use gst_object_ref_sink() instead.
23
24     gst_class_signal_connect() removed, was only used for XML
25
26     parent-set and parent-unset signals removed. Use notify:parent. Currently
27     still disabled because of deep notify locking issues.
28
29 * GstElement:
30     GstElementDetails is removed and replaced with more generic metadata.
31
32     gst_element_class_set_details_simple() -> gst_element_class_set_metadata()
33     gst_element_class_set_documentation_uri -> gst_element_class_add_metadata
34     gst_element_class_set_icon_name -> gst_element_class_add_metadata
35
36     gst_element_factory_get_longname -> gst_element_factory_get_metadata
37     gst_element_factory_get_klass -> gst_element_factory_get_metadata
38     gst_element_factory_get_description -> gst_element_factory_get_metadata
39     gst_element_factory_get_author -> gst_element_factory_get_metadata
40     gst_element_factory_get_documentation_uri -> gst_element_factory_get_metadata
41     gst_element_factory_get_icon_name -> gst_element_factory_get_metadata
42
43     gstelementmetadata.h contains the keys for all standard metadata.
44
45 * GstPad:
46     gst_pad_get_caps() does not return writable caps anymore and an explicit
47     gst_caps_make_writable() needs to be performed. This was the functionality
48     of gst_pad_get_caps_reffed(), which is removed now.
49
50     A similar change was done for gst_pad_peer_get_caps() and
51     gst_pad_peer_get_caps_reffed()
52