WikiDrawPlugin

create or annotate images and save as svg and png

Usage

WikiDrawPlugin uses SVG-edit (trunk svn from 29/09/2010 - pre2.6) to provide quick and easy drawing or annotation of images.

WARNING: editing not compatible with InternetExplorer - but viewing of the drawings works correctly

Syntax Rules

Warning: Can't find topic System.VarWIKIDRAW

save drawing as attachment to current topic

   %WIKIDRAW{
      "drawing"
      annotate="http://somewhere.onthenet.com/some_image.png" 
   }%

save drawing to a 'WikiDrawForm' topic

WikiDraw also can save the svg source for the drawing as the text of a topic - allowing searching and hand editing of that source, while continuing to provide the wysiwyg editing facility.

   %WIKIDRAW{
      "Sandbox.WikiDrawing"
      annotate="Sandbox.SomeImage/some_image.png" 
   }%

Extra Plugin support.

If Foswiki:Extensions.ImagePlugin is installed and enabled, the default skin template will automatically use it to lay out the image and drawing.

Technical details

This plugin adds a ext-foswiki.js extension that over-rides the built in 'Save Image' SVG menu item with a save to foswiki handler, which generates a png version of the overlay, and sends that, and the svg source to foswiki.

The transparent overlay png is displayed in view mode, and the annotated image (if any) will be put behind it using the css background.

Known issues:

1. it really doesn't like using svg dimensions other than 640x480 (I'e reported an issue for this, as its really painful when creating a drawing)
2. hide the edit buttons for ie..
3. _DEFAULT="Web.Topic/something" is very broken
4. strikeone support
5. comment support..
6. wow. subtle bug. - using %!WIKIDRAW{Sandbox.SomeTopic}%, will find the first image attached to BASETOPIC, which might be a tad surprising.

features to be added?

1. can we diff the svg's ?

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Info

Many thanks to the following sponsors for supporting this work:

• TRIN, The Taxonomic Information Network for Australian National Biodiversity Research

Author(s):	Foswiki:Main.SvenDowideit
Copyright:	© 2010 SvenDowideit @fosiki.com and SVG-edit contributors and David Belais (pngIE)
License:	GPL (Gnu General Public License) and Apache License 2.0 for SVG-edit
Release:	1.0.0
Version:	9700 (2010-10-24)
Change History:
21 October 2010:	initial public release
Dependencies:	None
Home page:	http://foswiki.org/bin/view/Extensions/WikiDrawPlugin
Support:	http://foswiki.org/bin/view/Support/WikiDrawPlugin