AIExpandSuite Struct Reference
[API Suite List]

This suite provides a single function that expands an art object into a set of objects with equivalent appearance. More...

#include <AIExpand.h>

List of all members.

Public Attributes
AIAPI AIErr(*	Expand )(AIArtHandle art, ai::int32 flags, ai::int32 steps)
	Breaks artwork up into individual parts, creating a set of objects with equivalent appearance.

---

Detailed Description

This suite provides a single function that expands an art object into a set of objects with equivalent appearance.

For backward compatibility, an older version is provided in AI70ExpandSuite.

• Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kAIExpandSuite and kAIExpandSuiteVersion.

---

Member Data Documentation

AIAPI AIErr(* AIExpandSuite::Expand)(AIArtHandle art, ai::int32 flags, ai::int32 steps)

Breaks artwork up into individual parts, creating a set of objects with equivalent appearance.

It is the same as choosing Expand from the Object menu.

• For path art with a fill of CMYK or RGB color, has no effect.
• For artwork filled with a gradient, breaks the artwork up into steps number of objects between each of the gradients stops. The resulting artwork contains a mask.
• For text art, turns the text into outlines.
• For stroked objects, outlines the stroke and creates a closed path. This is especially useful for art objects created using brushes.
• For objects filled with a pattern, draws the entire pattern tile on the page with the original object acting as a mask.

Parameters:

	art	The art object.
	flags	Options that control how the expansion is done. A logical OR of AIExpandFlagValue values.
	steps	For artwork filled with a gradient, the number of objects to create between gradient stops. For example an artwork with four stops and a steps value of 2 results in an artwork that has two steps between each of the four stops.

---

The documentation for this struct was generated from the following file:

• AIExpand.h