Breaking Changes in 6.0

We actively develop Customer's Canvas API and realize that critical changes may be unacceptable and complicate the update process. When some API elements become inconsistent and inconvenient, we first declare them deprecated, and they work in parallel with the new functionality for a while. In further major releases, we delete such deprecated elements.

This topic describes breaking changes in configuration parameters, markers, and the Web API that appear in Customer's Canvas 6.

Bleed Zone and Print Area Size

Starting from version 5.33, we have changed the way we define the bleed zone and print area size, bringing the user experience closer to Adobe InDesign and other professional tools. Earlier, if you wanted to create a 3.5x2" business card with 1/8" bleed, you created a 3.75x2.25" design and put a safety line inside it.

But now, when you create a 3.5x2" design, the bleed zone will expand outside the design.

Defining the bleed zone.

Bleed and Slug (the space outside the bleed zone) are now regulated by separate properties of the Print Area. If both safety lines and bleed margins are encountered, then the bleed has a higher priority. The safety lines are still displayed, but they no longer reflect the trim and bleed lines.

Accordingly, the logic for reading IDML files has changed when using the built-in Bleed and Slug fields. Earlier, the product size remains as is, and we automatically added a safety line object. Now, we expand the product by the size of Bleed and Slug. We consider the upper-left corner of the final product (i.e. trim line) as the origin, not the expanded design.

After upgrading to version 6, you may run into a problem when the size of the product is not what you expect, and unnecessary safety lines may also appear. If you encounter this, you can either rework the design and change the Bleed and Slug settings, or enable the old behavior. In the latter case, set LegacyIdmlBleedParsingEnabled to True in Aurigma.DesignAtoms.config.

For the products based on PSD templates, everything remains the same since they do not contain information about the bleed zone. However, if your designs do not contain backgrounds, we recommend using the bleed property instead of the safety lines.

Changed Parameters in Configuration Files

clientConfig.json

Parameter Name Old Value New Value
watermark.text.fontSettings "ArialMT" "Roboto-Regular"

AppSettings.config

Parameter Name Old Value New Value
FontSubstitutionEnabled "True" "False"
SubstitutionFontPostScriptName "ArialMT" "Roboto-Regular"
DefaultFontPostScriptName "ArialMT" "Roboto-Regular"

Removed Configuration Parameters

AppSettings.config

Parameter Name An Alternative
ParagraphTextEnabled Not applicable

clientConfig.json

Parameter Name An Alternative
arbitraryResizeForImageItemEnabled IResizeGripsPermissions
defaultAssetSelectWidget Not applicable
newImageName defaultItemsConfig.image.name
canvas.snapLines.enabled canvas.snapLines.{type}.enabled
canvas.snapLines.color canvas.snapLines.{type}.color
canvas.snapLines.tolerance canvas.snapLines.{type}.tolerance
canvas.ZoomStep canvas.zoom
widgets.BottomToolbar.snapLinesCheckboxEnabled widgets.BottomToolbar.snapLines{type}CheckboxEnabled
widgets.ColorPicker.defaultColorSpace widgets.ColorPicker.colorSpace
widgets.ColorPicker.availableColorSpaces Not applicable
widgets.ColorPicker.palette IPaletteSection

Removed Markers

Marker Name An Alternative
<DPH> Dynamic Image API

Changes in the Web API

POST ~/api/Preview/GeneratePreview

POST ~/api/HiRes/GenerateHiRes

Old Parameter New Parameter
previewOptions.width previewOptions.maxWidth
previewOptions.height previewOptions.maxHeight