What's New in Illustrator Scripting CC2021 (v25.1 January release)

[CarlosCanto]

save to cloud and the new repeat functions were added to this release, enjoy!

CC2021_v25.1
Application Class
	New Method
	Application.openCloudDocument (cloudPath: string) : Document
	Adobe Illustrator 25 Type Library
	Open the specified cloud document.
	cloudPath: Data Type: string
	Path of the document to be opened from cloud.
Document Class	New Property
	Document.isCloudDocument  (Read Only)
	Data Type: Boolean
	Adobe Illustrator 25 Type Library
	Is the document saved on cloud.
	New Method
	Document.saveToCloud (cloudPath: string )
	Adobe Illustrator 25 Type Library
	Save the document to cloud at the specified path.
	cloudPath: Data Type: string
	Path of the document to be saved on cloud.
Document, Layer, Group: New Collections
GridRepeatItems
Adobe Illustrator 25 Type Library
A collection of grid repeat items.
	Properties (same as other objects)
	length
	parent
	typename
	Methods
	GridRepeatItems.add (sourceArt:any, config: GridRepeatConfig) : GridRepeatItem
	Adobe Illustrator 25 Type Library
	Creates a grid repeat art.
	sourceArt: Data Type: any
	The page item(s) to apply to.
	config: Data Type: GridRepeatConfig
	The grid repeat configuration.
	More Methods (same as other objects)
	getByName(name)
	removeAll()
RadialRepeatItems
Adobe Illustrator 25 Type Library
A collection of radial repeat items.
	Properties (same as other objects)
	length
	parent
	typename
	Methods
	RadialRepeatItems.add (sourceArt:any, config: RadialRepeatConfig) : RadialRepeatItem
	Adobe Illustrator 25 Type Library
	Creates a radial repeat art.
	sourceArt: Data Type: any
	The page item(s) to apply to.
	config: Data Type: RadialRepeatConfig
	The radial repeat configuration.
	More Methods (same as other objects)
	getByName(name)
	removeAll()
SymmetryRepeatItems
Adobe Illustrator 25 Type Library
A collection of symmetry repeat items.
	Properties (same as other objects)
	length
	parent
	typename
	Methods
	SymmetryRepeatItems.add (sourceArt:any, config: SymmetryRepeatConfig) : SymmetryRepeatItem
	Adobe Illustrator 25 Type Library
	Creates a symmetry repeat art.
	sourceArt: Data Type: any
	The page item(s) to apply to.
	config: Data Type: SymmetryRepeatConfig
	The symmetry repeat configuration.
	More Methods (same as other objects)
	getByName(name)
	removeAll()
Document, Layer, Group: New Classes
GridRepeatItem
Base Class: PageItem
Adobe Illustrator 25 Type Library
A grid repeat item.
	Properties
	GridRepeatItem.gridConfig  (Read Only)
	Data Type: GridRepeatConfig
	Adobe Illustrator 25 Type Library
	Grid repeat config for repeat art.
	parent, typename (same as other objects)
	Methods
	GridRepeatItem.setGridConfiguration (config: GridRepeatConfig , state: GridRepeatUpdate )
	Adobe Illustrator 25 Type Library
	Update the grid repeat art.
	config: Data Type: GridRepeatConfig
	Updated grid repeat configuration.
	state: Data Type: GridRepeatUpdate
	Specify which properties of grid repeat gets updated.
	duplicate(), move(), remove(), removeAll() (same as other objects)
RadialRepeatItem
Base Class: PageItem
Adobe Illustrator 25 Type Library
A radial repeat item.
	Properties
	RadialRepeatItem.radialConfig  (Read Only)
	Data Type: RadialRepeatConfig
	Adobe Illustrator 25 Type Library
	Radial repeat config for repeat art.
	parent, typename (same as other objects)
	Methods
	RadialRepeatItem.setRadialConfiguration (config: RadialRepeatConfig , state: RadialRepeatUpdate )
	Adobe Illustrator 25 Type Library
	Update the radial repeat art.
	config: Data Type: RadialRepeatConfig
	Updated radial repeat configuration.
	state: Data Type: RadialRepeatUpdate
	Specify which properties of radial repeat gets updated.
	duplicate(), move(), remove(), removeAll() (same as other objects)
