Positions label at an absolute offset from a linear object, such as a structural member. This positioning module is used with the Structural Widget (StructuralWidgetLabelContent) content module.
Usage in Label Template XML
<posModules>
<posModule value="DwgLinearAbsPos">
<percentageOffset>0.50</percentageOffset>
<offsetFromMember>0.01</offsetFromMember>
<offsetFromWidget>-1</offsetFromWidget>
</posModule>
</posModules>
Customization
percentageOffset
Determines the label position along the length of a linear object, such as a structural member.
-
The following graphic illustrates a label with Percentage Offset set to 20.
-
The following graphic illustrates a label with Percentage Offset set to 50.
The following options are available for manually editing the .xml file.
-
Type 0 to place the label at the bottom left of the object.
-
Type 1 to place the label at the top right of the object.
-
Type a decimal value to place the label at a fractional point.
offsetFromMember
Specifies the perpendicular distance to offset the label away from a linear object, such as a structural member. A positive value places the label above or left of the centerline, while a negative value places the label below or right of the centerline.
The following graphic demonstrates the offsetFromMember property with an offset distance from the structural member of 0.01 m specified.
The next graphic demonstrates the offsetFromMember property with an offset distance from the structural member of 0.003 m specified.
offsetFromWidget
Determines the method of positioning the label offset. Type 0 to always offset the label from the object centerline. Type -1 to offset the label from the edge of the widget when the label and widget coincide and from the object centerline when they do not coincide. The value of offsetFromMember is used for the offset.
1 - offsetFromWidget with a value of -1 |
Examples
percentageOffset is 0.5, offsetFromMember is 0.01, and offsetFromWidget is 0:
percentageOffset is 0.5, offsetFromMember is 0.01, and offsetFromWidget is -1: