Adobe.com
Contents Suites Classes Class Index Member Index

AIMaskFlattener.h File Reference

#include "AITypes.h"
#include "AIArt.h"
#include "AIArtSet.h"
#include "AIPathStyle.h"
#include "AIHeaderBegin.h"
#include "AIHeaderEnd.h"

Go to the source code of this file.

Classes

struct  AIFlatteningOptions
 Options that control how flattening occurs. More...
struct  AIFlatteningInfoLinkedEPSObject
 Information on a linked EPS object created as a part of flattened artwork. More...
struct  AIFlatteningInfoPlacedArtObject
 Information on a placed art object created as a part of flattened artwork. More...
struct  AIFlatteningInfoSnippet
 An information packet sent to an AIFlatteningInfoReceiver. More...
struct  AIMaskFlattenerSuite
 This suite provides functions that allow you to flatten transparent artwork into an equivalent collection of opaque artwork. More...

Defines

#define kAIMaskFlattenerSuite   "AI Mask Flattener Suite"
#define kAIMaskFlattenerSuiteVersion5   AIAPI_VERSION(5)
#define kAIMaskFlattenerSuiteVersion   kAIMaskFlattenerSuiteVersion5
#define kAIMaskFlattenerVersion   kAIMaskFlattenerSuiteVersion
#define kAIFlattenDefaultResolution   (300.0f)
 Default resolution of raster images generated by art flattening, in DPI.
#define kAIFlattenMinResolution   (1.0f)
 Minimum resolution of raster images generated by art flattening, in DPI.
#define kAIFlattenMaxResolution   (9600.0f)
 Maximum resolution of raster images generated by art flattening, in DPI.
#define kAIFlattenMinBalance   0
 Minimum art-flattening balance.
#define kAIFlattenMaxBalance   100
 Maximum art-flattening balance.
#define kAIFlattenMaxSpots   27
 Maximum number of distinct spot colors that can appear in artwork to be flattened.
#define kAIFlattenHasLinkErr   'FLnk'
 Art to be flattened has linked mask.
#define kAIFlattenTooManySpotsErr   'FSpt'
 Art to be flattened has too many spot colors.

Typedefs

typedef AIErr(* AIFlatteningInfoReceiver )(void *receiverdata, AIFlatteningInfoSnippet *snippet)
 Prototype for a receiver of flattening information from AIMaskFlattenerSuite::CollectDocumentFlatteningInfo().

Enumerations

enum  AIFlatteningFlags {
  kAIFlattenDefault = 0, kAIFlattenOutlineText = 1 << 1, kAIFlattenOutlineStrokes = 1 << 2, kAIFlattenClipComplexRegions = 1 << 3,
  kAIFlattenPreserveOverprints = 1 << 4, kAIFlattenShowProgress = 1 << 7, kAIFlattenPreserveSimpleTransparency = 1 << 9, kAIFlattenPlanarizeOpaqueRegions = 1 << 10,
  kAIFlattenDontUndoChangesOnError = 1 << 11, kAIFlattenFOConversionFull = 1 << 12, kAIFlattenFOConversionSimplifyPaths = 1 << 13, kAIFlattenIntoKnockoutGroup = 1 << 14,
  kAIFlattenDisallowColorizedGray = 1 << 15, kAIFlattenDisallowNChannelIndexedImages = 1 << 16, kAIUsePathDPIToLimitPrecision = 1 << 17, kAIFlattenUseAntiAliasing = 1 << 18
}
 

Bit flags for AIFlatteningOptions::flags.

More...
enum  AIFlatteningQuality {
  kAIFlatteningQualityLevel0, kAIFlatteningQualityLevel1, kAIFlatteningQualityLevel2, kAIFlatteningQualityLevel3,
  kAIFlatteningQualityLevel4, kAIFlatteningQualityLevelCount
}
 

Obsolete.

More...
enum  AIFlatteningInfoType { kAIFlatteningInfoLinkedEPSObject, kAIFlatteningInfoPlacedArtObject }
 

The type of information collected with AIMaskFlattenerSuite::CollectDocumentFlatteningInfo() and sent to the AIFlatteningInfoReceiver.

More...

Detailed Description


Define Documentation