SymmetryRepeatItem
Base Class: PageItem
Adobe Illustrator 25 Type Library
A symmetry repeat item.
	Properties
	SymmetryRepeatItem.symmetryConfig  (Read Only)
	Data Type: SymmetryRepeatConfig
	Adobe Illustrator 25 Type Library
	Symmetry repeat config for repeat art.
	parent, typename (same as other objects)
	Methods
	SymmetryRepeatItem.setSymmetryConfiguration (config: SymmetryRepeatConfig , state: SymmetryRepeatUpdate )
	Adobe Illustrator 25 Type Library
	Update the symmetry repeat art.
	config: Data Type: SymmetryRepeatConfig
	Updated symmetry repeat configuration.
	state: Data Type: SymmetryRepeatUpdate
	Specify which properties of symmetry repeat gets updated.
	duplicate(), move(), remove(), removeAll() (same as other objects)
Repeat Config Classes
GridRepeatConfig
Adobe Illustrator 25 Type Library
Options for grid repaat art configuration.
	Properties
	GridRepeatConfig.columnFlipType
	Data Type: RepeatGridShiftFlipType , Default Value: RepeatGridShiftFlipType.NOSF
	Adobe Illustrator 25 Type Library
	Column flip type of grid repeat art.
	GridRepeatConfig.horizontalSpacing
	Data Type: number , Default Value: 10
	Adobe Illustrator 25 Type Library
	Spacing between each rows.
	GridRepeatConfig.patternType
	Data Type: RepeatGridShiftFlipType , Default Value: RepeatGridShiftFlipType.NOSF
	Adobe Illustrator 25 Type Library
	Shift type of grid repeat art.
	GridRepeatConfig.rowFlipType
	Data Type: RepeatGridShiftFlipType , Default Value: RepeatGridShiftFlipType.NOSF
	Adobe Illustrator 25 Type Library
	Row flip type of grid repeat art.
	GridRepeatConfig.verticalSpacing
	Data Type: number , Default Value: 10
	Adobe Illustrator 25 Type Library
	Spacing between each columns.
RadialRepeatConfig
Adobe Illustrator 25 Type Library
Options for radial repaat art configuration.
	Properties
	RadialRepeatConfig.numberOfInstances
	Data Type: Int32 , Default Value: 8
	Adobe Illustrator 25 Type Library
	Number of instances of radial repeat art.
	RadialRepeatConfig.radius
	Data Type: number , Default Value: -1
	Adobe Illustrator 25 Type Library
	Radius of radial repeat art.
	RadialRepeatConfig.reverseOverlap
	Data Type: Boolean , Default Value: false
	Adobe Illustrator 25 Type Library
	Reverse overlap of radial repeat art.
SymmetryRepeatConfig
Adobe Illustrator 25 Type Library
Options for symmetry repaat art configuration.
	Properties
	SymmetryRepeatConfig.axisRotationAngleInRadians
	Data Type: number , Default Value: 1.57
	Adobe Illustrator 25 Type Library
	Symmetry axis rotation angle wrt x-axis in anti-clockwise fashion.
New Enumerations
RepeatGridShiftFlipType
Adobe Illustrator 25 Type Library
Grid Repeat shift and flip type.
	RepeatGridShiftFlipType.HORIZONTALANDVERTICALSF  (Read Only)
	Data Type: int, Value: 3
	Adobe Illustrator 25 Type Library
	Create a grid after shifting both alternate rows and columns by half or flip the alternate rows about both x and y axis.
	RepeatGridShiftFlipType.HORIZONTALSF  (Read Only)
	Data Type: int, Value: 1
	Adobe Illustrator 25 Type Library
	Create a grid after shifting alternate rows by half or flip the alternate rows about y axis.
	RepeatGridShiftFlipType.NOSF  (Read Only)
	Data Type: int, Value: 0
	Adobe Illustrator 25 Type Library
	Create a normal grid of arts.
	RepeatGridShiftFlipType.VERTICALSF  (Read Only)
	Data Type: int, Value: 2
	Adobe Illustrator 25 Type Library
	Create a grid after shifting alternate columns by half or flip the alternate rows about x axis.
RadialRepeatUpdate
Adobe Illustrator 25 Type Library
Each flag represent which property of radial repeat gets updated.
	RadialRepeatUpdate.NUMBEROFINSTANCES  (Read Only)
	Data Type: int, Value: 32
	Adobe Illustrator 25 Type Library
	Update number of instances of radial repeat art.
	RadialRepeatUpdate.RADIALALL  (Read Only)
	Data Type: int, Value: 127
	Adobe Illustrator 25 Type Library
	Update all the properties of radial repeat art.
	RadialRepeatUpdate.RADIUSOFART  (Read Only)
	Data Type: int, Value: 2
	Adobe Illustrator 25 Type Library
	Update the radius of radial repeat art.
	RadialRepeatUpdate.REVERSEOVERLAP  (Read Only)
	Data Type: int, Value: 64
	Adobe Illustrator 25 Type Library
	Update reverse overlap of radial repeat art.
