Safety Lines

Safety Lines

You can define the safety lines through the product configuration in the editor but not through the PSD templates. These lines are shown only at the design time as follows:

Technically, the ISafetyLine interface defines these lines. It contains parameters to set up a width of the bleed zone and a style of safety lines. The width is measured in points (1/72 of an inch). For example, if you need the bleed zone of 1/8 of an inch, you should set margins to 9. You can set up a single margin for all four product sides or two separate margins for top/bottom and left/right sides.

The Product Definition

You can configure the safety lines for either all product surfaces or a single surface.

To define safety lines for all product surfaces, pass the IProductDefinition.defaultSafetyLines property to loadEditor.

productDefinition = {
    defaultSafetyLines: [{
        leftRightMargin: 5,
        topBottomMargin: 10,
        color: "rgba(0,255,0,255)",
        altColor: "rgba(255,255,255,0)",
        stepPx: 5,
        widthPx: 1
    }],
    surfaces: ["pocket_calendar", "pocket_calendar_back"]
};

CustomersCanvas.IframeApi.loadEditor(iframe, productDefinition);

Note that the default measurement units in Customer's Canvas are points. If a parameter accepts other units, then the unit name is specified in the parameter name like stepPx and widthPx in this example.

If the IProductDefinition.defaultSafetyLines property is set up, then all product surfaces will have the same safety lines by default. The default safety lines can be overridden for any surface by setting the surface's safety lines as follows:

productDefinition = {
    surfaces: [{
        designFile: "pocket_calendar", 
        safetyLines: [{
            margin: 9,
            color: "rgba(0,255,0,255)",
            altColor: "rgba(255,255,255,0)",
            stepPx: 5,
            widthPx: 1
        }]
    }]
};

Here, the IPrintAreaTemplate.safetyLines property sets safety lines for a surface having a design template. To set safety lines for a blank surface having no design template, use the IPrintAreaDefinition.safetyLines property.

productDefinition = {
    surfaces: [{
        width: 200, 
        height: 150, 
        printAreas:[{
            bounds: { x:0, y:0, width: 200, height: 150}, 
            safetyLines: [{
                margin: 9,
                color: "rgba(0,255,0,255)",
                altColor: "rgba(255,255,255,0)",
                stepPx: 5,
                widthPx: 1 
            }]
        }]
    }]
};

The Safety Zone with Rounded Corners

You may want to define rounded corners of the safety zone for some products. In this case, add the borderRadius property to the safetyLines definition.

productDefinition  = {
    surfaces: [{
        designFile: "sticker", 
        safetyLines: [{
            margin: 9,
            borderRadius: "10 20"
        }]
    }]
};

The borderRadius property takes a string containing space-separated values. As well as in the CSS format, you can specify up to four values for all the corners:

• borderRadius: "10" - one common radius for all four rounded corners.
• borderRadius: "10 20" - the upper-left and lower-right radiuses are 10, and the upper-right and lower-left radiuses are 20 points.
• borderRadius: "10 20 30" - the upper-left radius is 10; the upper-right and lower-left radiuses are 20; the lower-right radius is 30.
• borderRadius: "10 20 30 40" - the upper-left, upper-right, lower-right, and lower-left radiuses.

By default, these values are measured in points. Also, you can define them in percent of the width and height of the design: "20%". To apply arcs of ellipses to the rounded corners, you can specify the values as follows: "5/20". For example, borderRadius: "10 20 30/20 5%" is equivalent to the following widths and heights of ellipses:

• The upper-left corner: (10;20).
• The upper-right corner: (20;5%).
• The lower-right corner: (30;20).
• The lower-left corner: (20;5%).

The Editor Configuration

You can configure the safety lines' behavior both globally through the clientConfig.json file and for a single product through the IConfiguration interface. In the later case, you should pass the configuration to the loadEditor method.

If at least one safety line is specified for a surface, the Safety lines check box is displayed under Markings in the user interface.

This button allows the user to show and hide safety lines. You can disable this check box using the safetyLinesCheckboxEnabled configuration parameter to disallow your users to hide these lines. There are several other configuration parameters related to safety lines:

