Design Editor 5

48 minutes to read

This topic includes new features, improvements, and bug fixes for Design Editor 5.

5.35.19 - November 30, 2022

Bug Fixes

Fixed a problem with rendering text elements containing both the ampersand (&) symbol and variable data.

5.35.16 - March 15, 2022

General Improvements

Improved performance of rendering barcodes to bitmaps.

Bug Fixes

Fixed a problem when a font with incorrect postscript name was replaced with Arial on the canvas.

5.35.15 - February 18, 2022

Bug Fixes

Fixed a problem with selecting images for image placeholders from DepositPhotos or MemorySource.
Fixed a problem when design elements stopped being displayed in the editor in some cases.

5.35.14 - February 11, 2022

Bug Fixes

Fixed a problem when the Asset Manager took a long time to open Public Source.

5.35.13 - November 25, 2021

General Improvements

Added the possibility to speed up retrieving assets from the public gallery, for example, if they are located on network drives. You can now enable reading assets on demand and read only first-level subfolders when initializing the image manager. To do so, set OnlyFirstLevelSubfoldersInitialization to True in AppSettings.config.

5.35.12 - October 7, 2021

General Improvements

Added the possibility to control changing the text stroke color. To maintain the stroke color the same as the text color, for example when rendering thin or script fonts, you can now set widgets.TopToolbar.textStrokeColorButtonEnabled to false in clientConfig.json as well as use the <TACSTC_f> marker in your templates.

Bug Fixes

Fixed a problem with rendering PNG images in the extended format (16 bits per channel).
Fixed a problem when product.setItem() did not change the content of text elements in a group.
Fixed a problem when finishProductDesign() saved the state file before recent changes were applied to the design.
Fixed a problem when the editor was unresponsive on the first load of the Asset Manager.
Fixed a problem when the public gallery displayed the categories in sorted order, but not in the order specified in the configuration.
Fixed a problem when Cannot read property errors appeared in the console shortly before the expiration of the license key.

5.35.8 - July 5, 2021

General Improvements

Optimized processing of multiple requests. Large bitmaps are now processed separately from the main combined bitmap.

Bug Fixes

Fixed a problem when some text elements could obtain the wrong size when loading from PSD templates.

5.35.7 - June 16, 2021

General Improvements

Improved the user experience with the Color Picker. You can now allow your users to select a color space by using the ColorPicker.colorSpaceDropdownEnabled property. You can also use cmykDecimalsEnabled to enable a decimal place in the CMYK color fields and paletteHintsEnabled to display names of color swatches
Added the PrintAreaBoundsChanged, UndoProduct, and RedoProduct events notifying when the print area size changes and the user clicks the Undo and Redo buttons.

Bug Fixes

Fixed a problem with reading PostScript names of fonts used in InDesign templates.
Fixed a problem when linked in-string placeholders with the <STYLE> marker were not updated in multipage products.
Fixed a problem when the Undo button was not enabled when the user changed the font.

5.35.6 - April 28, 2021

Bug Fixes

Fixed a problem with Depositphotos integration after deprecation of image categories in the Depositphotos API.
Fixed a problem with missing IframeApi.js.

5.35.5 - April 26, 2021

Bug Fixes

Fixed a problem when the Rich text editor would not load in some cases.
Fixed a problem with resetting the opacity value when changing the background color.
Fixed a problem when the Edit button was displayed for Depositphotos images in the Asset Manager.

5.35.4 - March 24, 2021

Bug Fixes

Fixed a problem when items in a product with an overlaying mockup were not automatically selected after loading the editor.
Fixed some problems with translations of the Color Picker.

5.35.3 - March 19, 2021

Bug Fixes

Fixed a problem when the preview image for multiple fonts was not regenerated after being removed from the cache.
Fixed a problem with uploading fonts through the Web API.
Fixed a problem with applying the bold style to bulleted lists in the Rich text editor.

5.35.2 - February 16, 2021

Bug Fixes

Fixed memory leaks when rendering print files.

5.35.1 - February 15, 2021

General Improvements

Added the possibility to specify allowed HTTP headers for the Web API. To allow headers other than X-CustomersCanvasAPIKey, list them as a comma-separated string in CorsAllowRequestHeaders.

Other

The HttpHeaderAllowOriginDomains parameter has been renamed to CorsAllowOriginDomains, but it is still supported if you don't specify the new one.

5.35.0 - February 3, 2021

New Features

Added the possibility to manage violation settings for a single item by using markers.

General Improvements

Improved logic for checking the trim zone violation. By default, design elements representing the background can go out of the trim zone although the main content cannot.
Added the possibility to hide file extensions in the Asset Manager.

Bug Fixes

Fixed a problem when an image fill in InDesign templates could appear different on the canvas and in print files.
Fixed a problem with rendering InDesign templates that contain PDF graphics with indexed colors.
Fixed a problem with reading layer types in PSD files created in Photoshop 2021.

Other

The <ORWS> marker has been renamed to <VSAR>, but it is still supported in product templates.
Added the possibility to change the default resize interpolation mode from High to Anisotropic9. You will need to use Anisotropic9 when the rendering of print files results in ippStsExceededSizeError. To enable this mode, set UseAnisotropic9ResizeMode to True in Aurigma.DesignAtoms.config.

5.34.9 - January 14, 2021

General Improvements

Improved generation of font previews after loading a large number of fonts in the editor.

Bug Fixes

Fixed a problem with rendering PDF graphics embedded in InDesign templates.
Fixed a problem when the imageEditorEnabled property did not work in some cases.

5.34.8 - December 22, 2020

General Improvements

Improved editor performance when a product contains a large number of design elements.

Bug Fixes

Fixed a problem with unnecessary color conversion when rendering print files with the PdfRenderKeepOriginalColors option enabled.

5.34.7 - December 17, 2020

Bug Fixes

Fixed a problem when PDF boxes were not set on the pages rendered from channel containers.
Fixed a problem with the invalidation of image elements loaded through a remote URL.
Fixed a problem when leading was changed when changing the alignment of text elements.

5.34.6 - December 10, 2020

Bug Fixes

Fixed a problem with color management when rendering InDesign templates on the canvas and proof images.

5.34.5 - December 9, 2020

Bug Fixes

Fixed a problem with the invalidation of design elements when generating proof images through the IFrame API.
Fixed a problem when print files could contain incorrect values of PDF page boxes.
Fixed some problems with the appearance of bulleted and numbered lists in the Rich text editor.

