package net.knarcraft.stargate.container; /** * This stores a block location as a vector relative to a position * *
A relative block vector stores a vector relative to some origin. The origin in this plugin is usually the * top-left block of a gate (top-left when looking at the side with the sign). The right is therefore the distance * from the top-left corner towards the top-right corner. Depth is the distance from the top-left corner to the * bottom-left corner. Distance is the distance outward from the gate.
*/ public class RelativeBlockVector { private final int right; private final int depth; private final int distance; public enum Property {RIGHT, DEPTH, DISTANCE} /** * Instantiates a new relative block vector * * @param rightThe distance to the right relative to the origin
* @param depthThe distance downward relative to the origin
* @param distanceThe distance outward relative to the origin
*/ public RelativeBlockVector(int right, int depth, int distance) { this.right = right; this.depth = depth; this.distance = distance; } /** * Adds a value to one of the properties of this relative block vector * * @param propertyToAddToThe property to change
* @param valueToAddThe value to add to the property
* @returnA new relative block vector with the property altered
*/ public RelativeBlockVector addToVector(Property propertyToAddTo, int valueToAdd) { switch (propertyToAddTo) { case RIGHT: return new RelativeBlockVector(this.right + valueToAdd, this.depth, this.distance); case DEPTH: return new RelativeBlockVector(this.right, this.depth + valueToAdd, this.distance); case DISTANCE: return new RelativeBlockVector(this.right, this.depth, this.distance + valueToAdd); default: throw new IllegalArgumentException("Invalid relative block vector property given"); } } /** * Gets a relative block vector which is this inverted (pointing in the opposite direction) * * @returnThis vector, but inverted
*/ public RelativeBlockVector invert() { return new RelativeBlockVector(-this.right, -this.depth, -this.distance); } /** * Gets the distance to the right relative to the origin * * @return The distance to the right relative to the origin */ public int getRight() { return right; } /** * Gets the distance downward relative to the origin * * @return The distance downward relative to the origin */ public int getDepth() { return depth; } /** * Gets the distance outward relative to the origin * * @return The distance outward relative to the origin */ public int getDistance() { return distance; } @Override public String toString() { return String.format("(right = %d, depth = %d, distance = %d)", right, depth, distance); } @Override public boolean equals(Object other) { if (other == this) { return true; } if (other == null || this.getClass() != other.getClass()) { return false; } RelativeBlockVector otherVector = (RelativeBlockVector) other; return this.right == otherVector.right && this.depth == otherVector.depth && this.distance == otherVector.distance; } }