GridRepeatUpdate
Adobe Illustrator 25 Type Library
Each flag represent which property of grid repeat gets updated.
	GridRepeatUpdate.GRIDALL  (Read Only)
	Data Type: int, Value: 63
	Adobe Illustrator 25 Type Library
	Update all the properties of grid repeat art.
	GridRepeatUpdate.HORIZONTALSPACING  (Read Only)
	Data Type: int, Value: 4
	Adobe Illustrator 25 Type Library
	Update spacing between rows of grid repeat art.
	GridRepeatUpdate.VERTICALSPACING  (Read Only)
	Data Type: int, Value: 8
	Adobe Illustrator 25 Type Library
	Update spacing between columns of grid repeat art.
SymmetryRepeatUpdate
Adobe Illustrator 25 Type Library
Each flag represent which property of symmetry repeat gets updated.
	SymmetryRepeatUpdate.AXISROTATION  (Read Only)
	Data Type: int, Value: 2
	Adobe Illustrator 25 Type Library
	Update axis rotation angle wrt x-axis.
	SymmetryRepeatUpdate.SYMMETRYALL  (Read Only)
	Data Type: int, Value: 7
	Adobe Illustrator 25 Type Library
	Update all the properties of symmetry repeat art.

[m1b]

Thank you!

[Silly-V]

Thanks!

[erhanlale]

does "Adobe Illustrator CC Type Library" still exist? I can not find it in VBA-References list.

I see only "Adobe Illustrator 25 Type Library" and it is selected. If I run my old scripts, I get the error:

Runtime error 430: Class does not support Automation

Am I doing something wrong?

[CarlosCanto]

what version are you using? this was fixed on the latest version, 25.2

well, I didn't have the same error as you did, but early binding wasn't working on 25 or 25.1, but it now works on 25.2

[erhanlale]

I have Illustrator 25.2 (64 bit). 

I see in VBA-References:

"Adobe Illustrator 25 Type Library" and it is checked.

But there is no "Adobe Illustrator CC Type Library" and If I run any script, I get error message '429'. CreateObject is in "CC Type Library". 

I tought, it might be a conflict with beta version and uninstalled beta, add "ScriptingSupport.aip" over VBA-References again. Still not working. 

[CarlosCanto]

I think those are just the library names mapped to each illustrator version. 

I have

"Adobe Illustrator CC Type Library" mapped to CC2018. 

"Adobe Illustrator 23 Type Library" mapped to CC2019. 

"Adobe Illustrator 2020 Type Library" mapped to CC2020. 

"Adobe Illustrator 25 Type Library" mapped to CC2021. 

[erhanlale]

You have right. After update I get error message on my old script:

Run-Time Error '429': ActiveX Component Can't Create Object

And I tought, that it is about references. But "createObject" is a part of VBA-Library. 

First problem: this scripting guide is not actually: 

https://www.adobe.com/content/dam/acom/en/devnet/illustrator/pdf/AI_ScriptGd_2017.pdf

On page 10: "select the check box for Adobe Illustrator CC Type Library"

This is was the reason, that I wrote my issue under this topic. 

Second problem: 

after the update is registry is not as it should be: 

https://community.adobe.com/t5/illustrator/activex-component-can-t-creata-object-illustrator-applica...

This is reason of my problem. Not everyone can edit registry, sometimes you are not permitted, even if you can. 

I have in registry "illustrator.application" and "illustrator.application.24" too. I changed script: 

CreateObject("Illustrator.Application.24") but it is still not working. This issue is not belong to this topic. 

[Alpha35770768viiv]

Can you give me breif example on how to access my cloud file on illustrator with scripting 

var docRef = app.OpenCloudDocument("Test/NewGarbTemplate.aic");
Trying this but not working

Also can you please tell me how to add artboard as soon as i open some document 

Thanks in Advance

[CarlosCanto]

you have a typo, OpenCloudDocument should start with a lower case o

try this

var docRef = app.openCloudDocument("Test/NewGarbTemplate.aic");

[Alpha35770768viiv]

It worked!!! Thank you so much .... Also can you please tell me how can access third party hosted files like dropbox or azure blob storage files in Adobe Illustrator via scripts... 
Suppose i have https://nordicstore.blob.core.windows.net:443/nordic/orders/SpiritRecognitionInc/451880/1/projectfil... this file how can i get it inside adobe illustrator via script this 
Also if i can access any file on network drive like \\192.168.1.6\Developer\Assets

Thanks in Advance 

[m1b]

Hi @Alpha35770768viiv, that is a great question. I believe the answer will be quite involved, and isn't part of this topic, so this might not be the best place to ask it. It would be great to ask that as a new question.

- Mark