Integrate Untiled Functionality into Grid

This patch contains the singleTile functionality, as well as the events improvements/triggering in the Grid and Tile Layers. All new functionality includes a thorough test.

forgot to mention that there are two examples which clearly show the new functionality:

http://dev.openlayers.org/sandbox/euzuro/untiled3/examples/notile.html Shows the OpenLayers.Layer.WMS.Untiled and OpenLayers.Layer.WMS (with singleTile: true) working back to back

http://dev.openlayers.org/sandbox/euzuro/untiled3/examples/layerLoadMonitoring.html Shows the tile loading events as exhibited in grid layers of different buffer size, and the singletile.

all tests pass in ff & ie6.

I know this is a whopper, so if I can help in any way to get this reviewed as soon as possible, it would be greatly appreciated.

of worthy note, the diffstat for the changes to the lib directory:

$ svn diff lib > diff.js; cat diff.js | diffstat
 Layer/Grid.js        |  344 ++++++++++++++++++++++++++++++++++++++-------------

 Layer/KaMap.js       |    4
 Layer/WMS/Untiled.js |  271 +---------------------------------------
 Tile.js              |   24 +++
 Tile/Image.js        |   26 +++
 5 files changed, 322 insertions(+), 347 deletions(-)

(net reduction 25 lines of core code)

---

and the diffstat for changes to the tests directory

$ svn diff tests/ > diff.js; cat diff.js | diffstat
 Layer/test_Grid.html  |  383 +++++++++++++++++++++++++++++++++++++++++++++++---

 Layer/test_KaMap.html |    2
 Layer/test_TMS.html   |    2
 Tile/test_Image.html  |   16 +-
 test_Handler.html     |   25 ---
 test_Tile.html        |   29 +++
 6 files changed, 410 insertions(+), 47 deletions(-)

(net gain 363 lines of tests)

tim had snuck a test change into trunk before i created this patch.

updated diffstat for tests directory for new patch:

$ svn diff tests/ | diffstat
 Layer/test_Grid.html  |  383 +++++++++++++++++++++++++++++++++++++++++++++++---

 Layer/test_KaMap.html |    2
 Layer/test_TMS.html   |    2
 Tile/test_Image.html  |   16 +-
 test_Tile.html        |   29 +++
 5 files changed, 406 insertions(+), 26 deletions(-)

(net gain 380 lines of tests)

This is really slick work. Thanks for all your effort ripping in to this.

I approve - but know it is big enough that others might want to weigh in first.

please commit and mark Untiled subclasses as deprecated

The name of getGridBounds changed to getTilesBounds. In general, I'm fine with this, but I don't like that we don't maintain backwards compatibility. (I understand that getGridBounds was not an APIMethod, but I consider it important enough to be worth keeping backwards compatibility for.)

Other than that, patch looks just fine, and I'm ready to commit if that gets changed.

Brought back getGridBounds() as deprecated and marked WMS.Untiled deprecated as well.

the main differences in the 3rd patch are the following:

+    /**
      * Method: getGridBounds
+     * Deprecated. This function will be removed in 3.0. Please use 
+     *     getTilesBounds() instead.
+     * 
+     * Return:
+     * {<OpenLayers.Bounds>} A Bounds object representing the bounds of all the
+     * currently loaded tiles (including those partially or not at all seen 
+     * onscreen)
+     */
+    getGridBounds: function() {
+        var msg = "The getGridBounds() function is deprecated. It will be " +
+                  "removed in 3.0. Please use getTilesBounds() instead.";
+        OpenLayers.Console.warn(msg);
+        return getTilesBounds();
+    },
+

and

 /**
- * @requires OpenLayers/Layer/HTTPRequest.js
  * @requires OpenLayers/Layer/WMS.js
  *
  * Class: OpenLayers.Layer.WMS
+ * Deprecated, to be removed in 3.0 - instead use OpenLayers.Layer.WMS and 
+ *     pass the option 'singleTile' as true.
  * 
  * Inherits from: 
- *  - <OpenLayers.Layer.HTTPRequest>
+ *  - <OpenLayers.Layer.WMS>
  */

and

+        var msg = "The OpenLayers.Layer.WMS.Untiled class is deprecated and " +
+                  "will be removed in 3.0. Instead, you should use the " +
+                  "normal OpenLayers.Layer.WMS class, passing it the option " +
+                  "'singleTile' as true.";
+        OpenLayers.Console.warn(msg);
     },    

committed with r3725