From 927c3fcdb600bf36eea9800ad6c216e833a18c9d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= Date: Thu, 25 Apr 2024 13:51:40 +0300 Subject: [PATCH] gtk4paintablesink: Update README.md with all the new features Part-of: --- video/gtk4/README.md | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/video/gtk4/README.md b/video/gtk4/README.md index 4955d6a9..aaf66f33 100644 --- a/video/gtk4/README.md +++ b/video/gtk4/README.md @@ -1,10 +1,20 @@ -# Gtk 4 Sink & Paintable +# GTK 4 Sink & Paintable GTK 4 provides `gtk::Video` & `gtk::Picture` for rendering media such as videos. As the default `gtk::Video` widget doesn't offer the possibility to use a custom `gst::Pipeline`. The plugin provides a `gst_video::VideoSink` along with a `gdk::Paintable` that's capable of rendering the sink's frames. -The Sink can generate GL Textures if the system is capable of it, but it needs to be compiled -with either `wayland`, `x11glx` or `x11egl` cargo features. +The sink can generate GL Textures if the system is capable of it, but it needs +to be compiled with either `wayland`, `x11glx` or `x11egl` cargo features. On +Windows and macOS this is enabled by default. + +Additionally, the sink can render DMABufs directly on Linux if GTK 4.14 or +newer is used. For this the `dmabuf` feature needs to be enabled. + +Depending on the GTK version that is used and should be supported as minimum, +new features or more efficient processing can be opted in with the `gtk_v4_10`, +`gtk_v4_12` and `gtk_v4_14` features. The minimum GTK version required by the +sink is GTK 4.4 on Linux without GL support, and 4.6 on Windows and macOS, and +on Linux with GL support. # Flatpak Integration @@ -44,7 +54,7 @@ To build and include the plugin in a Flatpak manifest, you can add the following { "type": "git", "url": "https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs", - "branch": "0.10" + "branch": "0.12" } ], "build-options": {