scene.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 NANCY_STATE_SCENE_H
#define NANCY_STATE_SCENE_H

#include "common/singleton.h"
#include "common/queue.h"

#include "engines/nancy/commontypes.h"
#include "engines/nancy/puzzledata.h"

#include "engines/nancy/action/actionmanager.h"

#include "engines/nancy/state/state.h"

#include "engines/nancy/ui/fullscreenimage.h"
#include "engines/nancy/ui/viewport.h"
#include "engines/nancy/ui/textbox.h"
#include "engines/nancy/ui/inventorybox.h"
#include "engines/nancy/ui/inventorypopup.h"
#include "engines/nancy/ui/notebookpopup.h"
#include "engines/nancy/ui/cellphonepopup.h"
#include "engines/nancy/ui/conversationpopup.h"

namespace Common {
class SeekableReadStream;
class Serializer;
}

namespace Nancy {

class NancyEngine;
class NancyConsole;
struct SceneChangeDescription;

namespace Action {
class ConversationSound;
class PlaySecondaryMovie;
}

namespace Misc {
class Lightning;
class SpecialEffect;
}

namespace UI {
class Button;
class Taskbar;
class ViewportOrnaments;
class TextboxOrnaments;
class InventoryBoxOrnaments;
class Clock;
}

namespace State {

// The game state that handles all of the gameplay
class Scene : public State, public Common::Singleton<Scene> {
public:
    struct SceneSummary {
        // SSUM and TSUM
        // Default values set to match those applied when loading from a TSUM chunk
        Common::String description;
        Common::Path videoFile;

        uint16 videoFormat = kLargeVideoFormat;
        Common::Array<Common::Path> palettes;
        SoundDescription sound;

        byte panningType = kPan360;
        uint16 numberOfVideoFrames = 0;
        uint16 degreesPerRotation = 18;
        uint16 totalViewAngle = 0;
        uint16 horizontalScrollDelta = 1;
        uint16 verticalScrollDelta = 10;
        uint16 horizontalEdgeSize = 15;
        uint16 verticalEdgeSize = 15;
        Time slowMoveTimeDelta = 400;
        Time fastMoveTimeDelta = 66;

        // Sound start vectors, used in nancy3 and up
        Math::Vector3d listenerPosition;

        void read(Common::SeekableReadStream &stream);
        void readTerse(Common::SeekableReadStream &stream);
    };

    Scene();
    virtual ~Scene();

    // State API
    void process() override;
    void onStateEnter(const NancyState::NancyState prevState) override;
    bool onStateExit(const NancyState::NancyState nextState) override;

    // Used when winning/losing game
    void setDestroyOnExit() { _destroyOnExit = true; }

    bool isRunningAd() const { return _isRunningAd; }

    void changeScene(const SceneChangeDescription &sceneDescription);
    void pushScene(int16 itemID = -1);
    void popScene(bool inventory = false);

    // Nancy 11+ "UI prep scenes": opening a taskbar popup first runs a hidden,
    // videoless scene whose event-flag-gated ARs populate the popup's content;
    // a UIPopupPrepScene AR (32) then calls finishUIPrepScene to restore the
    // prior scene and open the (now populated) popup. startUIPrepScene saves
    // the current scene and jumps to prepSceneID; uiType (a UIType) selects
    // which popup finishUIPrepScene opens. No-op if a prep is already running
    // or prepSceneID is kNoScene.
    void startUIPrepScene(int16 uiType, int16 prepSceneID);
    void finishUIPrepScene();
    bool isUIPrepActive() const { return _uiPrep.active; }
    uint16 getSceneCounts(int16 hours) const {
        return _flags.sceneCounts.contains(hours) ? _flags.sceneCounts[hours] : 0;
    }

    void setPlayerTime(Time time, byte relative);
    Time getPlayerTime() const { return _timers.playerTime; }
    Time getTimerTime() const { return _timers.timerIsActive ? _timers.timerTime : 0; }
    byte getPlayerTOD() const;

    void addItemToInventory(int16 id);
    void removeItemFromInventory(int16 id, bool pickUp = true);
    int16 getHeldItem() const { return _flags.heldItem; }
    void setHeldItem(int16 id);
    void setNoHeldItem();
    byte hasItem(int16 id) const;
    byte getItemDisabledState(int16 id) const { return _flags.disabledItems[id]; }
    void setItemDisabledState(int16 id, byte state) {
        if ((uint16)id < _flags.disabledItems.size())
            _flags.disabledItems[id] = state;
    }

    void installInventorySoundOverride(byte command, const SoundDescription &sound, const Common::String &caption, uint16 itemID);
    void playItemCantSound(int16 itemID = -1, bool notHoldingSound = false);

