Places a label at an absolute position along the 2D curve. This is similar to the Clear Space Position by 2D Curve (ISDwgPositionByCurve2D) positioning module, but does not use clear space. The absolute position is the point created by the point generator used in the label template. The orientation of the label is set from the point, relative to the 2D curve, and is controlled by the parameters.
This module can be used as the last positioning module in a label template. It will
position the label when other clear space positioning modules cannot find a location.
Usage in Label Template XML
<label>
<posSettings>
<posModulesSets>
<posModulesSet>
<connectPoint>4</connectPoint>
<positioningPoint>4</positioningPoint>
<posModules>
<posModule value="ISDwgAbsolutePositionByCurve2D">
<angle>0</angle>
<anchor>1</anchor>
<hOffset>0.0</hOffset>
<vOffset>0.0</vOffset>
</posModule>
</posModules>
</posModulesSet>
</posModulesSets>
</posSettings>
<\label>
Customization
angle
Orientation of the label.
|
XML value |
||
|---|---|---|
|
Tangent Tangent to a curve |
|
0 |
|
Normal Out Along outward normal |
|
1 |
|
Normal In Along inward normal |
|
2 |
|
Horizontal |
|
3 |
|
Vertical |
|
4 |
|
Default Orientation |
|
5 |
|
Uses the orientation from the content module |
||
anchor
The point on the label used for positioning.
|
|
XML value |
|
|---|---|---|
|
Treat as Label |
|
0 |
|
Uses a key point on the bounding box of the label, as specified by the connect point property in posModulesSet. |
||
|
Treat as Symbol |
|
1 |
|
Uses the origin of the symbol. |
||
|
Use Connect Point Similar to 0 (Treat as Label) but uses a key point specified by the connect point property defined directly in this module. |
2 |
|
connectPoint
Specifies the position of the label relative to the key point on the text bounding box and used with the anchor property. The default value is 4 (Middle Middle).
|
Key Points |
|
|---|---|
|
0 |
Top Left |
|
1 |
Top Middle |
|
2 |
Top Right |
|
3 |
Middle Left |
|
4 |
Middle Middle |
|
5 |
Middle Right |
|
6 |
Bottom Left |
|
7 |
Bottom Middle |
|
8 |
Bottom Right |
-
Use the connect point in this module in the same way that you use the positioning point in the posModuleSet positioning module.
-
You can use the value of the connect point defined in the posModulesSet positioning module by using 0 (Treat as Label) for anchor or define the value directly in this module by using 2 (Use Connect Point) for anchor.
-
positioningPoint in the posModulesSet positioning module is not used by this module even when you have defined that parameter.
hOffset
Horizontal distance of the label from the positioning point. This value is measured in meters. The default value is 0.00.
vOffset
Vertical distance of the label from the positioning point. The software measures this value in meters. The default value is 0.00.
This module also uses the minFactor and maxFactor parameters. For more information, see Label Templates XML Overview.
Examples
For the labels in the following example, Angle is 0 and Anchor is 0 (using connectPoint 4 in posModulesSet)
The location of the profile thickness symbols change in the following examples based on the parameters.
|
hOffset is 0 vOffset is 0 angle is 0 (Tangent) |
|
|
hOffset is 0.01 vOffset is 0.03 angle is 0 (Tangent) |
|
|
hOffset is 0 vOffset is 0 angle is 3 (Horizontal) |
|
Although a content module creates the annotation output, this example shows how this
module affects the output.