5.34.4 - November 27, 2020

Bug Fixes

Fixed a problem with removing surrogate pair characters from text when rendering product templates.
Fixed a problem when the Web API could render preview images of IDML templates cropped.
Fixed a problem when the <VNP> marker was not applied to item groups defined in InDesign templates.
Fixed a problem with displaying metric and imperial units on the canvas rulers.
Fixed a problem when output PDF files could be displayed with inverted colors when opened in Adobe Illustrator.

Other

For backward compatibility, added the LegacyIdmlBleedParsingEnabled parameter. You can set this parameter to true in Aurigma.DesignAtoms.config to load IDML templates with bleed and slug zones as it was implemented in version 5.32.

5.34.3 - November 18, 2020

Bug Fixes

Fixed a problem when the ~/api/HiRes/GenerateHiRes endpoint returned links to print files that were not specified in dataSet.

5.34.2 - November 12, 2020

Bug Fixes

Fixed a problem with displaying safety lines.

5.34.1 - October 22, 2020

Bug Fixes

Fixed a problem with rendering proof images of InDesign templates that contain a large number of elements.
Fixed a problem with color management when rendering proof images using colors selected with the eyedropper.
Fixed a problem with color management when rendering vector graphics.
Fixed a problem when curved text on canvas did not match the text defined in the PSD template.
Fixed a problem that caused Unexpected item error when loading IDML templates.
Fixed some problems with adding print areas to a surface by using the IFrame API.
Fixed a problem with adding images through the Asset Manager.

5.34.0 - October 6, 2020

New Features

Added the GET ~/api/users/{userId}/states/{stateId}/model endpoint to retrieve the entire object model from a state file.
Added the possibility to change the color of the background layer through the Toolbox. You can now set the onlyImage property of the Background button to false to allow your users to change both colors and images.

General Improvements

Added saving the user changes in product tags. Now, the setPrintArea method supports user changes when applied to products loaded from state files.

Bug Fixes

Fixed a problem when background images defined in product templates could be replaced with a plain white background in some cases.
Fixed a problem when design elements could move out of the canvas when resizing the product through the IFrame API.
Fixed a problem with adjusting image colors in the Image Editor.
Fixed a problem when the Underline button did not work in the Top Toolbar.
Fixed a problem when a type error could appear in the console when displaying pop-up boxes on the canvas.

Other

Renamed the Bounded text command to Text block in the Toolbox.

5.33.0 - September 23, 2020

New Features

Introduced arched text - a single-line text element on an arch. To allow your users to create arched text in the Design Editor, enable the ArchedText button in the Toolbox. In Photoshop and InDesign templates, you can create arched text as text on a path with the <ART> and <ARTB> markers.
Added support for eyedropper to pick a color on the canvas. To improve the user experience with the Color Picker, the color space drop-down box and the corresponding property availableColorSpaces were removed. The defaultColorSpace is deprecated now. Instead, you can use the ColorPicker.colorSpace property.
Added the possibility to configure the Bleed and Slug zones when defining print areas.

General Improvements

Added the possibility to render proof images when passing only maxWidth or maxHeight into the getProofImages method.
Added the possibility to lock the default color of barcodes and QR-codes by using the <BACCL> marker.
Improved user experience with the Asset Manager.

Bug Fixes

Fixed a security problem.
Fixed a problem with serialization of surface tags.
Fixed a problem when barcodes were - Added vertically stretched to the canvas.
Fixed a problem with the context menu appearance.

5.32.3 - September 8, 2020

Bug Fixes

Fixed a problem with the invalidation of file cache.
Fixed a problem with downloading print files when using the Download button.

5.32.2 - September 2, 2020

General Improvements

Added the possibility to start generating print files in the background when running the finishProductDesign method as well as making a request to the POST ~/api/HiRes/GenerateHiRes endpoint. To enable this option, set pregenerateHiRes to true.

Bug Fixes

Fixed a problem with applying the Multiply blend mode when rendering 3D previews through the Web API.
Fixed a problem with the rendering of rotated design elements when applying a gradient fill in InDesign templates.
Fixed a problem with reading barcode placeholders from InDesign templates.
Fixed a problem when names passed as parameters of the addSurface method were not assigned to new surfaces.
Fixed a problem with applying the character limit to text elements.

5.32.1 - August 17, 2020

Bug Fixes

Fixed a problem with displaying thumbnails in the private user gallery when using authentication tokens.
Fixed a problem when the border of an image placeholder based on a shape layer was not rendered.
Fixed a problem with applying blend modes to images when rendering products by using the Web API.

5.32.0 - August 6, 2020

New Features

Added support for Amazon S3 in the Asset Manager. You can host your artwork on Amazon S3 as well as allow your users to upload images there.

Bug Fixes

Fixed a problem when the translateItems command could fail in some cases.

Other

The <DPH> marker is deprecated now. Instead, you can use the Dynamic Image API to render 3D previews.

5.31.0 - July 23, 2020

New Features

Added the possibility to resize the entire product and separate design elements by using the IFrame API.
Added the POST ~/api/ItemReader endpoint to retrieve serialized items from products.

General Improvements

Added a separate package for the object model of DesignAtoms. Now, you must additionally install @aurigma/design-atoms-model from npm and Aurigma.DesignAtoms.Model from NuGet when developing your applications.

Bug Fixes

Fixed a problem with reading the background layers from multipage InDesign templates.
Fixed a problem when a new CustomPlaceholder could appear collapsed in the upper-left corner of the canvas.
Fixed a problem when the Select all button appeared in the Asset Manager when changing the content of image placeholders.
Fixed a problem with selecting the background images in the Asset Manager.
Fixed some problems with displaying thumbnails and folders in the Asset Manager.

5.30.3 - July 14, 2020

Bug Fixes

Fixed some problems with loading IDML templates with linked graphics.
Fixed a problem when fragments of text elements could appear on the canvas while loading product templates.

5.30.2 - July 7, 2020

General Improvements

Added the possibility to open the Asset Manager through the IFrame API to change product layouts and fill out image placeholders.

Bug Fixes

Fixed a problem with serialization and deserialization of state files that contain images by using the Design Atoms.
Fixed a problem with adding rich formatted text to the canvas when the multicolumn mode is enabled.
Fixed a problem with rendering text that wraps around design elements.
Fixed a problem when HTML tags were not escaped when rendering plain text.
Fixed a problem when assets did not appear in the Asset Manager in iOS WebView.

