Adobe Illustrator CS5 Software Development Kit ReadMe File ______________________________________________________________________ This file contains the latest information about the Adobe Illustrator SDK. This information applies to Adobe Illustrator CS5 (15.0). The SDK enables you to develop software modules that plug into and extend the functionality of Adobe Illustrator CS5. ______________________________________________________________________ This file has the following sections: 1. Legal 2. SDK Documentation Overview 3. Development Environments 4. Installing the SDK 5. What's New 6. Known Issues 7. SDK Support and Adobe Partner Programs *********************************************************** 1. Legal *********************************************************** You may use this SDK only in a manner consistent with the included End User License Agreement: /legalnotices/EULAs.pdf *********************************************************** 2. SDK Documentation Overview *********************************************************** Adobe Illustrator CS5 Getting Started Guide: File: /docs/guides/getting-started-guide.pdf Describes the basics of how to get started developing plug-ins for Illustrator CS5 and provides descriptions of the sample plug-ins provided with this SDK. Adobe Illustrator CS5 Porting Guide: File: /docs/guides/porting-guide.pdf Describes how to set up your development environment and port existing code to Illustrator CS5. Details changes in the public API and other aspects of the SDK since the prior release. Adobe Illustrator CS5 Programmer's Guide: File: /docs/guides/programmers-guide.pdf Describes the fundamentals of writing plug-ins for Illustrator. Using the Adobe Text Engine: File: /docs/guides/using-adobe-text-engine.pdf Describes the components of the Illustrator Adobe Text Engine API, and provides recipes for creating, editing, deleting, styling and iterating text items in a document, with references to sample code and the Adobe Illustrator API Reference. Adobe Dialog Manager Programmer's Guide: File: /docs/guides/adm-guide.pdf Describes the concepts involved in programming the cross-platform user-interface toolkit used in Illustrator. *** ADM is deprecated in this release, and will be removed from future releases. Plug-ins that use it will still run in Illustrator CS5, but must be ported to some other UI framework to run in future releases. Adobe Illustrator API Reference: Reference documentation for the API is provided in two formats: File: /docs/references/index.chm API reference in compiled HTML format, a searchable help file To view the contents in Windows, double-click the index.chm file icon in Windows Explorer, to open the home page. To view the contents in Mac OS, you need a CMH viewer; for options, see "Adobe Illustrator CS5 Porting Guide". File: /docs/references/sdkdocs.tar.gz API reference in archive HTML format. After installing the SDK, double-click the sdkdocs.tar.gz file to decompress the archive. View the HTML documentation in your browser. API Advisor: File: /docs/references/apiadvisor-ai14-vs-ai15.html Reports class, struct, and file differences between the API included with the Illustrator CS4 SDK and this SDK. *********************************************************** 3. Development Environments *********************************************************** The following platforms are supported for the development of plug-ins for Illustrator CS5: Macintosh: OS: Mac OS 10.5 IDE: Xcode 3.1.1 Windows: OS: Microsoft Windows XP with service pack 2 IDE: Microsoft Visual C++ 9 (Visual Studio 2008 SP1) For more details, see "Adobe Illustrator CS5 Porting Guide." *********************************************************** 4. Installing the SDK *********************************************************** To install the SDK, download the pre-configured archive for your platform from the Adobe Illustrator Developers site: http://www.adobe.com/devnet/illustrator/ Start by expanding the archive, then follow the detailed instructions in "Adobe Illustrator CS5 Getting Started Guide" to set up your development platform. *********************************************************** 5. What's New *********************************************************** - New features: See details in "Adobe Illustrator CS5 Porting Guide". - API changes: For complete details of API changes, see "Adobe Illustrator CS5 Porting Guide" and "API Advisor" - ADM deprecated: Plug-ins that use it will still run in Illustrator CS5, but must be ported to some other UI framework to run in future releases. - Sample code changes: - SnippetRunner Code Snippets: To demonstrate new features, a new code snippet, SnpSymbolHelper, has been added to the SnippetRunner project, and the code snippet SnpArtboardHelper has been modified. - C++ framework is required when developing Illustrator CS5 plug-ins. The legacy shell framework is no longer supported. The Shell sample plug-in has been removed. - The ADMNonModalDialog sample plug-in has been removed. - A new sample plug-in, StrokeFilter, demonstrates the usage of new stroking functionality using the API provided by the new AIBeautifulStrokesSuite. This sample uses a Flash-based UI, which is a possible alternative for ADM in the SDK samples. For details, see "Creating a Flash UI for Plug-ins" in "Adobe Illustrator CS5 Programmer's Guide". - The MultiArrowTool sample plug-in has been enhanced to demonstrate how to display an annotation while drawing a path by dragging the cursor. - A new sample plug-in, FreeGrid, demonstrates the usage of new Perspective Grid functionality using the API methods provided by the new AIPerspectiveGridSuite and AIPerspectiveTransformSuite. This sample uses a Flash-based UI, which is a possible alternative for ADM in the SDK samples. For details, see "Creating a Flash UI for Plug-ins" in "Adobe Illustrator CS5 Programmer's Guide". *********************************************************** 6. Known Issues *********************************************************** The following are known issues in this SDK. These issues will be addressed in forthcoming SDKs: ______________________________________________________________________ * If you installed security update 896358 or Microsoft Windows Server 2003 Service Pack 1 (SP1), you may experience broken links and missing text while viewing the /docs/references/index.chm file. Use one of these workarounds: Method 1 -------- 1. Double-click the index.chm file. 2. In the "Open File-Security Warning" dialog box, clear the "Always ask before opening this file" check box. 3. Click Open. Method 2 -------- 1. Right-click the index.chm file, then click Properties. 2. Click Unblock. 3. Double-click the index.chm file to open the file. For details, see http://support.microsoft.com/kb/902225. ______________________________________________________________________ *********************************************************** 7. SDK Support and Adobe Partner Programs *********************************************************** If you require SDK support for the Illustrator CS5 SDK, you may purchase single or multi-pack SDK support cases. Information on purchasing SDK support cases can be found at: http://partners.adobe.com/public/developer/support/index.html Information on Adobe support, in general, may be found at: http://www.adobe.com/support/programs/ If you are a partner who extends, markets, or sells Adobe products or solutions, you should consider membership in the Adobe Partner Connection Solution Partner Program. The Solution Partner Program provides development support, access to timely product information, as well as various marketing benefits. To learn more about the program, point your browser to: http://go.adobe.com/kb/cs_cpsid_50036_en-us _____________________________________________________________________________ Copyright 2010 Adobe Systems Incorporated. All rights reserved. Adobe and Illustrator are registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Windows is a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. Macintosh is a trademark of Apple Computer, Incorporated, registered in the United States and other countries. All other brand and product names are trademarks or registered trademarks of their respective holders. _____________________________________________________________________________