.. 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 HPS 2024.7.0
############################

**PLATFORM SUPPORT WARNINGS** 

* |HPSTHEN| x86 architecture is now deprecated and support is scheduled to end with |HPSTHEN| 2024.8.0 in December, 2024. As part of this deprecation, customer packages for this platform are no longer accessible from the Developer Zone. Contact Tech Soft 3D Support for access to this platform.
* Support for Visual Studio 2017 (V14.1) is now deprecated and is scheduled to end with |HPSTHEN| 2024.8.0 in December, 2024.
* Support for .Net 5 is now deprecated due to Microsoft ending support in May 2022. Support in |HPSTHEN| is scheduled to end with |HPSTHEN| 2024.8.0 in December, 2024 and be replaced with support for .Net 8 in |HPSTHEN| 2025.1.0.
* Support for Universal Windows Platform (UWP) is now deprecated and is scheduled to end with |HPSTHEN| 2024.8.0 in December, 2024. Microsoft recommends using the Windows App SDK, and WinUI rather than UWP as it is no longer under active development. Instructions for migrating an app from UWP to Windows SDK can be found `here <https://learn.microsoft.com/en-us/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/migrate-to-windows-app-sdk-ovw>`__.
* Support for Hololens I will end with |HPSTHEN| 2024.8.0 in December, 2024 due to Microsoft's planned end of life for device support. After December 10, 2024, HoloLens (1st Gen) devices will continue to function, however will no longer receive security updates or technical support.
* Support for OpenGL on MacOS and iOS platforms is deprecated and contingent on Apple's unpublished support plan. Partners are strongly encouraged to migrate to Metal in order to maintain support in the future. 

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

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

.. only:: not spatial

	.. csv-table::
		:header: "Library name", "Version", "Windows", "Linux", "OS X", "Android", "iOS", "Notes"
		
		"HOOPS Exchange", "2024.7.0", |supported|, |supported|, |supported|, |supported|, |supported|, "Android simulator support is limited. See this :ref:`explanation <prog_guide/0906_exchange_integration:Important note for Android developers>`."
		"HOOPS Publish", "2024.7.0", |supported|, |supported|, |unsupported|, |unsupported|, |unsupported|, "Requires SSSE3 instruction set support, Linux support is limited to C++"
		"HOOPS Visualize Web HTML Sprocket", "2024.6.0", |supported|, |unsupported|, |unsupported|, |supported|, |supported|, "HC Sprocket only works with Visual Studio v142."
		"HOOPS Visualize Web Streaming Sprocket (HCA)", "2024.6.0", |supported|, |unsupported|, |unsupported|, |supported|, |supported|, "HC Sprocket only works with Visual Studio v142."
		".NET Framework", "4.5", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for VS 2017 libraries and samples."
		".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for VS 2019 libraries."
		".NET Core", "5.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for VS 2019 samples."
		"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", "2019", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "RealDWG 2019 works with Visual Studio 2017 Update 2 and Visual Studio 2015 Update 3"
		"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"
		
		".NET Framework", "4.5", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for VS 2017 libraries and samples."
		".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for VS 2019 libraries."
		".NET Core", "5.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "Required for VS 2019 samples."
		"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", "2019", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "RealDWG 2019 works with Visual Studio 2017 Update 2 and Visual Studio 2015 Update 3"
		"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"


Features and Enhancements
=========================

* **Memory Management.** Added a function to limit the amount of VRAM used for display lists in order to balance resource usage and rendering performance. Refer to `SetVideoMemoryLimitRatio(double in_limit_ratio) <https://docs.techsoft3d.com/hps/latest/api_ref/cpp/class_h_p_s_1_1_database.html#_CPPv4N3HPS8Database24SetVideoMemoryLimitRatioEd>`__ for more information.


Functional Changes
==================

* **harfbuzz upgrade.** Upgraded harfbuzz to v8.5.0 to address critical vulnerabilities and exposures.


Documentation Update
====================

.. rubric:: |HPSTHEN| Bridge Documentation Moved

Documentation for integrating HOOPS Luminate into a |HPSTHEN| application has been moved to the |HPSTHEN| documentation.
You can now retrieve it here: :doc:`/prog_guide/0911_luminate_hvd_bridge`.


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

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

    "SDHV-20839", "Search functionality crashes with HOOPS Exchange models (using include segments)"
    "SDHV-20766", "Hard crash when clicking on a leader line"
    "SDHV-20770", "Unexpected planes are displayed with MeasurementOperator"
    "SDHV-20710", "Application crashes with Visual Selection (C#)"
    "SDHV-20684", "HPS::Component::GetKeyPath crash"
    "SDHV-20537", "iOS Cpp static HPS::ByteArray const CUTTING_SEGMENT_USER_DATA = { 0 }; causing EXE_BAD_ACCESS error[240313-000018]"
