AIExpand.h File Reference

#include "AIArt.h"

Go to the source code of this file.

Classes
struct	AI70ExpandSuite
	This suite provides a legacy version of a single function that expands an art object into a set of objects with equivalent appearance. More...
struct	AIExpandSuite
	This suite provides a single function that expands an art object into a set of objects with equivalent appearance. More...
Defines
#define	kAIExpandSuite   "AI Expand Suite"
#define	kAI70ExpandSuite   kAIExpandSuite
#define	kAIExpandSuiteVersion4   AIAPI_VERSION(4)
#define	kAI70ExpandSuiteVersion   AIAPI_VERSION(1)
#define	kAIExpandSuiteVersion   kAIExpandSuiteVersion4
#define	kAIExpandVersion   kAIExpandSuiteVersion
Enumerations
enum	AIExpandFlagValue {   kExpandPluginArt = 0x0001, kExpandText = 0x0002, kExpandStroke = 0x0004, kExpandPattern = 0x0008,   kExpandGradientToMesh = 0x0010, kExpandGradientToPaths = 0x0020, kExpandSymbolInstances = 0x0040, kExpandChartArt = 0x0080,   kExpandRepeatArt = 0x0100, kExpandOneAtATime = 0x4000, kExpandShowProgress = 0x8000, kExpandLockedObjects = 0x10000 }
	Flag values for what should be expanded and how the operation is performed. More...

---

Detailed Description

---

Define Documentation

#define kAI70ExpandSuite   kAIExpandSuite

#define kAI70ExpandSuiteVersion   AIAPI_VERSION(1)

#define kAIExpandSuite   "AI Expand Suite"

#define kAIExpandSuiteVersion   kAIExpandSuiteVersion4

#define kAIExpandSuiteVersion4   AIAPI_VERSION(4)

#define kAIExpandVersion   kAIExpandSuiteVersion

---

Enumeration Type Documentation

enum AIExpandFlagValue

Flag values for what should be expanded and how the operation is performed.

The order of priority for expansion is as follows:

	#kExpandPluginArt
	#kExpandSymbolInstances
	#kExpandText
	

If any of these flags causes an expansion, the operation stops there. For example, if you call AIExpandSuite::Expand() on a text object inside a symbol instance, with options kExpandSymbolInstances and kExpandText set, the symbol is expanded, but the text object is not.

Otherwise, the expansion continues with the following priority:

	#kExpandStroke
	#kExpandPattern
	#kExpandGradientToMesh
	#kExpandGradientToPaths
	

These expansions can all occur in one call, unless kExpandOneAtATime is set. In this case, the expansion operation stops as soon as any expansion occurs.

Enumerator:

kExpandPluginArt	Expand plug-in art.
kExpandText	Expand text.
kExpandStroke	Expand strokes.
kExpandPattern	Expand patterns.
kExpandGradientToMesh	Expand gradient as a mesh.
kExpandGradientToPaths	Expand gradient as a path.
kExpandSymbolInstances	Expand symbols.
kExpandChartArt	Expand charts.
kExpandRepeatArt	Expand repeats.
kExpandOneAtATime	Stop the expansion operation after the first expansion occurs.
kExpandShowProgress	Show a progress bar during the operation.
kExpandLockedObjects	Expand locked objects (such as those on a locked layer). By default, modifications are not made on objects in locked layers.