crschmidt 68f70f750b Add support for a Canvas renderer. This renderer will allow for some new
capabilties in OpenLayers Vector drawing, including: 
 * Vector support for iPhone, Safari 2.x series browsers
 * Improved performance of dragging the map with a large number of 
   geometries.

The Vector layer default renderer order is now SVG, VML, Canvas, so browsers
with Canvas support and no SVG or VML will be able to draw vectors.

The Canvas layer has a number of limitations: getFeatureFromEvent is much
slower than the other types of layer, and any change to any feature requires a
redraw of the entire canvas. Because Canvas is typically a pretty fast 
drawing implementation, the latter is less problematic than it might otherwise
be.

r=pagameba,fred, with glances from a couple other people.
(Closes #1512)


git-svn-id: http://svn.openlayers.org/trunk/openlayers@7862 dc9f47b5-9b13-0410-9fdd-eb0c1a62fdaf
2008-08-26 14:22:59 +00:00
2008-01-01 08:14:55 +00:00

OpenLayers
-=-=-=-=-=-
Copyright (c) 2005-2008 MetaCarta, Inc.

OpenLayers is a JavaScript library for building map applications
on the web. OpenLayers is made available under a BSD-license.
Please see license.txt in this distribution for more details.

------------------
Getting OpenLayers
------------------

OpenLayers lives at http://www.openlayers.org/.

You can get OpenLayers from
    http://trac.openlayers.org/wiki/HowToDownload.

---------------------
Installing OpenLayers
---------------------

You can use OpenLayers as-is by copying build/OpenLayers.js and the
entire theme/ and img/ directories up to your webserver, putting them 
in the same directory. The files can be in subdirectories on your website, 
or right in the root of the site, as in these examples. 
To include the OpenLayers library in your web page from the root of the site, use:

  <script type="text/javascript" src="/OpenLayers.js" />

As an example, using bash (with the release files in ~/openlayers ):
$ cd /var/www/html
$ cp ~/openlayers/build/OpenLayers.js ./
$ cp -R ~/openlayers/theme ./
$ cp -R ~/openlayers/img ./

If you want to use the multiple-file version of OpenLayers (for, say,
debugging or development purposes), copy the lib/ directory up to your
webserver in the same directory you put the img/ folder. Then add
the following to your web page instead:

  <script type="text/javascript" src="/lib/OpenLayers.js" />

As an example, using bash (with the release files in ~/openlayers ):
$ cd /var/www/html
$ cp -R ~/openlayers/lib ./
$ cp -R ~/openlayers/theme ./
$ cp -R ~/openlayers/img ./


------------------------------------
Using OpenLayers in Your Own Website
------------------------------------

The examples/ directory is full of useful examples.

Documentation is available at http://trac.openlayers.org/wiki/Documentation.
You can generate the API documentation with http://www.naturaldocs.org/:
As an example, using bash (with the release files in ~/openlayers ):
$ cd ~/openlayers/
$ /path/to/NaturalDocs -i lib/ -o HTML doc/ -p doc_config/ -s Default OL

Information on changes in the API is available in news.txt.

--------------------------
Contributing to OpenLayers
--------------------------

Please join the email lists at http://openlayers.org/mailman/listinfo
Patches are welcome!

= 30 =
Description
Languages
JavaScript 99%
CSS 0.6%
Handlebars 0.3%
Shell 0.1%