Determines both the clear space position of grid labels that are placed in the margin as well as the end of the object relative to which the software should place the label.
Labels that are placed outside of the matchline and in clear space use the breakline settings as well as the perimeterOffset setting. The SMDwgPositionGridLblMarginOnly module then places grid labels at a perimeterOffset value in the margin. The orientation of the margin is determined by the orientation tag, as in the .xml example below.
The Absolute Grid Margin (DrawingGridLblMgnAbsPos) module must follow this positioning module in the <posModules> section. For more information, see Absolute Grid Margin (DrawingGridLblMgnAbsPos).
Usage in Label Template XML
<label>
<posModules>
<posModule value="SMDwgPositionGridLblMarginOnly"/>
<orientation>2</orientation>
<granularity>1</granularity>
<maxOffset>0.05</maxOffset>
<minOffset>0.01</minOffset>
<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.
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 |
minOffset
Defines the minimum distance from a connection point that you can place a label.
1 - Minimum 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 |
Examples
1: 2: |
1: 2: |