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,  // aka GET
    kActionInventory,
    kActionClimb,
    kActionTalk,
    kActionWalk, // aka GOTO
    kActionHelp,
    kActionOpen,
    kActionMove,
    kActionTravel,
    kActionSkip,
    kActionSaveLoad,
    kActionOptions,
};
 
/* These are the commands for MM. Noctropolis uses different numbers */
enum MartianCommands {
    kMartianCmdLook = 0,
    kMartianCmdOpen = 1,
    kMartianCmdMove = 2,
    kMartianCmdGetTake = 3,
    kMartianCmdUse = 4,
    kMartianCmdGoto = 5, // aka walk-to
    kMartianCmdTalk = 6,
};
 
 
/* These are the commands for MM and Amazon. Noctropolis uses different numbers */
enum AmazonCommands {
    kAmazonCmdLook = 0,
    kAmazonCmdOpen = 1,
    kAmazonCmdMove = 2,
    kAmazonCmdGetTake = 3,
    kAmazonCmdUse = 4,
    kAmazonCmdGoto = 5, // aka walk-to
    kAmazonCmdTalk = 6,
    kAmazonCmdWalkToCursor = 7,
    kAmazonCmdHelp = 8,
};
 
 
struct AccessActionCode {
    ACCESSActions _action;
    int8 _code;
};
 
#define ACCESS_SAVEGAME_VERSION 1
 
struct AccessSavegameHeader {
    uint8 _version;
    Common::String _saveName;
    Graphics::Surface *_thumbnail;
    int _year, _month, _day;
    int _hour, _minute;
    int _totalFrames;
    int _totalPlayTime;
};
 
class AccessEngine : public Engine {
private:
    uint32 _lastTime, _curTime;
 
    SpriteResource *_icons;
 
    Common::Language _lang;
 
    void initialize();
 
    void setVGA();
 
    void addHotspotHighlights();
 
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 Common::Error synchronize(Common::Serializer &s);
 
    virtual void initObjects() = 0;
 
    virtual void setupGame() = 0;
 
    virtual Common::Path getIconPath() const { return Common::Path("ICONS.LZ"); }
 
public:
    AnimationManager *_animation;
    BubbleBox *_bubbleBox;
    BubbleBox *_helpBox;
    BubbleBox *_travelBox;
    BubbleBox *_invBox;
    BubbleBox *_aboutBox;
    CharManager *_char;
    EventsManager *_events;
    FileManager *_files;
    InventoryManager *_inventory;
    Player *_player;
    Player *_curPlayer; // current player being animated (only changes in Noctropolis)
    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[128];
    bool _establishTable[128];
    bool _establishFlag;
    int _establishMode;         // Amazon only?
    int _establishGroup;        // Amazon only?
    int _establishCtrlTblOfs;   // Amazon only?
    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;     // Amazon only
    int _converseMode;      // Set but never read?
    bool _currentCharFlag;
    bool _boxSelect;
 
    int _scale;
    int _scaleH1, _scaleH2;
    int _scaleN1;
    int _scaleT1;
    int _scaleMaxY;
    int _scaleI;
    int _scrollX, _scrollY;
    int _scrollCol, _scrollRow;
    bool _canSaveLoad;
 
    Resource *_establish;
    int _printEnd;      // Amazon only
    int _txtPages;      // Amazon only
    int _narateFile;    // Used in speakText, only called in Amazon?
    int _sndSubFile;    // Used in speakText, only called in Amazon?
    int _countTbl[6];   // Used in speakText, only called in Amazon?
 
    // Fields that are included in savegames
    int _conversation;
    int _currentMan;
    uint32 _newTime;
    uint32 _newDate;
    int _flags[256];
 
    // Fields used by MM and sometimes Noctropolis
    // TODO: Refactor
    byte _travel[60]; // only first ~15 used in MM
    byte _ask[40];
    byte _asked[40]; // Noctropolis only
    int _startTravelItem;
    int _startTravelBox;
    int _startAboutItem;
    int _startAboutBox;
 
    int _boxDataStart;
    bool _boxDataEnd;
    int _boxSelectY;
    int _boxSelectYOld;
    int _numLines;
    int _bcnt;
 
    bool _clearSummaryFlag; // amazon only
    bool _cheatFl;   // cheats are enabled
    bool _restartFl; // game should restart
    bool _textFlag;  // whether subtitles are enabled
    bool _hotspotFl; // whether hotspot highlighting is enabled (for debug)
    bool _exitBox;   // whether the current hotspot is an exit (Noctropolis only)
    uint16 _stilScaleOff;
 
    // Fields mapped into the flags array
    int &_useItem;
    int &_startup;
    int &_manScaleOff;
    int &_pictureTaken;     // Only used in MM
 
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;
    AccessGameType getGameID() const;
    bool gameIs(AccessGameType game) 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 clearPlotImagesIn(int16 x, int16 y, int16 w, int16 h);
    void clearPlotVidsIn(int16 x, int16 y, int16 w, int16 h);
 
    void copyBlocks();
 
    void copyRects();
 
    void copyBF1BF2();
 
    void copyBF2Vid();
 
    void freeChar();
 
    virtual int16 getScreenWidth() const { return 320; }
    virtual int16 getScreenHeight() const { return 200; }
 
    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 loadGameStream(Common::SeekableReadStream *stream) override;
 
    Common::Error saveGameStream(Common::WriteStream *stream, bool isAutosave = false) override;
    bool canLoadGameStateCurrently(Common::U32String *msg = nullptr) override;
 
    bool canSaveGameStateCurrently(Common::U32String *msg = nullptr) override;
 
    static bool readSavegameHeader(Common::InSaveFile *in, AccessSavegameHeader &header, bool skipThumbnail = true);
 
    bool playMovie(const Common::Path &filename, const Common::Point &pos);
 
    const AccessActionCode *getActionCodes();
 
    virtual void drawOverlays();
 
};
 
} // End of namespace Access
 
#endif /* ACCESS_ACCESS_H */