8
Gaming API and Sound
PlayField are all empty (tile 0 - a reserved tile and represents an empty square). A tile set can later be added using setStaticTileSet().
PlayField Methods
The PlayField class defines the following methods:
•public void addSprite(Sprite s) throws
NullPointerException – Add a Sprite to the PlayField. Ignores the request if the Sprite is already associated with the PlayField.
•public void removeSprite(Sprite s) throws
RuntimeException, NullPointerException – Remove a Sprite from PlayField.
•public void removeAllSprites() – Remove all Sprites from PlayField.
•public int createAnimatedTile(int staticTileIdx) throws IndexOutOfBoundsException – Creates a new animated tile and initializes it with a static tile index. Returns the index to use when referring to this animated tile. The indices for animated tiles will be negative (<0) and the indices for the static tile set will be positive (>=0). The index sets do not overlap and therefore indices for static and animated tiles can be used interchangeably in the methods that set or move the contents of the PlayField cells. The first animated tile shall have the index
•public void setAnimatedTileImage(int animTileIdx, int staticTileIdx) throws IndexOutOfBoundsException –
Sets the static tile that will be displayed in any cell that contains the animated tile. The method parameters are animTileIdx - index of the animated tile, and staticTileIdx - index of a static tile to be referenced by the animated tile.
•public int getAnimatedTileImage(int animTileIdx) throws IndexOutOfBoundsException – Get the static tile referenced by an animated tile, and returns the index of the static tile that is currently referenced by an animated tile.
•public void setCell(int celCol, int celRow, int tileIdx) throws IndexOutOfBoundsException, ArrayIndexOutOfBoundsException – Sets the tile to be displayed in a cell. The tile can be either a static or an animated tile. The method parameters are celCol - column of cell to set, celRow - row of cell to set, and tileIdx - index of tile to place in cell.
•public int getCell(int celCol, int celRow)
throws.ArrayIndexOutOfBoundsException – Gets the index of the static or animated tile currently displayed in a cell.
•public void moveTiles(int dstCol, int dstRow,
int srcCol, int srcRow, int width, int height) throws ArrayIndexOutOfBoundsException – Move a rectangular set of tiles from a source location to a destination location. Source cells are left empty. If the
51
