PIKApp/app/widgets/pikaactionimpl.c

/* PIKA - Photo and Image Kooker Application
 * a rebranding of The GNU Image Manipulation Program (created with heckimp)
 * A derived work which may be trivial. However, any changes may be (C)2023 by Aldercone Studio
 *
 * Original copyright, applying to most contents (license remains unchanged): 
 * Copyright (C) 1995 Spencer Kimball and Peter Mattis
 *
 * pikaaction.c
 * Copyright (C) 2004-2019 Michael Natterer <mitch@gimp.org>
 *
 * 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 "libpikabase/pikabase.h"

#include "widgets-types.h"

#include "pikaaction.h"
#include "pikaactionimpl.h"
#include "pikaaction-history.h"


enum
{
  PROP_0,
  PROP_ENABLED = PIKA_ACTION_PROP_LAST + 1,
  PROP_PARAMETER_TYPE,
  PROP_STATE_TYPE,
  PROP_STATE
};

enum
{
  CHANGE_STATE,
  LAST_SIGNAL
};

struct _PikaActionImplPrivate
{
  GVariantType *parameter_type;
  GVariant     *state;
  GVariant     *state_hint;
  gboolean      state_set_already;
};

static void   pika_action_g_action_iface_init     (GActionInterface    *iface);

static void   pika_action_impl_finalize           (GObject             *object);
static void   pika_action_impl_set_property       (GObject             *object,
                                                   guint                prop_id,
                                                   const GValue        *value,
                                                   GParamSpec          *pspec);
static void   pika_action_impl_get_property       (GObject             *object,
                                                   guint                prop_id,
                                                   GValue              *value,
                                                   GParamSpec          *pspec);

/* XXX Implementations for our PikaAction are widely inspired by GSimpleAction
 * implementations.
 */
static void   pika_action_impl_activate           (GAction             *action,
                                                   GVariant            *parameter);
static void   pika_action_impl_change_state       (GAction             *action,
                                                   GVariant            *value);
static gboolean pika_action_impl_get_enabled      (GAction             *action);
static const GVariantType *
              pika_action_impl_get_parameter_type (GAction             *action);
static const GVariantType *
              pika_action_impl_get_state_type     (GAction             *action);
static GVariant *
              pika_action_impl_get_state          (GAction             *action);
static GVariant *
              pika_action_impl_get_state_hint     (GAction             *action);

static void   pika_action_impl_set_state          (PikaAction          *pika_action,
                                                   GVariant            *value);


G_DEFINE_TYPE_WITH_CODE (PikaActionImpl, pika_action_impl, PIKA_TYPE_OBJECT,
                         G_ADD_PRIVATE (PikaActionImpl)
                         G_IMPLEMENT_INTERFACE (G_TYPE_ACTION, pika_action_g_action_iface_init)
                         G_IMPLEMENT_INTERFACE (PIKA_TYPE_ACTION, NULL))

#define parent_class pika_action_impl_parent_class

static guint pika_action_impl_signals[LAST_SIGNAL] = { 0 };

