pathlength plugin for Adobe Illustrator

Copyright (C) Toby Thain 1995-2005 <toby@telegraphics.com.au>
http://www.telegraphics.com.au/


ABOUT THIS PACKAGE
------------------
Pathlength measures the length of selected paths (including Bezier curve segments) 
and shows it in points, millimetres & inches.

The source code is provided as an example of an Illustrator plugin
which is not only cross-platform (Windows/Mac) but can also be built
using multiple development systems (MPW, CodeWarrior and MinGW).

MPW can be freely downloaded from http://developer.apple.com/tools/mpw-tools/
For more information on CodeWarrior, see http://www.metrowerks.com/
MinGW is a GNU toolchain for building Win32 programs, see http://www.mingw.org/


GETTING STARTED
---------------
Obtain and unpack the Illustrator SDK v7.0 (this may be found on the Illustrator 7.0
application CD). Unfortunately this SDK is no longer found on Adobe's web site,
however the version 9.0 SDK may work (see
http://partners.adobe.com/asn/developer/gapsdk/IllustratorSDK.html )

Move the SDK into your build directory, which should then contain 3 folders like this
(or four, if you want to use the v10 SDK and build the plugin for Illustrator 10):

[unpacked v7.0 SDK:]
	Illustrator70.SDK
		 read me
		AIPluginAPI
		Documentation
		Sample Code

[unpacked v10.0 SDK (optional):]
	Adobe Illustrator 10 SDK
		Documentation
		IllustratorAPI
		README.TXT
		SampleCode

	common          ( checked out from Svn @ http://www.telegraphics.com.au/svn/common/trunk )
		...source files...
		
	pathlength-src  (unpacked from pathlength distribution,
                     or checked out from Svn @ http://www.telegraphics.com.au/svn/pathlength/trunk )
		cwpro1
			pathlength.mcp
			...
		cwpro7
			pathlength.mcp
			...
		Makefile         (for MinGW)
		pathlength.make  (for MPW)
		...source files...


BUILDING WITH MPW
-----------------
A makefile is provided which can build the plugin for:
- Illustrator 7.0-9.0 (fat Mac 68K & PowerPC)
- Illustrator 10.0 (Mac PowerPC)

1. Change the current directory to "pathlength-src"
by executing the following command (substitute the correct <path>):
	Directory <path>
(press the [enter] key at the end of the line to execute a command)
	
(If you open one of the source files in that directory to
launch MPW Shell, the current directory is set automatically.)

2. Then execute:
	BuildProgram pathlength
(or type command-B then "pathlength" as program name)

This will compile, link and resource-compile the plug-in for both
PowerPC and 68K targets, combined in a file "pathlength-ai7-fat".
With ingenuity it is possible to build separate plugins targeted to
PowerPC or 68K.

Building for Illustrator 10.0:

Switches are provided in "pathlength.make" to use the Illustrator v10.0 SDK
and PowerPC structure alignment (see the notes on the Adobe SDK page above).
You will also need to install the CarbonLib SDK, available from the Apple
Developer site, http://developer.apple.com/sdk/


BUILDING WITH CW PRO 7
----------------------
Targets are provided for:
- "pathlength-ai7.win": Illustrator 7.0-?? (Windows x86 DLL)
- "pathlength-ai7.ppc": Illustrator 7.0-9.0 (Mac PowerPC)
- "pathlength-ai10.ppc": Illustrator 10.0 (Mac PowerPC)


BUILDING WITH CW PRO 1
----------------------
Targets are provided for:
- "pathlength-ai7.win": Illustrator 7.0-?? (Windows x86 DLL)
- "pathlength-ai7.68k": Illustrator 7.0-?? (Mac 68K)
- "pathlength-ai7.ppc": Illustrator 7.0-9.0 (Mac PowerPC)


BUILDING WITH MINGW (Linux, OS X, or other UNIX)
-------------------
Install MinGW and ensure its executables can be found on your PATH.
To build:

	make dll
	
This builds the Win32 plugins (DLLs):
- pathlength-ai7.aip  (using AI7 SDK - fixed point numbers)
- pathlength-ai10.aip (using AI10 SDK - floating point numbers).