audio.h

Go to the documentation of this file.

/*
 * gamelib.h: 本檔案儲遊戲相關的class的interface
 * Copyright (C) 2002-2008 Woei-Kae Chen <wkc@csie.ntut.edu.tw>
 *
 * This file is part of game, a free game development framework for windows.
 *
 * game 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.
 *
 * game 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
 *
 * History:
 *   2002-03-04 V3.1
 *      1. Add ENABLE_AUDIO flag.
 *   2004-03-02 V4.0
 *      1. Add CInteger class.
 *      2. Add CGameState abstract class and adjust CGame to apply
 *         state pattern for switching game states.
 *   2004-03-08 V4.1
 *      1. Add OPEN_AS_FULLSCREEN flag.
 *      2. The Game Engine now becomes a framework.
 *   2005-07-28
 *      1. Add GAME_ASSERT macro to display run time errors gracefully.
 *      2. Remove CDDarw::CheckSystem(). It is useless.
 *   2005-09-08
 *      1. Eliminate CSpecialEffect::Abort. It is useless now.
 *      2. Add SHOW_GAME_CYCLE_TIME flag.
 *      3. Add DEFAULT_BG_COLOR flag;
 *   2005-09-20 V4.2Beta1.
 *   2005-09-29 V4.2Beta2.
 *      1. Add MOUSEMOVE Handler for CGame and CGameState.
 *      2. Add _TRACE preprocessor flag for VC++.net.
 *   2006-02-08 V4.2
 *      1. Rename OnInitialUpdate() -> OnInit().
 *      2. Remove constantness of CAnimation::DELAY_COUNT.
 *      3. Enhance CAnimation to support SetDelayCount(), Reset(), and IsFinalBitmap().
 *      4. Remove CAnimation::GetLocation() and CMovingBitmap::GetLocation().
 *      5. Bitmap coordinate can no longer be set by CMovingBitmap::LoadBitmap().
 *         Defauts to (0,0).
 *   2006-09-09 V4.3
 *      1. Rename Move() and Show() as OnMove and OnShow() to emphasize that they are
 *         event driven.
 *      2. Fix bug: audio is now correctly recovered after a sleep or suspension of windows.
 *      3. Support ENABLE_GAME_PAUSE.
 *   2008-02-15 V4.4
 *      1. Add setup project for Visual studio 2005.
 *      2. Support bitmap scaling when ShowBitmap(scale) is called.
 *      3. Add namespace game_framework.
 *      4. Make the class CGame a singleton so that MFC can access it easily.
 *      5. Support loading of bitmap from bmp file.
 *      6. Support ShowInitProgress(percent) to display loading progress. 
 *   2010-03-23 V4.6
 *      1. Rewrite CAudio with MCI commands to eliminate dependency with DirectMusic.
*/
 
#include <list>
#include <vector>
#include <map>
using namespace std;
 
// 這個class會建立DirectX Audio物件，以提供音效
// 每個Public Interface的用法都要懂，Implementation可以不懂
// 注意事項：音效檔案可以用WAVE檔(.wav)或MIDI檔(.mid)，數個音效檔案可以
//           混合(同時)撥放，但是其中只能混合一個MIDI檔，兩個MIDI檔案不
//           能同時撥放，如果同時撥放兩個MIDI檔的話，前一個MIDI檔會被停
//           掉。
 
namespace game_framework {
 
class CAudio {
public:
    ~CAudio();
    void           Close();                     // 關閉Direct Sound介面
    static CAudio* Instance();                  // 取得CAudio的Instance
    bool           Load(unsigned, char *);      // 載入編號i的聲音，指定MIDI檔案
    bool           Open();                      // 開啟Direct Sound介面
    void           Pause();                     // 暫停播放所有音效
    void           Play(unsigned, bool=false);  // 開始撥放編號i的聲音，指定是否重覆撥放
    void           Resume();                    // 復原暫停播放的音效
    void           SetPowerResume();            // 電源恢復
    void           Stop(unsigned);              // 停止撥放編號i的聲音
private:
    class Info {
    public:
        Info() {
            repeat = isGood = false;
        }
        bool repeat, isGood;
        string fileName;
    };
    static void MCIThread(HANDLE);  // MCI thread method
    static void ExecuteMciCommand(char *); // 
    void SendMciCommand(char *);    // 
    CAudio();                       // private constructor
    static CAudio       audio;      // 自動destruct
    map<int, Info>      info;
    bool                isOpened;
    HANDLE              hThread;    // MCI command thread
    HANDLE              hWriteEnd;  // Pipe write handle for thread
    const static int    MAX_MCI_COMMAND_SIZE = 400;
};
 
}