<HTML ><HEAD ><TITLE >gnome-sound</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK REL="HOME" TITLE="Gnome Library Reference Manual" HREF="book1.html"><LINK REL="UP" TITLE="Gnome Library" HREF="libgnome.html"><LINK REL="PREVIOUS" TITLE="gnome-score" HREF="gnome-gnome-score.html"><LINK REL="NEXT" TITLE="gnome-triggers" HREF="gnome-gnome-triggers.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TH COLSPAN="4" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="5" >Gnome Library Reference Manual</FONT ></TH ></TR ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnome-gnome-score.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gnome-gnome-triggers.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOME-GNOME-SOUND" >gnome-sound</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN4059" ></A ><H2 >Name</H2 >gnome-sound -- Sound playing routines for GNOME applications</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN4062" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> void <A HREF="gnome-gnome-sound.html#GNOME-SOUND-INIT" >gnome_sound_init</A > (const char *hostname); void <A HREF="gnome-gnome-sound.html#GNOME-SOUND-SHUTDOWN" >gnome_sound_shutdown</A > (void); int <A HREF="gnome-gnome-sound.html#GNOME-SOUND-SAMPLE-LOAD" >gnome_sound_sample_load</A > (const char *sample_name, const char *filename); void <A HREF="gnome-gnome-sound.html#GNOME-SOUND-PLAY" >gnome_sound_play</A > (const char *filename);</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4069" ></A ><H2 >Description</H2 ><P >These routines provide a simple way of playing sounds.</P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4072" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN4074" ></A ><H3 ><A NAME="GNOME-SOUND-INIT" ></A >gnome_sound_init ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_sound_init (const char *hostname);</PRE ></TD ></TR ></TABLE ><P >Initialize esd connection</P ><P >This routine initializes the applications connection to the system's sound server.</P ><P >The application can expect this to be automatically called if the user has requested GNOME sound support.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4081" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >hostname</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > hostname where esd daemon resides.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4090" ></A ><H3 ><A NAME="GNOME-SOUND-SHUTDOWN" ></A >gnome_sound_shutdown ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_sound_shutdown (void);</PRE ></TD ></TR ></TABLE ><P >shuts down the gnome sound support</P ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4096" ></A ><H3 ><A NAME="GNOME-SOUND-SAMPLE-LOAD" ></A >gnome_sound_sample_load ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >int gnome_sound_sample_load (const char *sample_name, const char *filename);</PRE ></TD ></TR ></TABLE ><P >Loads the audio on <TT CLASS="PARAMETER" ><I >filename</I ></TT > and XXXX</P ><P >Loads a sound file into esound sample with the given name. Returns the esound numeric ID of the sample.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4103" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >sample_name</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the name of the sample</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > the filename where the audio is stored</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > a sample_id, or a negative number otherwise.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4120" ></A ><H3 ><A NAME="GNOME-SOUND-PLAY" ></A >gnome_sound_play ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void gnome_sound_play (const char *filename);</PRE ></TD ></TR ></TABLE ><P >Plays the audio stored in <TT CLASS="PARAMETER" ><I >filename</I ></TT ></P ><P >Convenience routine to play a sound file. Fire and forget.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4127" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > file containing the sound sample</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><BR CLEAR="all"><BR><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnome-gnome-score.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gnome-gnome-triggers.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >gnome-score</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >gnome-triggers</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >