Formulas extracting areas

The following formulas extract areas in 1up and layout drawings.

Formulas that extract areas including closed contours (holes)

The formulas

Extracts From Formula
1up OneUpN.Area(units; StyleName)
Layout LayoutN.Area(units; StyleName)
  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. StyleName: The style of the objects that form closed contours. If no style is specified, EngView applies the Cutting style.
  4. 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$

Examples

The examples that follow show you how to write formulas for extracting the areas formed by closed contours and set formatting for the results. The examples refer to areas in a 1up drawing and in a Layout1 predefined area.

To print the area Extracts From In style Units Use Example
A closed contour OneUp1 Cutting, incl. child styles default $OneUp1.Area()$ 0.19
A closed contour OneUp1 Cutting, incl. child styles sq. cm. $OneUp1.Area(cm)$ sq. cm. 1876.64 sq. cm.
Closed contour Layout1 Cutting, incl. child styles sq. m. $Layout1.Area(m); n3$ sq. m. 0.375 sq. m.
Area defined by objects Layout1 Plotting Default $Layout1.Area( ; Plotting)$ 0.39
Area defined by objects Layout1 Plotting Sq. m. $Layout1.Area(cm; Plotting)$ sq. cm. 3875.43 sq. cm.
Formulas that extract areas by excluding closed contours (holes)

The formulas

Extracts From Formula
1up OneUpN.AreaEx(excludeHoles; Units; StyleName)
Layout LayoutN.AreaEx(excludeHoles; Units; StyleName)
  1. THE PARAMETERS
  2. excludeHoles Controls whether EngView should exclude the combined area of closed contours (holes). Values: Yes = excluded; No = included (identical with the result of the Area() function). Instead of Yes, you can use also true or 1; instead of No, you can use false or 0.
  3. Units: The measurement units in which EngView will compute the result. To use the default units, leave the argument empty.
  4. StyleName: The style of the objects that form closed contours. If no style is specified, the Cutting style is used.
  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$

Examples

The examples that follow show you how to write formulas for extracting the areas formed by closed contours excluding holes areas and set formatting for the results. The examples refer to areas in a 1up drawing and in a Layout1 predefined area.

To print the area of Extracts From In style Units Use Example
A closed contour OneUp1 Cutting, incl. child styles Default $OneUp1.AreaEx(yes)$ 0.16
Closed contour OneUp1 Cutting, incl. child styles Sq. cm. $OneUp1.AreaEx(yes; cm)$ sq. cm. 1876.64 sq. cm.
Area defined by objects Layout1 Plotting Default $Layout1.AreaEx(yes; ; Plotting)$ 0.33
Area defined by objects Layout1 Plotting Sq. cm. $Layout1.AreaEx(yes; cm; Plotting)$ sq. cm. 3286.09 sq. cm.
Formulas that extract the areas of holes in 1up and layout drawings

The formulas

Extracts From Formula
1up OneUpN.AreaHoles(units; StyleName)
Layout LayoutN.AreaHoles(units; StyleName)
  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. StyleName: The style of the objects that form holes (inner closed contours). If no style is specified, the Cutting style and its child styles are used. IMPORTANT: When citing a style, make sure your drawing includes at least two closed contours in the cited style, of which the second one is enclosed in the first. This makes EngView treat the internal contour as a hole and extracts information about it.
  4. 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$

Examples

To print the area of Extracts From In style Units Use Example
Holes OneUp1 Cutting style, incl. child styles Default $OneUp1.AreaHoles()$ 0.03
Holes OneUp1 Cutting style, incl. child styles sq. cm. $OneUp1.AreaHoles(cm)$ sq. cm. 307.32 sq. cm.
Holes Layout1 Cutting Default $Layout1.AreaHoles(); n3$ 0.061
Holes Layout1 Perforating Default $Layout1.AreaHoles( ; Perforating)$ 0.04

See the general rules for how to write formulas and format formula results.