The entity attribute AllowJointWhenOverlapping determines the behavior of joints between overlapping items.
By default, the attribute is automatically created for all entities through the Automatic Creation property, remaining hidden and with the value False.
Possible values:
- False: prevents the execution of joints between overlapping items.
- True: allows the execution of joints between overlapping items.
To enable this behavior, set the attribute value to True on the components involved in the joints.
Example:
Consider cabinet sides that, when positioned side by side, undergo a joint and are replaced by a divider.
In the images below, you can observe the difference in behavior according to the configuration of the AllowJointWhenOverlapping attribute:
- On the left: with the attribute set to False or not applied (since its default value is False), the sides remain unchanged when there is overlap between the modules (with the Collision option disabled), and the joint is not executed.
- On the right: with the attribute set to True, the joint is executed even with the modules overlapping. In this case, the cabinet side that performed the overlap is removed, while the side of the overlapped cabinet is replaced by the divider.
IMPORTANT: the gap shown in the image on the right occurs because the joint was registered considering the subtraction of the side thickness, so that its execution happens only when the sides are touching, not overlapping. To eliminate this space, it is necessary to adjust the clearance in the module insertion parameters.
The AllowJointWhenOverlapping attribute is also used in scenarios involving through hardware.
When the contact areas of the hardware meet, they can be unified and converted into a through hardware. However, in some situations, these areas may overlap instead of just touching.
In these cases, the joint behavior is defined by the attribute value:
- False: the joint is not executed when there is overlap between the contact areas.
- True: the joint is executed even when the contact areas are overlapping, allowing the creation of the through hardware.
To apply the attribute, click here and see how to proceed.