Clarified wxPropertyGrid::HitTest() docs

[wxWidgets.git] / include / wx / unix / sound.h

diff --git a/include/wx/unix/sound.h b/include/wx/unix/sound.h
index c85b0ef8666d7df02d6b4b369b3067c24b05c207..797eacd1fa2f5a91e7938448b80da6e812cd3a23 100644 (file)
--- a/include/wx/unix/sound.h
+++ b/include/wx/unix/sound.h
@@ -1,12 +1,12 @@
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////

-// Name:        wave.h
+// Name:        wx/unix/sound.h

 // Purpose:     wxSound class
 // Author:      Julian Smart, Vaclav Slavik
 // Modified by:
 // Created:     25/10/98
 // RCS-ID:      $Id$
 // Copyright:   (c) Julian Smart, Vaclav Slavik
 // Purpose:     wxSound class
 // Author:      Julian Smart, Vaclav Slavik
 // Modified by:
 // Created:     25/10/98
 // RCS-ID:      $Id$
 // Copyright:   (c) Julian Smart, Vaclav Slavik

-// Licence:    wxWindows licence
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 #ifndef _WX_SOUND_H_
 /////////////////////////////////////////////////////////////////////////////
 
 #ifndef _WX_SOUND_H_


@@ -14,11 +14,7 @@
 
 #include "wx/defs.h"
 
 
 #include "wx/defs.h"
 

-#if wxUSE_WAVE
-
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
-#pragma interface "sound.h"
-#endif
+#if wxUSE_SOUND

 
 #include "wx/object.h"
 
 
 #include "wx/object.h"
 


@@ -26,18 +22,18 @@
 // wxSound: simple audio playback class
 // ----------------------------------------------------------------------------
 
 // wxSound: simple audio playback class
 // ----------------------------------------------------------------------------
 

-class wxSoundBackend;
-class wxSound;
-class wxDynamicLibrary;
+class WXDLLIMPEXP_FWD_ADV wxSoundBackend;
+class WXDLLIMPEXP_FWD_ADV wxSound;
+class WXDLLIMPEXP_FWD_BASE wxDynamicLibrary;

 
 /// Sound data, as loaded from .wav file:
 
 /// Sound data, as loaded from .wav file:

