Aurigma.DesignAtoms.config
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="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 . |
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 |
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 |