package ch.epfl.maze.physical;

import ch.epfl.maze.util.Direction;
import ch.epfl.maze.util.Vector2D;

/**
 * Animal inside a {@code World} that can move depending on the available
 * choices it has at its position.
 *
 * @author EPFL
 * @author Pacien TRAN-GIRARD
 */
abstract public class Animal {

    private Vector2D position;

    /**
     * Constructs an animal with a specified position.
     *
     * @param position Position of the animal in the labyrinth
     */
    public Animal(Vector2D position) {
        this.position = position;
    }

    /**
     * Retrieves the next direction of the animal, by selecting one choice among
     * the ones available from its position.
     *
     * @param choices The choices left to the animal at its current position (see
     *                {@link ch.epfl.maze.physical.World#getChoices(Vector2D)
     *                World.getChoices(Vector2D)})
     * @return The next direction of the animal, chosen in {@code choices}
     */
    abstract public Direction move(Direction[] choices);

    /**
     * Updates the animal position with a direction.
     * <p>
     * <b>Note</b> : Do not call this function in {@code move(Direction[]
     * choices)} !
     *
     * @param dir Direction that the animal has taken
     */
    public final void update(Direction dir) {
        this.position = this.position.addDirectionTo(dir);
    }

    /**
     * Sets new position for Animal.
     * <p>
     * <b>Note</b> : Do not call this function in {@code move(Direction[]
     * choices)} !
     *
     * @param position
     */
    public final void setPosition(Vector2D position) {
        this.position = position;
    }

    /**
     * Returns position vector of animal.
     *
     * @return Current position of animal.
     */
    public final Vector2D getPosition() {
        return this.position;
    }

    abstract public Animal copy();

}