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 |
Type 0 to place the dimension text value inside of the dimension line.
1 - View border |
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 |
---|---|---|
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, |
0 |
Auto |
1 |
Top |
|
2 |
Bottom |
|
3 |
Left |
|
4 |
Right |
|
Clear Space Margin with Dimensions, |
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 |