Adobe.com
Contents Suites Classes Class Index Member Index

AIArtConverter.h File Reference

#include "AIArt.h"
#include "AIHeaderBegin.h"
#include "AIHeaderEnd.h"

Go to the source code of this file.

Classes

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

Defines

#define kAIArtConverterSuite   "AI Art Converter Suite"
#define kAIArtConverterSuiteVersion3   AIAPI_VERSION(3)
#define kAIArtConverterSuiteVersion   kAIArtConverterSuiteVersion3
#define kAIArtConverterVersion   kAIArtConverterSuiteVersion
#define kOutlineExpandStrokes   (kOutlineAddStrokes|kOutlineSubtractStrokes)
 How strokes are expanded while creating outlines; see kOutlineAlwaysIncludeFillArea.

Enumerations

enum  {
  kOutlineExpandAppearance = 0x0001, kOutlineEliminateUnpainted = 0x0002, kOutlineAddStrokes = 0x0004, kOutlineSubtractStrokes = 0x0008,
  kOutlineAlwaysIncludeFillArea = 0x0010, kOutlineAlwaysStrokeStraightLines = 0x0020
}
 

Option bit flags that control how the "footprint" of a path is treated when converting to outlines.

More...

Define Documentation

#define kAIArtConverterSuite   "AI Art Converter Suite"
#define kAIArtConverterSuiteVersion   kAIArtConverterSuiteVersion3
#define kAIArtConverterSuiteVersion3   AIAPI_VERSION(3)
#define kAIArtConverterVersion   kAIArtConverterSuiteVersion
#define kOutlineExpandStrokes   (kOutlineAddStrokes|kOutlineSubtractStrokes)

How strokes are expanded while creating outlines; see kOutlineAlwaysIncludeFillArea.


Enumeration Type Documentation

anonymous enum

Option bit flags that control how the "footprint" of a path is treated when converting to outlines.

See AIArtConverterSuite, AISymbolSuite.

Enumerator:
kOutlineExpandAppearance 

Expands source art before converting to outlines.

kOutlineEliminateUnpainted 

Strips paths with no fill and no stroke before converting to outlines.

kOutlineAddStrokes 

Adds strokes when converting to outlines; see kOutlineAlwaysIncludeFillArea.

kOutlineSubtractStrokes 

Subtracts strokes when converting to outlines; see kOutlineAlwaysIncludeFillArea.

kOutlineAlwaysIncludeFillArea 

Controls how the inner fillable area of unfilled but stroked paths is combined with the stroke area, if either kOutlineAddStrokes or kOutlineSubtractStrokes is set.

For example, assume an original path of a closed figure that contains another closed figure, which in turn contains another closed figure, with no fill and wide stroke:

		+-------+
 		|+-----+|
 		||+---+||
 		|||   |||
 		||+---+||
 		|+-----+|
 		+-------+
 		

With kOutlineAlwaysIncludeFillArea set, but both stroke flags off, stroke is ignored and the outline is that of the fillable area:

 		 +-----+
 		 |     |
 		 |     |
 		 |     |
 		 +-----+
 		

kOutlineAddStrokes only creates a filled compound path with a hole in the middle:

		+-------+
 		|       |
 		| +---+ |
 		| |   | |
 		| +---+ |
 		|       |
 		+-------+
  		

With both kOutlineAddStrokes and kOutlineAlwaysIncludeFillArea set, the fill area is added to the stroke area:

		+-------+
 		|       |
 		|       |
 		|       |
 		|       |
 		|       |
 		+-------+
  		

With both kOutlineSubtractStrokes and kOutlineAlwaysIncludeFillArea set, the fill area is added, and the stroke area is subtracted:

 		  +---+
 		  |   |
 		  +---+
  		

This can be used to get the inner region of a path, the part that would show in the fill color if it were filled.

With kOutlineSubtractStrokes only, the inner-area path is created on paths that are both filled and stroked, but paths that are stroked only are either stripped (if kOutlineEliminateUnpainted is on) or left alone (if it is off).

kOutlineAlwaysStrokeStraightLines 

If input art includes straight lines (which have no area and would be excluded by Pathfinder even if they have a fill), they are given a hair-line stroke so that they will be included in the union.

Use only when kOutlineAddStrokes is set.

The addition of a stroke happens after the test for unpainted paths, so if kOutlineEliminateUnpainted is set, it happens only to straight line segments that have a fill but no stroke and does not prevent the elimination of completely unpainted line segments. If kOutlineEliminateUnpainted is off, it also happens to unpainted straight line segments.



Contents Suites Classes Class Index Member Index
Adobe Solutions Network
 
Copyright © 2016 Adobe Systems Incorporated. All rights reserved.
Terms of Use Online Privacy Policy Adobe and accessibility Avoid software piracy Permissions and Trademarks