path.hpp

//  SuperTux Path
//  Copyright (C) 2005 Philipp <balinor@pnxs.de>
//  Copyright (C) 2006 Christoph Sommer <christoph.sommer@2006.expires.deltadevelopment.de>
//  Copyright (C) 2006 Matthias Braun <matze@braunis.de>
//
//  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 HEADER_SUPERTUX_OBJECT_PATH_HPP
#define HEADER_SUPERTUX_OBJECT_PATH_HPP

#include <memory>
#include <string>
#include <vector>

#include "math/vector.hpp"
#include "math/easing.hpp"
#include "util/gettext.hpp"

template<typename T>
class ObjectOption;
class PathGameObject;
class ReaderMapping;
class Writer;

enum class WalkMode {
  // moves from first to last path node and stops
  ONE_SHOT,
  // moves from first to last node then in reverse order back to first
  PING_PONG,
  // moves from last node back to the first node
  CIRCULAR
};

WalkMode string_to_walk_mode(const std::string& mode_string);
std::string walk_mode_to_string(WalkMode walk_mode);

class Path final
{
public:
  class Node
  {
  private:
    Path* parent; 
  public:
    Vector position; 
    Vector bezier_before; 
    Vector bezier_after; 
    float time; 
    float speed; 
    EasingMode easing; 
  public:
    Node(Path* parent_) :
      parent(parent_),
      position(0.0f, 0.0f),
      bezier_before(0.0f, 0.0f),
      bezier_after(0.0f, 0.0f),
      time(),
      speed(),
      easing()
    {}

    Path& get_parent() const { return *parent; }
  };

public:
  Path(PathGameObject& parent);
  Path(const Vector& pos, PathGameObject& parent);

  void read(const ReaderMapping& reader);
  void save(Writer& writer);

  Vector get_base() const;

  int get_nearest_node_idx(const Vector& reference_point) const;

  int get_farthest_node_idx(const Vector& reference_point) const;

  void move_by(const Vector& shift);

  void edit_path();

  bool is_valid() const;

  const std::vector<Node>& get_nodes() const { return m_nodes; }

  PathGameObject& get_gameobject() const { return m_parent_gameobject; }

private:
  PathGameObject& m_parent_gameobject;

public:
  std::vector<Node> m_nodes;

  WalkMode m_mode;

  bool m_adapt_speed; 
  void on_flip(float height);

private:
  Path(const Path&) = delete;
  Path& operator=(const Path&) = delete;
};

#endif

/* EOF */