Formulas extracting sheet information

The following formulas extract information about sheets in 1up and layout drawings.

Sheet name
Extracts From Formula
Layout $LayoutN.SheetName()$
1up $OneUpN.SheetName()$

NOTES: To see the name of the sheet you're using, right-click the sheet's edge, and then click Object Properties. The name appears in the Dimensions group dropdown list.

Sheet area
Extracts From Formula
1up OneUpN.SheetArea(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
1up OneUpN.Sheet(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
Layout LayoutN.SheetArea(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
Layout LayoutN.Sheet(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
  1. THE PARAMETERS
  2. Units: The measurement units in which >EngView will compute the result. To use the default units, leave the argument empty.
  3. CutBoxIfNoSheet: (Applies when the drawing does not have a sheet and the argument FallBackToStyle is No.) Extracts the area of the cut box. Values: Yes = extracts the area value, No = returns 0. No is the default and can be omitted.
  4. CutBox: Extracts the area of the cut box (the blue rectangle in the picture below). Values: Yes = extracts the cut box area value, No extracts the sheet area. No is the default and can be omitted.
  5. FallBackToStyle: (Applicable only if the drawing does not have a sheet but only objects in the Sheet style.) Values: Yes = extracts the bounding rectangle area of objects in the Sheet style. Most often these are drawings created outside >EngView — for example, in the .cf2 file format. No = >EngView does not look for objects in Sheet style; if there is no sheet, the formula returns 0, unless the CutBoxIfNoSheet argument is Yes. No is the default and can be omitted.
  6. Know your list separator: When typing a formula, make sure you separate its elements with your computer's list separator symbol. Yours may be different from the one used in this guide. Examples (in red):
    With Semicolon With Comma
    $Layout1.Length(Cutting; m; yes); n2$ $Layout1.Length(Cutting, m, yes), n2$

Cut box

  1. For 1up, the overall dimensions of the design (its bounding rectangle).
  2. For layout, the overall dimensions of all parts (marked in blue):

Examples

To print the sheet area (when there is a sheet) of
Extracts From Units Precision Use Example
Layout1 Default Default $Layout1.SheetArea()$ 1.52
Layout1 sq. cm. 0 $Layout1.SheetArea(cm); n0$ sq. cm. 15225 sq. cm.
 
To print the area of a bounding rectangle formed by objects in the Sheet style when there is no actual sheet
Layout1 Default 3 $Layout1.SheetArea( ; ; ; yes); n3$ 1.08
 
To print the area of the cut box
Layout1 Default Default $Layout1.SheetArea( ; ; yes)$ 0.94
Sheet width and height
Extracts From 1up Layout
Sheet Width
(horizontal sheet distance)		 OneUpN.SheetWidth(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle) LayoutN.SheetWidth(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
Sheet Height
(vertical sheet distance)		 OneUpN.SheetHeight(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle) LayoutN.SheetHeight(Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
  1. THE PARAMETERS
  2. Units: The measurement units in which EngView will compute the result. To use the default units, leave the argument empty.
  3. CutBoxIfNoSheet: (Applies when the drawing does not have a sheet and the argument FallBackToStyle is No.) Values: Yes = extracts the width/height value of the cut box, No = returns 0. No is the default and can be omitted.
  4. CutBox: Extracts the width/height of the cut box. Values: Yes = extracts the width/height value of the cut box; No = extracts the sheet's width/height. No is the default and can be omitted.
  5. FallBackToStyle: (Applicable only if the drawing does not have a sheet but only objects in the Sheet style.) Values: Yes = extracts the width/height of the bounding rectangle formed by objects in the Sheet style. Most often these are drawings created outside EngView — for example, in the .cf2 file format. No = EngView does not look for objects in Sheet style; if there is no sheet, the formula returns 0, unless the CutBoxIfNoSheet argument is Yes. No is the default and can be omitted.
  6. Know your list separator: When typing a formula, make sure you separate its elements with your computer's list separator symbol. Yours may be different from the one used in this guide. Examples (in red):
    With Semicolon With Comma
    $Layout1.Length(Cutting; m; yes); n2$ $Layout1.Length(Cutting, m, yes), n2$

Cut box

  1. For 1up, the overall dimensions of the design (its bounding rectangle).
  2. For layout, the overall dimensions of all parts (marked in blue):

Examples

To print a sheet's width/height, when there is an actual sheet
Extracts From Units Precision Use Example
Layout1 Default Default $Layout1.SheetWidth()$ 1450.00
Layout1 Default Default $Layout1.SheetHeight()$ 1050.00
Layout1 Meters 2 $Layout1.SheetWidth(m); n2$ m 1.45 m
 
To print the width/height of a bounding rectangle formed by objects in the Sheet style, when there is no actual sheet
Layout1 Default 1 $Layout1.SheetWidth( ; ; ; yes); n1$ 1269.0
 
To print the width/height of the cut box
Layout1 Default Default $Layout1.SheetWidth( ; ; yes)$ 1169.00
Sheet dimensions as measured along/against the flute direction

The formulas that follow return the sheet's dimensions as measured along or against the material's flute direction. For example, if a formula is configured to measure along the flute direction and the flute goes left to right, the formula will return the sheet's horizontal dimension; when the flute direction goes top to bottom, the same formula will return the vertical dimension.

IMPORTANT: Do not think of these dimensions as width or height: the flute direction is what determines the measurements.

TO CHECK THE FLUTE DIRECTION: To check the flute direction, go to the respective drawing and look at the flute direction icon in the upper left corner of the graphical area. The arrow there indicates the flute direction or check the drawing's properties.

The formula patterns

Sheet distances by flute direction
1up OneUpN.SheetSize(direction, Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
Layout LayoutN.SheetSize(direction, Units, CutBoxIfNoSheet, CutBox, FallBackToStyle)
  1. THE PARAMETERS
  2. Direction: Must be specified. Extracts sheet distances with respect to the material's flute direction. Use fd() to extract along the flute's direction; use fd()+90 to extract against the flute direction.
  3. Units: The measurement units in which EngView will compute the result. To use the default units, leave the argument empty.
  4. CutBoxIfNoSheet: (Applies when the drawing does not have a sheet and the argument FallBackToStyle is No.) Extracts the distance of the cut box along/against the flute direction. Values: Yes = extracts the distance, No = returns 0. No is the default and can be omitted.
  5. CutBox: Extracts the distance of the cut box along/against the flute direction. Values: Yes = extracts the distance; No = extracts the sheet distance along/against the flute direction. No is the default and can be omitted.
  6. FallBackToStyle: (Applicable only if the drawing does not have a sheet but only objects in the Sheet style.) Values: Yes = extracts the bounding rectangle distance along/against the flute direction defined by objects in the Sheet style. Most often these are drawings created outside EngView — for example, in the .cf2 file format. No = EngView does not look for objects in Sheet style; if there is no sheet, the formula returns 0, unless the CutBoxIfNoSheet argument is Yes. No is the default and can be omitted.
  7. Know your list separator: When typing a formula, make sure you separate its elements with your computer's list separator symbol. Yours may be different from the one used in this guide. Examples (in red):
    With Semicolon With Comma
    $Layout1.Length(Cutting; m; yes); n2$ $Layout1.Length(Cutting, m, yes), n2$

Cut box

  1. For 1up, the overall dimensions of the design (its bounding rectangle).
  2. For layout, the overall dimensions of all parts (marked in blue):

Example: How flute direction affects the sheet dimensions

To print the sheet distances
Drawing Flute Direction Units Precision Use Example fdY Example fdX
Layout1 Along Default Default $Layout1.SheetSize(fd())$ 700.00 1000.00
Layout1 Against Default Default $Layout1.SheetSize(fd()+90)$ 1000.00 700.00
 
To print the distances of a bounding rectangle formed by objects in the Sheet style (when there is no sheet)
Layout1 Along Default 1 $Layout1.SheetSize(fd(); ; ; ; yes); n1$ 700.00 1000.00
Layout1 Against Default 1 $Layout1.SheetSize(fd()+90; ; ; ; yes); n1$ 1000.00 700.00
 
To print the distances of cut box
Layout1 Along Default Default $Layout1.SheetSize(fd(); ; ; yes)$ 459.00 718.00
Layout1 Against Default Default $Layout1.SheetSize(fd()+90; ; ; yes)$ 718.00 459.00
Sheet margins

The formulas that follow display the distances between the endmost cutting rules and the sheet's edges for 1up and layout drawings.

Margin 1up Layout
Left OneUpN.SheetLeftMargin(Units, SkipInlinerObjects, FallBackToStyle) LayoutN.SheetLeftMargin(Units, SkipInlinerObjects, FallBackToStyle)
Right OneUpN.SheetRightMargin(Units, SkipInlinerObjects, FallBackToStyle) LayoutN.SheetRightMargin(Units, SkipInlinerObjects, FallBackToStyle)
Upper OneUpN.SheetTopMargin(Units, SkipInlinerObjects, FallBackToStyle) LayoutN.SheetTopMargin(Units, SkipInlinerObjects, FallBackToStyle)
Lower OneUpN.SheetBottomMargin(Units, SkipInlinerObjects, FallBackToStyle) LayoutN.SheetBottomMargin(Units, SkipInlinerObjects, FallBackToStyle)
  1. THE PARAMETERS
  2. Units: The measurement units in which EngView will compute the result. To use the default units, leave the argument empty.
  3. SkipInlinerObjects: Values: Yes = Extracts the distances between the endmost non-inliner objects and the sheet's edges for 1up and layout drawings; No = takes into account the inliner objects. See an example. No is the default and can be omitted.
  4. FallBackToStyle: (Applicable only if the drawing does not have a sheet but only objects in the Sheet style.) Values: Yes = extracts margins computed by the bounding rectangle of objects in the Sheet style. Most often these are drawings created outside EngView — for example, in the .cf2 file format. No = EngView does not look for objects in Sheet style; if there is no sheet, the formula returns 0. No is the default and can be omitted.
  5. Know your list separator: When typing a formula, make sure you separate its elements with your computer's list separator symbol. Yours may be different from the one used in this guide. Examples (in red):
    With Semicolon With Comma
    $Layout1.Length(Cutting; m; yes); n2$ $Layout1.Length(Cutting, m, yes), n2$

INLINER OBJECTS: Objects in styles to which any of the following production processes has been set: Creasing Wheel, Glue/adhesive tape wheel, Tear strip wheel, Reinforcement tape wheel, Half-cutting wheel, Cutting Wheel, Slot cutting. See an example.

Examples

To print sheet margins

NOTE: Applicable if there is a sheet.

To print sheet margins
Margin to print Use, in Layout1 Example
Left $Layout1.SheetLeftMargin()$ 141.00
Right $Layout1.SheetRightMargin(cm); n1$ cm 14.1 cm
Upper $Layout1.SheetTopMargin(); n0$ 231
Lower $Layout1.SheetBottomMargin()$ 10.00

To print margins of a bounding rectangle formed by objects in the Sheet style when there is no sheet

To print margins of a bounding rectangle formed by objects in the Sheet style
Margin to print Use, in Layout1 Example
Left $Layout1.SheetLeftMargin( ; ; yes)$ 30.00
Right $Layout1.SheetRightMargin(cm; ; yes); n1$ cm 3.0 cm
Upper $Layout1.SheetTopMargin( ; ; yes); n0$ 20
Lower $Layout1.SheetBottomMargin( ; ; yes)$ 15.00

Margins for inliner products

The above structure will be produced on an inliner machne. That is why, the objects that will be processed will be in styles to which the production processes Cutting wheel, Creasing wheel and Slot cutting have been assined. The rest of the objects — in this case, objects in the Cutting style — will be die-cut. These objects are selected (in pink). To extract the distance from the edge of the sheet to the non-inliner objects, use the formulas as follows:

To print margins
Margin Sheet Use (Layout1) Example
Right Yes $Layout1.SheetRightMargin( ; yes)$ 127.50
Upper Yes $Layout1.SheetTopMargin(cm; yes); n1$ cm 21.3 cm
Right Objects in Sheet style $Layout1.SheetRightMargin( ; yes; yes)$ 127.50
Upper Objects in Sheet style $Layout1.SheetTopMargin(cm; yes, yes); n1$ cm 21.3 cm