view src/gtksound.h @ 9387:bcdf6a530d41

[gaim-migrate @ 10195] (20:11:29) nosnilmot: s/To/Too/ in Chip's news entry :) (20:11:44) LSchiere: no, i'm not changing that one. he can fix his own grammer and spelling ;-) (20:11:53) LSchiere: then someone besides me can have spelling mistakes on file (20:11:55) nosnilmot: but he had to go... :) (20:11:58) SimGuy: LSchiere: I think you had a spelling error (20:12:04) LSchiere: see? someone has to keep me company (20:12:05) SimGuy: unless someone told you already (20:12:09) LSchiere: nope (20:12:32) SimGuy: s/writters/writers/ (20:12:38) LSchiere: *sigh* (20:12:56) nosnilmot: SimGuy: I don't know about you, but I'd be happy as a writter (20:13:16) aatharuv: LSchiere: oh, also s/Zepher/Zephyr/ :-) (20:13:23) nosnilmot: oh yeah, that too :) (20:13:24) LSchiere: where is that? (20:13:26) SimGuy: yeah, but I didn't contribute anything meaningful, so I don't get to be a writter, therefore I must take the honor from you (20:13:29) nosnilmot: ChangeLog (20:13:32) LSchiere: oh committer: Tailor Script <[e-mail]>

/**
 * @file gtksound.h GTK+ Sound API
 *
 * gaim
 *
 * Gaim 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef _GAIM_GTKSOUND_H_
#define _GAIM_GTKSOUND_H_

/**************************************************************************/
/** @name GTK+ Sound API                                                  */
/**************************************************************************/
/*@{*/

/**
 * Gets GTK Sound UI opsA
 *
 * @return UI operations struct
 */
GaimSoundUiOps *gaim_gtk_sound_get_ui_ops(void);

/**
 * Mutes or un-mutes sounds.
 *
 * @param mute The mute state.
 */
void gaim_gtk_sound_set_mute(gboolean mute);

/**
 * Gets mute state for sounds.
 *
 * @return The mute state.
 */
gboolean gaim_gtk_sound_get_mute();

/**
 * Mutes or un-mutes login sounds.
 *
 * @param mute The mute state.
 */
void gaim_gtk_sound_set_login_mute(gboolean mute);

/**
 * Get the prefs option for an event.
 *
 * @param event The event.
 * @return The option.
 */
const char *gaim_gtk_sound_get_event_option(GaimSoundEventID event);

/**
 * Get the label for an event.
 *
 * @param event The event.
 * @return The label.
 */
char *gaim_gtk_sound_get_event_label(GaimSoundEventID event);

/*@}*/

#endif /* _GAIM_GTKSOUND_H_ */