org.refcodes.checkerboard.MooreNeighbourhood Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of refcodes-checkerboard Show documentation
Artifact for providing some easy means to visualize (state of) board games or (state of) cellular automatons.
There is a newer version: 3.3.8
Show newest version
// /////////////////////////////////////////////////////////////////////////////
// REFCODES.ORG
// /////////////////////////////////////////////////////////////////////////////
// This code is copyright (c) by Siegfried Steiner, Munich, Germany and licensed
// under the following (see "http://en.wikipedia.org/wiki/Multi-licensing")
// licenses:
// -----------------------------------------------------------------------------
// GNU General Public License, v3.0 ("http://www.gnu.org/licenses/gpl-3.0.html")
// -----------------------------------------------------------------------------
// Apache License, v2.0 ("http://www.apache.org/licenses/LICENSE-2.0")
// -----------------------------------------------------------------------------
// Please contact the copyright holding author(s) of the software artifacts in
// question for licensing issues not being covered by the above listed licenses,
// also regarding commercial licensing models or regarding the compatibility
// with other open source licenses.
// /////////////////////////////////////////////////////////////////////////////

package org.refcodes.checkerboard;

import org.refcodes.exception.BugException;

/**
 * Definitions of the Moore neighbourhood.
 */
public enum MooreNeighbourhood implements Neighbourhood {

	LEFT(-1, 0), TOP_LEFT(-1, -1), TOP(0, -1), TOP_RIGHT(1, -1), RIGHT(1, 0), BOTTOM_RIGHT(1, 1), BOTTOM(1, 0), BOTTOM_LEFT(-1, 1);

	private int _posX;
	private int _posY;

	private MooreNeighbourhood( int aPosX, int aPosY ) {
		_posX = aPosX;
		_posY = aPosY;
	}

	/**
	 * Returns the relative X position to position (0, 0).
	 * 
	 * @return The relative position X to the (0,0) coordinate.
	 */
	@Override
	public int getPositionX() {
		return _posX;
	}

	/**
	 * Returns the relative Y position to position (0, 0).
	 * 
	 * @return The relative position Y to the (0,0) coordinate.
	 */
	@Override
	public int getPositionY() {
		return _posY;
	}

	/**
	 * Returns the next clockwise state relative to the current state. Imagine
	 * the states as the positions on a clock, next to {@link #TOP} would be
	 * {@link #TOP_RIGHT}, next to {@link #TOP_RIGHT} would be {@link #RIGHT},
	 * and so on (clockwise).
	 * 
	 * @return The next state relative to the current state.
	 */
	@Override
	public MooreNeighbourhood clockwiseNext() {
		switch ( this ) {
		case TOP:
			return TOP_RIGHT;
		case TOP_RIGHT:
			return RIGHT;
		case RIGHT:
			return BOTTOM_RIGHT;
		case BOTTOM_RIGHT:
			return BOTTOM;
		case BOTTOM:
			return BOTTOM_LEFT;
		case BOTTOM_LEFT:
			return LEFT;
		case LEFT:
			return TOP_LEFT;
		case TOP_LEFT:
			return TOP;
		default:
			throw new BugException( "Missing case statement for <" + this + "> in implementation!" );
		}
	}

	/**
	 * Returns the next anti-clockwise state relative to the current state.
	 * Imagine the states as the positions on a clock, next to {@link #TOP}
	 * would be {@link #TOP_LEFT}, next to {@link #TOP_LEFT} would be
	 * {@link #LEFT}, and so on (anti-clockwise).
	 * 
	 * @return The next state relative to the current state.
	 */
	@Override
	public MooreNeighbourhood clockwisePrevious() {
		switch ( this ) {
		case TOP:
			return TOP_LEFT;
		case TOP_LEFT:
			return LEFT;
		case LEFT:
			return BOTTOM_LEFT;
		case BOTTOM_LEFT:
			return BOTTOM;
		case BOTTOM:
			return BOTTOM_RIGHT;
		case BOTTOM_RIGHT:
			return RIGHT;
		case RIGHT:
			return TOP_RIGHT;
		case TOP_RIGHT:
			return TOP;
		default:
			throw new BugException( "Missing case statement for <" + this + "> in implementation!" );
		}
	}
}