access.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 ACCESS_ACCESS_H
#define ACCESS_ACCESS_H

#include "common/scummsys.h"
#include "common/system.h"
#include "common/error.h"
#include "common/random.h"
#include "common/savefile.h"
#include "common/serializer.h"
#include "common/util.h"

#include "engines/engine.h"

#include "graphics/surface.h"

#include "access/animation.h"
#include "access/bubble_box.h"
#include "access/char.h"
#include "access/data.h"
#include "access/events.h"
#include "access/files.h"
#include "access/font.h"
#include "access/inventory.h"
#include "access/player.h"
#include "access/resources.h"
#include "access/room.h"
#include "access/screen.h"
#include "access/scripts.h"
#include "access/sound.h"
#include "access/video.h"
#include "access/detection.h"

namespace Access {

enum AccessDebugChannels {
    kDebugPath = 1,
    kDebugScripts,
    kDebugGraphics,
    kDebugSound,
};

/* typed enum to match unsignedness of Common::CustomEventType */
enum ACCESSActions : Common::CustomEventType {
    kActionNone,
    kActionMoveUp,
    kActionMoveDown,
    kActionMoveLeft,
    kActionMoveRight,
    kActionMoveUpLeft,
    kActionMoveUpRight,
    kActionMoveDownLeft,
    kActionMoveDownRight,
    kActionLook,
    kActionUse,
    kActionTake,
    kActionInventory,
    kActionClimb,
    kActionTalk,
    kActionWalk,
    kActionHelp,
    kActionOpen,
    kActionMove,
    kActionTravel,
    kActionSkip,
    kActionSaveLoad,
};

struct AccessActionCode {
    ACCESSActions _action;
    int8 _code;
};

static const AccessActionCode AMAZON_ACTION_CODES[] = {
    { kActionLook, 1 },
    { kActionUse, 2 },
    { kActionTake, 3 },
    { kActionInventory, 4 },
    { kActionClimb, 5 },
    { kActionTalk, 6 },
    { kActionWalk, 7 },
    { kActionHelp, 8 },
    { kActionSaveLoad, -2 },
    { kActionNone, -1 },
};

static const AccessActionCode MARTIAN_ACTION_CODES[] = {
    { kActionLook, 0 },
    { kActionOpen, 1 },
    { kActionMove, 2 },
    { kActionTake, 3 },
    { kActionUse, 4 },
    { kActionWalk, 5 },
    { kActionTalk, 6 },
    { kActionTravel, 7 },
    { kActionHelp, 8 },
    { kActionSaveLoad, -2 },
    { kActionNone, -1 },
};

#define ACCESS_SAVEGAME_VERSION 1

struct AccessSavegameHeader {
    uint8 _version;
    Common::String _saveName;
    Graphics::Surface *_thumbnail;
    int _year, _month, _day;
    int _hour, _minute;
    int _totalFrames;
};

class AccessEngine : public Engine {
private:
    uint32 _lastTime, _curTime;

    SpriteResource *_icons;

    void initialize();

    void setVGA();

protected:
    const AccessGameDescription *_gameDescription;
    Common::RandomSource _randomSource;
    int _loadSaveSlot;

    void doRoom();

    void playVideo(int videoNum, const Common::Point &pt);

    // Engine APIs
    Common::Error run() override;
    bool hasFeature(EngineFeature f) const override;
protected:
    virtual void playGame() = 0;

    virtual void synchronize(Common::Serializer &s);
public:
    AnimationManager *_animation;
    BubbleBox *_bubbleBox;
    BubbleBox *_helpBox;
    BubbleBox *_travelBox;
    BubbleBox *_invBox;
    BubbleBox *_aboutBox;
    CharManager *_char;
    EventsManager *_events;
    FileManager *_files;
    InventoryManager *_inventory;
    Player *_player;
    Resources *_res;
    Room *_room;
    Screen *_screen;
    Scripts *_scripts;
    SoundManager *_sound;
    MusicManager *_midi;
    VideoPlayer *_video;

