com.threerings.miso.client

Class SceneBlock

java.lang.Object

com.threerings.miso.client.SceneBlock

public class SceneBlock
extends Object

Contains the base and object tile information on a particular rectangular region of a scene.

Constructor Summary

Constructors

Constructor and Description
SceneBlock(MisoSceneModel model, MisoSceneMetrics metrics, TileManager tileMgr, int tx, int ty, int width, int height)
SceneBlock(MisoScenePanel panel, int tx, int ty, int width, int height) Creates a scene block belonging to panel in preparation for its later resolution.

Method Summary

Modifier and Type	Method and Description
boolean	addObject(ObjectInfo info) Adds the supplied object to this block.
boolean	canTraverse(Object traverser, int tx, int ty) Returns true if the specified traverser can traverse the specified tile (which is assumed to be in the bounds of this scene block).
void	computeMemoryUsage(Map<Tile.Key,BaseTile> bases, Set<BaseTile> fringes, Map<Tile.Key,ObjectTile> objects, long[] usage) Computes the memory usage of the base and object tiles in this scene block; registering counted tiles in the hash map so that other blocks can be sure not to double count them.
boolean	deleteObject(ObjectInfo info) Removes the specified object from this block.
BaseTile	getBaseTile(int tx, int ty) Returns the base tile at the specified coordinates or null if there's no tile at said coordinates.
Rectangle	getBounds() Returns the bounds of this block, in tile coordinates.
Polygon	getFootprint() Returns the screen-coordinate polygon bounding the footprint of this block.
BaseTile	getFringeTile(int tx, int ty) Returns the fringe tile at the specified coordinates or null if there's no tile at said coordinates.
Rectangle	getObjectBounds() Returns the bounds of the screen coordinate rectangle that contains all pixels that are drawn on by all objects (but not base tiles) in this block.
SceneObject[]	getObjects() Returns an array of all resolved scene objects in this block.
Rectangle	getScreenBounds() Returns the bounds of the screen coordinate rectangle that contains all pixels that are drawn on by all tiles and objects in this block.
boolean	isResolved() Returns true if this block has been resolved, false if not.
boolean	resolve() This method is called by the SceneBlockResolver on the block resolution thread to allow us to load up our image data without blocking the AWT thread.
void	setVisiBlock(boolean visi) Makes a note that this block was considered to be visible at the time it was created.
String	toString()
void	updateBaseTile(int fqTileId, int tx, int ty) Informs this scene block that the specified base tile has been changed.
void	updateFringe(int tx, int ty) Instructs this block to recompute its fringe at the specified location.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SceneBlock

public SceneBlock(MisoScenePanel panel,
                  int tx,
                  int ty,
                  int width,
                  int height)

Creates a scene block belonging to panel in preparation for its later resolution.

SceneBlock

public SceneBlock(MisoSceneModel model,
                  MisoSceneMetrics metrics,
                  TileManager tileMgr,
                  int tx,
                  int ty,
                  int width,
                  int height)

Method Detail

setVisiBlock

public void setVisiBlock(boolean visi)

Makes a note that this block was considered to be visible at the time it was created. This is purely for debugging purposes.

resolve

public boolean resolve()

This method is called by the SceneBlockResolver on the block resolution thread to allow us to load up our image data without blocking the AWT thread.

isResolved

public boolean isResolved()

Returns true if this block has been resolved, false if not.

getBounds

public Rectangle getBounds()

Returns the bounds of this block, in tile coordinates.

getScreenBounds

public Rectangle getScreenBounds()

Returns the bounds of the screen coordinate rectangle that contains all pixels that are drawn on by all tiles and objects in this block.

getObjectBounds

public Rectangle getObjectBounds()

Returns the bounds of the screen coordinate rectangle that contains all pixels that are drawn on by all objects (but not base tiles) in this block. Note: this will return null if the block has no objects.

getFootprint

public Polygon getFootprint()

Returns the screen-coordinate polygon bounding the footprint of this block.

getObjects

public SceneObject[] getObjects()

Returns an array of all resolved scene objects in this block.

getBaseTile

public BaseTile getBaseTile(int tx,
                            int ty)

Returns the base tile at the specified coordinates or null if there's no tile at said coordinates.

getFringeTile

public BaseTile getFringeTile(int tx,
                              int ty)

Returns the fringe tile at the specified coordinates or null if there's no tile at said coordinates.

updateBaseTile

public void updateBaseTile(int fqTileId,
                           int tx,
                           int ty)

Informs this scene block that the specified base tile has been changed.

updateFringe

public void updateFringe(int tx,
                         int ty)

Instructs this block to recompute its fringe at the specified location.

addObject

public boolean addObject(ObjectInfo info)

Adds the supplied object to this block. Coverage is not computed for the added object, a subsequent call to update(java.util.Map<java.lang.Integer, com.threerings.miso.client.SceneBlock>) will be needed.

Returns:

true if the object was added, false if it was not because another object of the same type already occupies that location.

deleteObject

public boolean deleteObject(ObjectInfo info)

Removes the specified object from this block. Coverage is not recomputed, so a subsequent call to update(java.util.Map<java.lang.Integer, com.threerings.miso.client.SceneBlock>) will be needed.

Returns:

true if the object was deleted, false if it was not found in our object list.

canTraverse

public boolean canTraverse(Object traverser,
                           int tx,
                           int ty)

Returns true if the specified traverser can traverse the specified tile (which is assumed to be in the bounds of this scene block).

computeMemoryUsage

public void computeMemoryUsage(Map<Tile.Key,BaseTile> bases,
                               Set<BaseTile> fringes,
                               Map<Tile.Key,ObjectTile> objects,
                               long[] usage)

Computes the memory usage of the base and object tiles in this scene block; registering counted tiles in the hash map so that other blocks can be sure not to double count them. Base tile usage is placed into the zeroth array element, fringe tile usage into the first and object tile usage into the second.

toString

public String toString()

Overrides:

toString in class Object