5.30.1 - June 29, 2020

Bug Fixes

Fixed a problem with applying the stroke effect in the Design Editor.
Fixed a problem with changing the font size of text elements.
Fixed a problem when OnImageDpiChanged was generated when loading vector graphics.

5.30.0 - June 25, 2020

New Features

Added the possibility to automatically fill out image placeholders. You can now use a new button action FillPlaceholders to open the Asset Manager for selecting images that will be inserted into all empty and stub image placeholders of the product. To allow your users to select all images on an asset tab, set selectAllButtonEnabled to true.
Introduced cliparts - design elements representing a set of multicolor vector shapes. You can import SVG graphics as clipart through the Asset Manager.

Bug Fixes

Fixed a problem when the Web API failed to copy optimized state files.
Fixed a problem with emitting the RevertProduct event.
Fixed a problem when the Asset Manager did not open after the user changed the fonts of text elements.

5.29.0 - June 17, 2020

New Features

Added the possibility to delete subfolders in asset folders by using the Web API. You can now delete subfolders with fonts, designs, and mockups.

Bug Fixes

Fixed a problem with displaying linked images in IDML templates that contain special characters in their file names.
Fixed a problem that caused the FontException when updating a PlainTextItem.

Other

Now, GET requests of the ProductTemplates controller require the X-CustomersCanvasAPIKey header by default. To return the previous behavior and disable security key verification, you can set authRequired to false for your routes in AuthSettings.config.

5.28.1 - June 12, 2020

General Improvements

Added support for the full-screen mode of the Image Editor on mobile devices. To disable this mode, you can set ImageEditorDialog.fullscreenOnTouchDevice to false.
Improved user experience with image placeholders on mobile devices.

Bug Fixes

Fixed a problem with the color of rich formatted text in in-string placeholders when using fonts with ligatures.
Fixed a problem with entering text in text placeholders when the Object Inspector is hidden or collapsed.
Fixed a problem with the layout of Rich text editor when zooming in Safari.

5.27.0 - May 27, 2020

New Features

Added the possibility to open the Asset Manager by using the IFrame API. You can open it to add a new image, change an image, or set the background.
Added support for Google Drive assets in the BMP, GIF, TIFF, SVG, and AI formats.
Added the possibility to reset the history of user actions after changing mockups through the setMockups.

Bug Fixes

Fixed a problem with reading rich formatted text from InDesign templates.
Fixed a problem with rendering hidden elements of PDF files embedded in InDesign templates.
Fixed a problem when the Web API failed to personalize products if fillColor was not passed for image placeholders with the Colorize effect.
Fixed a problem when a text item - Added to the second product page by using the IFrame API was not rendered on the canvas.
Fixed a problem when new elements would not be - Added to the product after changing the design through the setPrintArea method.
Fixed a problem with font substitution not being applied to products with rotated text elements.
Fixed a problem with false warnings about low resolution for vector assets from Google Drive.
Fixed a problem when text typed in the Object Inspector was not rendered on the canvas in some cases.
Fixed some problems with the layout of Object Inspector and Rich text editor.
Fixed a problem with AccessViolationException thrown when loading some specific fonts.

5.26.0 - May 12, 2020

New Features

Added the PointText button action. For example, you can define such a button in the Toolbox to insert plain point text into a region.
Added the IgnoreInDesignMissingLinks parameter to configure how to process missing images when reading InDesign templates. If True, creates an empty image placeholder instead of such an image. By default, this parameter is False, which throws an exception.

General Improvements

Changed settings of importing groups from Photoshop and InDesign templates. The UseFlattenGroups parameter has been renamed to FlattenGroups, and its default value has changed to False to maintain groups of design elements.

Bug Fixes

Fixed some problems with reading group items from InDesign templates.
Fixed a problem with rendering text that was vertically scaled in InDesign.
Fixed a problem with resetting the index of the current surface when using the product.setProductModel() method.
Fixed a problem when an error was returned in the response to the Preview and Hires Web API requests.
Fixed a problem when text with a shadow moved when changing the canvas zoom level.
Fixed a problem when preview images could not be rotated after rotating the print area more than 360 degrees.
Fixed a problem when font substitution was applied after uploading this font to the server.
Fixed a problem with uploading PDF files to the Asset Manager in the overwrite mode when same-name files have a different number of pages.
Fixed a problem with the Asset Manager layout that appeared after uploading images in the overwrite mode.
Fixed a problem with displaying surface thumbnails in the Bottom Toolbar.

5.25.2 - April 28, 2020

Bug Fixes

Fixed a problem when the FitToWidth mode did not work when using All Caps in bounded text.
Fixed some problems with rendering a product preview through the IFrame API.

5.25.1 - April 24, 2020

General Improvements

Added the possibility to define the file name when downloading PDF proof images generated through getProofImages. To define the name, use the filename query parameter.

Bug Fixes

Fixed a problem when mockups appeared when rendering a product preview through the IFrame API.
Fixed a problem with opening the Rich text editor when the applyToAllTextMode is enabled.
Fixed a problem with the Top Toolbar layout.

5.25.0 - April 14, 2020

New Features

Introduced groups of design elements. To import groups from Photoshop and InDesign templates as a group object in Customer's Canvas, specify the <GR> marker in group names. You can also define how groups of design elements should be imported by default. Set the UseFlattenGroups parameter to False to import them as group objects.
Added the possibility to render real-size proof images and render previews of all product pages to a multi-page PDF file through the IFrame API.

General Improvements

Added support for pagination when retrieving a list of state files through the Web API. You can also set a parameter extendedStateInfo to false to output only state IDs and timestamps.

Bug Fixes

Fixed a problem with passing the config parameter into the loadEditor method.
Fixed a problem when TIFF images linked in InDesign templates would appear with gray edges on the canvas and proof images.
Fixed a problem with unnecessary color conversion from CMYK to CMYK when applying the Colorize effect to TIFF images.
Fixed a problem with displaying the Insert button in the Asset Manager on mobile devices.
Fixed some problems with editing barcode placeholders.

5.24.0 - April 1, 2020

New Features

Added support for pinch to zoom the content of image placeholders on mobile devices.

General Improvements

Migrated from the Instagram Legacy API onto the Instagram Basic Display API. Now, you need to obtain new app-id and app-secret in your Facebook Developer Account.

Bug Fixes

