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

###############
HPS 2022
###############


Library compatibility information
---------------------------------

.. only:: not spatial

	.. csv-table::
		:header: "Library name", "Version", "Windows", "Linux", "OS X", "Android", "iOS", "Notes"
		
		"HOOPS Exchange", "2022", |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", "2022", |supported|, |supported|, |unsupported|, |unsupported|, |unsupported|, "Requires SSSE3 instruction set support, Linux support is limited to C++"
		"HOOPS Communicator Sprocket", "2021 SP2", |supported|, |unsupported|, |unsupported|, |supported|, |supported|, ""
		".NET Framework", "4.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "4.5 required when using D3D_IMAGE_CANVAS"
		"Parasolid", "32.0.x", |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", "2021", |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.0", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "4.5 required when using D3D_IMAGE_CANVAS"
		"Parasolid", "32.0.x", |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", "2021", |supported|, |unsupported|, |unsupported|, |unsupported|, |unsupported|, "VS2019 Redistributable required, and only x64 Sketchup is supported"	


New features and enhancements
-----------------------------

**Front face culling.** HOOPS Visualize 2022 now includes a front face culling mechanism which provides additional control to selectively expose internal geometric features.

**Metal-compliant driver.** Support for the Metal graphics driver is now provided to give customers an alternative to OpenGL on Apple platforms.

**OpenGL driver deprecated.** OpenGL on Apple platforms is planned to be deprecated in HPS 2022 SP2.

**ARKit support.** ARKit, Apple's augmented reality platform for iOS, is now supported.

**Initialization function.** A new static function, ``HPS::World::IsInitialized()``, is now available. The function is used to query whether the HOOPS Visualize system has been initialized.

**Text metrics.** A new set of functions related to text metrics has been added, which can be used to determine the overall size of text, including ascenders and descenders. See ``HPS::KeyPath::ComputeTextMetrics`` and ``HPS::TextMetrics::Options`` for details.


Functional changes
------------------

.. only:: not spatial

	**HOOPS Exchange.** HOOPS Visualize now works with HOOPS Exchange 2022.

	**HOOPS Publish.** HOOPS Visualize now works with HOOPS Publish 2022.
	
**Vulkan driver.** The Vulkan driver has been removed.

**Windows minimum version.** For developers targeting Windows, Windows 10 64-bit is now the minimum version. Support for Windows 7, Windows 8, Windows 8.1, Windows Server 2008, and all Windows 32-bit operating systems is deprecated.

**iOS minimum version.** For developers targeting iOS, iOS 11.0 is now the minimum version. The minimum required compiler is now Xcode 12.2 (LLVM).

**macOS minimum version.** For developers targeting macOS, macOS 11.0 is now the minimum version. The minimum required compiler is now Xcode 12.2 (LLVM).

**Apple sandbox.** The driver used in the sandbox is now selectable on Apple systems.

**Hardware accelerated text.** Hardware accelerated text is now on by default. Note: Known issue - when hardware acceleration is enabled in combination with text anti-aliasing of transformable text and the text background and window background are different color, then a fringe exists matching the background color around the text.


Fixed bugs
----------

.. csv-table::
	:header: "Issue number", "Description"
	
	"SDHV-10995", "orbit mode becomes slow after hiding lines"
	"SDHV-10955", "Text right aligned staggers on right side depending on letters in line"
	"SDHV-10915", "Apply color to nearest faces returned by ComputeRelation on Shell"
	"SDHV-10871", "Performance of Text Rendering (5K)"
	"SDHV-10812", "Text region has different behavior since HPS 2021 SP2"
	"SDHV-10719", "Line is disappearing at specific camera"
	"SDHV-10709", "Using Algorithm.Visual mode no longer select points"
	"SDHV-10700", "Unable to import JPG file"
	"SDHV-10689", "Some text are blurry"
	"SDHV-10585", "Model moves with delay when panning camera compared with 2018SP2"
	"SDHV-10557", "dashed line pattern, dashes lose effect as camera orbits"
	"SDHV-10375", "back face coloring not working on some models when moving to HPS 2021"
	"SDHV-10904", "Hang in HOOPS HPS 2021 SP2 UP"
	"SDHV-10611", "Flat lighting does not work on geometry with face colors set"
	"SDHV-10499", "Missing points in point cloud"
	"SDHV-10443", "Highlighting of CylinderKey with 0 radius"