#define kAIFlattenDefaultResolution   (300.0f)

Default resolution of raster images generated by art flattening, in DPI.

#define kAIFlattenMaxBalance   100

Maximum art-flattening balance.

#define kAIFlattenMaxResolution   (9600.0f)

Maximum resolution of raster images generated by art flattening, in DPI.

#define kAIFlattenMaxSpots   27

Maximum number of distinct spot colors that can appear in artwork to be flattened.

#define kAIFlattenMinBalance   0

Minimum art-flattening balance.

#define kAIFlattenMinResolution   (1.0f)

Minimum resolution of raster images generated by art flattening, in DPI.

#define kAIMaskFlattenerSuite   "AI Mask Flattener Suite"
#define kAIMaskFlattenerSuiteVersion   kAIMaskFlattenerSuiteVersion5
#define kAIMaskFlattenerSuiteVersion5   AIAPI_VERSION(5)
#define kAIMaskFlattenerVersion   kAIMaskFlattenerSuiteVersion

Typedef Documentation

typedef AIErr(* AIFlatteningInfoReceiver)(void *receiverdata, AIFlatteningInfoSnippet *snippet)

Prototype for a receiver of flattening information from AIMaskFlattenerSuite::CollectDocumentFlatteningInfo().

Parameters:
receiverdata Developer defined data passed from AIMaskFlattenerSuite::CollectDocumentFlatteningInfo()
snippet The current snippet of flattening information.

Enumeration Type Documentation

Bit flags for AIFlatteningOptions::flags.

See AIMaskFlattenerSuite::FlattenArt().

Enumerator:
kAIFlattenDefault 
kAIFlattenOutlineText 

Output text outlines instead of native text.

kAIFlattenOutlineStrokes 

Convert stroke to fill even when object is not involved in transparency.

kAIFlattenClipComplexRegions 

For regions that contain high numbers of groups and objects, rasterize and clip to the art bounds (unless AIFlatteningOptions:balance is 100).

This speeds computation and simplifies the flattened output.

kAIFlattenPreserveOverprints 

Preserve overprint (rather than simulating it) in opaque regions.

kAIFlattenShowProgress 

Show a progress bar.

kAIFlattenPreserveSimpleTransparency 

Preserve simple transparency (flatten blend mode).

kAIFlattenPlanarizeOpaqueRegions 

Always use the planar map, even on opaque regions.

kAIFlattenDontUndoChangesOnError 

Do not call AIUndoSuite::UndoChanges() on error or cancel.

(For Live Effects, for example, that handle their own undo.)

kAIFlattenFOConversionFull 

Do not create foreign objects (art of type kForeignArt) to preserve things like spot colors.

May increase lossiness. See kAIFOConversionFull and AIFOConversionSuite.

kAIFlattenFOConversionSimplifyPaths 

Convert paths in the flattened output into non-self-intersecting paths.

See kAIFOConversionSimplifyPaths and AIFOConversionSuite

kAIFlattenIntoKnockoutGroup 

Flatten art into a knockout group.

kAIFlattenDisallowColorizedGray 

Disallow colorized grayscale images in the flattened output.

kAIFlattenDisallowNChannelIndexedImages 

Disallow NChannel/Separation/Indexed colorspace images in the flattened output.

kAIUsePathDPIToLimitPrecision 

Internal Use Only.

kAIFlattenUseAntiAliasing 

Use anti-aliasing when rasterizing during flattening.

The type of information collected with AIMaskFlattenerSuite::CollectDocumentFlatteningInfo() and sent to the AIFlatteningInfoReceiver.

A linked EPS is also a placed object, so the callback receives both types of snippets for each linked EPS, in no guaranteed order.

Enumerator:
kAIFlatteningInfoLinkedEPSObject 

Information on linked EPS objects in flattening output.

kAIFlatteningInfoPlacedArtObject 

Information on placed art objects in flattening output.

Obsolete.

Quality factors are now controlled by individual AIFlatteningOptions values.

Enumerator:
kAIFlatteningQualityLevel0 
kAIFlatteningQualityLevel1 
kAIFlatteningQualityLevel2 
kAIFlatteningQualityLevel3 
kAIFlatteningQualityLevel4 
kAIFlatteningQualityLevelCount 


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