fact.hexmap

Class FactPixelMapping

java.lang.Object

fact.hexmap.FactPixelMapping

All Implemented Interfaces:

PixelMapping

public class FactPixelMapping
extends Object
implements PixelMapping

This class provides a mapping between different Pixel ids and geometric information from the camera layout.

This class cen get instatiated as a singleton with the getInstance() method.

The geometric coordinates stored in the text file to build this map are stored in the "odd -q" vertical layout See http://www.redblobgames.com/grids/hexagons/ for details and pictures.

The coordinates are offset by 22 on the x-axis and by 19 on the y-axis

Author:

Kai

Field Summary

Fields

Modifier and Type	Field and Description
CameraPixel[]	pixelArray

Method Summary

Modifier and Type	Method and Description
int	getChidFromSoftID(int softid)
int[]	getCubeCoordinatesFromId(int id)
static FactPixelMapping	getInstance()
CameraPixel[]	getNeighborsForPixel(CameraPixel p) Return an array of CameraPixel which direct are neighbours to the pixel passed into this method.
CameraPixel[]	getNeighborsFromID(int id) Return an array of CameraPixel which are direct neighbours to the pixel ID passed into this method.
int	getNumberCols()
int	getNumberOfPixel()
int	getNumberRows()
CameraPixel	getPixelBelowCoordinatesInMM(double xCoordinate, double yCoordinate) Get the CameraPixel sitting below the coordinates passed to the method.
CameraPixel	getPixelFromCubeCoordinates(long x, long z)
CameraPixel	getPixelFromId(int id)
CameraPixel	getPixelFromOffsetCoordinates(int x, int y)
CameraPixel[]	getSecondOrderNeighboursForPixel(CameraPixel p) Return an array of CameraPixel which are the neighbours of the neighbours without the direct neighbours.
CameraPixel[]	getSecondOrderNeighboursFromID(int id) Return an array of CameraPixel which are the neighbours of the neighbours without the direct neighbours.
int	getSoftIDFromChid(int chid)
ArrayList<Integer>	line(int id1, int id2) Find lines between two pixels on the hexagonal grid.
double	toDouble(Serializable value)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

pixelArray

public final CameraPixel[] pixelArray

Method Detail

getInstance

public static FactPixelMapping getInstance()

getNumberRows

public int getNumberRows()

getNumberCols

public int getNumberCols()

getPixelBelowCoordinatesInMM

public CameraPixel getPixelBelowCoordinatesInMM(double xCoordinate,
                                                double yCoordinate)

Get the CameraPixel sitting below the coordinates passed to the method. The center of the coordinate system in the camera is the center of the camera.

Parameters:

xCoordinate -

yCoordinate -

Returns:

The pixel below the point or NULL if the pixels does not exist.

getNeighborsFromID

public CameraPixel[] getNeighborsFromID(int id)

Return an array of CameraPixel which are direct neighbours to the pixel ID passed into this method.

Parameters:

id - the id of pixel

Returns:

neighbouring Pixels

getNeighborsForPixel

public CameraPixel[] getNeighborsForPixel(CameraPixel p)

Return an array of CameraPixel which direct are neighbours to the pixel passed into this method.

Parameters:

p - the pixel to get the neighbours from

Returns:

neighbouring Pixels

getSecondOrderNeighboursFromID

public CameraPixel[] getSecondOrderNeighboursFromID(int id)

Return an array of CameraPixel which are the neighbours of the neighbours without the direct neighbours. These are all pixels with distance 2

Parameters:

id -

Returns:

array of CameraPixel; not always the same length

getSecondOrderNeighboursForPixel

public CameraPixel[] getSecondOrderNeighboursForPixel(CameraPixel p)

Return an array of CameraPixel which are the neighbours of the neighbours without the direct neighbours. These are all pixels with distance 2

Parameters:

p -

Returns:

array of CameraPixel; not always the same length

getCubeCoordinatesFromId

public int[] getCubeCoordinatesFromId(int id)

getPixelFromCubeCoordinates

public CameraPixel getPixelFromCubeCoordinates(long x,
                                               long z)

line

public ArrayList<Integer> line(int id1,
                               int id2)

Find lines between two pixels on the hexagonal grid. Line here means the 'path' with the minimal number of pixels between these two pixels. The length of the line is calculated as hexagonal distance. Returns an ArrayList containing the IDs of the line-pixel (including end-pixels id1 and id2).

Parameters:

id1 -

id2 -

Returns:

ArrayList

toDouble

public double toDouble(Serializable value)

getPixelFromOffsetCoordinates

public CameraPixel getPixelFromOffsetCoordinates(int x,
                                                 int y)

Specified by:

getPixelFromOffsetCoordinates in interface PixelMapping

getNumberOfPixel

public int getNumberOfPixel()

Specified by:

getNumberOfPixel in interface PixelMapping

getPixelFromId

public CameraPixel getPixelFromId(int id)

Specified by:

getPixelFromId in interface PixelMapping

getChidFromSoftID

public int getChidFromSoftID(int softid)

getSoftIDFromChid

public int getSoftIDFromChid(int chid)