Video

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_video_get_type ()" ) ]
public class Video : Widget, Accessible, Buildable, ConstraintTarget

`GtkVideo` is a widget to show a `GtkMediaStream` with media controls.

![An example GtkVideo](video.png)

The controls are available separately as [class@Gtk.MediaControls]. If you just want to display a video without controls, you can treat it like any other paintable and for example put it into a [class@Gtk.Picture].

`GtkVideo` aims to cover use cases such as previews, embedded animations, etc. It supports autoplay, looping, and simple media controls. It does not have support for video overlays, multichannel audio, device selection, or input. If you are writing a full-fledged video player, you may want to use the [class@Gdk.Paintable] API and a media framework such as Gstreamer directly.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public bool autoplay { get; set; }
If the video should automatically begin playing.
public File file { get; set; }
The file played by this video if the video is playing a file.
public bool loop { get; set; }
If new media files should be set to loop.
public MediaStream media_stream { get; set; }
The media-stream played

Creation methods:

public Video ()
Creates a new empty `GtkVideo`.
public Video.for_file (File? file)
Creates a `GtkVideo` to play back the given file.
public Video.for_filename (string? filename)
Creates a `GtkVideo` to play back the given filename.
public Video.for_media_stream (MediaStream? stream)
Creates a `GtkVideo` to play back the given stream.
public Video.for_resource (string? resource_path)
Creates a `GtkVideo` to play back the resource at the given resource_path.

Methods:

public bool get_autoplay ()
Returns true if videos have been set to loop.
public unowned File? get_file ()
Gets the file played by this or null if not playing back a file.
public bool get_loop ()
Returns true if videos have been set to loop.
public unowned MediaStream? get_media_stream ()
Gets the media stream managed by this or null if none.
public void set_autoplay (bool autoplay)
Sets whether this automatically starts playback when it becomes visible or when a new file gets loaded.
public void set_file (File? file)
Makes this play the given file.
public void set_filename (string? filename)
Makes this play the given filename.
public void set_loop (bool loop)
Sets whether new files loaded by this should be set to loop.
public void set_media_stream (MediaStream? stream)
Sets the media stream to be played back.
public void set_resource (string? resource_path)
Makes this play the resource at the given resource_path.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable