IllustratorSaveOptions

IllustratorSaveOptions

illustratorSaveOptions

Description

Options for saving a document as an Illustrator file, used with the Document.saveAs() method. All properties are optional.

---

Properties

IllustratorSaveOptions.artboardRange

illustratorSaveOptions.artboardRange

Description

If saveMultipleArtboards is true (which is valid only for Illustrator 13 or earlier), the document is considered for multi-asset extraction, which specifies an artboard range. An empty string extracts all artboards.

Default: empty String.

Type

String.

---

IllustratorSaveOptions.compatibility

illustratorSaveOptions.compatibility

Description

Specifies the version of Illustrator file format to create.

Default: Compatibility.ILLUSTRATOR19.

Type

Compatibility

---

IllustratorSaveOptions.compressed

illustratorSaveOptions.compressed

Note

This functionality was added in Illustrator version 10

Description

If true, the saved file is compressed.

Default: true.

Type

Boolean.

---

IllustratorSaveOptions.embedICCProfile

illustratorSaveOptions.embedICCProfile

Note

This functionality was added in Illustrator version 9

Description

If true, the document’s ICC profile is embedded in the saved file.

Default: false.

Type

Boolean.

---

IllustratorSaveOptions.embedLinkedFiles

illustratorSaveOptions.embedLinkedFiles

Note

This functionality was added in Illustrator version 7

Description

If true, the linked image files is embedded in the saved file.

Default: false.

Type

Boolean.

---

IllustratorSaveOptions.flattenOutput

illustratorSaveOptions.flattenOutput

Note

This functionality was added in Illustrator version 9

Description

How transparency should be flattened for older file format versions.

Default: OutputFlattening.PRESERVEAPPEARANCE.

Type

OutputFlattening

---

IllustratorSaveOptions.fontSubsetThreshold

illustratorSaveOptions.fontSubsetThreshold

Note

This functionality was added in Illustrator version 9

Description

Include a subset of fonts when less than this percentage of characters is used in the document.

Range: 0.0 to 100.0.

Default: 100.0.

Type

Number (double).

---

IllustratorSaveOptions.pdfCompatible

illustratorSaveOptions.pdfCompatible

Note

This functionality was added in Illustrator version 10

Description

If true, the file is saved as a PDF compatible file.

Default: true.

Type

Boolean.

---

IllustratorSaveOptions.saveMultipleArtboards

illustratorSaveOptions.saveMultipleArtboards

Description

If true, all artboards or range of the artboards are saved. Valid for Illustrator 13 or earlier.

Type

Boolean.

---

IllustratorSaveOptions.typename

illustratorSaveOptions.typename

Description

The class name of the referenced object.

Type

String; read-only.

---

Example

Saving with options

// Saves the current document to dest as an AI file with specified options,
// dest specifies the full path and file name of the new file

function exportFileToAI(dest) {
    if (app.documents.length > 0) {
        var ai8Doc = new File(dest);
        var saveOptions = new IllustratorSaveOptions();
        saveOptions.compatibility = Compatibility.ILLUSTRATOR8;
        saveOptions.flattenOutput = OutputFlattening.PRESERVEAPPEARANCE;

        app.activeDocument.saveAs(ai8Doc, saveOptions);
    }
}