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


Overview
========

HOOPS Visualize 3DF 30.50‑LTS is a stability‑ and quality‑focused long‑term support release. It concentrates on hardening HSF input handling (especially for intentionally corrupted or malicious content), improving interaction and rendering behavior in common partner workflows, and cleaning up several packaging and versioning regressions introduced in 30.40. This release does not introduce major new APIs; instead it delivers safer file handling, more predictable selection and visualization behavior, better localization support, and more reliable .NET and platform packaging for OEM deployments.


What's New in 30.50-LTS
=======================

  * **Safer HSF file handling** – Multiple crashes caused by intentionally corrupted HSF files have been fixed. Malformed or malicious content is now rejected safely, improving robustness of 3DF‑based viewers.
  * **More reliable selection and interaction** – Area selection now correctly includes content in subwindows, text‑extent queries behave robustly even when local windows are off‑screen, and a regression that could cause a black screen when anti‑aliasing was enabled has been resolved.
  * **Improved rendering consistency** – Visual issues and crashes when combining Static Model, cutting planes, transparent geometry, custom shaders and edges have been addressed, yielding more predictable visuals in advanced pipelines.
  * **Better localization support** – 3DF now correctly handles non‑ASCII (UTF‑8) font names, enabling localized and non‑Latin font families to be set and retrieved via the API.
  * **Fixed packaging, versioning and .NET issues** – Restored the missing hopengl32.dll, removed debug binaries from Release packages, corrected version metadata on key Windows binaries, and re‑enabled strong‑name signing for the hoops_mvo_cs.dll .NET wrapper.


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", "2025.4.0", |supported|, |unsupported|, |unsupported|, "HTML HIO only works with Visual Studio v142."
		"HOOPS Exchange", "2026.1.0", |supported|, |supported|, |unsupported|, ""
		"HOOPS Luminate", "2025.3.0", |supported|, |supported|, |supported|, ""
		".NET Framework", "4.8", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 libraries and samples."
		".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 and 2022 libraries."
		".NET Core", "8.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2022 samples."
		"Parasolid", "35.1", |supported|, |supported|, |unsupported|, ""
		"Qt", "6.5.3", |supported|, |unsupported|, |unsupported|, ""
		"Qt", "5.12.7", |unsupported|, |supported|, |unsupported|, "Visualize is compatible with Qt 5.4 only on OSX "
		"RealDWG", "2023", |supported|, |unsupported|, |unsupported|, "RealDWG 2023 is only compatible with Visual Studio 2019 (v142 toolchain) "
		"RealDWG", "2025", |supported|, |unsupported|, |unsupported|, "RealDWG 2025 is only compatible with Visual Studio 2022 (v143 toolchain) "
		"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.8", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 libraries and samples."
		".NET Standard", "2.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2019 and 2022 libraries."
		".NET Core", "8.0", |supported|, |unsupported|, |unsupported|, "Required for VS 2022 samples."
		"Qt", "6.5.3", |supported|, |unsupported|, |unsupported|, ""
		"Qt", "5.12.7", |unsupported|, |supported|, |unsupported|, "Visualize is compatible with Qt 5.4 only on OSX "
		"RealDWG", "2023", |supported|, |unsupported|, |unsupported|, "RealDWG 2023 is only compatible with Visual Studio 2019 (v142 toolchain) "
		"RealDWG", "2025", |supported|, |unsupported|, |unsupported|, "RealDWG 2025 is only compatible with Visual Studio 2022 (v143 toolchain) "


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

  * 3DF now supports setting and retrieving font names that contain non‑ASCII/UTF-8 characters. This improves internationalization and allows applications to use localized font names more reliably in their Visualize integrations.
  * Internal handling of enum values in opcode processing has been tightened to ensure only valid values are accepted. This reduces the risk of undefined behavior or crashes when encountering invalid or unexpected data.


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

  * Multiple crashes triggered by corrupted or intentionally malformed HSF files have been addressed. 3DF now fails gracefully when encountering these invalid inputs rather than crashing, improving robustness and security posture when handling untrusted or damaged data.
  * Fixed an issue where HC_Compute_Text_Extent_By_Path could fail if a local window lay outside of its outer window. Text extent computation is now robust to this configuration, improving reliability for advanced windowing setups and custom GUI layouts.
  * Transparent objects now clip and display correctly with cutting planes when Static Model is used.
  * Applications can safely combine custom vertex/pixel shaders with edges = on without instability.
  * Area selection now correctly includes subwindow contents (e.g., labels and overlays) when computing selection. Restores expected behavior for applications with multiple embedded viewports or UI subwindows.
  * Restored the hopengl32.dll library that had been missing since 30.40, resolving failures in workflows or deployments that depended on this DLL being present.


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

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

    "SDHV-21478", "Strong signing added back."
    "SDHV-21444", "Strong signing added back."
    "SDHV-21422", "Prevented AA activation with sample equal to one after having downscale it."
    "SDHV-21411", "Fixed static tree color setting management."
    "SDHV-21410", "Improved text extent computation."
    "SDHV-21395", "Selection now handles correctly rectangles."
    "SDHV-21389", "Fixed HOOPS stream issues and vulnerabilities."
    "SDHV-21388", "Fixed HOOPS stream issues and vulnerabilities."
    "SDHV-21387", "Fixed HOOPS stream issues and vulnerabilities."
    "SDHV-21345", "Fixed HOOPS stream issues and vulnerabilities."
    "SDHV-21344", "Fixed HOOPS stream issues and vulnerabilities."
