added wxMemoryInputStream(wxMemoryOutputStream&) ctor (patch 1170635)

[wxWidgets.git] / docs / latex / wx / sound.tex

diff --git a/docs/latex/wx/sound.tex b/docs/latex/wx/sound.tex
index 4d6ee2e4980d530b58e16ad2d990caad92268151..fd48c22e874f7fc97f7dca31229af99ea3c78e94 100644 (file)
--- a/docs/latex/wx/sound.tex
+++ b/docs/latex/wx/sound.tex
@@ -1,8 +1,10 @@
 \section{\class{wxSound}}\label{wxsound}
 
 \section{\class{wxSound}}\label{wxsound}
 

-This class represents a short wave file, in Windows WAV format, that
+This class represents a short sound (loaded from Windows WAV file), that

 can be stored in memory and played. Currently this class is implemented
 can be stored in memory and played. Currently this class is implemented

-on Windows and Linux only.
+on Windows and Unix (and uses either 
+\urlref{Open Sound System}{http://www.opensound.com/oss.html} or 
+\urlref{Simple DirectMedia Layer}{http://www.libsdl.org/}).

 
 \wxheading{Derived from}
 
 
 \wxheading{Derived from}
 


@@ -10,11 +12,11 @@ on Windows and Linux only.
 
 \wxheading{Include files}
 
 
 \wxheading{Include files}
 

-<wx/wave.h>
+<wx/sound.h>

 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 

-\membersection{wxSound::wxSound}\label{wxsoundconstr}
+\membersection{wxSound::wxSound}\label{wxsoundctor}

 
 \func{}{wxSound}{\void}
 
 
 \func{}{wxSound}{\void}
 


@@ -29,9 +31,9 @@ determine whether this succeeded.
 
 \docparam{fileName}{The filename or Windows resource.}
 
 
 \docparam{fileName}{The filename or Windows resource.}
 

-\docparam{isResource}{true if {\it fileName} is a resource, false if it is a filename.}
+\docparam{isResource}{\true if {\it fileName} is a resource, \false if it is a filename.}

 
 

-\membersection{wxSound::\destruct{wxSound}}
+\membersection{wxSound::\destruct{wxSound}}\label{wxsounddtor}

 
 \func{}{\destruct{wxSound}}{\void}
 
 
 \func{}{\destruct{wxSound}}{\void}
 


@@ -39,7 +41,7 @@ Destroys the wxSound object.
 
 \membersection{wxSound::Create}\label{wxsoundcreate}
 
 
 \membersection{wxSound::Create}\label{wxsoundcreate}
 

-\func{bool}{Create}{\param{const wxString\&}{ fileName}, \param{bool}{ isResource = false}}
+\func{bool}{Create}{\param{const wxString\&}{ fileName}, \param{bool}{ isResource = \false}}

 
 Constructs a wave object from a file or resource.
 
 
 Constructs a wave object from a file or resource.
 


@@ -47,22 +49,54 @@ Constructs a wave object from a file or resource.
 
 \docparam{fileName}{The filename or Windows resource.}
 
 
 \docparam{fileName}{The filename or Windows resource.}
 

-\docparam{isResource}{true if {\it fileName} is a resource, false if it is a filename.}
+\docparam{isResource}{\true if {\it fileName} is a resource, \false if it is a filename.}

 
 \wxheading{Return value}
 
 
 \wxheading{Return value}
 

-true if the call was successful, false otherwise.
+\true if the call was successful, \false otherwise.

 
 \membersection{wxSound::IsOk}\label{wxsoundisok}
 
 \constfunc{bool}{IsOk}{\void}
 
 
 \membersection{wxSound::IsOk}\label{wxsoundisok}
 
 \constfunc{bool}{IsOk}{\void}
 

-Returns true if the object contains a successfully loaded file or resource, false otherwise.
+Returns \true if the object contains a successfully loaded file or resource, \false otherwise.
+
+\membersection{wxSound::IsPlaying}\label{wxsoundisplaying}
+
+\constfunc{static bool}{IsPlaying}{\void}
+
+Returns \true if a sound is played at the moment.

 
 \membersection{wxSound::Play}\label{wxsoundplay}
 
 
 \membersection{wxSound::Play}\label{wxsoundplay}
 

-\constfunc{bool}{Play}{\param{bool}{ async = true}, \param{bool}{ looped = false}}
+\constfunc{bool}{Play}{\param{unsigned }{ flags = wxSOUND\_ASYNC}}
+
+\func{static bool}{Play}{\param{const wxString\& }{filename}, \param{unsigned}{ flags = wxSOUND\_ASYNC}}
+
+Plays the sound file. If another sound is playing, it will be interrupted.
+Returns \true on success, \false otherwise.
+
+The possible values for \arg{flags} are:
+
+\begin{twocollist}
+\twocolitem{wxSOUND\_SYNC}{{\tt Play} will block and wait until the sound is
+replayed.}
+\twocolitem{wxSOUND\_ASYNC}{Sound is played asynchronously, 
+{\tt Play} returns immediately}
+\twocolitem{wxSOUND\_ASYNC | wxSOUND\_LOOP}{Sound is played asynchronously
+and loops until another sound is played, 
+\helpref{wxSound::Stop}{wxsoundstop} is called or the program terminates.}
+\end{twocollist}
+
+The static form is shorthand for this code:
+
+\begin{verbatim}
+wxSound(filename).Play(flags);
+\end{verbatim}
+
+\membersection{wxSound::Stop}\label{wxsoundstop}

 
 

-Plays the wave file synchronously or asynchronously, looped or single-shot.
+\func{static void}{Stop}{\void}

 
 

+If a sound is played, this function stops it.