Positions horizontal grid labels to the left or right of a drawing view. The Orientation tag under labelSettings determines whether the labels are positioned on the left or right side. A value of 3 positions the labels on the left side, while a value of 4 positions the labels on the right side. DrawingGridLblMarginOnly and DrawingGridLblMgnAbsPos must follow this positioning module in the posModules section.
Usage in Label Template XML
<label>
<labelSettings>
<orientation>4</orientation>
<granularity>1</granularity>
<maxOffset>0.05</maxOffset>
<minOffset>0.01</minOffset>
</labelSettings>
...
<posModules>
<posModule value="DrawingGridLblHoriz"/>
<posModule value="DrawingGridLblMarginOnly"/>
<posModule value="DrawingGridLblMgnAbsPos"/>
</posModules>
</label>
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
maxOffset
Defines the maximum distance from a connection point that you can place a label.
1 – Maximum Offset |
minOffset
Defines the minimum distance from a connection point that you can place a label.
1 - Maximum Offset in X direction |