AIArtConverterSuite Struct Reference
[API Suite List]

This suite allows you to convert art to paths or outlines. More...

#include <AIArtConverter.h>

List of all members.

Public Attributes
AIAPI AIErr(*	ArtConvertToPaths )(AIArtHandle *art)
	Converts artwork to a path, a compound path, or a group of paths and compound paths.
AIAPI AIErr(*	GetOutlineArt )(AIArtHandle art, ai::int16 paintOrder, AIArtHandle destination, ai::int32 options, AIArtHandle *outlineArt)
	Creates a new path or compound path that is an outline of the given artwork, and inserts it into the artwork tree at a given location.
AIAPI AIErr(*	ArtConvertToOutline )(AIArtHandle *art, ai::int32 options)
	Converts a given art object in place to a single path or compound path, disposing of the original art object.

---

Detailed Description

This suite allows you to convert art to paths or outlines.

See also:

AISymbolSuite::CopySymbolPatternOutline(), AISymbolSuite::InsertSymbolArtOutline(), AISymbolSuite::PeekCachedPatternOutline()

• Acquire this suite using SPBasicSuite::AcquireSuite() with the constants kAIArtConverterSuite and kAIArtConverterVersion.

---

Member Data Documentation

AIAPI AIErr(* AIArtConverterSuite::ArtConvertToOutline)(AIArtHandle *art, ai::int32 options)

Converts a given art object in place to a single path or compound path, disposing of the original art object.

Resulting single path or compound path will be placed at the same position in the art tree as of original art object. Some of the style is ignored (only the shape is important to the outline), but the art style of the result object is generally derived from that of the top element, possibly modified by stroke expansion, depending on the options. Use this method instead of GetOutlineArt when original art object needs to be replaced by outlined art object.

Parameters:

	art	The art object.
	convertToOutlineOptions	Option flags for conversion, a logical OR of these values kOutlineExpandAppearance kOutlineEliminateUnpainted kOutlineAddStrokes kOutlineSubtractStrokes kOutlineAlwaysIncludeFillArea kOutlineAlwaysStrokeStraightLines

AIAPI AIErr(* AIArtConverterSuite::ArtConvertToPaths)(AIArtHandle *art)

Converts artwork to a path, a compound path, or a group of paths and compound paths.

This function does not combine multiple paths.

Parameters:

art

The art object. This object is deleted, and the new object or objects are inserted into the art tree in its place.

AIAPI AIErr(* AIArtConverterSuite::GetOutlineArt)(AIArtHandle art, ai::int16 paintOrder, AIArtHandle destination, ai::int32 options, AIArtHandle *outlineArt)

Creates a new path or compound path that is an outline of the given artwork, and inserts it into the artwork tree at a given location.

Combines multiple paths into a single path or compound path. Some of the style is ignored (only the shape is important to the outline), but the art style of the result object is generally derived from that of the top element, possibly modified by stroke expansion, depending on the options.

Parameters:

	art	The art object.
	paintOrder	The paint order position, relative to the destination object, an AITypes::AIPaintOrder value.
	destination	The prepositional art object for the paint order.
	convertToOutlineOptions	Option flags for conversion, a logical OR of these values: kOutlineExpandAppearance kOutlineEliminateUnpainted kOutlineAddStrokes kOutlineSubtractStrokes kOutlineAlwaysIncludeFillArea kOutlineAlwaysStrokeStraightLines
	outlineArt	Optional, a buffer in which to return the new path art object.

---

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

• AIArtConverter.h