.. role:: raw-html(raw)
    :format: html

.. |supported| image:: ../../_assets/images/green_circle.png
   
.. |na| image:: ../../_assets/images/grey_circle.png
   
.. |unsupported| image:: ../../_assets/images/red_circle.png
   
.. |partialsupport| image:: ../../_assets/images/gray_green_circle.png

################################
HOOPS Visualize Desktop 2026.1.0
################################

Technology Updates
==================

Third-Party Library Updates
---------------------------

================== =======================
*Library*          *New Version*
================== =======================
XXXXXXX            XXXXX
================== =======================



Library Compatibility Information
---------------------------------

.. only:: not spatial    

    .. csv-table::
        :header: "Library name", "Version", "Windows", "Linux", "OS X", "Android", "iOS", "Notes"

        "Android NDK", "r27", |unsupported|, |unsupported|, |unsupported|, |supported|, |unsupported|, ""
        "HOOPS Exchange", "2026.1.0", |supported|, |supported|, |supported|, |supported|, |supported|, "Android support is limited. See this :ref:`explanation <prog_guide/0906_exchange_integration:Important note for Android developers>`."
        "HOOPS Communicator HTML Sprocket", "2025.4.0", |supported|, |unsupported|, |unsupported|, |supported|, |supported|, "HC Sprocket only works with Visual Studio toolset 142."
        "HOOPS Communicator Streaming Sprocket (HCA)", "2025.3.0", |supported|, |unsupported|, |unsupported|, |supported|, |supported|, "HC Sprocket only works with Visual Studio toolset 142."
        ".NET Framework", "4.8", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for Visual Studio v14.2 libraries and samples."
        ".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for Visual Studio 2019 (toolset 142) and 2022 (toolset 143)."
        ".NET Core", "8.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for Visual Studio 2022 (toolset 143)."
        "Parasolid", "35.1", |supported|, |supported|, |supported|, |unsupported|, |supported|, "For iOS platforms, support is limited to 64-bit platforms for the Parasolid Sprockets (hps_sprk_parasolid and hps_sprk_exchange_parasolid)."
        "RealDWG", "2023", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "RealDWG 2023 is only compatible with Visual Studio 2019 (v142 toolchain) "
        "RealDWG", "2025", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "RealDWG 2025 is only compatible with Visual Studio 2022 (v143 toolchain) "
        "Qt", "5.12.7", |supported|, |supported|, |supported|, |unsupported|, |unsupported|, ""
        "SketchUp", "2023", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "VS2019 Redistributable required, and only x64 Sketchup is supported"      

.. only:: spatial

    .. csv-table::
        :header: "Library name", "Version", "Windows", "Linux", "OS X", "Android", "iOS", "Notes"
        
        "Android NDK", "r27", |unsupported|, |unsupported|, |unsupported|, |supported|, |unsupported|, ""
        ".NET Framework", "4.8", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for Visual Studio v14.2 libraries and samples."
        ".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for Visual Studio 2019 (toolset 142) and 2022 (toolset 143)."
        ".NET Core", "8.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for Visual Studio 2022 (toolset 143)."
        "Parasolid", "35.1", |supported|, |supported|, |supported|, |unsupported|, |supported|, "For iOS platforms, support is limited to 64-bit platforms for the Parasolid Sprockets (hps_sprk_parasolid and hps_sprk_exchange_parasolid)."
        "RealDWG", "2023", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "RealDWG 2023 is only compatible with Visual Studio 2019 (v142 toolchain) "
        "RealDWG", "2025", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "RealDWG 2025 is only compatible with Visual Studio 2022 (v143 toolchain) "
        "Qt", "5.12.7", |supported|, |supported|, |supported|, |unsupported|, |unsupported|, ""
        "SketchUp", "2023", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "VS2019 Redistributable required, and only x64 Sketchup is supported"
  

  
Platform Changes
----------------

Build and runtime issues on the following platforms have been addresed in this release:

* Linux ARM (qt_sandbox + Exchange),
* macOS (qt_sandbox + Exchange),
* iOS x86_64 (simulator builds).


New Features
============

.. rubric:: Stronger enum validation in opcode processing

Internal handling of opcodes has been hardened to ensure that only valid enum values are processed.
Reduces the risk of undefined behavior or crashes when dealing with malformed or unexpected data.


API Changes
===========

* Selection behavior: Due to refinements in selection for overlapping and transparent windows, you may observe more consistent behavior when selecting entities in complex UI layouts.
  This is intended and aligns selection with what is visually presented on screen.
* The qt_sandbox sample has been updated so it correctly locates and uses HOOPS Exchange binaries on Linux ARM.
* Build issues with qt_sandbox when using HOOPS Exchange on macOS have been resolved (related to previous macro changes around Publish support).
* Incorrect architecture settings in the iOS x86_64 pipeline have been corrected resulting in proper simulator builds and more reliable iOS development workflows.
* A memory leak introduced in the newer HOOPS Exchange integration has been fixed providing improved memory stability when using HOOPS Visualize together with HOOPS Exchange.
* A crash that could occur when enabling edge visibility in combination with specific custom shaders has been resolved.
  Benefit: More robust advanced shading scenarios for applications using custom shader pipelines plus edge rendering.
* A regression (introduced in 2025.4) where maximizing the application window and performing area selection in an anti-aliased context could cause the view to go black on some integrated GPUs has been fixed.
  

Fixed Bugs
==========

.. csv-table::
    :header: "Issue", "Description"

    "SDHV-21422", "Prevent AA activation with sample equal to one after having downscale it"
    "SDHV-21410", "Improve text extent computation"