• safetyLineViolationWarningEnabled enables a warning displayed if a design element crosses a safety line.
• proofImageSafetyLinesEnabled draws safety lines on the proof images.
• proofImageCropSafetyLine sets the name of a safety line which proof images are cropped to; if there is no safety line with the given name, proof images are not cropped. For more information, see the Configuring High Resolution and Proof Images topic.
• alignToSafetyLineName sets the name of a safety line which design items can be aligned to; if there is no safety line with the name, then the first safety line in the array is used.

For example, let us enable the warning, crop proof images, and disallow for hiding the safety lines for a product.

productDefinition = {
    surfaces: [{
        designFile: "pocket_calendar", 
        safetyLines: [{
            name: "line1",
            margin: 9,
            color: "rgba(0,0,255,255)",
            altColor: "rgba(255,255,255,0)"
        }]
    }]
};

configuration = {
    widgets: {
        BottomToolbar: { safetyLinesCheckboxEnabled: false }
    },
    violationWarningsSettings: { safetyLineViolationWarningEnabled: true }
    rendering: { proofImageCropSafetyLine: "line1" }
};

CustomersCanvas.IframeApi.loadEditor(iframe, productDefinition, configuration);

Crop Marks

You can draw safety lines on proof images to verify that all elements are fit the safety zone. To specify bleed zones where the printed page should be cut off, you can draw crop marks. Customer's Canvas allows for drawing additional page information like an order number, a file name, a date, and more. Crop marks are shown on both proof images and hi-resolution outputs.

For details, you can refer to the Crop Marks topic.

The Trifold Example

Let us look at a real use case of setting up a flexible markup. For example, if you print trifold-brochures, then every printed page is folded into three parts. While designing such a product in Customer's Canvas, you can display safety lines for all three parts, folding lines, and the bleed zone with crop marks.

This is the proof image, so neither safety lines nor folding lines are printed on the resulting hi-res output. We applied the following settings for this markup.

productDefinition = {
    surfaces: [{
        width: 792, 
        height: 612,
        foldingLines: [{
            margin: "264",
            isVertical: true,
            pen: { color: "green", altColor: "green", width:2 }
        }, {
            margin: "528",
            isVertical: true,
            pen: { color: "green", altColor: "green", width:2 }
        }],
        printAreas: [{
            bounds: { x:0, y:0, width: 792, height: 612}, 
            cropMarks: [{
                margin: 8,
                length: 7,
                color: "black",
                topNotes: [
                    { fontSize: 7, alignment: "Left", text: "trifold-brochure.pdf", edgeMargin: 0.1 },
                    { fontSize: 7, alignment: "Center", text: '1/8" Bleed', edgeMargin: 0.1 }          
                ]
            }],
            safetyLines: [
                { margin: 9, color: "yellow", altColor: "yellow" },
                { leftRightMargin: 255, topBottomMargin: 9, color: "yellow", altColor: "yellow" },
                { leftRightMargin: 273, topBottomMargin: 9, color: "yellow", altColor: "yellow" }  
            ]
        }]
    }]
};

configuration = {
    rendering: {
        proofImageSafetyLinesEnabled: true
    },
    violationWarningsSettings: { safetyLineViolationWarningEnabled: false }
};

CustomersCanvas.IframeApi.loadEditor(iframe, productDefinition, configuration);

Note that margins, heights, and widths are in points. In this example, they define the 8.5" x 11" page with the 1/8" bleed zone.

Non-rectangular Products

You can easily set up safety lines and crop marks for rectangular products in the web-to-print editor as this topic describes. Alternatively, you can put bleed lines in a design template in Photoshop as shown in the following image.

Here, the red circle defines the safety zone. This layer has the <VNP> marker to show only in the editor. The black circle defines where your personnel should cut off this product. To hide a layer in the editor but at the same time print it on hi-res outputs, you can add the <VNS> marker to this layer in Photoshop.

However, when a product shape allows for applying the built-in functionality of Customer's Canvas, like rounded corners of the safety zone, do not include such lines in your templates. Editing the designer's configuration is more flexible than modifying your PSD files.

See Also

Manual

• Understanding Print Products
• Crop Marks
• Configuring High Resolution and Proof Images
• Supported Markers

IFrame API Reference

• ISafetyLine
• ICropMark