Merge pull request #1682 from AcademySoftwareFoundation/v10.1.0_rc

Merging VDB 10.1.0 release back to master

Author: apradhana

CHANGES

@@ -1,8 +1,111 @@
 OpenVDB Version History
 =======================
 
-Version 10.0.2 - In development
+Version 10.1.0 - October 11, 2023
 
+  Highlights:
+    - OpenVDB Python bindings are now implemented using pybind11 instead of
+    Boost.Python.
+    [Contributed by Matthew Cong]
+
+  OpenVDB:
+    New features:
+    - Added points::replicate() for the replication of PointDataGrid points
+      and attributes.
+
+    Improvements:
+    - Upgraded OpenVDBs internal half representation to IMath 3.1.6. Brings
+      conversion support using F16C instructions (if enabled using -mf16c) and
+      the removal of the exponent lookup table in favor of bit shifting.
+    - OpenVDBs copy of Half.h is no longer built with an internal lookup table,
+      but explicitly selects the non-LUT version and disables the creation of
+      the LUT. This is required to avoid symbol conflicts with different
+      namespaced OpenVDB builds.
+    - Removed boost::uuid from Archive, instead std::random_device is used
+      directly to generate UUID-like objects.
+    - Moved all cases of file static/global variables which relied on non-trivial
+      construction into function scopes as static locals. These would previously
+      initialize themselves on start-up in a non-deterministic, compiler-dictated
+      order(static-initialization-order-fiasco). This order is now defined by the
+      program's execution.
+    - Fixed the constants used in openvdb::math::Coord::hash() and
+      nanovdb::Coord::hash() to correctly be prime numbers (note that this
+      changes the result of these methods).
+      [Contributed by Benedikt Mersch]
+    - Updated tools::meshToVolume to take two new optional arguments to provide
+      an interior test oracle and an interior testing method. These allow the
+      default outside-flood-fill to be replaced if the actual sidedness can be
+      known.
+      [Contributed by Tomas Skrivan]
+    - LevelSetRebuild now includes example code that demonstrates the intended
+      use of the new meshToVolume interior testing parameters for the
+      resampling of level sets, where the original grid is used as the true
+      sign value. However, due to differences between polygonalization and
+      trilinear interpolation, this behaviour is disabled and exists as a
+      reference.
+    - Introduced openvdb::TupleList to wrap std::tuple and provide interface
+      interop methods with openvdb::TypeList.
+    - Added OPENVDB_FORCE_INLINE, OPENVDB_LIKELY and OPENVDB_UNLIKELY macros.
+    - Introduced openvdb::make_index_sequence to solve clang compilations
+      issues with compiler built-in index_sequence implementations.
+
+    API changes:
+    - Significant infrastructural change to the ValueAccessor header and
+      implementation. All ValueAccessor specializations have been consolidated
+      into a single class which supports all possible ValueAccessor configurations
+      using index_sequences. Backward compatible declarations have been provided.
+      The new ValueAccessor implementation is marked as final.
+    - PagedArray iterators no longer derive from std::iterator
+      (but remains standard compliant).
+
+    Bug Fixes:
+    - Internal counters in tree::RangeIterator were limited to 32bit precision.
+      They are now extended to size_t.
+      [Reported by SpaceX]
+    - Fixed a bug when compiling with -fvisibility=hidden and GCC 11 which
+      would cause a crash in openvdb::initialize().
+    - Fixed a bug with LeafManager which wouldn't correctly
+      initialize its LeafNode array for single level Tree configurations
+      i.e. RootNode<LeafNode> (bug introduced in 7.2.0).
+      [Reported by @lanwatch]
+    - Fixed a bug with LeafNodeBool Topology constructor with designated
+      on/off values which wouldn't apply them correctly.
+      [Reported by @hozhaoea]
+
+  OpenVDB AX:
+    Improvements:
+    - Added support for LLVM 15.
+
+    Bug Fixes:
+    - Fixed a bug in AX on older X86 hardware which could cause a crash when
+      accessing point attributes with half compression (bug introduced in 9.1.0).
+    - Fixed an incorrect option in the `vdb_ax` command line tool where the default
+      optimization level was set to NONE instead of O3 (issue introduced in 10.0.0).
+
+  Houdini:
+    Improvements:
+    - Added Preserve Holes option to VDB From Polygons that uses the
+      fast winding oracle to not collapse holes in polygonal geometry.
+
+    Bug Fixes:
+    - Fix a bug in the projection mode of the Advect Points SOP that was causing
+      a segfault.
+
+  Build:
+    - Fixed a build issue where Boost was not being pulled in when
+      OPENVDB_USE_DELAYED_LOADING was set to OFF.
+    - Fixed a build issue with AX on 32-bit platforms.
+      [Reported by Mathieu Malaterre]
+    - Fixed a compilation issue with the min() and max() methods on Stencils
+      in openvdb/math/Stencils.h.
+      [Reported by Samuel Mauch]
+    - Fixed a compilation error that would be encountered when attempting to
+      enable the SSE4.2 or AVX SIMD options on non-x86 based platforms.
+    - Improved support for compiling with C++20.
+      [Contributed by Denys Maletskyy and Jérémie Dumas]
+    - OpenVDB's CMake no longer modifies the BUILD_SHARED_LIBS variable.
+      [Reported by Maksim Shabunin]
+    - Fix int-in-bool-context GCC9+ warnings by switching to use constexpr if.
 
 Version 10.0.1 - November 30, 2022
 