static void
pika_action_impl_class_init (PikaActionImplClass *klass)
{
  GObjectClass *object_class = G_OBJECT_CLASS (klass);

  pika_action_impl_signals[CHANGE_STATE] =
    g_signal_new ("change-state",
                  G_TYPE_FROM_CLASS (klass),
                  G_SIGNAL_RUN_LAST | G_SIGNAL_MUST_COLLECT,
                  G_STRUCT_OFFSET (PikaActionImplClass, change_state),
                  NULL, NULL, NULL,
                  G_TYPE_NONE, 1,
                  G_TYPE_VARIANT);

  object_class->finalize      = pika_action_impl_finalize;
  object_class->set_property  = pika_action_impl_set_property;
  object_class->get_property  = pika_action_impl_get_property;

  pika_action_install_properties (object_class);

  /**
   * PikaAction:enabled:
   *
   * If @action is currently enabled.
   *
   * If the action is disabled then calls to g_action_activate() and
   * g_action_change_state() have no effect.
   **/
  g_object_class_install_property (object_class, PROP_ENABLED,
                                   g_param_spec_boolean ("enabled",
                                                         "Enabled",
                                                         "If the action can be activated",
                                                         TRUE,
                                                         PIKA_PARAM_READWRITE));
  /**
   * PikaAction:parameter-type:
   *
   * The type of the parameter that must be given when activating the
   * action.
   **/
  g_object_class_install_property (object_class, PROP_PARAMETER_TYPE,
                                   g_param_spec_boxed ("parameter-type",
                                                       "Parameter Type",
                                                       "The type of GVariant passed to activate()",
                                                       G_TYPE_VARIANT_TYPE,
                                                       PIKA_PARAM_READWRITE |
                                                       G_PARAM_CONSTRUCT_ONLY));
  /**
   * PikaAction:state-type:
   *
   * The #GVariantType of the state that the action has, or %NULL if the
   * action is stateless.
   **/
  g_object_class_install_property (object_class, PROP_STATE_TYPE,
                                   g_param_spec_boxed ("state-type",
                                                       "State Type",
                                                       "The type of the state kept by the action",
                                                       G_TYPE_VARIANT_TYPE,
                                                       PIKA_PARAM_READABLE));

  /**
   * PikaAction:state:
   *
   * The state of the action, or %NULL if the action is stateless.
   **/
  g_object_class_install_property (object_class, PROP_STATE,
                                   g_param_spec_variant ("state",
                                                         "State",
                                                         "The state the action is in",
                                                         G_VARIANT_TYPE_ANY,
                                                         NULL,
                                                         PIKA_PARAM_READWRITE | G_PARAM_CONSTRUCT));
}

static void
pika_action_g_action_iface_init (GActionInterface *iface)
{
  iface->activate           = pika_action_impl_activate;
  iface->change_state       = pika_action_impl_change_state;
  iface->get_enabled        = pika_action_impl_get_enabled;
  iface->get_name           = (const gchar* (*) (GAction*)) pika_action_get_name;
  iface->get_parameter_type = pika_action_impl_get_parameter_type;
  iface->get_state_type     = pika_action_impl_get_state_type;
  iface->get_state          = pika_action_impl_get_state;
  iface->get_state_hint     = pika_action_impl_get_state_hint;
}

static void
pika_action_impl_init (PikaActionImpl *impl)
{
  impl->priv                    = pika_action_impl_get_instance_private (impl);
  impl->priv->state_set_already = FALSE;

  pika_action_init (PIKA_ACTION (impl));
}

static void
pika_action_impl_finalize (GObject *object)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (object);

  if (impl->priv->parameter_type)
    g_variant_type_free (impl->priv->parameter_type);
  if (impl->priv->state)
    g_variant_unref (impl->priv->state);
  if (impl->priv->state_hint)
    g_variant_unref (impl->priv->state_hint);

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

static void
pika_action_impl_get_property (GObject    *object,
                               guint       prop_id,
                               GValue     *value,
                               GParamSpec *pspec)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (object);

  switch (prop_id)
    {
    case PROP_ENABLED:
      g_value_set_boolean (value, pika_action_impl_get_enabled (G_ACTION (impl)));
      break;
    case PROP_PARAMETER_TYPE:
      g_value_set_boxed (value, pika_action_impl_get_parameter_type (G_ACTION (impl)));
      break;
    case PROP_STATE_TYPE:
      g_value_set_boxed (value, pika_action_impl_get_state_type (G_ACTION (impl)));
      break;
    case PROP_STATE:
      g_value_take_variant (value, pika_action_impl_get_state (G_ACTION (impl)));
      break;

    default:
      pika_action_get_property (object, prop_id, value, pspec);
      break;
    }
}

static void
pika_action_impl_set_property (GObject      *object,
                               guint         prop_id,
                               const GValue *value,
                               GParamSpec   *pspec)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (object);

  switch (prop_id)
    {
    case PROP_ENABLED:
      pika_action_set_sensitive (PIKA_ACTION (impl),
                                 g_value_get_boolean (value), NULL);
      break;
    case PROP_PARAMETER_TYPE:
      impl->priv->parameter_type = g_value_dup_boxed (value);
      break;
    case PROP_STATE:
      /* The first time we see this (during construct) we should just
       * take the state as it was handed to us.
       *
       * After that, we should make sure we go through the same checks
       * as the C API.
       */
      if (!impl->priv->state_set_already)
        {
          impl->priv->state             = g_value_dup_variant (value);
          impl->priv->state_set_already = TRUE;
        }
      else
        {
          pika_action_impl_set_state (PIKA_ACTION (impl), g_value_get_variant (value));
        }

      break;

    default:
      pika_action_set_property (object, prop_id, value, pspec);
      break;
    }
}

