You’re viewing outdated documentation. View the latest Customer’s Canvas On-Premises documentation.

Aurigma.DesignAtoms.config

Applies to: Customer's Canvas On-Premises; Design Editor 6.15.0, 6.x (may differ); Design Atoms .NET 6.15.0, 6.x (may differ) · Archived documentation

The ~/Configuration/Aurigma.DesignAtoms.config file allows you to configure the location of color profiles.

The following snippet shows parameters for working with fonts, product themes, and color management, which you can set up in either the Aurigma.DesignAtoms section of Web.config or in the separate ~/Configuration/Aurigma.DesignAtoms.config file, and their values.

XML

    <Aurigma.DesignAtoms>
        <add key="RgbColorProfileFileName" value="" />
        <add key="CmykColorProfileFileName" value="" />
        <add key="GrayscaleColorProfileFileName" value="" />
        <add key="ColorProfilesDirectory" value="..\assets\ColorProfiles" />
        <add key="PdfRenderDeviceProfileEnabled" value="False" />
        <add key="PdfRenderKeepOriginalColors" value="False" />
        <add key="PdfHiResRasterizeVectorLayers" value="False" />
        <add key="FontDirectory" value="..\assets\fonts" />
        <add key="PsdTextBoxWorkaroundEnabled" value="False" />
        <add key="LegacyTextEngineEnabled" value="False" />
        <add key="PreferredFallbackFonts" value="" />
        <add key="NotFoundGlyphRemovalEnabled" value="False" />
        <add key="UseInDesignLockedState" value="True" />
        <add key="UseInDesignVisibleState" value="True" />
        <add key="IgnoreInDesignMissingLinks" value="False" />
        <add key="LegacyIdmlBleedParsingEnabled" value="False" />
        <add key="FlattenGroups" value="False" />
        <add key="DefaultColorOverlayBlendMode" value="HardLight" />
        <add key="DefaultColorOverlayOpacity" value="0.8" />
        <add key="UseAnisotropic9ResizeMode" value="False" />
    </Aurigma.DesignAtoms>

Note

Parameters defining paths are either relative or absolute. Relative paths to folders are specified from your site root and start with ~/ (for example, ~/ColorProfiles). Absolute paths are complete ones; they start either with a drive letter (for example, C:\) or \\ for network locations. When you use absolute paths to external folders, make sure that the user account, under which Customer's Canvas runs in ASP.NET/IIS, has the read/write access to the remote folders.

Name	Description	Possible values
Color management
RgbColorProfileFileName	The name of the RGB color profile.	file name
CmykColorProfileFileName	The name of the CMYK color profile.	file name
GrayscaleColorProfileFileName	The name of the grayscale color profile.	file name
ColorProfilesDirectory	The folder path where color profiles are stored. The default value is `"..\assets\ColorProfiles"`.	folder path
PdfRenderDeviceProfileEnabled	Enables DeviceCMYK and does not embed any color profile into the resulting PDF file. To maintain correct colors, you need to specify a profile corresponding to your printing equipment in CmykColorProfileFileName. The default value is `False`.	`True`, `False`
PdfRenderKeepOriginalColors	Disables color management and maintains original colors in source templates and assets. This parameter does not embed any color profile into the resulting PDF file. Unlike PdfRenderDeviceProfileEnabled, it does not convert colors to the destination color space. The default value is `False`.	`True`, `False`
PdfHiResRasterizeVectorLayers	Allows for rasterizing vector elements in the PDF output. The default value is `False`.	`True`, `False`
Text
FontDirectory	The folder path where fonts are stored. The default value is `"..\assets\fonts"`.	folder path
PsdTextBoxWorkaroundEnabled	Allows for correcting a text position within the text box if Photoshop shifts this text for the used script font. The default value is `False`.	`True`, `False`
LegacyTextEngineEnabled	If `True`, the Rich text editor will open for editing text elements. If `False`, enables in-place text editing in a rich format. Since in-place editing does not support vertical text, scaled text, shadows, custom alignment, and text with overlapping lines, the Rich text editor opens to edit these text types in both cases. The default value is `False`.	`True`, `False`
PreferredFallbackFonts	When text elements contain glyphs that are not present in the font, Design Atoms searches for such glyphs in all fonts registered in the application. To specify which fonts must be checked first, you can list their PostScript names in the value of this parameter, for example, `"ArialMT;Menlo-Bold"`. This parameter is only applicable when using the Classic text engine, and its value is passed to fontRegistry.FallbackFonts. The default value is an empty string.	string
NotFoundGlyphRemovalEnabled	If `True`, glyphs missing in the used font will be removed from text elements when rendering the text. If `False`, throws an exception when such glyphs take place. The default value is `False`.	`True`, `False`
Reading templates
UseInDesignLockedState	If `True`, enables reading the Item.Locked attribute from InDesign templates. The default value is `True`.	`True`, `False`
UseInDesignVisibleState	If `True`, enables reading the Item.Visible attribute from InDesign templates. The default value is `True`.	`True`, `False`
IgnoreInDesignMissingLinks	Defines how to process missing images when reading InDesign templates. If `True`, creates empty image placeholders instead of such images and displays a console warning. If `False`, throws an exception. The default value in the config is `False`. Without this parameter, empty image placeholders appear instead of missing images.	`True`, `False`
LegacyIdmlBleedParsingEnabled	If `True`, loads IDML templates with bleed and slug zones as it was implemented in version 5.32 (for backward compatibility). The default value is `False`.	`True`, `False`
FlattenGroups	Defines how groups of design elements should be imported. If `False`, imports groups from InDesign and Photoshop templates as group objects to Customer's Canvas. If `True`, every element of a group will be imported as a separate item. The default value in the config is `False`. Without this parameter, the groups are split into separate items.	`True`, `False`
Product themes
DefaultColorOverlayBlendMode	The blend mode, which will be used when applying color themes to products. The default value is `HardLight`. For more details, refer to the Product Themes topic.	string
DefaultColorOverlayOpacity	The opacity, which will be used when applying color themes to products. The default value is `0.8`.	number
Miscellaneous
UseAnisotropic9ResizeMode	Enables either `High` or `Anisotropic9` resize interpolation mode for rendering products. You may need to use Anisotropic9 when the rendering of print files results in ippStsExceededSizeError. The default value is `False`.	`True`, `False`

For more details on color management, refer to the Color Management in Customer's Canvas topic.

Aurigma.DesignAtoms.config

Color management

Text

Reading templates

Product themes

Miscellaneous

See Also

Manual