    BaseSurface *_destIn;
    BaseSurface *_current;
    ASurface _buffer1;
    ASurface _buffer2;
    ASurface _vidBuf;
    int _vidX, _vidY;
    SpriteResource *_objectsTable[100];
    bool _establishTable[100];
    bool _establishFlag;
    int _establishMode;
    int _establishGroup;
    int _establishCtrlTblOfs;
    TimerList _timers;
    DeathList _deaths;
    FontManager _fonts;
    Common::Array<Common::Rect> _newRects;
    Common::Array<Common::Rect> _oldRects;
    Common::Array<ExtraCell> _extraCells;
    ImageEntryList _images;
    int _mouseMode;

    uint8 _playerDataCount;
    int _currentManOld;
    int _converseMode;
    bool _currentCharFlag;
    bool _boxSelect;
    int _scale;
    int _scaleH1, _scaleH2;
    int _scaleN1;
    int _scaleT1;
    int _scaleMaxY;
    int _scaleI;
    int _scrollX, _scrollY;
    int _scrollCol, _scrollRow;
    bool _imgUnscaled;
    bool _canSaveLoad;

    Resource *_establish;
    int _printEnd;
    int _txtPages;
    int _narateFile;
    int _sndSubFile;
    int _countTbl[6];

    // Fields that are included in savegames
    int _conversation;
    int _currentMan;
    uint32 _newTime;
    uint32 _newDate;
    int _flags[256];

    // Fields used by MM
    // TODO: Refactor
    byte _travel[60];
    byte _ask[40];
    int _startTravelItem;
    int _startTravelBox;
    int _startAboutItem;
    int _startAboutBox;
    int _boxDataStart;
    bool _boxDataEnd;
    int _boxSelectY;
    int _boxSelectYOld;
    int _numLines;
    byte _byte26CB5;
    int _bcnt;

    bool _vidEnd;
    bool _clearSummaryFlag;
    bool _cheatFl;
    bool _restartFl;
    // Fields mapped into the flags array
    int &_useItem;
    int &_startup;
    int &_manScaleOff;
    int &_pictureTaken;

public:
    AccessEngine(OSystem *syst, const AccessGameDescription *gameDesc);
    ~AccessEngine() override;

    virtual void dead(int deathId) = 0;

    uint32 getFeatures() const;
    bool isCD() const;
    bool isDemo() const;
    Common::Language getLanguage() const;
    Common::Platform getPlatform() const;
    uint16 getVersion() const;
    uint32 getGameID() const;
    uint32 getGameFeatures() const;
    bool shouldQuitOrRestart();

    int getRandomNumber(int maxNumber);

    const SpriteResource *getIcons();

    void loadCells(const Common::Array<CellIdent> &cells);

    void freeCells();

    virtual void establish(int esatabIndex, int sub) = 0;

    void plotList();
    void plotList1();

    void copyBlocks();

    void copyRects();

    void copyBF1BF2();

    void copyBF2Vid();

    void freeChar();

    void printText(BaseSurface *s, const Common::String &msg);
    void speakText(BaseSurface *s, const Common::String &msg);

    void syncSoundSettings() override;

    Common::Error loadGameState(int slot) override;

    Common::Error saveGameState(int slot, const Common::String &desc, bool isAutosave = false) override;

    bool canLoadGameStateCurrently(Common::U32String *msg = nullptr) override;

    bool canSaveGameStateCurrently(Common::U32String *msg = nullptr) override;

    WARN_UNUSED_RESULT static bool readSavegameHeader(Common::InSaveFile *in, AccessSavegameHeader &header, bool skipThumbnail = true);

    void writeSavegameHeader(Common::OutSaveFile *out, AccessSavegameHeader &header);

    bool playMovie(const Common::Path &filename, const Common::Point &pos);
};

} // End of namespace Access

#endif /* ACCESS_ACCESS_H */