This web contains the official documentation of the TWiki Release 4.2, code named FreetownRelease. It is a read-only web for reference. Please update documentation at TWiki.TWikiDrawPlugin. -- PeterThoeny - 29 Aug 2008
You are here: TWiki>
TWiki04x02 Web>TWikiDrawPlugin (17 May 2006, PeterThoeny)
TWiki04x02 Web>TWikiDrawPlugin (17 May 2006, PeterThoeny)TWikiDrawPlugin
On this page:
This plugin encapsulates the TWikiDraw Java Applet first developed by TWiki:Main/PeterThoeny from the original JHotDraw.
JHotDraw is a simple drawing editor that supports drawing in a style similar to that found in MS Powerpoint and MS Word. Various shaped figures can be placed in the drawing and text annotations joined to them.
Unique to TWikiDrawPlugin, a drawing can also have a "map" which makes figures in the drawing sensitive to the mouse cursor. A map is automatically added to an image when a URL is attached to any of the figures.
How you edit a drawing depends on whether the drawing has a map and the setting of the "EDIT_BUTTON" option. A drawing with no map can be edited simply by clicking on the drawing. A drawing with a map can be edited by clicking the edit button or, failing that, on the boundary of the image.
Browser support for Java 1.1 or later required.
Syntax Rules
- Write the command
%DRAWING{name}%anywhere in a TWiki topic. You can name the drawing anything you like, allowed characters areA-Z a-z 0-9 _ - .. If you have only one drawing in the topic you can simply write%DRAWING%.
Tools
The tools on the left create or manipulate figures.
|
|||||||||||||||||||||||||||
Handles
When selected, figures provide different handles to manipulate them.- the white squares let you to manipulate the shape of a figure
- the green squares on connections let you to reconnect them with another figure.
- the yellow circles on polygon figures let you change the size and rotation of the figure
- yellow circles on rounded rectangles let you change the radius of the corners
- the yellow circles on connections let you manipulate the position of connection segments.
Commands
Commands are invoked from the button bar at the bottom or from the menu bar at the top. The standard commands that are provided include cut, copy, paste, duplicate, delete, group, ungroup, bring to front, and send to back.Attributes
Attributes, such as fill color, text color or arrow tip, can be changed through the attributes menus.TWikiDrawPlugin Settings
- Set SHORTDESCRIPTION = Java Applet based drawing editor
- Set EXTRA_COLORS = Aquamarine=#70DB93,New Tan=#EBC79E,Sea Green=#238E68,Motorola Blue=#3ff
- Set EDIT_BUTTON = 1
- Set EDIT_TEXT = Edit drawing '%F%' (requires a Java 1.1 enabled browser)
Plugin Installation Instructions
- Download the ZIP file from the Plugin web (see below). Contents:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
- Unzip
TWikiDrawPlugin.zipin your twiki installation directory. - (Dakar) Visit
configurein your TWiki installation, and enable the plugin in the {Plugins} section. - To test if the plugin is correctly installed, view this topic in the installation and you should see a placeholder box below. Click on it.
- Here's an example using an image map. Move the mouse over the image and watch the status bar.
Edit
Known Problems
If you add a map to a drawing by setting a URL on any of the figures a map file is created. If you subsequently remove all the URLs from figures in the drawing the map still exists, but is now empty. There is no way to remove the map other than by manually moving the attachment.Plugin Info
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
- TWikiDrawPlugin is based on Erich Gamma's JHotDraw 5.1. (JHotDraw is copyright 1996, 1997 by IFA Informatik and Erich Gamma, erich_gamma@acmPLEASENOSPAM.org . It is hereby granted that this software can be used, copied, modified, and distributed without fee provided that this copyright notice appears in all copies. )
- TWikiDrawPlugin uses ACME Labs' GifEncoder to convert a drawing into a GIF file format. (GifEncoder is Copyright ©1996,1998 by Jef Poskanzer, jef@acmePLEASENOSPAM.com . All rights reserved. THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. )
- TWikiDrawPlugin uses some ideas of KmWiki drawing applet.
- Copyright 2000 by Peter Thoeny, Peter@ThoenyPLEASENOSPAM.com. It is hereby granted that this software can be used, copied, modified, and distributed without fee provided that this copyright notice appears in all copies.
- Modifications Copyright © 2001 Motorola. All Rights Reserved.
- Modifications © 2003-2004 Copyright Crawford Currie http://www.c-dot.co.uk
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
