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

**WARNING.** We are planning to remove support for Android x86 (32-bit) and v7 by the end of the year. If you are still supporting these platforms and need advice about how to proceed, please contact TS3D Support to discuss your options.
   
   
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", "2022 SP1", |supported|, |unsupported|, |unsupported|, ""
		"HOOPS Exchange", "2023 SP2 U1", |supported|, |supported|, |unsupported|, ""
		"HOOPS Publish", "2023 SP2 U1", |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", "32.0.x", |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
------------

**Codegen debugging.** Codegen debugging utility is more reliable at producing output for "large" and "very large" execution paths. 

**Transparency rendering option.** A new rendering option for transparency bias definition has been added. Two options are available: "normal" and "msaa".

**Custom vertex shaders.** Specific behaviors such as custom colors and interpolation can be applied to lines and markers using custom vertex shaders.


Functional Changes
------------------

**.NET changes.** Visual Studio 2019 libraries are now shipped in .NET Standard 2.0, allowing customers to run their applications from .NET 4.5 to .NET 6. Sample applications as delivered are set up to run using .NET 5.

**Marker color.** Marker custom glyph color is inherited from segment when using ``SetNormalColor`` on the glyph and ``SetExplicitColor`` on other glyphs.

**Hardware accelerated text.** Highlighted text now uses the hardware acceleration path for all types of text, resulting in improved rendering performance.

**Postscript export.** Memory usage reduced when saving PostScript files.

**Include paths.** Memory usage reduced when using include paths in the segment tree.

**Text spacing.** Text aspect ratio and spacing is now slightly different due to a correction in the way FreeType fonts are handled.


Fixed Bugs
----------

.. csv-table::
	:header: "Issue Number", "Description"
	
	"SDHV-20221", "Regression: Texture bug from upgrading to HOOPS v28.10 from v27.20"
	"SDHV-20181", ".NET dependency changed to .NETCoreApp v5.0 in 3DF 28.10"
	"SDHV-20171", "Some DLL (or HDI) files have no file version anymore"
	"SDHV-20169", "Texture cannot be set to Geometry anymore"
	"SDHV-20164", "Where is dx11_<hoops_version>.dll for using DirectX?"
	"SDHV-20153", "Issue when linking both hoops.lib and hoops_mgkstat_md.lib in latest HOOPS Visualize 3DF 28.10"
	"SDHV-20131", "Visibility issues with static model heuristic"
	"SDHV-20126", "HOOPS 3DF binaries are not digitally signed"
	"SDHV-20112", "Failed to open .xyz file"
	"SDHV-20108", "Fixed text size irrespective of zoom level"
	"SDHV-20082", "Text hardware acceleration affects the visibility of text"
	"SDHV-20068", "Rendering artifacts when using polyline"
	"SDHV-20017", "HC_UnSet_Color is not happening properly[230512-000008]"
	"SDHV-20008", "Hoops 28 binaries unsigned[230508-000003]"
	"SDHV-20006", "TrueType fonts have increased spacing in new"
	"SDHV-20000", "Hoops crashes during HC_Update_One_Display('.') for this case"
	"SDHV-19913", "Incorrect text rendering with preference=vector option"
	"SDHV-19844", "crash in HBaseView::Update();"
	"SDHV-19787", "Incorrect Importing of OBJ Files with Line Continuations [230119-000014]"
	"SDHV-19770", "Strange lines in Hoops 2710 using opengl2 driver and antialiasing [230110-000014]"
	"SDHV-19626", "Increasing the performance of the selection of subentities in 'selection by area or select by window' [221110-000004]"
	"SDHV-19520", "Custom glyph color"
	"SDHV-19235", "Transparency issue [220316-000004]"

	