package ch.epfl.maze.util;
/**
* Directions that an animal can take to move. They represent the four cardinal
* points ({@code DOWN, UP, RIGHT, LEFT}) from the frame of reference of the
* labyrinth, plus a default one : {@code NONE}.
*
* @author Pacien TRAN-GIRARD
*/
public enum Direction {
DOWN, UP, RIGHT, LEFT, NONE;
/**
* An array of all the possible directions that can be taken.
*/
public static final Direction[] POSSIBLE_DIRECTIONS = new Direction[]{
Direction.DOWN,
Direction.UP,
Direction.RIGHT,
Direction.LEFT
};
/**
* Returns the integer value of the direction
*
* @return Integer value of the direction
*/
public int intValue() {
switch (this) {
case DOWN:
return 0;
case UP:
return 1;
case RIGHT:
return 2;
case LEFT:
return 3;
case NONE:
default:
return 4;
}
}
/**
* Converts the direction into an orthonormal vector, when possible.
*
* @return Orthonormal {@code Vector2D} that represents the direction.
*/
public Vector2D toVector() {
switch (this) {
case DOWN:
return new Vector2D(0, 1);
case UP:
return new Vector2D(0, -1);
case RIGHT:
return new Vector2D(1, 0);
case LEFT:
return new Vector2D(-1, 0);
case NONE:
default:
return new Vector2D(0, 0);
}
}
/**
* Reverses the direction.
*
* @return The opposite direction.
*/
public Direction reverse() {
switch (this) {
case DOWN:
return UP;
case UP:
return DOWN;
case RIGHT:
return LEFT;
case LEFT:
return RIGHT;
case NONE:
default:
return NONE;
}
}
/**
* Determines whether the argument is the opposite of another.
*
* @param d The direction to compare with
* @return true if the direction is the opposite the argument,
* false otherwise
*/
public boolean isOpposite(Direction d) {
return this == d.reverse();
}
/**
* Converts the argument relative to the frame of reference given by the
* direction that calls the method.
*
* @param dir The direction to convert
* @return The direction converted to the frame of reference given by the
* direction called.
*/
public Direction relativeDirection(Direction dir) {
switch (this) {
case DOWN:
return dir.reverse();
case UP:
return dir;
case RIGHT:
return dir.rotateLeft();
case LEFT:
return dir.rotateRight();
case NONE:
default:
return NONE;
}
}
/**
* Converts the argument back to the frame of reference of the labyrinth
*
* @param dir The direction to convert back
* @return The direction converted back to the frame of reference of the
* labyrinth
*/
public Direction unRelativeDirection(Direction dir) {
switch (this) {
case DOWN:
return dir.reverse();
case UP:
return dir;
case RIGHT:
return dir.rotateRight();
case LEFT:
return dir.rotateLeft();
case NONE:
default:
return NONE;
}
}
/**
* Rotates the direction to the right.
*
* @return The rotated direction to the right
*/
public Direction rotateRight() {
switch (this) {
case DOWN:
return LEFT;
case UP:
return RIGHT;
case RIGHT:
return DOWN;
case LEFT:
return UP;
case NONE:
default:
return NONE;
}
}
/**
* Rotates the direction to the left.
*
* @return The rotated direction to the left
*/
public Direction rotateLeft() {
switch (this) {
case DOWN:
return RIGHT;
case UP:
return LEFT;
case RIGHT:
return UP;
case LEFT:
return DOWN;
case NONE:
default:
return NONE;
}
}
/**
* Applies the change of coordinates relative to the frame of reference
* of the direction that calls the method to all the directions in the
* argument.
*
* @param dir The array of directions to convert
* @return The directions converted to the frame of reference given by the
* direction which calls the method
*/
public Direction[] relativeDirections(Direction[] dir) {
Direction[] relativeDirections = new Direction[dir.length];
for (int i = 0; i < dir.length; i++) {
relativeDirections[i] = this.relativeDirection(dir[i]);
}
return relativeDirections;
}
}