mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-26 11:41:09 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/subprojects/gst-plugins-bad/gst-libs/gst/wayland/gstwlbuffer.h

60 lines
1.7 KiB
C
Raw Normal View History

gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
/* GStreamer Wayland Library
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
*
* Copyright (C) 2014 Collabora Ltd.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301 USA.
*/
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
#pragma once
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
#include <gst/wayland/wayland.h>
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
G_BEGIN_DECLS
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
#define GST_TYPE_WL_BUFFER gst_wl_buffer_get_type ()
wayland: Export the _get_type() functions Add the macro before the declaration so the types are properly exported, this makes it possible to do dynamic casting and checks. Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/3858>
2023-01-27 20:40:21 +00:00
GST_WL_API
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
G_DECLARE_FINAL_TYPE (GstWlBuffer, gst_wl_buffer, GST, WL_BUFFER, GObject);
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
struct _GstWlBuffer
{
GObject parent_instance;
};
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
GST_WL_API
waylandsink: stack the video subsurface into another subsurface that covers the whole render rectangle The main reason behind this is that when the video caps change and the video subsurface needs to resize and change position, the wl_subsurface.set_position call needs a commit in its parent in order to take effect. Previously, the parent was the application's surface, over which there is no control. Now, the parent is inside the sink, so we can commit it and change size smoothly. As a side effect, this also allows the sink to draw its black borders on its own, without the need for the application to do that. And another side effect is that this can now allow resizing the sink when it is in top-level mode and have it respect the aspect ratio.
2014-07-01 08:43:20 +00:00
GstWlBuffer * gst_buffer_add_wl_buffer (GstBuffer * gstbuffer,
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
struct wl_buffer * wlbuffer, GstWlDisplay * display);
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
GST_WL_API
waylandsink: Keep per display wayland buffer caches Instead of attaching a single wayland wl_buffer to each GStBuffer as qdata, keep a separate cache for each display. A unique wl_buffer and associated metadata is created for each display. This allows for sharing of GstBuffer objects between multiple displays, such as when using tee elements. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1401>
2020-07-08 10:06:38 +00:00
GstWlBuffer * gst_buffer_get_wl_buffer (GstWlDisplay * display, GstBuffer * gstbuffer);
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
GST_WL_API
waylandsink: Keep per display wayland buffer caches Instead of attaching a single wayland wl_buffer to each GStBuffer as qdata, keep a separate cache for each display. A unique wl_buffer and associated metadata is created for each display. This allows for sharing of GstBuffer objects between multiple displays, such as when using tee elements. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/1401>
2020-07-08 10:06:38 +00:00
void gst_wl_buffer_force_release_and_unref (GstBuffer *buf, GstWlBuffer * self);
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
GST_WL_API
waylandsink: stack the video subsurface into another subsurface that covers the whole render rectangle The main reason behind this is that when the video caps change and the video subsurface needs to resize and change position, the wl_subsurface.set_position call needs a commit in its parent in order to take effect. Previously, the parent was the application's surface, over which there is no control. Now, the parent is inside the sink, so we can commit it and change size smoothly. As a side effect, this also allows the sink to draw its black borders on its own, without the need for the application to do that. And another side effect is that this can now allow resizing the sink when it is in top-level mode and have it respect the aspect ratio.
2014-07-01 08:43:20 +00:00
void gst_wl_buffer_attach (GstWlBuffer * self, struct wl_surface *surface);
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
wayland: Add API to ref/unref current GstBuffer inside a GstWlBuffer Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/6133>
2024-02-15 21:41:52 +00:00
GST_WL_API
void gst_wl_buffer_ref_gst_buffer(GstWlBuffer * self);
GST_WL_API
void gst_wl_buffer_unref_buffer(GstWlBuffer * self);
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
GST_WL_API
GstWlDisplay *gst_wl_buffer_get_display (GstWlBuffer * self);
waylandsink: rework the mechanism for keeping buffers out of the pool until wl_buffer::release This also removes the GstWlMeta and adds a wrapper class for wl_buffer which is saved in the GstBuffer qdata instead of being a GstMeta. The motivation behind this is mainly to allow attaching wl_buffers on GstBuffers that have not been allocated inside the GstWaylandBufferPool, so that if for example an upstream element is sending us a buffer from a different pool, which however does not need to be copied to a buffer from our pool because it may be a hardware buffer (hello dmabuf!), we can create a wl_buffer directly from it and first, attach it on it so that we don't have to re-create a wl_buffer every time the same GstBuffer arrives and second, force the whole mechanism for keeping the buffer out of the pool until there is a wl_buffer::release on that foreign GstBuffer.
2014-06-20 11:47:57 +00:00
gstwayland: Move reusable parts of the waylandsink into a library In preparation for the new element `GstGtkWaylandSink`, move reusable parts out of `GstWaylandSink` into the already exisiting but very barebone library. Notable changes include: - the `GstWaylandVideo` interface was dropped - support for `wl-shell` was dropped - lots of renaming in order to match established naming patterns - lots of code modernisations, reducing boilerplate - members were made private wherever possible Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/2479>
2022-01-04 14:20:41 +00:00
G_END_DECLS
Reference in a new issue Copy permalink