text-to-speech.h

/* ScummVM - Graphic Adventure Engine
 *
 * ScummVM is the legal property of its developers, whose names
 * are too numerous to list here. Please refer to the COPYRIGHT
 * file distributed with this source distribution.
 *
 * This program 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 3 of the License, or
 * (at your option) any later version.
 *
 * This program 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, see <http://www.gnu.org/licenses/>.
 *
 */
 
#ifndef BACKENDS_TEXT_TO_SPEECH_ABSTRACT_H
#define BACKENDS_TEXT_TO_SPEECH_ABSTRACT_H
 
#include "common/scummsys.h"
#include "common/str.h"
 
#include "common/array.h"
namespace Common {
 
 
class TTSVoice {
    friend class TextToSpeechManager;
 
    public:
        enum Gender {
            MALE,
            FEMALE,
            UNKNOWN_GENDER
        };
 
        enum Age {
            CHILD,
            ADULT,
            UNKNOWN_AGE
        };
 
    public:
        TTSVoice();
 
        TTSVoice(Gender gender, Age age, void *data, String description) ;
 
        TTSVoice(const TTSVoice& voice);
 
        ~TTSVoice();
 
        TTSVoice& operator=(const TTSVoice& voice);
 
        Gender getGender() { return _gender; };
 
        void setGender(Gender gender) { _gender = gender; };
 
        Age getAge() { return _age; };
 
        void setAge(Age age) { _age = age; };
 
        void *getData() { return _data; };
 
        void setData(void *data) { _data = data; };
 
        String getDescription() { return _description; };
 
        void setDescription(String description) { _description = description; };
 
    protected:
        Gender _gender; 
        Age _age; 
        void *_data; 
        String _description; 
        int *_refCount; 
};
 
struct TTSState {
    int _rate;
    int _pitch;
    int _volume;
    String _language;
    int _activeVoice;
    Array<TTSVoice> _availableVoices;
    bool _enabled;
    TTSState *_next;
};
 
class TextToSpeechManager {
public:
    enum Action {
        INTERRUPT,
        INTERRUPT_NO_REPEAT,
        QUEUE,
        QUEUE_NO_REPEAT,
        DROP
    };
    TextToSpeechManager();
    virtual ~TextToSpeechManager() {}
 
    virtual bool say(const U32String &str, Action action) { return false; }
 
    bool say(const String &str, Action action, CodePage charset = kUtf8) {
        U32String textToSpeak(str, charset);
        return say(textToSpeak, action);
    }
 
    bool say(const U32String &str) { return say(str, INTERRUPT_NO_REPEAT); }
 
    bool say(const String &str, CodePage charset = kUtf8) {
        return say(str, INTERRUPT_NO_REPEAT, charset);
    }
 
    virtual bool stop() { return false; }
 
    virtual bool pause() { return false; }
 
    virtual bool resume() { return false; }
 
    virtual bool isSpeaking() { return false; }
 
    virtual bool isPaused() { return false; }
 
    virtual bool isReady() { return false; }
 
    virtual void setVoice(unsigned index) {}
 
    TTSVoice getVoice();
 
    virtual void setRate(int rate) { _ttsState->_rate = rate; }
 
    int getRate() { return _ttsState->_rate; }
 
    virtual void setPitch(int pitch) { _ttsState->_pitch = pitch; }
 
    int getPitch() { return _ttsState->_pitch; }
 
    virtual void setVolume(unsigned volume) { _ttsState->_volume = volume; }
 
    int getVolume() { return _ttsState->_volume; }
 
    virtual void setLanguage(String language);
 
    String getLanguage() { return _ttsState->_language; }
 
    Array<TTSVoice> getVoicesArray() { return _ttsState->_availableVoices; }
 
    Array<int> getVoiceIndicesByGender (TTSVoice::Gender gender);
 
    virtual int getDefaultVoice() { return 0; }
 
    void pushState();
 
    bool popState();
 
    virtual void freeVoiceData(void *data) {}
 
    void enable(bool on);
 
protected:
    TTSState *_ttsState;
 
    void clearState();
    virtual void updateVoices() {};
};
 
} // End of namespace Common
 
#endif // BACKENDS_TEXT_TO_SPEECH_ABSTRACT_H