InDesign2026
API 21.5.1.73
Object

FlattenerPreference

Transparency flattener preferences.

Preference FlattenerPreference
Hierarchy

Spread

FlattenerPreference

Properties

NameType AccessDescription
Boolean read/write If true, ensures that the boundaries between vector and rasterized artwork fall along object paths.
Boolean read/write If true, converts all strokes to outlines and ensures that stroke widths remain constant during flattening. Note: Can cause thin strokes to appear slightly thicker than their original width. Affects all strokes, not only strokes involved in the transparency.
Boolean read/write If true, converts all text to outlines and discards all type glyph information on spreads with transparency; ensures that the width of text strokes remains constant during flattening. Note: Can cause small fonts to appear slightly thicker when viewed in Acrobat or printed on low-quality desktop printers, but does not affect type quality when printed on high-resolution printers or imagesetters.
EventListeners<EventListener> readonly A collection of event listeners.
Events<Event> readonly A collection of events.
Number 0–1200 read/write The resolution for gradients rasterized as a result of flattening and for drop shadow and feathers when printed or exported. (Range: 0 to 1200) Note: Resolutions higher than 300 ppi increase file size and printing time but generally do not improve the image quality.
Boolean readonly Returns true if the object specifier resolves to valid objects.
Number 1–9600 read/write The resolution for vector objects rasterized as a result of flattening. (Range: 1 to 9600) For information, see raster vector balance.
Spread readonly The parent of the FlattenerPreference (a Spread).
Object read/write A property that allows setting of several properties at the same time.
FlattenerLevel | Real(0-100)
read/write The amount of vector artwork to rasterize during flattening, specified as an enumerator or as a percentage in the range 0 to 100. Can return: FlattenerLevel enumerator or Real (0 - 100).

Methods

EventListener

Adds an event listener.

eventType String The event type.
handler File | JavaScriptFunction The event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
FlattenerPreference[]

Resolves the object specifier, creating an array of object references.

Boolean

Removes the event listener.

eventType String The registered event type.
handler File | JavaScriptFunction The registered event handler. Can accept: File or JavaScript Function.
captures? Boolean This parameter is obsolete.
String

Generates a string which, if executed, will return the FlattenerPreference.

String

Retrieves the object specifier.

Object of 4

Properties elsewhere that hold a FlattenerPreference.

Return 1

Methods that return a FlattenerPreference.