Merge release v21.02

Author: pixar-oss

BUILDING.md

@@ -104,7 +104,7 @@ Support for Python can optionally be disabled by specifying the cmake flag
 Support for Python 3 can be enabled by specifying the cmake flag
 ```PXR_USE_PYTHON_3=ON```.
 
-##### OpenGL and GLEW
+##### OpenGL
 
 Support for OpenGL can optionally be disabled by specifying the cmake flag
 ```PXR_ENABLE_GL_SUPPORT=FALSE```.  This will skip components and libraries
@@ -114,12 +114,22 @@ that depend on GL, including:
 
 ##### Metal
 
-To build USD with Metal enabled requires macOS Mojave (10.14) or newer.
+Building USD with Metal enabled requires macOS Mojave (10.14) or newer.
 Support for Metal can optionally be disabled by specifying the cmake flag
 ```PXR_ENABLE_METAL_SUPPORT=FALSE```.  This will skip components and libraries
 that depend on Metal, including:
 - Hydra imaging
 
+##### Vulkan
+
+Building USD with Vulkan enabled requires the Vulkan SDK and glslang to
+be installed. The VULKAN_SDK environment variable must point to the
+location of the SDK. The glslang compiler headers must be locatable during
+the build process.
+
+Support for Vulkan can optionally be enabled by specifying the cmake flag
+```PXR_ENABLE_VULKAN_SUPPORT=TRUE```.
+
 ##### OSL (OpenShadingLanguage)
 
 Support for OSL is disabled by default, and can optionally be enabled by
@@ -308,6 +318,20 @@ of the environment variable using the following CMake option:
 By doing this, USD will check the ```CUSTOM_USD_PLUGINPATHS``` environment variable for paths, instead of the default
 ```PXR_PLUGINPATH_NAME``` one.
 
+The values specified in ```PXR_PLUGINPATH_NAME``` or ```PXR_INSTALL_LOCATION```
+have the following characteristics:
+
+- Values may contain any number of paths.
+
+- Paths ending with slash ('/') have 'plugInfo.json' appended automatically.
+
+- '*' may be used anywhere to match any character except slash.
+
+- '**' may be used anywhere to match any character including slash.
+
+- Paths follow Unix '$PATH'-like conventions; when duplicate definitions exist
+  in the path, the first one found is used.
+
 ##### Shared library prefix
 
 By default shared libraries will have the prefix 'lib'. This means, for a given
@@ -552,6 +576,25 @@ will add usd_m's interface link libraries, etc. This second instance
 doesn't increase the resulting file size because all symbols will be
 found in the first (-WHOLEARCHIVE) instance.
 