Fixed a problem when <RT_false> was not applied to rich formatted text on a curve.
Fixed a problem with using the <R> marker in IDML templates when defining bleed zones.
Fixed a problem with displaying violation warnings for locked layers in the editor.
Fixed a problem with selecting images through the Object Inspector in the MD theme.

5.23.0 - March 26, 2020

General Improvements

Added the possibility to disable ASP.NET Attribute Routing in the Design Atoms Framework.

Bug Fixes

Fixed a problem with changing bounds of text elements when deleting their content.
Fixed a problem when text could disappear on the canvas when shrinking its bounding rectangle.
Fixed a problem with dragging and resizing design elements on the canvas in Safari.
Fixed a problem with the mouse pointer appearance when hovering over the center of image placeholders.

5.22.0 - March 16, 2020

New Features

Added the possibility to limit the size of uploaded user images. You can now define maxUploadFileSize when configuring the Asset Manager.

Bug Fixes

Fixed a problem with rendering hi-res outputs by using the Web API when the product has images whose width or height is close to 0.
Fixed a problem with downloading IDML templates that contain multiple links to the same image by using the Web API.
Fixed a problem with measuring the area of design layers when a product is configured by using mockups and the designLocation property.
Fixed a problem with displaying the selected value of multi-value items in the Object Inspector when loading state files into the editor.
Fixed a problem when watermark settings defined in clientConfig.json were ignored when a state file contained a different watermark definition.
Fixed a problem when names of custom design elements were changed when adding several such elements to the canvas.
Fixed a problem when the quality meter was displayed for vector images in the editor.
Fixed a problem with the Top Toolbar layout that appeared when editing designs in a small browser window.

5.21.1 - March 3, 2020

Bug Fixes

Fixed a problem with applying a load mask when processing images in the Image Editor.
Fixed a problem when the Rich text editor would not open if a font configured for the text was missing.
Fixed a problem when a bounded text item could change its position and overlay another BoundedTextItem in some cases.
Fixed a problem when transforms were not applied to image placeholders through the Web API.

5.21.0 - February 27, 2020

New Features

Added the possibility to rotate proof images at the same angle as the canvas. To maintain the rotation, set the IRenderingProperty.proofImageRotateMode to "auto".

Bug Fixes

Fixed a problem when parameters defined in clientConfig.json were not used for rendering the hi-res outputs through the Web API.
Fixed a problem when users could not set a color for the background layer in the editor.
Fixed a problem with using the Floating Item Toolbar on mobile devices.
Fixed a problem with selecting design elements on the canvas after scrolling the page.

Other

Updated the system requirements. Now, to use the Design Atoms Framework as well as to compile the Design Editor from the source code, you need TypeScript 3.8.2.

5.20.0 - February 19, 2020

New Features

Added the possibility to start generating proof images in the background when running the finishProductDesign method of the IFrame API. To enable this feature, you can set the pregeneratePreviewImages option to true when calling finishProductDesign. You can also use this option in getProofImages to start generating proof images, not just links to these images.
Added the possibility to customize three new types of snap lines. Now, you can define different behavior of lines snapping to design items, print areas, and safety lines.

General Improvements

Improved binding of theme colors to design elements when using the Color Picker.

Bug Fixes

Fixed a problem with rendering proof images when using the finishProductDesign method with the specified image size.
Fixed a problem when the fill color used for the Colorize effect was not applied to the content of image placeholders when using theme bindings.
Fixed a problem when the Colorize effect was not applied to PDF images when rendering hi-res outputs in the PDF format.
Fixed a problem with poor quality of PDF outputs when applying a color overlay to PDF images.
Fixed a problem with reading the baseline shift defined for InDesign text items.
Fixed a problem with rendering products through the Web API when defining surfaces by stateId.
Fixed a problem when channel containers were rendered on proof images with an offset relative to the designLocation.
Fixed a problem when a user could not click Floating Item Toolbar buttons when there was another design element below this toolbar.
Fixed a problem with wrapping text around design elements.
Fixed a problem when rich formatted text was not displayed in the editor.

5.19.3 - February 14, 2020

Bug Fixes

Fixed a problem with wrapping text around design elements when loading products.

5.19.2 - February 13, 2020

Bug Fixes

Fixed a problem with rendering hi-res outputs through the Web API when markers were defined in external JSON files.
Improved the rendering time of proof images when using the IFrame API.

5.19.1 - February 6, 2020

Bug Fixes

Fixed a problem with changing surface backgrounds by using the IFrame API.
Fixed a problem with getting overall bounds when calling setPrintAreas in the advanced editor mode.

5.19.0 - February 4, 2020

New Features

Added support for the color overlay effect defined for image placeholders in Photoshop templates.
Added the possibility to retrieve variable items from state files by using the Web API.
Added the optional parameter updateSurfaceSize to the setPrintAreas and setMockups methods. You can now pass true for this parameter to change the surface size. Note that despite this parameter, the surface size is always changed if no mockups were defined for the surface.

Bug Fixes

Fixed a problem when setProductModel did not handle the object model properly.
Fixed a problem when the Design Atoms Framework incorrectly parsed InDesign text frames with non-default autoleading.
Fixed a problem with rendering small-size thumbnails for multiple products by using the Design Atoms.
Fixed a problem with rendering bounded text when its bottom line contains subscript characters that go out of the text frame.
Fixed a problem when bounded text was imported from IDML templates as PathBoundedTextItem.
Fixed a problem when finishProductDesign returned incorrect violation warning data for text items in multi-page products.
Fixed a problem when setPrintAreas rasterized a vector content of image placeholders when applying new layouts.
Fixed a problem with false warnings about text cropping on the canvas.
Fixed a problem that caused an exception when using invalid data for images and image placeholders in loadUserInfo.
Fixed a problem with loading the user info when the new content of text elements began with "http".
Fixed a problem with switching the editor to the advanced mode after calling the product.SetProductModel method.
Fixed a problem with editing barcode placeholders on the canvas.
Fixed a problem when buttons of image placeholders became disabled after rotating the canvas.
Fixed a problem with the appearance of text labels of design elements after zooming or rotating the canvas.

5.18.0 - January 21, 2020

New Features

Added the possibility to configure the number of concurrent tasks for rendering products and loading or saving state files in the Design Editor.

General Improvements

Updated the Color Picker's palette.
Changed the default value of rendering.hiResOutputCompression to "jpeg", which reduces the size of PDF files when rendering raster images.

