mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-27 04:01:08 +00:00
Code Issues 1 Projects Releases Wiki Activity

docs: update porting-to-0.11 document with a "soft" API changes checklist

Browse source 
Point out some API changes that the compiler won't
be able to warn about.
This commit is contained in:
Tim-Philipp Müller 2012-08-02 13:19:27 +01:00
parent f938cf9257
commit 31eb27aa16
1 changed files with 44 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

45
docs/random/porting-to-0.11.txt
View file

@ -4,6 +4,12 @@ The 0.11 porting guide
* All deprecated methods were removed. Recompile against 0.10 with
DISABLE_DEPRECATED and fix issues before attempting to port to 0.11.
* API changes are usually easy to spot, because the compiler will
generate a warning, at least if number of arguments or types differ
* Other changes are a bit more subtle. See checklist at the bottom
for some "soft" changes which the compiler will not warn about.
* GST_BOILERPLATE is gone, use G_DEFINE_TYPE instead.
* various methods take a gsize instead of a guint when talking about memory
@ -555,8 +561,45 @@ The 0.11 porting guide
GstGError -> GError
GST_TYPE_G_ERROR / gst_g_error_get_type() -> G_TYPE_ERROR
* "codec-data" and "streamheader" field in GstCaps
* "codec-data" and "streamheader" field in GstCaps (not implemented yet!)
codec-data and stream headers are no longer in GstCaps, but sent as
part of a STREAM CONFIG event (which should be sent after the initial
CAPS event if needed).
=============================================================================
Porting checklist - "soft" API changes
=============================================================================
* the "ffmpegcolorspace" element has been replaced by "videoconvert"
* "playbin2" has been renamed to "playbin", with similar API
* "decodebin2" has been renamed to "decodebin", with similar API. Note
that there is no longer a "new-decoded-pad" signal, just use GstElement's
"pad-added" signal instead (but don't forget to remove the 'gboolean last'
argument from your old signal callback functino signature).
* the names of some "formatted" pad templates has been changed from e.g.
"src%d" to "src%u" or "src_%u" or similar, since we don't want to see
negative numbers in pad names. This mostly affects applications that
create request pads from elements.
* some elements that used to have a single dynamic source pad have a
static source pad now. Example: wavparse, id3demux, apedemux. (This
does not affect applications using decodebin or playbin)
* the name of the GstXOverlay "prepare-xwindow-id" message has changed
to "prepare-window-handle" (and GstXOverlay has been renamed to
GstVideoOverlay). Code that checks for the string directly should be
changed to use gst_is_video_overlay_prepare_window_handle_message(message)
instead.
* playbin now proxies the GstVideoOverlay (former GstXOverlay) interface,
so most applications can just remove the sync bus handler where they
would set the window ID, and instead just set the window ID on playbin
from the application thread before starting playback.
* playbin also proxies the GstColorBalance and GstNavigation interfaces,
so applications that use this don't need to go fishing for elements
that may implement those any more, but can just use them unconditionally.