AI plug-ins 5.0 History

All plug-ins and renderers can be started without Python. The Python installation is checked only when Python is really needed (i.e. when a script starts with #!py). If the installation is missing, Python scripts return the error 1. For the first Python script, a corresponding warning message is also shown. The following Python versions are expected:

Mac: Python 3.12.x must be installed in the default location /Library/Frameworks. Other Python installations are not supported. We have tested 3.12.6.
Windows: On Windows, Python 3.12 is already included in the installation package. Further installations are not necessary.
Linux: /usr/lib/python3.12

By the way, you can have any other, even newer Python version(s) installed. These versions are ignored by the priint:comet plug-ins and by comet_pdf.

Please note: In contrast to v4.x, v5.0 requires the Python version 3.12.

For the installation of the plug-ins we strongly recommend the installers provided by WERK II.

If, for any reason, a manual installation is necessary, it is important to replace all (but not more) plug-ins. Replacing individual plug-ins of different releases will crash Illustrator®. Here you can find complete zip sets of the plug-ins.

For information about the System Requirements for Illustrator see here.

All plug-ins are supplied in the so-called Universal Architecture and run on both Intel and Silicon machines. At least macOS Version 12 (Monterey) is required for all priint:comet plug-ins.

All plug-ins are checked against malware by Apple. However, since you did not get the plug-ins from the App Store, it is necessary to change the security settings of your System Settings:

Choose Privacy & Security in the sidebar
Click General on the top.
Under the point Allow apps downloaded from select Choose App Store and identified developers.

Because this file contains entries from our bug tracking system, the content of this file is partly in German.

The table describes the features and bug fixes of the priint:comet AI 5.0 plug-ins.

Revision	Case	Description
v5.0 R36800 02.06.2025	Python improvements	General improvements All logging functions, aswell as showMessage and showError now accept all data types for the 'message' parameter, implicitly converting the parameter to str [Fixed] CHyperLink.getType always returns 0
	TW 3444127 - The icons in the control bar are difficult to work with	Can the icon handling in the illustrator control bar be reconsidered? Specifically, the 4 "box with strikethrough" icons on the right. I initially thought that these icons were broken, and the box represented an "icon not found" placeholder, but obviously that is not the case. When these Icons are in the inactive state, they are impossible to distinguish between, and there are no tool tips to help me. I am VERY hesitant to click on any type of tool when I'm unsure of what it does. Could these icons be given a more unique look, and utilize a greyed out status? We changed that a little bit. Off/Deactivated : Black resp. White On/Activated : Blue The magnet was experimental and we removed it.
	TW 3445465 - Illustrator® tooltips on Mac show 'ALT' key	The tooltips of the Illustrator® plug-ins refers to the ALT key from time to time. Could this be changed to 'OPTION'? We have changed this accordingly.
	TW 3445402 - Tool tips missing in Illustrator® plug-ins	Unfortunately, no tooltips are shown in the Mac version* of the Illustrator® plug-ins.* Tooltips can now also be shown in the Mac version of the Illustrator® plug-ins.
v5.0 R36601 24.04.2025	Python improvements	General improvements CFrame.setImage now removes the image when None is used as the path parameter __repr__ functions are now more consistend and have unified line breaks for the result. [Fixed] CFrame.setImageScale parameter names do not match documentation [Fixed] CFrame.setImageScale indicates wrong function name on parameter exception New modules: strutils - comet related string utilities New functions: strutils.getNetweight strutils.escapeTagged strutils.unescapeTagged CFrame.getTextPosition
v5.0 R36336 13.03.2025	No functional changes.
v5.0 R36258 03.03.2025	Python improvements	General improvements Function CFrame.getChainFrames has been renamed to CFrame.getChain. The old name is still callable for backwards compatibility. New functions: CDocument.getActiveLayer CDocument.setActiveLayer CDocument.getActive CDocument.setActive CFrame.getNextInChain CFrame.setNextInChain CTextModel.append
v5.0 R36258 03.03.2025	Update Panels after undo TW 3325184 - Panels are not updated on undo	The following panels are now properly updated on undo when they are open: Behavior Document Attributes Frame Tags Layout Rules Placeholder Options
v5.0 R36169 15.02.2025	No functional changes.
v5.0 R36072 03.02.2025	Python improvements	New functions: CDocument.removeAttributes
v5.0 R36001 23.01.2025	Installer of v5.0 not working on Windows	After installing the new v5.0 plug-ins, Illustrator® crashes on startup on Windows. The new installers are fixed accordingly
	TW 3286001 - Logger not working	I’m trying to log messages in some scripts. To configure that, I’ve added a log.xml. But unfortunately none of my attempts are working and the the requestesd logfile is not written. To improve performance, we have revised the entire logging system in 5.0 R35824. Unfortunately, a few errors have crept in - including the fact that many messages are no longer written in the presence of a log.xml configuration. This is fixed now and the logging system should work as before (but significantly faster).
	TW 3289137 - AI-Plugin / Python / comet.frame.moveTo does not work with group frames	I have an Illustrator document with two frames which are grouped. If I select one of the grouped frames, three frames are selected: - two real frames with content - the group frame. When I try to move the list of selected frames to a new position, I get the following error message: Parameter 'frames' is not list[CFrame] or is empty comet.frame.selected will no longer return CGroup instances. [Fixed]
	Enabling logfile writing does not work.	Enabling writing to a logfile using the Illustrator menu does not seem to work. [Fixed]
	comet.getVersionMajor and comet.getVersionMinor return str instead of int	The Python functions comet.getVersionMajor and comet.getVersionMinor return str instead of int. [Fixed]
	TW 3290207 - comet.file.downloadWebImages wrong result entries on failed downloads	The Python function comet.file.downloadWebImages returns a list of results containing error codes. When an invalid URL has been provided, the resulting error code is still 0 (success). [Fixed]
	TW 3290251 - Python - wrong parameter in comet.CFrame.setBarcode	The Python function comet.CFrame.setBarcode has multiple problems: The 'options' parameter expects a str but raises an error saying it expects list[str]. Even when the 'options' parameter is correctly passed, the function raises an error. The default values for parameters width, height, offsetX and offsetY do not seem to work. [Fixed]
v5.0 R35824 05.12.2024	Python improvements	General improvements: Omitting a return value from the main function now no longer causes an error, but a warning is put into the logfile and a return value of 0 is assumed. CProduct can now be tested for equality against other products. product.create now has an ID parameter to directly initialize the product ID.
v5.0 R35824 05.12.2024	Faster logfile writing	We managed to refactor logfile writing, resulting in greatly improved performance.
v5.0 R35572 16.10.2024	First Release of v5.0	We are pleased to present the First release of version 5 of the priint:comet AI plugins here.
	Python improvements	General improvements: All plug-ins now use Python 3.12. For more information see here. Debugging is now available. For more information see here. Performance improvements of up to several hundred percent when running many scripts. Support for serial placeholders. Improved documentation - Added dark mode, improved readability, added several examples, restructuring. CPageItem.getType can now return whether a pageitem is a text on a path. CFrame.setImage has new constants for image placement (backwards compatible). CPageItem.moveTo has new parameters 'refPoint' and 'useBBox'. comet.runCScript now supports CProduct & list[CProduct] for variable transfer. Breaking changes: See porting guide for more information. Constants moved from comet module to comet.constants module. prefs.setPanelEnabled has been deprecated. CGroup.getGroup has been removed. New modules: comet.constants comet.debug comet.file comet.panel comet.pagetemplate New classes: CMagnet CScrap CSpread CDocLink New functions: __repr__ functions for all comet classes, returning a comprehensive string representation containing additional meta information about an object. debug.breakpoint debug.getServerPort debug.isClientConnected debug.isServerStarted debug.setServerPort debug.startServer debug.waitForClient dialog.selectImage file.download file.downloadWebImages file.getDataFile file.PDFCountPages file.setDataFile getVersionMajor getVersionMinor host.getSessionArgument pagetemplate.getElementCount pagetemplate.getElementInfo pagetemplate.getInfo panel.isEnabled panel.isVisible panel.reloadList panel.setEnabled panel.setVisible placeholder.getFuncVarValue placeholder.setFuncVarValue progress.unit publication.checkinByID publication.checkoutByID publication.collectDocuments publication.getProperty publication.revertByID publication.setProperty CCrossRef.getSourceFrame CCrossRef.getSourceIndex CCrossRef.getSourceLength CDocLink.getFrame CDocLink.getPath CDocLink.getState CDocLink.getType CDocLink.relink CDocLink.update CDocument.getCometGroups CDocument.getDocLinks CDocument.getMasterPageItems CDocument.getSpreads CDocument.redraw CFrame.isNote CFrame.removeMagnets CFrame.setBarcode CFrame.setMagnet CFrame.showsTextEnd CHyperlinkDestination.getName CMagnet.getSource CMagnet.getTarget CMagnet.getType CMagnet.isImage CMagnet.isRotationOnly CPage.getSpread CPage.loadMasterItems CPageItem.getAlternativeText CPageItem.setAlternativeText CPageItem.getParent CPageItem.getPDFAccessibility CPageItem.setPDFAccessibility CPageItem.getWrap CPageItem.getWrapIgnore CPageItem.isMasteritemOverriden CPageItem.isOverridenMasteritem CPageItem.overrideMasteritem CPageItem.removeMasteritemOverride CPageItem.setStroke CPageItem.setWrap CPageItem.setWrapIgnore CProduct.setID CQuery.setMethod CScrap.isValid CSOAP.call CSOAP.getList CSOAP.getMessage CSOAP.setLanguage CSOAP.uploadMetaData CSOAP.uploadTemplates CSpread.getDocument CSpread.getPages CSpread.remove CTable.convertToBodyRows CTable.convertToFooterRows CTable.convertToHeaderRows CTable.getSkipFirstHeader CTable.getSkipLastFooter CTable.mergeEqual CTable.mergeEqualInFrame CTable.setSkipFirstHeader CTable.setSkipLastFooter CTextModel.collectLinks CTextModel.copy CTextModel.cut CTextModel.insertProducts CTextModel.paste CTextModel.redraw
	New cScript functions	There are new cScript functions available: document::force_redraw frame::get_name frame::set_name list::reload placeholder::change_tags preferences::show_panel table::convert_to_footerrows table::convert_to_headerrows retint_dialog
	Table module improvements	table::columns performance improvements. Support for rotated cell content in 90° increments. Support for basic column fitting.