Functions extracting length

Use these functions to extract lengths by style.

The functions

Extracting From
  The Active Drawing Drawing Specified By
System Name User-Defined Name
Length Length(StyleName, units, no/yes) OneUpN.Length(StyleName, units, no/yes) "DrawingName".Length(StyleName, units, no/yes)
LayoutN.Length(StyleName, units, no/yes)

Syntax note and examples

  1. SYNTAX NOTE
  2. StyleName: The style of the objects whose length you want to extract.

    TIP: To extract the total length of all objects in all styles, leave the argument empty. In this case, the result always includes the lengths of objects in child styles.

  3. Units: The measurement units in which Prinect will compute the result. To use the default units, leave the argument empty.
  4. No/Yes (Applies when you have supplied a style name.) Controls whether the combined length of all child styles the selected style should be included. Yes = added; No = not added. For example, the formula $Length(Creasing; m; yes)$ returns the combined lengths of all objects in the Creasing style and its child styles. Instead of Yes, you can use also true or 1; instead of No, you can use false or 0. If a function does not contain an argument, this means that No is used.
  5. List separator: When typing a formula, make sure you separate its arguments 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.Area(m; Plotting); n2$ $Layout1.Area(m, Plotting), n2$

The following examples demonstrate how the arguments work.

Styles Units Child Styles Drawing Function
All Meters Always Included Active Length( , m)
All Millimeters Not Included Specified by User-Defined Name "Body".Length( , mm)
All Default Included Specified by System Name Layout1.Length(, yes)
Creasing Decimeters Included Active Length(Creasing, dm, yes)