path: root/src/widgets/control-center/control-slider.c

#include "widgets/control-center/control-slider.h"

//
// FoobarControlSlider:
//
// A slider in the "controls" section of the control center with a title and icon, as well as an optional secondary
// button to toggle a details view.
//

struct _FoobarControlSlider
{
	GtkWidget parent_instance;
	gchar*    icon_name;
	gchar*    label;
	gboolean  can_expand;
	gboolean  is_expanded;
	gint      percentage;
};

enum
{
	PROP_ICON_NAME = 1,
	PROP_LABEL,
	PROP_CAN_EXPAND,
	PROP_IS_EXPANDED,
	PROP_PERCENTAGE,
	N_PROPS,
};

static GParamSpec* props[N_PROPS] = { 0 };

static void foobar_control_slider_class_init           ( FoobarControlSliderClass* klass );
static void foobar_control_slider_init                 ( FoobarControlSlider*      self );
static void foobar_control_slider_get_property         ( GObject*                  object,
                                                         guint                     prop_id,
                                                         GValue*                   value,
                                                         GParamSpec*               pspec );
static void foobar_control_slider_set_property         ( GObject*                  object,
                                                         guint                     prop_id,
                                                         GValue const*             value,
                                                         GParamSpec*               pspec );
static void foobar_control_slider_dispose              ( GObject*                  object );
static void foobar_control_slider_finalize             ( GObject*                  object );
static void foobar_control_slider_handle_expand_clicked( GtkButton*                button,
                                                         gpointer                  userdata );

G_DEFINE_FINAL_TYPE( FoobarControlSlider, foobar_control_slider, GTK_TYPE_WIDGET )

// ---------------------------------------------------------------------------------------------------------------------
// Widget Implementation
// ---------------------------------------------------------------------------------------------------------------------

//
// Static initialization for control sliders.
//
void foobar_control_slider_class_init( FoobarControlSliderClass* klass )
{
	GtkWidgetClass* widget_klass = GTK_WIDGET_CLASS( klass );
	gtk_widget_class_set_css_name( widget_klass, "control-slider" );
	gtk_widget_class_set_layout_manager_type( widget_klass, GTK_TYPE_BOX_LAYOUT );

	GObjectClass* object_klass = G_OBJECT_CLASS( klass );
	object_klass->get_property = foobar_control_slider_get_property;
	object_klass->set_property = foobar_control_slider_set_property;
	object_klass->dispose = foobar_control_slider_dispose;
	object_klass->finalize = foobar_control_slider_finalize;

	props[PROP_ICON_NAME] = g_param_spec_string(
		"icon-name",
		"Icon Name",
		"Name of the icon to be displayed next to the label.",
		NULL,
		G_PARAM_READWRITE );
	props[PROP_LABEL] = g_param_spec_string(
		"label",
		"Label",
		"The slider's main label.",
		NULL,
		G_PARAM_READWRITE );
	props[PROP_CAN_EXPAND] = g_param_spec_boolean(
		"can-expand",
		"Can Expand",
		"Indicates whether some details are hidden and can be revealed by a toggle button next to the slider.",
		FALSE,
		G_PARAM_READWRITE );
	props[PROP_IS_EXPANDED] = g_param_spec_boolean(
		"is-expanded",
		"Is Expanded",
		"Indicates whether additional details should be shown.",
		FALSE,
		G_PARAM_READWRITE );
	props[PROP_PERCENTAGE] = g_param_spec_int(
		"percentage",
		"Percentage",
		"Value shown by the slider.",
		0,
		100,
		0,
		G_PARAM_READWRITE );
	g_object_class_install_properties( object_klass, N_PROPS, props );
}

