/* 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-1997 Spencer Kimball and Peter Mattis
*
* 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 .
*/
#include "config.h"
#include
#include
#include
#include "libpikabase/pikabase.h"
#include "core-types.h"
#include "pika-memsize.h"
#include "pikaobject.h"
#include "pika-debug.h"
enum
{
DISCONNECT,
NAME_CHANGED,
LAST_SIGNAL
};
enum
{
PROP_0,
PROP_NAME,
N_PROPS
};
struct _PikaObjectPrivate
{
gchar *name;
gchar *normalized;
guint static_name : 1;
guint disconnected : 1;
};
static void pika_object_constructed (GObject *object);
static void pika_object_dispose (GObject *object);
static void pika_object_finalize (GObject *object);
static void pika_object_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec);
static void pika_object_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec);
static gint64 pika_object_real_get_memsize (PikaObject *object,
gint64 *gui_size);
static void pika_object_name_normalize (PikaObject *object);
G_DEFINE_TYPE_WITH_CODE (PikaObject, pika_object, G_TYPE_OBJECT,
G_ADD_PRIVATE (PikaObject))
#define parent_class pika_object_parent_class
static guint object_signals[LAST_SIGNAL] = { 0 };
static GParamSpec *object_props[N_PROPS] = { NULL, };
static void
pika_object_class_init (PikaObjectClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
parent_class = g_type_class_peek_parent (klass);
object_signals[DISCONNECT] =
g_signal_new ("disconnect",
G_TYPE_FROM_CLASS (klass),
G_SIGNAL_RUN_FIRST,
G_STRUCT_OFFSET (PikaObjectClass, disconnect),
NULL, NULL, NULL,
G_TYPE_NONE, 0);
object_signals[NAME_CHANGED] =
g_signal_new ("name-changed",
G_TYPE_FROM_CLASS (klass),
G_SIGNAL_RUN_FIRST,
G_STRUCT_OFFSET (PikaObjectClass, name_changed),
NULL, NULL, NULL,
G_TYPE_NONE, 0);
object_class->constructed = pika_object_constructed;
object_class->dispose = pika_object_dispose;
object_class->finalize = pika_object_finalize;
object_class->set_property = pika_object_set_property;
object_class->get_property = pika_object_get_property;
klass->disconnect = NULL;
klass->name_changed = NULL;
klass->get_memsize = pika_object_real_get_memsize;
object_props[PROP_NAME] = g_param_spec_string ("name",
NULL, NULL,
NULL,
PIKA_PARAM_READWRITE |
G_PARAM_CONSTRUCT);
g_object_class_install_properties (object_class, N_PROPS, object_props);
}
static void
pika_object_init (PikaObject *object)
{
object->p = pika_object_get_instance_private (object);
object->p->name = NULL;
object->p->normalized = NULL;
}
static void
pika_object_constructed (GObject *object)
{
G_OBJECT_CLASS (parent_class)->constructed (object);
pika_debug_add_instance (object, G_OBJECT_GET_CLASS (object));
}
static void
pika_object_dispose (GObject *object)
{
PikaObject *pika_object = PIKA_OBJECT (object);
if (! pika_object->p->disconnected)
{
g_signal_emit (object, object_signals[DISCONNECT], 0);
pika_object->p->disconnected = TRUE;
}
G_OBJECT_CLASS (parent_class)->dispose (object);
}
static void
pika_object_finalize (GObject *object)
{
pika_object_name_free (PIKA_OBJECT (object));
pika_debug_remove_instance (object);
G_OBJECT_CLASS (parent_class)->finalize (object);
}
static void
pika_object_set_property (GObject *object,
guint property_id,
const GValue *value,
GParamSpec *pspec)
{
PikaObject *pika_object = PIKA_OBJECT (object);
switch (property_id)
{
case PROP_NAME:
pika_object_set_name (pika_object, g_value_get_string (value));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
break;
}
}
static void
pika_object_get_property (GObject *object,
guint property_id,
GValue *value,
GParamSpec *pspec)
{
PikaObject *pika_object = PIKA_OBJECT (object);
switch (property_id)
{
case PROP_NAME:
if (pika_object->p->static_name)
g_value_set_static_string (value, pika_object->p->name);
else
g_value_set_string (value, pika_object->p->name);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
break;
}
}
/**
* pika_object_set_name:
* @object: a #PikaObject
* @name: the @object's new name (transfer none)
*
* Sets the @object's name. Takes care of freeing the old name and
* emitting the ::name_changed signal if the old and new name differ.
**/
void
pika_object_set_name (PikaObject *object,
const gchar *name)
{
g_return_if_fail (PIKA_IS_OBJECT (object));
if (! g_strcmp0 (object->p->name, name))
return;
pika_object_name_free (object);
object->p->name = g_strdup (name);
object->p->static_name = FALSE;
pika_object_name_changed (object);
g_object_notify_by_pspec (G_OBJECT (object), object_props[PROP_NAME]);
}
/**
* pika_object_set_name_safe:
* @object: a #PikaObject
* @name: the @object's new name (transfer none)
*
* A safe version of pika_object_set_name() that takes care of
* handling newlines and overly long names. The actual name set
* may be different to the @name you pass.
**/
void
pika_object_set_name_safe (PikaObject *object,
const gchar *name)
{
g_return_if_fail (PIKA_IS_OBJECT (object));
if (! g_strcmp0 (object->p->name, name))
return;
pika_object_name_free (object);
object->p->name = pika_utf8_strtrim (name, 30);
object->p->static_name = FALSE;
pika_object_name_changed (object);
g_object_notify_by_pspec (G_OBJECT (object), object_props[PROP_NAME]);
}
/**
* pika_object_set_static_name:
* @object: a #PikaObject
* @name: the @object's new name as a static string
*
* Sets the @object's name.
* Takes care of freeing the old name (when it was not statically set)
* and emits the ::name_changed signal if the old and new name differ.
*
* This function is a variant of pika_object_set_name() which assumes that
* the string is static and optimizes for this use case.
* Do not ever use this function with allocated strings.
**/
void
pika_object_set_static_name (PikaObject *object,
const gchar *name)
{
g_return_if_fail (PIKA_IS_OBJECT (object));
if (! g_strcmp0 (object->p->name, name))
return;
pika_object_name_free (object);
object->p->name = (gchar *) name;
object->p->static_name = TRUE;
pika_object_name_changed (object);
g_object_notify_by_pspec (G_OBJECT (object), object_props[PROP_NAME]);
}
/**
* pika_object_take_name:
* @object: a #PikaObject
* @name: the @object's new name (transfer full)
*
* Sets the @object's name. Takes care of freeing the old name and
* emitting the ::name_changed signal if the old and new name differ.
*
* Only use this function with GLib allocated strings.
*
* PikaObject will own the @name pointer and will dispose it when
* no longer needed or when it is the same as stored name.
* Calling code should *not* g_free() passed @name at all.
**/
void
pika_object_take_name (PikaObject *object,
gchar *name)
{
g_return_if_fail (PIKA_IS_OBJECT (object));
if (! g_strcmp0 (object->p->name, name))
{
g_free (name);
return;
}
pika_object_name_free (object);
object->p->name = name;
object->p->static_name = FALSE;
pika_object_name_changed (object);
g_object_notify_by_pspec (G_OBJECT (object), object_props[PROP_NAME]);
}
/**
* pika_object_get_name:
* @object: a #PikaObject
*
* This function gives access to the name of a PikaObject. The
* returned name belongs to the object and must not be freed.
*
* Returns: a pointer to the @object's name
**/
const gchar *
pika_object_get_name (gconstpointer object)
{
const PikaObject *object_typed = object;
g_return_val_if_fail (PIKA_IS_OBJECT (object_typed), NULL);
return object_typed->p->name;
}
/**
* pika_object_name_changed:
* @object: a #PikaObject
*
* Causes the ::name-changed signal to be emitted.
**/
void
pika_object_name_changed (PikaObject *object)
{
g_return_if_fail (PIKA_IS_OBJECT (object));
g_signal_emit (object, object_signals[NAME_CHANGED], 0);
}
/**
* pika_object_name_free:
* @object: a #PikaObject
*
* Frees the name of @object and sets the name pointer to %NULL. Also
* takes care of the normalized name that the object might be caching.
*
* In general you should be using pika_object_set_name() instead. But
* if you ever need to free the object name but don't want the
* ::name-changed signal to be emitted, then use this function. Never
* ever free the object name directly!
**/
void
pika_object_name_free (PikaObject *object)
{
if (object->p->normalized)
{
if (object->p->normalized != object->p->name)
g_free (object->p->normalized);
object->p->normalized = NULL;
}
if (object->p->name)
{
if (! object->p->static_name)
g_free (object->p->name);
object->p->name = NULL;
object->p->static_name = FALSE;
}
}
/**
* pika_object_name_collate:
* @object1: a #PikaObject
* @object2: another #PikaObject
*
* Compares two object names for ordering using the linguistically
* correct rules for the current locale. It caches the normalized
* version of the object name to speed up subsequent calls.
*
* Returns: -1 if object1 compares before object2,
* 0 if they compare equal,
* 1 if object1 compares after object2.
**/
gint
pika_object_name_collate (PikaObject *object1,
PikaObject *object2)
{
if (! object1->p->normalized)
pika_object_name_normalize (object1);
if (! object2->p->normalized)
pika_object_name_normalize (object2);
return strcmp (object1->p->normalized, object2->p->normalized);
}
static void
pika_object_name_normalize (PikaObject *object)
{
g_return_if_fail (object->p->normalized == NULL);
if (object->p->name)
{
gchar *key = g_utf8_collate_key (object->p->name, -1);
if (strcmp (key, object->p->name))
{
object->p->normalized = key;
}
else
{
g_free (key);
object->p->normalized = object->p->name;
}
}
}
#define DEBUG_MEMSIZE 1
#ifdef DEBUG_MEMSIZE
gboolean pika_debug_memsize = FALSE;
#endif
gint64
pika_object_get_memsize (PikaObject *object,
gint64 *gui_size)
{
gint64 my_size = 0;
gint64 my_gui_size = 0;
g_return_val_if_fail (object == NULL || PIKA_IS_OBJECT (object), 0);
if (! object)
{
if (gui_size)
*gui_size = 0;
return 0;
}
#ifdef DEBUG_MEMSIZE
if (pika_debug_memsize)
{
static gint indent_level = 0;
static GList *aggregation_tree = NULL;
static gchar indent_buf[256];
gint64 memsize;
gint64 gui_memsize = 0;
gint i;
gint my_indent_level;
gchar *object_size;
indent_level++;
my_indent_level = indent_level;
memsize = PIKA_OBJECT_GET_CLASS (object)->get_memsize (object,
&gui_memsize);
indent_level--;
for (i = 0; i < MIN (my_indent_level * 2, sizeof (indent_buf) - 1); i++)
indent_buf[i] = ' ';
indent_buf[i] = '\0';
object_size = g_strdup_printf ("%s%s \"%s\": "
"%" G_GINT64_FORMAT
"(%" G_GINT64_FORMAT ")\n",
indent_buf,
g_type_name (G_TYPE_FROM_INSTANCE (object)),
object->p->name ? object->p->name : "anonymous",
memsize,
gui_memsize);
aggregation_tree = g_list_prepend (aggregation_tree, object_size);
if (indent_level == 0)
{
GList *list;
for (list = aggregation_tree; list; list = g_list_next (list))
{
g_print ("%s", (gchar *) list->data);
g_free (list->data);
}
g_list_free (aggregation_tree);
aggregation_tree = NULL;
}
return memsize;
}
#endif /* DEBUG_MEMSIZE */
my_size = PIKA_OBJECT_GET_CLASS (object)->get_memsize (object,
&my_gui_size);
if (gui_size)
*gui_size = my_gui_size;
return my_size;
}
static gint64
pika_object_real_get_memsize (PikaObject *object,
gint64 *gui_size)
{
gint64 memsize = 0;
if (! object->p->static_name)
memsize += pika_string_get_memsize (object->p->name);
return memsize + pika_g_object_get_memsize ((GObject *) object);
}