CMakeLists.txt

@@ -53,8 +53,8 @@ endif()
 ###### Version
 
 set(OpenVDB_MAJOR_VERSION 10)
-set(OpenVDB_MINOR_VERSION 0)
-set(OpenVDB_PATCH_VERSION 2)
+set(OpenVDB_MINOR_VERSION 1)
+set(OpenVDB_PATCH_VERSION 0)
 set(OpenVDB_VERSION "${OpenVDB_MAJOR_VERSION}.${OpenVDB_MINOR_VERSION}.${OpenVDB_PATCH_VERSION}")
 
 project(OpenVDB LANGUAGES CXX VERSION ${OpenVDB_VERSION})

doc/changes.txt

@@ -2,11 +2,119 @@
 
 @page changes Release Notes
 
-@htmlonly <a name="v10_0_2_changes"></a>@endhtmlonly
+@htmlonly <a name="v10_1_0_changes"></a>@endhtmlonly
 @par
-<B>Version 10.0.2</B> - <I>In development</I>
+<B>Version 10.1.0</B> - <I>October 11, 2023</I>
 
+@par
+Highlights:
+  - OpenVDB Python bindings are now implemented using pybind11 instead of Boost.Python.
+    [Contributed by Matthew Cong]
+
+@par
+OpenVDB:
+- New features:
+  - Added points::replicate() for the replication of PointDataGrid points
+    and attributes.
+
+- Improvements:
+  - Upgraded OpenVDBs internal half representation to IMath 3.1.6. Brings
+    conversion support using F16C instructions (if enabled using -mf16c) and
+    the removal of the exponent lookup table in favor of bit shifting.
+  - OpenVDBs copy of Half.h is no longer built with an internal lookup table,
+    but explicitly selects the non-LUT version and disables the creation of
+    the LUT. This is required to avoid symbol conflicts with different
+    namespaced OpenVDB builds.
+  - Removed boost::uuid from Archive, instead std::random_device is used
+    directly to generate UUID-like objects.
+  - Moved all cases of file static/global variables which relied on non-trivial
+    construction into function scopes as static locals. These would previously
+    initialize themselves on start-up in a non-deterministic, compiler-dictated
+    order(static-initialization-order-fiasco). This order is now defined by the
+    program's execution.
+  - Fixed the constants used in openvdb::math::Coord::hash() and
+    nanovdb::Coord::hash() to correctly be prime numbers (note that this
+    changes the result of these methods).
+    [Contributed by Benedikt Mersch]
+  - Updated tools::meshToVolume to take two new optional arguments to provide
+    an interior test oracle and an interior testing method. These allow the
+    default outside-flood-fill to be replaced if the actual sidedness can be
+    known.
+    [Contributed by Tomas Skrivan]
+  - LevelSetRebuild now includes example code that demonstrates the intended
+    use of the new meshToVolume interior testing parameters for the
+    resampling of level sets, where the original grid is used as the true
+    sign value. However, due to differences between polygonalization and
+    trilinear interpolation, this behaviour is disabled and exists as a
+    reference.
+  - Introduced openvdb::TupleList to wrap std::tuple and provide interface
+    interop methods with openvdb::TypeList.
+  - Added OPENVDB_FORCE_INLINE, OPENVDB_LIKELY and OPENVDB_UNLIKELY macros.
+  - Introduced openvdb::make_index_sequence to solve clang compilations
+    issues with compiler built-in index_sequence implementations.
 
