lib: Introduce Clapper GTK integration library

An easy to use GTK integration library. Meant as a GtkVideo alternative.

While GtkVideo is more of a simple example of video playback under GTK4, this
acts as a full-fledged video player in the form of a GtkWidget that can be placed
anywhere within application.

The widget offers customization options for both top header and bottom playback
controls panels. The Clapper playback API is exposed under widget "player" property
making it easy for the programmer to set media and control playback programically.

The new library will be distributed with Clapper player. This includes public headers
and GObject Introspection support.

Licensed under LGPL-2.1-or-later.
This commit is contained in:
Rafał Dzięgiel
2024-03-13 20:58:00 +01:00
parent d7f069d6c3
commit 675ddc85a1
91 changed files with 11030 additions and 0 deletions

View File

@@ -0,0 +1,137 @@
/* Clapper GTK Integration Library
* Copyright (C) 2024 Rafał Dzięgiel <rafostar.github@gmail.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#include "config.h"
#include <gst/gst.h>
#include "clapper-gtk-status-private.h"
#define NORMAL_SPACING 16
#define ADAPT_SPACING 8
#define GST_CAT_DEFAULT clapper_gtk_status_debug
GST_DEBUG_CATEGORY_STATIC (GST_CAT_DEFAULT);
struct _ClapperGtkStatus
{
ClapperGtkContainer parent;
GtkWidget *status_box;
GtkWidget *image;
GtkWidget *title_label;
GtkWidget *description_label;
};
#define parent_class clapper_gtk_status_parent_class
G_DEFINE_TYPE (ClapperGtkStatus, clapper_gtk_status, CLAPPER_GTK_TYPE_CONTAINER)
static void
adapt_cb (ClapperGtkContainer *container, gboolean adapt,
ClapperGtkStatus *self)
{
GST_DEBUG_OBJECT (self, "Adapted: %s", (adapt) ? "yes" : "no");
gtk_box_set_spacing (GTK_BOX (self->status_box), (adapt) ? ADAPT_SPACING : NORMAL_SPACING);
if (adapt) {
gtk_widget_add_css_class (GTK_WIDGET (self), "adapted");
gtk_widget_add_css_class (GTK_WIDGET (self->title_label), "title-2");
} else {
gtk_widget_remove_css_class (GTK_WIDGET (self), "adapted");
gtk_widget_remove_css_class (GTK_WIDGET (self->title_label), "title-2");
}
}
static void
_set_status (ClapperGtkStatus *self, const gchar *icon_name,
const gchar *title, const gchar *description)
{
gtk_image_set_from_icon_name (GTK_IMAGE (self->image), icon_name);
gtk_label_set_label (GTK_LABEL (self->title_label), title);
gtk_label_set_label (GTK_LABEL (self->description_label), description);
gtk_widget_set_visible (GTK_WIDGET (self), TRUE);
}
void
clapper_gtk_status_set_error (ClapperGtkStatus *self, const GError *error)
{
GST_DEBUG_OBJECT (self, "Status set to \"error\"");
_set_status (self, "dialog-warning-symbolic", "Unplayable Content", error->message);
}
void
clapper_gtk_status_set_missing_plugin (ClapperGtkStatus *self, const gchar *name)
{
gchar *description;
GST_DEBUG_OBJECT (self, "Status set to \"missing-plugin\"");
description = g_strdup_printf ("Your GStreamer installation is missing a plugin: %s", name);
_set_status (self, "dialog-information-symbolic", "Missing Plugin", description);
g_free (description);
}
void
clapper_gtk_status_clear (ClapperGtkStatus *self)
{
GST_DEBUG_OBJECT (self, "Status cleared");
gtk_widget_set_visible (GTK_WIDGET (self), FALSE);
}
static void
clapper_gtk_status_init (ClapperGtkStatus *self)
{
gtk_widget_init_template (GTK_WIDGET (self));
gtk_box_set_spacing (GTK_BOX (self->status_box), NORMAL_SPACING);
}
static void
clapper_gtk_status_dispose (GObject *object)
{
gtk_widget_dispose_template (GTK_WIDGET (object), CLAPPER_GTK_TYPE_STATUS);
G_OBJECT_CLASS (parent_class)->dispose (object);
}
static void
clapper_gtk_status_class_init (ClapperGtkStatusClass *klass)
{
GObjectClass *gobject_class = (GObjectClass *) klass;
GtkWidgetClass *widget_class = (GtkWidgetClass *) klass;
GST_DEBUG_CATEGORY_INIT (GST_CAT_DEFAULT, "clappergtkstatus", 0,
"Clapper GTK Status");
gobject_class->dispose = clapper_gtk_status_dispose;
gtk_widget_class_set_template_from_resource (widget_class,
CLAPPER_GTK_RESOURCE_PREFIX "/ui/clapper-gtk-status.ui");
gtk_widget_class_bind_template_child (widget_class, ClapperGtkStatus, status_box);
gtk_widget_class_bind_template_child (widget_class, ClapperGtkStatus, image);
gtk_widget_class_bind_template_child (widget_class, ClapperGtkStatus, title_label);
gtk_widget_class_bind_template_child (widget_class, ClapperGtkStatus, description_label);
gtk_widget_class_bind_template_callback (widget_class, adapt_cb);
gtk_widget_class_set_css_name (widget_class, "clapper-gtk-status");
}