Aurigma.DesignAtoms.config

5-6 minutes to read

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.

<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="PdfTextOutputMode" value="Outlines" />
    <add key="UseInDesignLockedState" value="True" />
    <add key="UseInDesignVisibleState" value="True" />
    <add key="IgnoreInDesignMissingLinks" value="False" />
    <add key="LegacyIdmlBleedParsingEnabled" value="False" />
    <add key="InterpretEmptyGraphicFrameAsImagePlaceholder" value="False" />
    <add key="FlattenGroups" value="False" />
    <add key="DefaultColorOverlayBlendMode" value="HardLight" />
    <add key="DefaultColorOverlayOpacity" value="0.8" />
    <add key="UseAnisotropic9ResizeMode" value="False" />
    <add key="UseHiResDpiForPdfResize" value="False" />
    <add key="LegacyBlackAndWhiteEffectEnabled" 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.

Let's look at these parameters in more detail.

Color management

Name	Description	Possible values
RgbColorProfileFileName	The name of the RGB color profile. For details, refer to the Color management topic.	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	If `True`, enables DeviceCMYK and does not embed any color profile into the resulting PDF file in the PDF/X-4 standard. 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`. Note: you can also apply this behavior to a single rendering operation. For more details, see the Rendering API.	`True`, `False`
PdfHiResRasterizeVectorLayers	Allows for rasterizing vector elements in the PDF output. The default value is `False`.	`True`, `False`

Text

Name	Description	Possible values
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 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`
PdfTextOutputMode	Defines how text will be rendered to output PDF files. If `Outlines`, renders a set of vector outlines. If `Text`, renders strings. The default value is `Outlines`.	`Outlines`, `Text`

Reading templates

Name	Description	Possible values
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`
InterpretEmptyGraphicFrameAsImagePlaceholder	If `True`, imports graphic frames from IDML templates as image placeholders. By default, this value is `False`, and graphic frames are loaded depending on the <PH> marker.	`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

Name	Description	Possible values
DefaultColorOverlayBlendMode	The blend mode, which will be used when applying color themes to products. The default value is `HardLight`.	string
DefaultColorOverlayOpacity	The opacity, which will be used when applying color themes to products. The default value is `0.8`.	number

Miscellaneous

Name	Description	Possible values
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`
UseHiResDpiForPdfResize	If `True`, it uses a high-resolution DPI for the preview when zooming the viewer, typically 300 DPI. If `False`, it uses a low-resolution DPI corresponding to the zoom level. The lower the DPI, the lower the image quality and the higher the rendering speed. The default value is `False`.	`True`, `False`
LegacyBlackAndWhiteEffectEnabled	If `True`, enables the earlier algorithm for the black-and-white effect when the resulting pixel color (black or white) was calculated based on the illumination of the pixel in the original image. By default, this value is `False`, and the algorithm uses dithering and gives a better visual approximation to the original image.	`True`, `False`