Quelle  gimpshortcutbutton.c   Sprache: C

/* GIMP - The GNU Image Manipulation Program
 * Copyright (C) 1995 Spencer Kimball and Peter Mattis
 *
 * gimpshortcutbutton.c
 * Copyright (C) 2022 Jehan
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

#include "config.h"

#include <gegl.h>
#include <gtk/gtk.h>

#include "libgimpbase/gimpbase.h"
#include "libgimpwidgets/gimpwidgets.h"

#include "widgets-types.h"

#include "gimpshortcutbutton.h"

#include "gimp-intl.h"


enum
{
  ACCELERATOR_CHANGED,
  LAST_SIGNAL
};
enum
{
  PROP_0,
  PROP_ACCELERATOR
};

struct _GimpShortcutButtonPrivate
{
  guint            keyval;
  GdkModifierType  modifiers;

  GtkWidget       *stack;

  gboolean         modifier_only_accepted;
  gboolean         single_modifier;

  guint            timer;
  guint            last_keyval;
  GdkModifierType  last_modifiers;
};


static void     gimp_shortcut_button_constructed         (GObject            *object);
static void     gimp_shortcut_button_finalize            (GObject            *object);
static void     gimp_shortcut_button_set_property        (GObject            *object,
                                                          guint               property_id,
                                                          const GValue       *value,
                                                          GParamSpec         *pspec);
static void     gimp_shortcut_button_get_property        (GObject            *object,
                                                          guint               property_id,
                                                          GValue             *value,
                                                          GParamSpec         *pspec);

static gboolean gimp_shortcut_button_key_press_event     (GtkWidget          *button,
                                                          GdkEventKey        *event,
                                                          gpointer            user_data);
static gboolean gimp_shortcut_button_focus_out_event     (GimpShortcutButton *button,
                                                          GdkEventFocus       event,
                                                          gpointer            user_data);
static void     gimp_shortcut_button_toggled             (GimpShortcutButton *button,
                                                          gpointer            user_data);

static void     gimp_shortcut_button_update_label        (GimpShortcutButton *button);

static gboolean gimp_shortcut_button_timeout             (GimpShortcutButton *button);

static void     gimp_shortcut_button_keyval_to_modifiers (guint               keyval,
                                                          GdkModifierType    *modifiers);


G_DEFINE_TYPE_WITH_PRIVATE (GimpShortcutButton, gimp_shortcut_button, GTK_TYPE_TOGGLE_BUTTON)

#define parent_class gimp_shortcut_button_parent_class

static guint signals[LAST_SIGNAL] = { 0 };

static void
gimp_shortcut_button_class_init (GimpShortcutButtonClass *klass)
{
  GObjectClass *object_class = G_OBJECT_CLASS (klass);

  object_class->constructed  = gimp_shortcut_button_constructed;
  object_class->finalize     = gimp_shortcut_button_finalize;
  object_class->get_property = gimp_shortcut_button_get_property;
  object_class->set_property = gimp_shortcut_button_set_property;

  g_object_class_install_property (object_class, PROP_ACCELERATOR,
                                   g_param_spec_string ("accelerator",
                                                        NULL, NULL, NULL,
                                                        GIMP_PARAM_READWRITE |
                                                        G_PARAM_EXPLICIT_NOTIFY));

  signals[ACCELERATOR_CHANGED] = g_signal_new ("accelerator-changed",
                                               G_TYPE_FROM_CLASS (klass),
                                               G_SIGNAL_RUN_FIRST,
                                               G_STRUCT_OFFSET (GimpShortcutButtonClass, accelerator_changed),
                                               NULL, NULL, NULL,
                                               G_TYPE_NONE, 1,
                                               G_TYPE_STRING);

  klass->accelerator_changed = NULL;
}

static void
gimp_shortcut_button_init (GimpShortcutButton *button)
{
  GtkWidget *label;

  button->priv = gimp_shortcut_button_get_instance_private (button);

  button->priv->timer = 0;

  button->priv->stack = gtk_stack_new ();
  gtk_container_add (GTK_CONTAINER (button), button->priv->stack);
  gtk_widget_show (button->priv->stack);

  label = gtk_shortcut_label_new (NULL);
  gtk_stack_add_named (GTK_STACK (button->priv->stack), label,
                       "shortcut-label");
  gtk_widget_show (label);

  label = gtk_label_new (_("No shortcut"));
  gtk_stack_add_named (GTK_STACK (button->priv->stack), label,
                       "label");
  gtk_widget_show (label);
}

static void
gimp_shortcut_button_constructed (GObject *object)
{
  G_OBJECT_CLASS (parent_class)->constructed (object);

  g_signal_connect (object, "key-press-event",
                    G_CALLBACK (gimp_shortcut_button_key_press_event),
                    NULL);
  g_signal_connect (object, "focus-out-event",
                    G_CALLBACK (gimp_shortcut_button_focus_out_event),
                    NULL);
  g_signal_connect (object, "toggled",
                    G_CALLBACK (gimp_shortcut_button_toggled),
                    NULL);

  gimp_shortcut_button_toggled (GIMP_SHORTCUT_BUTTON (object), NULL);
}

static void
gimp_shortcut_button_finalize (GObject *object)
{
  GimpShortcutButton *button = GIMP_SHORTCUT_BUTTON (object);

  G_OBJECT_CLASS (parent_class)->finalize (object);

  if (button->priv->timer != 0)
    {
      g_source_remove (button->priv->timer);
      button->priv->timer = 0;
    }
}

static void
gimp_shortcut_button_set_property (GObject      *object,
                                   guint         property_id,
                                   const GValue *value,
                                   GParamSpec   *pspec)
{
  GimpShortcutButton *button = GIMP_SHORTCUT_BUTTON (object);

  switch (property_id)
    {
    case PROP_ACCELERATOR:
      gimp_shortcut_button_set_accelerator (button, g_value_get_string (value), 0, 0);
      break;

   default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
      break;
    }
}

static void
gimp_shortcut_button_get_property (GObject    *object,
                                   guint       property_id,
                                   GValue     *value,
                                   GParamSpec *pspec)
{
  GimpShortcutButton *button = GIMP_SHORTCUT_BUTTON (object);

  switch (property_id)
    {
    case PROP_ACCELERATOR:
        {
          gchar *name = gtk_accelerator_name (button->priv->keyval, button->priv->modifiers);

          g_value_set_string (value, gtk_accelerator_name (button->priv->keyval, button->priv->modifiers));
          g_free (name);
        }
      break;

   default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
      break;
    }
}

/*  public functions  */

