actor.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 SCUMM_ACTOR_H
#define SCUMM_ACTOR_H

#include "common/scummsys.h"
#include "common/serializer.h"
#include "scumm/scumm.h"

namespace Scumm {

#define CHORE_REDIRECT_INIT        56
#define CHORE_REDIRECT_WALK        57
#define CHORE_REDIRECT_STAND       58
#define CHORE_REDIRECT_START_TALK  59
#define CHORE_REDIRECT_STOP_TALK   60
#define CHORE_TURN_DIR             61
#define CHORE_FACE_DIR             62
#define CHORE_STOP                 63

enum {
    V12_X_MULTIPLIER = 8,
    V12_Y_MULTIPLIER = 2,

    V12_X_SHIFT = 3,
    V12_Y_SHIFT = 1
};

enum MoveFlags {
    MF_NEW_LEG = 1,
    MF_IN_LEG = 2,
    MF_TURN = 4,
    MF_LAST_LEG = 8,
    MF_FROZEN = 0x80
};

struct CostumeData {
    CostumeData() {
        reset();
    }

    byte animType[16];
    uint16 animCounter;
    byte soundCounter;
    byte soundPos;
    uint16 stopped;
    uint16 curpos[16];
    uint16 start[16];
    uint16 end[16];
    uint16 frame[16];

    /* HE specific */
    uint16 heJumpOffsetTable[16] = {};
    uint16 heJumpCountTable[16] = {};
    uint32 heCondMaskTable[16] = {};

    void reset() {
        animCounter = 0;
        soundCounter = 0;
        soundPos = 0;
        stopped = 0;
        memset(animType, 0, sizeof(animType)); // AKAT_Empty
        memset(curpos, 0xFF, sizeof(curpos));
        memset(start, 0xFF, sizeof(start));
        memset(end, 0xFF, sizeof(end));
        memset(frame, 0xFF, sizeof(frame));
    }
};

struct AdjustBoxResult {    /* Result type of AdjustBox functions */
    int16 x, y;
    byte box;
};

enum {
    kOldInvalidBox = 255,   // For GF_SMALL_HEADER games
    kNewInvalidBox = 0
};

class Actor : public Common::Serializable {
public:
    static byte kInvalidBox;

protected:
    ScummEngine *_vm;

    Common::Point _pos;

public:
    int _top = 0, _bottom = 0;
    uint _width = 0;
    byte _number = 0;
    uint16 _costume = 0;
    byte _room = 0;

public:
    byte _talkColor = 0;
    int _talkFrequency = 0;
    byte _talkPan = 0;
    byte _talkVolume = 0;
    uint16 _boxscale = 0;
    byte _scalex = 0, _scaley = 0;
    byte _charset = 0;
    byte _moving = 0;
    bool _ignoreBoxes = false;
    byte _forceClip = 0;
    uint16 _lastValidX = 0, _lastValidY = 0;

    byte _initFrame = 0;
    byte _walkFrame = 0;
    byte _standFrame = 0;
    byte _talkStartFrame = 0;
    byte _talkStopFrame = 0;

    bool _needRedraw = false, _needBgReset = false, _visible = false;
    byte _shadowMode = 0;
    bool _flip = false;
    byte _frame = 0;
    byte _walkbox = 0;
    int16 _talkPosX = 0, _talkPosY = 0;
    uint16 _talkScript = 0, _walkScript = 0;
    bool _ignoreTurns = false;
    bool _drawToBackBuf = false;
    int32 _layer = 0;
    uint16 _sound[32] = {};
    CostumeData _cost;

    /* HE specific */
    int _heOffsX = 0, _heOffsY = 0;
    bool _heSkipLimbs = false;
    uint32 _heCondMask = 0;
    uint32 _hePaletteNum = 0;
    uint32 _heShadow = 0;

protected:
    struct ActorWalkData {
        Common::Point dest;           // Final destination point
        byte destbox = 0;             // Final destination box
        int16 destdir = 0;            // Final destination, direction to face at

        Common::Point cur;            // Last position
        byte curbox = 0;              // Last box

        Common::Point next;           // Next position on our way to the destination, i.e. our intermediate destination

        Common::Point point3;
        int32 deltaXFactor = 0, deltaYFactor = 0;
        uint16 xfrac = 0, yfrac = 0;
        uint16 xAdd = 0, yAdd = 0;
        int16 facing = 0;

