File	Date	Author	Commit
demos	2014-11-21	Andrew Shadura	[020abb] Fix file modes
doc	2015-02-25	Andras Varga	[21fe9d] doc: documented supported values for linecap/li...
generic	2015-03-02	Zoltan Bojthe	[2d5e6a] bugfix: 'coords' command with arrows
library	2014-10-21	Zoltan Bojthe	[34ac19] change tkpath version to 0.3.3
macosx	2015-03-02	Zoltan Bojthe	[a6704f] macosx: implements multiline ptext
tclconfig	2012-07-04	George Petasis	[790813] Updated to TEA 3.9
tests	2008-07-23	Mats Bengtsson	[9731b0] * Updated by roger.
unix	2015-02-26	Zoltan Bojthe	[16ef55] linux: implements multiline ptext
win	2015-02-26	Zoltan Bojthe	[a08850] better condition for: windows: pimage fix: halo...
.hgtags	2013-04-05	Andrew Shadura	[ebaffc] Update tags
ChangeLog	2014-10-27	Zoltan Bojthe	[9d4f33] ChangeLog updated
Makefile.in	2012-07-04	George Petasis	[e0076e] Updated to TEA 3.9
README.txt	2008-05-22	Mats Bengtsson	[0bab3a] * Update.
TODO	2008-07-25	Mats Bengtsson	[ecd576] * Added bug item.
WhatsNew	2014-10-22	Andras Varga	[aab097] added WhatsNew file
aclocal.m4	2007-01-23	Carlos Tasada	[3cac48] - Updated building system to TEA 3.5
configure	2015-02-25	Rudolf Hornig	[519af6] build: fixed build errors on linux/windows
configure.in	2015-02-25	Rudolf Hornig	[519af6] build: fixed build errors on linux/windows
pkgIndex.tcl.in	2014-11-21	Andrew Shadura	[020abb] Fix file modes

Read Me

                           README for tkpath
                           _________________

This package implements path drawing modelled after its SVG counterpart,
see http://www.w3.org/TR/SVG11/. See the doc directory for more info.

There are three backends used for drawing. They are all platform specific
except for the Tk drawing which uses only the API found in Tk. This
backend is very limited and has some problems with multiple subpaths.
It is only to be used as a fallback when the cairo backend is missing.

The backends:

    1) CoreGraphics for MacOSX, built using ProjectBuilder
 
    2) GDI+ for WinXP, built by VC++7 (.NET), runs also on older system
       using the gdiplus.dll

    3) cairo (http://cairographics.org), built using the automake system;
       the configure.in and Makefile.in files are a hack, so please help
       yourself (and me). It requires a cairo 1.0 installation since
       incompatible API changes appeared before 1.0 (libcairo.so.2 ?).

There used to be two additional backends, GDI and core Tk drawing, but 
these have been dropped.

I could think of another backend based on X11 that has more features than
the compatibility layer of Tk, since the fallback is only necessary on unix 
systems anyway. Perhaps an OpenGL backend would also be useful, mainly on
unix systems without cairo support.

There are two important Design Principles:

    1) Follow the SVG graphics model. Make it more condensed without
       giving up any features. For instance, tkpath keeps only a -matrix
       option which comprises translate, scale etc. attributes

    2) Keep the actual path drawing code separate and independent of any
       canvas code. 

Open Issues:

There are a number of design choices that I'd like to discuss.

 o How to provide coordinates for prect? As the standard Tk way (x1,y1,x2,y2), 
   using sizes (x,y,width,height), or using options (x,y,-width,-height)?

 o What shall the precedence of the -style option compared to the individual
   options be?

Copyright (c) 2005-2008  Mats Bengtsson

BSD style license.