GtkWidget *
gimp_shortcut_button_new (const gchar *accelerator)
{
  GimpShortcutButton *button;

  button = g_object_new (GIMP_TYPE_SHORTCUT_BUTTON,
                         "accelerator", accelerator,
                         NULL);

  return GTK_WIDGET (button);
}

gchar *
gimp_shortcut_button_get_accelerator (GimpShortcutButton *button)
{
  g_return_val_if_fail (GIMP_IS_SHORTCUT_BUTTON (button), NULL);

  return gtk_accelerator_name (button->priv->keyval, button->priv->modifiers);
}

void
gimp_shortcut_button_get_keys (GimpShortcutButton  *button,
                               guint               *keyval,
                               GdkModifierType     *modifiers)
{
  g_return_if_fail (GIMP_IS_SHORTCUT_BUTTON (button));

  if (keyval)
    *keyval = button->priv->keyval;
  if (modifiers)
    *modifiers = button->priv->modifiers;
}

void
gimp_shortcut_button_set_accelerator (GimpShortcutButton *button,
                                      const gchar        *accelerator,
                                      guint               keyval,
                                      GdkModifierType     modifiers)
{
  g_return_if_fail (GIMP_IS_SHORTCUT_BUTTON (button));

  if (accelerator)
    gtk_accelerator_parse (accelerator, &keyval, &modifiers);

  if (button->priv->modifier_only_accepted && keyval != 0)
    {
      if (button->priv->single_modifier)
        modifiers = 0;
      gimp_shortcut_button_keyval_to_modifiers (keyval, &modifiers);
      keyval = 0;
    }

  if (keyval != button->priv->keyval || modifiers != button->priv->modifiers)
    {
      GtkWidget *label;
      gchar     *previous_accel;
      gchar     *accel;

      previous_accel = gtk_accelerator_name (button->priv->keyval, button->priv->modifiers);
      button->priv->keyval = keyval;
      button->priv->modifiers = modifiers;

      label = gtk_stack_get_child_by_name (GTK_STACK (button->priv->stack),
                                           "shortcut-label");

      accel = gtk_accelerator_name (keyval, modifiers);
      gtk_shortcut_label_set_accelerator (GTK_SHORTCUT_LABEL (label), accel);
      g_free (accel);

      g_object_notify (G_OBJECT (button), "accelerator");

      g_signal_emit (button, signals[ACCELERATOR_CHANGED], 0,
                     previous_accel);
      g_free (previous_accel);

      gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), keyval != 0 || modifiers == 0);
      gimp_shortcut_button_toggled (GIMP_SHORTCUT_BUTTON (button), NULL);
    }
}

/**
 * gimp_shortcut_button_accepts_modifier:
 * @accepted: are shortcuts with only modifiers accepted?
 * @unique:   if @only and @unique are both %TRUE, then the button will
 *            grab a single modifier
 *
 * By default, the shortcut button will accept shortcuts such as `a` or
 * `Ctrl-a` or `Shift-Ctrl-a`. A modifier-only shortcut such as `Ctrl`
 * will not be recorded.
 * If @accepted is %TRUE, then it is the opposite. In such case, 2 cases
 * are possible: if @unique is %FALSE, then single modifiers are
 * recorded, such as `Ctrl` or `Shift`, but not `Ctrl-Shift`; if @unique
 * is %FALSE, it may record both `Ctrl` and `Ctrl-Shift` or any modifier
 * combination.
 */