Bug Fixes

Fixed a problem with rendering PNG images embedded into PDF files when using the JPEG compression.
Fixed a problem with VisualizationPermissions.NoShow after applying the <VNS> marker to the corresponding item in a product template.
Fixed a problem with rendering some script fonts when aligning text to the bottom of the text box.
Fixed a problem when the content of image placeholders appeared shifted in Customer's Canvas when a BleedBox was defined in InDesign templates.
Fixed a problem when the rotation grip did not work in applications implemented in the Design Atoms Framework.
Fixed a problem with rendering proof images by using the IFrame API when the product has items whose width or height is close to 0.
Fixed some problems with rendering text in Arabic.
Fixed a problem when a hard return at the beginning of a text area did not expand its bottom bound despite the <TOS_expandBox> marker.
Fixed a problem with applying the <IE_colorize> marker to image placeholders.
Fixed a problem with the appearance of drop-down lists in iOS 13.3.
Fixed a problem with notification of the license key expiration.

5.17.1 - December 30, 2019

Bug Fixes

Fixed a problem with reading the First Baseline options of InDesign text frames.
Fixed some problems when folding lines and spines were applied to mockups instead of designs. Optimized rendering of hi-res outputs in the PDF format. Optimized saving state files by using StateFileSerializer.

5.17.0 - December 26, 2019

New Features

Added the possibility to specify product surfaces that need to be rendered to proof images by using the Web API.

Bug Fixes

Fixed a problem with deleting InDesign templates with linked images by using the Web API.
Fixed some problems with loading multiple text elements when fonts used in InDesign templates were missing on the server.
Fixed a problem when finishProductDesign returned "Page is unsupported" error instead of the link to return to editing a product.
Fixed a problem with displaying drop-down lists in the Bottom Toolbar on mobile devices.
Fixed some problems with rendering vector graphics in SVG format.
Fixed a problem with rendering specific PDF graphics embedded into IDML files.
Fixed a problem when scaling PDF graphics with the stroke effect resulted in the incorrect stroke width.
Fixed a problem when proof images were not cropped to safety lines if folding lines were defined for the product.

5.16.1 - December 18, 2019

Bug Fixes

Fixed a problem with the appearance of the pagination control on mobile devices.
Fixed a problem when multiple Web API requests to download proof images caused exceptions.

5.16.0 - December 13, 2019

New Features

Added the HiResControllerStoreDataInState parameter defining whether to save personalization data to state files when rendering hi-res outputs through the Web API or not. As an alternative, you can pass StoreDataInState in the request payload.

General Improvements

The Design Editor has stopped using the Image Gallery. After upgrading to this version, if the Image Gallery is still the default asset widget in your editor's config, the editor will open the Asset Manager with settings of the old gallery.
Added the possibility to use the Image Gallery configuration to set up the Asset Manager.
Improved error logging in the Rendering Web API.

Bug Fixes

Fixed a problem causing MediaCorruptedException when processing assets of unsupported formats through the Web API.
Fixed a problem when text on a curve went out of the text box after the font size reached the minimum value.
Fixed a problem with specifying the border width and opacity of design elements in the editor by using the keyboard.
Fixed a problem with editing design elements in the Object Inspector after using the Undo and Redo buttons.
Fixed a problem when InDesign templates with linked PDF graphics were not displayed correctly on the canvas.
Fixed a problem when text did not follow its text frame when moving on the canvas.
Fixed some problems when image and text effects were not applied to design elements after moving the sliders in the corresponding dialog boxes.
Fixed a problem when image placeholders were displayed with a non-transparent background in the edit mode.

5.15.0 - December 5, 2019

New Features

Added the possibility to arrange uploaded user images in a subfolder of userdata/user/images. To perform this, you can use the path property of the PrivateSource.

Bug Fixes

Fixed a problem with importing EPS graphics embedded in compound frames of IDML templates.
Fixed a problem with the shift of background layers when loading multipage IDML templates with defined bleed zones.
Fixed a problem with deleting the .json files from the designs folder through the Web API.
Fixed a problem when changes were incorrectly applied to shapes after using the product.setItem method.
Fixed a problem when the curve defining curved text changed depending on the text length.
Fixed a problem when blend modes were not applied to smart objects in PSD templates.
Fixed a problem with wrapping text around image placeholders when switching product surfaces in the editor.

5.14.3 - December 3, 2019

Bug Fixes

Fixed a problem with processing multiple Web API requests to render product previews.
Fixed a problem with caching preview mockups that prevented products from loading into the editor.

5.14.2 - December 2, 2019

Bug Fixes

Fixed a problem with resetting the text color when the user repeatedly changes the color in the Rich text editor.
Fixed a problem when rich formatted text disappeared after adjusting its bounding rectangle on the canvas.
Fixed a problem when the underline style was not applied to plain text in some cases.
Fixed a problem with rendering proof images and print-ready files when product surfaces were defined through ISurfaceFromState.
Fixed a problem with rendering text when using the allcaps style in the Rendering Web API.
Fixed a problem when the toolbar appeared on Asset Manager tabs on mobile devices despite toolbarEnabled set to false.
Fixed a problem when the Edit button would appear in the public gallery in the Asset Manager.
Fixed a problem with scrolling the Top Toolbar of the Design Editor.
Fixed some problems with the layout of image placeholders.
Fixed a problem with exiting the edit mode of image placeholders.

5.14.1 - November 26, 2019

Bug Fixes

Fixed a problem when rich formatted text was removed when selecting a color in the Rich text editor.
Fixed a problem when the Rich text editor opened too long to edit a text element in which the user has changed a text color.
Fixed a problem when the Remove format button reset formatting buttons when no text was selected in the Rich text editor.
Fixed a problem when the Search box hint was hardcoded instead of using the SEARCH_PLACEHOLDER string from AssetManager.json translations.
Fixed a problem with the alignment of plain text.
Fixed a problem with editing text items in the Object Inspector.

5.14.0 - November 22, 2019

General Improvements

Added the possibility to ignore the Item.Locked and Item.Visible attributes in InDesign templates. You can now set UseInDesignLockedState and UseInDesignVisibleState to False in Aurigma.DesignAtoms.config not to read them.

Bug Fixes

