Element Constraints
- Last UpdatedApr 18, 2023
- 9 minute read
Constraints are concepts which constrain the placement of annotations.
A constraint is hard or soft. A hard constraint must comply with the AVEVA E3D Whitespace Optimizer settings, setting the allowable (Sheet) area where the annotation can be placed. A soft constraint defines areas where the annotation is best placed within the (hard constraint) defined areas of the Sheet using the AVEVA E3D Whitespace Optimizer settings.
The element constraints can be defined for an individual annotation element by the Element Style unless superseded by Template Settings or user-defined explicit values.

The Element constraints tab displays a list of available element constraint styles. Input values in the fields or select values from the drop-down lists to modify the element constraints.
Right-click on an element constraint style and select Rename from the drop-down menu to rename the element constraint style.
If required, enter a Description for the element constraint style.
The Attribute Hint part of the window displays a hint to the constraints functionality.
Element constraints can be specified By Style, which inherits the value from the selected element constraints style. Refer to Assigned References for further information.
Element constraints can be spec.ified By Template, which inherits the value from the symbol template constraints. Refer to Template Constraints for further information.
Element constraints can be specified Use Generic, which inherits the value from the generic constraints settings. Refer to Generic Constraints for further information.
For example:
-
If an element is set to By Template and the template is set to Unset, the WESTYL is used.
-
If an element is set to By Template and the template is set to Use Generic, the generic constraints are used.
-
If the WESTYL is referenced (directly or via the template) and the WESTYL is set to Use Generic, the generic constraints are used.
Anno Intersections Allowed
Specifies the limitations for annotation intersections:
-
False, the annotation is not allowed to be intersected by other connection lines.
-
CONL Only, only the connection line part of the annotation is allowed to be intersected by other connection lines.
-
True, the annotation as a whole (both its main geometry and connection lines) is allowed to be intersected by other connection lines.
The following element types support this option:
-
TEXP, SYMB, GRDRLR - only True/False values are available.
-
VIEW - only True/False values are available, and the setting only controls how the matchline text of the view is treated (the matchlines and the frame of the view are always treated as a CONL of family ‘Other’).
-
SLAB/GLAB - all three (True/False/CONL Only) values are available.
For all other element types this option is not configurable.
The option is also available on templates (SYTM, TXTM, ISOTM) and WESTYL (all three values, True/False/CONL Only are available). The default value for this setting is False (for WESTYL).
If an element does not support the CONL Only value (TEXP), but is set to (for example) ByStyle and references a WESTYL that is set to CONL Only, even though the setting value for this element evaluates to CONL Only, because the element has no CONLs, it is treated by the AVEVA E3D Whitespace Optimizer as if evaluated to False.
Example A

Labels B, C and D are set to False. Label FV 117 and the MATCHLINE E 505950 text are set to False, no intersections are allowed.
Example B

The settings are the same as example A with the exception of label B. Label B is set to CONL Only, which allows an intersection with label FV 117.
Example C

