3.0 - 3.5 Release Notes

3.0 - 3.5 Release Notes

Release 3.5

Release 3.5.0 - Sep 2022

Release 3.5.0 is a significant release with new features, several configuration improvements, and a few other improvements and bug fixes. For more information on the following, see Release 3.5

Deprecation Announcements
  • Hbr is deprecated and will be removed from subsequent releases
New Features
  • Simplified Surface Evaluation (Bfr)
  • Tessellation Patterns (Bfr)
  • Suppression of GCC compiler warnings (GitHub #1253, #1254, #1270)
  • Additional methods for Far::TopologyLevel (GitHub #1227, #1255)
  • Improved mixed partial derivative at Gregory patch corners (GitHub #1252)
  • Minor improvements to Far tutorials (GitHub #1226, #1241)
  • Added CMake config (GitHub #1242)
  • Updated CMake minimum version to 3.12 (GitHub #1237, #1261)
  • Updated documentation build scripts for Python 3 (#1265, #1266)
  • Updated 'stringify' build tool for improved cross compilation support (GitHub #1267)
  • Added 'NO_MACOS_FRAMEWORKS' build option (GitHub #1238)
  • Updated Azure pipelines agents for Unbuntu and macOS (GitHub #1247, #1256)
  • Removed obsolete AppVeyor and Travis CI scripts (GitHub #1259)
Bug Fixes
  • Cache active program for Osd::GLComputeEvaluator (GitHub #1244)
  • Fixed member initialization warnings in Osd::D3D11ComputeEvaluator (GitHub #1239)
  • Fixed GLSL shader source to remove storage qualifiers from struct members (GitHub #1271)
  • Fixed use of CMake variables for Apple builds (GitHub #1235)
  • Fixed build errors when using OpenGL without GLFW (GitHub #1257)
  • Fixed links to embedded videos (GitHub #1231)

Release 3.4

Release 3.4.4 - Feb 2021

Release 3.4.4 is a minor release including bug fixes and configuration improvements

  • The "master" branch on GitHub has been renamed "release" (GitHub #1218 #1219)
  • The CMake configuration has been updated to allow use as a sub-project (GitHub #1206)
  • Removed obsolete references to hbr from examples/farViewer (GitHub #1217)
Bug Fixes
  • Fixed bug with sparse PatchTables and irregular face-varying seams (GitHub #1203)
  • Fixed loss of precision when using double precision stencil tables (GitHub #1207)
  • Fixed reset of Far::TopologyRefiner::GetMaxLevel() after call to Unrefine() (GitHub #1208)
  • Fixed linking with -ldl on unix systems (GitHub #1196)
  • Fixed naming and installation of macOS frameworks (GitHub #1194 #1201)
  • Fixed GL version and extension processing and dynamic loading on macOS (GitHub #1216)
  • Fixed FindDocutils.cmake to be more robust (GitHub #1213 #1220)
  • Fixed errors using build_scripts/build_osd.py with Python3 (GitHub #1206)

Release 3.4.3 - Apr 2020

Release 3.4.3 is a minor release including bug fixes and configuration improvements

  • GLEW is no longer required by default (GitHub #1183 #1184)
  • Removed false Ptex link dependency from libosdCPU (GitHub #1174)
  • Removed false GLFW link dependency from DX11 and Metal examples (GitHub #1178)
  • Removed link dependency on unused TBB libraries (GitHub #1064)
  • Added option to disable building of dynamic shared libraries (GitHub #1169)
  • Added new tutorial for Far::LimitStencilTable (GitHub #1176)
  • Updated use of EXT_direct_state_access to ARB_direct_state_access (GitHub #1184)
  • Fixed C++ strict aliasing warnings (GitHub #1182)
  • Fixed MSVC warnings in example code (GitHub #1158 #1172)
  • Fixed compatibility with Visual Studio 2019 (GitHub #1173 #1189)
  • Fixed CMake CMP0054 warnings (GitHub #1180)
  • Added prefix to OpenSubdiv CMake macros (GitHub #1157)
  • Moved utilities in examples/common to regression/common (GitHub #1167)
  • Minor fixes to Far tutorials (GitHub #1175 #1177)
  • Switched to Azure Pipelines for continuous integration testing instead of Travis-CI and AppVeyor (GitHub #1168 #1190)
Bug Fixes
  • Fixed selective boundary interpolation for case Sdc::Options::VTX_BOUNDARY_NONE (GitHub #1170 #1171)
  • Fixed static library linking to address missing symbols (GitHub #1192)
  • Additional fixes for dynamic and static linking (GitHub #1193)

Release 3.4.0 - Jun 2019

Release 3.4.0 is a significant release with several new features, bug fixes, and general code and configuration improvements. For more information on the following, please see Release 3.4

New Features
  • Triangular Patches for Loop subdivision
  • Improvements to Introductory Documentation
  • Sparse Patch Tables and Adaptive Refinement
  • Full Support for Double Precision in Far
  • Added new build script (GitHub #1068)
  • Added support for newer DirectX SDKs (GitHub #1066)
  • Patch arrays extended to support combined regular and irregular types (GitHub #995)
  • Far::PatchTables and adaptive refinement supported for Bilinear scheme (GitHub #1035)
  • New Far::PatchTableFactory method to determine adaptive refinement options ((GitHub #1047)
  • New Far::PatchTableFactory options to align primvar buffers of uniform tables (GitHub #986)
  • Far::StencilTable::UpdateValues() overloaded to support separate base buffer (GitHub #1011)
  • Far::LimitStencilTableFactory updated to create face-varying tables (GitHub #1012)
  • Regular patches on boundaries no longer require additional isolation (GitHub #1025)
  • Inclusion of OpenSubdiv header files in source code now consistent (GitHub #767)
  • Re-organization of and additions to Far tutorials (GitHub #1083)
  • examples now use common command-line conventions and parsing (GitHub #1056)
Bug Fixes
  • Fixed Far::PrimvarRefiner internal limitFVar() prototype (GitHub #979)
  • Fixed Far::StencilTable append when base StencilTable empty (GitHub #982)
  • Patches around non-manifold vertices now free of cracks (GitHub #1013)

Release 3.3

Release 3.3.3 - Jul 2018

Release 3.3.3 is bug-fix release addressing regressions from release 3.3.2

Bug Fixes
  • Fixed a regression in PatchTable construction with varying patches (GitHub #976)
  • Fixed a regression in PatchTable construction for face-varying patches (GitHub #972)
  • Fixed a bug in the initialization of Far::SourcePatch (GitHub #971)

Release 3.3.2 - Jun 2018

Release 3.3.2 is a minor release with potentially significant performance improvements to the patch pre-processing stages

  • Improved performance of PatchTable construction (GitHub #966)
  • The resulting improved accuracy will produce slight numerical differences in computations involving patches, e.g. StencilTable and PatchTable evaluation
Bug Fixes
  • Far::PatchTableFactory now supports PatchTable construction with ENDCAP_BILINEAR_BASIS specified

Release 3.3.1 - Feb 1018

Release 3.3.1 is a minor bug-fix release

Bug Fixes
  • Fixed GLSL/HLSL/Metal patch shader code to resolve degenerate normals (GitHub #947)
  • Fixed problems with face-varying patches in uniform PatchTables (GitHub #946)
  • Fixed integer overflow bugs for large meshes in PatchTable factories (GitHub #957)
  • Fixed computation of PatchParam for triangle refinement (GitHub #962)
  • Added build options: NO_GLFW and NO_GLFW_X11
  • Added additional shapes with infinitely sharp creases to the Metal and DX11 example viewers
  • Disabled GL tests during CI runs on Linux
  • Improved stability of examples/glImaging in CI runs by testing GL version

Release 3.3.0 - Aug 2017

Release 3.3.0 is significant release adding an Osd implementation for Apple's Metal API

New Features
  • Added an Osd implementation for Apple's Metal API
  • Added the mtlViewer example
  • Fixed several instances of local variable shadowing that could cause build warnings
  • Updated continuous-integration build scripts and added testing on macOS

Release 3.2

Release 3.2.0 - Feb 2017

Release 3.2.0 is a minor release containing API additions and bug fixes

New Features
  • Extended Far::StencilTableFactory to support face-varying
  • Extended Osd Evaluator classes to support evaluation of 1st and 2nd derivatives
  • Added an option to disable generation of legacy sharp corner patches
  • Corrected numerous spelling errors in doxygen comments
  • Updated glFVarViewer with improved error detection and command line parsing
  • Added option to build using MSVC with static CRT
Bug Fixes
  • Fixed a double delete of GL program in Osd::GLComputeEvaluator

Release 3.1

Release 3.1.1 - Jan 2017

Release 3.1.1 is a minor bug-fix release.

Bug Fixes
  • Fixed a bug with non-manifold face-varying topology causing a crash during patch table creation
  • Fixed GLEW compilation and linking with dynamic GLEW libraries on Windows
  • Fixed GLFW linking with GLFW 3.2 on X11 platforms

Release 3.1.0 - Oct 2016

Release 3.1.0 is a significant release with several new features, bug fixes, and general code and configuration improvements. For more information on the following, please see Release 3.1

New Features
  • Bicubic Face-Varying Patches
  • Varying and Face-Varying Evaluation
  • Second Order Derivative Evaluation
  • Separate Levels of Feature Isolation
  • Sharp Patches for Infinitely Sharp Features
  • Enabled the use of CMake's folder feature
  • Removed the use of iso646 alternative keywords ('and', 'or', 'not', etc.) to improve portability
  • Added numerical valued preprocessor directives (OPENSUBDIV_VERSION_MAJOR, etc.) to <opensubdiv/version.h>
  • Improved documentation for Far::PatchParam and added Unnormalize() to complement Normalize()
  • Added additional topology queries to Far::TopologyLevel
  • Updated glFVarViewer and glEvalLimit viewer to make use of bicubic face-varying patches
  • Updated glViewer and dxViewer to add a toggle for InfSharpPatch
  • Updated dxPtexViewer for improved feature parity with glPtexViewer
  • Improved far_regression to exercise shapes independent of Hbr compatibility
  • Added support for Appveyor continuous integration testing
  • Removed cmake/FindIlmBase
  • Removed mayaPolySmooth example
Bug Fixes
  • Fixed Ptex version parsing and compatibility issues
  • Fixed compatibility issues with VS2015
  • Fixed bug interpolating face-varying data with Bilinear scheme
  • Fixed bug with refinement using Chaikin creasing
  • Fixed bugs with HUD sliders in the example viewers

Release 3.0

Release 3.0.5 - Mar 2016

Release 3.0.5 is a minor stability release with performance and correctness bug fixes.

Bug Fixes
  • The previous release reduced transient memory use during PatchTable construction, but increased the amount of memory consumed by the resulting PatchTable itself, this regression has been fixed.
  • The example Ptex texture sampling code has been fixed to prevent sampling beyond the texels for a face when multisample rasterization is enabled.

Release 3.0.4 - Feb 2016

Release 3.0.4 is a minor stability release which includes important performance and bug fixes.

New Features
  • Added accessor methods to Far::LimitStencilTable to retrieve limit stencil data including derivative weights
  • Added support for OpenCL event control to Osd::CLVertexBuffer and Osd::CLEvaluator
  • Major reduction in memory use during Far::PatchTable construction for topologies with large numbers of extraordinary features
  • Improved performance for GL and D3D11 tessellation control / hull shader execution when drawing BSpline patches with the single crease patch optimization enabled
Bug Fixes
  • Restored support for drawing with fractional tessellation
  • Fixed far_tutorial_6 to refine primvar data only up to the number of levels produced by topological refinement
  • Fixed build warnings and errors reported by Visual Studio 2015

Release 3.0.3 - Oct 2015

Release 3.0.3 is a minor stability release which includes important performance and bug fixes.

New Features
  • Smooth normal generation tutorial, far_tutorial_8
  • Major performance improvement in PatchTable construction
  • Improved patch approximations for non-manifold features
Bug Fixes
  • Fixed double delete in GLSL Compute controller
  • Fixed buffer layout for GLSL Compute kernel
  • Fixed GL buffer leak in Osd::GLPatchTable
  • Fixed out-of-bounds data access for TBB and OMP stencil evaluation
  • Fixed WIN32_LEAN_AND_MEAN typo
  • Fixed Loop-related shader issues glFVarViewer

Release 3.0.2 - Aug 2015

Release 3.0.2 is a minor release for a specific fix.

Bug Fixes
  • Fixed drawing of single crease patches

Release 3.0.1 - Aug 2015

Release 3.0.1 is a minor release focused on stability and correctness.

  • Added a references section to the documentation, please see References
  • Removed references to AddVaryingWithWeight from examples and tutorials
  • Added more regression test shapes
  • Addressed general compiler warnings (e.g. signed vs unsigned comparisons)
  • Addressed compiler warnings in the core libraries reported by GCC's -Wshadow
  • Eased GCC version restriction, earlier requirement for version 4.8 or newer is no longer needed
  • Replaced topology initialization assertions with errors
  • Improved compatibility with ICC
  • Improved descriptive content and formatting of Far error messages
  • Improved build when configured to include no GPU specific code
Bug Fixes
  • Fixed handling of unconnected vertices to avoid out of bounds data access
  • Fixed non-zero starting offsets for TbbEvalStencils and OmpEvalStencils
  • Fixed Far::StencilTableFactory::Options::factorizeIntermediateLevels
  • Fixed Far::PatchTablesFactory::Options::generateAllLevels
  • Fixed the behavior of VTX_BOUNDARY_NONE for meshes with bilinear scheme
  • Fixed some template method specializations which produced duplicate definitions
  • Disabled depth buffering when drawing the UI in the example viewers
  • Disabled the fractional tessellation spacing option in example viewers since this mode is currently not supported

Release 3.0.0 - Jun 2015

Release 3.0.0 is a major release with many significant improvements and changes. For more information on the following, please see Release 3.0

New Features
  • Faster subdivision using less memory
  • Support for non-manifold topology
  • Face-Varying data specified topologically
  • Elimination of fixed valence tables
  • Single-crease patch for semi-sharp edges
  • Additional irregular patch approximations
  • Introduction of Stencil Tables
  • Faster, simpler GPU kernels
  • Unified adaptive shaders
  • Updated coding style with namespaces
  • More documentation and tutorials
Bug Fixes
  • Smooth Face-Varying interpolation around creases

Release 3.0.0 RC2

New Features
  • Documentation updates
  • far_tutorial_3 updates for the multiple face-varying channels
  • maya example plugin interpolates a UV channel and a vertex color channel
Bug Fixes
  • Fixed a LimitStencilTableFactory bug, which returns an invalid table
  • PatchParam encoding changed to support refinement levels up to 10
  • Added Xinerama link dependency
  • Fixed MSVC 32bit build problem
  • Fixed minor cmake issues
  • Fixed glViewer/farViewer stability bugs

Release 3.0.0 RC1

  • Far::TopologyRefiner was split into several classes to clarify and focus the API.
  • Interpolation of Vertex and Varying primvars in a single pass is no longer supported.
  • The Osd layer was largely refactored.

Previous 2.x Release Notes

Previous releases