Orients coordinate labels based on the "up" direction of the drawing view. DrawingAbsolute or DrawingMarginOnly should always follow this module in the posModules section of the XML. This positioning module supports plan views only.
Usage in Label Template XML
<posModules>
<posModule value="DrawingCoordLblPosMod">
<orientation>1</orientation>
<granularity>1</granularity>
<positioningPoint>4</positioningPoint>
<labelOffset>0.04</labeloffset>
</posModule>
<posModule value="DrawingAbsolute">
<hOffset>-0.003</hOffset>
<vOffset>0.02</vOffset>
<angle>1.570796</angle>
</posModule>
</posModules>
Customization
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 |
granularity
Specifies a portion of the height of a label as the basis for the increment used to find clear space in which to position the label.
-
Type 0 to specify a Coarse setting. With a Coarse setting, the software searches an increment of exactly one width and height of the existing label in order to find clear space in which to place the new label.
-
Type 1 to specify a Medium setting. With a Medium setting, the software searches an increment of exactly one-half the width and height of the existing label.
-
Type 2 to specify a Fine setting. With a Fine setting, the software searches an increment of exactly one-third the width and height of the existing label.
1 - Label Offset
2 - Coarse setting
3 - Medium setting
4 - Fine setting
positioningPoint
Allows you to select a point within the range of a model object as the starting point. Starting at this specified point, the software searches for clear space in the quadrants in order to place a label.
The range of available options is indicated by colored dots in the following graphic. In the following image, the Positioning Point is shown placed in the TopRight position, and the Connect Point is shown placed in the MiddleRight position.
In the following image, the Positioning Point is shown placed in the TopRight position, and the Connect Point is shown placed in the MiddleRight position.
1 - Top Left |
The following options allow you to manually edit the .xml file.
-
Type 0 to place the point at the top left.
-
Type 1 to place the point in the top middle.
-
Type 2 to place the point at the top right.
-
Type 3 to place the point at the middle left.
-
Type 4 to place the point in the middle middle.
-
Type 5 to place the point at the middle right.
-
Type 6 to place the point at the middle left.
-
Type 7 to place the point in the bottom middle.
-
Type 8 to place the point at the bottom middle.
labelOffset
Allows you to specify the distance from a point placed on the model object to the farthest location from the point that the label can be placed.
Use the Label Offset property when you want to place the label within quadrants around the point. The point generator calculates the point. The software starts from the point location and looks outward to the limit of the Label Offset distance, and then begins looking for clear space within which to place the label.
1 - Label Offset |
Specify both the horizontal and vertical distances within which to place the label. Both distances must be the same.