void
gimp_shortcut_button_accepts_modifier (GimpShortcutButton *button,
                                       gboolean            accepted,
                                       gboolean            unique)
{
  g_return_if_fail (GIMP_IS_SHORTCUT_BUTTON (button));

  button->priv->modifier_only_accepted = accepted;
  button->priv->single_modifier        = unique;

  gimp_shortcut_button_update_label (button);
}

/* Private functions. */

static gboolean
gimp_shortcut_button_key_press_event (GtkWidget   *widget,
                                      GdkEventKey *event,
                                      gpointer     user_data)
{
  GimpShortcutButton *button = GIMP_SHORTCUT_BUTTON (widget);

  if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (button)))
    {
      GdkModifierType accel_mods = 0;

      accel_mods = event->state;
      accel_mods &= gtk_accelerator_get_default_mod_mask ();

      if (button->priv->modifier_only_accepted)
        {
          if (button->priv->single_modifier)
            {
              if (event->is_modifier)
                {
                  gimp_shortcut_button_set_accelerator (button, NULL, event->keyval, 0);
                  gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), FALSE);
                }
            }
          else
            {
              button->priv->last_keyval    = event->keyval;
              button->priv->last_modifiers = accel_mods;
              if ((event->is_modifier || accel_mods != 0) && button->priv->timer == 0)
                {
                  button->priv->timer = g_timeout_add (250,
                                                       (GSourceFunc) gimp_shortcut_button_timeout,
                                                       button);
                }
            }
        }
      else if (! event->is_modifier)
        {
          gimp_shortcut_button_set_accelerator (button, NULL, event->keyval, event->state);
          gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), FALSE);
        }
      return TRUE;
    }
  return FALSE;
}

static gboolean
gimp_shortcut_button_focus_out_event (GimpShortcutButton* button,
                                      GdkEventFocus       event,
                                      gpointer            user_data)
{
  /* On losing focus, we untoggle, so we don't have to grab anything.
   * Let's avoid cases with several shortcut buttons all grabbing the
   * same shortcuts for instance.
   */
  if (button->priv->timer != 0)
    {
      g_source_remove (button->priv->timer);
      button->priv->timer = 0;
    }

  gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), FALSE);

  /* Propagate event further. */
  return FALSE;
}

static void
gimp_shortcut_button_toggled (GimpShortcutButton* button,
                              gpointer            user_data)
{
  gimp_shortcut_button_update_label (button);

  if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (button)) ||
      (button->priv->keyval == 0 && button->priv->modifiers == 0))
    gtk_stack_set_visible_child_name (GTK_STACK (button->priv->stack), "label");
  else
    gtk_stack_set_visible_child_name (GTK_STACK (button->priv->stack), "shortcut-label");
}

static void
gimp_shortcut_button_update_label (GimpShortcutButton *button)
{
  GtkWidget *label;
  gchar     *markup;

  g_return_if_fail (GIMP_IS_SHORTCUT_BUTTON (button));

  label = gtk_stack_get_child_by_name (GTK_STACK (button->priv->stack),
                                       "label");

  if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (button)))
    {
      if (button->priv->modifier_only_accepted)
        markup = g_strdup_printf ("<b>%s</b>", _("Set modifier"));
      else
        markup = g_strdup_printf ("<b>%s</b>", _("Set shortcut"));
    }
  else
    {
      if (button->priv->modifier_only_accepted)
        markup = g_strdup_printf ("<i>%s</i>", _("No modifier"));
      else
        markup = g_strdup_printf ("<i>%s</i>", _("No shortcut"));
    }
  gtk_label_set_markup (GTK_LABEL (label), markup);
  g_free (markup);
}

static gboolean
gimp_shortcut_button_timeout (GimpShortcutButton *button)
{
  gimp_shortcut_button_set_accelerator (button, NULL,
                                        button->priv->last_keyval,
                                        button->priv->last_modifiers);

  gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), FALSE);

  button->priv->timer = 0;

  return G_SOURCE_REMOVE;
}

static void
gimp_shortcut_button_keyval_to_modifiers (guint            keyval,
                                          GdkModifierType *modifiers)
{
  /* XXX I believe that more keysyms are considered modifiers, but let's
   * start with this. This basic list is basically taken from GDK code
   * in gdk/quartz/gdkevents-quartz.c file.
   */
  GdkModifierType mask = 0;

  switch (keyval)
    {
    case GDK_KEY_Meta_R:
    case GDK_KEY_Meta_L:
      mask = GDK_MOD2_MASK;
      break;
    case GDK_KEY_Shift_R:
    case GDK_KEY_Shift_L:
      mask = GDK_SHIFT_MASK;
      break;
    case GDK_KEY_Caps_Lock:
      mask = GDK_LOCK_MASK;
      break;
    case GDK_KEY_Alt_R:
    case GDK_KEY_Alt_L:
      mask = GDK_MOD1_MASK;
      break;
    case GDK_KEY_Control_R:
    case GDK_KEY_Control_L:
      mask = GDK_CONTROL_MASK;
      break;
    default:
      mask = 0;
    }

  *modifiers |= mask;
}