Introduce gst_element_request_pad_simple
authorFrançois Laignel <fengalin@free.fr>
Thu, 22 Apr 2021 15:53:44 +0000 (17:53 +0200)
committerFrançois Laignel <fengalin@free.fr>
Tue, 4 May 2021 13:49:32 +0000 (15:49 +0200)
commit1a8dfdfc54c55f9a431c86847f94b7052d6b6842
tree6adbabc96265d739fd2e2baca7c76e03d402ff42
parent77ab7b42b382d07982ca8df464e82949dd749612
Introduce gst_element_request_pad_simple

The name `gst_element_get_request_pad()` is confusing to people
learning GStreamer. `gst_element_request_pad_simple()` aims at
providing the exact same functionality, while making it more
explicit it is a simplified `gst_element_request_pad()`.

`gst_element_request_pad_simple()` is consistent with other
functions such as `gst_element_seek_simple`.

This commit deprecates `gst_element_get_request_pad()` so that a
compilation warning is emitted when used and incite developers
to use the more explicit `gst_element_request_pad_simple()`.

See also https://gitlab.freedesktop.org/gstreamer/gstreamer-rs/-/merge_requests/743#note_886586

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/802>
16 files changed:
gst/gstelement.c
gst/gstelement.h
gst/gstpadtemplate.c
gst/gstutils.c
libs/gst/check/gstcheck.c
libs/gst/check/gstharness.c
tests/check/elements/concat.c
tests/check/elements/funnel.c
tests/check/elements/multiqueue.c
tests/check/elements/selector.c
tests/check/elements/tee.c
tests/check/gst/gstelement.c
tests/check/gst/gstutils.c
tests/check/libs/aggregator.c
tests/check/libs/collectpads.c
tests/examples/streamiddemux/streamiddemux-stream.c