Skip to content

PrintFlattenerOptions

new PrintFlattenerOptions()

Contains flattening options for use when Illustrator outputs artwork that contains transparency into a non-native format.


printFlattenerOptions.clipComplexRegions

If true, complex regions should be clipped.

Default: false

Boolean


PrintFlattenerOptions.convertStrokesToOutlines

Section titled “PrintFlattenerOptions.convertStrokesToOutlines”

printFlattenerOptions.convertStrokesToOutlines

If true, convert all strokes to outlines.

Default: false

Boolean


PrintFlattenerOptions.convertTextToOutlines

Section titled “PrintFlattenerOptions.convertTextToOutlines”

printFlattenerOptions.convertTextToOutlines

If true, all text is converted to vector paths; preserves the visual appearance of type.

Default: false

Boolean


printFlattenerOptions.flatteningBalance

The flattening balance.

Range: 0.0 to 100.0.

Default: 100.0

Number (long)


printFlattenerOptions.gradientResolution

The gradient resolution in dots per inch (dpi).

Range: 1.0 to 9600.0.

Default: 300.0

Number (double)


printFlattenerOptions.overprint

Whether to preserve, discard, or simulate overprinting.

Default: PDFOverprint.PRESERVEPDFOVERPRINT

PDFOverprint


PrintFlattenerOptions.rasterizationResolution

Section titled “PrintFlattenerOptions.rasterizationResolution”

printFlattenerOptions.rasterizationResolution

The rasterization resolution in dots per inch (dpi).

Range: 1.0 to 9600.0.

Default: 300.0

Number (double)


printFlattenerOptions.typename

The class name of the object.

String; read-only.


// Creates a new document, adds symbols to the document
// then prints with a range of flattener balance settings
var docRef = documents.add();
var y = docRef.height - 30;
for (var i = 0; i < (docRef.symbols.length); i++) {
symbolRef = docRef.symbols[i];
symbolItemRef1 = docRef.symbolItems.add(symbolRef);
symbolItemRef1.top = y;
symbolItemRef1.left = 100;
y -= (symbolItemRef1.height + 10);
}
redraw();
// Create PrintFlattenerOptions object and assign to a PrintOptions object
var flatOpts = new PrintFlattenerOptions();
var printOpts = new PrintOptions();
printOpts.flattenerOptions = flatOpts;
// Set other print options
printOpts.ClipComplexRegions = true;
printOpts.GradientResoultion = 360;
printOpts.RasterizatonResotion = 360;
// Print the current document with flattening balance increments of 20
for (var i = 0; i <= 100; i += 20) {
flatOpts.flatteningBalance = i;
activeDocument.print(printOpts);
}