:orphan:

.. 
    Orphan hides the file from the doc compiler. Remove this for actual files

:tocdepth: 2

##############
Envision 5.1
##############

July 22, 2025 - SHA: abcdefgh

|web| CEETRON Envision for Web        |desktop| CEETRON Envision for Desktop

****************
Breaking Changes
****************

The default element visibility behavior is now VIS_RESULT_ELEMENTS_COLLAPSE (for more details see the new feature below). To revert to the previous behavior, set the visibility result behavior to ``VIS_RESULT_ELEMENTS_REMOVE`` using the ``cee::ug::ModelSettings.ModelSettings::setVisibilityResultMode`` (desktop) 
or ``VisibilityResultMode.ELEMENTS_REMOVE`` using the property ``cee.ug.ModelSettings.visibilityResultMode`` (web).


***********
Fixed Bugs
***********


*************
New Features
*************

CAE-1436 Add Element Visibility Result Behavior for Collapsing Invisible/Eroded Elements |web| |desktop|
========================================================================================================

A new element collapse mode for handling visibility results in large models has been added. 
The feature addresses performance and memory consumption issues by maintaining a consistent triangle count across animation frames 
while preserving visual accuracy.

The traditional approach to visibility results treats models as adaptive and streams complete new geometry for each timestep 
when new elements are identified as invisible, rather than reusing geometry and just streaming displacement/scalar updates.

Instead of using an adaptive model and regenerating the mesh on each frame, this feature introduces a new approach 
where non-visible elements are collapsed to a single vertex, maintaining the same triangle count across all frames and allowing data reuse.

This results in significant memory and load time reductions for better performance.

A new VisibilityResultMode enum has been introduced:

.. code:: cpp

    enum VisibilityResultMode
    {
        VIS_RESULT_ELEMENTS_COLLAPSE,   
        VIS_RESULT_ELEMENTS_REMOVE
    };

The default behavior is now VIS_RESULT_ELEMENTS_COLLAPSE. To revert to the previous behavior, set the visibility result behavior to ``VIS_RESULT_ELEMENTS_REMOVE`` using the ``cee::ug::ModelSettings.ModelSettings::setVisibilityResultMode`` (desktop) 
or ``VisibilityResultMode.ELEMENTS_REMOVE`` using the property ``cee.ug.ModelSettings.visibilityResultMode`` (web).


CAE-359 Support the Ansys CFX result files |web| |desktop|
=========================================================================

We have added support for reading Ansys CFX result files (.res). 
Note that the libraries are not provided and will need to be obtained from Ansys separately.