The settings are the same as example B with the exception of the MATCHLINE E 505950 text which is set to True, which allows intersections with labels C and D.
Dog Leg Creation/Removal
Dog leg annotations can be calculated in the following ways:
|
Setting Combinations |
||||
|
Creation allowed |
False |
False |
True |
True |
|
Removal allowed |
False |
True |
False |
True |
|
Resulting Condition |
||||
|
Straight Annotation |
Must be straight |
Must be straight |
Prefer straight |
Prefer straight |
|
Dog leg annotation |
Must be dog leg |
Prefer dog leg |
Must be dog leg |
Prefer dog leg |
|
Leader line restriction |
Specifies a limitation on the leader line direction. Select True from the drop-down list to restrict the leader line from doubling back on itself when the whitespace calculation is performed. The example displays a leader line that is doubling back on itself.
Select False from the drop-down list to omit the leader line restriction when the whitespace calculation is performed. |
|
Minimum AP distance |
Specifies the preferred minimum annotation label distance for SLAB/GLAB and LDIM, measured from the attachment point. Input a value in the field or select a value from the drop-down list to modify the minimum annotation label distance. |
|
Optimal insertion dist. |
Input a value in the field or select a value from the drop-down list to define the preferred connection line length (applied to a SLAB/GLAB). The value works in conjunction with optimize connection line length. The value also controls the distance penalty for other placement modes. The example displays three annotations all with a preferred connection line length value of 30mm. |
|
|
|
|
Placement direction |
Limits the movement of annotations to a single direction which is determined by the Angle value. |
|
Angle |
Input a value in the field or select a value from the drop-down list to specify the annotation movement plane. For example, input a value of 90deg to limit the movement of annotations to a vertical plane (up or down). Select By element from the drop-down list to calculate the label placement angle from the direction of the model element it is attached to. This setting is subject to further element implementation rules. |
|
Intervals (user) |
Input a value in the field to limit the annotation movement distance along the direction line, measured from the starting point. For example, input a value of -20:20 to allow the annotation to move -20mm to +20mm along the direction line. Select By element from the drop down list to calculate the label placement from the key points of the model element it is attached to. |
|
Placement mode |
Select Don’t Move from the drop-down list to effect no modification to the annotation position when the whitespace calculation is performed. Note: Select Prefer original position from the drop-down list to specify that the annotation should remain in the original position. The annotation moves only when a better position is calculated that is close enough to the original position using the defined Whitespace objective preferences. Select optimize connection line length from the drop-down list to specify that the annotation uses the Optimal insertion dist. value as a preference. Select Free from the drop-down list to specify that the annotation is moved to the optimal position on the drawing canvas. Annotations are positioned as near to the original position as possible. There is no distance penalty and the distance from the original position is less important than any other constraint. For example, a Free label will prefer to be 200mm from its original position if it satisfies its XA configuration. (Rather than being 5mm from its original position and violating XA configuration, even if the violation is worth only 0.01 penalty points.) If white space is limited on the drawing canvas, Free annotations always give way to annotations with other placement modes. |
|
Placement priority |
Input a value in the field or select a value from the drop-down list to define the annotation placement priority. For example, It may be preferable to have a certain label type optimized first and then another type second, to increase the likelihood of the first label types criteria being met when the whitespace calculation is performed. The higher the value, the more important it is to place the annotation in the optimal position when the whitespace calculation is performed. This may be at the cost of placing another annotation, with a lower value, in a worse position than it would have been placed if both the annotations had the same priority. |
|
Relation to view |
Select No preference from the drop-down list to specify that the annotation can be positioned both inside and outside of the owning VIEW/REGN element boundary. Select Inside preferred from the drop-down list to specify that the preferred annotation position is inside of the owning VIEW/REGN element boundary. The annotation can be positioned outside of the owning VIEW/REGN element boundary when other constraints are non compliant. Select Must be inside from the drop-down list to specify that the annotation must be positioned inside of the owning VIEW/REGN element boundary. Select Outside preferred from the drop-down list to specify that the preferred annotation position is outside of the owning VIEW/REGN element boundary. The annotation can be positioned inside of the owning VIEW/REGN element boundary when other constraints are non compliant. Select Must be outside from the drop-down list to specify that the annotation must be positioned outside of the owning VIEW/REGN element boundary. The calculated annotation positions are also dependent on other AVEVA E3D Whitespace Optimizer settings. Refer to Relation to View Rules for further information. |
|
Preferred sides |
The functionality becomes available if outside preferred or Must be outside is selected from the Relation to view drop-down list. Select the required check boxes from the drop-down list to define the available annotation positioning settings. The calculation can be a combination of any of the following: Top, Right, Bottom, Left. At least one check box must be selected. Note: |
|
X-Angs |
Displays the preferred annotation connection line angles. Select None from the drop-down list to omit a preferred angle for annotation connection lines. When None is selected from the drop-down list, the Expected angle 1 field becomes active which allows you to define a preferred annotation connection line angle. |
|
Expected angle 1 |
Input a value in the field to define the preferred angle for annotation connection lines. |
|
+Angle Deviation |
Input a value in the field to define an acceptable positive angle deviation from the expected angle.
|
|
-Angle Deviation |
Input a value in the field to define an acceptable negative angle deviation from the expected angle.
|
|
Angle Penalty |
Input a percentage value in the field to set the angle penalty. |
|
Deviation Penalty |
Input a percentage value in the field to set the deviation penalty. |
|
Expected angle 2 |
The field is created when the Expected angle 1 field is populated. The process is repeated allowing you to create multiple expected angles. |



