Clear Space Margin with Dimensions (DwgMatchlineWithDim) - Intergraph Smart 3D - Reference Data

Intergraph Smart 3D Drawings and Reports Reference Data

PPMProductFamily
3D Design and Visualization
PPMProduct
Intergraph Smart 3D
PPMCategory
Reference Data
Version_S3D
12.x(2018)

Positions labels and dimensions outside of the drawing matchline based on user-defined offsets.

Usage in Label Template XML

<posModules>
<posModule value="DwgMatchlineWithDim"/>
<dimension>-1</dimension>
<dimPerimeterOffset>0.02</dimPerimeterOffset>
<dimStyle>ANSI</dimStyle>
<dimTextOutside>-1</dimTextOutside>
<dimTextRotateClearance>0.002</dimTextRotateClearance>
<orientation>1</orientation>
<justification>-2</justification>
<angle>1</angle>
<clearance>0.003</clearance>
<perimeterOffset>0.01</perimeterOffset>
</posModules>

Customization

dimension

Specifies whether to place dimensions as part of the label rule.

Type -1 to place dimensions.

Type 0 to suppress dimensions.

dimPerimeterOffset

Determines the offset distance from the dimension to the matchline.

1 - Dimension Perimeter Offset

dimStyle

Defines the appearance of dimensions placed by the label rule.

Type any of the following styles.

  • ANSI: Applies a thin, solid, dark cyan line style with a filled arrow terminator to the leader line.

  • ANSI_FRACTIONAL: Applies a thick, solid, dark cyan line style with a filled arrow terminator to the leader line.

  • ANSI_NOARROW: Applies a thick, solid, dark cyan line style with no terminator to the leader line.

  • JIS: Applies a thick, solid, dark cyan line style with a large, open arrow terminator to the leader line.

  • ISO: Applies a thick, solid, dark cyan line style with a large, filled arrow terminator to the leader line.

  • DIN: Applies a thick, solid, dark cyan line style with a large, filled arrow terminator to the leader line.

  • ASA: Applies a thick, solid, dark cyan line style with a filled arrow terminator to the leader line.

  • BSI: Applies a thick, solid, dark cyan line style with a large, filled arrow terminator to the leader line.

The following examples demonstrate the ISO and JIS properties, respectively.

1 - ISO dimension style

1 - JIS dimension style

dimTextOutside

Controls the placement of dimension text values for margin dimensions in the right and bottom margins.

Type -1 to place the dimension text value outside of the dimension line.

1 - View border
2 - Dimension text value

Type 0 to place the dimension text value inside of the dimension line.

1 - View border
2 - Dimension text value

dimTextRotateClearance

Rotates the text of a dimension line 90 degrees when insufficient space exists for the text between the projection lines.

Specify the minimum clearance between the beginning or end of the dimension line text and the corresponding projection line. If the actual distance between the text and the projection line is less than the specified value, the software rotates the text 90 degrees relative to the dimension line.

Clearance of 0.01 m

In the above image, 0.01 m has been specified as the clearance between the end of the dimension line text and the projection line. Because the distance between the end of the dimension line text and the projection line is not at least 0.01 m, the text is not rotated.

Clearance of 0.002 m

In the above example, 0.002 m has been specified as the clearance between the end of the dimension line text and the projection line. Because the distance between the end of the dimension line text and the projection line is not at least 0.002 m, the text is rotated.

orientation

Allows you to specify the positional orientation of the label with respect to the labeled object.

Manual .xml edits depend on the module that you use, as follows.

Positioning Module

XML Value

Corresponding
Placement

Absolute XY Offset

1

Up

2

Down

3

Left

4

Right

Absolute Grid Margin

1

Top

2

Bottom

3

Left

4

Right

Clear Space Coordinate

0

Horizontal

1

Vertical

Clear Space Grid Horizontal

3

Left

4

Right

Clear Space Grid Margin

1

Top

2

Bottom

3

Left

4

Right

Clear Space Grid Vertical

1

Top

2

Bottom

Clear Space Margin with Dimensions,
used with non-linear point generator

0

Auto

1

Top

2

Bottom

3

Left

4

Right

Clear Space Margin with Dimensions,
only for Equipment

5

Longitudinal

6

Transversal

Point Generator

XML Value

Corresponding Placement

Local CS Origin with Object Axis

5

Longitudinal

Local CS Origin with Object Axis, only for Equipment

6

Transversal

justification

Determines whether to align labels inside or outside the available clear space.

The following example demonstrates a label as well as the text positioned inside clear space.

The next example shows the result when the label and text are positioned outside clear space.

The following options are available for manually editing the .xml file.

  • Type -2 to position the label and align the text outside the available clear space.

  • Type -1 to position the label outside the available clear space.

  • Type 0 to disable Justification.

  • Type 1 to position the label inside the available clear space.

  • Type 2 to position the label and align the text inside the available clear space.

angle

Controls the vertical, horizontal, or absolute angle of a label.

If you are using the Absolute XY Offset (DrawingAbsolute) positioning module, then type a floating point number as the value. You must type a number greater than negative pi/2 and less than or equal to positive pi/2. Additionally, you must set the value in radians, not degrees. The default value when you use this module is 0.0.

The following example demonstrates an Absolute setting.

1 - East label

2 - North Label

If you use the Clear Space Margin with Dimensions (DwgMatchlineWithDim) positioning module, then you can specify 0 to set a Horizontal angle or 1 to specify a Vertical angle. The default value when you use this module is 1.

The following example demonstrates a vertically placed label.

1 - Vertically placed label

The next example demonstrates a horizontally placed label.

1 - Horizontally placed label

clearance

Specifies the minimum distance separating adjacent labels.

1 - Clearance

If the labels in the current drawing use two separate templates that both define a Clearance, then the software uses the larger of the two Clearance values to separate adjacent labels.

perimeterOffset

Specifies either the distance from the edge of the view to the dimension line, or the distance from the edge of the view to the edge of the label that is closest to the view.

1 - Perimeter offset distance
2 - Dimension