mirror of https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs.git synced 2024-12-23 10:30:40 +00:00

History

Sebastian Dröge 9971f71e94 gtk4: Always draw a black background behind the video frame This makes sure that there is the same background behind the frame, no matter if black borders have to be added or not. Without this a frame that has transparency would change rendering depending on the layout. Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/merge_requests/1452>		2024-02-08 12:35:26 +02:00
..
examples	Use let-else instead of match for weak reference upgrades	2023-10-30 11:34:35 +02:00
src	gtk4: Always draw a black background behind the video frame	2024-02-08 12:35:26 +02:00
build.rs	Add a GTK4 paintable sink plugin	2021-10-13 12:28:51 +03:00
Cargo.toml	gtk4: Improve handling of RGBA GL textures in GTK	2024-02-08 12:35:26 +02:00
LICENSE-MPL-2.0	git: replace LICENSE file symlinks with copies	2023-04-04 14:26:37 +01:00
README.md	video/gtk4: Add a flatpak snippet example in the README	2023-02-22 22:15:40 +02:00

README.md

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.

Flatpak Integration

To build and include the plugin in a Flatpak manifest, you can add the following snippet to your json manifest:

{
    "sdk-extensions": [
        "org.freedesktop.Sdk.Extension.rust-stable"
    ],
    "build-options": {
        "env": {
            "CARGO_HOME": "/run/build/cargo-c/cargo"
        },
        "append-path": "/usr/lib/sdk/rust-stable/bin",
    },
    "modules": [
        {
            "name": "cargo-c",
            "buildsystem": "simple",
            "build-commands": [
                "cargo install cargo-c --root /app"
            ],
            "build-options": {
                "build-args": [
                    "--share=network"
                ]
            },
            "cleanup": [
                "*"
            ]
        },
        {
            "name": "gst-plugins-rs",
            "buildsystem": "simple",
            "sources": [
                {
                    "type": "git",
                    "url": "https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs",
                    "branch": "0.10"
                }
            ],
            "build-options": {
                "build-args": [
                    "--share=network"
                ]
            },
            "build-commands": [
                "cargo cinstall -p gst-plugin-gtk4 --prefix=/app"
            ]
        }
    ]
}