+###### Avoiding linking statically to Python
+
+The default build with python support will link to the python static lib for
+your interpreter. This is to support running python code from C++. If that is
+not desirable, python static linking can be disabled using the flag
+
+```
+-DPXR_PY_UNDEFINED_DYNAMIC_LOOKUP=ON
+```
+
+The primary motivating case for this is generating wheel packages for PyPI, but
+the parameter was made more generic in case it has other uses in the future. It
+is useful when we want to take advantage of python's approach to ABI
+compatibility.
+
+Note that this flag has no effect on Windows, see 
+[here for more info](https://docs.python.org/3/extending/windows.html)
+    
+
 ## Build Issues FAQ
 
 1. Boost_NO_BOOST_CMAKE: 

CHANGELOG.md

@@ -1,5 +1,185 @@
 # Change Log
 
+## [21.02] - 2021-01-18
+
+### Build
+- Added build and packaging scripts for PyPI packages. Thanks to Nvidia for
+  their work on this project!
+- Updated documentation build to fix several issues and no longer require 
+  Python. (Issue #718)
+- GLEW is no longer required for building imaging components.
+
+- Various fixes and changes to build_usd.py:
+  - Fixed command-line args not being respected for OpenVDB. (PR #1406)
+  - Updated boost to 1.70 on macOS for both Python 2 and 3. (Issue #1369)
+  - Updated MaterialX to 1.37.3 with shared libraries on Linux.
+
+- Fixed various linking issues with OpenEXR. (PR #1398)
+
+### USD
+- Allow setting malloc hook functions if they were previously set to malloc/etc.
+- Fixed handling of symbolic links and mount points on Windows. (PR #1378)
+- Fixed incorrect handling of non-existent variables in TfEnvSetting in Python.
+- Updated GfRect2i API to use function and argument names that are agnostic
+  to the direction of the Y axis.
+- Updated ilmbase half embedded in Gf to OpenEXR v2.5.3. (Issue #1354)
+- Added VtArray::AsConst, cfront, and cback methods to help avoid inadvertent
+  copy-on-writes and thread-safety issues.
+
+- Fixes for variety of issues with VtArray conversions in Python, including
+  conversion from Python sequences if all elements are convertible and a
+  bug with inadvertent copy-on-writes. (Issue #1138)
+
+- Initial implementation of Ar 2.0. This includes new features like support
+  for URI resolvers and many changes to the ArResolver interface. For more
+  details see https://graphics.pixar.com/usd/docs/668045551.html.
+
+  Work on Ar 2.0 is not yet complete and will continue through the next few
+  releases. Ar 2.0 is disabled by default but can be enabled for preview and
+  initial testing by specifying `PXR_USE_AR_2=ON` when running CMake.
+
+- Moved SdfFindOrOpenRelativeToLayer to SdfLayer::FindOrOpenRelativeToLayer.
+- Fixed SdfLayer::FindRelativeToLayer to use the same anchoring logic as
+  SdfLayer::FindOrOpenRelativeToLayer.
+- Fixed string encoding issue in .usda file writer. (Issue #1331)
+- Improved behavior when hitting hard-coded composition graph limits in Pcp.
+- Fixed incorrect native instancing behavior with sub-root references.
+
+- Added support for auto-apply API schemas. This allows single-apply API
+  schemas to be automatically applied to prims using one of a list of
+  associated concrete schema types instead of requiring the user to manually
+  apply the API schema.
+
+- Renamed UsdSchemaType to UsdSchemaKind to disambiguate between the schema
+  type (e.g. UsdGeomSphere) and kind (e.g. non-applied, single-apply, etc).
+- Deprecated functions using the "schema type" terminology in favor of
+  "schema kind".
+- Added UsdVariantSet::BlockVariantSelection. (Issue #1319, PR #1340)
+- Removed deprecated UsdAttribute::BlockConnections.
+- Removed deprecated UsdRelationship::BlockTargets.
+- Removed deprecated UsdCollectionAPI::ApplyCollection.
+- Added "container" concept to UsdShadeConnectableAPI.
+- Added support for connecting multiple sources to UsdShadeConnectableAPI.
+- Deprecated API for connecting to single sources in favor of the more
+  general multiple-source API on UsdShadeConnectableAPI.
+
+- Deprecated UsdConnectableAPI::IsShader and IsNodeGraph in favor of
+  IsContainer API. Warnings are emitted on first use unless the environment
+  setting `USD_SHADE_EMIT_CONNECTABLE_API_DEPRECATION_WARNING` is set to 0.
+
+- Updated various clients to apply the UsdShadeMaterialBindingAPI schema
+  before binding materials.
+- Fixed Python binding for UsdShade.CoordSysAPI.HasLocalBindings. (PR #1360)
+- Fixed Python binding for UsdSkel.SkinningQuery.ComputeExtentsPadding.
+  (Issue #1375)
+- Added UsdLuxPluginLight and UsdLuxPluginLightFilter schemas that allow for
+  defining a light or light filter via an SdrShaderNode.
+- UsdLuxLight and UsdLuxLightFilter schemas now publish an associated
+  SdrShaderNode based on their built-in properties.
+- Input attributes for UsdLuxLight and UsdLuxLightFilter schemas are now
+  connectable and have been renamed to include the "inputs:" prefix.
+- Deprecated UsdLuxLightPortal schema in favor of new UsdLuxPortalLight schema.
+
+### Imaging
+- Added new GL Loading Library (GLApi) to replace GLEW. GLEW is no longer 
+  required.
+- Added HioImage, removed GlfImage.
+- Added new camera framing API. Introduces the display and data window and 
+  storage size to separate these concepts. Updated Storm, HdPrman, and HdEmbree.
+- Added support for normal buffers to HdxPickFromRenderBufferTask.
+- Added standard prim API to HdInstancer and HdSceneDelegate::GetInstancerId.
+- Added support for animated extents when using draw modes. (PR #1365)
+- Improved Hydra camera to better support physically based attributes.
+- Extended HdDisplayStyle to house more advanced selection behaviors.
+- Changed renderParams timeCode default values from Default to EarliestValue.
+- Changed UsdImagingDelegate to map HdLightTokens to the new input attribute 
+  names in queries through GetLightParamValue.
+- Merged tokens textureResourceMemory into textureMemory for better performance 
+  tracking.
+- Renamed UsdImagingValueCache to UsdImagingPrimvarDescCache, it only stores 
+  primvar descriptors.
+- Removed implementations of deprecated HdSceneDelegate::GetTextureResource.
+- Removed HwFieldReader volume material node in favor of typed nodes.
+- Fixed bug in pick targets when resolving unique hits. (Issue #1343)
+- Fixed UsdSkel instance drawing at origin bug. (Issue #1347)
+- Fixed UsdImaging to discard coord sys bindings to non-existent xforms. 
+  (Issue #1346)
+- Fixed UsdSkelImagingSkeletonAdapter to forward GetMaterialId and 
+  GetDoubleSided calls to skinned mesh primadapter. (Issue #1384)
+- Fixed an issue where UsdSkelImagingSkeletonAdapter::_RemovePrim() failed to 
+  remove skeletons that did not have any bindings to skinned prims. 
+  (Issue #1228, #1248)
+- Fixed some display crashes after resyncing skeletons. (PR #1397)
+- Fixed dome light preview surface. (PR #1392)
+- Fixed links to OpenEXR for Alembic and OpenImageIO plugins. (PR #1398)
+
+### Storm
+- Added support for varying interpolation of any basis curves primvar. 
+  (Issue #1308)
+- Added support for HdStResourceRegistry::ReloadResource to allow clients to 
+  explicitly force textures to be reloaded by file path. (Issue #1352)
+- Added a new HdMaterialNetwork2 to combine (and then replace) 
+  HdStMaterialNetwork and MatFiltNetwork.
+- Added step to convert 3 channel textures to 4 channel to support Hgi backends 
+  with 4 channel requirements.
+- Added Resize() to barContainer.
+- Added fieldTextureMemory render setting to specify the target memory of 
+  volume textures.
+- Added experimental MaterialXFilter to process a material network and convert 
+  it into a MaterialX network. Also, added a first pass on a MaterialX 
+  shadergen.
+- Enabled bindless textures by default.
+- Several improvements to volume rendering including a step size relative to the 
+  sample distance so that the quality of the rendered volume does not depend on 
+  the scale.
+- Optimized HdStRenderBuffer performance by only allocating when the descriptor 
+  changes.
+- Optimized computations by avoiding copying the compute kernel for GPU 
+  computations.
+- Refactored face culling to remove fragment shader discards when possible.
+- Refactored geometric shaders such that only prims with the "masked" material 
+  tag can use alpha threshold based discards.
+- Switched Storm over to using the "translucent" material tag rather than 
+  "additive" as the default translucency state.
+- Fixed handling of valid to invalid BAR transitions due to Scene graph 
+  operations on primvars or primvar filtering. (Issue #1182)
+- Fixed GPU memory leak of certain buffers never getting garbage collected.
+- Fixed fullscreen pass to preserve alpha.
+- Removed instance primvar filtering.
+- Various improvements to Hgi :
+  - Added initial version of the Hgi codegen to be able to produce 
+    GLSL/MetalSL/others from glslfx.
+  - Added the first push of our experimental, incomplete, HgiVulkan backend, 
+    which does not yet build by default.
+  - Added memory barriers to Hgi.
+  - Added CopyTextureToBuffer and CopyBufferToTexture to HgiBlitCmds.
+  - Added 2D_ARRAY support to Hgi.
+  - Moved Ptex and Udim loading from Glf to Hgi and Storm.
+  - Added UINT16 format as prep work for Ptex support.
+  - Fixed obj-c autorelease issue, and simplification of secondary command 
+    buffer in HgiMetal compute encoder.
+  - Fixed HgiTexture::GetByteSizeOfResource to take the mip levels into account.
+  - Fixed for missing include. (PR #1359)
+
+### usdview
+- Fixed StageView.pickObject when doubles are small or out of image-bounds. 
+  (PR #1296)
+
+### MaterialX Plugin
+- Removed deprecated support for MaterialX 1.36.
+
+### Embree Hydra Plugin
+- Added support for new camera framing API and HdCamera API.
+
+### RenderMan Hydra Plugin
+- Bumped version requirement to RenderMan 23.5 or greater.
+- Improved calculation of vertex, varying, and face-varying primvar counts in 
+  BasisCurves to better match RenderMan.
+- Added support for new camera framing API and HdCamera API.
+- Added support for material node int array inputs. (Issue #1294)
+- Fixed issue that caused parameters from a shader to be incorrectly carried 
+  over to the next shader that was parsed. (Issue #1396)
+
 ## [20.11] - 2020-10-14
 
 ### Build

LICENSE.txt

@@ -522,3 +522,70 @@ Roboto Mono Fonts
 ============================================================
 USD bundles Roboto Mono fonts, which is available under the Apache 2.0 license. 
 For details, see https://fonts.google.com/specimen/Roboto+Mono#license
+
+
+============================================================
+Vulkan Memory Allocator
+============================================================
+Copyright (c) 2017-2020 Advanced Micro Devices, Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+============================================================
+Spirv Reflect
+============================================================
+Copyright 2017-2018 Google Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+
+============================================================
+khrplatform.h
+============================================================
+Copyright (c) 2008-2018 The Khronos Group Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and/or associated documentation files (the
+"Materials"), to deal in the Materials without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Materials, and to
+permit persons to whom the Materials are furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Materials.
+
+THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.

README.md

@@ -69,7 +69,6 @@ The following dependencies are required:
 
 The following dependencies are optional:
 
- - [GLEW](http://glew.sourceforge.net/)
  - [OpenEXR](http://www.openexr.com)
  - [OpenImageIO](https://sites.google.com/site/openimageio/home)
  - [OpenColorIO](http://opencolorio.org/)

VERSIONS.md

@@ -20,7 +20,6 @@ Our test machines have the following software versions installed
 | Boost         | 1.61.0, 1.70.0       | 1.61.0, 1.70.0               | 1.61.0, 1.70.0                 |
 | Intel TBB     | 2017 Update 6        | 2017 Update 6                | 2017 Update 6                  |
 | OpenSubdiv    | 3.4.3                | 3.4.3                        | 3.4.3                          |
-| GLEW          | 2.0.0                | 2.0.0                        | 2.0.0                          |
 | OpenImageIO   | 2.1.16.0             | 2.1.16.0                     | 2.1.16.0                       |
 | OpenColorIO   | 1.0.9                | 1.1.0                        | 1.1.0                          |
 | OSL           | 1.8.12               |                              |                                |
@@ -38,6 +37,7 @@ Our test machines have the following software versions installed
 | Doxygen       | 1.8.14               |                              |                                |
 | GraphViz      | 2.40.1               |                              |                                |
 | OpenVDB       | 5.2.0, 6.1.0         | 6.1.0                        | 6.1.0                          |
+| Vulkan SDK    | 1.2.135.0            | 1.2.135.0                    | 1.2.135.0                      |
 
 ## Other Known Versions
 

azure-pipelines.yml

@@ -30,6 +30,8 @@ jobs:
   - script: |
       # The SYSTEM env var is used by the Makefile of glew and having it set trips it up
       unset SYSTEM
+      # Update PATH to ensure that pyside2-uic can be found
+      export PATH=/Library/Frameworks/Python.framework/Versions/2.7/bin:$PATH
       /bin/bash -c "sudo xcode-select -s /Applications/Xcode_10.1.app/Contents/Developer"
       sudo pip install pyside2 ;
       sudo pip install PyOpenGL ;