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

.. _toc_2400:

Major Release 24.00
-------------------


Library compatibility information
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. only:: not spatial

  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | Library name       | Version     | Windows     | Linux         | OS X          | Notes                                                                                       |
  +====================+=============+=============+===============+===============+=============================================================================================+
  | DGN Direct         | 4.2         | |supported| | |unsupported| | |unsupported| |                                                                                             |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | HOOPS Communicator | 2018 SP2 U1 | |supported| | |unsupported| | |unsupported| |                                                                                             |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | HOOPS Exchange     | 2019        | |supported| | |supported|   | |unsupported| |                                                                                             |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | HOOPS Publish      | 2019        | |supported| | |supported|   | |unsupported| |                                                                                             |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | .NET Framework     | 4.0         | |supported| | |unsupported| | |unsupported| | v4.5 required for wpf_image                                                                 |
  |                    |             |             |               |               | v4.5 required for WPF over Remote Desktop                                                   |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | Parasolid          | 30.1        | |supported| | |supported|   | |unsupported| |                                                                                             |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | Qt                 | 5.6         | |supported| | |supported|   | |unsupported| | Please note, 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           | 2015        | |supported| | |unsupported| | |unsupported| |                                                                                             |
  +--------------------+-------------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+

.. only:: spatial

  +----------------+-----------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | Library name   | Version   | Windows     | Linux         | OS X          | Notes                                                                                       |
  +================+===========+=============+===============+===============+=============================================================================================+
  | DGN Direct     | 4.2       | |supported| | |unsupported| | |unsupported| |                                                                                             |
  +----------------+-----------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | .NET Framework | 4.0       | |supported| | |unsupported| | |unsupported| | v4.5 required for wpf_image                                                                 |
  |                |           |             |               |               | v4.5 required for WPF over Remote Desktop                                                   |
  +----------------+-----------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+
  | Qt             | 5.6       | |supported| | |supported|   | |unsupported| | Please note, 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       | 2015      | |supported| | |unsupported| | |unsupported| |                                                                                             |
  +----------------+-----------+-------------+---------------+---------------+---------------------------------------------------------------------------------------------+

*Functional changes*
^^^^^^^^^^^^^^^^^^^^

**Linux Compiler Upgrade.** The compiler for Linux binaries has been upgraded to gcc/g++ 6.3. The glibc version is unchanged (still version 2.12). Please see the :doc:`/general/supported_platforms` page for more information.

**OSX Compatibility Changes.** Previously, Visualize shipped with fat binaries for OSX that were compatible with both 32-bit and 64-bit architectures. As of this release, Visualize now ships with binaries that are only compatible with 64-bit architectures on OSX.

**AR/VR Sandbox Projects Moved.** The sandbox projects for Augmented Reality and Virtual Reality on Windows are now included in the primary sample solution file, samples_v1xx.sln.

*Enhancements*
^^^^^^^^^^^^^^

**GPU Selection.** For Visualize applications using DirectX 11 drivers, a new \`gpu preference\` option has been added to ``Set_Driver_Options_gpu_preference``, allowing you to select a specific GPU or to direct Visualize to select an appropriate GPU. Please see the ``Set_Driver_Options_gpu_preference`` "API Reference" for more information. **Note:** This option is not available for C# users using D3DImage, due to the reliance of D3DImage on the DirectX 9 driver.

In addition, the \`available gpus\` option has been added to ``Show_Device_Info_available_gpus``, which instructs Visualize return a comma-separated list of available GPU drivers. This is useful for setting a GPU preference with ``Set_Driver_Options_gpu_preference``. For more information on \`available_gpus`, please see the ``Show_Device_Info_available_gpus`` "API Reference".

**VR Sandbox Application Updated.** The \`openvr_simple\` sandbox application has been refactored for ease of use and simplicity. For more information please see these `instructions for building the OpenVR Simple application <building_sandboxes.html#openvr_simple>`__ as well as a more in-depth explanation of the OpenVR sandbox in the updated :doc:`Virtual Reality documentation </prog_guide/misc/vr_integration>`.

**Selection Performance Improvements.** ``Compute_Selection_By_Ray()`` is faster in most cases. ``Compute_Selection()`` and ``Compute_Selection_By_Area()`` are faster for extremely large polyhedrons.

.. only:: not spatial

  **Tessellation Settings for HIO_Exchange.** In the \`HOOPS/MVO\` component, a new class ``HTessellationSettings`` can be used in conjunction with \`HIO_Exchange\` to customize a variety of output settings for tessellation, such as triangle size. Please see the ``API Reference`` and the :doc:`Programming Guide </prog_guide/hio/HIO_Exchange>` for full details.

  **New Formats for HIO_Exchange.** Several new import formats were added to Visualize's \`HIO_Exchange\` component, including Rhino3D, Revit, and GLTF.

  As part of this upgrade, a new member specific for Rhino3D import called ``HInputHandlerOptions::m_bForceRenderedModeColors`` was added to the ``HInputHandlerOptions`` class in \`MVO`.

**New Options for Define_Highlight.** Two new options are now available with the ``Define_Highlight`` function in 3DGS, \`passive\` and \`append`:

-  **passive:** By default, ``Define_Highlight`` will override locked attributes on a highlighted segment, but with the new \`passive\` highlight option, ``Define_Highlight`` will not override attribute locks set on highlighted segments.
-  **append:** Previously, only a single named style would be applied when ``Define_Highlight`` was called. Now when ``Define_Highlight`` is called with the \`append\` option, the function will append a new named style to any named styles currently active for the highlighted segment.

Please see the API Reference for more information and usage samples.

**Highlight Querying and Searching.** New functionality is now available to search for highlighted segment keys within a Visualize scene. Options include searching along a specific key path and filtering results according to drawing mode. Please see the API Reference for more information.

**New Quick Moves InPlace Highlight Option.** An "InPlace" highlighting option is now available for ``Define_Highlight_quick_moves`` and ``Begin_Highlight_Search().`` This option is useful for highlights containing transparency. Please see the ``Define_Highlight_quick_moves`` "API Reference" for more details.

**Documentation for Sandboxes.** A new section in the documentation for building the Visualize sandboxes is now available.

**RealDWG multiline text.** HOOPS Visualize now uses RealDWG 2019, which handles multiline text differently compared to the previous release. RealDWG now breaks long lines of text into multiple lines, and as a result, multiline text is not guaranteed to look the same as AutoCAD.

--------------
