"tooldemo", a Tool plugin for Adobe Illustrator
Copyright (C) 2002-3 Toby Thain, toby@telegraphics.com.au

http://www.telegraphics.com.au/


ABOUT THIS PACKAGE
------------------
Tooldemo is an Adobe Illustrator tool plugin, a simple demonstration
which creates a logarithmic graph with basic text labels etc.

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 or mingw32).

MPW can be freely downloaded from http://developer.apple.com/tools/mpw-tools/
For more information on CodeWarrior, see http://www.metrowerks.com/
Mingw32 is a free GNU-based toolset for building Win32 executables, hosted
under Linux, UNIX or Windows (for more information, 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

[unpacked from tooldemo distribution]
	tooldemo
		cwpro1
			tooldemo.mcp
			...
		cwpro7
			tooldemo.mcp
			...
		tooldemo.make
		...source files...


BUILDING WITH MPW
-----------------
A makefile is provided which can build the plugin for
Illustrator 7.0-10.0 (Mac PowerPC).

1. Change the current directory to "tooldemo"
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 tooldemo
(or type command-B then "tooldemo" as program name)

Building for Illustrator 10.0:

Switches are provided in "tooldemo.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 1.5 SDK, available from the Apple
Developer site, http://developer.apple.com/sdk/

MPW cannot build a 68K version of this plugin without modification; as written,
Tooldemo uses global variables and the stdio library (which also uses globals).
(Unlike CodeWarrior, MPW does not support building code resources
which indexes globals from a register other than A5, which is required
due to frequent callbacks to the host application.)


BUILDING WITH CW PRO 7
----------------------
Targets are provided for:
- Illustrator 7.0-?? (Windows x86 DLL)
- Illustrator 7.0-9.0 (Mac PowerPC)
- Illustrator 10.0 (Mac PowerPC)


BUILDING WITH CW PRO 1
----------------------
Targets are provided for:
- Illustrator 7.0-?? (Windows x86 DLL)
- Illustrator 7.0-?? (Mac 68K)
- Illustrator 7.0-9.0 (Mac PowerPC)


BUILDING WITH MINGW32
---------------------
Win mingw32 installed (see http://www.mingw.org/), run:
	make
to build a Win32 DLL.