source: code/branches/Dialog_HS17/src/modules/dialog/DialogManager.h @ 11819

#ifndef _DialogManager_H__
#define _DialogManager_H__

#include "DialogPrereqs.h"
#include "util/Singleton.h"
#include "core/singleton/ScopedSingletonIncludes.h"
#include "core/object/Listable.h"
#include "Dialog.h"

#include <string>

namespace orxonox //tolua_export

{//tolua_export

    /**
    @brief
    this class is used for calling on a dialog form luascript

    the class is the interface of dialog to lua, all lua functionallity is given by this class, it can be found by lua due to singleton definition

    @todo 
        reseting or setting new start for dialog on exit, to allow coming back to a npc
        picture of person
        parameters to differ dialog depending on some world values, like items, completed objectives etc...
    */

    class _OrxonoxExport DialogManager //tolua_export
    : public Singleton<DialogManager>
    {//tolua_export
        friend class Singleton<DialogManager>;
    
        public:
        
        DialogManager(); 

        /**
        @brief
            gives the pointer to the sigleton dialog manager to the lua script

        @return
            returns pointer
        */

        static DialogManager& getInstance() { return Singleton<DialogManager>::getInstance(); } //tolua_export

        /**
        @brief
            allows to set the current dialog

            this is used by a dialog when triggered to set its self to the current dialog

        @param dialog
            pointer to the dialog that wants to be current one
        */
        void setDialog(Dialog* dialog);

        //from here on functions for lua interface

        /**
        @brief
            gives the string of the momentary npc textoption

        @return
            string of npc text
        */
        std::string getQuestion(); //tolua_export

        /**
        @brief
            function that returns size of answerid array

        @return
            returns number of possible answers to momentary questions, 0 if there are no player text options
        */
        int getSize(); //tolua_export

        /**
        @brief
            returns the answer to the id that is at index in the array of answers

        @param param1
            index of desired answer

        @return
            string of answer
        */
        std::string getAnswer(int index); //tolua_export

        /**
        @brief
            gives name of npc the player is currently talking to

        @return
            sting with name
        */
        std::string getPerson(); //tolua_export

        /**
        @brief
            tests the dialog if there are any followup npc textoptions to the given answer or if there are no answers to the current question 

        @return
            true if the answer array of the question is empty or the next question id of the answer does not exist
        */
        bool endtest(int index); //tolua_export

        /**
        @brief
            tells the dialog to update according to a given answer, if no answer is actively clicked the standard index is sett 0 in the lua
            when called the current question of the dialog is set to the new one and the answerId vector is set accordingly 

        @param param1
            index of the answer given by the player

        */
        void update(int index); //tolua_export

private:
    static DialogManager* singletonPtr_s;   //!< a pointer to the single class object

    Dialog* currentTalk_;   //!< pointer to the currently active dialog or last active if no one is currently active
    const std::vector<std::string>* answerIds_; //!< pointer to the possible answerIds of the current question, for faster access

    };//tolua_export
}//tolua_export

#endif /* _DialogManager_H__ */