    void setEventFlag(int16 label, byte flag);
    void setEventFlag(FlagDescription eventFlag);
    bool getEventFlag(int16 label, byte flag) const;
    bool getEventFlag(FlagDescription eventFlag) const;

    // Nancy 11+ software-timer queries used by timer dependencies.
    bool isSoftwareTimerActive(uint16 index) const;
    uint32 getSoftwareTimerElapsed(uint16 index) const;

    // Nancy 12+ UI resource values (the UIRC boot chunk). Resource 0 is the
    // coin purse amount in cents. Backed by the lazily-created, saved
    // UIResourceData puzzle chunk, seeded from UIRC on first use and mutated by
    // AR 132 (ResourceUse). Non-const because the first access creates/seeds it.
    int32 getUIResource(uint index);
    void setUIResource(uint index, int32 value);

    void setLogicCondition(int16 label, byte flag);
    bool getLogicCondition(int16 label, byte flag) const;
    void clearLogicConditions();
    Time getLogicConditionTimestamp(int16 label) const {
        return _flags.logicConditions[label].timestamp; 
    }

    void setDifficulty(uint difficulty) { _difficulty = difficulty; }
    uint16 getDifficulty() const { return _difficulty; }

    byte getHintsRemaining() const { return _hintsRemaining[_difficulty]; }
    void useHint(uint16 characterID, uint16 hintID);

    void requestStateChange(NancyState::NancyState state) { _gameStateRequested = state; }
    void resetStateToInit() { _state = kInit; }

    void resetAndStartTimer() { _timers.timerIsActive = true; _timers.timerTime = 0; }
    void stopTimer() { _timers.timerIsActive = false; _timers.timerTime = 0; }

    Time getMovementTimeDelta(bool fast) const { return fast ? _sceneState.summary.fastMoveTimeDelta : _sceneState.summary.slowMoveTimeDelta; }

    // Nancy 11+ AR 30/31. Toggles whether the player may scroll/pan the viewport.
    // Backed by a reserved event flag (so it persists across scene changes and
    // is saved/restored with the rest of the event flags).
    void setPlayerScrolling(bool enabled);
    bool getPlayerScrolling() const;

    void registerGraphics();

    void synchronize(Common::Serializer &serializer);

    UI::FullScreenImage &getFrame() { return _frame; }
    UI::Viewport &getViewport() { return _viewport; }
    UI::Textbox &getTextbox() { return _textbox; }
    UI::InventoryBox &getInventoryBox() { return _inventoryBox; }
    UI::InventoryPopup &getInventoryPopup() { return _inventoryPopup; }
    UI::NotebookPopup &getNotebookPopup() { return _notebookPopup; }
    UI::CellPhonePopup &getCellPhonePopup() { return _cellPhonePopup; }
    UI::ConversationPopup &getConversationPopup() { return _conversationPopup; }
    UI::Clock *getClock();
    UI::Taskbar *getTaskbar() { return _taskbar; }

    Action::ActionManager &getActionManager() { return _actionManager; }

    SceneChangeDescription &getSceneInfo() { return _sceneState.currentScene; }
    SceneChangeDescription &getNextSceneInfo() { return _sceneState.nextScene; }
    const SceneSummary &getSceneSummary() const { return _sceneState.summary; }

    void setActiveMovie(Action::PlaySecondaryMovie *activeMovie);
    Action::PlaySecondaryMovie *getActiveMovie();

    // Called when a PSM(isRandom) AR is loaded — drives stale-chain cleanup.
    void notifyRandomMovieARLoaded() { _hadRandomMovieARThisScene = true; }
    void setActiveConversation(Action::ConversationSound *activeConversation);
    Action::ConversationSound *getActiveConversation();

    Graphics::ManagedSurface &getLastScreenshot() { return _lastScreenshot; }

    // The Vampire Diaries only;
    void beginLightning(int16 distance, uint16 pulseTime, int16 rgbPercent);

    // Used from nancy2 onwards
    void specialEffect(byte type, uint16 fadeToBlackTime, uint16 frameTime);
    void specialEffect(byte type, uint16 totalTime, uint16 fadeToBlackTime, Common::Rect rect);

    // Get the persistent data for a given puzzle type
    PuzzleData *getPuzzleData(const uint32 tag);

    enum State {
        kInit,
        kLoad,
        kStartSound,
        kRun
    };

    State getState() const { return _state; }
    void setState(State state) { _state = state; }

    // Close every open Nancy 10+ popup. Used before a script auto-opens one
    // (e.g. the incoming game-over call) so two popups can't stack.
    void closeActivePopups();