Fixed a problem causing color conversion exception when reading image fill colors from some IDML templates.
Fixed a problem when colors on the canvas did not change after applying color themes.
Fixed a problem when PDF graphics embedded into InDesign templates appeared distorted on the canvas.
Fixed a problem with updating channel containers by using the IFrame API.
Fixed a problem when names of user info fields and interpolation placeholders were case-sensitive when populating them with data.
Fixed a problem when double-clicking a group of design elements caused the primary action of the last selected element.
Fixed a problem with changing the text color in the Rich text editor.
Fixed some problems with deleting images from the Asset Manager.
Fixed a problem when the imageEditorEnabled property did not work in the Asset Manager.
Fixed a problem with the appearance of the Floating Item Toolbar when editing the content of image placeholders.
Fixed a problem when new text elements could appear transparent on the canvas in some cases.
Fixed a problem with displaying the current color of the background layer in the Color Picker.
Fixed a problem with changing the background color in the folding mode.
Fixed a problem with navigation using the arrow keys.
Fixed a problem with displaying the handle of image placeholders on mobile devices.
Fixed a problem with the editor layout on mobile devices.

5.13.1 - November 11, 2019

Bug Fixes

Fixed a problem with wrapping text around design elements.
Fixed a problem with color management when rendering products on the canvas.
Fixed a problem with swapping product surfaces by using the IFrame API.
Fixed a problem when the Edit button could appear in the Floating Item Toolbar for image placeholders despite showEditButton set to false.
Fixed a problem when barcode elements could lose focus after editing them.

5.13.0 - November 8, 2019

New Features

Added support for Code 128, UPC-A, and UPC-E barcodes. To create stub barcode placeholders, you can use the <BPH_CODE-128>, <BPH_UPC-A>, and <BPH_UPC-E> markers.
Added the possibility to specify the blend mode and opacity for applying color themes to products.
Added the possibility to disable color management and maintain original colors in assets starting from loading a product template to rendering a hi-res output. To perform this, you can set the PdfRenderKeepOriginalColors parameter to True in Aurigma.DesignAtoms.config.

General Improvements

Added the historySize parameter to specify the number of actions that the user can revert by using the Undo button. The default number of such actions is 10.
Improved performance of the Design Editor when manipulating elements on the canvas.
Optimized serialization of products containing a large number of text elements.

Bug Fixes

Fixed a problem with loading state files created in Customer's Canvas 5.0.
Fixed a problem when the user could insert images into a product after they were deleted through the Asset Manager.
Fixed a problem with wrapping text inside a shape.
Fixed a problem when an infinite loop was observed while entering text into a text element.
Fixed a problem with the alignment of design elements on the canvas.
Fixed a problem with opening the context menu for selected items.
Fixed a problem when the rotation angle tooltip would appear outside the canvas.
Fixed a problem with displaying the zoom level of the canvas in the MD Light theme.
Fixed a problem with displaying the rotation grip on mobile devices.

5.12.1 - October 29, 2019

Bug Fixes

Fixed a problem with expanding bounds of text elements when the user increases the font size.
Fixed a problem with applying the fill color to images using the Colorize effect in Safari.
Fixed some problems when properties of several design elements were not changed by using the setProductModel method or were not initialized in the multiple object update mode in the Design Editor.
Fixed a problem when URLs returned by the Web API for the private image gallery did not include the specified subfolder path.
Fixed a problem when incorrect names of spot colors appeared in output PDF files.
Fixed a problem with the appearance of the rotation grip on the canvas.
Fixed a problem when the Design Editor displayed incorrect previews of QR codes representing vCards.
Fixed a problem with displaying grips for cloned text elements on the canvas.
Fixed a problem with the invalidation of preflight warnings after cloning design elements.

5.12.0 - October 22, 2019

New Features

Added support for Frame Fitting Options in InDesign templates. Now, you can enable Auto-Fit and use the selected Fitting value as the content resize mode of image placeholders.

General Improvements

Added the possibility to both specify and obtain extensions of design files and mockups when using the File manipulation Web API.
Added the possibility to select multiple objects on the canvas by using the Shift key and mouse.

Bug Fixes

Fixed a problem with reading the image size in templates created in InDesign CS4.
Fixed a problem with undoing text items inserted into a product through the IFrame API.
Fixed a problem when data edited in the QR code dialog box could be lost in some cases.
Fixed a problem with adding images from Facebook by using the Asset Manager.
Fixed a problem with false warnings about the mockup resolution.
Fixed a problem when the Floating Item Toolbar disappeared after resizing empty placeholders.
Fixed a problem with the positioning of the Floating Item Toolbar when changing the canvas zoom.
Fixed a problem with grips of lines on the canvas.
Fixed a problem with rendering XML Escape characters in plain text elements.
Fixed a problem with rendering the ampersand (&) symbol in plain and rich formatted text when using the All Caps style.
Fixed a problem with assigning names to variable items.
Fixed a problem causing Cannot find a profile console warning when applying color management.
Fixed a problem causing Unexpected event type error when selecting an autocomplete option in barcode data boxes.
Fixed a problem causing Maximum call stack size exceeded error when clicking design items on the canvas.
Fixed a problem with the Top Toolbar layout.

Other

The newImageItem and arbitraryResizeForImageItemEnabled configuration parameters are deprecated now and will be removed in the next major release. Instead, you can use defaultItemsConfig.image.name and resizeGrips, correspondingly.

5.11.1 - October 17, 2019

Bug Fixes

Fixed a problem with defining the design location in print areas when using the setPrintAreas method.

5.11.0 - October 10, 2019

New Features

Added support for locked (Item.Locked) and visible (Item.Visible) attributes in InDesign templates.
Added support for Drop Shadow effect in InDesign templates.

General Improvements

Improved user experience with text labels of elements displayed on the canvas when using the canvasItemHoverEnabled property.
Added the possibility to specify opacity for border and fill colors in InDesign templates.

Bug Fixes

Fixed a problem with loading IDML templates created in InDesign CS4.
Fixed issues with text pop-up windows on mobile devices.
Fixed a problem with violationWarningData returning incorrect violation details for multipage products.
Fixed an issue with Object Inspector not being displayed in some cases.
Fixed a problem with spot colors in rich formatted text layers.
Fixed issues with font scale and size in the Font size drop-down list.
Fixed a problem with poor quality of image thumbnails in the Asset Manager.
Fixed some problems with the layout of Object Inspector and Top Toolbar.
Fixed a problem with the Edit button not being displayed in Floating Item Toolbar for text elements in some cases.
Fixed a problem when changes were incorrectly applied to in-string placeholders after using the product.setItem method.
Fixed a problem with using the Delete key in the Asset Manager.

