drive_node.hpp

//
//  SuperTuxKart - a fun racing game with go-kart
//  Copyright (C) 2009-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, B

#ifndef HEADER_DRIVE_NODE_HPP
#define HEADER_DRIVE_NODE_HPP

#include <vector>

#include "tracks/quad.hpp"

class DriveNode : public Quad
{
public:
    enum         DirectionType {DIR_STRAIGHT, DIR_LEFT, DIR_RIGHT,
                                DIR_UNDEFINED};
protected:
    Vec3 m_lower_center;

    Vec3 m_upper_center;

    float m_distance_from_start;

private:
    bool               m_ai_ignore;

    std::vector<int>   m_successor_nodes;

    std::vector<int>   m_predecessor_nodes;

    std::vector<float> m_distance_to_next;

    std::vector<float> m_angle_to_next;

    float m_width;

    Vec3 m_center_to_right;

    typedef std::vector<int> PathToNodeVector;
    PathToNodeVector  m_path_to_node;

    std::vector<DirectionType>  m_direction;

    std::vector<unsigned int> m_last_index_same_direction;

    Vec3 m_right_unit_vector;

   std::vector< int > m_checkline_requirements;


    // ------------------------------------------------------------------------
   void markAllSuccessorsToUse(unsigned int n,
                                PathToNodeVector *m_path_to_node);

public:
                 DriveNode(const Vec3 &p0, const Vec3 &p1, const Vec3 &p2,
                           const Vec3 &p3, const Vec3 &normal,
                           unsigned int node_index, bool invisible,
                           bool ai_ignore, bool ignored);
    // ------------------------------------------------------------------------
         virtual ~DriveNode() {}
    // ------------------------------------------------------------------------
    void         addSuccessor (unsigned int to);
    // ------------------------------------------------------------------------
    void         setupPathsToNode();
    // ------------------------------------------------------------------------
    void         setChecklineRequirements(int latest_checkline);
    // ------------------------------------------------------------------------
    void         setDirectionData(unsigned int successor, DirectionType dir,
                                  unsigned int last_node_index);
    // ------------------------------------------------------------------------
    unsigned int getNumberOfSuccessors() const
                             { return (unsigned int)m_successor_nodes.size(); }
    // ------------------------------------------------------------------------
    unsigned int getSuccessor(unsigned int i)  const
                                               { return m_successor_nodes[i]; }
    // ------------------------------------------------------------------------
    unsigned int getNumberOfPredecessors() const
                           { return (unsigned int)m_predecessor_nodes.size(); }
    // ------------------------------------------------------------------------
    int getPredecessor(unsigned int i) const { return m_predecessor_nodes[i]; }
    // ------------------------------------------------------------------------
    float        getDistanceToSuccessor(unsigned int j) const
                                              { return m_distance_to_next[j]; }
    // ------------------------------------------------------------------------
    float        getAngleToSuccessor(unsigned int j) const
                                                 { return m_angle_to_next[j]; }
    // ------------------------------------------------------------------------
    float        getDistanceFromStart() const
                                              { return m_distance_from_start; }
    // ------------------------------------------------------------------------
    void         setDistanceFromStart(float d)   { m_distance_from_start = d; }
    // ------------------------------------------------------------------------
    float        getPathWidth() const                       { return m_width; }
    // ------------------------------------------------------------------------
    const Vec3& getLowerCenter() const               { return m_lower_center; }
    // ------------------------------------------------------------------------
    const Vec3& getUpperCenter() const               { return m_upper_center; }
    // ------------------------------------------------------------------------
    float       getNodeLength() const
                           { return (m_lower_center-m_upper_center).length(); }
    // ------------------------------------------------------------------------
    bool        ignoreSuccessorForAI(unsigned int i) const;
    // ------------------------------------------------------------------------
    int getSuccessorToReach(unsigned int n)
    {
        // If we have a path to node vector, use its information, otherwise
        // (i.e. there is only one successor anyway) use this one successor.
        return m_path_to_node.size()>0 ? m_path_to_node[n] : 0;
    }   // getSuccesorToReach
    // ------------------------------------------------------------------------
    const std::vector<int>& getChecklineRequirements() const
                                           { return m_checkline_requirements; }
    // ------------------------------------------------------------------------
    void getDirectionData(unsigned int succ, DirectionType *dir,
                          unsigned int *last) const
    {
        *dir = m_direction[succ];  *last = m_last_index_same_direction[succ];
    }
    // ------------------------------------------------------------------------
    const Vec3 &getRightUnitVector() const      { return m_right_unit_vector; }
    // ------------------------------------------------------------------------
    bool        letAIIgnore() const                     { return m_ai_ignore; }
    // ------------------------------------------------------------------------
    virtual void getDistances(const Vec3 &xyz, Vec3 *result) const = 0;

};   // DriveNode

#endif