    struct Timers {
        Time pushedPlayTime;
        Time lastTotalTime;
        Time sceneTime;
        Time timerTime;
        bool timerIsActive = false;
        Time playerTime;           // In-game time of day, adds a minute every 5 seconds
        Time playerTimeNextMinute; // Stores the next tick count until we add a minute to playerTime
    };

    Timers _timers;

    RenderObject _hotspotDebug;

private:
    void init();
    void load(bool fromSaveFile = false);
    void run();
    void handleInput();

    // Nancy 11+ AR 69. Advances all running software timers (stored as TimerData
    // puzzle data) and fires any whose configured duration has just elapsed.
    void tickSoftwareTimers(uint32 deltaMs);
    void fireSoftwareTimer(TimerData::Timer &timer);
    void fireTimerTrigger(TimerData::Trigger &trigger);

    // Rect of the open Nancy 10+ taskbar popup, or empty if none.
    Common::Rect activePopupConfinement() const;

    void initStaticData();

    void clearSceneData(bool nextIsNoArt = false);
    void clearPuzzleData();

    // Maps an event flag label to its index in the eventFlags array
    int16 eventFlagToIndex(int16 label) const;

    struct SceneState {
        SceneSummary summary;
        SceneChangeDescription currentScene;
        SceneChangeDescription nextScene;
        SceneChangeDescription pushedScene;
        bool isScenePushed = false;
        SceneChangeDescription pushedInvScene;
        int16 pushedInvItemID = -1;
        bool isInvScenePushed = false;
    };

    struct PlayFlags {
        struct LogicCondition {
            LogicCondition();
            byte flag;
            Time timestamp;
        };

        LogicCondition logicConditions[30];
        Common::Array<byte> eventFlags;
        Common::HashMap<uint16, uint16> sceneCounts;
        Common::Array<byte> items;
        Common::Array<byte> disabledItems;
        int16 heldItem = -1;
        int16 primaryVideoResponsePicked = -1;
    };

    struct InventorySoundOverride {
        bool isDefault = false; // When true, other fields are ignored
        SoundDescription sound;
        Common::String caption;
    };

    // UI
    UI::FullScreenImage _frame;
    UI::Viewport _viewport;
    UI::Textbox _textbox;
    UI::InventoryBox _inventoryBox;
    UI::InventoryPopup _inventoryPopup;
    UI::NotebookPopup _notebookPopup;
    UI::CellPhonePopup _cellPhonePopup;
    UI::ConversationPopup _conversationPopup;

    UI::Button *_menuButton;
    UI::Button *_helpButton;
    UI::Taskbar *_taskbar;
    Time _buttonPressActivationTime;

    // A clicked MENU/HELP taskbar button whose state change is deferred until
    // its click sound finishes playing (see handleInput). -1 = none pending.
    int _pendingTaskbarButton;

    UI::ViewportOrnaments *_viewportOrnaments;
    UI::TextboxOrnaments *_textboxOrnaments;
    UI::InventoryBoxOrnaments *_inventoryBoxOrnaments;
    RenderObject *_clock;

    Common::Rect _mapHotspot;

    // General data
    SceneState _sceneState;
    PlayFlags _flags;
    uint16 _difficulty;
    Common::Array<uint16> _hintsRemaining;
    int16 _lastHintCharacter;
    int16 _lastHintID;
    NancyState::NancyState _gameStateRequested;
    Common::HashMap<uint16, InventorySoundOverride> _inventorySoundOverrides;

    Misc::Lightning *_lightning;
    Common::Queue<Misc::SpecialEffect> _specialEffects;

    Common::HashMap<uint32, PuzzleData *> _puzzleData;

    Action::ActionManager _actionManager;
    Action::PlaySecondaryMovie *_activeMovie;
    Action::ConversationSound *_activeConversation;

    // Set by notifyRandomMovieARLoaded; checked in clearSceneData to wind
    // down a persistent random-movie whose scene chain is over.
    bool _hadRandomMovieARThisScene = false;

    // Whether esc was already down last frame, so a held key only skips once
    bool _escHeld = false;

    // Contains a screenshot of the Scene state from the last time it was exited
    Graphics::ManagedSurface _lastScreenshot;

    bool _destroyOnExit;
    bool _isRunningAd;

    // State for a running UI prep scene (see startUIPrepScene).
    struct UIPrepState {
        bool active = false;
        int16 uiType = 0;   // UIType of the popup that requested the prep
        SceneChangeDescription returnScene;
        uint32 startMillis = 0;
    } _uiPrep;

    State _state;
};

#define NancySceneState Nancy::State::Scene::instance()

} // End of namespace State
} // End of namespace Nancy

#endif // NANCY_STATE_SCENE_H