5.10.0 - September 27, 2019

New Features

Added the possibility to specify a state file as a surface in a product definition. For state files representing multipage products, you can select a certain page.
Added the possibility to save personalization data to state files by using the Web API.
Added support for the All caps OpenType feature in PSD and IDML templates.

General Improvements

Improved changing the text color when using the product.setItem method.

Bug Fixes

Fixed a problem with reading Superscript characters specified in point text in PSD templates.
Fixed a problem with color management when applying color themes to products.
Fixed a problem with wrapping text inside a shape.
Fixed a problem when product.setProductModel changed bounds of design elements in some cases.
Fixed a problem with loading linked graphics from IDML templates.
Fixed some problems when a missing font could not be substituted with a default one when loading IDML templates.
Fixed a problem with manipulating some specific IDML templates by using the Web API.
Fixed a problem with applying transforms to the content of image placeholders in the original resize mode when using the Rendering Web API.
Fixed a problem with using the Delete key in the Barcode dialog box.
Fixed a problem with changing the fill color of barcode placeholders.
Fixed a problem when designLocation was not applied when changing images in the background layer.
Fixed a problem with displaying safety lines on the canvas when changing the zoom level.
Fixed some problems with the appearance of the Color Picker when selecting a color.
Fixed a problem with scrolling drop-down lists in the Top Toolbar.
Fixed a problem with the appearance of the Floating Item Toolbar in the simple editor mode.
Fixed a problem with applying the <BG> marker to shapes.
Fixed a problem when the default properties specified in themeBinding were not applied to new lines.

Other

Removed obsolete permissions from the default marker shortcuts in TemplateConfigShortcuts.json.

5.9.0 - September 13, 2019

New Features

Added support for mockups when using multipage IDML templates. Now, you can specify a mockup for all pages as well as for a single page.
Added the possibility to select a predefined angle to which the canvas is rotated when clicking the Rotate button in the Bottom Toolbar.

General Improvements

Improved the product.setItem method to eliminate blinking design elements on the canvas when editing them through the IFrame API.

Bug Fixes

Fixed a problem when a default color profile was incorrectly applied to shapes and text elements in IDML templates.
Fixed a problem when applyProductTheme failed to change text colors in some cases.
Fixed a problem with loading IDML templates that contain some specific fonts.
Fixed a problem with rendering design elements to which the multiply blend mode and gradient fill were applied in IDML templates.
Fixed a problem with false warnings about text cropping on the canvas.
Fixed a problem with rendering proof images when the product width significantly differs from the product height.
Fixed a problem causing the State not found error.
Fixed a problem with adding barcodes to large-scale products.
Fixed some problems with managing external storage of state files.
Fixed a problem with rasterization of vertical and horizontal lines when using the <SR> marker.
Fixed a problem with editing text elements in products created through the setPrintAreas method.
Fixed a problem with manipulating design elements on the canvas by using the keyboard.
Fixed a problem when resetting the content of image placeholders could change the content resize mode.
Fixed some problems with rendering QR codes on proof images and hi-res outputs.

5.8.2 - September 2, 2019

Bug Fixes

Fixed a problem with updating text elements on the canvas when the multipleObjectsUpdateOptimizationEnabled parameter is enabled.

5.8.1 - August 31, 2019

Bug Fixes

Fixed a problem with rendering hi-res outputs by using the Web API.

5.8.0 - August 30, 2019

New Features

Added the possibility to list product templates and mockups in a single subfolder by using the Web API. The resulting list includes identifiers of those files that have valid extensions.

General Improvements

Improved load time of product templates.

Bug Fixes

Fixed a deadlock problem when using the Authentication Web API in a load-balanced environment.
Fixed a problem with the initialization of authentication tokens in the anonymous mode.
Fixed a problem with selecting overlapping design elements on the canvas.
Fixed a problem with the order of font family names in the Top Toolbar.
Fixed a problem with opening the Rich text editor in some cases.
Fixed a problem with reading paths to linked images in IDML templates.
Fixed a problem with AccessViolationException thrown when reading IDML templates with some specific fonts.

5.7.1 - August 26, 2019

General Improvements

Optimized saving state files.

Bug Fixes

Fixed a problem with loss of embedded color profiles when inserting PDF graphics into image placeholders.
Fixed a problem with positioning the Floating Item Toolbar.

5.7.0 - August 22, 2019

New Features

Added the possibility to use products as templates for variable data printing in the Design Atoms Framework and the Web API.

Bug Fixes

Fixed a problem with rendering previews of IDML templates by using the Web API.
Fixed a problem with rendering a product in the Design Editor in the Canvas Only mode.
Fixed a problem with switching the editor to full-screen mode.
Fixed a problem with the allowEditImage permission applied to the content of image placeholders.
Fixed some problems when the Floating Item Toolbar displayed disabled buttons.
Fixed some problems with the z-order of the Floating Item Toolbar and design element grips in the Design Editor.

5.6.0 - August 12, 2019

New Features

Added the possibility to download and move IDML templates together with linked images when using the Web API.
Added the possibility to change properties of the content of image placeholders when rendering products through the Web API.

General Improvements

Improved safety of the setUserId() method. Before using this method, you must enable the secure mode and update a token with a new userId.
Added the possibility to configure the maximum and minimum zoom level of the canvas. The canvas.zoomStep parameter is deprecated now.

Bug Fixes

Fixed a problem with browser cache invalidation after upgrading Customer's Canvas.
Fixed a problem with the disappearance of design elements from the canvas in Safari.
Fixed a problem with AccessViolationException thrown when trying to open an IDML template being uploaded to the Design Editor.
Fixed some problems when PDF graphics embedded into InDesign templates could appear distorted on the canvas.
Fixed a problem with converting spot colors.
Fixed a problem with the Toolbox layout.

5.5.1 - August 5, 2019

Bug Fixes

Fixed a problem with handling mouse events in dialog boxes.
Fixed a problem with selecting a text color in the Rich text editor.
Fixed a problem when a color preview did not appear in the Object Inspector in some cases.
Fixed a problem when the Asset Manager did not open by double-clicking images on the canvas.
Fixed a problem causing User token must be provided error when using the Web API.
Fixed a problem causing Incorrect RgbColor format console warning when selecting background color from the color palette.

