# HG changeset patch # User Justin Rodriguez # Date 1212801804 0 # Node ID de8f7e6a707a2813dae2740f666758e89467b350 # Parent a4bfb7514607f3b08bc9240352d7637a77634c3b Added basic theme for libpurple to be used by theme manager and loaders (abstract gobject) diff -r a4bfb7514607 -r de8f7e6a707a libpurple/Makefile.am --- a/libpurple/Makefile.am Tue May 27 21:47:41 2008 +0000 +++ b/libpurple/Makefile.am Sat Jun 07 01:23:24 2008 +0000 @@ -77,6 +77,7 @@ sound.c \ sslconn.c \ upnp.c \ + theme.c \ util.c \ value.c \ version.c \ @@ -130,6 +131,7 @@ sound.h \ sslconn.h \ upnp.h \ + theme.h \ util.h \ value.h \ xmlnode.h \ diff -r a4bfb7514607 -r de8f7e6a707a libpurple/theme.c --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/libpurple/theme.c Sat Jun 07 01:23:24 2008 +0000 @@ -0,0 +1,291 @@ +/* + * Themes for LibPurple + * + * Pidgin is the legal property of its developers, whose names are too numerous + * to list here. Please refer to the COPYRIGHT file distributed with this + * source distribution. + * + * 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 2 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, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA + * + */ + +#include "theme.h" + +#define PURPLE_THEME_GET_PRIVATE(PurpleTheme) \ + ((PurpleThemePrivate *) ((PurpleTheme)->priv)) + + +/****************************************************************************** + * Structs + *****************************************************************************/ +typedef struct { + gchar *name; + gchar *author; + gchar *type; + gchar *dir; + PurpleStoredImage *img; +} PurpleThemePrivate; + +/****************************************************************************** + * Globals + *****************************************************************************/ + +/****************************************************************************** + * Enums + *****************************************************************************/ +#define PROP_NAME_S "name" +#define PROP_AUTHOR_S "author" +#define PROP_TYPE_S "type" +#define PROP_DIR_S "dir" +#define PROP_IMAGE_S "image" + +enum { + PROP_ZERO = 0, + PROP_NAME, + PROP_AUTHOR, + PROP_TYPE, + PROP_DIR, + PROP_IMAGE +}; + + +/********************************************************************* + * GObject Stuff * + *********************************************************************/ + +static void +purple_theme_get_property(GObject *obj, guint param_id, GValue *value, + GParamSpec *psec) +{ + PurpleThemePrivate *priv = PURPLE_THEME_GET_PRIVATE(PURPLE_THEME(obj)); + + switch(param_id) { + case PROP_NAME: + g_value_set_string(value, priv->name); + break; + case PROP_AUTHOR: + g_value_set_string(value, priv->author); + break; + case PROP_TYPE: + g_value_set_string(value, priv->type); + break; + case PROP_DIR: + g_value_set_string(value, priv->dir); + break; + case PROP_IMAGE: + g_value_set_pointer(value, priv->img); + break; + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, psec); + break; + } +} + +static void +purple_theme_set_property(GObject *obj, guint param_id, const GValue *value, + GParamSpec *psec) +{ + PurpleThemePrivate *priv = PURPLE_THEME_GET_PRIVATE(PURPLE_THEME(obj)); + PurpleStoredImage *img; + + switch(param_id) { + case PROP_NAME: + if(priv->name) + g_free(priv->name); + priv->name = g_value_dup_string(value); + break; + case PROP_AUTHOR: + if(priv->author) + g_free(priv->author); + priv->author = g_value_dup_string(value); + break; + case PROP_DIR: + if(priv->dir) + g_free(priv->dir); + priv->dir = g_value_dup_string(value); + break; + case PROP_IMAGE: + img = g_value_get_pointer(value); + + purple_imgstore_unref(priv->img); + if (img) + priv->img = img; + break; + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID(obj, param_id, psec); + break; + } +} + +static void +purple_theme_class_init (PurpleThemeClass *klass) +{ + GObjectClass *obj_class = G_OBJECT_CLASS(klass); + GParamSpec *pspec; + + /* 2.4 + * g_type_class_add_private(klass, sizeof(PurpleThemePrivate)); */ + + obj_class->get_property = purple_theme_get_property; + obj_class->set_property = purple_theme_set_property; + + /* NAME */ + pspec = g_param_spec_string(PROP_NAME_S, "Name", + "The name of the theme", + NULL, + G_PARAM_READWRITE | G_PARAM_CONSTRUCT); + g_object_class_install_property(obj_class, PROP_NAME, pspec); + /* AUTHOR */ + pspec = g_param_spec_string(PROP_AUTHOR_S, "Author", + "The author of the theme", + NULL, + G_PARAM_READWRITE | G_PARAM_CONSTRUCT); + g_object_class_install_property(obj_class, PROP_AUTHOR, pspec); + /* TYPE STRING (read only) */ + pspec = g_param_spec_string(PROP_TYPE_S, "Type", + "The string represtenting the type of the theme", + NULL, + G_PARAM_READABLE | G_PARAM_CONSTRUCT_ONLY); + g_object_class_install_property(obj_class, PROP_TYPE, pspec); + /* DIRECTORY */ + pspec = g_param_spec_string(PROP_DIR_S, "Directory", + "The directory that contains the theme and all its files", + NULL, + G_PARAM_READWRITE | G_PARAM_CONSTRUCT); + g_object_class_install_property(obj_class, PROP_DIR, pspec); + /* PREVIEW IMAGE */ + pspec = g_param_spec_pointer(PROP_IMAGE_S, "Image", + "A preview image of the theme", + G_PARAM_READABLE); + g_object_class_install_property(obj_class, PROP_IMAGE, pspec); +} + + +GType +purple_theme_get_type (void) +{ + static GType type = 0; + if (type == 0) { + static const GTypeInfo info = { + sizeof (PurpleThemeClass), + NULL, /* base_init */ + NULL, /* base_finalize */ + (GClassInitFunc)purple_theme_class_init, /* class_init */ + NULL, /* class_finalize */ + NULL, /* class_data */ + sizeof (PurpleTheme), + 0, /* n_preallocs */ + NULL, /* instance_init */ + NULL, /* value table */ + }; + type = g_type_register_static (G_TYPE_OBJECT, + "PurpleThemeType", + &info, G_TYPE_FLAG_ABSTRACT); + } + return type; +} + + +/***************************************************************************** + * Public API functions * + *****************************************************************************/ + +gchar * +purple_theme_get_name(PurpleTheme *theme) +{ + PurpleThemePrivate *priv = NULL; + g_return_val_if_fail(PURPLE_IS_THEME(theme), NULL); + priv = PURPLE_THEME_GET_PRIVATE(theme); + return priv->name; +} + +void +purple_theme_set_name(PurpleTheme *theme, const gchar *name) +{ + PurpleThemePrivate *priv = NULL; + g_return_if_fail(PURPLE_IS_THEME(theme)); + priv = PURPLE_THEME_GET_PRIVATE(theme); + if(priv->name) + g_free(priv->name); + priv->name = g_strdup (name); +} + +gchar * +purple_theme_get_author(PurpleTheme *theme) +{ + PurpleThemePrivate *priv = NULL; + g_return_val_if_fail(PURPLE_IS_THEME(theme), NULL); + priv = PURPLE_THEME_GET_PRIVATE(theme); + return priv->author; +} + +void +purple_theme_set_author(PurpleTheme *theme, const gchar *author) +{ + PurpleThemePrivate *priv = NULL; + g_return_if_fail(PURPLE_IS_THEME(theme)); + priv = PURPLE_THEME_GET_PRIVATE(theme); + if(priv->author) + g_free(priv->author); + priv->author = g_strdup (author); +} + +gchar * +purple_theme_get_type_string(PurpleTheme *theme) +{ + PurpleThemePrivate *priv = NULL; + g_return_val_if_fail(PURPLE_IS_THEME(theme), NULL); + priv = PURPLE_THEME_GET_PRIVATE(theme); + return priv->type; +} + +gchar * +purple_theme_get_dir(PurpleTheme *theme) +{ + PurpleThemePrivate *priv = NULL; + g_return_val_if_fail(PURPLE_IS_THEME(theme), NULL); + priv = PURPLE_THEME_GET_PRIVATE(theme); + return priv->dir; +} + +void +purple_theme_set_dir(PurpleTheme *theme, const gchar *dir) +{ + PurpleThemePrivate *priv = NULL; + g_return_if_fail(PURPLE_IS_THEME(theme)); + priv = PURPLE_THEME_GET_PRIVATE(theme); + if(priv->dir) + g_free(priv->dir); + priv->dir = g_strdup (dir); +} + +PurpleStoredImage * +purple_theme_get_image(PurpleTheme *theme) +{ + PurpleThemePrivate *priv = NULL; + g_return_val_if_fail(PURPLE_IS_THEME(theme), NULL); + priv = PURPLE_THEME_GET_PRIVATE(theme); + return purple_imgstore_ref(priv->img); +} + +void +purple_theme_set_image(PurpleTheme *theme, PurpleStoredImage *img) +{ + PurpleThemePrivate *priv = NULL; + g_return_if_fail(PURPLE_IS_THEME(theme)); + priv = PURPLE_THEME_GET_PRIVATE(theme); + purple_imgstore_unref(priv->img); + priv->img = img; +} diff -r a4bfb7514607 -r de8f7e6a707a libpurple/theme.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/libpurple/theme.h Sat Jun 07 01:23:24 2008 +0000 @@ -0,0 +1,160 @@ +/** + * @file purpletheme.h Purple Theme Abstact Class API + */ + +/* purple + * + * Purple is the legal property of its developers, whose names are too numerous + * to list here. Please refer to the COPYRIGHT file distributed with this + * source distribution. + * + * 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 2 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, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA + */ + +#ifndef _PURPLE_THEME_H_ +#define _PURPLE_THEME_H_ + +#include +#include +#include "imgstore.h" + +/** + * A purple theme. + * This is an abstract class for Purple to use with the Purple theme manager. + * + * PurpleTheme is a GObject. + */ +typedef struct _PurpleTheme PurpleTheme; +typedef struct _PurpleThemeClass PurpleThemeClass; + +#define PURPLE_TYPE_THEME (purple_theme_get_type ()) +#define PURPLE_THEME(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), PURPLE_TYPE_THEME, PurpleTheme)) +#define PURPLE_THEME_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), PURPLE_TYPE_THEME, PurpleThemeClass)) +#define PURPLE_IS_THEME(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), PURPLE_TYPE_THEME)) +#define PURPLE_IS_THEME_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), PURPLE_TYPE_THEME)) +#define PURPLE_THEME_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), PURPLE_TYPE_THEME, PurpleThemeClass)) + +struct _PurpleTheme +{ + GObject parent; + gpointer priv; +}; + +struct _PurpleThemeClass +{ + GObjectClass parent_class; +}; + +/**************************************************************************/ +/** @name Purple Theme API */ +/**************************************************************************/ +G_BEGIN_DECLS + +/** + * GObject foo. + * @internal. + */ +GType purple_theme_get_type(void); + +/** + * Creates a new PurpleTheme object + * + * @param name the purple theme name + * @param author the purple theme author + * @param type the purple theme type + * + * @return a new PurpleTheme object + */ +PurpleTheme *purple_theme_new(const gchar *name, const gchar *author, const gchar *type); + +/** + * Returns the name of the PurpleTheme object + * + * @param theme the purple theme + * + * @return The string representating the name of the theme + */ +gchar *purple_theme_get_name(PurpleTheme *theme); + +/** + * Sets the name of the PurpleTheme object + * + * @param theme the purple theme + * @param name the name of the PurpleTheme object + */ +void purple_theme_set_name(PurpleTheme *theme, const gchar *name); + +/** + * Returns the author of the PurpleTheme object + * + * @param theme the purple theme + * + * @return The author of the theme + */ +gchar *purple_theme_get_author(PurpleTheme *theme); + +/** + * Sets the author of the PurpleTheme object + * + * @param theme the purple theme + * @param author the author of the PurpleTheme object + */ +void purple_theme_set_author(PurpleTheme *theme, const gchar *author); + +/** + * Returns the type (string) of the PurpleTheme object + * + * @param theme the purple theme + * + * @return The string represtenting the type + */ +gchar *purple_theme_get_type_string(PurpleTheme *theme); + +/** + * Returns the directory of the PurpleTheme object + * + * @param theme the purple theme + * + * @return The string represtenting the theme directory + */ +gchar *purple_theme_get_dir(PurpleTheme *theme); + +/** + * Sets the directory of the PurpleTheme object + * + * @param theme the purple theme + * @param dir the directory of the PurpleTheme object + */ +void purple_theme_set_dir(PurpleTheme *theme, const gchar *dir); + +/** + * Returns the image preview of the PurpleTheme object + * + * @param theme the purple theme + * + * @return The PurpleStoredImage preview of the PurpleTheme object + */ +PurpleStoredImage *purple_theme_get_image(PurpleTheme *theme); + +/** + * Sets the directory of the PurpleTheme object + * + * @param theme the purple theme + * @param img the image preview of the PurpleTheme object + */ +void purple_theme_set_image(PurpleTheme *theme, PurpleStoredImage *img); + +G_END_DECLS +#endif /* _PURPLE_THEME_H_ */