//
// Instance initialization for control sliders.
//
void foobar_control_slider_init( FoobarControlSlider* self )
{
	GtkWidget* icon = gtk_image_new( );
	gtk_widget_set_valign( icon, GTK_ALIGN_CENTER );
	g_object_bind_property(
		self,
		"icon-name",
		icon,
		"icon-name",
		G_BINDING_SYNC_CREATE );

	GtkWidget* label = gtk_label_new( NULL );
	gtk_widget_set_valign( label, GTK_ALIGN_CENTER );
	gtk_widget_set_hexpand( label, TRUE );
	gtk_label_set_justify( GTK_LABEL( label ), GTK_JUSTIFY_LEFT );
	gtk_label_set_xalign( GTK_LABEL( label ), 0 );
	g_object_bind_property(
		self,
		"label",
		label,
		"label",
		G_BINDING_SYNC_CREATE );

	GtkWidget* header = gtk_box_new( GTK_ORIENTATION_HORIZONTAL, 0 );
	gtk_box_append( GTK_BOX( header ), icon );
	gtk_box_append( GTK_BOX( header ), label );

	GtkWidget* scale = gtk_scale_new_with_range( GTK_ORIENTATION_HORIZONTAL, 0, 100, 2 );
	g_object_bind_property(
		self,
		"percentage",
		gtk_range_get_adjustment( GTK_RANGE( scale ) ),
		"value",
		G_BINDING_SYNC_CREATE | G_BINDING_BIDIRECTIONAL );

	GtkWidget* primary_content = gtk_box_new( GTK_ORIENTATION_VERTICAL, 0 );
	gtk_widget_add_css_class( primary_content, "primary" );
	gtk_box_append( GTK_BOX( primary_content ), header );
	gtk_box_append( GTK_BOX( primary_content ), scale );

	GtkWidget* expand_button = gtk_button_new_from_icon_name( "fluent-chevron-right-symbolic" );
	gtk_widget_add_css_class( expand_button, "expand" );
	g_object_bind_property(
		self,
		"can-expand",
		expand_button,
		"visible",
		G_BINDING_SYNC_CREATE );
	g_signal_connect( expand_button, "clicked", G_CALLBACK( foobar_control_slider_handle_expand_clicked ), self );

	GtkLayoutManager* layout = gtk_widget_get_layout_manager( GTK_WIDGET( self ) );
	gtk_orientable_set_orientation( GTK_ORIENTABLE( layout ), GTK_ORIENTATION_HORIZONTAL );
	gtk_widget_insert_before( primary_content, GTK_WIDGET( self ), NULL );
	gtk_widget_insert_before( expand_button, GTK_WIDGET( self ), NULL );
}

//
// Property getter implementation, mapping a property id to a method.
//
void foobar_control_slider_get_property(
	GObject*    object,
	guint       prop_id,
	GValue*     value,
	GParamSpec* pspec )
{
	FoobarControlSlider* self = (FoobarControlSlider*)object;

	switch ( prop_id )
	{
		case PROP_ICON_NAME:
			g_value_set_string( value, foobar_control_slider_get_icon_name( self ) );
			break;
		case PROP_LABEL:
			g_value_set_string( value, foobar_control_slider_get_label( self ) );
			break;
		case PROP_CAN_EXPAND:
			g_value_set_boolean( value, foobar_control_slider_can_expand( self ) );
			break;
		case PROP_IS_EXPANDED:
			g_value_set_boolean( value, foobar_control_slider_is_expanded( self ) );
			break;
		case PROP_PERCENTAGE:
			g_value_set_int( value, foobar_control_slider_get_percentage( self ) );
			break;
		default:
			G_OBJECT_WARN_INVALID_PROPERTY_ID( object, prop_id, pspec );
			break;
	}
}

//
// Property setter implementation, mapping a property id to a method.
//
void foobar_control_slider_set_property(
	GObject*      object,
	guint         prop_id,
	GValue const* value,
	GParamSpec*   pspec )
{
	FoobarControlSlider* self = (FoobarControlSlider*)object;

	switch ( prop_id )
	{
		case PROP_ICON_NAME:
			foobar_control_slider_set_icon_name( self, g_value_get_string( value ) );
			break;
		case PROP_LABEL:
			foobar_control_slider_set_label( self, g_value_get_string( value ) );
			break;
		case PROP_CAN_EXPAND:
			foobar_control_slider_set_can_expand( self, g_value_get_boolean( value ) );
			break;
		case PROP_IS_EXPANDED:
			foobar_control_slider_set_expanded( self, g_value_get_boolean( value ) );
			break;
		case PROP_PERCENTAGE:
			foobar_control_slider_set_percentage( self, g_value_get_int( value ) );
			break;
		default:
			G_OBJECT_WARN_INVALID_PROPERTY_ID( object, prop_id, pspec );
			break;
	}
}

//
// Instance de-initialization for control sliders.
//
void foobar_control_slider_dispose( GObject* object )
{
	FoobarControlSlider* self = (FoobarControlSlider*)object;

	GtkWidget* child;
	while ( ( child = gtk_widget_get_first_child( GTK_WIDGET( self ) ) ) )
	{
		gtk_widget_unparent( child );
	}

	G_OBJECT_CLASS( foobar_control_slider_parent_class )->dispose( object );
}

//
// Instance cleanup for control sliders.
//
void foobar_control_slider_finalize( GObject* object )
{
	FoobarControlSlider* self = (FoobarControlSlider*)object;

	g_clear_pointer( &self->icon_name, g_free );
	g_clear_pointer( &self->label, g_free );

	G_OBJECT_CLASS( foobar_control_slider_parent_class )->finalize( object );
}

