.. 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.8.0
############################


Technology Update
=================

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

* |HPSTHEN| x86 architecture ends with this release. 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) ends with this release. This platform will not be available for download starting with |HPSTHEN| 2025.1.0.
* Support for .Net 5 ends with this release and be replaced with support for .Net 8 in |HPSTHEN| 2025.1.0.
* Support for Universal Windows Platform (UWP) ends with this release. 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 ends with this release 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 will no longer be supported starting with |HPSTHEN| 2026.1.0. Partners will have to migrate to Metal in order to maintain support in the future. 


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

.. only:: not spatial

	.. csv-table::
		:header: "Library name", "Version", "Windows", "Linux", "OS X", "Android", "iOS", "Notes"
		
		"HOOPS Exchange", "2024.8.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.8.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"


    
.. only:: not spatial

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

    **Export JT**

        * **Wireframe:** When exporting JT files from HOOPS Exchange Sprocket, a specific export option is now available to include wireframes.

        * **Version:** The current default version is 10.0, and support is also available for versions 9.5 and 8.1.

        For more information, refer to the ``A3DRWParamsExportJTData`` struct in the |url_he_api| page.

    **Export STEP**

        * **Format and Editions:** The HOOPS Exchange Sprocket now supports multiple editions of STEP AP 242 export. The default format and edition is AP 242 Ed 1, but other editions including AP 242 Ed 2 and 3, AP 203 and AP 214 are available as export options.

        For more information, refer to the ``A3DRWParamsExportStepData`` struct in the |url_he_api| page.


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

.. rubric:: Unicode Text Alignment

The calculation of the center point of unicode text strings has been corrected in the case of inserting text with SetAlignment and SetPath along a rotated path.

.. only:: not spatial

    .. rubric:: PMI Visibility in 3D PDF

    PMI in 3DF that are set to visible by layers are now displayable when reading the file through the HOOPS Exchange Sprocket.

    .. rubric:: Samples and Sandboxes

    The directory containing the sample fonts delivered with the SDK has been moved up one level and is now parallel to the samples. The samples have also been modified to find this font directory.
  

Documentation Changes
=====================

HOOPSY
------

We are excited to introduce **HOOPSY**, our new Documentation AI assistant. It is now available for |HPSTHEN| users. This tool leverages advanced AI capabilities to help you find relevant information quickly and efficiently. It provides on-demand, multilingual support for your documentation needs.

.. rubric:: Key Features

- **Natural Language Processing (NLP):**  
  The assistant understands your queries in everyday language, delivering precise and contextually relevant answers.

- **Comprehensive Documentation Search:**  
  Searches across the |HPSTHEN| documentation to retrieve the most relevant pages, ensuring you get accurate information for your queries.

- **Reference Links:**  
  Offers direct links to the original documentation, enabling deeper exploration and providing full context to enhance understanding.

- **Conversation Sharing:**  
  Easily share your AI assistant conversations with others for collaborative troubleshooting and knowledge sharing.

- **Multilingual Support:**  
  Supports multiple languages to cater to a global user base, allowing you to interact with the assistant in your preferred language.

- **Continuous Learning:**  
  The AI assistant continuously improves its responses based on user interactions, ensuring it becomes more helpful over time.


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

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

    "SDHV-20855", "PMI visualizing issue in 3D PDF"
    "SDHV-20807", "DWG PMI disappears on zoom"
    "SDHV-20749", "Fixed Text Alignment not properly working with SetPath"
    "SDHV-20342", "2D PDF marker/points incorrect ordering"
    "SDHV-20173", "Selection highlight color doesn't change"
    "SDHV-20009", "Measure length differences when 2d files opened with Import option SetDrawing=true"