static void
pika_action_impl_activate (GAction  *action,
                           GVariant *parameter)
{
  g_object_add_weak_pointer (G_OBJECT (action), (gpointer) &action);

  pika_action_emit_activate (PIKA_ACTION (action), parameter);

  if (action != NULL)
    {
      /* Some actions are self-destructive, such as the "windows-recent-*"
       * actions which don't exist after being run. Don't log these.
       */
      g_object_remove_weak_pointer (G_OBJECT (action), (gpointer) &action);

      pika_action_history_action_activated (PIKA_ACTION (action));
    }
}

static void
pika_action_impl_change_state (GAction  *action,
                               GVariant *value)
{
  /* If the user connected a signal handler then they are responsible
   * for handling state changes.
   */
  if (g_signal_has_handler_pending (action, pika_action_impl_signals[CHANGE_STATE], 0, TRUE))
    g_signal_emit (action, pika_action_impl_signals[CHANGE_STATE], 0, value);
  else
    /* If not, then the default behavior is to just set the state. */
    pika_action_impl_set_state (PIKA_ACTION (action), value);
}

static gboolean
pika_action_impl_get_enabled (GAction *action)
{
  return pika_action_is_sensitive (PIKA_ACTION (action), NULL);
}

static const GVariantType *
pika_action_impl_get_parameter_type (GAction *action)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (action);

  return impl->priv->parameter_type;
}

static const GVariantType *
pika_action_impl_get_state_type (GAction *action)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (action);

  if (impl->priv->state != NULL)
    return g_variant_get_type (impl->priv->state);
  else
    return NULL;
}

static GVariant *
pika_action_impl_get_state (GAction *action)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (action);

  return impl->priv->state ? g_variant_ref (impl->priv->state) : NULL;
}

static GVariant *
pika_action_impl_get_state_hint (GAction *action)
{
  PikaActionImpl *impl = PIKA_ACTION_IMPL (action);

  if (impl->priv->state_hint != NULL)
    return g_variant_ref (impl->priv->state_hint);
  else
    return NULL;
}


/*  public functions  */

PikaAction *
pika_action_impl_new (const gchar *name,
                      const gchar *label,
                      const gchar *short_label,
                      const gchar *tooltip,
                      const gchar *icon_name,
                      const gchar *help_id,
                      PikaContext *context)
{
  PikaAction *action;

  action = g_object_new (PIKA_TYPE_ACTION_IMPL,
                         "name",        name,
                         "label",       label,
                         "short-label", short_label,
                         "tooltip",     tooltip,
                         "icon-name",   icon_name,
                         "context",     context,
                         NULL);

  pika_action_set_help_id (action, help_id);

  return action;
}


/*  private functions  */

static void
pika_action_impl_set_state (PikaAction *pika_action,
                            GVariant   *value)
{
  PikaActionImpl     *impl;
  const GVariantType *state_type;

  g_return_if_fail (PIKA_IS_ACTION (pika_action));
  g_return_if_fail (value != NULL);

  impl = PIKA_ACTION_IMPL (pika_action);

  state_type = impl->priv->state ? g_variant_get_type (impl->priv->state) : NULL;

  g_return_if_fail (state_type != NULL);
  g_return_if_fail (g_variant_is_of_type (value, state_type));

  g_variant_ref_sink (value);

  if (! impl->priv->state || ! g_variant_equal (impl->priv->state, value))
    {
      if (impl->priv->state)
        g_variant_unref (impl->priv->state);

      impl->priv->state = g_variant_ref (value);

      g_object_notify (G_OBJECT (impl), "state");
    }

  g_variant_unref (value);
}