-------------------------------------------------------------------------------
dojox.gfx
-------------------------------------------------------------------------------
Version 1.100
Release date: 08/01/2006
-------------------------------------------------------------------------------
Project state:
beta
HTMLCanvas renderer: experimental
-------------------------------------------------------------------------------
Credits
Eugene Lazutkin (eugene.lazutkin@gmail.com)
Kun Xi (bookstack@gmail.com)
Chris Mitchell (ccmitchellusa@gmail.com) HTML Canvas
-------------------------------------------------------------------------------
Project description
Implementation of simple portable 2D graphics library.
-------------------------------------------------------------------------------
Dependencies:
Dojo Core
-------------------------------------------------------------------------------
Documentation
Currently it can be found here: http://docs.google.com/Doc?id=d764479_1hnb2tn
HTMLCanvas Renderer Status
To use canvas rendering, insert 'canvas' at the beginning of the gfxRenderers list in your
djConfig, for example:
<script type="text/javascript" src="../../../dojo/dojo.js"
djConfig="parseOnLoad: true, gfxRenderer: 'canvas,svg,silverlight,vml'"></script>
canvas currently will only render on non-IE browsers (see dojox/gfx.js for where the renderer is loaded);
although it should be possible to use an IE canvas implementation (like Google's); however, it will be very slow.
The following tests can be made to work with HTML Canvas with minor testcase modification:
dojox/gfx/tests
test_gfx.html-Bugs #1
test_arc.html
test_bezier.html
test_pattern.html
test_gradient.html
test_linearGradient.html
test_image1.html - Limitation #3
test_transform.html - Bug #1
test_poly.html - Bug #1
dojox/gfx/demos
butterfly.html - Bug #1
lion.html - Bug #1
tiger.html - Bug #1
circles.html - No event processing yet :(
creator.html
dojox/chart
test_pie2d.html - Dojo Charts on iPhone anyone? :)
test_chart2d.html -
// To make charts work, the following line needs to be added to the end of the
// Chart2D.js render() method (prior to return)
if(this.surface.render){this.surface.render()};
Known Limitations:
1) event handling- plan is to capture all events at canvas, perform intersect/hit
tests (not implemented) against scene graph, then propogate event to top-most
intersected shape. HtmlCanvas shape need intersectsStroke and intersectsBounds,
and intersects (region).
2) SVG and VML are "live" scene graphs; eg. any state change to objects in the
scene automatically get rendered in next engine render pass. For canvas, it's
procedural, and current implementation requires application to call surface.render()
whenever scene needs to be updated. Plan is to do dirty region checking based
on bounding boxes (currently not properly computed), and track dirty areas anytime
state changes (invalidate) separate from render phase.
Add the following call where changes to the scene graph are complete and you want to
render:
if (surface.render){surface.render();}
4) Text/Text Paths - Text shape is implemented using DIV overlays. Many text styles are not
applied, and outline/fills are not possible. This is due to limitations in Canvas spec.
Firefox 3.0 has proprietary text functions that we could test for and use once FF3 is out.
No luck on Safari.
3) No Image skewing - Limitation of Canvas
Known Bugs:
1) Matrix xformations (applied from root to shape leaf nodes) not quite right--but very close.
Canvas does not have a built in transformation function that allows skewing. Need to
track skew matrix with Shape, and perform other trans/rot/scale transformations without
using canvas transform functions.
-------------------------------------------------------------------------------
Installation instructions
Grab the following from the Dojo SVN Repository:
http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/gfx.js
http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/gfx/*
Install into the following directory structure:
/dojox/gfx/
...which should be at the same level as your Dojo checkout.
-------------------------------------------------------------------------------
8398c9048d