Class: SMap_Tile

The option 'cacheTime' by default. There is no 'setter' function for cache time because flatten() calls SMap_Layer::cacheStatus() in order to set this value.

Objects are constrained and dumped in here (in order) via addObject().

The tile grid marks the position of this tile in the rest of the view. This should be used sparingly in order to allow caching. The grid also won't be available if we have some sort of dynamic Google Maps thing going on.

Applies a tile to an object, and adds said object to the $objs array.

If the image doesn't already exist, create it. If layers have been added but not rendered, render them.

This is the second step in the process of rendering. The first is adding the layers. Here we take care of reducing each layer to objects, or retrieving the cached image.

Flattening is done after all layers are added so background labels can avoid foreground objects (such as the panning graphic). This is done before the final render is done so that labels have a chance to organize and send themselves to corrisponding tiles.

Image format selection is also decided here. We hope that photo realistic images (such as satellite) can be compressed as JPEG, just because it's more efficient compression. If a single layer requests PNG compression, though, we'll have to use PNG. This will ensure that we aren't forcing lossy compression where there shouldn't be any.

If all layers can agree on a different format (not PNG or JPEG), that format will be used. Ensure that the chosen format is enabled in SMap_Object_CachedImage::cache(), SMap_Object_CachedImage::getCachedFName(), and display().

If applicable, we are also handling caching here. SMap_Layer::cacheStatus() is called, and we figure out which layers should be cached, and which we can't cache at all. If the tile is cacheable and we have a cached tile, we retrieve it and use it. Otherwise we need to break it down to layers. Is each layer cacheable? Use a SMap_Object_CachedImage in place of rendering it.

This key is different than SMap::$key because it only uses the layers enabled in this tile. It can also only be used after flatten() is called.

If we are returning a server side image map, one of the returned objects will be of shape 'ismap'. The form should be able to handle this case. If a user clicks on a server side image map, {@SMap::handleImageMap()} should be called, which will return the appropriate URL the user should be redirected to.

If we are returning a client side image map, returned set of arrays represent the "area" of the image map. They have indexes at ['alt'], ['coords'], ['shape'], and ['href'].

If there is no link here, we will return an empty array.

If no last modified time is set, then the current time is used. If there is already a modified time, then the more recent one is used.

POSX,POSY are the position of the current tile in the grid. VIEWX,VIEWY are the dimensions of the view. TILESX,TILESY are the dimensions of the current map. VIEWX,VIEWY normaly equals TILESX,TILESY, except when a tile is being rendered. TILESX,TILESY are the only indicies that always are set.