+- API changes:
+  - Significant infrastructural change to the ValueAccessor header and
+    implementation. All ValueAccessor specializations have been consolidated
+    into a single class which supports all possible ValueAccessor configurations
+    using index_sequences. Backward compatible declarations have been provided.
+    The new ValueAccessor implementation is marked as final.
+  - PagedArray iterators no longer derive from std::iterator
+    (but remains standard compliant).
+
+- Bug Fixes:
+  - Internal counters in tree::RangeIterator were limited to 32bit precision.
+    They are now extended to size_t.
+    [Reported by SpaceX]
+  - Fixed a bug when compiling with -fvisibility=hidden and GCC 11 which
+    would cause a crash in openvdb::initialize().
+  - Fixed a bug with LeafManager which wouldn't correctly
+    initialize its LeafNode array for single level Tree configurations
+    i.e. RootNode<LeafNode> (bug introduced in 7.2.0).
+    [Reported by @lanwatch]
+  - Fixed a bug with LeafNodeBool Topology constructor with designated
+    on/off values which wouldn't apply them correctly.
+    [Reported by @hozhaoea]
+
+@par
+OpenVDB AX:
+- Improvements:
+  - Added support for LLVM 15.
+
+- Bug Fixes:
+  - Fixed a bug in AX on older X86 hardware which could cause a crash when
+    accessing point attributes with half compression (bug introduced in 9.1.0).
+  - Fixed an incorrect option in the `vdb_ax` command line tool where the default
+    optimization level was set to NONE instead of O3 (issue introduced in 10.0.0).
+
+@par
+OpenVDB Houdini:
+- Improvements:
+  - Added Preserve Holes option to VDB From Polygons that uses the
+    fast winding oracle to not collapse holes in polygonal geometry.
+
+- Bug Fixes:
+  - Fix a bug in the projection mode of the Advect Points SOP that was causing
+    a segfault.
+
+@par
+Build:
+- Fixed a build issue where Boost was not being pulled in when
+  OPENVDB_USE_DELAYED_LOADING was set to OFF.
+- Fixed a build issue with AX on 32-bit platforms.
+  [Reported by Mathieu Malaterre]
+- Fixed a compilation issue with the min() and max() methods on Stencils
+  in openvdb/math/Stencils.h.
+  [Reported by Samuel Mauch]
+- Fixed a compilation error that would be encountered when attempting to
+  enable the SSE4.2 or AVX SIMD options on non-x86 based platforms.
+- Improved support for compiling with C++20.
+  [Contributed by Denys Maletskyy and Jérémie Dumas]
+- OpenVDB's CMake no longer modifies the BUILD_SHARED_LIBS variable.
+  [Reported by Maksim Shabunin]
+- Fix int-in-bool-context GCC9+ warnings by switching to use constexpr if.
+
+@par
 @htmlonly <a name="v10_0_1_changes"></a>@endhtmlonly
 @par
 <B>Version 10.0.1</B> - <I>November 30, 2022</I>

openvdb/openvdb/util/PagedArray.h

@@ -20,6 +20,7 @@
 #include <deque>
 #include <cassert>
 #include <iostream>
+#include <iterator>
 #include <algorithm>// std::swap
 #include <atomic>
 #include <tbb/spin_mutex.h>
@@ -634,11 +635,6 @@ class PagedArray<ValueT, Log2PageSize>::ConstIterator
     const PagedArray* mParent;
 };// Public class PagedArray::ConstIterator
 
-#ifdef OPENVDB_HAS_CXX20
-static_assert(std::random_access_iterator<PagedArray<int, 10UL>::ConstIterator>,
-    "ConstIterator must satisfy random_access_iterator concept");
-#endif
-
 
 ////////////////////////////////////////////////////////////////////////////////
 
@@ -695,11 +691,6 @@ class PagedArray<ValueT, Log2PageSize>::Iterator
     PagedArray* mParent;
 };// Public class PagedArray::Iterator
 
-#ifdef OPENVDB_HAS_CXX20
-static_assert(std::random_access_iterator<PagedArray<int, 10UL>::Iterator>,
-    "Iterator must satisfy random_access_iterator concept");
-#endif
-
 ////////////////////////////////////////////////////////////////////////////////
 
 // Private member-class of PagedArray implementing a memory page