Fix some functions descriptions
[pidgin-git.git] / libpurple / sound-theme-loader.c
blob630266bacef628191bced9b73fdf85a5b1d695bb
1 /*
2 * SoundThemeLoader for libpurple
4 * Pidgin is the legal property of its developers, whose names are too numerous
5 * to list here. Please refer to the COPYRIGHT file distributed with this
6 * source distribution.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
23 #include "internal.h"
24 #include "sound-theme-loader.h"
25 #include "sound-theme.h"
26 #include "util.h"
27 #include "xmlnode.h"
28 #include "debug.h"
30 /*****************************************************************************
31 * Sound Theme Builder
32 *****************************************************************************/
34 static PurpleTheme *
35 purple_sound_loader_build(const gchar *theme_dir)
37 PurpleXmlNode *root_node = NULL, *sub_node;
38 gchar *dir, *filename_full, *data = NULL;
39 PurpleSoundTheme *theme = NULL;
40 const gchar *name;
42 /* Find the theme file */
43 g_return_val_if_fail(theme_dir != NULL, NULL);
44 dir = g_build_filename(theme_dir, "purple", "sound", NULL);
45 filename_full = g_build_filename(dir, "theme.xml", NULL);
47 if (g_file_test(filename_full, G_FILE_TEST_IS_REGULAR))
48 root_node = purple_xmlnode_from_file(dir, "theme.xml", "sound themes", "sound-theme-loader");
50 g_free(filename_full);
51 if (root_node == NULL) {
52 g_free(dir);
53 return NULL;
56 name = purple_xmlnode_get_attrib(root_node, "name");
58 if (name && purple_strequal(purple_xmlnode_get_attrib(root_node, "type"), "sound")) {
59 /* Parse the tree */
60 sub_node = purple_xmlnode_get_child(root_node, "description");
61 data = purple_xmlnode_get_data(sub_node);
63 if (purple_xmlnode_get_attrib(root_node, "name") != NULL) {
64 theme = g_object_new(PURPLE_TYPE_SOUND_THEME,
65 "type", "sound",
66 "name", name,
67 "author", purple_xmlnode_get_attrib(root_node, "author"),
68 "image", purple_xmlnode_get_attrib(root_node, "image"),
69 "directory", dir,
70 "description", data, NULL);
72 sub_node = purple_xmlnode_get_child(root_node, "event");
74 while (sub_node) {
75 purple_sound_theme_set_file(theme,
76 purple_xmlnode_get_attrib(sub_node, "name"),
77 purple_xmlnode_get_attrib(sub_node, "file"));
78 sub_node = purple_xmlnode_get_next_twin(sub_node);
81 } else purple_debug_warning("sound-theme-loader", "Missing attribute or problem with the root element\n");
83 purple_xmlnode_free(root_node);
84 g_free(data);
85 g_free(dir);
86 return PURPLE_THEME(theme);
89 /******************************************************************************
90 * GObject Stuff
91 *****************************************************************************/
93 static void
94 purple_sound_theme_loader_class_init(PurpleSoundThemeLoaderClass *klass)
96 PurpleThemeLoaderClass *loader_klass = PURPLE_THEME_LOADER_CLASS(klass);
98 loader_klass->purple_theme_loader_build = purple_sound_loader_build;
101 GType
102 purple_sound_theme_loader_get_type(void)
104 static GType type = 0;
105 if (type == 0) {
106 static const GTypeInfo info = {
107 sizeof(PurpleSoundThemeLoaderClass),
108 NULL, /* base_init */
109 NULL, /* base_finalize */
110 (GClassInitFunc)purple_sound_theme_loader_class_init, /* class_init */
111 NULL, /* class_finalize */
112 NULL, /* class_data */
113 sizeof(PurpleSoundThemeLoader),
114 0, /* n_preallocs */
115 NULL, /* instance_init */
116 NULL, /* value table */
118 type = g_type_register_static(PURPLE_TYPE_THEME_LOADER,
119 "PurpleSoundThemeLoader", &info, 0);
121 return type;