        void reset() {
            dest.x = dest.y = 0;
            destbox = 0;
            destdir = 0;
            cur.x = cur.y = 0;
            curbox = 0;
            next.x = next.y = 0;
            point3.x = point3.y = 0;
            deltaXFactor = 0;
            deltaYFactor = 0;
            xfrac = 0;
            yfrac = 0;
            xAdd = 0;
            yAdd = 0;
            facing = 0;
        }
    };


    uint16 _palette[256] = {};
    int _elevation = 0;
    uint16 _facing = 0;
    uint16 _targetFacing = 0;
    uint _speedx = 0, _speedy = 0;
    byte _animProgress = 0, _animSpeed = 0;
    bool _costumeNeedsInit = false;
    ActorWalkData _walkdata;
    int16 _animVariable[27] = {};

public:

    Actor(ScummEngine *scumm, int id);
    ~Actor() override {}

//protected:
    virtual void hideActor();
    void showActor();

    virtual void initActor(int mode);

    void putActor() {
        putActor(_pos.x, _pos.y, _room);
    }

    void putActor(int room) {
        putActor(_pos.x, _pos.y, room);
    }

    void putActor(int x, int y) {
        putActor(x, y, _room);
    }

    void putActor(int x, int y, int room);
    void setActorWalkSpeed(uint newSpeedX, uint newSpeedY);
protected:
    virtual int calcMovementFactor(const Common::Point& next);
    virtual int actorWalkStep();
    virtual int remapDirection(int dir, bool is_walking);
    virtual void setupActorScale();

    void setBox(int box);
    int updateActorDirection(bool is_walking);

public:
    void adjustActorPos();
    virtual AdjustBoxResult adjustXYToBeInBox(int dstX, int dstY);

    virtual void setDirection(int direction);
    void faceToObject(int obj);
    virtual void turnToDirection(int newdir);
    virtual void walkActor();
    void drawActorCostume(bool hitTestMode = false);
    virtual void prepareDrawActorCostume(BaseCostumeRenderer *bcr);
    virtual void animateCostume();
    virtual void setActorCostume(int c);

    void animateLimb(int limb, int f);

    bool actorHitTest(int x, int y);

    const byte *getActorName();
    void startWalkActor(int x, int y, int dir);
    void stopActorMoving();
protected:
    void startWalkAnim(int cmd, int angle);
public:
    void runActorTalkScript(int f);
    virtual void startAnimActor(int frame);

    void remapActorPalette(int r_fact, int g_fact, int b_fact, int threshold);
    void remapActorPaletteColor(int slot, int color);

    void animateActor(int anim);

    bool isInCurrentRoom() const {
        return _room == _vm->_currentRoom;
    }

    Common::Point getPos() const {
        Common::Point p(_pos);
        if (_vm->_game.version <= 2) {
            p.x *= V12_X_MULTIPLIER;
            p.y *= V12_Y_MULTIPLIER;
        }
        return p;
    }

    const Common::Point& getRealPos() const {
        return _pos;
    }

    int getRoom() const {
        return _room;
    }

    int getFacing() const {
        return _facing;
    }

    void setFacing(int newFacing) {
        _facing = newFacing;
    }

    int getAnimVar(byte var) const;
    void setAnimVar(byte var, int value);

    void setAnimSpeed(byte newAnimSpeed) {
        _animSpeed = newAnimSpeed;
        _animProgress = 0;
    }

    int getAnimSpeed() const {
        return _animSpeed;
    }

    int getAnimProgress() const {
        return _animProgress;
    }

    int getElevation() const {
        return _elevation;
    }

    void setElevation(int newElevation) {
        if (_elevation != newElevation) {
            _elevation = newElevation;
            _needRedraw = true;
        }

        if (_vm->_game.heversion >= 70) {
            _needRedraw = true;
            _needBgReset = true;
        }
    }

    void setPalette(int idx, int val) {
        _palette[idx] = val;
        _needRedraw = true;
    }

    void setScale(int sx, int sy) {
        if (sx != -1)
            _scalex = sx;
        if (sy != -1)
            _scaley = sy;
        _needRedraw = true;

        if (_vm->_game.heversion >= 70) {
            _needBgReset = true;
        }
    }

    void classChanged(int cls, bool value);

    void saveLoadWithSerializer(Common::Serializer &ser) override;

protected:
    bool isInClass(int cls);

    virtual bool isPlayer();

    bool findPathTowards(byte box, byte box2, byte box3, Common::Point &foundPath);
};

class Actor_v3 : public Actor {
public:
    Actor_v3(ScummEngine *scumm, int id) : Actor(scumm, id), _stepX(1), _stepThreshold(0), _facingXYratio(scumm->_game.version == 3 ? 3 : 1) {}

