Extension:AnyWikiDraw

What can this extension do?
The AnyWikiDraw extensions adds a  tag to the MediaWiki parser which allows to edit SVG, PNG and JPEG images directly in a page using a Java applet.

This extension is also available for PmWiki and TWiki.

Usage
The tag has the following form:


 * The tag needs to be put into two curly braces.
 * The name of the tag is
 * The parameter  specifies the name of the image file. If you specify an image file that does not yet exist in your Wiki, the image is created the first time you save a drawing.
 * The image name may have one of the following extensions: svg, svgz, png, jpg.
 * The parameter  specifies the width of the image
 * The parameter  specifies the height of the image

To draw the image HappyWiki.svg with a width of 400 pixels and a height of 300 pixels on a page, insert the following tag:

Installation

 * 1) Copy the AnyWikiDraw folder into the   folder of your MediaWiki installation.
 * 2) Change the LocalSettings.php file as described below.

Changes to LocalSettings.php
require_once("$IP/extensions/AnyWikiDraw/AnyWikiDraw.php");

To Do
This extension is in experimental state, because its functionality is incomplete, and because there are some known issues:

Missing functionality

 * Support for the ODG file format is missing. ODG is the Open Document Drawing format used by Open Office, Neo Office and other open source office programs.
 * Support for the TWikiDraw and PmWikiDraw file formats is missing.
 * SVG Color gradients are displayed but can not be edited.
 * SVG Markers are not yet supported.
 * The offline version of AnyWikiDraw is missing.

Known issues

 * AnyWikiDraw only works with the specified MediaWiki versions.
 * Browsers don't refresh images after they are saved. We need either find a way to clear the image cache of the browser, or to deliver images without letting the browser cache them.
 * Pages which use the drawing tag are not listed as linking to the image file.
 * It is not clear, how we can add support for image formats like ODG .odg, TWikiDraw .draw an PmWikiDraw .draw. For these file formats MediaWiki can not render a thumbnail image. Of course, the AnyWikiDraw Applet can render the thumbnail image, and even passes it to the server. But there is no API which allows let extensions render thumbnail images.
 * The scribble tool and the polygon tool sometimes create Bezier paths with wrong tangent points, which are sometimes outside of the drawing area.
 * Generated images always has a size of 256x256 pixels, because the drawing editor does currently not save a widht and height value in the drawing.

Links
A demo of the drawing applet can be tried out at http://www.randelshofer.ch/anywikidraw/demo/anywikidraw_for_twiki_demo.html