---
title: "ISafetyLine Interface"
canonical: https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.objectmodel.isafetyline.htm
archived: true
applies_to:
  - product: "Customer's Canvas On-Premises"
  - product: "Design Editor"
    versions: ["4.4.25", "4.x (may differ)"]
---

**You’re viewing outdated documentation.** [View the latest Customer’s Canvas On-Premises documentation](https://customerscanvas.com/docs/on-premises/).

# ISafetyLine Interface

**Applies to:** Customer's Canvas On-Premises; Design Editor 4.4.25, 4.x (may differ) · **Archived documentation**
 
A structure holding settings for a safety line. For details, see the [Safety Lines](https://customerscanvas.com/docs/cc4/safety-lines.htm.md) topic.
  
 - example
     - ```
// Defining the product.
var w = 720, h = 504; // in points (1 point = 1/72 inch)

var emptyProduct = {
    surfaces: [{
        width: w,
        height: h,
        printAreas: [{
            bounds: {
                x: 0,
                y: 0,
                width: w,
                height: h
            },
            safetyLines: [{
                margin: 8.5,
                color: 'rgba(0,255,0,1)',
                borderRadius: "10",
                stepPx: 5,
                widthPx: 1 
            }]
        }]
    }]
};
```
 
## Properties
 
### Optional altColor
 
altColor: string

The alternate color; a CSS-style color value. The default value is `"rgba(0,0,0,255)"`.
 
### Optional borderRadius
 
borderRadius: string

The definition of rounded corners in the CSS format. You can set up the radius in points, in percent, or through the width and height of ellipses. By default, the safety zone is not rounded.
 
### Optional color
 
color: string

The main color; a CSS-style color value. The default value is `"rgba(255,255,255,255)"`.
 
### Optional leftRightMargin
 
leftRightMargin: number

*Outdated, use the **margin.horizontal** property instead*. The left and right margins - the distance of a safety line from the left and right borders of the print area.
 
### Optional margin
 
margin: number  |  [IMarginHV](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.objectmodel.imarginhv.htm.md)  |  [IMarginLTRB](https://customerscanvas.com/docs/cc4/customerscanvas.iframeapi.objectmodel.imarginltrb.htm.md)

The distance between a safety line and the print area bounds, in points. The default value is `10`.
 
### Optional name
 
name: string

The name of the safety line.
 
### Optional stepPx
 
stepPx: number

The dash length in pixels; the safety line is always a dashed line. The default value is `10`px.
 
### Optional topBottomMargin
 
topBottomMargin: number

*Outdated, use the **margin.vertical** property instead*. The top and bottom margins - the distance of a safety line from the top and bottom borders of the print area.
 
### Optional widthPx
 
widthPx: number

The line width, in pixels. The default value is `1`px.