Merge release v20.02

Author: pixar-oss

.travis.yml

@@ -76,4 +76,4 @@ cache:
 script:
   - mkdir -p $HOME/USDinst
   - mkdir -p $HOME/USDgen
-  - travis_wait 90 python build_scripts/build_usd.py -v --build $HOME/USDgen/build --src $HOME/USDgen/src $HOME/USDinst
+  - travis_wait 90 python build_scripts/build_usd.py -v --build $HOME/USDgen/build --src $HOME/USDgen/src $HOME/USDinst --build-args USD,"-DBoost_NO_BOOST_CMAKE=On -DBoost_NO_SYSTEM_PATHS=True -DBOOST_ROOT=$HOME/USDinst"

BUILDING.md

@@ -107,7 +107,7 @@ Support for OpenGL can optionally be disabled by specifying the cmake flag
 that depend on GL, including:
 - usdview
 - Hydra GL imaging
-- Maya and Katana app plugins
+- Katana app plugins
 
 ##### OSL (OpenShadingLanguage)
 
@@ -209,10 +209,13 @@ More documentation is available [here](http://openusd.org/docs/RenderMan-USD-Ima
 ## Third Party Plugins
 
 USD provides several plugins for integration with third-party software packages,
-including Maya, Katana, Houdini, and Alembic. There is additional documentation on each plugin
+including Katana, Houdini, and Alembic. There is additional documentation on each plugin
 [here](http://openusd.org/docs/USD-3rd-Party-Plugins.html).
 These plugins are not built by default and must be enabled via the instructions below.
 
+The USD Maya plugins can be found in the Autodesk-supported repo available
+[here](https://github.com/Autodesk/maya-usd).
+
 ##### Alembic Plugin
 
 Enable the [Alembic](https://github.com/alembic/alembic) plugin in the build
@@ -237,22 +240,6 @@ support requires the following dependencies:
 
 For further information see the documentation on the Alembic plugin [here](http://openusd.org/docs/Alembic-USD-Plugin.html).
 
-##### Maya Plugin
-
-Enable the Maya plugin in the build by specifying the cmake flag 
-```PXR_BUILD_MAYA_PLUGIN=TRUE``` when invoking cmake. 
-
-The additional dependencies that must be supplied when invoking cmake are:
-
-| Dependency Name   | Description                                                                                     |
-| ----------------- | -----------------------------------                                                             |
-| MAYA_LOCATION     | The root path to a Maya SDK install |
-| MAYA_tbb_LIBRARY  | The location of TBB, this should be the same as TBB_tbb_LIBRARY provided to the core USD build  |
-
-See [3rd Party Library and Application Versions](VERSIONS.md) for version information.
-
-For further information see the documentation on the Maya plugin [here](http://openusd.org/docs/Maya-USD-Plugins.html).
-
 ##### Katana Plugin
 
 Enable the Katana plugin in the build by specifying the cmake flag 
@@ -380,7 +367,7 @@ pxr/pxr.h, which facilitates using namespaces:
 ##### ASCII Parser Editing/Validation
 
 There is an ASCII parser for the USD file format, which can be found in
-[sdf](pxr/usd/lib/sdf/). Most users will not have a need to edit the parser, but
+[sdf](pxr/usd/sdf). Most users will not have a need to edit the parser, but
 for the adventurous ones, there are a couple additional requirements.
 
 If you choose to edit the ASCII parsers, make sure

CHANGELOG.md

@@ -1,5 +1,158 @@
 # Change Log
 
+## [20.02] - 2020-01-24
+
+We anticipate aligning with the version requirements from the VFX Reference
+Platform CY2018 (https://vfxplatform.com) in the next release. In particular,
+this includes requiring support for C++14.
+
+This release adds a Hydra plugin for RenderMan 23 and removes the deprecated
+Maya plugin from the repository. This release also deprecates support for the
+Houdini and Katana plugins. See details below.
+
+### Build
+- The source tree has been restructured so that code no longer lives under a
+  separate "lib" directory. This means that (with a few exceptions) include
+  paths now match source tree paths.
+
+- Added support for Visual Studio 2019 to build_usd.py. (PR #1042)
+- Added PXR_BUILD_USD_TOOLS option to disable building of command-line tools
+  (e.g. usdcat, usdedit) (PR #1048)
+- The PXR_LIB_PREFIX option now defaults to "" and is respected for .lib files
+  on Windows. (Issue #1027)
+
+### USD
+- Added "subIdentifier" and "sourceType" parameters to GetNodeFromAsset API in
+  Ndr and Sdr and "subIdentifier" attribute to UsdShadeShader schema. This
+  allows clients to identify and retrieve definitions for a particular shader
+  in source assets that have multiple shaders defined in them. (Issue #919)
+
+- Removed unused legacy SdfVariabilityConfig variability value.
+- Fixed bug where prims in masters would be populated incorrectly when a
+  UsdStage's population mask contained paths descendant to masters.
+- Fixed bug where layer stack flattening would lose some variant selections.
+  (Issue #1060)
+- UsdStage::CreateClassPrim is no longer restricted to root prims. (Issue #994)
+- UsdVariantSets::GetNames() now returns the union of all variant set names
+  across layer stacks.
+- Improved performance of retrieving metadata with templated API in UsdObject.
+- Numerous changes to improve performance when making edits to many properties.
+- Removed support for inverse layer offsets which were deprecated in v0.8.2.
+- Removed support for legacy UsdShade encodings, yielding cleaner code and
+  improved performance.
+- Improved diagnostics in usdGenSchema for non-identifier tokens in schema.usda.
+- Improved documentation generated by usdGenSchema for schema attributes.
+- usdGenSchema now treats all C++ and Python keywords as reserved and will
+  prepend a "_" if they are encountered in any identifiers.
+- Modified UsdGeomXformCommonAPI to be generated and behave like other API
+  schemas (as the name implies) for consistency.
+- Fixed bug in UsdGeomImageable::MakeVisible where the given prim would not be
+  made visible if other "invis" opinions existed on ancestor prims. (PR #1043)
+- Fixed bug in UsdGeomSubset::GetUnassignedIndices where passing in an
+  invalid element count could lead to a crash. (Issue #989)
+- Removed deprecated shader binding API on UsdShadeMaterial in favor of
+  UsdShadeMaterialBindingAPI schema.
+- Improved fidelity of light-related UsdRi schemas.
+- Added UsdLuxDomeLight::OrientToStageUpAxis utility for creating dome lights
+  with an appropriate default orientation. (Issue #938)
+- Added UsdMedia schema library and UsdMediaSpatialAudio schema.
+- Fixed bugs in UsdSkelCache::ComputeSkelBinding where inherited skel:skeleton
+  bindings were incorrectly evaluated and bindings would be returned for
+  inactive prims.
+- Python binding for UsdSkelSkinningQuery is now UsdSkel.SkinningQuery.
+
+### Imaging
+- Added RenderMan 23 Hydra plugin.
+- Added support for specifying thread limits and convergence criteria in
+  HdPrman via settings.
+- Added initial support for light filters.
+- Added an Sdr parser plugin for .glslfx files.
+- Added support for material networks in Storm.
+- Added initial support for volume rendering in Storm.
+- Added basic support for bindless shadow maps in Storm.
+- Added primvar/points editing support for points, basis curves, and meshes
+  in UsdImaging. Previously everything was resync.
+- Added Hydra changetracker dependencies between parent and child instancers.
+- Added new task HdxColorChannelTask to output a specific display channel.
+- Added command line option (--traceToFile) to usdview to start tracing as soon
+  as the application is started.
+- Changed HdPrman linking to be independent of RenderMan install.
+- Changed "depth" AOV range from [-1, 1] to [0, 1].
+- Changed name "linearDepth" AOV to "cameraDepth".
+- Changed HdxPickHit "ndcDepth" field with a range of [-1,1] to
+  "normalizedDepth" with a range of [0,1]
+- Changed edge hashing to use triangular numbers in Hd. This is about 3x faster
+  than the previous code.
+- Changed UsdImaging's DrawModeAdapter to use HdMaterialNetwork.
+- Changed default camera shutter in UsdImaging to match UsdGeomCamera [0,0].
+- Improved Storm's instance registry and moved resource registries from Hd core
+  to Storm.
+- Improved aggregation of material shaders in Storm.
+- Improved material primvar filtering in Storm.
+- Improved property refresh support in UsdImaging for instance attributes.
+- Removed HydraMaterialAdapter in UsdImaging since it is no longer needed.
+- Removed old Hydra scene delegate API that was only used by the old material
+  system in Storm. (GetSurfaceShaderSource, GetDisplacementShaderSource,
+  GetMaterialParams and others..).
+- Fixed instance adapter selection highlighting performance issues.
+- Fixed bug where pick task was continuously running in usdview.
+- Fixed Storm to skip string primvars.
+- Fixed bug where rtx_glfImage was not honoring the channel offset and number
+  of channels specified in the FillRequest parameter.
+- Fixed nullptr exception in HdPrman when rendering without a camera.
+- Fixed data ownership of instance indices. DirtyInstanceIndex is set on
+  instancers and tells them they need to re-fetch their index buffer, relative
+  to one of their prototypes.
+- Fixed UsdImaging native instancing so instead of compensating for prototype
+  transforms by overwriting prototype transforms, it compensates in the
+  per-instance transform primvar.
+- Fixed usdSkelImaging dirtyness propagation to the skinning aggregator
+  computation.
+- Fixed double color correction on MacOS.
+- Implemented SamplePrimvar for native instancer adapter. (Issue #996)
+- Fixed UsdPreviewSurface material displacement in Storm. (Issue #922, #1026)
+- Fixed change processing when an inherited primvar is removed. (Issue #1004)
+- Fixed incorrect points buffer computation for implicit geometry. (Issue #1024)
+- Added GetHgiTextureHandle API on renderbuffer to avoid HdSt dynamic_casts
+  and CPU -> GPU copies during post-process pipeline (Issue #1008)
+- Fixed TBB library linkage in hdEmbree. (PR #991)
+- Added support for 'jpeg' extension for Glf_StbImage. (PR #998)
+- Fixed bug where time-invariant geometry subsets would mask time-varying
+  topology from Hydra. (PR #1045)
+- Fixed bug where UsdGeomSubset indices were always retrieved at the default
+  time. (PR #1059)
+- Fixed incomplete handling of UsdGeomMesh face-varying options. (PR #1061)
+
+### Houdini Plugin
+- Deprecated Houdini plugins in favor of Houdini-native USD support.
+  We anticipate removing the plugin from the USD repository in a future
+  release.
+- Additional changes for Houdini 17.5 compatibility.
+
+### Katana Plugin
+- Deprecated Katana plugin in favor of the Foundry-supported Katana plugins 
+  available at https://github.com/TheFoundryVisionmongers/KatanaUsdPlugins.
+  We anticipate removing the plugin from the USD repository in a future release.
+- Changed how UsdGeomBasisCurve Widths and Normal attributes are read into
+  Katana. Author either a geometry.point.* entry (old behavior) or a
+  geometry.arbitrary.* entry (new behavior) based on the attribute's
+  interpolation.
+- Changes in preparation for reading UsdShadeMaterials which contain
+  UsdShadeNodegraph subgraphs.
+- Removed custom Viewer Modifier Plugins. These were used by Katana's legacy
+  Viewer tab, which has been replaced by the Hydra Viewer tab.
+- Removed support for /LooksDerivedStructure in USD shader libraries.
+- Fixed incorrect geometry.instanceSource attribute for nested instances.
+  (PR #1015)
+
+### MaterialX Plugin
+- Added support for versions 1.36.3 and later.
+
+### Maya Plugin
+- The Maya plugin has been removed from the USD repository. Development for
+  the plugin has moved to the Autodesk maya-usd repository located at
+  https://github.com/Autodesk/maya-usd.
+
 ## [19.11] - 2019-10-18
 
 This release deprecates support for cmake 2.x and the Maya plugin.

CMakeLists.txt

@@ -59,10 +59,6 @@ if (${PXR_BUILD_KATANA_PLUGIN})
     add_subdirectory(third_party/katana)
 endif()
 
-if (${PXR_BUILD_MAYA_PLUGIN})
-    add_subdirectory(third_party/maya)
-endif()
-
 if (${PXR_BUILD_HOUDINI_PLUGIN})
     add_subdirectory(third_party/houdini)
 endif()

LICENSE.txt

@@ -501,3 +501,10 @@ Redistributions of source code must retain the above copyright notice, this list
 Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
 
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+============================================================
+Draco
+============================================================
+USD bundles Draco, which is available under the Apache 2.0 license. For details,
+see https://github.com/google/draco/blob/master/README.md.