samples/sound/sound.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        sound.cpp
   3 // Purpose:     Example of sound playing in wxWindows
   4 // Author:      Vaclav Slavik
   5 // Modified by:
   6 // Created:     2004/01/29
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2004 Vaclav Salvik
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #include "wx/wxprec.h"
  13
  14 #ifdef __BORLANDC__
  15     #pragma hdrstop
  16 #endif
  17
  18 // for all others, include the necessary headers (this file is usually all you
  19 // need because it includes almost all "standard" wxWindows headers)
  20 #ifndef WX_PRECOMP
  21     #include "wx/app.h"
  22     #include "wx/frame.h"
  23     #include "wx/menu.h"
  24     #include "wx/msgdlg.h"
  25     #include "wx/icon.h"
  26     #include "wx/textctrl.h"
  27     #include "wx/filedlg.h"
  28 #endif
  29
  30 #include "wx/sound.h"
  31 #include "wx/numdlg.h"
  32
  33 // ----------------------------------------------------------------------------
  34 // resources
  35 // ----------------------------------------------------------------------------
  36
  37 // the application icon (under Windows and OS/2 it is in resources)
  38 #if defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__) || defined(__WXX11__)
  39     #include "../sample.xpm"
  40 #endif
  41
  42 #define WAV_FILE _T("doggrowl.wav")
  43
  44 // ----------------------------------------------------------------------------
  45 // private classes
  46 // ----------------------------------------------------------------------------
  47
  48 class MyApp : public wxApp
  49 {
  50 public:
  51     virtual bool OnInit();
  52 };
  53
  54
  55 class MyFrame : public wxFrame
  56 {
  57 public:
  58     // ctor(s)
  59     MyFrame(const wxString& title);
  60     ~MyFrame() { delete m_sound; }
  61
  62     // event handlers (these functions should _not_ be virtual)
  63     void OnPlaySync(wxCommandEvent& event);
  64     void OnPlayAsync(wxCommandEvent& event);
  65     void OnPlayAsyncOnStack(wxCommandEvent& event);
  66     void OnPlayLoop(wxCommandEvent& event);
  67
  68     void OnSelectFile(wxCommandEvent& event);
  69     void OnQuit(wxCommandEvent& event);
  70     void OnAbout(wxCommandEvent& event);
  71
  72     void NotifyUsingFile(const wxString& name);
  73
  74
  75 private:
  76     wxSound*    m_sound;
  77     wxString    m_soundFile;
  78     wxTextCtrl* m_tc;
  79
  80     // any class wishing to process wxWindows events must use this macro
  81     DECLARE_EVENT_TABLE()
  82 };
  83
  84 // ----------------------------------------------------------------------------
  85 // constants
  86 // ----------------------------------------------------------------------------
  87
  88 // IDs for the controls and the menu commands
  89 enum
  90 {
  91     // menu items
  92     Sound_Quit = wxID_EXIT,
  93     Sound_About = wxID_ABOUT,
  94     Sound_PlaySync = wxID_HIGHEST + 1,
  95     Sound_PlayAsync,
  96     Sound_PlayAsyncOnStack,
  97     Sound_PlayLoop,
  98     Sound_SelectFile
  99 };
 100
 101 // ----------------------------------------------------------------------------
 102 // event tables and other macros for wxWindows
 103 // ----------------------------------------------------------------------------
 104
 105 // the event tables connect the wxWindows events with the functions (event
 106 // handlers) which process them. It can be also done at run-time, but for the
 107 // simple menu events like this the static method is much simpler.
 108 BEGIN_EVENT_TABLE(MyFrame, wxFrame)
 109     EVT_MENU(Sound_SelectFile,       MyFrame::OnSelectFile)
 110     EVT_MENU(Sound_Quit,             MyFrame::OnQuit)
 111     EVT_MENU(Sound_About,            MyFrame::OnAbout)
 112     EVT_MENU(Sound_PlaySync,         MyFrame::OnPlaySync)
 113     EVT_MENU(Sound_PlayAsync,        MyFrame::OnPlayAsync)
 114     EVT_MENU(Sound_PlayAsyncOnStack, MyFrame::OnPlayAsync)
 115     EVT_MENU(Sound_PlayLoop,         MyFrame::OnPlayLoop)
 116 END_EVENT_TABLE()
 117
 118 // Create a new application object: this macro will allow wxWindows to create
 119 // the application object during program execution (it's better than using a
 120 // static object for many reasons) and also implements the accessor function
 121 // wxGetApp() which will return the reference of the right type (i.e. MyApp and
 122 // not wxApp)
 123 IMPLEMENT_APP(MyApp)
 124
 125 // ============================================================================
 126 // implementation
 127 // ============================================================================
 128
 129 // ----------------------------------------------------------------------------
 130 // the application class
 131 // ----------------------------------------------------------------------------
 132
 133 // 'Main program' equivalent: the program execution "starts" here
 134 bool MyApp::OnInit()
 135 {
 136     // create the main application window
 137     MyFrame *frame = new MyFrame(_T("wxWindows Sound Sample"));
 138
 139     // and show it (the frames, unlike simple controls, are not shown when
 140     // created initially)
 141     frame->Show(true);
 142
 143     // success: wxApp::OnRun() will be called which will enter the main message
 144     // loop and the application will run. If we returned false here, the
 145     // application would exit immediately.
 146     return true;
 147 }
 148
 149 // ----------------------------------------------------------------------------
 150 // main frame
 151 // ----------------------------------------------------------------------------
 152
 153 // frame constructor
 154 MyFrame::MyFrame(const wxString& title)
 155        : wxFrame(NULL, wxID_ANY, title)
 156 {
 157     m_sound = NULL;
 158     m_soundFile = WAV_FILE;
 159
 160     // set the frame icon
 161     SetIcon(wxICON(sample));
 162
 163     wxMenu *menuFile = new wxMenu;
 164     wxMenu *helpMenu = new wxMenu;
 165     wxMenu *playMenu = new wxMenu;
 166     helpMenu->Append(Sound_About, _T("&About...\tF1"), _T("Show about dialog"));
 167     menuFile->Append(Sound_SelectFile, _T("&Select WAV file"), _T("Select a new wav file to play"));
 168     menuFile->Append(Sound_Quit, _T("E&xit\tAlt-X"), _T("Quit this program"));
 169     playMenu->Append(Sound_PlaySync, _T("Play sound &synchronously"));
 170     playMenu->Append(Sound_PlayAsync, _T("Play sound &asynchronously"));
 171     playMenu->Append(Sound_PlayAsync, _T("Play sound asynchronously (&object on stack)"));
 172     playMenu->Append(Sound_PlayLoop, _T("&Loop sound"));
 173
 174     // now append the freshly created menu to the menu bar...
 175     wxMenuBar *menuBar = new wxMenuBar();
 176     menuBar->Append(menuFile, _T("&File"));
 177     menuBar->Append(playMenu, _T("&Play"));
 178     menuBar->Append(helpMenu, _T("&Help"));
 179
 180     // ... and attach this menu bar to the frame
 181     SetMenuBar(menuBar);
 182
 183     m_tc = new wxTextCtrl(this, -1, "", wxDefaultPosition, wxDefaultSize,
 184                           wxTE_MULTILINE|wxTE_READONLY);
 185     NotifyUsingFile(m_soundFile);
 186 }
 187
 188
 189
 190 void MyFrame::NotifyUsingFile(const wxString& name)
 191 {
 192     wxString msg;
 193     msg << _T("Using sound file: ") << name << _T("\n");
 194     m_tc->AppendText(msg);
 195 }
 196
 197
 198 // event handlers
 199
 200
 201 void MyFrame::OnSelectFile(wxCommandEvent& WXUNUSED(event))
 202 {
 203     wxFileDialog dlg(this, _T("Choose a sound file"),
 204                      wxEmptyString, wxEmptyString,
 205                      _T("WAV files (*.wav)|*.wav"), wxOPEN|wxCHANGE_DIR);
 206     if ( dlg.ShowModal() == wxID_OK )
 207     {
 208         m_soundFile = dlg.GetPath();
 209         delete m_sound;
 210         m_sound = NULL;
 211         NotifyUsingFile(m_soundFile);
 212     }
 213 }
 214
 215 void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event))
 216 {
 217     // true is to force the frame to close
 218     Close(true);
 219 }
 220
 221 void MyFrame::OnPlaySync(wxCommandEvent& WXUNUSED(event))
 222 {
 223     wxBusyCursor busy;
 224     if (!m_sound)
 225         m_sound = new wxSound(m_soundFile);
 226     if (m_sound->IsOk())
 227         m_sound->Play(wxSOUND_SYNC);
 228 }
 229
 230 void MyFrame::OnPlayAsync(wxCommandEvent& WXUNUSED(event))
 231 {
 232     wxBusyCursor busy;
 233     if (!m_sound)
 234         m_sound = new wxSound(m_soundFile);
 235     if (m_sound->IsOk())
 236         m_sound->Play(wxSOUND_ASYNC);
 237 }
 238
 239 void MyFrame::OnPlayAsyncOnStack(wxCommandEvent& WXUNUSED(event))
 240 {
 241     wxBusyCursor busy;
 242     wxSound snd(m_soundFile);
 243     if (snd.IsOk())
 244         snd.Play(wxSOUND_ASYNC);
 245 }
 246
 247 void MyFrame::OnPlayLoop(wxCommandEvent& WXUNUSED(event))
 248 {
 249     wxBusyCursor busy;
 250     if (!m_sound)
 251         m_sound = new wxSound(m_soundFile);
 252     if (m_sound->IsOk())
 253         m_sound->Play(wxSOUND_ASYNC | wxSOUND_LOOP);
 254 }
 255
 256 void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 257 {
 258     wxString msg;
 259     msg.Printf( _T("This is the About dialog of the sound sample.\n")
 260                 _T("Welcome to %s"), wxVERSION_STRING);
 261
 262     wxMessageBox(msg, _T("About"), wxOK | wxICON_INFORMATION, this);
 263 }