Implement section caps through sceneModelEntity:capMaterial

[ijlal99]

Please give this branch a test and let me know if you see any bugs so that we can fix it before merging into main.

[paireks]

Ok, I will give it a try :)

[paireks]

Hey guys, I'm testing it on various different models, it works better than I thought. It runs quite fast and gets quite good results. But also it has some limitations:

• models have to have all meshes closed (solids). But in reality many models have none of them closed or only some of them closed, which results in only partial caps / no caps.
• for huge models (such as WestRiverSideHospital) it crashes my browser.
• it doesn't work once I set the position of the model (it doesn't cap then)
• I think it would be good to check the model far from origin, but I can't remember which one was it. Do you remember @xeolabs?

Because of the above I'm thinking if maybe it would be better to add this functionality more as an example rather than a xeokit-sdk functionality? What do you guys think?

[ijlal99]

Hi @paireks!

Thank you for trying out this feature and your valuable feedback.

1. For the capping of only solid objects, this is not really a limitation but actually a requirement that we only hatch solid objects.

   xeokit-sdk/src/viewer/scene/sectionCaps/SectionCaps.js

   Line 201 in d324265

   if (isSolid && object.capMaterial) {

2. For huge models like WestRiverSideHospital, I checked and the browser crashes even when the SectionCaps are disabled.
3. We currently do not have any event in xeokit that informs us that the position of an object has been changed. We plan to handle this situation later.
4. Our first implementation of this feature was a plugin and then we switched and made it a part of xeokit sdk with the agreement of @MichalDybizbanskiCreoox and @xeolabs.

[MichalDybizbanskiCreoox]

2. For huge models like WestRiverSideHospital, I checked and the browser crashes even when the SectionCaps are disabled.

I've added a section plane and capMaterials to the xkt_dtx_WestRiverSideHospital.html example (also calling Viewer constructor with the readableGeometryEnabled: true flag needed for hatching).
The example works for me in Chrome on macOS just fine:
https://github.com/user-attachments/assets/9dfe8b42-c5a3-4c7e-baa5-ecc133d5355b