abstract_kart_animation.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_ABSTRACT_KART_ANIMATION_HPP
#define HEADER_ABSTRACT_KART_ANIMATION_HPP
 
#include "LinearMath/btTransform.h"
 
#include "config/stk_config.hpp"
#include "utils/no_copy.hpp"
#include "utils/vec3.hpp"
 
#include <exception>
#include <limits>
#include <string>
 
class AbstractKart;
class BareNetworkString;
 
enum KartAnimationType : uint8_t
{
    KAT_RESCUE = 0,
    KAT_EXPLOSION = 1,
    KAT_CANNON = 2
};
 
class KartAnimationCreationException : public std::exception
{
public:
    virtual int getSkippingOffset() const = 0;
};
 
class AbstractKartAnimation: public NoCopy
{
private:
    std::string m_name;
 
protected:
    AbstractKart *m_kart;
 
    int m_end_ticks;
 
    int m_created_ticks;
 
    btTransform m_created_transform;
 
    /* Compressed values for server to send to avoid compressing everytime. */
    int m_created_transform_compressed[4];
 
    void resetPowerUp();
    // ------------------------------------------------------------------------
    void restoreBasicState(BareNetworkString* buffer);
    // ------------------------------------------------------------------------
    float getMaximumHeight(const Vec3& up_vector, float height_remove);
 
public:
                 AbstractKartAnimation(AbstractKart* kart,
                                       const std::string &name);
    virtual     ~AbstractKartAnimation();
    virtual void update(int ticks);
    // ------------------------------------------------------------------------
    virtual void updateGraphics(float dt);
    // ------------------------------------------------------------------------
    virtual float getAnimationTimer() const;
    // ------------------------------------------------------------------------
    virtual const std::string &getName() const { return m_name; }
    // ------------------------------------------------------------------------
    virtual KartAnimationType getAnimationType() const = 0;
    // ------------------------------------------------------------------------
    /* Used to ignore adding karts back to physics when destroying world. */
    void handleResetRace()   { m_end_ticks = std::numeric_limits<int>::max(); }
    // ------------------------------------------------------------------------
    /* Used to recreate animation in \ref KartRewinder. */
    virtual void saveState(BareNetworkString* buffer);
    // ------------------------------------------------------------------------
    /* Called when kart animation is the same in kart state, which make sure
     * for example the end or created ticks are the same. */
    virtual void restoreState(BareNetworkString* buffer)
                                                 { restoreBasicState(buffer); }
};   // AbstractKartAnimation
 
#endif