diff options
author | Matthias Clasen <mclasen@redhat.com> | 2021-01-02 19:04:26 +0000 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2021-01-02 19:04:26 +0000 |
commit | 01b94db73d20236a67693081a363d27b879ce288 (patch) | |
tree | 14eb3a83fb7f22f88d2a6a2d47654016e3472a05 | |
parent | 384081ce0a6aae4c7c5d6b3ec381c982145c3438 (diff) | |
parent | c8046453828405cfaf6e103703d36274aad0f116 (diff) | |
download | gtk+-01b94db73d20236a67693081a363d27b879ce288.tar.gz |
Merge branch 'matthiasc/for-master' into 'master'
video: Tweak the docs
See merge request GNOME/gtk!3026
-rw-r--r-- | gtk/gtkmediastream.c | 5 | ||||
-rw-r--r-- | gtk/gtkvideo.c | 19 |
2 files changed, 17 insertions, 7 deletions
diff --git a/gtk/gtkmediastream.c b/gtk/gtkmediastream.c index c7c0a6fb0c..29c9c310a2 100644 --- a/gtk/gtkmediastream.c +++ b/gtk/gtkmediastream.c @@ -27,10 +27,13 @@ * SECTION:gtkmediastream * @Short_description: Display media in GTK * @Title: GtkMediaStream - * @See_also: #GdkPaintable + * @See_also: #GdkPaintable, #GtkMediaFile * * #GtkMediaStream is the integration point for media playback inside GTK. * + * GTK provides an implementation of the #GtkMediaStream interface that + * is called #GtkMediaFile. + * * Apart from application-facing API for stream playback, #GtkMediaStream * has a number of APIs that are only useful for implementations and should * not be used in applications: diff --git a/gtk/gtkvideo.c b/gtk/gtkvideo.c index 8258e25145..15a5e25a36 100644 --- a/gtk/gtkvideo.c +++ b/gtk/gtkvideo.c @@ -36,12 +36,19 @@ * SECTION:gtkvideo * @title: GtkVideo * @short_description: A widget for displaying video - * @see_also: #GtkMediaControls - * - * GtkVideo is a widget to show a #GtkMediaStream. - * - * It is commonly combined with #GtkMediaControls to give the - * user a way to control the playback. + * @see_also: #GtkMediaControls, #GtkMediaStream + * + * GtkVideo is a widget to show a #GtkMediaStream with media controls + * as provided by #GtkMediaControls. 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 #GtkPicture. + * + * 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 #GdkPaintable API and a media framework such + * as Gstreamer directly. */ struct _GtkVideo |