------------------------------------------------------------------------------- dojox.gfx ------------------------------------------------------------------------------- Version 1.100 Release date: 08/01/2006 ------------------------------------------------------------------------------- Project state: SVG renderer: production VML renderer: production Silverlight renderer: beta HTMLCanvas renderer: beta SVGWeb integration: experimental ------------------------------------------------------------------------------- Credits Eugene Lazutkin (eugene.lazutkin@gmail.com) Kun Xi (bookstack@gmail.com) Chris Mitchell (ccmitchellusa@gmail.com) HTML Canvas Yang Li () SVGWeb integration ------------------------------------------------------------------------------- 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: 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. SVGWeb Integration Status See README-svgweb. ------------------------------------------------------------------------------- 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. -------------------------------------------------------------------------------