// ---------------------------------------------------------------------------------------------------------------------
// Public API
// ---------------------------------------------------------------------------------------------------------------------

//
// Create a new control slider instance.
//
GtkWidget* foobar_control_slider_new( void )
{
	return g_object_new( FOOBAR_TYPE_CONTROL_SLIDER, NULL );
}

//
// Get the name of the icon to be displayed next to the label.
//
gchar const* foobar_control_slider_get_icon_name( FoobarControlSlider* self )
{
	g_return_val_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ), NULL );
	return self->icon_name;
}

//
// Get the slider's main label.
//
gchar const* foobar_control_slider_get_label( FoobarControlSlider* self )
{
	g_return_val_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ), NULL );
	return self->label;
}

//
// Check whether some details are hidden and can be revealed by a toggle button next to the slider.
//
gboolean foobar_control_slider_can_expand( FoobarControlSlider* self )
{
	g_return_val_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ), FALSE );
	return self->can_expand;
}

//
// Check whether additional details should currently be shown.
//
gboolean foobar_control_slider_is_expanded( FoobarControlSlider* self )
{
	g_return_val_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ), FALSE );
	return self->is_expanded;
}

//
// Get the value shown by the slider.
//
gint foobar_control_slider_get_percentage( FoobarControlSlider* self )
{
	g_return_val_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ), FALSE );
	return self->percentage;
}

//
// Update the name of the icon to be displayed next to the label.
//
void foobar_control_slider_set_icon_name(
	FoobarControlSlider* self,
	gchar const*         value )
{
	g_return_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ) );

	if ( g_strcmp0( self->icon_name, value ) )
	{
		g_clear_pointer( &self->icon_name, g_free );
		self->icon_name = g_strdup( value );
		g_object_notify_by_pspec( G_OBJECT( self ), props[PROP_ICON_NAME] );
	}
}

//
// Update the slider's main label.
//
void foobar_control_slider_set_label(
	FoobarControlSlider* self,
	gchar const*         value )
{
	g_return_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ) );

	if ( g_strcmp0( self->label, value ) )
	{
		g_clear_pointer( &self->label, g_free );
		self->label = g_strdup( value );
		g_object_notify_by_pspec( G_OBJECT( self ), props[PROP_LABEL] );
	}
}

//
// Update whether some details are hidden and can be revealed by a toggle button next to the slider.
//
void foobar_control_slider_set_can_expand(
	FoobarControlSlider* self,
	gboolean             value )
{
	g_return_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ) );

	if ( !value ) { foobar_control_slider_set_expanded( self, FALSE ); }

	value = !!value;
	if ( self->can_expand != value )
	{
		self->can_expand = value;
		g_object_notify_by_pspec( G_OBJECT( self ), props[PROP_CAN_EXPAND] );
	}
}

//
// Update whether additional details are currently shown.
//
void foobar_control_slider_set_expanded(
	FoobarControlSlider* self,
	gboolean             value )
{
	g_return_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ) );

	value = value && self->can_expand;
	if ( self->is_expanded != value )
	{
		self->is_expanded = value;
		g_object_notify_by_pspec( G_OBJECT( self ), props[PROP_IS_EXPANDED] );

		if ( self->is_expanded )
		{
			gtk_widget_add_css_class( GTK_WIDGET( self ), "expanded" );
		}
		else
		{
			gtk_widget_remove_css_class( GTK_WIDGET( self ), "expanded" );
		}
	}
}

//
// Update the value shown by the slider.
//
void foobar_control_slider_set_percentage( FoobarControlSlider* self, gint value )
{
	g_return_if_fail( FOOBAR_IS_CONTROL_SLIDER( self ) );

	value = CLAMP( value, 0, 100 );
	if ( self->percentage != value )
	{
		self->percentage = value;
		g_object_notify_by_pspec( G_OBJECT( self ), props[PROP_PERCENTAGE] );
	}
}

// ---------------------------------------------------------------------------------------------------------------------
// Signal Handlers
// ---------------------------------------------------------------------------------------------------------------------

//
// Called when the expand button was clicked.
//
// If allowed, this will toggle the "expanded" state of the slider.
//
void foobar_control_slider_handle_expand_clicked( GtkButton* button, gpointer userdata )
{
	(void)button;
	FoobarControlSlider* self = (FoobarControlSlider*)userdata;

	if ( foobar_control_slider_can_expand( self ) )
	{
		foobar_control_slider_set_expanded( self, !foobar_control_slider_is_expanded( self ) );
	}
}