stk-code_catmod/src/replay/replay_base.hpp

//
//  SuperTuxKart - a fun racing game with go-kart
//  Copyright (C) 2012-2015 Joerg Henrichs
//
//  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, write to the Free Software
//  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

#ifndef HEADER_REPLAY_BASE_HPP
#define HEADER_REPLAY_BASE_HPP

#include "LinearMath/btTransform.h"
#include "utils/no_copy.hpp"

#include <stdio.h>
#include <string>
#include <vector>

/**
  * \ingroup race
  */
class ReplayBase : public NoCopy
{
    // Needs access to KartReplayEvent
    friend class GhostKart;

protected:
    /** Stores a transform event, i.e. a position and rotation of a kart
     *  at a certain time. */
    struct TransformEvent
    {
        /** Time at which this event happens. */
        float               m_time;
        /** The transform at a certain time. */
        btTransform         m_transform;
    };   // TransformEvent

    // ------------------------------------------------------------------------
    struct PhysicInfo
    {
        /** The speed at a certain time. */
        float               m_speed;
        /** The steering at a certain time. */
        float               m_steer;
        /** The suspension length of 4 wheels at a certain time. */
        float               m_suspension_length[4];
        /** The skidding state */
        int                 m_skidding_state;
    };   // PhysicInfo

    // ------------------------------------------------------------------------
    struct BonusInfo
    {
        /** The attachment. This is stored using a custom format
            0 = none ; 1 = parachute ; 2 = anvil ; 3 = bomb ;
            4 = swatter ; 5 = bubblegum
            This is necessary so replay files are not broken if the
            game internal attachment format/ordering is changed. */
        int                 m_attachment;
        /** The nitro amount at a certain time. */
        float               m_nitro_amount;
        /** The number of items at a certain time. */
        int                 m_item_amount;
        /** The type of item at a certain time. */
        int                 m_item_type;
        /** Used to store mode-specific values : eggs in egg-hunt,
            number of lives in battle-mode. */
        int                 m_special_value;
    };   // StateInfo


    // ------------------------------------------------------------------------
    /** Records all other events. */
    struct KartReplayEvent
    {
        /** distance on track for the kart recorded. */
        float  m_distance;
        /** Nitro usage for the kart recorded. */
        int    m_nitro_usage;
        /** Zipper usage for the kart recorded. */
        bool   m_zipper_usage;
        /** Skidding effect for the kart recorded. */
        int    m_skidding_effect;
        /** Kart skidding showing red flame or not. */
        bool   m_red_skidding;
        /** True if the kart recorded is jumping. */
        bool        m_jumping;
    };   // KartReplayEvent

    // ------------------------------------------------------------------------
    FILE *openReplayFile(bool writeable, bool full_path = false, int replay_file_number=1);
    // ------------------------------------------------------------------------
    /** Returns the filename that was opened. */
    virtual const std::string& getReplayFilename(int replay_file_number = 1) const = 0;
    // ------------------------------------------------------------------------
    /** Returns the version number of the replay file recorderd by this executable.
     *  This is also used as a maximum supported version by this exexcutable. */
    unsigned int getCurrentReplayVersion() const { return 4; }

    // ------------------------------------------------------------------------
    /** This is used to check that a loaded replay file can still
     *  be understood by this executable. */
    unsigned int getMinSupportedReplayVersion() const { return 3; }

public:
             ReplayBase();
    virtual ~ReplayBase() {};
};   // ReplayBase

#endif