    void initActor(int mode) override;
    void walkActor() override;

    void saveLoadWithSerializer(Common::Serializer &ser) override;

protected:
    int calcMovementFactor(const Common::Point& next) override;
    void setupActorScale() override;
    void findPathTowardsOld(byte box, byte box2, byte box3, Common::Point &p2, Common::Point &p3);
    uint _stepThreshold;
private:
    virtual int actorWalkStep() override;
    uint _stepX;
    const int _facingXYratio;
};

class Actor_v2 : public Actor_v3 {
public:
    Actor_v2(ScummEngine *scumm, int id) : Actor_v3(scumm, id) {}

    void initActor(int mode) override;
    void walkActor() override;
    AdjustBoxResult adjustXYToBeInBox(int dstX, int dstY) override;

protected:
    bool isPlayer() override;
    void prepareDrawActorCostume(BaseCostumeRenderer *bcr) override;
private:
    int actorWalkStep() override;
    int remapDirection(int dir, bool is_walking) override;
};

class Actor_v7 final : public Actor {
public:
    Actor_v7(ScummEngine *scumm, int id) : Actor(scumm, id) {}

    void initActor(int mode) override;
    void walkActor() override;
    void turnToDirection(int newdir) override;
    void startAnimActor(int frame) override;

private:
    int updateActorDirection();
};

enum ActorV0MiscFlags {
    kActorMiscFlagStrong    = 0x01, // Kid is strong (Hunk-O-Matic used)
    kActorMiscFlagGTFriend  = 0x02, // Kid is green tentacle's friend (recording contract)
    kActorMiscFlagWatchedTV = 0x04, // Kid knows publisher's address (watched TV)
    kActorMiscFlagEdsEnemy  = 0x08, // Kid is not Weird Ed's friend
    kActorMiscFlag_10       = 0x10, // ???
    kActorMiscFlag_20       = 0x20, // ???
    kActorMiscFlagFreeze    = 0x40, // Stop moving
    kActorMiscFlagHide      = 0x80  // Kid is invisible (dead or in radiation suit)
};

class Actor_v0 : public Actor_v2 {
public:
    Common::Point _CurrentWalkTo, _NewWalkTo;

    Common::Array<byte> _walkboxHistory;

    byte _walkboxQueue[0x10] = {};
    byte _walkboxQueueIndex = 0;

    byte _costCommandNew = 0;
    byte _costCommand = 0;
    byte _miscflags = 0;
    byte _speaking = 0;

    byte _walkCountModulo = 0;
    bool _newWalkBoxEntered = false;

    byte _walkDirX = 0;
    byte _walkDirY = 0;

    byte _walkYCountGreaterThanXCount = 0;
    byte _walkXCount = 0;
    byte _walkXCountInc = 0;
    byte _walkYCount = 0;
    byte _walkYCountInc = 0;

    byte _walkMaxXYCountInc = 0;

    Common::Point _tmp_Pos;
    Common::Point _tmp_NewPos;
    byte _tmp_WalkBox = 0;
    bool _tmp_NewWalkBoxEntered = false;

    int8 _animFrameRepeat = 0;
    int8 _limbFrameRepeatNew[8] = {};
    int8 _limbFrameRepeat[8] = {};

    bool _limb_flipped[8] = {};

private:

    bool walkBoxQueueAdd(int box);
    bool walkBoxQueueFind(int box);
    void walkboxQueueReverse();

public:
    Actor_v0(ScummEngine *scumm, int id) : Actor_v2(scumm, id) {}

    void initActor(int mode) override;
    void animateActor(int anim);
    void animateCostume() override;

    void limbFrameCheck(int limb);

    void directionUpdate();
    void speakCheck();
    void setDirection(int direction) override;
    void startAnimActor(int f) override;

    bool calcWalkDistances();
    void walkActor() override;
    void actorSetWalkTo();
    byte actorWalkXCalculate();
    byte actorWalkYCalculate();
    byte updateWalkbox();

    void walkBoxQueueReset();
    bool walkBoxQueuePrepare();

    AdjustBoxResult adjustXYToBeInBox(int dstX, int dstY) override;
    AdjustBoxResult adjustPosInBorderWalkbox(AdjustBoxResult box);

    void setActorToTempPosition();
    void setActorToOriginalPosition();

    void saveLoadWithSerializer(Common::Serializer &ser) override;
};


} // End of namespace Scumm

#endif