-class wxSoundData
+class WXDLLIMPEXP_ADV wxSoundData

 {
 public:
     wxSoundData() : m_refCnt(1) {}
     void IncRef();
     void DecRef();
 {
 public:
     wxSoundData() : m_refCnt(1) {}
     void IncRef();
     void DecRef();

-    
+

     // .wav header information:
     unsigned m_channels;       // num of channels (mono:1, stereo:2)
     unsigned m_samplingRate;
     // .wav header information:
     unsigned m_channels;       // num of channels (mono:1, stereo:2)
     unsigned m_samplingRate;


@@ -45,7 +41,7 @@ public:
                                // samples (wxUint8), if 16 then signed 16bit
                                // (wxInt16)
     unsigned m_samples;        // length in samples:
                                // samples (wxUint8), if 16 then signed 16bit
                                // (wxInt16)
     unsigned m_samples;        // length in samples:

-    
+

     // wave data:
     size_t   m_dataBytes;
     wxUint8 *m_data;           // m_dataBytes bytes of data
     // wave data:
     size_t   m_dataBytes;
     wxUint8 *m_data;           // m_dataBytes bytes of data


@@ -59,13 +55,13 @@ private:
 
 
 /// Simple sound class:
 
 
 /// Simple sound class:

-class wxSound : public wxSoundBase
+class WXDLLIMPEXP_ADV wxSound : public wxSoundBase

 {
 public:
     wxSound();
     wxSound(const wxString& fileName, bool isResource = false);
     wxSound(int size, const wxByte* data);
 {
 public:
     wxSound();
     wxSound(const wxString& fileName, bool isResource = false);
     wxSound(int size, const wxByte* data);

-    ~wxSound();
+    virtual ~wxSound();

 
     // Create from resource or file
     bool Create(const wxString& fileName, bool isResource = false);
 
     // Create from resource or file
     bool Create(const wxString& fileName, bool isResource = false);


@@ -73,17 +69,23 @@ public:
     bool Create(int size, const wxByte* data);
 
     bool IsOk() const { return m_data != NULL; }
     bool Create(int size, const wxByte* data);
 
     bool IsOk() const { return m_data != NULL; }

-    
+
+    // Stop playing any sound
+    static void Stop();
+
+    // Returns true if a sound is being played
+    static bool IsPlaying();
+

     // for internal use
     static void UnloadBackend();
     // for internal use
     static void UnloadBackend();

-    
+

 protected:
 protected:

-    bool DoPlay(unsigned flags);
+    bool DoPlay(unsigned flags) const;

 
     static void EnsureBackend();
     void Free();
     bool LoadWAV(const wxUint8 *data, size_t length, bool copyData);
 
     static void EnsureBackend();
     void Free();
     bool LoadWAV(const wxUint8 *data, size_t length, bool copyData);

-    
+

     static wxSoundBackend *ms_backend;
 #if wxUSE_LIBSDL && wxUSE_PLUGINS
     // FIXME - temporary, until we have plugins architecture
     static wxSoundBackend *ms_backend;
 #if wxUSE_LIBSDL && wxUSE_PLUGINS
     // FIXME - temporary, until we have plugins architecture


@@ -96,20 +98,30 @@ private:
 
 
 // ----------------------------------------------------------------------------
 
 
 // ----------------------------------------------------------------------------

-// wxSoundBackend: 
+// wxSoundBackend:

 // ----------------------------------------------------------------------------
 
 // This is interface to sound playing implementation. There are multiple
 // ----------------------------------------------------------------------------
 
 // This is interface to sound playing implementation. There are multiple

-// sound architectures in use on Unix platforms and wxWindows can use several
+// sound architectures in use on Unix platforms and wxWidgets can use several

 // of them for playback, depending on their availability at runtime; hence
 // of them for playback, depending on their availability at runtime; hence

-// the need for backends. This class is for use by wxWindows and people writing
-// additional backends only, it is _not_ for use by applications! 
+// the need for backends. This class is for use by wxWidgets and people writing
+// additional backends only, it is _not_ for use by applications!

 
 

-class wxSoundBackend
+// Structure that holds playback status information
+struct wxSoundPlaybackStatus
+{
+    // playback is in progress
+    bool m_playing;
+    // main thread called wxSound::Stop()
+    bool m_stopRequested;
+};
+
+// Audio backend interface
+class WXDLLIMPEXP_ADV wxSoundBackend

 {
 public:
     virtual ~wxSoundBackend() {}
 {
 public:
     virtual ~wxSoundBackend() {}

-    
+

     // Returns the name of the backend (e.g. "Open Sound System")
     virtual wxString GetName() const = 0;
 
     // Returns the name of the backend (e.g. "Open Sound System")
     virtual wxString GetName() const = 0;
 


@@ -121,16 +133,29 @@ public:
     virtual bool IsAvailable() const = 0;
 
     // Returns true if the backend is capable of playing sound asynchronously.
     virtual bool IsAvailable() const = 0;
 
     // Returns true if the backend is capable of playing sound asynchronously.

-    // If false, then wxWindows creates a playback thread and handles async
+    // If false, then wxWidgets creates a playback thread and handles async

     // playback, otherwise it is left up to the backend (will usually be more
     // playback, otherwise it is left up to the backend (will usually be more

-    // effective)
+    // effective).

     virtual bool HasNativeAsyncPlayback() const = 0;
 
     virtual bool HasNativeAsyncPlayback() const = 0;
 

-    // Plays the sound. flags are same flags as those passed to wxSound::Play
-    virtual bool Play(wxSoundData *data, unsigned flags) = 0;
+    // Plays the sound. flags are same flags as those passed to wxSound::Play.
+    // The function should periodically check the value of
+    // status->m_stopRequested and terminate if it is set to true (it may
+    // be modified by another thread)
+    virtual bool Play(wxSoundData *data, unsigned flags,
+                      volatile wxSoundPlaybackStatus *status) = 0;
+
+    // Stops playback (if something is played).
+    virtual void Stop() = 0;
+
+    // Returns true if the backend is playing anything at the moment.
+    // (This method is never called for backends that don't support async
+    // playback.)
+    virtual bool IsPlaying() const = 0;

 };
 
 
 };
 
 

-#endif // wxUSE_WAVE
+#endif // wxUSE_SOUND
+
+#endif // _WX_SOUND_H_

 
 

-#endif