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


#########
3DF 29.40
#########

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

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

  * HOOPS Visualize 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 3DF 30.0.0.
  * Support for .Net Framework 4.5 and .Net 5 ends with this release and be replaced with support for .Net Framework 4.8.1 and .Net 8 in HOOPS Visualize  3DF 30.0.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 3DF 31.0.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", "Notes"
		
		"DGN Direct", "4.2", |supported|, |unsupported|, |unsupported|, ""
		"HOOPS Communicator", "2024.6.0", |supported|, |unsupported|, |unsupported|, "HTML HIO only works with Visual Studio v142."
		"HOOPS Exchange", "2024.8.0", |supported|, |supported|, |unsupported|, ""
		"HOOPS Publish", "2024.8.0", |supported|, |supported|, |unsupported|, "Requires support for SSSE3 instruction set."
		".NET Framework", "4.5", |supported|, |unsupported|, |unsupported|, "Required for VS 2017 libraries and samples."
		".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 libraries."
		".NET Core", "5.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 samples."
		"Parasolid", "35.1", |supported|, |supported|, |unsupported|, ""
		"Qt", "5.12.7", |supported|, |supported|, |unsupported|, "Visualize is compatible with Qt 5.4 on OSX "
		"RealDWG", "2019", |supported|, |unsupported|, |unsupported|, "RealDWG 2019 is compatible with Visual Studio 2015 Update 3 and Visual Studio 2017 Update 2 "
		"SketchUp", "2023", |supported|, |unsupported|, |unsupported|, "64-bit Windows only. Requires Visual Studio 2019 Redistributable."
		
.. only:: spatial

	.. csv-table::
		:header: "Library Name", "Version", "Windows", "Linux", "OS X", "Notes"
		
		"DGN Direct", "4.2", |supported|, |unsupported|, |unsupported|, ""
		".NET Framework", "4.5", |supported|, |unsupported|, |unsupported|, "Required for VS 2017 libraries and samples."
		".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 libraries."
		".NET Core", "5.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 samples."
		"Qt", "5.12.7", |supported|, |supported|, |unsupported|, "Visualize is compatible with Qt 5.4 on OSX "
		"RealDWG", "2019", |supported|, |unsupported|, |unsupported|, "RealDWG 2019 is compatible with Visual Studio 2015 Update 3 and Visual Studio 2017 Update 2 "
		"SketchUp", "2023", |supported|, |unsupported|, |unsupported|, "64-bit Windows only. Requires Visual Studio 2019 Redistributable."


Enhancements
============

* **Unicode Layout Processing** Per-character attributes are now supported for Unicode text layouts.

* **Select by Ray** Select_By_Ray can now return subentity information for shells/polygons/meshes.


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

* **HTML HIO** HOOPS Communicator libSC now only works with Visual Studio v142.

* **PDF Output/Print Preview** Lines with transparency (alpha < 1.0) are rendered behind shells in PDF output and print preview.

* **Winforms** Dev_Tools/hoops_winforms/source/hoops_panel_3dgs_only_cs142.csproj is now named Dev_Tools/hoops_winforms/source/hoops_panel_3dgs_only142.csproj in order to make the output library name consistent with other libraries in the package.


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

HOOPSY
------

We are excited to introduce **HOOPSY**, our new Documentation AI assistant. It is now available for HOOPS Visualize 3DF 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 HOOPS Visualize 3DF 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-20873", "Hoops_3dgs_v142 build error"
    "SDHV-20848", "Crash in call of HC_Move_By_Key linked to ticket SDHV-20223"
    "SDHV-20844", "HOOPS 29: C#-API-Method (Show_Memory_Usage) not useable anymore[240923-000000]"
    "SDHV-20836", "Crash on HBaseView::update"
    "SDHV-20807", "DWG PMI disappears on zoom"
    "SDHV-20798", "Compute_Selection_By_Sh_W_Op() gives wrong result with clearance > 0"
    "SDHV-20772", "False exception: ”A cutting plane became singular after transforming”"
    "SDHV-20763", "Application becomes unresponsive under OpenGL2 when calling HC_Compute_Screen_Extent_By_Key while there are texts with backgrounds in the scene"
    "SDHV-20749", "Fixed Text Alignment not properly working with SetPath"
    "SDHV-20742", "Incorrect Offsets for Ray Selection for various Surfaces"
    "SDHV-20737", "Memory leaks in HFileStreamToolkit"
    "SDHV-20730", "HOOPS Version 27.22 & 27.20: Black contour lines displayed after HOOPS 3DF upgrade from 23.00 to 27.20 and 27.22"
    "SDHV-20681", "Hang (Really slow) when loading IFC file right after loading a HSF file"
    "SDHV-20672", "HC_Compute_Selection_By_Shell_With_Options Incorrect Result with tolerance=0.0"
    "SDHV-19493", "HC_Compute_Selection_By_Area  regression [220817-000003]"