Positions grid labels that are placed in the margin. Places grid labels at a perimeter offset value in the margin determined by the orientation tag. The perimeter is defined by the drawing volume. Absolute Grid Margin (DrawingGridLblMgnAbsPos) must follow this positioning module in the posModules section.
Usage in Label Template XML
<label>
<posModules>
<posModule value="DrawingGridLblMarginOnly"/>
<orientation>2</orientation>
<granularity>1</granularity>
<maxOffset>0.05</maxOffset>
<perimeterOffset>0.01</perimeterOffset>
</posModule>
<posModule value="DrawingGridLblMgnAbsPos"/>
<orientation>2</orientation>
</posModule>
</posModules>
</label>
Customization
orientation
Allows you to specify the positional orientation of the label with respect to the labeled object.
Use 1 to place the label in the top margin, 2 to place the label in the bottom margin, 3 to place the label in the left margin, or 4 to place the label in the right margin.
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 – Perimeter Offset |
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 |