5.5.0 - July 29, 2019

New Features

Added the possibility to import shape frames from InDesign templates as raster images. To perform this, you can use the <SR> marker.
Added the possibility to render spot colors and textures to separate hi-res files.
Added the possibility to check if a state file is available and upload state files through the Web API.

Bug Fixes

Fixed a problem with rendering alternate glyphs selected in InDesign templates.
Fixed a problem with rendering the stroke and shadow effects by using the Web API.
Fixed a problem causing User token must be provided error after passing a tokenId to the Design Editor.
Fixed a problem with selecting CMYK colors in the Color Picker.

5.4.0 - July 19, 2019

New Features

Added the possibility to render Lab colors into PDF outputs.
Added the possibility to change barcode colors through the user interface, product themes, and defaultItemsConfig.
Implemented a new mode of the overflow strategy for bounded text elements when the original text area can be expanded. You can enable this mode through either the <TOS_expandBox> marker or the overflowStrategy property of text items.

General Improvements

Improved user experience with overlaying design elements on the canvas.
Disabled restoring a product state when the page is reloaded in the browser. To change back this behavior, set the restoreProductOnReloadEnabled parameter to true in clientConfig.json.

Bug Fixes

Fixed a problem with false warnings about text cropping.
Fixed some problems causing Index out of range and Unsupported pixel format errors when loading specific IDML templates.
Fixed some problems when dragging was incorrectly activated when users manipulated design elements over image placeholders on the canvas.

5.3.0 - July 8, 2019

New Features

Added support for fill colors of grayscale images imported from InDesign templates. You can also add the <IE_colorize><IFC_color> markers to an image layer in either PSD or IDML templates. In this case, the Design Editor converts this image to grayscale and applies the specified color. To change this color, your users can select another fill color in the Top Toolbar.
Added the possibility to download templates and mockup files from your Design Editor by using the Web API.
Added the possibility to select design elements on the canvas through the IFrame API. Now, you can select items by names, select all items, and deselect them.

General Improvements

Added the possibility to specify color profiles at runtime through IConfiguration.
Removed editorial photos from search results in Depositphotos assets.

Bug Fixes

Fixed a problem with selecting Depositphotos assets on mobile devices.
Fixed a problem when default safety lines and crop marks were not applied to new surfaces.
Fixed a problem when image placeholders with arbitrary shapes appeared rectangular.
Fixed a problem with titles of text pop-up boxes.
Fixed a problem with the rotation of the image placeholder content when using the Rendering Web API.

5.2.0 - June 25, 2019

New Features

Introduced external storage for state files. Now, you can specify endpoints for pushing and pulling state files and avoid storing these files in your local storage. In this case, you need to implement a controller processing the push and pull requests.
Added the possibility to use new fonts in the Design Editor as soon as you add them to the ..\assets\fonts folder without calling Web API methods.
Added the possibility to read spot colors from IDML templates. You can also define these colors in the Color Picker. For example, "spot(PANTONE Rubine Red C, cmyk(30%,100%,90%,36%,100%), 1, 100%)".
Added support for blend modes in InDesign templates.

General Improvements

Added a new Aurigma.DesignAtoms.x86 NuGet package that allows for using the Design Atoms Framework in the x86 environment.

Bug Fixes

Fixed a problem with the initial zoom level of large-scale products on the canvas.
Fixed a problem when the Asset Manager displayed sources not specified in the tabs array to select the content of image placeholders.
Fixed a problem with rotating a product on the canvas.
Fixed a problem with navigation using the Tab key on the Top Toolbar.
Fixed a problem when ruler markers did not match the cursor position.
Fixed some problems with the layout of Asset Manager and Object Inspector.

5.1.1 - June 6, 2019

General Improvements

Now, when you use either Evaluation or Developer license key, watermarks appear on the canvas notifying you of the license expiration date.

Bug Fixes

Fixed a problem with loading the Design Editor that occurred in some special cases.
Fixed some problems with the Multiple mode of in-string placeholders.
Fixed some problems with the layout of text pop-up windows.
Fixed a problem with the Object Inspector layout in the MD Light theme.

5.1.0 - May 31, 2019

New Features

Released SDK source code. You can now completely customize the on-premises version of Customer's Canvas 5.

General Improvements

Now, Customer's Canvas uses default names of InDesign elements (in angle brackets) as names for items.
Now, when you specify the bleed area in InDesign, it will be used as the trim box in PDF outputs.

Bug Fixes

Fixed a problem when after changing a license key, it was not applied.
Fixed some problems with the invalidation of browser cache after updating Customer's Canvas.
Fixed a problem with the <PHRM_original> marker.

5.0.1 - May 24, 2019

New Features

Added support for rich formatted text on a curve. You can enable a rich format by using the <RT> marker or various formatting for curved text.
Added support for OpenType Features such as ligatures, uppercase, lowercase, superscript, and subscript in the Design Atoms Framework. Now, you can use these features in PSD and IDML templates and render them both on the canvas and in hi-res outputs.
Added support for vector masks of text and image layers in the Design Atoms Framework.
Added the possibility to track item changes by using the ItemChanged and SelectedItemsChanged events.
Added the possibility to crop hi-res outputs to safety lines. You can specify how to crop them by using the pdfBox property in your definition of safetyLines.
Added the possibility to specify text labels for design elements. To enable these labels in the Object Inspector, set the widgets.ObjectInspector.showItemName property to true. The canvasItemHoverEnabled property allows you to display these labels on the canvas.

General Improvements

Optimized performance of the Design Editor when loading watermarks and adding or deleting design elements.

Bug Fixes

Fixed a problem when buttons on the Floating Item Toolbar did not work for text elements - Added through the IFrame API.
Fixed a problem with using the ColorFactory in the Iframe API.
Fixed a problem with the appearance of safety lines on the canvas.
Fixed a problem with specifying the path to color profiles.
Fixed a problem when a locked item, - Added through the Iframe API, could obtain the focus.
Fixed a problem when users could not change fonts of plain text elements in Firefox.

5.0.0 - April 25, 2019

Major Feature Highlights

New Design Atoms Framework - implemented an official API to work with each element of a design loaded in the editor.
The ready-to-use project with samples - added GitHub repositories with code examples.
Revised default config settings - optimized parameters from early versions of Customer's Canvas.
Revised application structure - changed the default location of the asset and data folders so that makes it easy to upgrade Customer's Canvas and maintain multiple versions.