From ae54621af8169360daae4b72f04b25b14ee6b27b Mon Sep 17 00:00:00 2001 From: andy Date: Fri, 28 Jun 2024 12:19:36 -0400 Subject: [PATCH 1/7] feat: add debug bindings - wasm file not included here because it's too large, need to generate locally --- usd-wasm/src/bindings-debug/emHdBindings.data | 19331 ++++++++++++++++ usd-wasm/src/bindings-debug/emHdBindings.js | 13005 +++++++++++ .../src/bindings-debug/emHdBindings.worker.js | 181 + 3 files changed, 32517 insertions(+) create mode 100644 usd-wasm/src/bindings-debug/emHdBindings.data create mode 100644 usd-wasm/src/bindings-debug/emHdBindings.js create mode 100644 usd-wasm/src/bindings-debug/emHdBindings.worker.js diff --git a/usd-wasm/src/bindings-debug/emHdBindings.data b/usd-wasm/src/bindings-debug/emHdBindings.data new file mode 100644 index 0000000..168e611 --- /dev/null +++ b/usd-wasm/src/bindings-debug/emHdBindings.data @@ -0,0 +1,19331 @@ +{ + "Plugins": [ + { + "Info": { + "Types": { + "ArResolver": {}, + "ArDefaultResolver": { + "bases": [ + "ArResolver" + ], + "implementsContexts": true + }, + "ArPackageResolver": {} + } + }, + "LibraryPath": "", + "Name": "ar", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +// +// Copyright 2023 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +//////////////////////////////////////////////////////////////////////// + +/* ************************************************************************** */ +/* ** ** */ +/* ** This file is generated by a script. ** */ +/* ** ** */ +/* ** Do not edit it directly (unless it is within a CUSTOM CODE section)! ** */ +/* ** Edit hdSchemaDefs.py instead to make changes. ** */ +/* ** ** */ +/* ************************************************************************** */ + +#include "{{ INCLUDE_PATH }}/{{ FILE_NAME }}.h" + +#include "pxr/imaging/hd/retainedDataSource.h" + +{%- if IMPL_SCHEMA_INCLUDES is defined -%} +{%- for t in IMPL_SCHEMA_INCLUDES %} +#include "{{ t | expand }}.h" +{%- endfor -%} +{%- endif %} + +#include "pxr/base/trace/trace.h" + +// --(BEGIN CUSTOM CODE: Includes)-- +{%- if 'Includes' in CUSTOM_CODE_IMPL %} +{{ CUSTOM_CODE_IMPL['Includes'] }} +{%- endif %} +// --(END CUSTOM CODE: Includes)-- + +PXR_NAMESPACE_OPEN_SCOPE + +TF_DEFINE_PUBLIC_TOKENS({{SCHEMA_CLASS_NAME}}Tokens, + {{ SCHEMA_CLASS_NAME|snake }}_TOKENS); + +// --(BEGIN CUSTOM CODE: Schema Methods)-- +{%- if 'Schema Methods' in CUSTOM_CODE_IMPL %} +{{ CUSTOM_CODE_IMPL['Schema Methods'] }} +{%- endif %} +// --(END CUSTOM CODE: Schema Methods)-- + +{%- if GENERIC_MEMBER is defined -%} +{%- set name, type_name, opt_dict = GENERIC_MEMBER -%} +{%- if opt_dict.get('GETTER', True) %} + +TfTokenVector +{{ SCHEMA_CLASS_NAME }}::Get{{ name | capitalizeFirst }}Names() +{%- if VERSION_GUARD_CONST_GETTER %} +#if HD_API_VERSION >= 66 + const +#else + +#endif +{% else %} const +{% endif -%} {#- if VERSION_GUARD_CONST_GETTER -#} +{ + if (_container) { + return _container->GetNames(); + } else { + return {}; + } +} + +{{ type_name}}{% if not type_name.endswith('Schema') %}Handle{% endif %} +{{ SCHEMA_CLASS_NAME }}::Get{{ name | capitalizeFirst }}(const TfToken &name) +{%- if VERSION_GUARD_CONST_GETTER %} +#if HD_API_VERSION >= 66 + const +#else + +#endif +{% else %} const +{% endif -%} {#- if VERSION_GUARD_CONST_GETTER -#} +{ + {%- if type_name.endswith('Schema') %} + return {{type_name}}( + _GetTypedDataSource<{{ type_name | underlyingDataSource}}>(name)); + {%- else %} + return _GetTypedDataSource<{{ type_name | underlyingDataSource}}>(name); + {%- endif %} +} +{%- endif -%} {# if opt_dict.get('GETTER', True) #} +{%- endif -%} {# if GENERIC_MEMBER is defiend #} + +{%- if MEMBERS is defined -%} +{%- for name, type_name, opt_dict in MEMBERS -%} +{%- if opt_dict.get('GETTER', True) %} + +{{ type_name}}{% if not type_name.endswith('Schema') %}Handle{% endif %} +{{ SCHEMA_CLASS_NAME }}::Get{{ name|capitalizeFirst }}() +{%- if VERSION_GUARD_CONST_GETTER %} +#if HD_API_VERSION >= 66 + const +#else + +#endif +{% else %} const +{% endif -%} {#- if VERSION_GUARD_CONST_GETTER -#} +{ + return {% if type_name.endswith('Schema') %}{{ type_name }}({% endif %}_GetTypedDataSource<{{type_name | underlyingDataSource}}>( + {{SCHEMA_CLASS_NAME}}Tokens->{{ name }}){% if type_name.endswith('Schema') %}){% endif %}; +} +{%- endif -%} {# if opt_dict.get('GETTER', True) #} +{%- endfor -%} +{%- endif -%} {# if MEMBERS is defined #} + +{%- if GENERIC_MEMBER is defined %} + +/*static*/ +HdContainerDataSourceHandle +{{SCHEMA_CLASS_NAME}}::BuildRetained( + const size_t count, + const TfToken * const names, + const HdDataSourceBaseHandle * const values) +{ + return HdRetainedContainerDataSource::New(count, names, values); +} +{%- else -%} +{%- if MEMBERS %} + +/*static*/ +HdContainerDataSourceHandle +{{ SCHEMA_CLASS_NAME }}::BuildRetained( +{%- for name, type_name, opt_dict in MEMBERS %} + const {{type_name | underlyingDataSource}}Handle &{{ name }}{%if loop.last == False %},{% endif -%} +{%- endfor %} +) +{ + TfToken _names[{{MEMBERS|length}}]; + HdDataSourceBaseHandle _values[{{MEMBERS|length}}]; + + size_t _count = 0; +{%- for name, type_name, opt_dict in MEMBERS %} + + if ({{name}}) { + _names[_count] = {{SCHEMA_CLASS_NAME}}Tokens->{{name}}; + _values[_count++] = {{name}}; + } +{%- endfor %} + return HdRetainedContainerDataSource::New(_count, _names, _values); +} + +{%- for name, type_name, opt_dict in MEMBERS %} + +{{ SCHEMA_CLASS_NAME }}::Builder & +{{ SCHEMA_CLASS_NAME }}::Builder::Set{{ name|capitalizeFirst }}( + const {{ type_name | underlyingDataSource}}Handle &{{name}}) +{ + _{{name}} = {{name}}; + return *this; +} +{%- endfor %} + +HdContainerDataSourceHandle +{{ SCHEMA_CLASS_NAME }}::Builder::Build() +{ + return {{ SCHEMA_CLASS_NAME }}::BuildRetained( +{%- for name, type_name, opt_dict in MEMBERS %} + _{{ name }}{%if loop.last == False %},{% endif -%} +{%- endfor %} + ); +} +{%- endif -%} {# else of if MEMBERS #} +{%- endif -%} {# else of if GENERIC_MEMBER is defined #} + +{%- if SCHEMA_TOKEN is defined %} + +/*static*/ +{{ SCHEMA_CLASS_NAME }} +{{ SCHEMA_CLASS_NAME }}::GetFromParent( + const HdContainerDataSourceHandle &fromParentContainer) +{ + return {{ SCHEMA_CLASS_NAME }}( + fromParentContainer + ? HdContainerDataSource::Cast(fromParentContainer->Get( + {{SCHEMA_CLASS_NAME}}Tokens->{{SCHEMA_TOKEN}})) + : nullptr); +} + +/*static*/ +const TfToken & +{{ SCHEMA_CLASS_NAME }}::GetSchemaToken() +{ + return {{SCHEMA_CLASS_NAME}}Tokens->{{SCHEMA_TOKEN}}; +} +{%- endif -%} + +{%- if ADD_DEFAULT_LOCATOR is defined %} + +/*static*/ +const HdDataSourceLocator & +{{ SCHEMA_CLASS_NAME }}::GetDefaultLocator() +{ +{%- if LOCATOR_PREFIX is defined %} + static const HdDataSourceLocator locator = + {{ LOCATOR_PREFIX }}.Append(GetSchemaToken()); +{%- else %} + static const HdDataSourceLocator locator(GetSchemaToken()); +{%- endif %} + return locator; +} +{%- endif -%} + +{%- if MEMBERS is defined -%} +{%- for name, type_name, opt_dict in MEMBERS -%} +{%- if opt_dict['ADD_LOCATOR'] %} + +/* static */ +const HdDataSourceLocator & +{{ SCHEMA_CLASS_NAME }}::Get{{ name |capitalizeFirst }}Locator() +{ + static const HdDataSourceLocator locator = + GetDefaultLocator().Append( + {{SCHEMA_CLASS_NAME}}Tokens->{{name}}); + return locator; +} +{%- endif -%} {# if opt_dict['ADD_LOCATOR'] #} +{%- endfor -%} +{%- endif -%} {# if MEMBERS is defined #} + +{%- if STATIC_LOCATOR_ACCESSORS is defined -%} +{%- for name, tokens in STATIC_LOCATOR_ACCESSORS %} + +/*static*/ +const HdDataSourceLocator & +{{ SCHEMA_CLASS_NAME }}::Get{{name|capitalizeFirst}}Locator() +{ + static const HdDataSourceLocator locator( + {%- for t in tokens -%} + {%if t is string %}{{SCHEMA_CLASS_NAME}}Tokens->{{ t }}{% else %}{{ t[0] }}SchemaTokens->{{ t[1] }}{% endif %}{%if loop.last == False %},{% endif -%} + {%- endfor %} + ); + return locator; +} +{%- endfor -%} +{%- endif -%} {# if STATIC_LOCATOR_ACCESSORS is defined #} + +{%- if STATIC_TOKEN_DATASOURCE_BUILDERS is defined -%} +{%- for typeName, tokens in STATIC_TOKEN_DATASOURCE_BUILDERS %} + +/*static*/ +HdTokenDataSourceHandle +{{ SCHEMA_CLASS_NAME }}::Build{{typeName|capitalizeFirst}}DataSource( + const TfToken &{{typeName}}) +{ +{% for token in tokens %} + if ({{typeName}} == {{SCHEMA_CLASS_NAME}}Tokens->{{ token | tokenName }}) { + static const HdRetainedTypedSampledDataSource::Handle ds = + HdRetainedTypedSampledDataSource::New({{typeName}}); + return ds; + } +{%- endfor %} + // fallback for unknown token + return HdRetainedTypedSampledDataSource::New({{typeName}}); +} +{%- endfor -%} +{%- endif %} {# if STATIC_TOKEN_DATASOURCE_BUILDERS is defined #} + +PXR_NAMESPACE_CLOSE_SCOPE +// +// Copyright 2023 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +//////////////////////////////////////////////////////////////////////// + +/* ************************************************************************** */ +/* ** ** */ +/* ** This file is generated by a script. ** */ +/* ** ** */ +/* ** Do not edit it directly (unless it is within a CUSTOM CODE section)! ** */ +/* ** Edit hdSchemaDefs.py instead to make changes. ** */ +/* ** ** */ +/* ************************************************************************** */ + +#ifndef {{ HEADER_GUARD|snake }}_{{ FILE_NAME|snake }}_H +#define {{ HEADER_GUARD|snake }}_{{ FILE_NAME|snake }}_H + +/// \file + +#include "{{ INCLUDE_PATH }}/api.h" + +{%- if SCHEMA_INCLUDES is defined -%} +{%- for t in SCHEMA_INCLUDES %} +#include "{{ t | expand }}.h" +{%- endfor -%} +{%- endif %} + +#include "pxr/imaging/hd/schema.h" +{%- if VERSION_GUARD_CONST_GETTER %} +#include "pxr/imaging/hd/version.h" +{%- endif %} + +// --(BEGIN CUSTOM CODE: Includes)-- +{%- if 'Includes' in CUSTOM_CODE_HEADER %} +{{ CUSTOM_CODE_HEADER['Includes'] }} +{%- endif %} +// --(END CUSTOM CODE: Includes)-- + +PXR_NAMESPACE_OPEN_SCOPE + +// --(BEGIN CUSTOM CODE: Declares)-- +{%- if 'Declares' in CUSTOM_CODE_HEADER %} +{{ CUSTOM_CODE_HEADER['Declares'] }} +{%- endif %} +// --(END CUSTOM CODE: Declares)-- + +#define {{ SCHEMA_CLASS_NAME|snake }}_TOKENS \ + +{%- if SCHEMA_TOKEN is defined %} + ({{SCHEMA_TOKEN}}) \ +{%- endif -%} + +{%- if MEMBERS is defined -%} +{%- for name, type_name, opt_dict in MEMBERS -%} +{%- if SCHEMA_TOKEN is not defined or name != SCHEMA_TOKEN %} + ({{name}}) \ +{%- endif -%} +{%- endfor -%} +{%- endif -%} + +{%- if EXTRA_TOKENS is defined -%} +{%- for t in EXTRA_TOKENS %} + ({{t}}) \ +{%- endfor -%} +{%- endif -%} + +{%- if STATIC_TOKEN_DATASOURCE_BUILDERS is defined -%} +{%- for typeName, tokens in STATIC_TOKEN_DATASOURCE_BUILDERS -%} +{%- for token in tokens %} + ({{token}}) \ +{%- endfor -%} +{%- endfor -%} +{%- endif %} + +TF_DECLARE_PUBLIC_TOKENS({{SCHEMA_CLASS_NAME}}Tokens, {{ LIBRARY_API }}, + {{ SCHEMA_CLASS_NAME|snake }}_TOKENS); + +//----------------------------------------------------------------------------- + +{% if DOC is defined -%} +{{ DOC | expand | makeComment }} +{%- endif %} +class {{ SCHEMA_CLASS_NAME }} : public HdSchema +{ +public: + /// \name Schema retrieval + /// @{ + + {{ SCHEMA_CLASS_NAME }}(HdContainerDataSourceHandle container) + : HdSchema(container) {} + +{%- if SCHEMA_TOKEN is defined %} + + /// Retrieves a container data source with the schema's default name token + /// "{{ SCHEMA_TOKEN }}" from the parent container and constructs a + /// {{SCHEMA_CLASS_NAME}} instance. + /// Because the requested container data source may not exist, the result + /// should be checked with IsDefined() or a bool comparison before use. + {{ LIBRARY_API }} + static {{ SCHEMA_CLASS_NAME }} GetFromParent( + const HdContainerDataSourceHandle &fromParentContainer); +{%- endif %} + + /// @} + +// --(BEGIN CUSTOM CODE: Schema Methods)-- +{%- if 'Schema Methods' in CUSTOM_CODE_HEADER %} +{{ CUSTOM_CODE_HEADER['Schema Methods'] }} +{%- endif %} +// --(END CUSTOM CODE: Schema Methods)-- + + /// \name Member accessor + /// @{ +{%- if GENERIC_MEMBER is defined -%} +{%- set name, type_name, opt_dict = GENERIC_MEMBER -%} +{%- if opt_dict.get('GETTER', True) %} + + {{ LIBRARY_API }} + TfTokenVector Get{{ name | capitalizeFirst }}Names() +{%- if VERSION_GUARD_CONST_GETTER %} +#if HD_API_VERSION >= 66 + const; +#else + ; +#endif +{% else %} const; +{% endif -%} {# if VERSION_GUARD_CONST_GETTER #} + +{%- if 'DOC' in opt_dict -%} +{%- for l in (opt_dict['DOC'].split()|join(' ')|wordwrap(width=70)).split('\n') %} + /// {{l}} +{%- endfor -%} +{%- endif %} + {{ LIBRARY_API }} + {{ type_name}}{% if not type_name.endswith('Schema') %}Handle{% endif %} Get{{ name|capitalizeFirst }}(const TfToken &name) +{%- if VERSION_GUARD_CONST_GETTER %} +#if HD_API_VERSION >= 66 + const; +#else + ; +#endif +{% else %} const; +{%- endif -%} {# if VERSION_GUARD_CONST_GETTER #} +{%- endif -%} {# if opt_dict.get('GETTER', True) #} +{%- endif -%} {# if GENERIC_MEMBER is defined #} + +{%- if MEMBERS is defined -%} +{%- for name, type_name, opt_dict in MEMBERS -%} +{%- if opt_dict.get('GETTER', True) %} +{% if 'DOC' in opt_dict -%} +{%- for l in (opt_dict['DOC'].split()|join(' ')|wordwrap(width=70)).split('\n') %} + /// {{l}} +{%- endfor -%} +{%- endif %} + {{ LIBRARY_API }} + {{ type_name}}{% if not type_name.endswith('Schema') %}Handle{% endif %} Get{{ name|capitalizeFirst }}() +{%- if VERSION_GUARD_CONST_GETTER %} +#if HD_API_VERSION >= 66 + const; +#else + ; +#endif +{% else %} const; +{%- endif -%} {# if VERSION_GUARD_CONST_GETTER #} +{%- endif -%} {# if opt_dict.get('GETTER', True) #} +{%- endfor -%} +{%- endif %} {# if MEMBERS is defined #} + + /// @} + +{%- if SCHEMA_TOKEN is defined %} + + /// \name Schema location + /// @{ + + /// Returns a token where the container representing this schema is found in + /// a container by default. + {{ LIBRARY_API }} + static const TfToken &GetSchemaToken(); + +{%- if ADD_DEFAULT_LOCATOR is defined %} + + /// Returns an HdDataSourceLocator (relative to the prim-level data source) + /// where the container representing this schema is found by default. + {{ LIBRARY_API }} + static const HdDataSourceLocator &GetDefaultLocator(); +{%- endif %} + + /// @} +{%- endif -%} + + +{%- if self.member_locators() | trim %} + + /// \name Data source locators for members + /// + /// The following methods return an HdDataSourceLocator (relative to the + /// prim-level data source) where the data source for a member can be found. + /// + /// This is often useful for checking intersection against the + /// HdDataSourceLocatorSet sent with HdDataSourceObserver::PrimsDirtied. + /// @{ + +{%- block member_locators -%} +{%- if MEMBERS is defined -%} +{%- for name, type_name, opt_dict in MEMBERS -%} +{%- if opt_dict['ADD_LOCATOR'] %} + + /// Prim-level relative data source locator to locate {{ name }}. + {{ LIBRARY_API }} + static const HdDataSourceLocator &Get{{ name |capitalizeFirst }}Locator(); +{%- endif -%} +{%- endfor -%} +{%- endif -%} {# if MEMBERS is defined #} + +{%- if STATIC_LOCATOR_ACCESSORS is defined -%} +{%- for name, tokens in STATIC_LOCATOR_ACCESSORS %} + + /// Additional prim-level relative data source locator to locate + /// {{ name }}. + {{ LIBRARY_API }} + static const HdDataSourceLocator &Get{{name | capitalizeFirst}}Locator(); +{%- endfor -%} +{%- endif -%} +{%- endblock member_locators %} + /// @} +{%- endif %} {# if self.member_locators() | trim #} + + /// \name Schema construction + /// @{ + +{%- if GENERIC_MEMBER is defined %} + {{ LIBRARY_API }} + static HdContainerDataSourceHandle + BuildRetained( + size_t count, + const TfToken *names, + const HdDataSourceBaseHandle *values); +{%- else -%} +{%- if MEMBERS %} + + /// \deprecated Use Builder instead. + /// + /// Builds a container data source which includes the provided child data + /// sources. Parameters with nullptr values are excluded. This is a + /// low-level interface. For cases in which it's desired to define + /// the container with a sparse set of child fields, the Builder class + /// is often more convenient and readable. + {{ LIBRARY_API }} + static HdContainerDataSourceHandle + BuildRetained( +{%- for name, type_name, opt_dict in MEMBERS %} + const {{ type_name | underlyingDataSource }}Handle &{{ name }}{%if loop.last == False %},{% endif -%} +{%- endfor %} + ); + + /// \class {{ SCHEMA_CLASS_NAME }}::Builder + /// + /// Utility class for setting sparse sets of child data source fields to be + /// filled as arguments into BuildRetained. Because all setter methods + /// return a reference to the instance, this can be used in the "builder + /// pattern" form. + class Builder + { + public: +{%- for name, type_name, opt_dict in MEMBERS %} + {{ LIBRARY_API }} + Builder &Set{{ name|capitalizeFirst }}( + const {{ type_name | underlyingDataSource}}Handle &{{name}}); +{%- endfor %} + + /// Returns a container data source containing the members set thus far. + {{ LIBRARY_API }} + HdContainerDataSourceHandle Build(); + + private: +{%- for name, type_name, opt_dict in MEMBERS %} + {{ type_name | underlyingDataSource}}Handle _{{name}}; +{%- endfor %} + + }; +{%- endif -%} {# else of if MEMBERS #} +{%- endif -%} {# else of if GENERIC_MEMBER is defined #} + +{%- if STATIC_TOKEN_DATASOURCE_BUILDERS is defined -%} +{%- for typeName, tokens in STATIC_TOKEN_DATASOURCE_BUILDERS %} + + /// Returns token data source for use as {{typeName}} value. + /// + /// The following values will be stored statically and reused for future + /// calls: +{%- for token in tokens %} + /// - {{SCHEMA_CLASS_NAME}}Tokens->{{ token | tokenName }} +{%- endfor %} + {{ LIBRARY_API }} + static HdTokenDataSourceHandle Build{{typeName|capitalizeFirst}}DataSource( + const TfToken &{{typeName}}); +{%- endfor -%} +{%- endif %} + + /// @} +}; + +PXR_NAMESPACE_CLOSE_SCOPE + +#endif +{ + "Plugins": [ + { + "Info": {}, + "LibraryPath": "", + "Name": "hd", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +{ + "Plugins": [ + { + "Info": { + "Types": { + "HttpResolver": { + "bases": ["ArDefaultResolver"] + } + } + }, + "Name": "HttpResolver", + "LibraryPath": "", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +{ + "Plugins": [ + { + "Info": { + "Types": { + "NdrDiscoveryPlugin": {}, + "_NdrFilesystemDiscoveryPlugin" : { + "bases": ["NdrDiscoveryPlugin"], + "displayName": "Filesystem Discovery" + }, + "NdrParserPlugin": {} + } + }, + "LibraryPath": "", + "Name": "ndr", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +{ + "Includes": [ + "*/resources/" + ] +} +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "payloadAssetDependencies": { + "appliesTo": "prims", + "displayGroup": "Pipeline", + "type": "asset[]" + } + }, + "Types": { + "SdfFileFormat": { + "displayName": "Sdf file format base class", + "target": "sdf" + }, + "SdfTextFileFormat": { + "bases": [ + "SdfFileFormat" + ], + "displayName": "Sdf Text File Format", + "extensions": [ + "sdf" + ], + "formatId": "sdf" + } + } + }, + "LibraryPath": "", + "Name": "sdf", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +// +// Copyright 2017 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +#ifndef {{ Upper(libraryName) }}_API_H +#define {{ Upper(libraryName) }}_API_H + +#include "pxr/base/arch/export.h" + +#if defined(PXR_STATIC) +# define {{ Upper(libraryName) }}_API +# define {{ Upper(libraryName) }}_API_TEMPLATE_CLASS(...) +# define {{ Upper(libraryName) }}_API_TEMPLATE_STRUCT(...) +# define {{ Upper(libraryName) }}_LOCAL +#else +# if defined({{ Upper(libraryName) }}_EXPORTS) +# define {{ Upper(libraryName) }}_API ARCH_EXPORT +# define {{ Upper(libraryName) }}_API_TEMPLATE_CLASS(...) ARCH_EXPORT_TEMPLATE(class, __VA_ARGS__) +# define {{ Upper(libraryName) }}_API_TEMPLATE_STRUCT(...) ARCH_EXPORT_TEMPLATE(struct, __VA_ARGS__) +# else +# define {{ Upper(libraryName) }}_API ARCH_IMPORT +# define {{ Upper(libraryName) }}_API_TEMPLATE_CLASS(...) ARCH_IMPORT_TEMPLATE(class, __VA_ARGS__) +# define {{ Upper(libraryName) }}_API_TEMPLATE_STRUCT(...) ARCH_IMPORT_TEMPLATE(struct, __VA_ARGS__) +# endif +# define {{ Upper(libraryName) }}_LOCAL ARCH_HIDDEN +#endif + +#endif +{ + "Plugins": [ + { + "Info": { + "Types": { + } + }, + "LibraryPath": "@PLUG_INFO_LIBRARY_PATH@", + "Name": "{{ libraryName }}", + "ResourcePath": "@PLUG_INFO_RESOURCE_PATH@", + "Root": "@PLUG_INFO_ROOT@", + "Type": "library" + } + ] +} +// +// Copyright 2016 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +#include "{{ libraryPath }}/{{ cls.GetHeaderFile() }}" +#include "pxr/usd/usd/schemaRegistry.h" +#include "pxr/usd/usd/typed.h" + +#include "pxr/usd/sdf/types.h" +#include "pxr/usd/sdf/assetPath.h" + +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} +#include "pxr/base/tf/staticTokens.h" + +{% endif %} +{% if useExportAPI %} +{{ namespaceOpen }} + +{% endif %} +// Register the schema with the TfType system. +TF_REGISTRY_FUNCTION(TfType) +{ + TfType::Define<{{ cls.cppClassName }}, + TfType::Bases< {{ cls.parentCppClassName }} > >(); + +{% if cls.isConcrete %} + // Register the usd prim typename as an alias under UsdSchemaBase. This + // enables one to call + // TfType::Find().FindDerivedByName("{{ cls.usdPrimTypeName }}") + // to find TfType<{{ cls.cppClassName }}>, which is how IsA queries are + // answered. + TfType::AddAlias("{{ cls.usdPrimTypeName }}"); +{% endif %} +} + +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} +TF_DEFINE_PRIVATE_TOKENS( + _schemaTokens, + ({{ cls.propertyNamespacePrefix }}) +); + +{% endif %} +/* virtual */ +{{ cls.cppClassName }}::~{{ cls.cppClassName }}() +{ +} + +{% if not cls.isAPISchemaBase %} +/* static */ +{{ cls.cppClassName }} +{{ cls.cppClassName }}::Get(const UsdStagePtr &stage, const SdfPath &path) +{ + if (!stage) { + TF_CODING_ERROR("Invalid stage"); + return {{ cls.cppClassName }}(); + } +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + TfToken name; + if (!Is{{ cls.usdPrimTypeName }}Path(path, &name)) { + TF_CODING_ERROR("Invalid {{ cls.propertyNamespacePrefix }} path <%s>.", path.GetText()); + return {{ cls.cppClassName }}(); + } + return {{ cls.cppClassName }}(stage->GetPrimAtPath(path.GetPrimPath()), name); +{% else %} + return {{ cls.cppClassName }}(stage->GetPrimAtPath(path)); +{% endif %} +} + +{% if cls.isMultipleApply %} +{{ cls.cppClassName }} +{{ cls.cppClassName }}::Get(const UsdPrim &prim, const TfToken &name) +{ + return {{ cls.cppClassName }}(prim, name); +} + +/* static */ +std::vector<{{ cls.cppClassName }}> +{{ cls.cppClassName }}::GetAll(const UsdPrim &prim) +{ + std::vector<{{ cls.cppClassName }}> schemas; + + for (const auto &schemaName : + UsdAPISchemaBase::_GetMultipleApplyInstanceNames(prim, _GetStaticTfType())) { + schemas.emplace_back(prim, schemaName); + } + + return schemas; +} + +{% endif %} +{% endif %} +{% if cls.isConcrete %} +/* static */ +{{ cls.cppClassName }} +{{ cls.cppClassName }}::Define( + const UsdStagePtr &stage, const SdfPath &path) +{ + static TfToken usdPrimTypeName("{{ cls.usdPrimTypeName }}"); + if (!stage) { + TF_CODING_ERROR("Invalid stage"); + return {{ cls.cppClassName }}(); + } + return {{ cls.cppClassName }}( + stage->DefinePrim(path, usdPrimTypeName)); +} +{% endif %} +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + +/* static */ +bool +{{ cls.cppClassName }}::IsSchemaPropertyBaseName(const TfToken &baseName) +{ + static TfTokenVector attrsAndRels = { +{% for attrName in cls.attrOrder %} +{% set attr = cls.attrs[attrName] %} + UsdSchemaRegistry::GetMultipleApplyNameTemplateBaseName( + {{ tokensPrefix }}Tokens->{{ attr.name }}), +{% endfor %} +{% for relName in cls.relOrder %} +{% set rel = cls.rels[relName] %} + UsdSchemaRegistry::GetMultipleApplyNameTemplateBaseName( + {{ tokensPrefix }}Tokens->{{ rel.name }}), +{% endfor %} + }; + + return find(attrsAndRels.begin(), attrsAndRels.end(), baseName) + != attrsAndRels.end(); +} + +/* static */ +bool +{{ cls.cppClassName }}::Is{{ cls.usdPrimTypeName }}Path( + const SdfPath &path, TfToken *name) +{ + if (!path.IsPropertyPath()) { + return false; + } + + std::string propertyName = path.GetName(); + TfTokenVector tokens = SdfPath::TokenizeIdentifierAsTokens(propertyName); + + // The baseName of the {{ cls.usdPrimTypename }} path can't be one of the + // schema properties. We should validate this in the creation (or apply) + // API. + TfToken baseName = *tokens.rbegin(); + if (IsSchemaPropertyBaseName(baseName)) { + return false; + } + + if (tokens.size() >= 2 + && tokens[0] == _schemaTokens->{{ cls.propertyNamespacePrefix }}) { + *name = TfToken(propertyName.substr( + _schemaTokens->{{ cls.propertyNamespacePrefix }}.GetString().size() + 1)); + return true; + } + + return false; +} +{% endif %} + +/* virtual */ +UsdSchemaKind {{ cls.cppClassName }}::_GetSchemaKind() const +{ + return {{ cls.cppClassName }}::schemaKind; +} +{% if cls.isAppliedAPISchema %} + +/* static */ +bool +{% if not cls.isMultipleApply %} +{{ cls.cppClassName }}::CanApply( + const UsdPrim &prim, std::string *whyNot) +{% else %} +{{ cls.cppClassName }}::CanApply( + const UsdPrim &prim, const TfToken &name, std::string *whyNot) +{% endif %} +{ +{% if cls.isMultipleApply %} + return prim.CanApplyAPI<{{ cls.cppClassName }}>(name, whyNot); +{% else %} + return prim.CanApplyAPI<{{ cls.cppClassName }}>(whyNot); +{% endif %} +} + +/* static */ +{{ cls.cppClassName }} +{% if not cls.isMultipleApply %} +{{ cls.cppClassName }}::Apply(const UsdPrim &prim) +{% else %} +{{ cls.cppClassName }}::Apply(const UsdPrim &prim, const TfToken &name) +{% endif %} +{ +{% if cls.isMultipleApply %} + if (prim.ApplyAPI<{{ cls.cppClassName }}>(name)) { + return {{ cls.cppClassName }}(prim, name); + } +{% else %} + if (prim.ApplyAPI<{{ cls.cppClassName }}>()) { + return {{ cls.cppClassName }}(prim); + } +{% endif %} + return {{ cls.cppClassName }}(); +} +{% endif %} + +/* static */ +const TfType & +{{ cls.cppClassName }}::_GetStaticTfType() +{ + static TfType tfType = TfType::Find<{{ cls.cppClassName }}>(); + return tfType; +} + +/* static */ +bool +{{ cls.cppClassName }}::_IsTypedSchema() +{ + static bool isTyped = _GetStaticTfType().IsA(); + return isTyped; +} + +/* virtual */ +const TfType & +{{ cls.cppClassName }}::_GetTfType() const +{ + return _GetStaticTfType(); +} +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + +/// Returns the property name prefixed with the correct namespace prefix, which +/// is composed of the the API's propertyNamespacePrefix metadata and the +/// instance name of the API. +static inline +TfToken +_GetNamespacedPropertyName(const TfToken instanceName, const TfToken propName) +{ + return UsdSchemaRegistry::MakeMultipleApplyNameInstance(propName, instanceName); +} +{% endif %} + +{% for attrName in cls.attrOrder %} +{% set attr = cls.attrs[attrName] %} +{# Only emit Create/Get API and doxygen if apiName is not empty string. #} +{% if attr.apiName != '' %} +{% if attr.apiGet != "custom" %} +UsdAttribute +{{ cls.cppClassName }}::Get{{ Proper(attr.apiName) }}Attr() const +{ +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + return GetPrim().GetAttribute( + _GetNamespacedPropertyName( + GetName(), + {{ tokensPrefix }}Tokens->{{ attr.name }})); +{% else %} + return GetPrim().GetAttribute({{ tokensPrefix }}Tokens->{{ attr.name }}); +{% endif %} +} +{% endif %} + +UsdAttribute +{{ cls.cppClassName }}::Create{{ Proper(attr.apiName) }}Attr(VtValue const &defaultValue, bool writeSparsely) const +{ +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + return UsdSchemaBase::_CreateAttr( + _GetNamespacedPropertyName( + GetName(), + {{ tokensPrefix }}Tokens->{{ attr.name }}), +{% else %} + return UsdSchemaBase::_CreateAttr({{ tokensPrefix }}Tokens->{{ attr.name }}, +{% endif %} + {{ attr.usdType }}, + /* custom = */ {{ "true" if attr.custom else "false" }}, + {{ attr.variability }}, + defaultValue, + writeSparsely); +} + +{% endif %} +{% endfor %} +{% for relName in cls.relOrder %} +{% set rel = cls.rels[relName] %} +{# Only emit Create/Get API and doxygen if apiName is not empty string. #} +{% if rel.apiName != '' %} +{% if rel.apiGet != "custom" %} +UsdRelationship +{{ cls.cppClassName }}::Get{{ Proper(rel.apiName) }}Rel() const +{ +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + return GetPrim().GetRelationship( + _GetNamespacedPropertyName( + GetName(), + {{ tokensPrefix }}Tokens->{{ rel.name }})); +{% else %} + return GetPrim().GetRelationship({{ tokensPrefix }}Tokens->{{ rel.name }}); +{% endif %} +} +{% endif %} + +UsdRelationship +{{ cls.cppClassName }}::Create{{ Proper(rel.apiName) }}Rel() const +{ +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + return GetPrim().CreateRelationship( + _GetNamespacedPropertyName( + GetName(), + {{ tokensPrefix }}Tokens->{{ rel.name }}), +{% else %} + return GetPrim().CreateRelationship({{ tokensPrefix }}Tokens->{{rel.name}}, +{% endif %} + /* custom = */ {{ "true" if rel.custom else "false" }}); +} + +{% endif %} +{% endfor %} +{% if cls.attrOrder|length > 0 %} +namespace { +static inline TfTokenVector +_ConcatenateAttributeNames(const TfTokenVector& left,const TfTokenVector& right) +{ + TfTokenVector result; + result.reserve(left.size() + right.size()); + result.insert(result.end(), left.begin(), left.end()); + result.insert(result.end(), right.begin(), right.end()); + return result; +} +} + +{% endif %} +/*static*/ +const TfTokenVector& +{{ cls.cppClassName }}::GetSchemaAttributeNames(bool includeInherited) +{ +{% if cls.attrOrder|length > 0 %} + static TfTokenVector localNames = { +{% for attrName in cls.attrOrder %} +{% set attr = cls.attrs[attrName] %} +{% if attr.apiName != '' %} + {{ tokensPrefix }}Tokens->{{ attr.name }}, +{% endif %} +{% endfor %} + }; + static TfTokenVector allNames = + _ConcatenateAttributeNames( + {{ cls.parentCppClassName }}::GetSchemaAttributeNames(true), + localNames); +{% else %} + static TfTokenVector localNames; + static TfTokenVector allNames = + {{ cls.parentCppClassName }}::GetSchemaAttributeNames(true); +{% endif %} + + if (includeInherited) + return allNames; + else + return localNames; +} + +{% if cls.isMultipleApply %} +/*static*/ +TfTokenVector +{{ cls.cppClassName }}::GetSchemaAttributeNames( + bool includeInherited, const TfToken &instanceName) +{ + const TfTokenVector &attrNames = GetSchemaAttributeNames(includeInherited); + if (instanceName.IsEmpty()) { + return attrNames; + } + TfTokenVector result; + result.reserve(attrNames.size()); + for (const TfToken &attrName : attrNames) { + result.push_back( + UsdSchemaRegistry::MakeMultipleApplyNameInstance(attrName, instanceName)); + } + return result; +} + +{% endif %} +{% if useExportAPI %} +{{ namespaceClose }} + +{% endif %} +// ===================================================================== // +// Feel free to add custom code below this line. It will be preserved by +// the code generator. +{% if useExportAPI %} +// +// Just remember to wrap code in the appropriate delimiters: +// '{{ namespaceOpen }}', '{{ namespaceClose }}'. +{% endif %} +// ===================================================================== // +// --(BEGIN CUSTOM CODE)-- + +// +// Copyright 2016 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +#ifndef {{ Upper(libraryName) }}_GENERATED_{{ Upper(cls.className) }}_H +#define {{ Upper(libraryName) }}_GENERATED_{{ Upper(cls.className) }}_H + +/// \file {{ libraryName }}/{{ cls.GetHeaderFile() }} + +{% if useExportAPI %} +#include "pxr/pxr.h" +#include "{{ libraryPath }}/api.h" +{% endif %} +#include "{{ cls.parentLibPath }}/{{ cls.GetParentHeaderFile() }}" +#include "pxr/usd/usd/prim.h" +#include "pxr/usd/usd/stage.h" +{% if cls.tokens -%} +#include "{{ libraryPath }}/tokens.h" +{% endif %} +{% if cls.extraIncludes -%} +{{ cls.extraIncludes }} +{% endif %} + +#include "pxr/base/vt/value.h" + +#include "pxr/base/gf/vec3d.h" +#include "pxr/base/gf/vec3f.h" +#include "pxr/base/gf/matrix4d.h" + +#include "pxr/base/tf/token.h" +#include "pxr/base/tf/type.h" + +{% if useExportAPI %} +{{ namespaceOpen }} + +{% endif %} +class SdfAssetPath; + +// -------------------------------------------------------------------------- // +// {{ Upper(cls.usdPrimTypeName) }}{{' ' * (74 - cls.usdPrimTypeName|count)}} // +// -------------------------------------------------------------------------- // + +/// \class {{ cls.cppClassName }} +/// +{% if cls.doc -%} +/// {{ cls.doc }} +{% endif %} +{% if cls.doc and hasTokenAttrs -%} +/// +{%endif%} +{% if hasTokenAttrs -%} +/// For any described attribute \em Fallback \em Value or \em Allowed \em Values below +/// that are text/tokens, the actual token is published and defined in \ref {{ tokensPrefix }}Tokens. +/// So to set an attribute to the value "rightHanded", use {{ tokensPrefix }}Tokens->rightHanded +/// as the value. +{% endif %} +/// +class {{ cls.cppClassName }} : public {{ cls.parentCppClassName }} +{ +public: + /// Compile time constant representing what kind of schema this class is. + /// + /// \sa UsdSchemaKind + static const UsdSchemaKind schemaKind = {{cls.schemaKindEnumValue }}; + +{% if cls.isMultipleApply %} + /// Construct a {{ cls.cppClassName }} on UsdPrim \p prim with + /// name \p name . Equivalent to + /// {{ cls.cppClassName }}::Get( + /// prim.GetStage(), + /// prim.GetPath().AppendProperty( + /// "{{ cls.propertyNamespacePrefix }}:name")); + /// + /// for a \em valid \p prim, but will not immediately throw an error for + /// an invalid \p prim + explicit {{ cls.cppClassName }}( + const UsdPrim& prim=UsdPrim(), const TfToken &name=TfToken()) + : {{ cls.parentCppClassName }}(prim, /*instanceName*/ name) + { } + + /// Construct a {{ cls.cppClassName }} on the prim held by \p schemaObj with + /// name \p name. Should be preferred over + /// {{ cls.cppClassName }}(schemaObj.GetPrim(), name), as it preserves + /// SchemaBase state. + explicit {{ cls.cppClassName }}( + const UsdSchemaBase& schemaObj, const TfToken &name) + : {{ cls.parentCppClassName }}(schemaObj, /*instanceName*/ name) + { } +{% else %} + /// Construct a {{ cls.cppClassName }} on UsdPrim \p prim . + /// Equivalent to {{ cls.cppClassName }}::Get(prim.GetStage(), prim.GetPath()) + /// for a \em valid \p prim, but will not immediately throw an error for + /// an invalid \p prim + explicit {{ cls.cppClassName }}(const UsdPrim& prim=UsdPrim()) + : {{ cls.parentCppClassName }}(prim) + { + } + + /// Construct a {{ cls.cppClassName }} on the prim held by \p schemaObj . + /// Should be preferred over {{ cls.cppClassName }}(schemaObj.GetPrim()), + /// as it preserves SchemaBase state. + explicit {{ cls.cppClassName }}(const UsdSchemaBase& schemaObj) + : {{ cls.parentCppClassName }}(schemaObj) + { + } +{% endif %} + + /// Destructor. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + virtual ~{{ cls.cppClassName }}() {%- if cls.isAPISchemaBase %} = 0{% endif %}; + + /// Return a vector of names of all pre-declared attributes for this schema + /// class and all its ancestor classes. Does not include attributes that + /// may be authored by custom/extended methods of the schemas involved. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static const TfTokenVector & + GetSchemaAttributeNames(bool includeInherited=true); +{% if cls.isMultipleApply %} + + /// Return a vector of names of all pre-declared attributes for this schema + /// class and all its ancestor classes for a given instance name. Does not + /// include attributes that may be authored by custom/extended methods of + /// the schemas involved. The names returned will have the proper namespace + /// prefix. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static TfTokenVector + GetSchemaAttributeNames(bool includeInherited, const TfToken &instanceName); + + /// Returns the name of this multiple-apply schema instance + TfToken GetName() const { + return _GetInstanceName(); + } +{% endif %} +{% if not cls.isAPISchemaBase %} + + /// Return a {{ cls.cppClassName }} holding the prim adhering to this + /// schema at \p path on \p stage. If no prim exists at \p path on + /// \p stage, or if the prim at that path does not adhere to this schema, +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + /// return an invalid schema object. \p path must be of the format + /// .{{ cls.propertyNamespacePrefix }}:name . + /// + /// This is shorthand for the following: + /// + /// \code + /// TfToken name = SdfPath::StripNamespace(path.GetToken()); + /// {{ cls.cppClassName }}( + /// stage->GetPrimAtPath(path.GetPrimPath()), name); + /// \endcode +{% else %} + /// return an invalid schema object. This is shorthand for the following: + /// + /// \code + /// {{ cls.cppClassName }}(stage->GetPrimAtPath(path)); + /// \endcode +{% endif %} + /// + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static {{ cls.cppClassName }} + Get(const UsdStagePtr &stage, const SdfPath &path); +{% if cls.isMultipleApply %} + + /// Return a {{ cls.cppClassName }} with name \p name holding the + /// prim \p prim. Shorthand for {{ cls.cppClassName }}(prim, name); + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static {{ cls.cppClassName }} + Get(const UsdPrim &prim, const TfToken &name); + + /// Return a vector of all named instances of {{ cls.cppClassName }} on the + /// given \p prim. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static std::vector<{{ cls.cppClassName }}> + GetAll(const UsdPrim &prim); +{% endif %} +{% endif %} + +{% if cls.isConcrete %} + /// Attempt to ensure a \a UsdPrim adhering to this schema at \p path + /// is defined (according to UsdPrim::IsDefined()) on this stage. + /// + /// If a prim adhering to this schema at \p path is already defined on this + /// stage, return that prim. Otherwise author an \a SdfPrimSpec with + /// \a specifier == \a SdfSpecifierDef and this schema's prim type name for + /// the prim at \p path at the current EditTarget. Author \a SdfPrimSpec s + /// with \p specifier == \a SdfSpecifierDef and empty typeName at the + /// current EditTarget for any nonexistent, or existing but not \a Defined + /// ancestors. + /// + /// The given \a path must be an absolute prim path that does not contain + /// any variant selections. + /// + /// If it is impossible to author any of the necessary PrimSpecs, (for + /// example, in case \a path cannot map to the current UsdEditTarget's + /// namespace) issue an error and return an invalid \a UsdPrim. + /// + /// Note that this method may return a defined prim whose typeName does not + /// specify this schema class, in case a stronger typeName opinion overrides + /// the opinion at the current EditTarget. + /// + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static {{ cls.cppClassName }} + Define(const UsdStagePtr &stage, const SdfPath &path); +{% endif %} +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + /// Checks if the given name \p baseName is the base name of a property + /// of {{ cls.usdPrimTypeName }}. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static bool + IsSchemaPropertyBaseName(const TfToken &baseName); + + /// Checks if the given path \p path is of an API schema of type + /// {{ cls.usdPrimTypeName }}. If so, it stores the instance name of + /// the schema in \p name and returns true. Otherwise, it returns false. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static bool + Is{{ cls.usdPrimTypeName }}Path(const SdfPath &path, TfToken *name); +{% endif %} +{% if cls.isAppliedAPISchema and not cls.isMultipleApply %} + + /// Returns true if this single-apply API schema can be applied to + /// the given \p prim. If this schema can not be a applied to the prim, + /// this returns false and, if provided, populates \p whyNot with the + /// reason it can not be applied. + /// + /// Note that if CanApply returns false, that does not necessarily imply + /// that calling Apply will fail. Callers are expected to call CanApply + /// before calling Apply if they want to ensure that it is valid to + /// apply a schema. + /// + /// \sa UsdPrim::GetAppliedSchemas() + /// \sa UsdPrim::HasAPI() + /// \sa UsdPrim::CanApplyAPI() + /// \sa UsdPrim::ApplyAPI() + /// \sa UsdPrim::RemoveAPI() + /// + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static bool + CanApply(const UsdPrim &prim, std::string *whyNot=nullptr); + + /// Applies this single-apply API schema to the given \p prim. + /// This information is stored by adding "{{ cls.primName }}" to the + /// token-valued, listOp metadata \em apiSchemas on the prim. + /// + /// \return A valid {{ cls.cppClassName }} object is returned upon success. + /// An invalid (or empty) {{ cls.cppClassName }} object is returned upon + /// failure. See \ref UsdPrim::ApplyAPI() for conditions + /// resulting in failure. + /// + /// \sa UsdPrim::GetAppliedSchemas() + /// \sa UsdPrim::HasAPI() + /// \sa UsdPrim::CanApplyAPI() + /// \sa UsdPrim::ApplyAPI() + /// \sa UsdPrim::RemoveAPI() + /// + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static {{ cls.cppClassName }} + Apply(const UsdPrim &prim); +{% endif %} +{% if cls.isAppliedAPISchema and cls.isMultipleApply %} + + /// Returns true if this multiple-apply API schema can be applied, + /// with the given instance name, \p name, to the given \p prim. If this + /// schema can not be a applied the prim, this returns false and, if + /// provided, populates \p whyNot with the reason it can not be applied. + /// + /// Note that if CanApply returns false, that does not necessarily imply + /// that calling Apply will fail. Callers are expected to call CanApply + /// before calling Apply if they want to ensure that it is valid to + /// apply a schema. + /// + /// \sa UsdPrim::GetAppliedSchemas() + /// \sa UsdPrim::HasAPI() + /// \sa UsdPrim::CanApplyAPI() + /// \sa UsdPrim::ApplyAPI() + /// \sa UsdPrim::RemoveAPI() + /// + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static bool + CanApply(const UsdPrim &prim, const TfToken &name, + std::string *whyNot=nullptr); + + /// Applies this multiple-apply API schema to the given \p prim + /// along with the given instance name, \p name. + /// + /// This information is stored by adding "{{ cls.primName }}:name" + /// to the token-valued, listOp metadata \em apiSchemas on the prim. + /// For example, if \p name is 'instance1', the token + /// '{{ cls.primName }}:instance1' is added to 'apiSchemas'. + /// + /// \return A valid {{ cls.cppClassName }} object is returned upon success. + /// An invalid (or empty) {{ cls.cppClassName }} object is returned upon + /// failure. See \ref UsdPrim::ApplyAPI() for + /// conditions resulting in failure. + /// + /// \sa UsdPrim::GetAppliedSchemas() + /// \sa UsdPrim::HasAPI() + /// \sa UsdPrim::CanApplyAPI() + /// \sa UsdPrim::ApplyAPI() + /// \sa UsdPrim::RemoveAPI() + /// + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static {{ cls.cppClassName }} + Apply(const UsdPrim &prim, const TfToken &name); +{% endif %} + +protected: + /// Returns the kind of schema this class belongs to. + /// + /// \sa UsdSchemaKind + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + UsdSchemaKind _GetSchemaKind() const override; + +private: + // needs to invoke _GetStaticTfType. + friend class UsdSchemaRegistry; + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + static const TfType &_GetStaticTfType(); + + static bool _IsTypedSchema(); + + // override SchemaBase virtuals. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + const TfType &_GetTfType() const override; + +{% for attrName in cls.attrOrder %} +{% set attr = cls.attrs[attrName]%} +{# Only emit Create/Get API and doxygen if apiName is not empty string. #} +{% if attr.apiName != '' %} +public: + // --------------------------------------------------------------------- // + // {{ Upper(attr.apiName) }} + // --------------------------------------------------------------------- // + /// {{ attr.doc }} + /// +{% if attr.details %} + /// | || + /// | -- | -- | +{% for detail in attr.details %} + /// | {{ detail[0] }} | {{ detail[1] }} | +{% endfor %} +{% endif %} + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + UsdAttribute Get{{ Proper(attr.apiName) }}Attr() const; + + /// See Get{{ Proper(attr.apiName) }}Attr(), and also + /// \ref Usd_Create_Or_Get_Property for when to use Get vs Create. + /// If specified, author \p defaultValue as the attribute's default, + /// sparsely (when it makes sense to do so) if \p writeSparsely is \c true - + /// the default for \p writeSparsely is \c false. + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + UsdAttribute Create{{ Proper(attr.apiName) }}Attr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const; + +{% endif %} +{% endfor %} +{% for relName in cls.relOrder %} +{% set rel = cls.rels[relName]%} +{# Only emit Create/Get API and doxygen if apiName is not empty string. #} +{% if rel.apiName != '' %} +public: + // --------------------------------------------------------------------- // + // {{ Upper(rel.apiName) }} + // --------------------------------------------------------------------- // + /// {{ rel.doc }} + /// +{% for detail in rel.details %} + /// \n {{ detail[0] }}: {{ detail[1] }} +{% endfor %} + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + UsdRelationship Get{{ Proper(rel.apiName) }}Rel() const; + + /// See Get{{ Proper(rel.apiName) }}Rel(), and also + /// \ref Usd_Create_Or_Get_Property for when to use Get vs Create + {% if useExportAPI -%} + {{ Upper(libraryName) }}_API + {% endif -%} + UsdRelationship Create{{ Proper(rel.apiName) }}Rel() const; +{% endif %} + +{% endfor %} +public: + // ===================================================================== // + // Feel free to add custom code below this line, it will be preserved by + // the code generator. + // + // Just remember to: + // - Close the class declaration with }; +{% if useExportAPI %} + // - Close the namespace with {{ namespaceClose }} +{% endif %} + // - Close the include guard with #endif + // ===================================================================== // + // --(BEGIN CUSTOM CODE)-- + +// +// Copyright 2016 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +#include "{{ libraryPath }}/tokens.h" + +{% if useExportAPI %} +{{ namespaceOpen }} + +{% endif %} +{{ tokensPrefix }}TokensType::{{ tokensPrefix }}TokensType() : +{% for token in tokens %} + {{ token.id }}("{{ token.value }}", TfToken::Immortal), +{% endfor %} + allTokens({ +{% for token in tokens %} + {{ token.id }}{% if not loop.last %},{% endif %} + +{% endfor %} + }) +{ +} + +TfStaticData<{{ tokensPrefix }}TokensType> {{ tokensPrefix }}Tokens; +{% if useExportAPI %} + +{{ namespaceClose }} +{% endif %} +// +// Copyright 2016 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +#ifndef {{ Upper(tokensPrefix) }}_TOKENS_H +#define {{ Upper(tokensPrefix) }}_TOKENS_H + +/// \file {{ libraryName }}/tokens.h + +// XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +// +// This is an automatically generated file (by usdGenSchema.py). +// Do not hand-edit! +// +// XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + +{% if useExportAPI %} +#include "pxr/pxr.h" +#include "{{ libraryPath }}/api.h" +{% endif %} +#include "pxr/base/tf/staticData.h" +#include "pxr/base/tf/token.h" +#include + +{% if useExportAPI %} +{{ namespaceOpen }} + +{% endif %} + +/// \class {{ tokensPrefix }}TokensType +/// +/// \link {{ tokensPrefix }}Tokens \endlink provides static, efficient +/// \link TfToken TfTokens\endlink for use in all public USD API. +/// +/// These tokens are auto-generated from the module's schema, representing +/// property names, for when you need to fetch an attribute or relationship +/// directly by name, e.g. UsdPrim::GetAttribute(), in the most efficient +/// manner, and allow the compiler to verify that you spelled the name +/// correctly. +/// +/// {{ tokensPrefix }}Tokens also contains all of the \em allowedTokens values +/// declared for schema builtin attributes of 'token' scene description type. +{% if tokens %} +/// Use {{ tokensPrefix }}Tokens like so: +/// +/// \code +/// gprim.GetMyTokenValuedAttr().Set({{ tokensPrefix }}Tokens->{{ tokens[0].id }}); +/// \endcode +{% endif %} +struct {{ tokensPrefix }}TokensType { + {% if useExportAPI %}{{ Upper(libraryName) }}_API {% endif %}{{ tokensPrefix }}TokensType(); +{% for token in tokens %} + /// \brief "{{ token.value }}" + /// + /// {{ token.desc }} + const TfToken {{ token.id }}; +{% endfor %} + /// A vector of all of the tokens listed above. + const std::vector allTokens; +}; + +/// \var {{ tokensPrefix }}Tokens +/// +/// A global variable with static, efficient \link TfToken TfTokens\endlink +/// for use in all public USD API. \sa {{ tokensPrefix }}TokensType +extern{% if useExportAPI %} {{ Upper(libraryName) }}_API{% endif %} TfStaticData<{{ tokensPrefix }}TokensType> {{ tokensPrefix }}Tokens; +{% if useExportAPI %} + +{{ namespaceClose }} +{% endif %} + +#endif +// +// Copyright 2016 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +#include "{{ libraryPath }}/{{ cls.GetHeaderFile() }}" +#include "pxr/usd/usd/schemaBase.h" + +#include "pxr/usd/sdf/primSpec.h" + +#include "pxr/usd/usd/pyConversions.h" +{% if cls.isAppliedAPISchema %} +#include "pxr/base/tf/pyAnnotatedBoolResult.h" +{% endif %} +#include "pxr/base/tf/pyContainerConversions.h" +#include "pxr/base/tf/pyResultConversions.h" +#include "pxr/base/tf/pyUtils.h" +#include "pxr/base/tf/wrapTypeHelpers.h" + +#include + +#include + +using namespace boost::python; + +{% if useExportAPI %} +{{ namespaceUsing }} + +namespace { + +{% endif %} +#define WRAP_CUSTOM \ + template static void _CustomWrapCode(Cls &_class) + +// fwd decl. +WRAP_CUSTOM; + +{% for attrName in cls.attrOrder -%} +{% set attr = cls.attrs[attrName] %} +{# Only emit Create/Get API if apiName is not empty string. #} +{% if attr.apiName != '' %} + +static UsdAttribute +_Create{{ Proper(attr.apiName) }}Attr({{ cls.cppClassName }} &self, + object defaultVal, bool writeSparsely) { + return self.Create{{ Proper(attr.apiName) }}Attr( + UsdPythonToSdfType(defaultVal, {{ attr.usdType }}), writeSparsely); +} +{% endif %} +{% endfor %} +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + +static bool _WrapIs{{ cls.usdPrimTypeName }}Path(const SdfPath &path) { + TfToken collectionName; + return {{ cls.cppClassName }}::Is{{ cls.usdPrimTypeName }}Path( + path, &collectionName); +} +{% endif %} +{% if not cls.isAPISchemaBase %} + +static std::string +_Repr(const {{ cls.cppClassName }} &self) +{ + std::string primRepr = TfPyRepr(self.GetPrim()); +{% if cls.isMultipleApply %} + std::string instanceName = TfPyRepr(self.GetName()); + return TfStringPrintf( + "{{ libraryName[0]|upper }}{{ libraryName[1:] }}.{{ cls.className }}(%s, '%s')", + primRepr.c_str(), instanceName.c_str()); +{% else %} + return TfStringPrintf( + "{{ libraryName[0]|upper }}{{ libraryName[1:] }}.{{ cls.className }}(%s)", + primRepr.c_str()); +{% endif %} +} +{% endif %} +{% if cls.isAppliedAPISchema %} + +struct {{ cls.cppClassName }}_CanApplyResult : + public TfPyAnnotatedBoolResult +{ + {{ cls.cppClassName }}_CanApplyResult(bool val, std::string const &msg) : + TfPyAnnotatedBoolResult(val, msg) {} +}; + +{% if cls.isMultipleApply %} +static {{ cls.cppClassName }}_CanApplyResult +_WrapCanApply(const UsdPrim& prim, const TfToken& name) +{ + std::string whyNot; + bool result = {{ cls.cppClassName }}::CanApply(prim, name, &whyNot); + return {{ cls.cppClassName }}_CanApplyResult(result, whyNot); +} +{% else %} +static {{ cls.cppClassName }}_CanApplyResult +_WrapCanApply(const UsdPrim& prim) +{ + std::string whyNot; + bool result = {{ cls.cppClassName }}::CanApply(prim, &whyNot); + return {{ cls.cppClassName }}_CanApplyResult(result, whyNot); +} +{% endif %} +{% endif %} +{% if useExportAPI %} + +} // anonymous namespace +{% endif %} + +void wrap{{ cls.cppClassName }}() +{ + typedef {{ cls.cppClassName }} This; + +{% if cls.isAppliedAPISchema %} + {{ cls.cppClassName }}_CanApplyResult::Wrap<{{ cls.cppClassName }}_CanApplyResult>( + "_CanApplyResult", "whyNot"); + +{% endif %} +{% if cls.isAPISchemaBase %} + class_< This , bases<{{ cls.parentCppClassName }}>, boost::noncopyable> cls ("APISchemaBase", "", no_init); +{% else %} + class_ > + cls("{{ cls.className }}"); +{% endif %} + + cls +{% if not cls.isAPISchemaBase %} +{% if cls.isMultipleApply %} + .def(init((arg("prim"), arg("name")))) + .def(init((arg("schemaObj"), arg("name")))) +{% else %} + .def(init(arg("prim"))) + .def(init(arg("schemaObj"))) +{% endif %} +{% endif %} + .def(TfTypePythonClass()) + +{% if not cls.isAPISchemaBase %} +{% if cls.isMultipleApply %} + .def("Get", + ({{ cls.cppClassName }}(*)(const UsdStagePtr &stage, + const SdfPath &path)) + &This::Get, + (arg("stage"), arg("path"))) + .def("Get", + ({{ cls.cppClassName }}(*)(const UsdPrim &prim, + const TfToken &name)) + &This::Get, + (arg("prim"), arg("name"))) +{% else %} + .def("Get", &This::Get, (arg("stage"), arg("path"))) +{% endif %} + .staticmethod("Get") +{% endif %} +{% if cls.isMultipleApply %} + + .def("GetAll", + (std::vector<{{ cls.cppClassName }}>(*)(const UsdPrim &prim)) + &This::GetAll, + arg("prim"), + return_value_policy()) + .staticmethod("GetAll") +{% endif %} +{% if cls.isConcrete %} + + .def("Define", &This::Define, (arg("stage"), arg("path"))) + .staticmethod("Define") +{% endif %} +{% if cls.isAppliedAPISchema and not cls.isMultipleApply %} + + .def("CanApply", &_WrapCanApply, (arg("prim"))) + .staticmethod("CanApply") +{% endif %} +{% if cls.isAppliedAPISchema and cls.isMultipleApply %} + + .def("CanApply", &_WrapCanApply, (arg("prim"), arg("name"))) + .staticmethod("CanApply") +{% endif %} +{% if cls.isAppliedAPISchema and not cls.isMultipleApply %} + + .def("Apply", &This::Apply, (arg("prim"))) + .staticmethod("Apply") +{% endif %} +{% if cls.isAppliedAPISchema and cls.isMultipleApply %} + + .def("Apply", &This::Apply, (arg("prim"), arg("name"))) + .staticmethod("Apply") +{% endif %} + +{% if cls.isMultipleApply %} + .def("GetSchemaAttributeNames", + (const TfTokenVector &(*)(bool))&This::GetSchemaAttributeNames, + arg("includeInherited")=true, + return_value_policy()) + .def("GetSchemaAttributeNames", + (TfTokenVector(*)(bool, const TfToken &)) + &This::GetSchemaAttributeNames, + arg("includeInherited"), + arg("instanceName"), + return_value_policy()) +{% else %} + .def("GetSchemaAttributeNames", + &This::GetSchemaAttributeNames, + arg("includeInherited")=true, + return_value_policy()) +{% endif %} + .staticmethod("GetSchemaAttributeNames") + + .def("_GetStaticTfType", (TfType const &(*)()) TfType::Find, + return_value_policy()) + .staticmethod("_GetStaticTfType") + + .def(!self) + +{% for attrName in cls.attrOrder -%} +{% set attr = cls.attrs[attrName] %} +{# Only emit Create/Get API if apiName is not empty string. #} +{% if attr.apiName != '' %} + + .def("Get{{ Proper(attr.apiName) }}Attr", + &This::Get{{ Proper(attr.apiName) }}Attr) + .def("Create{{ Proper(attr.apiName) }}Attr", + &_Create{{ Proper(attr.apiName) }}Attr, + (arg("defaultValue")=object(), + arg("writeSparsely")=false)) +{% endif %} +{% endfor %} + +{% for relName in cls.relOrder -%} +{# Only emit Create/Get API and doxygen if apiName is not empty string. #} +{% set rel = cls.rels[relName] %} +{% if rel.apiName != '' %} + + .def("Get{{ Proper(rel.apiName) }}Rel", + &This::Get{{ Proper(rel.apiName) }}Rel) + .def("Create{{ Proper(rel.apiName) }}Rel", + &This::Create{{ Proper(rel.apiName) }}Rel) +{% endif %} +{% endfor %} +{% if cls.isMultipleApply and cls.propertyNamespacePrefix %} + .def("Is{{ cls.usdPrimTypeName }}Path", _WrapIs{{ cls.usdPrimTypeName }}Path) + .staticmethod("Is{{ cls.usdPrimTypeName }}Path") +{% endif %} +{% if not cls.isAPISchemaBase %} + .def("__repr__", ::_Repr) +{% endif %} + ; + + _CustomWrapCode(cls); +} + +// ===================================================================== // +// Feel free to add custom code below this line, it will be preserved by +// the code generator. The entry point for your custom code should look +// minimally like the following: +// +// WRAP_CUSTOM { +// _class +// .def("MyCustomMethod", ...) +// ; +// } +// +// Of course any other ancillary or support code may be provided. +{% if useExportAPI %} +// +// Just remember to wrap code in the appropriate delimiters: +// 'namespace {', '}'. +// +{% endif %} +// ===================================================================== // +// --(BEGIN CUSTOM CODE)-- + +// +// Copyright 2016 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// +// GENERATED FILE. DO NOT EDIT. +#include +#include "{{ libraryPath }}/tokens.h" + +{% if useExportAPI %} +{{ namespaceUsing }} + +{% endif %} +namespace { + +// Helper to return a static token as a string. We wrap tokens as Python +// strings and for some reason simply wrapping the token using def_readonly +// bypasses to-Python conversion, leading to the error that there's no +// Python type for the C++ TfToken type. So we wrap this functor instead. +class _WrapStaticToken { +public: + _WrapStaticToken(const TfToken* token) : _token(token) { } + + std::string operator()() const + { + return _token->GetString(); + } + +private: + const TfToken* _token; +}; + +template +void +_AddToken(T& cls, const char* name, const TfToken& token) +{ + cls.add_static_property(name, + boost::python::make_function( + _WrapStaticToken(&token), + boost::python::return_value_policy< + boost::python::return_by_value>(), + boost::mpl::vector1())); +} + +} // anonymous + +void wrap{{ tokensPrefix }}Tokens() +{ + boost::python::class_<{{ tokensPrefix }}TokensType, boost::noncopyable> + cls("Tokens", boost::python::no_init); +{% for token in tokens %} + _AddToken(cls, "{{ token.id }}", {{ tokensPrefix }}Tokens->{{ token.id }}); +{% endfor %} +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class "Typed" ( + doc = '''The base class for all typed schemas (those that can impart a + typeName to a UsdPrim), and therefore the base class for all + concrete, instantiable "IsA" schemas. + + UsdTyped implements a typeName-based query for its override of + UsdSchemaBase::_IsCompatible(). It provides no other behavior.''' +) +{ +} + +class "APISchemaBase" ( + doc = """The base class for all API schemas. + + An API schema provides an interface to a prim's qualities, but does not + specify a typeName for the underlying prim. The prim's qualities include + its inheritance structure, attributes, relationships etc. Since it cannot + provide a typeName, an API schema is considered to be non-concrete. + + To auto-generate an API schema using usdGenSchema, simply leave the + typeName empty and make it inherit from \"/APISchemaBase\" or from another + API schema. See UsdModelAPI, UsdClipsAPI and UsdCollectionAPI for examples. + + API schemas are classified into applied and non-applied API schemas. + The author of an API schema has to decide on the type of API schema + at the time of its creation by setting customData['apiSchemaType'] in the + schema definition (i.e. in the associated primSpec inside the schema.usda + file). UsdAPISchemaBase implements methods that are used to record the + application of an API schema on a USD prim. + + If an API schema only provides an interface to set certain core bits of + metadata (like UsdModelAPI, which sets model kind and UsdClipsAPI, which + sets clips-related metadata) OR if the API schema can apply to any type of + prim or only to a known fixed set of prim types OR if there is no use of + recording the application of the API schema, in such cases, it would be + better to make it a non-applied API schema. Examples of non-applied API + schemas include UsdModelAPI, UsdClipsAPI, UsdShadeConnectableAPI and + UsdGeomPrimvarsAPI. + + If there is a need to discover (or record) whether a prim contains or + subscribes to a given API schema, it would be advantageous to make the API + schema be \"applied\". In general, API schemas that add one or more properties + to a prim should be tagged as applied API schemas. A public Apply() method + is generated for applied API schemas by usdGenSchema. An applied API schema + must be applied to a prim via a call to the generated Apply() method, for + the schema object to evaluate to true when converted to a bool using the + explicit bool conversion operator. Examples of applied API schemas include + UsdCollectionAPI, UsdGeomModelAPI and UsdGeomMotionAPI + + \\anchor UsdAPISchemaBase_SingleVsMultipleApply + \\name Single vs. Multiple Apply API Schemas + + Applied API schemas can further be classified into single-apply and + multiple-apply API schemas. As the name suggests, a single-apply API schema + can only be applied once to a prim. A multiple-apply API schema can be + applied multiple times with different 'instanceName' values. An example of + a multiple-apply API schema is UsdCollectionAPI, where the API schema is + applied to a prim once for every collection owned by the prim. + + \\note An applied API schema can only inherit from another applied API + schema or directly from APISchemaBase. Similarly, a non-applied API schema + can only inherit from a non-applied API Schema or directly from + APISchemaBase. 'usdGenSchema' attempts to issue a warning if it detects + an incompatibility. + + \\note A multiple-apply API schema may not inherit from a single-apply API + schema and vice versa. + + \\note When the bool-conversion operator is invoked on an applied API + schema, it evaluates to true only if the application of the API schema has + been recorded on the prim via a call to the auto-generated Apply() method. + + """ +) +{ +} + +class "ModelAPI" ( + doc = """UsdModelAPI is an API schema that provides an interface to a prim's + model qualities, if it does, in fact, represent the root prim of a model. + + The first and foremost model quality is its kind, i.e. the metadata + that establishes it as a model (See KindRegistry). UsdModelAPI provides + various methods for setting and querying the prim's kind, as well as + queries (also available on UsdPrim) for asking what category of model + the prim is. See \"Kind and Model-ness\". + + UsdModelAPI also provides access to a prim's \"assetInfo\" + data. While any prim can host assetInfo, it is common that published + (referenced) assets are packaged as models, therefore it is convenient + to provide access to the one from the other. + + \\todo establish an _IsCompatible() override that returns IsModel() + \\todo GetModelInstanceName() + """ +) +{ +} + +class "CollectionAPI" ( + doc = """ This is a general purpose API schema, used to describe a + collection of heterogeneous objects within the scene. \"Objects\" here may be + prims or properties belonging to prims or other collections. It's an add-on + schema that can be applied many times to a prim with different collection + names. + + A collection allows an enumeration of a set of paths to include and a + set of paths to exclude. Whether the descendants of an included + path are members of a collection are decided by its expansion rule + (see below). If the collection excludes paths that are not descendents + of included paths, the collection implicitly includes the root path + </>. If such a collection also includes paths that are not + descendants of the excluded paths, it is considered invalid, since + the intention is ambiguous. + + All the properties authored by the schema are namespaced under + \"collection:\". The given name of the collection provides additional + namespacing for the various per-collection properties, which include the + following: + +
  • uniform token collection:collectionName:expansionRule - + specified how the paths that are included in the collection must be expanded + to determine its members. Possible values include: +
      +
    • explicitOnly - only paths in the includes rel targets and not + in the excludes rel targets belong to the collection. +
      • +
    • expandPrims - all the prims at or below the includes rel- + targets (and not under the excludes rel-targets) belong to the + collection. Any property paths included in the collection would, of + course, also be honored. This is the default behavior as it satisfies + most use cases. +
      • +
    • expandPrimsAndProperties - like expandPrims, but also + includes all properties on all matched prims. We're still not quite + sure what the use cases are for this, but you can use it to capture a + whole lot of UsdObjects very concisely. +
      • +
    +
    • +
  • bool collection:collectionName:includeRoot - boolean + attribute indicating whether the pseudo-root path </> should + be counted as one of the included target paths. The fallback is false. + This separate attribute is required because relationships cannot + directly target the root. When expansionRule is explicitOnly, this + attribute is ignored. +
  • rel collection:collectionName:includes - specifies a list + of targets that are included in the collection. This can target prims or + properties directly. A collection can insert the rules of another + collection by making its includes relationship target the + collection:{collectionName} property on the owning prim of the + collection to be included (see UsdCollectionAPI::GetCollectionAttr). + It is important to note that including another collection does not + guarantee the contents of that collection will be in the final collection; + instead, the rules are merged. This means, for example, an exclude + entry may exclude a portion of the included collection. + When a collection includes one or more collections, the order in which + targets are added to the includes relationship may become significant, if + there are conflicting opinions about the same path. Targets that are added + later are considered to be stronger than earlier targets for the same path. +
    • +
  • rel collection:collectionName:excludes - specifies a list + of targets that are excluded below the included paths in this + collection. This can target prims or properties directly, but cannot + target another collection. This is to keep the membership determining + logic simple, efficient and easier to reason about. Finally, it is invalid + for a collection to exclude paths that are not included in it. The presence + of such \"orphaned\" excluded paths will not affect the set of paths included + in the collection, but may affect the performance of querying membership of + a path in the collection (see UsdCollectionAPI::MembershipQuery::IsPathIncluded) + or of enumerating the objects belonging to the collection (see + UsdCollectionAPI::GetIncludedObjects). +
    • +
  • uniform opaque collection:collectionName - opaque + attribute (meaning it can never have a value) that represents the collection + for the purpose of allowing another collection to include it. When this + property is targeted by another collection's includes relationship, + the rules of this collection will be inserted into the rules of the collection + that includes it. +
+ + Implicit inclusion + + In some scenarios it is useful to express a collection that includes + everything except certain paths. To support this, a collection + that has an exclude that is not a descendent of any include + will include the root path </>. + + Creating collections in C++ + + \\snippet examples_usd.cpp ApplyCollections + """ +) +{ + uniform opaque collection:__INSTANCE_NAME__ ( + doc = """This property represents the collection for the purpose of + allowing another collection to include it. When this property is + targeted by another collection's includes relationship, the rules + of this collection will be inserted into the rules of the collection + that includes it. + """ + ) + rel collection:__INSTANCE_NAME__:excludes ( + doc = '''Specifies a list of targets that are excluded below + the included paths in this collection. This can target prims or + properties directly, but cannot target another collection. This is to + keep the membership determining logic simple, efficient and easier to + reason about. Finally, it is invalid for a collection to exclude + paths that are not included in it. The presence of such "orphaned" + excluded paths will not affect the set of paths included in the + collection, but may affect the performance of querying membership of + a path in the collection (see + UsdCollectionAPI::MembershipQuery::IsPathIncluded) + or of enumerating the objects belonging to the collection (see + UsdCollectionAPI::GetIncludedObjects).''' + ) + uniform token collection:__INSTANCE_NAME__:expansionRule = "expandPrims" ( + allowedTokens = ["explicitOnly", "expandPrims", "expandPrimsAndProperties"] + doc = """Specifies how the paths that are included in + the collection must be expanded to determine its members.""" + ) + uniform bool collection:__INSTANCE_NAME__:includeRoot ( + doc = """Boolean attribute indicating whether the pseudo-root + path </> should be counted as one of the included target + paths. The fallback is false. This separate attribute is + required because relationships cannot directly target the root.""" + ) + rel collection:__INSTANCE_NAME__:includes ( + doc = """Specifies a list of targets that are included in the collection. + This can target prims or properties directly. A collection can insert + the rules of another collection by making its includes + relationship target the collection:{collectionName} property on + the owning prim of the collection to be included""" + ) + uniform pathExpression collection:__INSTANCE_NAME__:membershipExpression ( + doc = """Specifies a path expression that determines membership in this + collection.""" + ) +} + +class "ClipsAPI" ( + doc = """ UsdClipsAPI is an API schema that provides an interface to + a prim's clip metadata. Clips are a \"value resolution\" feature that + allows one to specify a sequence of usd files (clips) to be consulted, + over time, as a source of varying overrides for the prims at and + beneath this prim in namespace. + + SetClipAssetPaths() establishes the set of clips that can be consulted. + SetClipActive() specifies the ordering of clip application over time + (clips can be repeated), while SetClipTimes() specifies time-mapping + from stage-time to clip-time for the clip active at a given stage-time, + which allows for time-dilation and repetition of clips. + Finally, SetClipPrimPath() determines the path within each clip that will + map to this prim, i.e. the location within the clip at which we will look + for opinions for this prim. + + The clip asset paths, times and active metadata can also be specified + through template clip metadata. This can be desirable when your set of + assets is very large, as the template metadata is much more concise. + SetClipTemplateAssetPath() establishes the asset identifier pattern of the + set of clips to be consulted. SetClipTemplateStride(), + SetClipTemplateEndTime(), and SetClipTemplateStartTime() specify the range + in which USD will search, based on the template. From the set of resolved + asset paths, times and active will be derived internally. + + A prim may have multiple \"clip sets\" -- named sets of clips that each + have their own values for the metadata described above. For example, + a prim might have a clip set named \"Clips_1\" that specifies some group + of clip asset paths, and another clip set named \"Clips_2\" that uses + an entirely different set of clip asset paths. These clip sets are + composed across composition arcs, so clip sets for a prim may be + defined in multiple sublayers or references, for example. Individual + metadata for a given clip set may be sparsely overridden. + + Important facts about clips: + - Within the layerstack in which clips are established, the + opinions within the clips will be weaker than any local opinions + in the layerstack, but em stronger than varying opinions coming across + references and variants. + - We will never look for metadata or default opinions in clips + when performing value resolution on the owning stage, since these + quantities must be time-invariant. + + This leads to the common structure in which we reference a model asset + on a prim, and then author clips at the same site: the asset reference + will provide the topology and unvarying data for the model, while the + clips will provide the time-sampled animation. + + For further information, see \\ref Usd_Page_ValueClips + """ +) +{ +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "apiSchemas": { + "appliesTo": "prims", + "type": "tokenlistop" + }, + "clipSets": { + "appliesTo": [ + "prims" + ], + "type": "stringlistop" + }, + "clips": { + "appliesTo": [ + "prims" + ], + "type": "dictionary" + }, + "fallbackPrimTypes": { + "appliesTo": [ + "layers" + ], + "type": "dictionary" + } + }, + "Types": { + "UsdAPISchemaBase": { + "alias": { + "UsdSchemaBase": "APISchemaBase" + }, + "autoGenerated": true, + "bases": [ + "UsdSchemaBase" + ], + "schemaKind": "abstractBase" + }, + "UsdClipsAPI": { + "alias": { + "UsdSchemaBase": "ClipsAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "nonAppliedAPI" + }, + "UsdCollectionAPI": { + "alias": { + "UsdSchemaBase": "CollectionAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "multipleApplyAPI" + }, + "UsdModelAPI": { + "alias": { + "UsdSchemaBase": "ModelAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "nonAppliedAPI" + }, + "UsdSchemaBase": { + "alias": { + "UsdSchemaBase": "SchemaBase" + }, + "schemaKind": "abstractBase" + }, + "UsdTyped": { + "alias": { + "UsdSchemaBase": "Typed" + }, + "autoGenerated": true, + "bases": [ + "UsdSchemaBase" + ], + "schemaKind": "abstractBase" + }, + "UsdUsdFileFormat": { + "bases": [ + "SdfFileFormat" + ], + "displayName": "USD File Format", + "extensions": [ + "usd" + ], + "formatId": "usd", + "primary": true, + "target": "usd" + }, + "UsdUsdaFileFormat": { + "bases": [ + "SdfTextFileFormat" + ], + "displayName": "USD Text File Format", + "extensions": [ + "usda" + ], + "formatId": "usda", + "primary": true, + "target": "usd" + }, + "UsdUsdcFileFormat": { + "bases": [ + "SdfFileFormat" + ], + "displayName": "USD Crate File Format", + "extensions": [ + "usdc" + ], + "formatId": "usdc", + "primary": true, + "target": "usd" + }, + "UsdUsdzFileFormat": { + "bases": [ + "SdfFileFormat" + ], + "displayName": "USDZ File Format", + "extensions": [ + "usdz" + ], + "formatId": "usdz", + "primary": true, + "supportsEditing": false, + "supportsWriting": false, + "target": "usd" + }, + "Usd_UsdzResolver": { + "bases": [ + "ArPackageResolver" + ], + "extensions": [ + "usdz" + ] + } + } + }, + "LibraryPath": "", + "Name": "usd", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + "This file describes the USD primitive schemata and drives code generation." +) + +def "GLOBAL" ( + customData = { + string libraryName = "usd" + string libraryPath = "pxr/usd/usd" + # string libraryPrefix = "Usd" + # string tokensPrefix = "Usd" + dictionary libraryTokens = { + dictionary apiSchemas = { + string doc = """ + A listop metadata containing the API schemas which have + been applied to this prim, using the Apply() method on + the particular schema class. + """ + } + dictionary fallbackPrimTypes = { + string doc = """ + A dictionary metadata that maps the name of a concrete schema + prim type to an ordered list of schema prim types to use instead + if the schema prim type doesn't exist in version of USD being + used. + """ + } + } + } +) +{ +} + +class "Typed" +( + doc = """The base class for all \\em typed schemas (those that can impart a + typeName to a UsdPrim), and therefore the base class for all + concrete, instantiable "IsA" schemas. + + UsdTyped implements a typeName-based query for its override of + UsdSchemaBase::_IsCompatible(). It provides no other behavior.""" +) +{ +} + +class "APISchemaBase" +( + doc = """The base class for all \\em API schemas. + + An API schema provides an interface to a prim's qualities, but does not + specify a typeName for the underlying prim. The prim's qualities include + its inheritance structure, attributes, relationships etc. Since it cannot + provide a typeName, an API schema is considered to be non-concrete. + + To auto-generate an API schema using usdGenSchema, simply leave the + typeName empty and make it inherit from "/APISchemaBase" or from another + API schema. See UsdModelAPI, UsdClipsAPI and UsdCollectionAPI for examples. + + API schemas are classified into applied and non-applied API schemas. + The author of an API schema has to decide on the type of API schema + at the time of its creation by setting customData['apiSchemaType'] in the + schema definition (i.e. in the associated primSpec inside the schema.usda + file). UsdAPISchemaBase implements methods that are used to record the + application of an API schema on a USD prim. + + If an API schema only provides an interface to set certain core bits of + metadata (like UsdModelAPI, which sets model kind and UsdClipsAPI, which + sets clips-related metadata) OR if the API schema can apply to any type of + prim or only to a known fixed set of prim types OR if there is no use of + recording the application of the API schema, in such cases, it would be + better to make it a non-applied API schema. Examples of non-applied API + schemas include UsdModelAPI, UsdClipsAPI, UsdShadeConnectableAPI and + UsdGeomPrimvarsAPI. + + If there is a need to discover (or record) whether a prim contains or + subscribes to a given API schema, it would be advantageous to make the API + schema be "applied". In general, API schemas that add one or more properties + to a prim should be tagged as applied API schemas. A public Apply() method + is generated for applied API schemas by usdGenSchema. An applied API schema + must be applied to a prim via a call to the generated Apply() method, for + the schema object to evaluate to true when converted to a bool using the + explicit bool conversion operator. Examples of applied API schemas include + UsdCollectionAPI, UsdGeomModelAPI and UsdGeomMotionAPI + + \\anchor UsdAPISchemaBase_SingleVsMultipleApply + \\name Single vs. Multiple Apply API Schemas + + Applied API schemas can further be classified into single-apply and + multiple-apply API schemas. As the name suggests, a single-apply API schema + can only be applied once to a prim. A multiple-apply API schema can be + applied multiple times with different 'instanceName' values. An example of + a multiple-apply API schema is UsdCollectionAPI, where the API schema is + applied to a prim once for every collection owned by the prim. + + \\note An applied API schema can only inherit from another applied API + schema or directly from APISchemaBase. Similarly, a non-applied API schema + can only inherit from a non-applied API Schema or directly from + APISchemaBase. 'usdGenSchema' attempts to issue a warning if it detects + an incompatibility. + + \\note A multiple-apply API schema may not inherit from a single-apply API + schema and vice versa. + + \\note When the bool-conversion operator is invoked on an applied API + schema, it evaluates to true only if the application of the API schema has + been recorded on the prim via a call to the auto-generated Apply() method. + + """ + customData = { + string fileName = "apiSchemaBase" + } +) +{ +} + +class "ModelAPI" +( + inherits = + doc = """UsdModelAPI is an API schema that provides an interface to a prim's + model qualities, if it does, in fact, represent the root prim of a model. + + The first and foremost model quality is its \\em kind, i.e. the metadata + that establishes it as a model (See KindRegistry). UsdModelAPI provides + various methods for setting and querying the prim's kind, as well as + queries (also available on UsdPrim) for asking what category of model + the prim is. See \\ref Usd_ModelKind "Kind and Model-ness". + + UsdModelAPI also provides access to a prim's \\ref Usd_Model_AssetInfo "assetInfo" + data. While any prim \\em can host assetInfo, it is common that published + (referenced) assets are packaged as models, therefore it is convenient + to provide access to the one from the other. + + \\todo establish an _IsCompatible() override that returns IsModel() + \\todo GetModelInstanceName() + """ + customData = { + string apiSchemaType = "nonApplied" + } +) +{ +} + +class "CollectionAPI" +( + inherits = + doc = """ This is a general purpose API schema, used to describe a + collection of heterogeneous objects within the scene. "Objects" here may be + prims or properties belonging to prims or other collections. It's an add-on + schema that can be applied many times to a prim with different collection + names. + + A collection allows an enumeration of a set of paths to include and a + set of paths to exclude. Whether the descendants of an included + path are members of a collection are decided by its expansion rule + (see below). If the collection excludes paths that are not descendents + of included paths, the collection implicitly includes the root path + </>. If such a collection also includes paths that are not + descendants of the excluded paths, it is considered invalid, since + the intention is ambiguous. + + All the properties authored by the schema are namespaced under + "collection:". The given name of the collection provides additional + namespacing for the various per-collection properties, which include the + following: + +
  • uniform token collection:collectionName:expansionRule - + specified how the paths that are included in the collection must be expanded + to determine its members. Possible values include: +
      +
    • explicitOnly - only paths in the includes rel targets and not + in the excludes rel targets belong to the collection. +
      • +
    • expandPrims - all the prims at or below the includes rel- + targets (and not under the excludes rel-targets) belong to the + collection. Any property paths included in the collection would, of + course, also be honored. This is the default behavior as it satisfies + most use cases. +
      • +
    • expandPrimsAndProperties - like expandPrims, but also + includes all properties on all matched prims. We're still not quite + sure what the use cases are for this, but you can use it to capture a + whole lot of UsdObjects very concisely. +
      • +
    +
    • +
  • bool collection:collectionName:includeRoot - boolean + attribute indicating whether the pseudo-root path </> should + be counted as one of the included target paths. The fallback is false. + This separate attribute is required because relationships cannot + directly target the root. When expansionRule is explicitOnly, this + attribute is ignored. +
  • rel collection:collectionName:includes - specifies a list + of targets that are included in the collection. This can target prims or + properties directly. A collection can insert the rules of another + collection by making its includes relationship target the + collection:{collectionName} property on the owning prim of the + collection to be included (see UsdCollectionAPI::GetCollectionAttr). + It is important to note that including another collection does not + guarantee the contents of that collection will be in the final collection; + instead, the rules are merged. This means, for example, an exclude + entry may exclude a portion of the included collection. + When a collection includes one or more collections, the order in which + targets are added to the includes relationship may become significant, if + there are conflicting opinions about the same path. Targets that are added + later are considered to be stronger than earlier targets for the same path. +
    • +
  • rel collection:collectionName:excludes - specifies a list + of targets that are excluded below the included paths in this + collection. This can target prims or properties directly, but cannot + target another collection. This is to keep the membership determining + logic simple, efficient and easier to reason about. Finally, it is invalid + for a collection to exclude paths that are not included in it. The presence + of such "orphaned" excluded paths will not affect the set of paths included + in the collection, but may affect the performance of querying membership of + a path in the collection (see UsdCollectionAPI::MembershipQuery::IsPathIncluded) + or of enumerating the objects belonging to the collection (see + UsdCollectionAPI::GetIncludedObjects). +
    • +
  • uniform opaque collection:collectionName - opaque + attribute (meaning it can never have a value) that represents the collection + for the purpose of allowing another collection to include it. When this + property is targeted by another collection's includes relationship, + the rules of this collection will be inserted into the rules of the collection + that includes it. +
+ + Implicit inclusion + + In some scenarios it is useful to express a collection that includes + everything except certain paths. To support this, a collection + that has an exclude that is not a descendent of any include + will include the root path </>. + + Creating collections in C++ + + \\snippet examples_usd.cpp ApplyCollections + """ + + customData = { + string extraIncludes = """ +#include "pxr/usd/usd/collectionMembershipQuery.h" +#include "pxr/usd/usd/primFlags.h" +#include "pxr/usd/usd/tokens.h" +#include "pxr/usd/sdf/pathExpression.h" +""" + token apiSchemaType = "multipleApply" + token propertyNamespacePrefix = "collection" + dictionary schemaTokens = { + dictionary exclude = { + string doc = """ + This is the token used to exclude a path from a collection. + Although it is not a possible value for the "expansionRule" + attribute, it is used as the expansionRule for excluded paths + in UsdCollectionAPI::MembershipQuery::IsPathIncluded. + """ + } + } + } +) +{ + uniform token expansionRule = "expandPrims" ( + allowedTokens = ["explicitOnly", "expandPrims", "expandPrimsAndProperties"] + doc = """Specifies how the paths that are included in + the collection must be expanded to determine its members.""" + ) + uniform bool includeRoot ( + doc = """Boolean attribute indicating whether the pseudo-root + path </> should be counted as one of the included target + paths. The fallback is false. This separate attribute is + required because relationships cannot directly target the root.""" + ) + rel includes ( + doc = """Specifies a list of targets that are included in the collection. + This can target prims or properties directly. A collection can insert + the rules of another collection by making its includes + relationship target the collection:{collectionName} property on + the owning prim of the collection to be included""" + ) + rel excludes ( + doc = """Specifies a list of targets that are excluded below + the included paths in this collection. This can target prims or + properties directly, but cannot target another collection. This is to + keep the membership determining logic simple, efficient and easier to + reason about. Finally, it is invalid for a collection to exclude + paths that are not included in it. The presence of such "orphaned" + excluded paths will not affect the set of paths included in the + collection, but may affect the performance of querying membership of + a path in the collection (see + UsdCollectionAPI::MembershipQuery::IsPathIncluded) + or of enumerating the objects belonging to the collection (see + UsdCollectionAPI::GetIncludedObjects).""" + ) + uniform pathExpression membershipExpression ( + doc = """Specifies a path expression that determines membership in this + collection.""" + ) + uniform opaque __INSTANCE_NAME__ ( + customData = { + string apiName = "Collection" + } + doc = """This property represents the collection for the purpose of + allowing another collection to include it. When this property is + targeted by another collection's includes relationship, the rules + of this collection will be inserted into the rules of the collection + that includes it. + """ + ) +} + +class "ClipsAPI" +( + inherits = + doc = """ UsdClipsAPI is an API schema that provides an interface to + a prim's clip metadata. Clips are a "value resolution" feature that + allows one to specify a sequence of usd files (clips) to be consulted, + over time, as a source of varying overrides for the prims at and + beneath this prim in namespace. + + SetClipAssetPaths() establishes the set of clips that can be consulted. + SetClipActive() specifies the ordering of clip application over time + (clips can be repeated), while SetClipTimes() specifies time-mapping + from stage-time to clip-time for the clip active at a given stage-time, + which allows for time-dilation and repetition of clips. + Finally, SetClipPrimPath() determines the path within each clip that will + map to this prim, i.e. the location within the clip at which we will look + for opinions for this prim. + + The clip asset paths, times and active metadata can also be specified + through template clip metadata. This can be desirable when your set of + assets is very large, as the template metadata is much more concise. + SetClipTemplateAssetPath() establishes the asset identifier pattern of the + set of clips to be consulted. SetClipTemplateStride(), + SetClipTemplateEndTime(), and SetClipTemplateStartTime() specify the range + in which USD will search, based on the template. From the set of resolved + asset paths, times and active will be derived internally. + + A prim may have multiple "clip sets" -- named sets of clips that each + have their own values for the metadata described above. For example, + a prim might have a clip set named "Clips_1" that specifies some group + of clip asset paths, and another clip set named "Clips_2" that uses + an entirely different set of clip asset paths. These clip sets are + composed across composition arcs, so clip sets for a prim may be + defined in multiple sublayers or references, for example. Individual + metadata for a given clip set may be sparsely overridden. + + Important facts about clips: + \\li Within the layerstack in which clips are established, the + opinions within the clips will be \\em weaker than any local opinions + in the layerstack, but \em stronger than varying opinions coming across + references and variants. + \\li We will never look for metadata or default opinions in clips + when performing value resolution on the owning stage, since these + quantities must be time-invariant. + + This leads to the common structure in which we reference a model asset + on a prim, and then author clips at the same site: the asset reference + will provide the topology and unvarying data for the model, while the + clips will provide the time-sampled animation. + + For further information, see \\ref Usd_Page_ValueClips + """ + customData = { + token apiSchemaType = "nonApplied" + dictionary schemaTokens = { + dictionary clips = { + string doc = """ + Dictionary that contains the definition of the clip sets on + this prim. See \\ref UsdClipsAPI::GetClips. + """ + } + + dictionary clipSets = { + string doc = """ + ListOp that may be used to affect how opinions from + clip sets are applied during value resolution. + See \\ref UsdClipsAPI::GetClipSets. + """ + } + } + } +) +{ +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class "Imageable" ( + doc = """Base class for all prims that may require rendering or + visualization of some sort. The primary attributes of Imageable + are visibility and purpose, which each provide instructions for + what geometry should be included for processing by rendering and other + computations. + + \\deprecated Imageable also provides API for accessing primvars, which + has been moved to the UsdGeomPrimvarsAPI schema, because primvars can now + be applied on non-Imageable prim types. This API is planned + to be removed, UsdGeomPrimvarsAPI should be used directly instead.""" +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) +} + +class "VisibilityAPI" ( + doc = ''' + UsdGeomVisibilityAPI introduces properties that can be used to author + visibility opinions. + + \\note + Currently, this schema only introduces the attributes that are used to + control purpose visibility. Later, this schema will define _all_ + visibility-related properties and UsdGeomImageable will no longer define + those properties. + + The purpose visibility attributes added by this schema, + _guideVisibility_, _proxyVisibility_, and _renderVisibility_ can each be + used to control visibility for geometry of the corresponding purpose + values, with the overall _visibility_ attribute acting as an + override. I.e., if _visibility_ evaluates to "invisible", purpose + visibility is invisible; otherwise, purpose visibility is determined by + the corresponding purpose visibility attribute. + + Note that the behavior of _guideVisibility_ is subtly different from the + _proxyVisibility_ and _renderVisibility_ attributes, in that "guide" + purpose visibility always evaluates to either "invisible" or "visible", + whereas the other attributes may yield computed values of "inherited" if + there is no authored opinion on the attribute or inherited from an + ancestor. This is motivated by the fact that, in Pixar"s user workflows, + we have never found a need to have all guides visible in a scene by + default, whereas we do find that flexibility useful for "proxy" and + "render" geometry. + + This schema can only be applied to UsdGeomImageable prims. The + UseGeomImageable schema provides API for computing the purpose visibility + values that result from the attributes introduced by this schema. + ''' +) +{ + uniform token guideVisibility = "invisible" ( + allowedTokens = ["inherited", "invisible", "visible"] + doc = ''' + This attribute controls visibility for geometry with purpose "guide". + + Unlike overall _visibility_, _guideVisibility_ is uniform, and + therefore cannot be animated. + + Also unlike overall _visibility_, _guideVisibility_ is tri-state, in + that a descendant with an opinion of "visible" overrides an ancestor + opinion of "invisible". + + The _guideVisibility_ attribute works in concert with the overall + _visibility_ attribute: The visibility of a prim with purpose "guide" + is determined by the inherited values it receives for the _visibility_ + and _guideVisibility_ attributes. If _visibility_ evaluates to + "invisible", the prim is invisible. If _visibility_ evaluates to + "inherited" and _guideVisibility_ evaluates to "visible", then the + prim is visible. __Otherwise, it is invisible.__ + ''' + ) + uniform token proxyVisibility = "inherited" ( + allowedTokens = ["inherited", "invisible", "visible"] + doc = ''' + This attribute controls visibility for geometry with purpose "proxy". + + Unlike overall _visibility_, _proxyVisibility_ is uniform, and + therefore cannot be animated. + + Also unlike overall _visibility_, _proxyVisibility_ is tri-state, in + that a descendant with an opinion of "visible" overrides an ancestor + opinion of "invisible". + + The _proxyVisibility_ attribute works in concert with the overall + _visibility_ attribute: The visibility of a prim with purpose "proxy" + is determined by the inherited values it receives for the _visibility_ + and _proxyVisibility_ attributes. If _visibility_ evaluates to + "invisible", the prim is invisible. If _visibility_ evaluates to + "inherited" then: If _proxyVisibility_ evaluates to "visible", then + the prim is visible; if _proxyVisibility_ evaluates to "invisible", + then the prim is invisible; if _proxyVisibility_ evaluates to + "inherited", then the prim may either be visible or invisible, + depending on a fallback value determined by the calling context. + ''' + ) + uniform token renderVisibility = "inherited" ( + allowedTokens = ["inherited", "invisible", "visible"] + doc = ''' + This attribute controls visibility for geometry with purpose + "render". + + Unlike overall _visibility_, _renderVisibility_ is uniform, and + therefore cannot be animated. + + Also unlike overall _visibility_, _renderVisibility_ is tri-state, in + that a descendant with an opinion of "visible" overrides an ancestor + opinion of "invisible". + + The _renderVisibility_ attribute works in concert with the overall + _visibility_ attribute: The visibility of a prim with purpose "render" + is determined by the inherited values it receives for the _visibility_ + and _renderVisibility_ attributes. If _visibility_ evaluates to + "invisible", the prim is invisible. If _visibility_ evaluates to + "inherited" then: If _renderVisibility_ evaluates to "visible", then + the prim is visible; if _renderVisibility_ evaluates to "invisible", + then the prim is invisible; if _renderVisibility_ evaluates to + "inherited", then the prim may either be visible or invisible, + depending on a fallback value determined by the calling context. + ''' + ) +} + +class "PrimvarsAPI" ( + doc = """UsdGeomPrimvarsAPI encodes geometric \"primitive variables\", + as UsdGeomPrimvar, which interpolate across a primitive's topology, + can override shader inputs, and inherit down namespace. + + Which Method to Use to Retrieve Primvars + + While creating primvars is unambiguous (CreatePrimvar()), there are quite + a few methods available for retrieving primvars, making it potentially + confusing knowing which one to use. Here are some guidelines: + + - If you are populating a GUI with the primvars already available for + authoring values on a prim, use GetPrimvars(). + - If you want all of the \"useful\" (e.g. to a renderer) primvars + available at a prim, including those inherited from ancestor prims, use + FindPrimvarsWithInheritance(). Note that doing so individually for many + prims will be inefficient. + - To find a particular primvar defined directly on a prim, which may + or may not provide a value, use GetPrimvar(). + - To find a particular primvar defined on a prim or inherited from + ancestors, which may or may not provide a value, use + FindPrimvarWithInheritance(). + - To *efficiently* query for primvars using the overloads of + FindPrimvarWithInheritance() and FindPrimvarsWithInheritance(), one + must first cache the results of FindIncrementallyInheritablePrimvars() for + each non-leaf prim on the stage. """ +) +{ +} + +class "Xformable" ( + doc = """Base class for all transformable prims, which allows arbitrary + sequences of component affine transformations to be encoded. + + \\note + You may find it useful to review while reading + this class description. + + Supported Component Transformation Operations + + UsdGeomXformable currently supports arbitrary sequences of the following + operations, each of which can be encoded in an attribute of the proper + shape in any supported precision: + - translate - 3D + - scale - 3D + - rotateX - 1D angle in degrees + - rotateY - 1D angle in degrees + - rotateZ - 1D angle in degrees + - rotateABC - 3D where ABC can be any combination of the six principle + Euler Angle sets: XYZ, XZY, YXZ, YZX, ZXY, ZYX. See + \"note on rotation packing order\" + - orient - 4D (quaternion) + - transform - 4x4D + + Creating a Component Transformation + + To add components to a UsdGeomXformable prim, simply call AddXformOp() + with the desired op type, as enumerated in \\ref UsdGeomXformOp::Type, + and the desired precision, which is one of \\ref UsdGeomXformOp::Precision. + Optionally, you can also provide an \"op suffix\" for the operator that + disambiguates it from other components of the same type on the same prim. + Application-specific transform schemas can use the suffixes to fill a role + similar to that played by AbcGeom::XformOp's \"Hint\" enums for their own + round-tripping logic. + + We also provide specific \"Add\" API for each type, for clarity and + conciseness, e.g. AddTranslateOp(), AddRotateXYZOp() etc. + + AddXformOp() will return a UsdGeomXformOp object, which is a schema on a + newly created UsdAttribute that provides convenience API for authoring + and computing the component transformations. The UsdGeomXformOp can then + be used to author any number of timesamples and default for the op. + + Each successive call to AddXformOp() adds an operator that will be applied + \"more locally\" than the preceding operator, just as if we were pushing + transforms onto a transformation stack - which is precisely what should + happen when the operators are consumed by a reader. + + \\note + If you can, please try to use the UsdGeomXformCommonAPI, which wraps + the UsdGeomXformable with an interface in which Op creation is taken + care of for you, and there is a much higher chance that the data you + author will be importable without flattening into other DCC's, as it + conforms to a fixed set of Scale-Rotate-Translate Ops. + + \\sa \"Using the Authoring API\" + + Data Encoding and Op Ordering + + Because there is no \"fixed schema\" of operations, all of the attributes + that encode transform operations are dynamic, and are scoped in + the namespace \"xformOp\". The second component of an attribute's name provides + the type of operation, as listed above. An \"xformOp\" attribute can + have additional namespace components derived from the opSuffix argument + to the AddXformOp() suite of methods, which provides a preferred way of + naming the ops such that we can have multiple \"translate\" ops with unique + attribute names. For example, in the attribute named + \"xformOp:translate:maya:pivot\", \"translate\" is the type of operation and + \"maya:pivot\" is the suffix. + + The following ordered list of attribute declarations in usda + define a basic Scale-Rotate-Translate with XYZ Euler angles, wherein the + translation is double-precision, and the remainder of the ops are single, + in which we will: + +
    +
  1. Scale by 2.0 in each dimension +
  2. Rotate about the X, Y, and Z axes by 30, 60, and 90 degrees, respectively +
  3. Translate by 100 units in the Y direction +
+ + \\code + float3 xformOp:rotateXYZ = (30, 60, 90) + float3 xformOp:scale = (2, 2, 2) + double3 xformOp:translate = (0, 100, 0) + uniform token[] xformOpOrder = [ \"xformOp:translate\", \"xformOp:rotateXYZ\", \"xformOp:scale\" ] + \\endcode + + The attributes appear in the dictionary order in which USD, by default, + sorts them. To ensure the ops are recovered and evaluated in the correct + order, the schema introduces the **xformOpOrder** attribute, which + contains the names of the op attributes, in the precise sequence in which + they should be pushed onto a transform stack. **Note** that the order is + opposite to what you might expect, given the matrix algebra described in + This also dictates order of op creation, + since each call to AddXformOp() adds a new op to the end of the + \\b xformOpOrder array, as a new \"most-local\" operation. See + \"Example 2 below\" for C++ code that could + have produced this USD. + + If it were important for the prim's rotations to be independently + overridable, we could equivalently (at some performance cost) encode + the transformation also like so: + \\code + float xformOp:rotateX = 30 + float xformOp:rotateY = 60 + float xformOp:rotateZ = 90 + float3 xformOp:scale = (2, 2, 2) + double3 xformOp:translate = (0, 100, 0) + uniform token[] xformOpOrder = [ \"xformOp:translate\", \"xformOp:rotateZ\", \"xformOp:rotateY\", \"xformOp:rotateX\", \"xformOp:scale\" ] + \\endcode + + Again, note that although we are encoding an XYZ rotation, the three + rotations appear in the **xformOpOrder** in the opposite order, with Z, + followed, by Y, followed by X. + + Were we to add a Maya-style scalePivot to the above example, it might + look like the following: + \\code + float3 xformOp:rotateXYZ = (30, 60, 90) + float3 xformOp:scale = (2, 2, 2) + double3 xformOp:translate = (0, 100, 0) + double3 xformOp:translate:scalePivot + uniform token[] xformOpOrder = [ \"xformOp:translate\", \"xformOp:rotateXYZ\", \"xformOp:translate:scalePivot\", \"xformOp:scale\" ] + \\endcode + + Paired \"Inverted\" Ops + + We have been claiming that the ordered list of ops serves as a set + of instructions to a transform stack, but you may have noticed in the last + example that there is a missing operation - the pivot for the scale op + needs to be applied in its inverse-form as a final (most local) op! In the + AbcGeom::Xform schema, we would have encoded an actual \"final\" translation + op whose value was authored by the exporter as the negation of the pivot's + value. However, doing so would be brittle in USD, given that each op can + be independently overridden, and the constraint that one attribute must be + maintained as the negation of the other in order for successful + re-importation of the schema cannot be expressed in USD. + + Our solution leverages the **xformOpOrder** member of the schema, which, + in addition to ordering the ops, may also contain one of two special + tokens that address the paired op and \"stack resetting\" behavior. + + The \"paired op\" behavior is encoded as an \"!invert!\" prefix in + \\b xformOpOrder, as the result of an AddXformOp(isInverseOp=True) call. + The \\b xformOpOrder for the last example would look like: + \\code + uniform token[] xformOpOrder = [ \"xformOp:translate\", \"xformOp:rotateXYZ\", \"xformOp:translate:scalePivot\", \"xformOp:scale\", \"!invert!xformOp:translate:scalePivot\" ] + \\endcode + + When asked for its value via UsdGeomXformOp::GetOpTransform(), an + \"inverted\" Op (i.e. the \"inverted\" half of a set of paired Ops) will fetch + the value of its paired attribute and return its negation. This works for + all op types - an error will be issued if a \"transform\" type op is singular + and cannot be inverted. When getting the authored value of an inverted op + via UsdGeomXformOp::Get(), the raw, uninverted value of the associated + attribute is returned. + + For the sake of robustness, setting a value on an inverted op is disallowed. + Attempting to set a value on an inverted op will result in a coding error + and no value being set. + + Resetting the Transform Stack + + The other special op/token that can appear in xformOpOrder is + \"!resetXformStack!\", which, appearing as the first element of + xformOpOrder, indicates this prim should not inherit the transformation + of its namespace parent. See SetResetXformStack() + + Expected Behavior for \"Missing\" Ops + + If an importer expects Scale-Rotate-Translate operations, but a prim + has only translate and rotate ops authored, the importer should assume + an identity scale. This allows us to optimize the data a bit, if only + a few components of a very rich schema (like Maya's) are authored in the + app. + + \\anchor usdGeom_xformableExamples + Using the C++ API + + #1. Creating a simple transform matrix encoding + \\snippet examples_usdGeom.cpp CreateMatrixWithDefault + + #2. Creating the simple SRT from the example above + \\snippet examples_usdGeom.cpp CreateExampleSRT + + #3. Creating a parameterized SRT with pivot using UsdGeomXformCommonAPI + \\snippet examples_usdGeom.cpp CreateSRTWithDefaults + + #4. Creating a rotate-only pivot transform with animated + rotation and translation + \\snippet examples_usdGeom.cpp CreateAnimatedTransform + +""" +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Scope "Scope" ( + doc = """Scope is the simplest grouping primitive, and does not carry the + baggage of transformability. Note that transforms should inherit down + through a Scope successfully - it is just a guaranteed no-op from a + transformability perspective.""" +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) +} + +class Xform "Xform" ( + doc = "Concrete prim schema for a transform, which implements Xformable " +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "Boundable" ( + doc = """Boundable introduces the ability for a prim to persistently + cache a rectilinear, local-space, extent. + + Why Extent and not Bounds ? + Boundable introduces the notion of \"extent\", which is a cached computation + of a prim's local-space 3D range for its resolved attributes at the + layer and time in which extent is authored. We have found that with + composed scene description, attempting to cache pre-computed bounds at + interior prims in a scene graph is very fragile, given the ease with which + one can author a single attribute in a stronger layer that can invalidate + many authored caches - or with which a re-published, referenced asset can + do the same. + + Therefore, we limit to precomputing (generally) leaf-prim extent, which + avoids the need to read in large point arrays to compute bounds, and + provides UsdGeomBBoxCache the means to efficiently compute and + (session-only) cache intermediate bounds. You are free to compute and + author intermediate bounds into your scenes, of course, which may work + well if you have sufficient locks on your pipeline to guarantee that once + authored, the geometry and transforms upon which they are based will + remain unchanged, or if accuracy of the bounds is not an ironclad + requisite. + + When intermediate bounds are authored on Boundable parents, the child prims + will be pruned from BBox computation; the authored extent is expected to + incorporate all child bounds.""" +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "Gprim" ( + doc = '''Base class for all geometric primitives. + + Gprim encodes basic graphical properties such as doubleSided and + orientation, and provides primvars for "display color" and "display + opacity" that travel with geometry to be used as shader overrides. ''' +) +{ + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Cube "Cube" ( + doc = """Defines a primitive rectilinear cube centered at the origin. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" +) +{ + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-1, -1, -1), (1, 1, 1)] ( + doc = """Extent is re-defined on Cube only to provide a fallback value. + \\sa UsdGeomGprim::GetExtentAttr().""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double size = 2 ( + doc = """Indicates the length of each edge of the cube. If you + author size you must also author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Sphere "Sphere" ( + doc = """Defines a primitive sphere centered at the origin. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" +) +{ + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-1, -1, -1), (1, 1, 1)] ( + doc = """Extent is re-defined on Sphere only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double radius = 1 ( + doc = """Indicates the sphere's radius. If you + author radius you must also author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Cylinder "Cylinder" ( + doc = """Defines a primitive cylinder with closed ends, centered at the + origin, whose spine is along the specified axis. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" +) +{ + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = "The axis along which the spine of the cylinder is aligned" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-1, -1, -1), (1, 1, 1)] ( + doc = """Extent is re-defined on Cylinder only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + double height = 2 ( + doc = """The size of the cylinder's spine along the specified + axis. If you author height you must also author extent. + + \\sa GetExtentAttr()""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double radius = 1 ( + doc = """The radius of the cylinder. If you author radius + you must also author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Capsule "Capsule" ( + doc = """Defines a primitive capsule, i.e. a cylinder capped by two half + spheres, centered at the origin, whose spine is along the specified + axis. + The spherical cap heights (sagitta) of the two endcaps are a function of + the relative radii of the endcaps, such that cylinder tangent and sphere + tangent are coincident and maintain C1 continuity.""" +) +{ + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = "The axis along which the spine of the capsule is aligned" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-0.5, -0.5, -1), (0.5, 0.5, 1)] ( + doc = """Extent is re-defined on Capsule only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + double height = 1 ( + doc = """The length of the capsule's spine along the specified + axis excluding the size of the two half spheres, i.e. + the length of the cylinder portion of the capsule. + If you author height you must also author extent. + \\sa GetExtentAttr()""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double radius = 0.5 ( + doc = """The radius of the capsule. If you + author radius you must also author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Cone "Cone" ( + doc = """Defines a primitive cone, centered at the origin, whose spine + is along the specified axis, with the apex of the cone pointing + in the direction of the positive axis. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" +) +{ + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = "The axis along which the spine of the cone is aligned" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-1, -1, -1), (1, 1, 1)] ( + doc = """Extent is re-defined on Cone only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + double height = 2 ( + doc = """The length of the cone's spine along the specified + axis. If you author height you must also author extent. + + \\sa GetExtentAttr()""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double radius = 1 ( + doc = """The radius of the cone. If you + author radius you must also author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Cylinder_1 "Cylinder_1" ( + doc = """Defines a primitive cylinder with closed ends, centered at the + origin, whose spine is along the specified axis, with a pair of radii + describing the size of the end points. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" +) +{ + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = "The axis along which the spine of the cylinder is aligned" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-1, -1, -1), (1, 1, 1)] ( + doc = """Extent is re-defined on Cylinder only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + double height = 2 ( + doc = """The length of the cylinder's spine along the specified + axis. If you author height you must also author extent. + + \\sa GetExtentAttr()""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double radiusBottom = 1 ( + doc = """The radius of the bottom of the cylinder - i.e. the face + point located along the negative axis. If you author + radiusBottom you must also author extent. + + \\sa GetExtentAttr()""" + ) + double radiusTop = 1 ( + doc = """The radius of the top of the cylinder - i.e. the face located + along the positive axis. If you author radiusTop you must also + author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Capsule_1 "Capsule_1" ( + doc = """Defines a primitive capsule, i.e. a cylinder capped by two half + spheres, with potentially different radii, centered at the origin, and whose + spine is along the specified axis. + The spherical cap heights (sagitta) of the two endcaps are a function of + the relative radii of the endcaps, such that cylinder tangent and sphere + tangent are coincident and maintain C1 continuity.""" +) +{ + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = "The axis along which the spine of the capsule is aligned" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent = [(-0.5, -0.5, -1), (0.5, 0.5, 1)] ( + doc = """Extent is re-defined on Capsule only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + double height = 1 ( + doc = """The length of the capsule's spine along the specified + axis excluding the size of the two half spheres, i.e. + the length of the cylinder portion of the capsule. + If you author height you must also author extent. + \\sa GetExtentAttr()""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double radiusBottom = 0.5 ( + doc = """The radius of the capping sphere at the bottom of the capsule - + i.e. the sphere located in the direction of the negative axis. If + you author radius you must also author extent. + + \\sa GetExtentAttr()""" + ) + double radiusTop = 0.5 ( + doc = """The radius of the capping sphere at the top of the capsule - + i.e. the sphere in the direction of the positive axis. If you + author radius you must also author extent. + + \\sa GetExtentAttr()""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Plane "Plane" ( + doc = """Defines a primitive plane, centered at the origin, and is defined by + a cardinal axis, width, and length. The plane is double-sided by default. + + The axis of width and length are perpendicular to the plane's axis: + + axis | width | length + ----- | ------ | ------- + X | z-axis | y-axis + Y | x-axis | z-axis + Z | x-axis | y-axis + + """ +) +{ + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the surface of the plane is aligned. When set + to 'Z' the plane is in the xy-plane; when axis is 'X' the plane is in + the yz-plane, and when axis is 'Y' the plane is in the xz-plane. + + \\sa UsdGeomGprim::GetAxisAttr().""" + ) + uniform bool doubleSided = 1 ( + doc = """Planes are double-sided by default. Clients may also support + single-sided planes. + + \\sa UsdGeomGprim::GetDoubleSidedAttr()""" + ) + float3[] extent = [(-1, -1, 0), (1, 1, 0)] ( + doc = """Extent is re-defined on Plane only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) + double length = 2 ( + doc = """The length of the plane, which aligns to the y-axis when axis is + 'Z' or 'X', or to the z-axis when axis is 'Y'. If you author length + you must also author extent. + + \\sa UsdGeomGprim::GetExtentAttr()""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + double width = 2 ( + doc = """The width of the plane, which aligns to the x-axis when axis is + 'Z' or 'Y', or to the z-axis when axis is 'X'. If you author width + you must also author extent. + + \\sa UsdGeomGprim::GetExtentAttr()""" + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "PointBased" ( + doc = """Base class for all UsdGeomGprims that possess points, + providing common attributes such as normals and velocities.""" +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Mesh "Mesh" ( + doc = """Encodes a mesh with optional subdivision properties and features. + + As a point-based primitive, meshes are defined in terms of points that + are connected into edges and faces. Many references to meshes use the + term 'vertex' in place of or interchangeably with 'points', while some + use 'vertex' to refer to the 'face-vertices' that define a face. To + avoid confusion, the term 'vertex' is intentionally avoided in favor of + 'points' or 'face-vertices'. + + The connectivity between points, edges and faces is encoded using a + common minimal topological description of the faces of the mesh. Each + face is defined by a set of face-vertices using indices into the Mesh's + _points_ array (inherited from UsdGeomPointBased) and laid out in a + single linear _faceVertexIndices_ array for efficiency. A companion + _faceVertexCounts_ array provides, for each face, the number of + consecutive face-vertices in _faceVertexIndices_ that define the face. + No additional connectivity information is required or constructed, so + no adjacency or neighborhood queries are available. + + A key property of this mesh schema is that it encodes both subdivision + surfaces and simpler polygonal meshes. This is achieved by varying the + _subdivisionScheme_ attribute, which is set to specify Catmull-Clark + subdivision by default, so polygonal meshes must always be explicitly + declared. The available subdivision schemes and additional subdivision + features encoded in optional attributes conform to the feature set of + OpenSubdiv + (https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html). + + \\anchor UsdGeom_Mesh_Primvars + __A Note About Primvars__ + + The following list clarifies the number of elements for and the + interpolation behavior of the different primvar interpolation types + for meshes: + + - __constant__: One element for the entire mesh; no interpolation. + - __uniform__: One element for each face of the mesh; elements are + typically not interpolated but are inherited by other faces derived + from a given face (via subdivision, tessellation, etc.). + - __varying__: One element for each point of the mesh; + interpolation of point data is always linear. + - __vertex__: One element for each point of the mesh; + interpolation of point data is applied according to the + _subdivisionScheme_ attribute. + - __faceVarying__: One element for each of the face-vertices that + define the mesh topology; interpolation of face-vertex data may + be smooth or linear, according to the _subdivisionScheme_ and + _faceVaryingLinearInterpolation_ attributes. + + Primvar interpolation types and related utilities are described more + generally in \\ref Usd_InterpolationVals. + + \\anchor UsdGeom_Mesh_Normals + __A Note About Normals__ + + Normals should not be authored on a subdivision mesh, since subdivision + algorithms define their own normals. They should only be authored for + polygonal meshes (_subdivisionScheme_ = \"none\"). + + The _normals_ attribute inherited from UsdGeomPointBased is not a generic + primvar, but the number of elements in this attribute will be determined by + its _interpolation_. See . + If _normals_ and _primvars:normals_ are both specified, the latter has + precedence. If a polygonal mesh specifies __neither__ _normals_ nor + _primvars:normals_, then it should be treated and rendered as faceted, + with no attempt to compute smooth normals. + + The normals generated for smooth subdivision schemes, e.g. Catmull-Clark + and Loop, will likewise be smooth, but others, e.g. Bilinear, may be + discontinuous between faces and/or within non-planar irregular faces.""" +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + int[] cornerIndices = [] ( + doc = """The indices of points for which a corresponding sharpness + value is specified in _cornerSharpnesses_ (so the size of this array + must match that of _cornerSharpnesses_).""" + ) + float[] cornerSharpnesses = [] ( + doc = """The sharpness values associated with a corresponding set of + points specified in _cornerIndices_ (so the size of this array must + match that of _cornerIndices_). Use the constant `SHARPNESS_INFINITE` + for a perfectly sharp corner.""" + ) + int[] creaseIndices = [] ( + doc = """The indices of points grouped into sets of successive pairs + that identify edges to be creased. The size of this array must be + equal to the sum of all elements of the _creaseLengths_ attribute.""" + ) + int[] creaseLengths = [] ( + doc = """The length of this array specifies the number of creases + (sets of adjacent sharpened edges) on the mesh. Each element gives + the number of points of each crease, whose indices are successively + laid out in the _creaseIndices_ attribute. Since each crease must + be at least one edge long, each element of this array must be at + least two.""" + ) + float[] creaseSharpnesses = [] ( + doc = """The per-crease or per-edge sharpness values for all creases. + Since _creaseLengths_ encodes the number of points in each crease, + the number of elements in this array will be either len(creaseLengths) + or the sum over all X of (creaseLengths[X] - 1). Note that while + the RI spec allows each crease to have either a single sharpness + or a value per-edge, USD will encode either a single sharpness + per crease on a mesh, or sharpnesses for all edges making up + the creases on a mesh. Use the constant `SHARPNESS_INFINITE` for a + perfectly sharp crease.""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + token faceVaryingLinearInterpolation = "cornersPlus1" ( + allowedTokens = ["none", "cornersOnly", "cornersPlus1", "cornersPlus2", "boundaries", "all"] + doc = '''Specifies how elements of a primvar of interpolation type + "faceVarying" are interpolated for subdivision surfaces. Interpolation + can be as smooth as a "vertex" primvar or constrained to be linear at + features specified by several options. Valid values correspond to + choices available in OpenSubdiv: + + - __none__: No linear constraints or sharpening, smooth everywhere + - __cornersOnly__: Sharpen corners of discontinuous boundaries only, + smooth everywhere else + - __cornersPlus1__: The default, same as "cornersOnly" plus additional + sharpening at points where three or more distinct face-varying + values occur + - __cornersPlus2__: Same as "cornersPlus1" plus additional sharpening + at points with at least one discontinuous boundary corner or + only one discontinuous boundary edge (a dart) + - __boundaries__: Piecewise linear along discontinuous boundaries, + smooth interior + - __all__: Piecewise linear everywhere + + These are illustrated and described in more detail in the OpenSubdiv + documentation: + https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#face-varying-interpolation-rules''' + ) + int[] faceVertexCounts ( + doc = """Provides the number of vertices in each face of the mesh, + which is also the number of consecutive indices in _faceVertexIndices_ + that define the face. The length of this attribute is the number of + faces in the mesh. If this attribute has more than + one timeSample, the mesh is considered to be topologically varying.""" + ) + int[] faceVertexIndices ( + doc = """Flat list of the index (into the _points_ attribute) of each + vertex of each face in the mesh. If this attribute has more than + one timeSample, the mesh is considered to be topologically varying.""" + ) + int[] holeIndices = [] ( + doc = """The indices of all faces that should be treated as holes, + i.e. made invisible. This is traditionally a feature of subdivision + surfaces and not generally applied to polygonal meshes.""" + ) + token interpolateBoundary = "edgeAndCorner" ( + allowedTokens = ["none", "edgeOnly", "edgeAndCorner"] + doc = '''Specifies how subdivision is applied for faces adjacent to + boundary edges and boundary points. Valid values correspond to choices + available in OpenSubdiv: + + - __none__: No boundary interpolation is applied and boundary faces are + effectively treated as holes + - __edgeOnly__: A sequence of boundary edges defines a smooth curve to + which the edges of subdivided boundary faces converge + - __edgeAndCorner__: The default, similar to "edgeOnly" but the smooth + boundary curve is made sharp at corner points + + These are illustrated and described in more detail in the OpenSubdiv + documentation: + https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#boundary-interpolation-rules''' + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + uniform token subdivisionScheme = "catmullClark" ( + allowedTokens = ["catmullClark", "loop", "bilinear", "none"] + doc = '''The subdivision scheme to be applied to the surface. + Valid values are: + + - __catmullClark__: The default, Catmull-Clark subdivision; preferred + for quad-dominant meshes (generalizes B-splines); interpolation + of point data is smooth (non-linear) + - __loop__: Loop subdivision; preferred for purely triangular meshes; + interpolation of point data is smooth (non-linear) + - __bilinear__: Subdivision reduces all faces to quads (topologically + similar to "catmullClark"); interpolation of point data is bilinear + - __none__: No subdivision, i.e. a simple polygonal mesh; interpolation + of point data is linear + + Polygonal meshes are typically lighter weight and faster to render, + depending on renderer and render mode. Use of "bilinear" will produce + a similar shape to a polygonal mesh and may offer additional guarantees + of watertightness and additional subdivision features (e.g. holes) but + may also not respect authored normals.''' + ) + token triangleSubdivisionRule = "catmullClark" ( + allowedTokens = ["catmullClark", "smooth"] + doc = '''Specifies an option to the subdivision rules for the + Catmull-Clark scheme to try and improve undesirable artifacts when + subdividing triangles. Valid values are "catmullClark" for the + standard rules (the default) and "smooth" for the improvement. + + See https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#triangle-subdivision-rule''' + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class TetMesh "TetMesh" ( + doc = """Encodes a tetrahedral mesh. A tetrahedral mesh is defined as a set of + tetrahedra. Each tetrahedron is defined by a set of 4 points, with the + triangles of the tetrahedron determined from these 4 points as described in + the tetVertexIndices attribute description. The mesh surface faces + are encoded as triangles. Surface faces must be provided for consumers + that need to do surface calculations, such as renderers or consumers using + physics attachments. Both tetrahedra and surface face definitions use + indices into the TetMesh's points attribute, inherited from + UsdGeomPointBased.""" +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + int3[] surfaceFaceVertexIndices ( + doc = """surfaceFaceVertexIndices defines the triangle + surface faces indices wrt. points of the tetmesh surface. Again + the orientation attribute inherited from UsdGeomPrim should be + set accordingly. The orientation for faces of tetrahedra and + surface faces must match.""" + ) + int4[] tetVertexIndices ( + doc = '''Flat list of the index (into the points attribute) of + each vertex of each tetrahedron in the mesh. Each int4 corresponds to the + indices of a single tetrahedron. Users should set the orientation + attribute of UsdGeomPrim accordingly. That is if the orientation + is "rightHanded", the CCW face ordering of a tetrahedron is + [123],[032],[013],[021] with respect to the int4. This results in the + normals facing outward from the center of the tetrahedron. The following + diagram shows the face ordering of an unwrapped tetrahedron with + "rightHanded" orientation. + + \\image html USDTetMeshRightHanded.svg + + If the orientation attribute is set to "leftHanded" the face + ordering of the tetrahedron is [321],[230],[310],[120] and the + leftHanded CW face normals point outward from the center of the + tetrahedron. The following diagram shows the face ordering of an + unwrapped tetrahedron with "leftHanded" orientation. + + \\image html USDTetMeshLeftHanded.svg + + Setting the orientation attribute to align with the + ordering of the int4 for the tetrahedrons is the responsibility of the + user.''' + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class GeomSubset "GeomSubset" ( + doc = """Encodes a subset of a piece of geometry (i.e. a UsdGeomImageable) + as a set of indices. Currently supports encoding subsets of faces, + points, edges, and tetrahedrons. + + To apply to a geometric prim, a GeomSubset prim must be the prim's direct + child in namespace, and possess a concrete defining specifier (i.e. def). + This restriction makes it easy and efficient to discover subsets of a prim. + We might want to relax this restriction if it's common to have multiple + families of subsets on a gprim and if it's useful to be able to + organize subsets belonging to a family under a common scope. See + 'familyName' attribute for more info on defining a family of subsets. + + Note that a GeomSubset isn't an imageable (i.e. doesn't derive from + UsdGeomImageable). So, you can't author visibility for it or + override its purpose. + + Materials are bound to GeomSubsets just as they are for regular + geometry using API available in UsdShade (UsdShadeMaterial::Bind). +""" +) +{ + uniform token elementType = "face" ( + allowedTokens = ["face", "point", "edge", "tetrahedron"] + doc = """The type of element that the indices target. \"elementType\" can + have one of the following values: +
  • face: Identifies faces on a Gprim's surface. For a + UsdGeomMesh, each element of the _indices_ attribute would refer to + an element of the Mesh's _faceCounts_ attribute. For a UsdGeomTetMesh, + each element of the _indices_ attribute would refer to an element of + the Mesh's _surfaceFaceVertexIndices_ attribute.
    • +
  • point: for any UsdGeomPointBased, each + element of the _indices_ attribute would refer to an element of the + Mesh's _points_ attribute
    • +
  • edge: for any UsdGeomMesh, each pair of elements + in the _indices_ attribute would refer to a pair of points of the + Mesh's _points_ attribute that are connected as an implicit edge on the + Mesh. These edges are derived from the Mesh's _faceVertexIndices_ + attribute. Edges are not currently defined for a UsdGeomTetMesh, but + could be derived from all tetrahedron edges or surface face edges only + if a specific use-case arises.
    • +
  • tetrahedron: for any UsdGeomTetMesh, each element of the + _indices_ attribute would refer to an element of the TetMesh's + _tetVertexIndices_ attribute. +
""" + ) + uniform token familyName = "" ( + doc = '''The name of the family of subsets that this subset belongs to. + This is optional and is primarily useful when there are multiple + families of subsets under a geometric prim. In some cases, this could + also be used for achieving proper roundtripping of subset data between + DCC apps. + When multiple subsets belonging to a prim have the same familyName, they + are said to belong to the family. A familyType value can be + encoded on the owner of a family of subsets as a token using the static + method UsdGeomSubset::SetFamilyType(). "familyType" can have one of the + following values: +
  • UsdGeomTokens->partition: implies that every element of + the whole geometry appears exactly once in only one of the subsets + belonging to the family.
    • +
  • UsdGeomTokens->nonOverlapping: an element that appears in one + subset may not appear in any other subset belonging to the family, and + appears only once in the subset in which it appears.
    • +
  • UsdGeomTokens->unrestricted: implies that there are no + restrictions w.r.t. the membership of elements in the subsets. They + could be overlapping and the union of all subsets in the family may + not represent the whole.
    • +
+ \\note The validity of subset data is not enforced by the authoring + APIs, however they can be checked using UsdGeomSubset::ValidateFamily(). + ''' + ) + int[] indices = [] ( + doc = """The set of indices included in this subset. The indices need not + be sorted, but the same index should not appear more than once. Indices + are invalid if outside the range [0, elementCount) for the given time on + the parent geometric prim.""" + ) +} + +class NurbsPatch "NurbsPatch" ( + doc = """Encodes a rational or polynomial non-uniform B-spline + surface, with optional trim curves. + + The encoding mostly follows that of RiNuPatch and RiTrimCurve: + https://renderman.pixar.com/resources/RenderMan_20/geometricPrimitives.html#rinupatch , with some minor renaming and coalescing for clarity. + + The layout of control vertices in the points attribute inherited + from UsdGeomPointBased is row-major with U considered rows, and V columns. + + \\anchor UsdGeom_NurbsPatch_Form + NurbsPatch Form + + The authored points, orders, knots, weights, and ranges are all that is + required to render the nurbs patch. However, the only way to model closed + surfaces with nurbs is to ensure that the first and last control points + along the given axis are coincident. Similarly, to ensure the surface is + not only closed but also C2 continuous, the last order - 1 control + points must be (correspondingly) coincident with the first order - 1 + control points, and also the spacing of the last corresponding knots + must be the same as the first corresponding knots. + + Form is provided as an aid to interchange between modeling and + animation applications so that they can robustly identify the intent with + which the surface was modelled, and take measures (if they are able) to + preserve the continuity/concidence constraints as the surface may be rigged + or deformed. + - An open-form NurbsPatch has no continuity constraints. + - A closed-form NurbsPatch expects the first and last control points + to overlap + - A periodic-form NurbsPatch expects the first and last + order - 1 control points to overlap. + + Nurbs vs Subdivision Surfaces + + Nurbs are an important modeling primitive in CAD/CAM tools and early + computer graphics DCC's. Because they have a natural UV parameterization + they easily support \"trim curves\", which allow smooth shapes to be + carved out of the surface. + + However, the topology of the patch is always rectangular, and joining two + nurbs patches together (especially when they have differing numbers of + spans) is difficult to do smoothly. Also, nurbs are not supported by + the Ptex texturing technology (http://ptex.us). + + Neither of these limitations are shared by subdivision surfaces; therefore, + although they do not subscribe to trim-curve-based shaping, subdivs are + often considered a more flexible modeling primitive. + """ +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + double[] pointWeights ( + doc = """Optionally provides \"w\" components for each control point, + thus must be the same length as the points attribute. If authored, + the patch will be rational. If unauthored, the patch will be + polynomial, i.e. weight for all points is 1.0. + \\note Some DCC's pre-weight the points, but in this schema, + points are not pre-weighted.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + int[] trimCurve:counts ( + doc = '''Each element specifies how many curves are present in each + "loop" of the trimCurve, and the length of the array determines how + many loops the trimCurve contains. The sum of all elements is the + total nuber of curves in the trim, to which we will refer as + nCurves in describing the other trim attributes.''' + ) + double[] trimCurve:knots ( + doc = """Flat list of parametric values for each of the + nCurves curves. There will be as many knots as the sum over + all elements of vertexCounts plus the sum over all elements of + orders.""" + ) + int[] trimCurve:orders ( + doc = "Flat list of orders for each of the nCurves curves." + ) + double3[] trimCurve:points ( + doc = """Flat list of homogeneous 2D points (u, v, w) that comprise + the nCurves curves. The number of points should be equal to the + um over all elements of vertexCounts.""" + ) + double2[] trimCurve:ranges ( + doc = """Flat list of minimum and maximum parametric values + (as defined by knots) for each of the nCurves curves.""" + ) + int[] trimCurve:vertexCounts ( + doc = """Flat list of number of vertices for each of the + nCurves curves.""" + ) + uniform token uForm = "open" ( + allowedTokens = ["open", "closed", "periodic"] + doc = '''Interpret the control grid and knot vectors as representing + an open, geometrically closed, or geometrically closed and C2 continuous + surface along the U dimension. + \\sa "NurbsPatch Form" ''' + ) + double[] uKnots ( + doc = """Knot vector for U direction providing U parameterization. + The length of this array must be ( uVertexCount + uOrder ), and its + entries must take on monotonically increasing values.""" + ) + int uOrder ( + doc = """Order in the U direction. Order must be positive and is + equal to the degree of the polynomial basis to be evaluated, plus 1.""" + ) + double2 uRange ( + doc = """Provides the minimum and maximum parametric values (as defined + by uKnots) over which the surface is actually defined. The minimum + must be less than the maximum, and greater than or equal to the + value of uKnots[uOrder-1]. The maxium must be less than or equal + to the last element's value in uKnots.""" + ) + int uVertexCount ( + doc = """Number of vertices in the U direction. Should be at least as + large as uOrder.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + uniform token vForm = "open" ( + allowedTokens = ["open", "closed", "periodic"] + doc = '''Interpret the control grid and knot vectors as representing + an open, geometrically closed, or geometrically closed and C2 continuous + surface along the V dimension. + \\sa "NurbsPatch Form" ''' + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + double[] vKnots ( + doc = """Knot vector for V direction providing U parameterization. + The length of this array must be ( vVertexCount + vOrder ), and its + entries must take on monotonically increasing values.""" + ) + int vOrder ( + doc = """Order in the V direction. Order must be positive and is + equal to the degree of the polynomial basis to be evaluated, plus 1.""" + ) + double2 vRange ( + doc = """Provides the minimum and maximum parametric values (as defined + by vKnots) over which the surface is actually defined. The minimum + must be less than the maximum, and greater than or equal to the + value of vKnots[vOrder-1]. The maxium must be less than or equal + to the last element's value in vKnots.""" + ) + int vVertexCount ( + doc = """Number of vertices in the V direction. Should be at least as + large as vOrder.""" + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "Curves" ( + doc = """Base class for UsdGeomBasisCurves, UsdGeomNurbsCurves, and + UsdGeomHermiteCurves. The BasisCurves schema is designed to be + analagous to offline renderers' notion of batched curves (such as + the classical RIB definition via Basis and Curves statements), + while the NurbsCurve schema is designed to be analgous to the + NURBS curves found in packages like Maya and Houdini while + retaining their consistency with the RenderMan specification for + NURBS Patches. HermiteCurves are useful for the + interchange of animation guides and paths. + + It is safe to use the length of the curve vertex count to derive + the number of curves and the number and layout of curve vertices, + but this schema should NOT be used to derive the number of curve + points. While vertex indices are implicit in all shipped + descendent types of this schema, one should not assume that all + internal or future shipped schemas will follow this pattern. Be + sure to key any indexing behavior off the concrete type, not this + abstract type. + """ +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + int[] curveVertexCounts ( + doc = """Curves-derived primitives can represent multiple distinct, + potentially disconnected curves. The length of 'curveVertexCounts' + gives the number of such curves, and each element describes the + number of vertices in the corresponding curve""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + float[] widths ( + doc = """Provides width specification for the curves, whose application + will depend on whether the curve is oriented (normals are defined for + it), in which case widths are \"ribbon width\", or unoriented, in which + case widths are cylinder width. 'widths' is not a generic Primvar, + but the number of elements in this attribute will be determined by + its 'interpolation'. See . If 'widths' + and 'primvars:widths' are both specified, the latter has precedence.""" + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class BasisCurves "BasisCurves" ( + doc = """BasisCurves are a batched curve representation analogous to the + classic RIB definition via Basis and Curves statements. BasisCurves are + often used to render dense aggregate geometry like hair or grass. + + A 'matrix' and 'vstep' associated with the basis are used to + interpolate the vertices of a cubic BasisCurves. (The basis attribute + is unused for linear BasisCurves.) + + A single prim may have many curves whose count is determined implicitly by + the length of the curveVertexCounts vector. Each individual curve is + composed of one or more segments. Each segment is defined by four vertices + for cubic curves and two vertices for linear curves. See the next section + for more information on how to map curve vertex counts to segment counts. + + Segment Indexing + Interpolating a curve requires knowing how to decompose it into its + individual segments. + + The segments of a cubic curve are determined by the vertex count, + the wrap (periodicity), and the vstep of the basis. For linear + curves, the basis token is ignored and only the vertex count and + wrap are needed. + + cubic basis | vstep + ------------- | ------ + bezier | 3 + catmullRom | 1 + bspline | 1 + + The first segment of a cubic (nonperiodic) curve is always defined by its + first four points. The vstep is the increment used to determine what + vertex indices define the next segment. For a two segment (nonperiodic) + bspline basis curve (vstep = 1), the first segment will be defined by + interpolating vertices [0, 1, 2, 3] and the second segment will be defined + by [1, 2, 3, 4]. For a two segment bezier basis curve (vstep = 3), the + first segment will be defined by interpolating vertices [0, 1, 2, 3] and + the second segment will be defined by [3, 4, 5, 6]. If the vstep is not + one, then you must take special care to make sure that the number of cvs + properly divides by your vstep. (The indices described are relative to + the initial vertex index for a batched curve.) + + For periodic curves, at least one of the curve's initial vertices are + repeated to close the curve. For cubic curves, the number of vertices + repeated is '4 - vstep'. For linear curves, only one vertex is repeated + to close the loop. + + Pinned curves are a special case of nonperiodic curves that only affects + the behavior of cubic Bspline and Catmull-Rom curves. To evaluate or render + pinned curves, a client must effectively add 'phantom points' at the + beginning and end of every curve in a batch. These phantom points + are injected to ensure that the interpolated curve begins at P[0] and + ends at P[n-1]. + + For a curve with initial point P[0] and last point P[n-1], the phantom + points are defined as. + P[-1] = 2 * P[0] - P[1] + P[n] = 2 * P[n-1] - P[n-2] + + Pinned cubic curves will (usually) have to be unpacked into the standard + nonperiodic representation before rendering. This unpacking can add some + additional overhead. However, using pinned curves reduces the amount of + data recorded in a scene and (more importantly) better records the + authors' intent for interchange. + + \\note The additional phantom points mean that the minimum curve vertex + count for cubic bspline and catmullRom curves is 2. + + Linear curve segments are defined by two vertices. + A two segment linear curve's first segment would be defined by + interpolating vertices [0, 1]. The second segment would be defined by + vertices [1, 2]. (Again, for a batched curve, indices are relative to + the initial vertex index.) + + When validating curve topology, each renderable entry in the + curveVertexCounts vector must pass this check. + + type | wrap | validitity + ------- | --------------------------- | ---------------- + linear | nonperiodic | curveVertexCounts[i] > 2 + linear | periodic | curveVertexCounts[i] > 3 + cubic | nonperiodic | (curveVertexCounts[i] - 4) % vstep == 0 + cubic | periodic | (curveVertexCounts[i]) % vstep == 0 + cubic | pinned (catmullRom/bspline) | (curveVertexCounts[i] - 2) >= 0 + + Cubic Vertex Interpolation + + \\image html USDCurveBasisMatrix.png width=750 + + Linear Vertex Interpolation + + Linear interpolation is always used on curves of type linear. + 't' with domain [0, 1], the curve is defined by the equation + P0 * (1-t) + P1 * t. t at 0 describes the first point and t at 1 describes + the end point. + + Primvar Interpolation + + For cubic curves, primvar data can be either interpolated cubically between + vertices or linearly across segments. The corresponding token + for cubic interpolation is 'vertex' and for linear interpolation is + 'varying'. Per vertex data should be the same size as the number + of vertices in your curve. Segment varying data is dependent on the + wrap (periodicity) and number of segments in your curve. For linear curves, + varying and vertex data would be interpolated the same way. By convention + varying is the preferred interpolation because of the association of + varying with linear interpolation. + + \\image html USDCurvePrimvars.png + + To convert an entry in the curveVertexCounts vector into a segment count + for an individual curve, apply these rules. Sum up all the results in + order to compute how many total segments all curves have. + + The following tables describe the expected segment count for the 'i'th + curve in a curve batch as well as the entire batch. Python syntax + like '[:]' (to describe all members of an array) and 'len(...)' + (to describe the length of an array) are used. + + type | wrap | curve segment count | batch segment count + ------- | --------------------------- | -------------------------------------- | -------------------------- + linear | nonperiodic | curveVertexCounts[i] - 1 | sum(curveVertexCounts[:]) - len(curveVertexCounts) + linear | periodic | curveVertexCounts[i] | sum(curveVertexCounts[:]) + cubic | nonperiodic | (curveVertexCounts[i] - 4) / vstep + 1 | sum(curveVertexCounts[:] - 4) / vstep + len(curveVertexCounts) + cubic | periodic | curveVertexCounts[i] / vstep | sum(curveVertexCounts[:]) / vstep + cubic | pinned (catmullRom/bspline) | (curveVertexCounts[i] - 2) + 1 | sum(curveVertexCounts[:] - 2) + len(curveVertexCounts) + + The following table descrives the expected size of varying + (linearly interpolated) data, derived from the segment counts computed + above. + + wrap | curve varying count | batch varying count + ------------------- | ---------------------------- | ------------------------------------------------ + nonperiodic/pinned | segmentCounts[i] + 1 | sum(segmentCounts[:]) + len(curveVertexCounts) + periodic | segmentCounts[i] | sum(segmentCounts[:]) + + Both curve types additionally define 'constant' interpolation for the + entire prim and 'uniform' interpolation as per curve data. + + + \\note Take care when providing support for linearly interpolated data for + cubic curves. Its shape doesn't provide a one to one mapping with either + the number of curves (like 'uniform') or the number of vertices (like + 'vertex') and so it is often overlooked. This is the only primitive in + UsdGeom (as of this writing) where this is true. For meshes, while they + use different interpolation methods, 'varying' and 'vertex' are both + specified per point. It's common to assume that curves follow a similar + pattern and build in structures and language for per primitive, per + element, and per point data only to come upon these arrays that don't + quite fit into either of those categories. It is + also common to conflate 'varying' with being per segment data and use the + segmentCount rules table instead of its neighboring varying data table + rules. We suspect that this is because for the common case of + nonperiodic cubic curves, both the provided segment count and varying data + size formula end with '+ 1'. While debugging, users may look at the double + '+ 1' as a mistake and try to remove it. We take this time to enumerate + these issues because we've fallen into them before and hope that we save + others time in their own implementations. + + As an example of deriving per curve segment and varying primvar data counts from + the wrap, type, basis, and curveVertexCount, the following table is provided. + + wrap | type | basis | curveVertexCount | curveSegmentCount | varyingDataCount + ------------- | ------- | ------- | ----------------- | ------------------ | ------------------------- + nonperiodic | linear | N/A | [2 3 2 5] | [1 2 1 4] | [2 3 2 5] + nonperiodic | cubic | bezier | [4 7 10 4 7] | [1 2 3 1 2] | [2 3 4 2 3] + nonperiodic | cubic | bspline | [5 4 6 7] | [2 1 3 4] | [3 2 4 5] + periodic | cubic | bezier | [6 9 6] | [2 3 2] | [2 3 2] + periodic | linear | N/A | [3 7] | [3 7] | [3 7] + + Tubes and Ribbons + + The strictest definition of a curve as an infinitely thin wire is not + particularly useful for describing production scenes. The additional + widths and normals attributes can be used to describe cylindrical + tubes and or flat oriented ribbons. + + Curves with only widths defined are imaged as tubes with radius + 'width / 2'. Curves with both widths and normals are imaged as ribbons + oriented in the direction of the interpolated normal vectors. + + While not technically UsdGeomPrimvars, widths and normals + also have interpolation metadata. It's common for authored widths to have + constant, varying, or vertex interpolation + (see UsdGeomCurves::GetWidthsInterpolation()). It's common for + authored normals to have varying interpolation + (see UsdGeomPointBased::GetNormalsInterpolation()). + + \\image html USDCurveHydra.png + + The file used to generate these curves can be found in + extras/usd/examples/usdGeomExamples/basisCurves.usda. It's provided + as a reference on how to properly image both tubes and ribbons. The first + row of curves are linear; the second are cubic bezier. (We aim in future + releases of HdSt to fix the discontinuity seen with broken tangents to + better match offline renderers like RenderMan.) The yellow and violet + cubic curves represent cubic vertex width interpolation for which there is + no equivalent for linear curves. + + \\note How did this prim type get its name? This prim is a portmanteau of + two different statements in the original RenderMan specification: + 'Basis' and 'Curves'. +""" +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + uniform token basis = "bezier" ( + allowedTokens = ["bezier", "bspline", "catmullRom"] + doc = """The basis specifies the vstep and matrix used for cubic + interpolation. \\note The 'hermite' and 'power' tokens have been + removed. We've provided UsdGeomHermiteCurves + as an alternative for the 'hermite' basis.""" + ) + int[] curveVertexCounts ( + doc = """Curves-derived primitives can represent multiple distinct, + potentially disconnected curves. The length of 'curveVertexCounts' + gives the number of such curves, and each element describes the + number of vertices in the corresponding curve""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + uniform token type = "cubic" ( + allowedTokens = ["linear", "cubic"] + doc = """Linear curves interpolate linearly between two vertices. + Cubic curves use a basis matrix with four vertices to interpolate a segment.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + float[] widths ( + doc = """Provides width specification for the curves, whose application + will depend on whether the curve is oriented (normals are defined for + it), in which case widths are \"ribbon width\", or unoriented, in which + case widths are cylinder width. 'widths' is not a generic Primvar, + but the number of elements in this attribute will be determined by + its 'interpolation'. See . If 'widths' + and 'primvars:widths' are both specified, the latter has precedence.""" + ) + uniform token wrap = "nonperiodic" ( + allowedTokens = ["nonperiodic", "periodic", "pinned"] + doc = """If wrap is set to periodic, the curve when rendered will + repeat the initial vertices (dependent on the vstep) to close the + curve. If wrap is set to 'pinned', phantom points may be created + to ensure that the curve interpolation starts at P[0] and ends at P[n-1]. + """ + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class NurbsCurves "NurbsCurves" ( + doc = """This schema is analagous to NURBS Curves in packages like Maya + and Houdini, often used for interchange of rigging and modeling curves. + Unlike Maya, this curve spec supports batching of multiple curves into a + single prim, widths, and normals in the schema. Additionally, we require + 'numSegments + 2 * degree + 1' knots (2 more than maya does). This is to + be more consistent with RenderMan's NURBS patch specification. + + To express a periodic curve: + - knot[0] = knot[1] - (knots[-2] - knots[-3]; + - knot[-1] = knot[-2] + (knot[2] - knots[1]); + + To express a nonperiodic curve: + - knot[0] = knot[1]; + - knot[-1] = knot[-2]; + + In spite of these slight differences in the spec, curves generated in Maya + should be preserved when roundtripping. + + order and range, when representing a batched NurbsCurve should be + authored one value per curve. knots should be the concatentation of + all batched curves.""" +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + int[] curveVertexCounts ( + doc = """Curves-derived primitives can represent multiple distinct, + potentially disconnected curves. The length of 'curveVertexCounts' + gives the number of such curves, and each element describes the + number of vertices in the corresponding curve""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + double[] knots ( + doc = """Knot vector providing curve parameterization. + The length of the slice of the array for the ith curve + must be ( curveVertexCount[i] + order[i] ), and its + entries must take on monotonically increasing values.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + int[] order = [] ( + doc = """Order of the curve. Order must be positive and is + equal to the degree of the polynomial basis to be evaluated, plus 1. + Its value for the 'i'th curve must be less than or equal to + curveVertexCount[i]""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + double[] pointWeights ( + doc = """Optionally provides \"w\" components for each control point, + thus must be the same length as the points attribute. If authored, + the curve will be rational. If unauthored, the curve will be + polynomial, i.e. weight for all points is 1.0. + \\note Some DCC's pre-weight the points, but in this schema, + points are not pre-weighted.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double2[] ranges ( + doc = """Provides the minimum and maximum parametric values (as defined + by knots) over which the curve is actually defined. The minimum must + be less than the maximum, and greater than or equal to the value of the + knots['i'th curve slice][order[i]-1]. The maxium must be less + than or equal to the last element's value in knots['i'th curve slice]. +\tRange maps to (vmin, vmax) in the RenderMan spec.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + float[] widths ( + doc = """Provides width specification for the curves, whose application + will depend on whether the curve is oriented (normals are defined for + it), in which case widths are \"ribbon width\", or unoriented, in which + case widths are cylinder width. 'widths' is not a generic Primvar, + but the number of elements in this attribute will be determined by + its 'interpolation'. See . If 'widths' + and 'primvars:widths' are both specified, the latter has precedence.""" + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Points "Points" ( + doc = """Points are analogous to the RiPoints spec. + + Points can be an efficient means of storing and rendering particle + effects comprised of thousands or millions of small particles. Points + generally receive a single shading sample each, which should take + normals into account, if present. + + While not technically UsdGeomPrimvars, the widths and normals also + have interpolation metadata. It's common for authored widths and normals + to have constant or varying interpolation.""" +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + int64[] ids ( + doc = """Ids are optional; if authored, the ids array should be the same + length as the points array, specifying (at each timesample if + point identities are changing) the id of each point. The + type is signed intentionally, so that clients can encode some + binary state on Id'd points without adding a separate + primvar.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + float[] widths ( + doc = """Widths are defined as the diameter of the points, in + object space. 'widths' is not a generic Primvar, but + the number of elements in this attribute will be determined by + its 'interpolation'. See . If + 'widths' and 'primvars:widths' are both specified, the latter + has precedence.""" + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class PointInstancer "PointInstancer" ( + doc = """Encodes vectorized instancing of multiple, potentially + animated, prototypes (object/instance masters), which can be arbitrary + prims/subtrees on a UsdStage. + + PointInstancer is a \"multi instancer\", as it allows multiple prototypes + to be scattered among its \"points\". We use a UsdRelationship + prototypes to identify and order all of the possible prototypes, by + targeting the root prim of each prototype. The ordering imparted by + relationships associates a zero-based integer with each prototype, and + it is these integers we use to identify the prototype of each instance, + compactly, and allowing prototypes to be swapped out without needing to + reauthor all of the per-instance data. + + The PointInstancer schema is designed to scale to billions of instances, + which motivates the choice to split the per-instance transformation into + position, (quaternion) orientation, and scales, rather than a + 4x4 matrix per-instance. In addition to requiring fewer bytes even if + all elements are authored (32 bytes vs 64 for a single-precision 4x4 + matrix), we can also be selective about which attributes need to animate + over time, for substantial data reduction in many cases. + + Note that PointInstancer is not a Gprim, since it is not a graphical + primitive by any stretch of the imagination. It is, however, + Boundable, since we will sometimes want to treat the entire PointInstancer + similarly to a procedural, from the perspective of inclusion or framing. + + Varying Instance Identity over Time + + PointInstancers originating from simulations often have the characteristic + that points/instances are \"born\", move around for some time period, and then + die (or leave the area of interest). In such cases, billions of instances + may be birthed over time, while at any specific time, only a much + smaller number are actually alive. To encode this situation efficiently, + the simulator may re-use indices in the instance arrays, when a particle + dies, its index will be taken over by a new particle that may be birthed in + a much different location. This presents challenges both for + identity-tracking, and for motion-blur. + + We facilitate identity tracking by providing an optional, animatable + ids attribute, that specifies the 64 bit integer ID of the particle + at each index, at each point in time. If the simulator keeps monotonically + increasing a particle-count each time a new particle is birthed, it will + serve perfectly as particle ids. + + We facilitate motion blur for varying-topology particle streams by + optionally allowing per-instance velocities and angularVelocities + to be authored. If instance transforms are requested at a time between + samples and either of the velocity attributes is authored, then we will + not attempt to interpolate samples of positions or orientations. + If not authored, and the bracketing samples have the same length, then we + will interpolate. + + Computing an Instance Transform + + Each instance's transformation is a combination of the SRT affine transform + described by its scale, orientation, and position, applied after + (i.e. less locally than) the local to parent transformation computed at + the root of the prototype it is instancing. + + If your processing of prototype geometry naturally takes into account the + transform of the prototype root, then this term can be omitted from the + computation of each instance transform, and this can be controlled when + computing instance transformation matrices using the + UsdGeomPointInstancer::PrototypeXformInclusion enumeration. + + To understand the computation of the instance transform, in order to put + an instance of a PointInstancer into the space of the PointInstancer's + parent prim we do the following: + + 1. Apply (most locally) the authored local to parent transformation for + prototypes[protoIndices[i]] + 2. If *scales* is authored, next apply the scaling matrix from *scales[i]* + 3. If *orientations* is authored: **if *angularVelocities* is authored**, + first multiply *orientations[i]* by the unit quaternion derived by scaling + *angularVelocities[i]* by the \"time differential\" + from the left-bracketing timeSample for *orientation* to the requested + evaluation time *t*, storing the result in *R*, **else** assign *R* + directly from *orientations[i]*. Apply the rotation matrix derived + from *R*. + 4. Apply the translation derived from *positions[i]*. If *velocities* is + authored, apply the translation deriving from *velocities[i]* scaled by + the time differential from the left-bracketing timeSample for *positions* + to the requested evaluation time *t*. + 5. Least locally, apply the transformation authored on the PointInstancer + prim itself (or the UsdGeomImageable::ComputeLocalToWorldTransform() of the + PointInstancer to put the instance directly into world space) + + If neither *velocities* nor *angularVelocities* are authored, we fallback to + standard position and orientation computation logic (using linear + interpolation between timeSamples) as described by + . + + \\anchor UsdGeom_PITimeScaling + Scaling Velocities for Interpolation + + When computing time-differentials by which to apply velocity or + angularVelocity to positions or orientations, we must scale by + ( 1.0 / UsdStage::GetTimeCodesPerSecond() ), because velocities are recorded + in units/second, while we are interpolating in UsdTimeCode ordinates. + + We provide both high and low-level API's for dealing with the + transformation as a matrix, both will compute the instance matrices using + multiple threads; the low-level API allows the client to cache unvarying + inputs so that they need not be read duplicately when computing over + time. + + See also . + + Primvars on PointInstancer + + \"Primvars\" authored on a PointInstancer prim should + always be applied to each instance with constant interpolation at + the root of the instance. When you are authoring primvars on a + PointInstancer, think about it as if you were authoring them on a + point-cloud (e.g. a UsdGeomPoints gprim). The same + interpolation rules for points apply here, substituting + \"instance\" for \"point\". + + In other words, the (constant) value extracted for each instance + from the authored primvar value depends on the authored interpolation + and elementSize of the primvar, as follows: + - constant or uniform : the entire authored value of the + primvar should be applied exactly to each instance. + - varying, vertex, or faceVarying: the first + elementSize elements of the authored primvar array should be assigned to + instance zero, the second elementSize elements should be assigned to + instance one, and so forth. + + + Masking Instances: \"Deactivating\" and Invising + + Often a PointInstancer is created \"upstream\" in a graphics pipeline, and + the needs of \"downstream\" clients necessitate eliminating some of the + instances from further consideration. Accomplishing this pruning by + re-authoring all of the per-instance attributes is not very attractive, + since it may mean destructively editing a large quantity of data. We + therefore provide means of \"masking\" instances by ID, such that the + instance data is unmolested, but per-instance transform and primvar data + can be retrieved with the no-longer-desired instances eliminated from the + (smaller) arrays. PointInstancer allows two independent means of masking + instances by ID, each with different features that meet the needs of + various clients in a pipeline. Both pruning features' lists of ID's are + combined to produce the mask returned by ComputeMaskAtTime(). + + \\note If a PointInstancer has no authored ids attribute, the masking + features will still be available, with the integers specifying element + position in the protoIndices array rather than ID. + + \\subsection UsdGeomPointInstancer_inactiveIds InactiveIds: List-edited, Unvarying Masking + + The first masking feature encodes a list of IDs in a list-editable metadatum + called inactiveIds, which, although it does not have any similar + impact to stage population as \"prim activation\", + it shares with that feature that its application is uniform over all time. + Because it is list-editable, we can sparsely add and remove instances + from it in many layers. + + This sparse application pattern makes inactiveIds a good choice when + further downstream clients may need to reverse masking decisions made + upstream, in a manner that is robust to many kinds of future changes to + the upstream data. + + See ActivateId(), ActivateIds(), DeactivateId(), DeactivateIds(), + ActivateAllIds() + + \\subsection UsdGeomPointInstancer_invisibleIds invisibleIds: Animatable Masking + + The second masking feature encodes a list of IDs in a time-varying + Int64Array-valued UsdAttribute called invisibleIds , since it shares + with \"Imageable visibility\" + the ability to animate object visibility. + + Unlike inactiveIds, overriding a set of opinions for invisibleIds + is not at all straightforward, because one will, in general need to + reauthor (in the overriding layer) **all** timeSamples for the attribute + just to change one Id's visibility state, so it cannot be authored + sparsely. But it can be a very useful tool for situations like encoding + pre-computed camera-frustum culling of geometry when either or both of + the instances or the camera is animated. + + See VisId(), VisIds(), InvisId(), InvisIds(), VisAllIds() + + Processing and Not Processing Prototypes + + Any prim in the scenegraph can be targeted as a prototype by the + prototypes relationship. We do not, however, provide a specific + mechanism for identifying prototypes as geometry that should not be drawn + (or processed) in their own, local spaces in the scenegraph. We + encourage organizing all prototypes as children of the PointInstancer + prim that consumes them, and pruning \"raw\" processing and drawing + traversals when they encounter a PointInstancer prim; this is what the + UsdGeomBBoxCache and UsdImaging engines do. + + There is a pattern one can deploy for organizing the prototypes + such that they will automatically be skipped by basic UsdPrim::GetChildren() + or UsdPrimRange traversals. Usd prims each have a + \"specifier\" of \"def\", \"over\", or \"class\". The + default traversals skip over prims that are \"pure overs\" or classes. So + to protect prototypes from all generic traversals and processing, place + them under a prim that is just an \"over\". For example, + \\code + 01 def PointInstancer \"Crowd_Mid\" + 02 { + 03 rel prototypes = [ , ] + 04 + 05 over \"Prototypes\" + 06 { + 07 def \"MaleThin_Business\" ( + 08 references = [@MaleGroupA/usd/MaleGroupA.usd@] + 09 variants = { + 10 string modelingVariant = \"Thin\" + 11 string costumeVariant = \"BusinessAttire\" + 12 } + 13 ) + 14 { ... } + 15 + 16 def \"MaleThin_Casual\" + 17 ... + 18 } + 19 } + \\endcode + """ +) +{ + vector3f[] accelerations ( + doc = """If authored, per-instance 'accelerations' will be used with + velocities to compute positions between samples for the 'positions' + attribute rather than interpolating between neighboring 'positions' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + vector3f[] angularVelocities ( + doc = """If authored, per-instance angular velocity vector to be used for + interoplating orientations. Angular velocities should be considered + mandatory if both protoIndices and orientations are animated. + Angular velocity is measured in degrees per second. To convert + to degrees per UsdTimeCode, divide by + UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + int64[] ids ( + doc = """Ids are optional; if authored, the ids array should be the same + length as the protoIndices array, specifying (at each timeSample if + instance identities are changing) the id of each instance. The + type is signed intentionally, so that clients can encode some + binary state on Id'd instances without adding a separate primvar. + See also \\ref UsdGeomPointInstancer_varyingTopo""" + ) + int64[] invisibleIds = [] ( + doc = """A list of id's to make invisible at the evaluation time. + See .""" + ) + quath[] orientations ( + doc = """If authored, per-instance orientation of each instance about its + prototype's origin, represented as a unit length quaternion, which + allows us to encode it with sufficient precision in a compact GfQuath. + + It is client's responsibility to ensure that authored quaternions are + unit length; the convenience API below for authoring orientations from + rotation matrices will ensure that quaternions are unit length, though + it will not make any attempt to select the \"better (for interpolation + with respect to neighboring samples)\" of the two possible quaternions + that encode the rotation. + + See also .""" + ) + quatf[] orientationsf ( + doc = """If authored, per-instance orientation of each instance about its + prototype's origin, represented as a unit length quaternion, encoded + as a GfQuatf to support higher precision computations. + + It is client's responsibility to ensure that authored quaternions are + unit length; the convenience API below for authoring orientations from + rotation matrices will ensure that quaternions are unit length, though + it will not make any attempt to select the \"better (for interpolation + with respect to neighboring samples)\" of the two possible quaternions + that encode the rotation. Note that if the earliest time sample (or + default value if there are no time samples) of orientationsf is not empty + orientationsf will be preferred over orientations if both are authored. + + See also .""" + ) + point3f[] positions ( + doc = """Required property. Per-instance position. See also + .""" + ) + int[] protoIndices ( + doc = """Required property. Per-instance index into + prototypes relationship that identifies what geometry should be + drawn for each instance. Topology attribute - can be animated, + but at a potential performance impact for streaming.""" + ) + rel prototypes ( + doc = """Required property. Orders and targets the prototype root + prims, which can be located anywhere in the scenegraph that is convenient, + although we promote organizing prototypes as children of the + PointInstancer. The position of a prototype in this relationship defines + the value an instance would specify in the protoIndices attribute to + instance that prototype. Since relationships are uniform, this property + cannot be animated.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + float3[] scales ( + doc = """If authored, per-instance scale to be applied to + each instance, before any rotation is applied. + + See also .""" + ) + vector3f[] velocities ( + doc = """If provided, per-instance 'velocities' will be used to + compute positions between samples for the 'positions' attribute, + rather than interpolating between neighboring 'positions' samples. + Velocities should be considered mandatory if both protoIndices + and positions are animated. Velocity is measured in position + units per second, as per most simulation software. To convert to + position units per UsdTimeCode, divide by + UsdStage::GetTimeCodesPerSecond(). + + See also + .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Camera "Camera" ( + doc = """Transformable camera. + + Describes optical properties of a camera via a common set of attributes + that provide control over the camera's frustum as well as its depth of + field. For stereo, the left and right camera are individual prims tagged + through the \"stereoRole attribute\". + + There is a corresponding class GfCamera, which can hold the state of a + camera (at a particular time). and + convert between a USD camera prim and + a GfCamera. + + To obtain the camera's location in world space, call the following on a + UsdGeomCamera 'camera': + \\code + GfMatrix4d camXform = camera.ComputeLocalToWorldTransform(time); + \\endcode + \\note + Cameras in USD are always \"Y up\", regardless of the stage's orientation + (i.e. UsdGeomGetStageUpAxis()). This means that the inverse of + 'camXform' (the VIEW half of the MODELVIEW transform in OpenGL parlance) + will transform the world such that the camera is at the origin, looking + down the -Z axis, with +Y as the up axis, and +X pointing to the right. + This describes a __right handed coordinate system__. + + Units of Measure for Camera Properties + + Despite the familiarity of millimeters for specifying some physical + camera properties, UsdGeomCamera opts for greater consistency with all + other UsdGeom schemas, which measure geometric properties in scene units, + as determined by UsdGeomGetStageMetersPerUnit(). We do make a + concession, however, in that lens and filmback properties are measured in + __tenths of a scene unit__ rather than \"raw\" scene units. This means + that with the fallback value of .01 for _metersPerUnit_ - i.e. scene unit + of centimeters - then these \"tenth of scene unit\" properties are + effectively millimeters. + + \\note If one adds a Camera prim to a UsdStage whose scene unit is not + centimeters, the fallback values for filmback properties will be + incorrect (or at the least, unexpected) in an absolute sense; however, + proper imaging through a \"default camera\" with focusing disabled depends + only on ratios of the other properties, so the camera is still usable. + However, it follows that if even one property is authored in the correct + scene units, then they all must be. + + + \\sa \\ref UsdGeom_LinAlgBasics + """ +) +{ + float4[] clippingPlanes = [] ( + doc = """Additional, arbitrarily oriented clipping planes. + A vector (a,b,c,d) encodes a clipping plane that cuts off + (x,y,z) with a * x + b * y + c * z + d * 1 < 0 where (x,y,z) + are the coordinates in the camera's space.""" + ) + float2 clippingRange = (1, 1000000) ( + doc = """Near and far clipping distances in scene units; see + .""" + ) + float exposure = 0 ( + doc = """Exposure adjustment, as a log base-2 value. The default + of 0.0 has no effect. A value of 1.0 will double the + image-plane intensities in a rendered image; a value of + -1.0 will halve them.""" + ) + float focalLength = 50 ( + doc = """Perspective focal length in tenths of a scene unit; see + .""" + ) + float focusDistance = 0 ( + doc = """Distance from the camera to the focus plane in scene units; see + .""" + ) + float fStop = 0 ( + doc = "Lens aperture. Defaults to 0.0, which turns off focusing." + ) + float horizontalAperture = 20.955 ( + doc = """Horizontal aperture in tenths of a scene unit; see + . Default is the equivalent of + the standard 35mm spherical projector aperture.""" + ) + float horizontalApertureOffset = 0 ( + doc = """Horizontal aperture offset in the same units as + horizontalAperture. Defaults to 0.""" + ) + token projection = "perspective" ( + allowedTokens = ["perspective", "orthographic"] + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + double shutter:close = 0 ( + doc = """Frame relative shutter close time, analogous comments from + shutter:open apply. A value greater or equal to shutter:open + should be authored, otherwise there is no exposure and a + renderer should produce a black image.""" + ) + double shutter:open = 0 ( + doc = """Frame relative shutter open time in UsdTimeCode units (negative + value indicates that the shutter opens before the current + frame time). Used for motion blur.""" + ) + uniform token stereoRole = "mono" ( + allowedTokens = ["mono", "left", "right"] + doc = """If different from mono, the camera is intended to be the left + or right camera of a stereo setup.""" + ) + float verticalAperture = 15.2908 ( + doc = """Vertical aperture in tenths of a scene unit; see + . Default is the equivalent of + the standard 35mm spherical projector aperture.""" + ) + float verticalApertureOffset = 0 ( + doc = """Vertical aperture offset in the same units as + verticalAperture. Defaults to 0.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "GeomModelAPI" ( + doc = """UsdGeomModelAPI extends the generic UsdModelAPI schema with + geometry specific concepts such as cached extents for the entire model, + constraint targets, and geometry-inspired extensions to the payload + lofting process. + + As described in GetExtentsHint() below, it is useful to cache extents + at the model level. UsdGeomModelAPI provides schema for computing and + storing these cached extents, which can be consumed by UsdGeomBBoxCache to + provide fast access to precomputed extents that will be used as the model's + bounds ( see UsdGeomBBoxCache::UsdGeomBBoxCache() ). + + Draw Modes + + Draw modes provide optional alternate imaging behavior for USD subtrees with + kind model. model:drawMode (which is inheritable) and + model:applyDrawMode (which is not) are resolved into a decision to stop + traversing the scene graph at a certain point, and replace a USD subtree + with proxy geometry. + + The value of model:drawMode determines the type of proxy geometry: + - origin - Draw the model-space basis vectors of the replaced prim. + - bounds - Draw the model-space bounding box of the replaced prim. + - cards - Draw textured quads as a placeholder for the replaced prim. + - default - An explicit opinion to draw the USD subtree as normal. + - inherited - Defer to the parent opinion. + + model:drawMode falls back to _inherited_ so that a whole scene, + a large group, or all prototypes of a model hierarchy PointInstancer can + be assigned a draw mode with a single attribute edit. If no draw mode is + explicitly set in a hierarchy, the resolved value is _default_. + + model:applyDrawMode is meant to be written when an asset is authored, + and provides flexibility for different asset types. For example, + a character assembly (composed of character, clothes, etc) might have + model:applyDrawMode set at the top of the subtree so the whole group + can be drawn as a single card object. An effects subtree might have + model:applyDrawMode set at a lower level so each particle + group draws individually. + + Models of kind component are automatically treated as if + model:applyDrawMode were true if model:applyDrawMode is not + authored on the component prim. A component prim will be drawn drawn with a + simplified representation when the prim has kind component, + model:applyDrawMode is not authored (or authored to be true), and the + resolved (i.e. inherited down namespace) value for model:drawMode is + not _default_. If you don't want component prims to use the resolved + non-default drawMode, you must apply the UsdGeomModelAPI schema on the prim + and explicitly set model:applyDrawMode to false. + + Cards Geometry + + The specific geometry used in cards mode is controlled by the + model:cardGeometry attribute: + - cross - Generate a quad normal to each basis direction and negative. + Locate each quad so that it bisects the model extents. + - box - Generate a quad normal to each basis direction and negative. + Locate each quad on a face of the model extents, facing out. + - fromTexture - Generate a quad for each supplied texture from + attributes stored in that texture's metadata. + + For cross and box mode, the extents are calculated for purposes + default, proxy, and render, at their earliest authored time. + If the model has no textures, all six card faces are rendered using + model:drawModeColor. If one or more textures are present, only axes + with one or more textures assigned are drawn. For each axis, if both + textures (positive and negative) are specified, they'll be used on the + corresponding card faces; if only one texture is specified, it will be + mapped to the opposite card face after being flipped on the texture's + s-axis. Any card faces with invalid asset paths will be drawn with + model:drawModeColor. + + Both model:cardGeometry and model:drawModeColor should be + authored on the prim where the draw mode takes effect, since these + attributes are not inherited. + + For fromTexture mode, only card faces with valid textures assigned + are drawn. The geometry is generated by pulling the worldtoscreen + attribute out of texture metadata. This is expected to be a 4x4 matrix + mapping the model-space position of the card quad to the clip-space quad + with corners (-1,-1,0) and (1,1,0). The card vertices are generated by + transforming the clip-space corners by the inverse of worldtoscreen. + Textures are mapped so that (s) and (t) map to (+x) and (+y) in clip space. + If the metadata cannot be read in the right format, or the matrix can't + be inverted, the card face is not drawn. + + All card faces are drawn and textured as single-sided. + + \\todo CreatePayload() """ +) +{ + uniform bool model:applyDrawMode = 0 ( + doc = """If true, and the resolved value of model:drawMode is + non-default, apply an alternate imaging mode to this prim. See + \\ref UsdGeomModelAPI_drawMode.""" + ) + uniform token model:cardGeometry = "cross" ( + allowedTokens = ["cross", "box", "fromTexture"] + doc = """The geometry to generate for imaging prims inserted for \\em + cards imaging mode. See for + geometry descriptions.""" + ) + asset model:cardTextureXNeg ( + doc = """In cards imaging mode, the texture applied to the X- quad. + The texture axes (s,t) are mapped to model-space axes (y, -z).""" + ) + asset model:cardTextureXPos ( + doc = """In cards imaging mode, the texture applied to the X+ quad. + The texture axes (s,t) are mapped to model-space axes (-y, -z).""" + ) + asset model:cardTextureYNeg ( + doc = """In cards imaging mode, the texture applied to the Y- quad. + The texture axes (s,t) are mapped to model-space axes (-x, -z).""" + ) + asset model:cardTextureYPos ( + doc = """In cards imaging mode, the texture applied to the Y+ quad. + The texture axes (s,t) are mapped to model-space axes (x, -z).""" + ) + asset model:cardTextureZNeg ( + doc = """In cards imaging mode, the texture applied to the Z- quad. + The texture axes (s,t) are mapped to model-space axes (-x, -y).""" + ) + asset model:cardTextureZPos ( + doc = """In cards imaging mode, the texture applied to the Z+ quad. + The texture axes (s,t) are mapped to model-space axes (x, -y).""" + ) + uniform token model:drawMode = "inherited" ( + allowedTokens = ["origin", "bounds", "cards", "default", "inherited"] + doc = """Alternate imaging mode; applied to this prim or child prims + where model:applyDrawMode is true, or where the prim + has kind component and model:applyDrawMode is not + authored. See \\ref UsdGeomModelAPI_drawMode + for mode descriptions.""" + ) + uniform float3 model:drawModeColor = (0.18, 0.18, 0.18) ( + doc = """The base color of imaging prims inserted for alternate + imaging modes. For origin and bounds modes, this + controls line color; for cards mode, this controls the + fallback quad color.""" + ) +} + +class "MotionAPI" ( + doc = '''UsdGeomMotionAPI encodes data that can live on any prim that + may affect computations involving: + - computed motion for motion blur + - sampling for motion blur + + The "motion:blurScale" attribute allows + artists to scale the __amount__ of motion blur to be rendered for parts + of the scene without changing the recorded animation. See + for use and implementation details. + + ''' +) +{ + float motion:blurScale = 1 ( + doc = """BlurScale is an __inherited__ float attribute that stipulates + the rendered motion blur (as typically specified via UsdGeomCamera's + _shutter:open_ and _shutter:close_ properties) should be scaled for + __all objects__ at and beneath the prim in namespace on which the + _motion:blurScale_ value is specified. + + Without changing any other data in the scene, _blurScale_ allows artists to + \"dial in\" the amount of blur on a per-object basis. A _blurScale_ + value of zero removes all blur, a value of 0.5 reduces blur by half, + and a value of 2.0 doubles the blur. The legal range for _blurScale_ + is [0, inf), although very high values may result in extremely expensive + renders, and may exceed the capabilities of some renderers. + + Although renderers are free to implement this feature however they see + fit, see for our guidance on implementing + the feature universally and efficiently. + + \\sa ComputeMotionBlurScale() + """ + ) + int motion:nonlinearSampleCount = 3 ( + doc = """Determines the number of position or transformation samples + created when motion is described by attributes contributing non-linear + terms. + + To give an example, imagine an application (such as a + renderer) consuming 'points' and the USD document also + contains 'accelerations' for the same prim. Unless the + application can consume these 'accelerations' itself, an + intermediate layer has to compute samples within the sampling + interval for the point positions based on the value of + 'points', 'velocities' and 'accelerations'. The number of these + samples is given by 'nonlinearSampleCount'. The samples are + equally spaced within the sampling interval. + + Another example involves the PointInstancer where + 'nonlinearSampleCount' is relevant when 'angularVelocities' + or 'accelerations' are authored. + + 'nonlinearSampleCount' is an **inherited** attribute, also + see ComputeNonlinearSampleCount()""" + ) + float motion:velocityScale = 1 ( + doc = """\\deprecated + + VelocityScale is an **inherited** float attribute that + velocity-based schemas (e.g. PointBased, PointInstancer) can consume + to compute interpolated positions and orientations by applying + velocity and angularVelocity, which is required for interpolating + between samples when topology is varying over time. Although these + quantities are generally physically computed by a simulator, sometimes + we require more or less motion-blur to achieve the desired look. + VelocityScale allows artists to dial-in, as a post-sim correction, + a scale factor to be applied to the velocity prior to computing + interpolated positions from it.""" + ) +} + +class "XformCommonAPI" ( + doc = """This class provides API for authoring and retrieving a standard set + of component transformations which include a scale, a rotation, a + scale-rotate pivot and a translation. The goal of the API is to enhance + component-wise interchange. It achieves this by limiting the set of allowed + basic ops and by specifying the order in which they are applied. In addition + to the basic set of ops, the 'resetXformStack' bit can also be set to + indicate whether the underlying xformable resets the parent transformation + (i.e. does not inherit it's parent's transformation). + + \\sa UsdGeomXformCommonAPI::GetResetXformStack() + \\sa UsdGeomXformCommonAPI::SetResetXformStack() + + The operator-bool for the class will inform you whether an existing + xformable is compatible with this API. + + The scale-rotate pivot is represented by a pair of (translate, + inverse-translate) xformOps around the scale and rotate operations. + The rotation operation can be any of the six allowed Euler angle sets. + \\sa UsdGeomXformOp::Type. + + The xformOpOrder of an xformable that has all of the supported basic ops + is as follows: + [\"xformOp:translate\", \"xformOp:translate:pivot\", \"xformOp:rotateXYZ\", + \"xformOp:scale\", \"!invert!xformOp:translate:pivot\"]. + + It is worth noting that all of the ops are optional. For example, an + xformable may have only a translate or a rotate. It would still be + considered as compatible with this API. Individual SetTranslate(), + SetRotate(), SetScale() and SetPivot() methods are provided by this API + to allow such sparse authoring.""" +) +{ +} + +class HermiteCurves "HermiteCurves" ( + doc = """This schema specifies a cubic hermite interpolated curve batch as + sometimes used for defining guides for animation. While hermite curves can + be useful because they interpolate through their control points, they are + not well supported by high-end renderers for imaging. Therefore, while we + include this schema for interchange, we strongly recommend the use of + UsdGeomBasisCurves as the representation of curves intended to be rendered + (ie. hair or grass). Hermite curves can be converted to a Bezier + representation (though not from Bezier back to Hermite in general). + + Point Interpolation + + The initial cubic curve segment is defined by the first two points and + first two tangents. Additional segments are defined by additional + point / tangent pairs. The number of segments for each non-batched hermite + curve would be len(curve.points) - 1. The total number of segments + for the batched UsdGeomHermiteCurves representation is + len(points) - len(curveVertexCounts). + + Primvar, Width, and Normal Interpolation + + Primvar interpolation is not well specified for this type as it is not + intended as a rendering representation. We suggest that per point + primvars would be linearly interpolated across each segment and should + be tagged as 'varying'. + + It is not immediately clear how to specify cubic or 'vertex' interpolation + for this type, as we lack a specification for primvar tangents. This + also means that width and normal interpolation should be restricted to + varying (linear), uniform (per curve element), or constant (per prim). + """ +) +{ + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + int[] curveVertexCounts ( + doc = """Curves-derived primitives can represent multiple distinct, + potentially disconnected curves. The length of 'curveVertexCounts' + gives the number of such curves, and each element describes the + number of vertices in the corresponding curve""" + ) + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + vector3f[] tangents = [] ( + doc = """Defines the outgoing trajectory tangent for each point. + Tangents should be the same size as the points attribute.""" + ) + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also .""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + float[] widths ( + doc = """Provides width specification for the curves, whose application + will depend on whether the curve is oriented (normals are defined for + it), in which case widths are \"ribbon width\", or unoriented, in which + case widths are cylinder width. 'widths' is not a generic Primvar, + but the number of elements in this attribute will be determined by + its 'interpolation'. See . If 'widths' + and 'primvars:widths' are both specified, the latter has precedence.""" + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "constraintTargetIdentifier": { + "appliesTo": [ + "attributes" + ], + "default": "", + "documentation": "Unique identifier within a model's namespace for an matrix-valued attribute representing a constraint target", + "type": "token" + }, + "elementSize": { + "appliesTo": [ + "attributes" + ], + "default": 1, + "displayGroup": "Primvars", + "documentation": "The number of values in a primvar's value array that must be aggregated for each element on the primitive.", + "type": "int" + }, + "inactiveIds": { + "appliesTo": [ + "prims" + ], + "type": "int64listop" + }, + "interpolation": { + "appliesTo": [ + "attributes" + ], + "default": "constant", + "displayGroup": "Primvars", + "documentation": "How a primvar interpolates across a primitive; equivalent to RenderMan's 'class specifier'", + "type": "token" + }, + "metersPerUnit": { + "appliesTo": [ + "layers" + ], + "default": 0.01, + "displayGroup": "Stage", + "type": "double" + }, + "unauthoredValuesIndex": { + "appliesTo": [ + "attributes" + ], + "default": -1, + "displayGroup": "Primvars", + "documentation": "The index that represents unauthored values in the indices array of an indexed primvar.", + "type": "int" + }, + "upAxis": { + "appliesTo": [ + "layers" + ], + "default": "Y", + "displayGroup": "Stage", + "type": "token" + } + }, + "Types": { + "UsdGeomBasisCurves": { + "alias": { + "UsdSchemaBase": "BasisCurves" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomCurves" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomBoundable": { + "alias": { + "UsdSchemaBase": "Boundable" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "schemaKind": "abstractTyped" + }, + "UsdGeomCamera": { + "alias": { + "UsdSchemaBase": "Camera" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomCapsule": { + "alias": { + "UsdSchemaBase": "Capsule" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomCapsule_1": { + "alias": { + "UsdSchemaBase": "Capsule_1" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomCone": { + "alias": { + "UsdSchemaBase": "Cone" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomCube": { + "alias": { + "UsdSchemaBase": "Cube" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomCurves": { + "alias": { + "UsdSchemaBase": "Curves" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomPointBased" + ], + "implementsComputeExtent": true, + "schemaKind": "abstractTyped" + }, + "UsdGeomCylinder": { + "alias": { + "UsdSchemaBase": "Cylinder" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomCylinder_1": { + "alias": { + "UsdSchemaBase": "Cylinder_1" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomGprim": { + "alias": { + "UsdSchemaBase": "Gprim" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomBoundable" + ], + "schemaKind": "abstractTyped" + }, + "UsdGeomHermiteCurves": { + "alias": { + "UsdSchemaBase": "HermiteCurves" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomCurves" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomImageable": { + "alias": { + "UsdSchemaBase": "Imageable" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "abstractTyped" + }, + "UsdGeomMesh": { + "alias": { + "UsdSchemaBase": "Mesh" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomPointBased" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomModelAPI": { + "alias": { + "UsdSchemaBase": "GeomModelAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdGeomMotionAPI": { + "alias": { + "UsdSchemaBase": "MotionAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdGeomNurbsCurves": { + "alias": { + "UsdSchemaBase": "NurbsCurves" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomCurves" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomNurbsPatch": { + "alias": { + "UsdSchemaBase": "NurbsPatch" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomPointBased" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomPlane": { + "alias": { + "UsdSchemaBase": "Plane" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomPointBased": { + "alias": { + "UsdSchemaBase": "PointBased" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "abstractTyped" + }, + "UsdGeomPointInstancer": { + "alias": { + "UsdSchemaBase": "PointInstancer" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomBoundable" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomPoints": { + "alias": { + "UsdSchemaBase": "Points" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomPointBased" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomPrimvarsAPI": { + "alias": { + "UsdSchemaBase": "PrimvarsAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "nonAppliedAPI" + }, + "UsdGeomScope": { + "alias": { + "UsdSchemaBase": "Scope" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomImageable" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomSphere": { + "alias": { + "UsdSchemaBase": "Sphere" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdGeomSubset": { + "alias": { + "UsdSchemaBase": "GeomSubset" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomTetMesh": { + "alias": { + "UsdSchemaBase": "TetMesh" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomPointBased" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomVisibilityAPI": { + "alias": { + "UsdSchemaBase": "VisibilityAPI" + }, + "apiSchemaCanOnlyApplyTo": [ + "Imageable" + ], + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdGeomXform": { + "alias": { + "UsdSchemaBase": "Xform" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "schemaKind": "concreteTyped" + }, + "UsdGeomXformCommonAPI": { + "alias": { + "UsdSchemaBase": "XformCommonAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "nonAppliedAPI" + }, + "UsdGeomXformable": { + "alias": { + "UsdSchemaBase": "Xformable" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomImageable" + ], + "schemaKind": "abstractTyped" + } + } + }, + "LibraryPath": "", + "Name": "usdGeom", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + "This file describes the USD Geometric schemata for code generation." + subLayers = [ + @usd/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdGeom" + string libraryPath = "pxr/usd/usdGeom" + # string libraryPrefix = "UsdGeom" + # string tokensPrefix = "UsdGeom" + bool useLiteralIdentifier = 0 + dictionary libraryTokens = { + dictionary interpolation = { + string doc = """UsdGeomPrimvar - How a Primvar interpolates + across a primitive; equivalent to RenderMan's \\ref Usd_InterpolationVals "class specifier" """ + } + dictionary elementSize = { + string doc = """UsdGeomPrimvar - The number of values in the + value array that must be aggregated for each element on the + primitive.""" + } + dictionary unauthoredValuesIndex = { + string doc = """UsdGeomPrimvar - The index that represents + unauthored values in the indices array of an indexed primvar.""" + } + dictionary constant ={ + string doc = """Possible value for UsdGeomPrimvar::SetInterpolation. + Default value for UsdGeomPrimvar::GetInterpolation. One value + remains constant over the entire surface primitive.""" + } + dictionary uniform = { + string doc = """Possible value for UsdGeomPrimvar::SetInterpolation. + One value remains constant for each uv patch segment of the + surface primitive (which is a \\em face for meshes).""" + } + dictionary varying = { + string doc = """Possible value for UsdGeomPrimvar::SetInterpolation. + Four values are interpolated over each uv patch segment of the + surface. Bilinear interpolation is used for interpolation + between the four values.""" + } + dictionary vertex = { + string doc = """Possible value for UsdGeomPrimvar::SetInterpolation. + Values are interpolated between each vertex in the surface + primitive. The basis function of the surface is used for + interpolation between vertices.""" + } + dictionary faceVarying = { + string doc = """Possible value for UsdGeomPrimvar::SetInterpolation. + For polygons and subdivision surfaces, four values are + interpolated over each face of the mesh. Bilinear interpolation + is used for interpolation between the four values.""" + } + dictionary upAxis = { + string doc = """Stage-level metadata that encodes a scene's + orientation as a token whose value can be "Y" or "Z".""" + } + dictionary metersPerUnit = { + string doc = """Stage-level metadata that encodes a scene's + linear unit of measure as meters per encoded unit.""" + } + dictionary partition = { + string doc = """A type of family of GeomSubsets. It implies + that every element appears exacly once in only one of the + subsets in the family.""" + } + dictionary nonOverlapping = { + string doc = """A type of family of GeomSubsets. It implies that + the elements in the various subsets belonging to the family are + mutually exclusive, i.e., an element that appears in one + subset may not belong to any other subset in the family.""" + } + dictionary unrestricted = { + string doc = """A type of family of GeomSubsets. It implies that + there are no restrictions w.r.t. the membership of elements in + the subsets. There could be overlapping members in subsets + belonging to the family and the union of all subsets in the + family may not contain all the elements.""" + } + dictionary hermite = { + string doc = """A deprecated basis token for + UsdGeomBasisCurves. Consumers of USD should transition + to using the UsdGeomHermiteCurves schema.""" + } + dictionary power = { + string doc = """A deprecated basis token for + UsdGeomBasisCurves.""" + } + } + } +) +{ +} + +class "Imageable" ( + inherits = + doc = """Base class for all prims that may require rendering or + visualization of some sort. The primary attributes of Imageable + are \\em visibility and \\em purpose, which each provide instructions for + what geometry should be included for processing by rendering and other + computations. + + \\deprecated Imageable also provides API for accessing primvars, which + has been moved to the UsdGeomPrimvarsAPI schema, because primvars can now + be applied on non-Imageable prim types. This API is planned + to be removed, UsdGeomPrimvarsAPI should be used directly instead.""" + customData = { + string extraIncludes = """ +#include "pxr/base/gf/bbox3d.h" +#include "pxr/usd/usdGeom/primvar.h" """ + } +) { + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = """Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.""" + ) + + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See \\ref UsdGeom_ImageablePurpose for more detail about how + \\em purpose is computed and used.""" + ) + rel proxyPrim ( + doc = """The \\em proxyPrim relationship allows us to link a + prim whose \\em purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + \\li In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + \\li DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + \\li With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".""" + ) +} + +class "VisibilityAPI" +( + inherits = + customData = { + token[] apiSchemaCanOnlyApplyTo = [ + "Imageable" + ] + } + doc = """ + UsdGeomVisibilityAPI introduces properties that can be used to author + visibility opinions. + + \\note + Currently, this schema only introduces the attributes that are used to + control purpose visibility. Later, this schema will define _all_ + visibility-related properties and UsdGeomImageable will no longer define + those properties. + + The purpose visibility attributes added by this schema, + _guideVisibility_, _proxyVisibility_, and _renderVisibility_ can each be + used to control visibility for geometry of the corresponding purpose + values, with the overall _visibility_ attribute acting as an + override. I.e., if _visibility_ evaluates to "invisible", purpose + visibility is invisible; otherwise, purpose visibility is determined by + the corresponding purpose visibility attribute. + + Note that the behavior of _guideVisibility_ is subtly different from the + _proxyVisibility_ and _renderVisibility_ attributes, in that "guide" + purpose visibility always evaluates to either "invisible" or "visible", + whereas the other attributes may yield computed values of "inherited" if + there is no authored opinion on the attribute or inherited from an + ancestor. This is motivated by the fact that, in Pixar"s user workflows, + we have never found a need to have all guides visible in a scene by + default, whereas we do find that flexibility useful for "proxy" and + "render" geometry. + + This schema can only be applied to UsdGeomImageable prims. The + UseGeomImageable schema provides API for computing the purpose visibility + values that result from the attributes introduced by this schema. + """ +) +{ + uniform token guideVisibility = "invisible" ( + allowedTokens = ["inherited", "invisible", "visible"] + doc = """ + This attribute controls visibility for geometry with purpose "guide". + + Unlike overall _visibility_, _guideVisibility_ is uniform, and + therefore cannot be animated. + + Also unlike overall _visibility_, _guideVisibility_ is tri-state, in + that a descendant with an opinion of "visible" overrides an ancestor + opinion of "invisible". + + The _guideVisibility_ attribute works in concert with the overall + _visibility_ attribute: The visibility of a prim with purpose "guide" + is determined by the inherited values it receives for the _visibility_ + and _guideVisibility_ attributes. If _visibility_ evaluates to + "invisible", the prim is invisible. If _visibility_ evaluates to + "inherited" and _guideVisibility_ evaluates to "visible", then the + prim is visible. __Otherwise, it is invisible.__ + """ + ) + + uniform token proxyVisibility = "inherited" ( + allowedTokens = ["inherited", "invisible", "visible"] + doc = """ + This attribute controls visibility for geometry with purpose "proxy". + + Unlike overall _visibility_, _proxyVisibility_ is uniform, and + therefore cannot be animated. + + Also unlike overall _visibility_, _proxyVisibility_ is tri-state, in + that a descendant with an opinion of "visible" overrides an ancestor + opinion of "invisible". + + The _proxyVisibility_ attribute works in concert with the overall + _visibility_ attribute: The visibility of a prim with purpose "proxy" + is determined by the inherited values it receives for the _visibility_ + and _proxyVisibility_ attributes. If _visibility_ evaluates to + "invisible", the prim is invisible. If _visibility_ evaluates to + "inherited" then: If _proxyVisibility_ evaluates to "visible", then + the prim is visible; if _proxyVisibility_ evaluates to "invisible", + then the prim is invisible; if _proxyVisibility_ evaluates to + "inherited", then the prim may either be visible or invisible, + depending on a fallback value determined by the calling context. + """ + ) + + uniform token renderVisibility = "inherited" ( + allowedTokens = ["inherited", "invisible", "visible"] + doc = """ + This attribute controls visibility for geometry with purpose + "render". + + Unlike overall _visibility_, _renderVisibility_ is uniform, and + therefore cannot be animated. + + Also unlike overall _visibility_, _renderVisibility_ is tri-state, in + that a descendant with an opinion of "visible" overrides an ancestor + opinion of "invisible". + + The _renderVisibility_ attribute works in concert with the overall + _visibility_ attribute: The visibility of a prim with purpose "render" + is determined by the inherited values it receives for the _visibility_ + and _renderVisibility_ attributes. If _visibility_ evaluates to + "invisible", the prim is invisible. If _visibility_ evaluates to + "inherited" then: If _renderVisibility_ evaluates to "visible", then + the prim is visible; if _renderVisibility_ evaluates to "invisible", + then the prim is invisible; if _renderVisibility_ evaluates to + "inherited", then the prim may either be visible or invisible, + depending on a fallback value determined by the calling context. + """ + ) +} + +class "PrimvarsAPI" ( + inherits = + doc = """UsdGeomPrimvarsAPI encodes geometric "primitive variables", + as UsdGeomPrimvar, which interpolate across a primitive's topology, + can override shader inputs, and inherit down namespace. + + \\section usdGeom_PrimvarFetchingAPI Which Method to Use to Retrieve Primvars + + While creating primvars is unambiguous (CreatePrimvar()), there are quite + a few methods available for retrieving primvars, making it potentially + confusing knowing which one to use. Here are some guidelines: + + \\li If you are populating a GUI with the primvars already available for + authoring values on a prim, use GetPrimvars(). + \\li If you want all of the "useful" (e.g. to a renderer) primvars + available at a prim, including those inherited from ancestor prims, use + FindPrimvarsWithInheritance(). Note that doing so individually for many + prims will be inefficient. + \\li To find a particular primvar defined directly on a prim, which may + or may not provide a value, use GetPrimvar(). + \\li To find a particular primvar defined on a prim or inherited from + ancestors, which may or may not provide a value, use + FindPrimvarWithInheritance(). + \\li To *efficiently* query for primvars using the overloads of + FindPrimvarWithInheritance() and FindPrimvarsWithInheritance(), one + must first cache the results of FindIncrementallyInheritablePrimvars() for + each non-leaf prim on the stage. """ + customData = { + token apiSchemaType = "nonApplied" + string extraIncludes = """ +#include "pxr/usd/usdGeom/primvar.h" """ + } +) { +} + +class "Xformable" ( + inherits = + customData = { + string extraIncludes = """ +#include "pxr/usd/usdGeom/xformOp.h" +#include """ + } + doc = """Base class for all transformable prims, which allows arbitrary + sequences of component affine transformations to be encoded. + + \\note + You may find it useful to review \\ref UsdGeom_LinAlgBasics while reading + this class description. + + Supported Component Transformation Operations + + UsdGeomXformable currently supports arbitrary sequences of the following + operations, each of which can be encoded in an attribute of the proper + shape in any supported precision: + \\li translate - 3D + \\li scale - 3D + \\li rotateX - 1D angle in degrees + \\li rotateY - 1D angle in degrees + \\li rotateZ - 1D angle in degrees + \\li rotateABC - 3D where ABC can be any combination of the six principle + Euler Angle sets: XYZ, XZY, YXZ, YZX, ZXY, ZYX. See + \\ref usdGeom_rotationPackingOrder "note on rotation packing order" + \\li orient - 4D (quaternion) + \\li transform - 4x4D + + Creating a Component Transformation + + To add components to a UsdGeomXformable prim, simply call AddXformOp() + with the desired op type, as enumerated in \\ref UsdGeomXformOp::Type, + and the desired precision, which is one of \\ref UsdGeomXformOp::Precision. + Optionally, you can also provide an "op suffix" for the operator that + disambiguates it from other components of the same type on the same prim. + Application-specific transform schemas can use the suffixes to fill a role + similar to that played by AbcGeom::XformOp's "Hint" enums for their own + round-tripping logic. + + We also provide specific "Add" API for each type, for clarity and + conciseness, e.g. AddTranslateOp(), AddRotateXYZOp() etc. + + AddXformOp() will return a UsdGeomXformOp object, which is a schema on a + newly created UsdAttribute that provides convenience API for authoring + and computing the component transformations. The UsdGeomXformOp can then + be used to author any number of timesamples and default for the op. + + Each successive call to AddXformOp() adds an operator that will be applied + "more locally" than the preceding operator, just as if we were pushing + transforms onto a transformation stack - which is precisely what should + happen when the operators are consumed by a reader. + + \\note + If you can, please try to use the UsdGeomXformCommonAPI, which wraps + the UsdGeomXformable with an interface in which Op creation is taken + care of for you, and there is a much higher chance that the data you + author will be importable without flattening into other DCC's, as it + conforms to a fixed set of Scale-Rotate-Translate Ops. + + \\sa \\ref usdGeom_xformableExamples "Using the Authoring API" + + Data Encoding and Op Ordering + + Because there is no "fixed schema" of operations, all of the attributes + that encode transform operations are dynamic, and are scoped in + the namespace "xformOp". The second component of an attribute's name provides + the \\em type of operation, as listed above. An "xformOp" attribute can + have additional namespace components derived from the \\em opSuffix argument + to the AddXformOp() suite of methods, which provides a preferred way of + naming the ops such that we can have multiple "translate" ops with unique + attribute names. For example, in the attribute named + "xformOp:translate:maya:pivot", "translate" is the type of operation and + "maya:pivot" is the suffix. + + The following ordered list of attribute declarations in usda + define a basic Scale-Rotate-Translate with XYZ Euler angles, wherein the + translation is double-precision, and the remainder of the ops are single, + in which we will: + +
    +
  1. Scale by 2.0 in each dimension +
  2. Rotate about the X, Y, and Z axes by 30, 60, and 90 degrees, respectively +
  3. Translate by 100 units in the Y direction +
+ + \\code + float3 xformOp:rotateXYZ = (30, 60, 90) + float3 xformOp:scale = (2, 2, 2) + double3 xformOp:translate = (0, 100, 0) + uniform token[] xformOpOrder = [ "xformOp:translate", "xformOp:rotateXYZ", "xformOp:scale" ] + \\endcode + + The attributes appear in the dictionary order in which USD, by default, + sorts them. To ensure the ops are recovered and evaluated in the correct + order, the schema introduces the **xformOpOrder** attribute, which + contains the names of the op attributes, in the precise sequence in which + they should be pushed onto a transform stack. **Note** that the order is + opposite to what you might expect, given the matrix algebra described in + \\ref UsdGeom_LinAlgBasics. This also dictates order of op creation, + since each call to AddXformOp() adds a new op to the end of the + \\b xformOpOrder array, as a new "most-local" operation. See + \\ref usdGeom_xformableExamples "Example 2 below" for C++ code that could + have produced this USD. + + If it were important for the prim's rotations to be independently + overridable, we could equivalently (at some performance cost) encode + the transformation also like so: + \\code + float xformOp:rotateX = 30 + float xformOp:rotateY = 60 + float xformOp:rotateZ = 90 + float3 xformOp:scale = (2, 2, 2) + double3 xformOp:translate = (0, 100, 0) + uniform token[] xformOpOrder = [ "xformOp:translate", "xformOp:rotateZ", "xformOp:rotateY", "xformOp:rotateX", "xformOp:scale" ] + \\endcode + + Again, note that although we are encoding an XYZ rotation, the three + rotations appear in the **xformOpOrder** in the opposite order, with Z, + followed, by Y, followed by X. + + Were we to add a Maya-style scalePivot to the above example, it might + look like the following: + \\code + float3 xformOp:rotateXYZ = (30, 60, 90) + float3 xformOp:scale = (2, 2, 2) + double3 xformOp:translate = (0, 100, 0) + double3 xformOp:translate:scalePivot + uniform token[] xformOpOrder = [ "xformOp:translate", "xformOp:rotateXYZ", "xformOp:translate:scalePivot", "xformOp:scale" ] + \\endcode + + Paired "Inverted" Ops + + We have been claiming that the ordered list of ops serves as a set + of instructions to a transform stack, but you may have noticed in the last + example that there is a missing operation - the pivot for the scale op + needs to be applied in its inverse-form as a final (most local) op! In the + AbcGeom::Xform schema, we would have encoded an actual "final" translation + op whose value was authored by the exporter as the negation of the pivot's + value. However, doing so would be brittle in USD, given that each op can + be independently overridden, and the constraint that one attribute must be + maintained as the negation of the other in order for successful + re-importation of the schema cannot be expressed in USD. + + Our solution leverages the **xformOpOrder** member of the schema, which, + in addition to ordering the ops, may also contain one of two special + tokens that address the paired op and "stack resetting" behavior. + + The "paired op" behavior is encoded as an "!invert!" prefix in + \\b xformOpOrder, as the result of an AddXformOp(isInverseOp=True) call. + The \\b xformOpOrder for the last example would look like: + \\code + uniform token[] xformOpOrder = [ "xformOp:translate", "xformOp:rotateXYZ", "xformOp:translate:scalePivot", "xformOp:scale", "!invert!xformOp:translate:scalePivot" ] + \\endcode + + When asked for its value via UsdGeomXformOp::GetOpTransform(), an + "inverted" Op (i.e. the "inverted" half of a set of paired Ops) will fetch + the value of its paired attribute and return its negation. This works for + all op types - an error will be issued if a "transform" type op is singular + and cannot be inverted. When getting the authored value of an inverted op + via UsdGeomXformOp::Get(), the raw, uninverted value of the associated + attribute is returned. + + For the sake of robustness, setting a value on an inverted op is disallowed. + Attempting to set a value on an inverted op will result in a coding error + and no value being set. + + Resetting the Transform Stack + + The other special op/token that can appear in \\em xformOpOrder is + \\em "!resetXformStack!", which, appearing as the first element of + \\em xformOpOrder, indicates this prim should not inherit the transformation + of its namespace parent. See SetResetXformStack() + + Expected Behavior for "Missing" Ops + + If an importer expects Scale-Rotate-Translate operations, but a prim + has only translate and rotate ops authored, the importer should assume + an identity scale. This allows us to optimize the data a bit, if only + a few components of a very rich schema (like Maya's) are authored in the + app. + + \\anchor usdGeom_xformableExamples + Using the C++ API + + #1. Creating a simple transform matrix encoding + \\snippet examples_usdGeom.cpp CreateMatrixWithDefault + + #2. Creating the simple SRT from the example above + \\snippet examples_usdGeom.cpp CreateExampleSRT + + #3. Creating a parameterized SRT with pivot using UsdGeomXformCommonAPI + \\snippet examples_usdGeom.cpp CreateSRTWithDefaults + + #4. Creating a rotate-only pivot transform with animated + rotation and translation + \\snippet examples_usdGeom.cpp CreateAnimatedTransform + +""" +) { + + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Scope "Scope" ( + inherits = + doc = """Scope is the simplest grouping primitive, and does not carry the + baggage of transformability. Note that transforms should inherit down + through a Scope successfully - it is just a guaranteed no-op from a + transformability perspective.""" +) { +} + +class Xform "Xform" ( + inherits = + doc = """Concrete prim schema for a transform, which implements Xformable """ +) { +} + +class "Boundable" ( + inherits = + doc = """Boundable introduces the ability for a prim to persistently + cache a rectilinear, local-space, extent. + + \\section UsdGeom_Boundable_Extent Why Extent and not Bounds ? + Boundable introduces the notion of "extent", which is a cached computation + of a prim's local-space 3D range for its resolved attributes at the + layer and time in which extent is authored. We have found that with + composed scene description, attempting to cache pre-computed bounds at + interior prims in a scene graph is very fragile, given the ease with which + one can author a single attribute in a stronger layer that can invalidate + many authored caches - or with which a re-published, referenced asset can + do the same. + + Therefore, we limit to precomputing (generally) leaf-prim extent, which + avoids the need to read in large point arrays to compute bounds, and + provides UsdGeomBBoxCache the means to efficiently compute and + (session-only) cache intermediate bounds. You are free to compute and + author intermediate bounds into your scenes, of course, which may work + well if you have sufficient locks on your pipeline to guarantee that once + authored, the geometry and transforms upon which they are based will + remain unchanged, or if accuracy of the bounds is not an ironclad + requisite. + + When intermediate bounds are authored on Boundable parents, the child prims + will be pruned from BBox computation; the authored extent is expected to + incorporate all child bounds.""" +) +{ + # XXX: Note this is really a GfRange3f, which is not fully supported + # in Vt I/O. + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), \\em without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) +} + +class "Gprim" ( + inherits = + doc = """Base class for all geometric primitives. + + Gprim encodes basic graphical properties such as \\em doubleSided and + \\em orientation, and provides primvars for "display color" and "display + opacity" that travel with geometry to be used as shader overrides. """ + +) { + color3f[] primvars:displayColor ( + customData = { + string apiName = "displayColor" + } + doc = """It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a \\em displayColor parameter.""" + ) + + float[] primvars:displayOpacity ( + customData = { + string apiName = "displayOpacity" + } + doc = """Companion to \\em displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + + uniform bool doubleSided = false ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + \\em orientation. By doing so they can perform "backface culling" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's \\em doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see \\ref UsdGeom_WindingOrder for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) +} + +class Cube "Cube" ( + inherits = + doc = """Defines a primitive rectilinear cube centered at the origin. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double size = 2.0 ( + doc = """Indicates the length of each edge of the cube. If you + author \\em size you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + + float3[] extent = [(-1.0, -1.0, -1.0), (1.0, 1.0, 1.0)] ( + doc = """Extent is re-defined on Cube only to provide a fallback value. + \\sa UsdGeomGprim::GetExtentAttr().""" + ) + +} + +class Sphere "Sphere" ( + inherits = + doc = """Defines a primitive sphere centered at the origin. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double radius = 1.0 ( + doc = """Indicates the sphere's radius. If you + author \\em radius you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + + float3[] extent = [(-1.0, -1.0, -1.0), (1.0, 1.0, 1.0)] ( + doc = """Extent is re-defined on Sphere only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class Cylinder "Cylinder" ( + inherits = + doc = """Defines a primitive cylinder with closed ends, centered at the + origin, whose spine is along the specified \\em axis. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double height = 2 ( + doc = """The size of the cylinder's spine along the specified + \\em axis. If you author \\em height you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + double radius = 1.0 ( + doc = """The radius of the cylinder. If you author \\em radius + you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the spine of the cylinder is aligned""" + ) + + float3[] extent = [(-1.0, -1.0, -1.0), (1.0, 1.0, 1.0)] ( + doc = """Extent is re-defined on Cylinder only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class Capsule "Capsule" ( + inherits = + doc = """Defines a primitive capsule, i.e. a cylinder capped by two half + spheres, centered at the origin, whose spine is along the specified + \\em axis. + The spherical cap heights (sagitta) of the two endcaps are a function of + the relative radii of the endcaps, such that cylinder tangent and sphere + tangent are coincident and maintain C1 continuity.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double height = 1.0 ( + doc = """The length of the capsule's spine along the specified + \\em axis excluding the size of the two half spheres, i.e. + the length of the cylinder portion of the capsule. + If you author \\em height you must also author \\em extent. + \\sa GetExtentAttr()""" + ) + double radius = 0.5 ( + doc = """The radius of the capsule. If you + author \\em radius you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the spine of the capsule is aligned""" + ) + + float3[] extent = [(-0.5, -0.5, -1.0), (0.5, 0.5, 1.0)] ( + doc = """Extent is re-defined on Capsule only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class Cone "Cone" ( + inherits = + doc = """Defines a primitive cone, centered at the origin, whose spine + is along the specified \\em axis, with the apex of the cone pointing + in the direction of the positive axis. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double height = 2.0 ( + doc = """The length of the cone's spine along the specified + \\em axis. If you author \\em height you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + double radius = 1.0 ( + doc = """The radius of the cone. If you + author \\em radius you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the spine of the cone is aligned""" + ) + + float3[] extent = [(-1.0, -1.0, -1.0), (1.0, 1.0, 1.0)] ( + doc = """Extent is re-defined on Cone only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class Cylinder_1 "Cylinder_1" ( + inherits = + doc = """Defines a primitive cylinder with closed ends, centered at the + origin, whose spine is along the specified \\em axis, with a pair of radii + describing the size of the end points. + + The fallback values for Cube, Sphere, Cone, and Cylinder are set so that + they all pack into the same volume/bounds.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double height = 2 ( + doc = """The length of the cylinder's spine along the specified + \\em axis. If you author \\em height you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + double radiusTop = 1.0 ( + doc = """The radius of the top of the cylinder - i.e. the face located + along the positive \\em axis. If you author \\em radiusTop you must also + author \\em extent. + + \\sa GetExtentAttr()""" + ) + double radiusBottom = 1.0 ( + doc = """The radius of the bottom of the cylinder - i.e. the face + point located along the negative \\em axis. If you author + \\em radiusBottom you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the spine of the cylinder is aligned""" + ) + + float3[] extent = [(-1.0, -1.0, -1.0), (1.0, 1.0, 1.0)] ( + doc = """Extent is re-defined on Cylinder only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class Capsule_1 "Capsule_1" ( + inherits = + doc = """Defines a primitive capsule, i.e. a cylinder capped by two half + spheres, with potentially different radii, centered at the origin, and whose + spine is along the specified \\em axis. + The spherical cap heights (sagitta) of the two endcaps are a function of + the relative radii of the endcaps, such that cylinder tangent and sphere + tangent are coincident and maintain C1 continuity.""" + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + double height = 1.0 ( + doc = """The length of the capsule's spine along the specified + \\em axis excluding the size of the two half spheres, i.e. + the length of the cylinder portion of the capsule. + If you author \\em height you must also author \\em extent. + \\sa GetExtentAttr()""" + ) + double radiusTop = 0.5 ( + doc = """The radius of the capping sphere at the top of the capsule - + i.e. the sphere in the direction of the positive \\em axis. If you + author \\em radius you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + double radiusBottom = 0.5 ( + doc = """The radius of the capping sphere at the bottom of the capsule - + i.e. the sphere located in the direction of the negative \\em axis. If + you author \\em radius you must also author \\em extent. + + \\sa GetExtentAttr()""" + ) + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the spine of the capsule is aligned""" + ) + + float3[] extent = [(-0.5, -0.5, -1.0), (0.5, 0.5, 1.0)] ( + doc = """Extent is re-defined on Capsule only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class Plane "Plane" ( + inherits = + doc = """Defines a primitive plane, centered at the origin, and is defined by + a cardinal axis, width, and length. The plane is double-sided by default. + + The axis of width and length are perpendicular to the plane's \\em axis: + + axis | width | length + ----- | ------ | ------- + X | z-axis | y-axis + Y | x-axis | z-axis + Z | x-axis | y-axis + + """ + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + uniform bool doubleSided = true ( + doc = """Planes are double-sided by default. Clients may also support + single-sided planes. + + \\sa UsdGeomGprim::GetDoubleSidedAttr()""" + ) + double width = 2.0 ( + doc = """The width of the plane, which aligns to the x-axis when \\em axis is + 'Z' or 'Y', or to the z-axis when \\em axis is 'X'. If you author \\em width + you must also author \\em extent. + + \\sa UsdGeomGprim::GetExtentAttr()""" + ) + double length = 2.0 ( + doc = """The length of the plane, which aligns to the y-axis when \\em axis is + 'Z' or 'X', or to the z-axis when \\em axis is 'Y'. If you author \\em length + you must also author \\em extent. + + \\sa UsdGeomGprim::GetExtentAttr()""" + ) + uniform token axis = "Z" ( + allowedTokens = ["X", "Y", "Z"] + doc = """The axis along which the surface of the plane is aligned. When set + to 'Z' the plane is in the xy-plane; when \\em axis is 'X' the plane is in + the yz-plane, and when \\em axis is 'Y' the plane is in the xz-plane. + + \\sa UsdGeomGprim::GetAxisAttr().""" + ) + float3[] extent = [(-1.0, -1.0, 0.0), (1.0, 1.0, 0.0)] ( + doc = """Extent is re-defined on Plane only to provide a fallback + value. \\sa UsdGeomGprim::GetExtentAttr().""" + ) +} + +class "PointBased" ( + doc = """Base class for all UsdGeomGprims that possess points, + providing common attributes such as normals and velocities.""" + + inherits = + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { + # positional + point3f[] points ( + doc = """The primary geometry attribute for all PointBased + primitives, describes points in (local) space.""" + ) + + vector3f[] velocities ( + doc = """If provided, 'velocities' should be used by renderers to + + compute positions between samples for the 'points' attribute, rather + than interpolating between neighboring 'points' samples. This is the + only reasonable means of computing motion blur for topologically + varying PointBased primitives. It follows that the length of each + 'velocities' sample must match the length of the corresponding + 'points' sample. Velocity is measured in position units per second, + as per most simulation software. To convert to position units per + UsdTimeCode, divide by UsdStage::GetTimeCodesPerSecond(). + + See also \\ref UsdGeom_VelocityInterpolation .""" + ) + + vector3f[] accelerations ( + doc = """If provided, 'accelerations' should be used with + velocities to compute positions between samples for the 'points' + attribute rather than interpolating between neighboring 'points' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + + # shaping + normal3f[] normals ( + doc = """Provide an object-space orientation for individual points, + which, depending on subclass, may define a surface, curve, or free + points. Note that 'normals' should not be authored on any Mesh that + is subdivided, since the subdivision algorithm will define its own + normals. 'normals' is not a generic primvar, but the number of elements + in this attribute will be determined by its 'interpolation'. See + \\ref SetNormalsInterpolation() . If 'normals' and 'primvars:normals' + are both specified, the latter has precedence.""" + ) +} + +class Mesh "Mesh" ( + inherits = + customData = { + string extraIncludes = """ +#include "pxr/usd/usd/timeCode.h" """ + } + doc="""Encodes a mesh with optional subdivision properties and features. + + As a point-based primitive, meshes are defined in terms of points that + are connected into edges and faces. Many references to meshes use the + term 'vertex' in place of or interchangeably with 'points', while some + use 'vertex' to refer to the 'face-vertices' that define a face. To + avoid confusion, the term 'vertex' is intentionally avoided in favor of + 'points' or 'face-vertices'. + + The connectivity between points, edges and faces is encoded using a + common minimal topological description of the faces of the mesh. Each + face is defined by a set of face-vertices using indices into the Mesh's + _points_ array (inherited from UsdGeomPointBased) and laid out in a + single linear _faceVertexIndices_ array for efficiency. A companion + _faceVertexCounts_ array provides, for each face, the number of + consecutive face-vertices in _faceVertexIndices_ that define the face. + No additional connectivity information is required or constructed, so + no adjacency or neighborhood queries are available. + + A key property of this mesh schema is that it encodes both subdivision + surfaces and simpler polygonal meshes. This is achieved by varying the + _subdivisionScheme_ attribute, which is set to specify Catmull-Clark + subdivision by default, so polygonal meshes must always be explicitly + declared. The available subdivision schemes and additional subdivision + features encoded in optional attributes conform to the feature set of + OpenSubdiv + (https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html). + + \\anchor UsdGeom_Mesh_Primvars + __A Note About Primvars__ + + The following list clarifies the number of elements for and the + interpolation behavior of the different primvar interpolation types + for meshes: + + - __constant__: One element for the entire mesh; no interpolation. + - __uniform__: One element for each face of the mesh; elements are + typically not interpolated but are inherited by other faces derived + from a given face (via subdivision, tessellation, etc.). + - __varying__: One element for each point of the mesh; + interpolation of point data is always linear. + - __vertex__: One element for each point of the mesh; + interpolation of point data is applied according to the + _subdivisionScheme_ attribute. + - __faceVarying__: One element for each of the face-vertices that + define the mesh topology; interpolation of face-vertex data may + be smooth or linear, according to the _subdivisionScheme_ and + _faceVaryingLinearInterpolation_ attributes. + + Primvar interpolation types and related utilities are described more + generally in \\ref Usd_InterpolationVals. + + \\anchor UsdGeom_Mesh_Normals + __A Note About Normals__ + + Normals should not be authored on a subdivision mesh, since subdivision + algorithms define their own normals. They should only be authored for + polygonal meshes (_subdivisionScheme_ = "none"). + + The _normals_ attribute inherited from UsdGeomPointBased is not a generic + primvar, but the number of elements in this attribute will be determined by + its _interpolation_. See \\ref UsdGeomPointBased::GetNormalsInterpolation() . + If _normals_ and _primvars:normals_ are both specified, the latter has + precedence. If a polygonal mesh specifies __neither__ _normals_ nor + _primvars:normals_, then it should be treated and rendered as faceted, + with no attempt to compute smooth normals. + + The normals generated for smooth subdivision schemes, e.g. Catmull-Clark + and Loop, will likewise be smooth, but others, e.g. Bilinear, may be + discontinuous between faces and/or within non-planar irregular faces.""" +) { + # + # Common Properties + # + int[] faceVertexIndices ( + doc = """Flat list of the index (into the _points_ attribute) of each + vertex of each face in the mesh. If this attribute has more than + one timeSample, the mesh is considered to be topologically varying.""" + ) + + int[] faceVertexCounts ( + doc = """Provides the number of vertices in each face of the mesh, + which is also the number of consecutive indices in _faceVertexIndices_ + that define the face. The length of this attribute is the number of + faces in the mesh. If this attribute has more than + one timeSample, the mesh is considered to be topologically varying.""" + ) + + # + # Subdiv Properties + # + + uniform token subdivisionScheme = "catmullClark" ( + allowedTokens = ["catmullClark", "loop", "bilinear", "none"] + doc = """The subdivision scheme to be applied to the surface. + Valid values are: + + - __catmullClark__: The default, Catmull-Clark subdivision; preferred + for quad-dominant meshes (generalizes B-splines); interpolation + of point data is smooth (non-linear) + - __loop__: Loop subdivision; preferred for purely triangular meshes; + interpolation of point data is smooth (non-linear) + - __bilinear__: Subdivision reduces all faces to quads (topologically + similar to "catmullClark"); interpolation of point data is bilinear + - __none__: No subdivision, i.e. a simple polygonal mesh; interpolation + of point data is linear + + Polygonal meshes are typically lighter weight and faster to render, + depending on renderer and render mode. Use of "bilinear" will produce + a similar shape to a polygonal mesh and may offer additional guarantees + of watertightness and additional subdivision features (e.g. holes) but + may also not respect authored normals.""") + + token interpolateBoundary = "edgeAndCorner" ( + allowedTokens = ["none", "edgeOnly", "edgeAndCorner"] + doc = """Specifies how subdivision is applied for faces adjacent to + boundary edges and boundary points. Valid values correspond to choices + available in OpenSubdiv: + + - __none__: No boundary interpolation is applied and boundary faces are + effectively treated as holes + - __edgeOnly__: A sequence of boundary edges defines a smooth curve to + which the edges of subdivided boundary faces converge + - __edgeAndCorner__: The default, similar to "edgeOnly" but the smooth + boundary curve is made sharp at corner points + + These are illustrated and described in more detail in the OpenSubdiv + documentation: + https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#boundary-interpolation-rules""") + + token faceVaryingLinearInterpolation = "cornersPlus1" ( + allowedTokens = ["none", "cornersOnly", "cornersPlus1", + "cornersPlus2", "boundaries", "all"] + doc = """Specifies how elements of a primvar of interpolation type + "faceVarying" are interpolated for subdivision surfaces. Interpolation + can be as smooth as a "vertex" primvar or constrained to be linear at + features specified by several options. Valid values correspond to + choices available in OpenSubdiv: + + - __none__: No linear constraints or sharpening, smooth everywhere + - __cornersOnly__: Sharpen corners of discontinuous boundaries only, + smooth everywhere else + - __cornersPlus1__: The default, same as "cornersOnly" plus additional + sharpening at points where three or more distinct face-varying + values occur + - __cornersPlus2__: Same as "cornersPlus1" plus additional sharpening + at points with at least one discontinuous boundary corner or + only one discontinuous boundary edge (a dart) + - __boundaries__: Piecewise linear along discontinuous boundaries, + smooth interior + - __all__: Piecewise linear everywhere + + These are illustrated and described in more detail in the OpenSubdiv + documentation: + https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#face-varying-interpolation-rules""") + + token triangleSubdivisionRule = "catmullClark" ( + allowedTokens = ["catmullClark", "smooth"] + doc = """Specifies an option to the subdivision rules for the + Catmull-Clark scheme to try and improve undesirable artifacts when + subdividing triangles. Valid values are "catmullClark" for the + standard rules (the default) and "smooth" for the improvement. + + See https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#triangle-subdivision-rule""") + + int[] holeIndices = [] ( + doc = """The indices of all faces that should be treated as holes, + i.e. made invisible. This is traditionally a feature of subdivision + surfaces and not generally applied to polygonal meshes.""") + + int[] cornerIndices = [] ( + doc = """The indices of points for which a corresponding sharpness + value is specified in _cornerSharpnesses_ (so the size of this array + must match that of _cornerSharpnesses_).""") + + float[] cornerSharpnesses = [] ( + doc = """The sharpness values associated with a corresponding set of + points specified in _cornerIndices_ (so the size of this array must + match that of _cornerIndices_). Use the constant `SHARPNESS_INFINITE` + for a perfectly sharp corner.""") + + int[] creaseIndices = [] ( + doc = """The indices of points grouped into sets of successive pairs + that identify edges to be creased. The size of this array must be + equal to the sum of all elements of the _creaseLengths_ attribute.""") + + int[] creaseLengths = [] ( + doc = """The length of this array specifies the number of creases + (sets of adjacent sharpened edges) on the mesh. Each element gives + the number of points of each crease, whose indices are successively + laid out in the _creaseIndices_ attribute. Since each crease must + be at least one edge long, each element of this array must be at + least two.""") + + float[] creaseSharpnesses = [] ( + doc = """The per-crease or per-edge sharpness values for all creases. + Since _creaseLengths_ encodes the number of points in each crease, + the number of elements in this array will be either len(creaseLengths) + or the sum over all X of (creaseLengths[X] - 1). Note that while + the RI spec allows each crease to have either a single sharpness + or a value per-edge, USD will encode either a single sharpness + per crease on a mesh, or sharpnesses for all edges making up + the creases on a mesh. Use the constant `SHARPNESS_INFINITE` for a + perfectly sharp crease.""") +} + +class TetMesh "TetMesh" ( + inherits = + customData = { + string extraIncludes = """ +#include "pxr/usd/usd/timeCode.h" """ + } + doc="""Encodes a tetrahedral mesh. A tetrahedral mesh is defined as a set of + tetrahedra. Each tetrahedron is defined by a set of 4 points, with the + triangles of the tetrahedron determined from these 4 points as described in + the tetVertexIndices attribute description. The mesh surface faces + are encoded as triangles. Surface faces must be provided for consumers + that need to do surface calculations, such as renderers or consumers using + physics attachments. Both tetrahedra and surface face definitions use + indices into the TetMesh's points attribute, inherited from + UsdGeomPointBased.""" +) { + # + # Common Properties + # + int4[] tetVertexIndices ( + doc = """Flat list of the index (into the points attribute) of + each vertex of each tetrahedron in the mesh. Each int4 corresponds to the + indices of a single tetrahedron. Users should set the orientation + attribute of UsdGeomPrim accordingly. That is if the orientation + is "rightHanded", the CCW face ordering of a tetrahedron is + [123],[032],[013],[021] with respect to the int4. This results in the + normals facing outward from the center of the tetrahedron. The following + diagram shows the face ordering of an unwrapped tetrahedron with + "rightHanded" orientation. + + \\image html USDTetMeshRightHanded.svg + + If the orientation attribute is set to "leftHanded" the face + ordering of the tetrahedron is [321],[230],[310],[120] and the + leftHanded CW face normals point outward from the center of the + tetrahedron. The following diagram shows the face ordering of an + unwrapped tetrahedron with "leftHanded" orientation. + + \\image html USDTetMeshLeftHanded.svg + + Setting the orientation attribute to align with the + ordering of the int4 for the tetrahedrons is the responsibility of the + user.""" + ) + + int3[] surfaceFaceVertexIndices ( + doc = """surfaceFaceVertexIndices defines the triangle + surface faces indices wrt. points of the tetmesh surface. Again + the orientation attribute inherited from UsdGeomPrim should be + set accordingly. The orientation for faces of tetrahedra and + surface faces must match.""" + ) +} + +class GeomSubset "GeomSubset" ( + inherits = + doc = """Encodes a subset of a piece of geometry (i.e. a UsdGeomImageable) + as a set of indices. Currently supports encoding subsets of faces, + points, edges, and tetrahedrons. + + To apply to a geometric prim, a GeomSubset prim must be the prim's direct + child in namespace, and possess a concrete defining specifier (i.e. def). + This restriction makes it easy and efficient to discover subsets of a prim. + We might want to relax this restriction if it's common to have multiple + families of subsets on a gprim and if it's useful to be able to + organize subsets belonging to a family under a common scope. See + 'familyName' attribute for more info on defining a family of subsets. + + Note that a GeomSubset isn't an imageable (i.e. doesn't derive from + UsdGeomImageable). So, you can't author visibility for it or + override its purpose. + + Materials are bound to GeomSubsets just as they are for regular + geometry using API available in UsdShade (UsdShadeMaterial::Bind). +""" + customData = { + string className = "Subset" + string extraIncludes = """ +#include "pxr/base/tf/token.h" +#include "pxr/usd/usdGeom/imageable.h" +#include "pxr/usd/usdGeom/mesh.h" +#include "pxr/usd/usdGeom/tetMesh.h" +""" + } +) +{ + uniform token elementType = "face" ( + allowedTokens = ["face", "point", "edge", "tetrahedron"] + doc = """The type of element that the indices target. "elementType" can + have one of the following values: +
  • face: Identifies faces on a Gprim's surface. For a + UsdGeomMesh, each element of the _indices_ attribute would refer to + an element of the Mesh's _faceCounts_ attribute. For a UsdGeomTetMesh, + each element of the _indices_ attribute would refer to an element of + the Mesh's _surfaceFaceVertexIndices_ attribute.
    • +
  • point: for any UsdGeomPointBased, each + element of the _indices_ attribute would refer to an element of the + Mesh's _points_ attribute
    • +
  • edge: for any UsdGeomMesh, each pair of elements + in the _indices_ attribute would refer to a pair of points of the + Mesh's _points_ attribute that are connected as an implicit edge on the + Mesh. These edges are derived from the Mesh's _faceVertexIndices_ + attribute. Edges are not currently defined for a UsdGeomTetMesh, but + could be derived from all tetrahedron edges or surface face edges only + if a specific use-case arises.
    • +
  • tetrahedron: for any UsdGeomTetMesh, each element of the + _indices_ attribute would refer to an element of the TetMesh's + _tetVertexIndices_ attribute. +
""" + ) + int[] indices = [] ( + doc = """The set of indices included in this subset. The indices need not + be sorted, but the same index should not appear more than once. Indices + are invalid if outside the range [0, elementCount) for the given time on + the parent geometric prim.""" + ) + uniform token familyName = "" ( + doc = """The name of the family of subsets that this subset belongs to. + This is optional and is primarily useful when there are multiple + families of subsets under a geometric prim. In some cases, this could + also be used for achieving proper roundtripping of subset data between + DCC apps. + When multiple subsets belonging to a prim have the same familyName, they + are said to belong to the family. A familyType value can be + encoded on the owner of a family of subsets as a token using the static + method UsdGeomSubset::SetFamilyType(). "familyType" can have one of the + following values: +
  • UsdGeomTokens->partition: implies that every element of + the whole geometry appears exactly once in only one of the subsets + belonging to the family.
    • +
  • UsdGeomTokens->nonOverlapping: an element that appears in one + subset may not appear in any other subset belonging to the family, and + appears only once in the subset in which it appears.
    • +
  • UsdGeomTokens->unrestricted: implies that there are no + restrictions w.r.t. the membership of elements in the subsets. They + could be overlapping and the union of all subsets in the family may + not represent the whole.
    • +
+ \\note The validity of subset data is not enforced by the authoring + APIs, however they can be checked using UsdGeomSubset::ValidateFamily(). + """ + ) +} + +class NurbsPatch "NurbsPatch" ( + inherits = + doc = """Encodes a rational or polynomial non-uniform B-spline + surface, with optional trim curves. + + The encoding mostly follows that of RiNuPatch and RiTrimCurve: + https://renderman.pixar.com/resources/RenderMan_20/geometricPrimitives.html#rinupatch , with some minor renaming and coalescing for clarity. + + The layout of control vertices in the \\em points attribute inherited + from UsdGeomPointBased is row-major with U considered rows, and V columns. + + \\anchor UsdGeom_NurbsPatch_Form + NurbsPatch Form + + The authored points, orders, knots, weights, and ranges are all that is + required to render the nurbs patch. However, the only way to model closed + surfaces with nurbs is to ensure that the first and last control points + along the given axis are coincident. Similarly, to ensure the surface is + not only closed but also C2 continuous, the last \\em order - 1 control + points must be (correspondingly) coincident with the first \\em order - 1 + control points, and also the spacing of the last corresponding knots + must be the same as the first corresponding knots. + + Form is provided as an aid to interchange between modeling and + animation applications so that they can robustly identify the intent with + which the surface was modelled, and take measures (if they are able) to + preserve the continuity/concidence constraints as the surface may be rigged + or deformed. + \\li An \\em open-form NurbsPatch has no continuity constraints. + \\li A \\em closed-form NurbsPatch expects the first and last control points + to overlap + \\li A \\em periodic-form NurbsPatch expects the first and last + \\em order - 1 control points to overlap. + + Nurbs vs Subdivision Surfaces + + Nurbs are an important modeling primitive in CAD/CAM tools and early + computer graphics DCC's. Because they have a natural UV parameterization + they easily support "trim curves", which allow smooth shapes to be + carved out of the surface. + + However, the topology of the patch is always rectangular, and joining two + nurbs patches together (especially when they have differing numbers of + spans) is difficult to do smoothly. Also, nurbs are not supported by + the Ptex texturing technology (http://ptex.us). + + Neither of these limitations are shared by subdivision surfaces; therefore, + although they do not subscribe to trim-curve-based shaping, subdivs are + often considered a more flexible modeling primitive. + """ +) { + int uVertexCount ( + doc = """Number of vertices in the U direction. Should be at least as + large as uOrder.""" + ) + + int vVertexCount ( + doc = """Number of vertices in the V direction. Should be at least as + large as vOrder.""" + ) + + int uOrder ( + doc = """Order in the U direction. Order must be positive and is + equal to the degree of the polynomial basis to be evaluated, plus 1.""" + ) + + int vOrder ( + doc = """Order in the V direction. Order must be positive and is + equal to the degree of the polynomial basis to be evaluated, plus 1.""" + ) + + double[] uKnots ( + doc = """Knot vector for U direction providing U parameterization. + The length of this array must be ( uVertexCount + uOrder ), and its + entries must take on monotonically increasing values.""" + ) + + double[] vKnots ( + doc = """Knot vector for V direction providing U parameterization. + The length of this array must be ( vVertexCount + vOrder ), and its + entries must take on monotonically increasing values.""" + ) + + uniform token uForm = "open" ( + allowedTokens = ["open", "closed", "periodic"] + doc = """Interpret the control grid and knot vectors as representing + an open, geometrically closed, or geometrically closed and C2 continuous + surface along the U dimension. + \\sa \\ref UsdGeom_NurbsPatch_Form "NurbsPatch Form" """ + ) + + uniform token vForm = "open" ( + allowedTokens = ["open", "closed", "periodic"] + doc = """Interpret the control grid and knot vectors as representing + an open, geometrically closed, or geometrically closed and C2 continuous + surface along the V dimension. + \\sa \\ref UsdGeom_NurbsPatch_Form "NurbsPatch Form" """ + ) + + # Alembic's NuPatch does not encode these... wonder how they + # get away with that? Just assume it's the full range, presumably. + double2 uRange ( + doc = """Provides the minimum and maximum parametric values (as defined + by uKnots) over which the surface is actually defined. The minimum + must be less than the maximum, and greater than or equal to the + value of uKnots[uOrder-1]. The maxium must be less than or equal + to the last element's value in uKnots.""" + ) + + double2 vRange ( + doc = """Provides the minimum and maximum parametric values (as defined + by vKnots) over which the surface is actually defined. The minimum + must be less than the maximum, and greater than or equal to the + value of vKnots[vOrder-1]. The maxium must be less than or equal + to the last element's value in vKnots.""" + ) + + double[] pointWeights ( + doc = """Optionally provides "w" components for each control point, + thus must be the same length as the points attribute. If authored, + the patch will be rational. If unauthored, the patch will be + polynomial, i.e. weight for all points is 1.0. + \\note Some DCC's pre-weight the \\em points, but in this schema, + \\em points are not pre-weighted.""" + ) + + int[] trimCurve:counts ( + doc = """Each element specifies how many curves are present in each + "loop" of the trimCurve, and the length of the array determines how + many loops the trimCurve contains. The sum of all elements is the + total nuber of curves in the trim, to which we will refer as + \\em nCurves in describing the other trim attributes.""" + ) + + int[] trimCurve:orders ( + doc = """Flat list of orders for each of the \\em nCurves curves.""" + ) + + int[] trimCurve:vertexCounts ( + doc = """Flat list of number of vertices for each of the + \\em nCurves curves.""" + ) + + double[] trimCurve:knots ( + doc = """Flat list of parametric values for each of the + \\em nCurves curves. There will be as many knots as the sum over + all elements of \\em vertexCounts plus the sum over all elements of + \\em orders.""" + ) + + double2[] trimCurve:ranges ( + doc = """Flat list of minimum and maximum parametric values + (as defined by \\em knots) for each of the \\em nCurves curves.""" + ) + + double3[] trimCurve:points ( + doc = """Flat list of homogeneous 2D points (u, v, w) that comprise + the \\em nCurves curves. The number of points should be equal to the + um over all elements of \\em vertexCounts.""" + ) + +} + +class "Curves" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } + inherits = + doc = """Base class for UsdGeomBasisCurves, UsdGeomNurbsCurves, and + UsdGeomHermiteCurves. The BasisCurves schema is designed to be + analagous to offline renderers' notion of batched curves (such as + the classical RIB definition via Basis and Curves statements), + while the NurbsCurve schema is designed to be analgous to the + NURBS curves found in packages like Maya and Houdini while + retaining their consistency with the RenderMan specification for + NURBS Patches. HermiteCurves are useful for the + interchange of animation guides and paths. + + It is safe to use the length of the curve vertex count to derive + the number of curves and the number and layout of curve vertices, + but this schema should NOT be used to derive the number of curve + points. While vertex indices are implicit in all shipped + descendent types of this schema, one should not assume that all + internal or future shipped schemas will follow this pattern. Be + sure to key any indexing behavior off the concrete type, not this + abstract type. + """ +) { + # topology attributes + int[] curveVertexCounts ( + doc = """Curves-derived primitives can represent multiple distinct, + potentially disconnected curves. The length of 'curveVertexCounts' + gives the number of such curves, and each element describes the + number of vertices in the corresponding curve""" + ) + + # shaping attributes + float[] widths ( + doc = """Provides width specification for the curves, whose application + will depend on whether the curve is oriented (normals are defined for + it), in which case widths are "ribbon width", or unoriented, in which + case widths are cylinder width. 'widths' is not a generic Primvar, + but the number of elements in this attribute will be determined by + its 'interpolation'. See \\ref SetWidthsInterpolation() . If 'widths' + and 'primvars:widths' are both specified, the latter has precedence.""" + ) +} + +class BasisCurves "BasisCurves" ( + inherits = + doc = """BasisCurves are a batched curve representation analogous to the + classic RIB definition via Basis and Curves statements. BasisCurves are + often used to render dense aggregate geometry like hair or grass. + + A 'matrix' and 'vstep' associated with the \\em basis are used to + interpolate the vertices of a cubic BasisCurves. (The basis attribute + is unused for linear BasisCurves.) + + A single prim may have many curves whose count is determined implicitly by + the length of the \\em curveVertexCounts vector. Each individual curve is + composed of one or more segments. Each segment is defined by four vertices + for cubic curves and two vertices for linear curves. See the next section + for more information on how to map curve vertex counts to segment counts. + + \\section UsdGeomBasisCurves_Segment Segment Indexing + Interpolating a curve requires knowing how to decompose it into its + individual segments. + + The segments of a cubic curve are determined by the vertex count, + the \\em wrap (periodicity), and the vstep of the basis. For linear + curves, the basis token is ignored and only the vertex count and + wrap are needed. + + cubic basis | vstep + ------------- | ------ + bezier | 3 + catmullRom | 1 + bspline | 1 + + The first segment of a cubic (nonperiodic) curve is always defined by its + first four points. The vstep is the increment used to determine what + vertex indices define the next segment. For a two segment (nonperiodic) + bspline basis curve (vstep = 1), the first segment will be defined by + interpolating vertices [0, 1, 2, 3] and the second segment will be defined + by [1, 2, 3, 4]. For a two segment bezier basis curve (vstep = 3), the + first segment will be defined by interpolating vertices [0, 1, 2, 3] and + the second segment will be defined by [3, 4, 5, 6]. If the vstep is not + one, then you must take special care to make sure that the number of cvs + properly divides by your vstep. (The indices described are relative to + the initial vertex index for a batched curve.) + + For periodic curves, at least one of the curve's initial vertices are + repeated to close the curve. For cubic curves, the number of vertices + repeated is '4 - vstep'. For linear curves, only one vertex is repeated + to close the loop. + + Pinned curves are a special case of nonperiodic curves that only affects + the behavior of cubic Bspline and Catmull-Rom curves. To evaluate or render + pinned curves, a client must effectively add 'phantom points' at the + beginning and end of every curve in a batch. These phantom points + are injected to ensure that the interpolated curve begins at P[0] and + ends at P[n-1]. + + For a curve with initial point P[0] and last point P[n-1], the phantom + points are defined as. + P[-1] = 2 * P[0] - P[1] + P[n] = 2 * P[n-1] - P[n-2] + + Pinned cubic curves will (usually) have to be unpacked into the standard + nonperiodic representation before rendering. This unpacking can add some + additional overhead. However, using pinned curves reduces the amount of + data recorded in a scene and (more importantly) better records the + authors' intent for interchange. + + \\note The additional phantom points mean that the minimum curve vertex + count for cubic bspline and catmullRom curves is 2. + + Linear curve segments are defined by two vertices. + A two segment linear curve's first segment would be defined by + interpolating vertices [0, 1]. The second segment would be defined by + vertices [1, 2]. (Again, for a batched curve, indices are relative to + the initial vertex index.) + + When validating curve topology, each renderable entry in the + curveVertexCounts vector must pass this check. + + type | wrap | validitity + ------- | --------------------------- | ---------------- + linear | nonperiodic | curveVertexCounts[i] > 2 + linear | periodic | curveVertexCounts[i] > 3 + cubic | nonperiodic | (curveVertexCounts[i] - 4) % vstep == 0 + cubic | periodic | (curveVertexCounts[i]) % vstep == 0 + cubic | pinned (catmullRom/bspline) | (curveVertexCounts[i] - 2) >= 0 + + \\section UsdGeomBasisCurves_BasisMatrix Cubic Vertex Interpolation + + \\image html USDCurveBasisMatrix.png width=750 + + \\section UsdGeomBasisCurves_Linear Linear Vertex Interpolation + + Linear interpolation is always used on curves of type linear. + 't' with domain [0, 1], the curve is defined by the equation + P0 * (1-t) + P1 * t. t at 0 describes the first point and t at 1 describes + the end point. + + \\section UsdGeomBasisCurves_PrimvarInterpolation Primvar Interpolation + + For cubic curves, primvar data can be either interpolated cubically between + vertices or linearly across segments. The corresponding token + for cubic interpolation is 'vertex' and for linear interpolation is + 'varying'. Per vertex data should be the same size as the number + of vertices in your curve. Segment varying data is dependent on the + wrap (periodicity) and number of segments in your curve. For linear curves, + varying and vertex data would be interpolated the same way. By convention + varying is the preferred interpolation because of the association of + varying with linear interpolation. + + \\image html USDCurvePrimvars.png + + To convert an entry in the curveVertexCounts vector into a segment count + for an individual curve, apply these rules. Sum up all the results in + order to compute how many total segments all curves have. + + The following tables describe the expected segment count for the 'i'th + curve in a curve batch as well as the entire batch. Python syntax + like '[:]' (to describe all members of an array) and 'len(...)' + (to describe the length of an array) are used. + + type | wrap | curve segment count | batch segment count + ------- | --------------------------- | -------------------------------------- | -------------------------- + linear | nonperiodic | curveVertexCounts[i] - 1 | sum(curveVertexCounts[:]) - len(curveVertexCounts) + linear | periodic | curveVertexCounts[i] | sum(curveVertexCounts[:]) + cubic | nonperiodic | (curveVertexCounts[i] - 4) / vstep + 1 | sum(curveVertexCounts[:] - 4) / vstep + len(curveVertexCounts) + cubic | periodic | curveVertexCounts[i] / vstep | sum(curveVertexCounts[:]) / vstep + cubic | pinned (catmullRom/bspline) | (curveVertexCounts[i] - 2) + 1 | sum(curveVertexCounts[:] - 2) + len(curveVertexCounts) + + The following table descrives the expected size of varying + (linearly interpolated) data, derived from the segment counts computed + above. + + wrap | curve varying count | batch varying count + ------------------- | ---------------------------- | ------------------------------------------------ + nonperiodic/pinned | segmentCounts[i] + 1 | sum(segmentCounts[:]) + len(curveVertexCounts) + periodic | segmentCounts[i] | sum(segmentCounts[:]) + + Both curve types additionally define 'constant' interpolation for the + entire prim and 'uniform' interpolation as per curve data. + + + \\note Take care when providing support for linearly interpolated data for + cubic curves. Its shape doesn't provide a one to one mapping with either + the number of curves (like 'uniform') or the number of vertices (like + 'vertex') and so it is often overlooked. This is the only primitive in + UsdGeom (as of this writing) where this is true. For meshes, while they + use different interpolation methods, 'varying' and 'vertex' are both + specified per point. It's common to assume that curves follow a similar + pattern and build in structures and language for per primitive, per + element, and per point data only to come upon these arrays that don't + quite fit into either of those categories. It is + also common to conflate 'varying' with being per segment data and use the + segmentCount rules table instead of its neighboring varying data table + rules. We suspect that this is because for the common case of + nonperiodic cubic curves, both the provided segment count and varying data + size formula end with '+ 1'. While debugging, users may look at the double + '+ 1' as a mistake and try to remove it. We take this time to enumerate + these issues because we've fallen into them before and hope that we save + others time in their own implementations. + + As an example of deriving per curve segment and varying primvar data counts from + the wrap, type, basis, and curveVertexCount, the following table is provided. + + wrap | type | basis | curveVertexCount | curveSegmentCount | varyingDataCount + ------------- | ------- | ------- | ----------------- | ------------------ | ------------------------- + nonperiodic | linear | N/A | [2 3 2 5] | [1 2 1 4] | [2 3 2 5] + nonperiodic | cubic | bezier | [4 7 10 4 7] | [1 2 3 1 2] | [2 3 4 2 3] + nonperiodic | cubic | bspline | [5 4 6 7] | [2 1 3 4] | [3 2 4 5] + periodic | cubic | bezier | [6 9 6] | [2 3 2] | [2 3 2] + periodic | linear | N/A | [3 7] | [3 7] | [3 7] + + \\section UsdGeomBasisCurves_TubesAndRibbons Tubes and Ribbons + + The strictest definition of a curve as an infinitely thin wire is not + particularly useful for describing production scenes. The additional + \\em widths and \\em normals attributes can be used to describe cylindrical + tubes and or flat oriented ribbons. + + Curves with only widths defined are imaged as tubes with radius + 'width / 2'. Curves with both widths and normals are imaged as ribbons + oriented in the direction of the interpolated normal vectors. + + While not technically UsdGeomPrimvars, widths and normals + also have interpolation metadata. It's common for authored widths to have + constant, varying, or vertex interpolation + (see UsdGeomCurves::GetWidthsInterpolation()). It's common for + authored normals to have varying interpolation + (see UsdGeomPointBased::GetNormalsInterpolation()). + + \\image html USDCurveHydra.png + + The file used to generate these curves can be found in + extras/usd/examples/usdGeomExamples/basisCurves.usda. It's provided + as a reference on how to properly image both tubes and ribbons. The first + row of curves are linear; the second are cubic bezier. (We aim in future + releases of HdSt to fix the discontinuity seen with broken tangents to + better match offline renderers like RenderMan.) The yellow and violet + cubic curves represent cubic vertex width interpolation for which there is + no equivalent for linear curves. + + \\note How did this prim type get its name? This prim is a portmanteau of + two different statements in the original RenderMan specification: + 'Basis' and 'Curves'. +""" +) { + # interpolation attributes + uniform token type = "cubic" ( + allowedTokens = ["linear", "cubic"] + doc = """Linear curves interpolate linearly between two vertices. + Cubic curves use a basis matrix with four vertices to interpolate a segment.""") + + uniform token basis = "bezier" ( + allowedTokens = ["bezier", "bspline", "catmullRom"] + doc = """The basis specifies the vstep and matrix used for cubic + interpolation. \\note The 'hermite' and 'power' tokens have been + removed. We've provided UsdGeomHermiteCurves + as an alternative for the 'hermite' basis.""") + + uniform token wrap = "nonperiodic" ( + allowedTokens = ["nonperiodic", "periodic", "pinned"] + doc = """If wrap is set to periodic, the curve when rendered will + repeat the initial vertices (dependent on the vstep) to close the + curve. If wrap is set to 'pinned', phantom points may be created + to ensure that the curve interpolation starts at P[0] and ends at P[n-1]. + """) +} + +class NurbsCurves "NurbsCurves" ( + inherits = + doc = """This schema is analagous to NURBS Curves in packages like Maya + and Houdini, often used for interchange of rigging and modeling curves. + Unlike Maya, this curve spec supports batching of multiple curves into a + single prim, widths, and normals in the schema. Additionally, we require + 'numSegments + 2 * degree + 1' knots (2 more than maya does). This is to + be more consistent with RenderMan's NURBS patch specification. + + To express a periodic curve: + - knot[0] = knot[1] - (knots[-2] - knots[-3]; + - knot[-1] = knot[-2] + (knot[2] - knots[1]); + + To express a nonperiodic curve: + - knot[0] = knot[1]; + - knot[-1] = knot[-2]; + + In spite of these slight differences in the spec, curves generated in Maya + should be preserved when roundtripping. + + \\em order and \\em range, when representing a batched NurbsCurve should be + authored one value per curve. \\em knots should be the concatentation of + all batched curves.""" +) { + # topology attributes + int[] order = [] ( + doc = """Order of the curve. Order must be positive and is + equal to the degree of the polynomial basis to be evaluated, plus 1. + Its value for the 'i'th curve must be less than or equal to + curveVertexCount[i]""") + + # interpolation attributes + double[] knots ( + doc = """Knot vector providing curve parameterization. + The length of the slice of the array for the ith curve + must be ( curveVertexCount[i] + order[i] ), and its + entries must take on monotonically increasing values.""") + + double2[] ranges ( + doc = """Provides the minimum and maximum parametric values (as defined + by knots) over which the curve is actually defined. The minimum must + be less than the maximum, and greater than or equal to the value of the + knots['i'th curve slice][order[i]-1]. The maxium must be less + than or equal to the last element's value in knots['i'th curve slice]. + Range maps to (vmin, vmax) in the RenderMan spec.""") + + double[] pointWeights ( + doc = """Optionally provides "w" components for each control point, + thus must be the same length as the points attribute. If authored, + the curve will be rational. If unauthored, the curve will be + polynomial, i.e. weight for all points is 1.0. + \\note Some DCC's pre-weight the \\em points, but in this schema, + \\em points are not pre-weighted.""" + ) +} + +class Points "Points" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } + inherits = + doc = """Points are analogous to the RiPoints spec. + + Points can be an efficient means of storing and rendering particle + effects comprised of thousands or millions of small particles. Points + generally receive a single shading sample each, which should take + \\em normals into account, if present. + + While not technically UsdGeomPrimvars, the widths and normals also + have interpolation metadata. It's common for authored widths and normals + to have constant or varying interpolation.""" + +) { + # shaping attributes + float[] widths ( + doc = """Widths are defined as the \\em diameter of the points, in + object space. 'widths' is not a generic Primvar, but + the number of elements in this attribute will be determined by + its 'interpolation'. See \\ref SetWidthsInterpolation() . If + 'widths' and 'primvars:widths' are both specified, the latter + has precedence.""" + ) + + int64[] ids ( + doc = """Ids are optional; if authored, the ids array should be the same + length as the points array, specifying (at each timesample if + point identities are changing) the id of each point. The + type is signed intentionally, so that clients can encode some + binary state on Id'd points without adding a separate + primvar.""" + ) +} + +class PointInstancer "PointInstancer" ( + doc = """Encodes vectorized instancing of multiple, potentially + animated, prototypes (object/instance masters), which can be arbitrary + prims/subtrees on a UsdStage. + + PointInstancer is a "multi instancer", as it allows multiple prototypes + to be scattered among its "points". We use a UsdRelationship + \\em prototypes to identify and order all of the possible prototypes, by + targeting the root prim of each prototype. The ordering imparted by + relationships associates a zero-based integer with each prototype, and + it is these integers we use to identify the prototype of each instance, + compactly, and allowing prototypes to be swapped out without needing to + reauthor all of the per-instance data. + + The PointInstancer schema is designed to scale to billions of instances, + which motivates the choice to split the per-instance transformation into + position, (quaternion) orientation, and scales, rather than a + 4x4 matrix per-instance. In addition to requiring fewer bytes even if + all elements are authored (32 bytes vs 64 for a single-precision 4x4 + matrix), we can also be selective about which attributes need to animate + over time, for substantial data reduction in many cases. + + Note that PointInstancer is \\em not a Gprim, since it is not a graphical + primitive by any stretch of the imagination. It \\em is, however, + Boundable, since we will sometimes want to treat the entire PointInstancer + similarly to a procedural, from the perspective of inclusion or framing. + + \\section UsdGeomPointInstancer_varyingTopo Varying Instance Identity over Time + + PointInstancers originating from simulations often have the characteristic + that points/instances are "born", move around for some time period, and then + die (or leave the area of interest). In such cases, billions of instances + may be birthed over time, while at any \\em specific time, only a much + smaller number are actually alive. To encode this situation efficiently, + the simulator may re-use indices in the instance arrays, when a particle + dies, its index will be taken over by a new particle that may be birthed in + a much different location. This presents challenges both for + identity-tracking, and for motion-blur. + + We facilitate identity tracking by providing an optional, animatable + \\em ids attribute, that specifies the 64 bit integer ID of the particle + at each index, at each point in time. If the simulator keeps monotonically + increasing a particle-count each time a new particle is birthed, it will + serve perfectly as particle \\em ids. + + We facilitate motion blur for varying-topology particle streams by + optionally allowing per-instance \\em velocities and \\em angularVelocities + to be authored. If instance transforms are requested at a time between + samples and either of the velocity attributes is authored, then we will + not attempt to interpolate samples of \\em positions or \\em orientations. + If not authored, and the bracketing samples have the same length, then we + will interpolate. + + \\section UsdGeomPointInstancer_transform Computing an Instance Transform + + Each instance's transformation is a combination of the SRT affine transform + described by its scale, orientation, and position, applied \\em after + (i.e. less locally than) the local to parent transformation computed at + the root of the prototype it is instancing. + + If your processing of prototype geometry naturally takes into account the + transform of the prototype root, then this term can be omitted from the + computation of each instance transform, and this can be controlled when + computing instance transformation matrices using the + UsdGeomPointInstancer::PrototypeXformInclusion enumeration. + + To understand the computation of the instance transform, in order to put + an instance of a PointInstancer into the space of the PointInstancer's + parent prim we do the following: + + 1. Apply (most locally) the authored local to parent transformation for + prototypes[protoIndices[i]] + 2. If *scales* is authored, next apply the scaling matrix from *scales[i]* + 3. If *orientations* is authored: **if *angularVelocities* is authored**, + first multiply *orientations[i]* by the unit quaternion derived by scaling + *angularVelocities[i]* by the \\ref UsdGeom_PITimeScaling "time differential" + from the left-bracketing timeSample for *orientation* to the requested + evaluation time *t*, storing the result in *R*, **else** assign *R* + directly from *orientations[i]*. Apply the rotation matrix derived + from *R*. + 4. Apply the translation derived from *positions[i]*. If *velocities* is + authored, apply the translation deriving from *velocities[i]* scaled by + the time differential from the left-bracketing timeSample for *positions* + to the requested evaluation time *t*. + 5. Least locally, apply the transformation authored on the PointInstancer + prim itself (or the UsdGeomImageable::ComputeLocalToWorldTransform() of the + PointInstancer to put the instance directly into world space) + + If neither *velocities* nor *angularVelocities* are authored, we fallback to + standard position and orientation computation logic (using linear + interpolation between timeSamples) as described by + \\ref UsdGeom_VelocityInterpolation . + + \\anchor UsdGeom_PITimeScaling + Scaling Velocities for Interpolation + + When computing time-differentials by which to apply velocity or + angularVelocity to positions or orientations, we must scale by + ( 1.0 / UsdStage::GetTimeCodesPerSecond() ), because velocities are recorded + in units/second, while we are interpolating in UsdTimeCode ordinates. + + We provide both high and low-level API's for dealing with the + transformation as a matrix, both will compute the instance matrices using + multiple threads; the low-level API allows the client to cache unvarying + inputs so that they need not be read duplicately when computing over + time. + + See also \\ref UsdGeom_VelocityInterpolation . + + \\section UsdGeomPointInstancer_primvars Primvars on PointInstancer + + \\ref UsdGeomPrimvar "Primvars" authored on a PointInstancer prim should + always be applied to each instance with \\em constant interpolation at + the root of the instance. When you are authoring primvars on a + PointInstancer, think about it as if you were authoring them on a + point-cloud (e.g. a UsdGeomPoints gprim). The same + interpolation rules for points apply here, substituting + "instance" for "point". + + In other words, the (constant) value extracted for each instance + from the authored primvar value depends on the authored \\em interpolation + and \\em elementSize of the primvar, as follows: + \\li constant or uniform : the entire authored value of the + primvar should be applied exactly to each instance. + \\li varying, vertex, or faceVarying: the first + \\em elementSize elements of the authored primvar array should be assigned to + instance zero, the second \\em elementSize elements should be assigned to + instance one, and so forth. + + + \\section UsdGeomPointInstancer_masking Masking Instances: "Deactivating" and Invising + + Often a PointInstancer is created "upstream" in a graphics pipeline, and + the needs of "downstream" clients necessitate eliminating some of the + instances from further consideration. Accomplishing this pruning by + re-authoring all of the per-instance attributes is not very attractive, + since it may mean destructively editing a large quantity of data. We + therefore provide means of "masking" instances by ID, such that the + instance data is unmolested, but per-instance transform and primvar data + can be retrieved with the no-longer-desired instances eliminated from the + (smaller) arrays. PointInstancer allows two independent means of masking + instances by ID, each with different features that meet the needs of + various clients in a pipeline. Both pruning features' lists of ID's are + combined to produce the mask returned by ComputeMaskAtTime(). + + \\note If a PointInstancer has no authored \\em ids attribute, the masking + features will still be available, with the integers specifying element + position in the \\em protoIndices array rather than ID. + + \\subsection UsdGeomPointInstancer_inactiveIds InactiveIds: List-edited, Unvarying Masking + + The first masking feature encodes a list of IDs in a list-editable metadatum + called \\em inactiveIds, which, although it does not have any similar + impact to stage population as \\ref UsdPrim::SetActive() "prim activation", + it shares with that feature that its application is uniform over all time. + Because it is list-editable, we can \\em sparsely add and remove instances + from it in many layers. + + This sparse application pattern makes \\em inactiveIds a good choice when + further downstream clients may need to reverse masking decisions made + upstream, in a manner that is robust to many kinds of future changes to + the upstream data. + + See ActivateId(), ActivateIds(), DeactivateId(), DeactivateIds(), + ActivateAllIds() + + \\subsection UsdGeomPointInstancer_invisibleIds invisibleIds: Animatable Masking + + The second masking feature encodes a list of IDs in a time-varying + Int64Array-valued UsdAttribute called \\em invisibleIds , since it shares + with \\ref UsdGeomImageable::GetVisibilityAttr() "Imageable visibility" + the ability to animate object visibility. + + Unlike \\em inactiveIds, overriding a set of opinions for \\em invisibleIds + is not at all straightforward, because one will, in general need to + reauthor (in the overriding layer) **all** timeSamples for the attribute + just to change one Id's visibility state, so it cannot be authored + sparsely. But it can be a very useful tool for situations like encoding + pre-computed camera-frustum culling of geometry when either or both of + the instances or the camera is animated. + + See VisId(), VisIds(), InvisId(), InvisIds(), VisAllIds() + + \\section UsdGeomPointInstancer_protoProcessing Processing and Not Processing Prototypes + + Any prim in the scenegraph can be targeted as a prototype by the + \\em prototypes relationship. We do not, however, provide a specific + mechanism for identifying prototypes as geometry that should not be drawn + (or processed) in their own, local spaces in the scenegraph. We + encourage organizing all prototypes as children of the PointInstancer + prim that consumes them, and pruning "raw" processing and drawing + traversals when they encounter a PointInstancer prim; this is what the + UsdGeomBBoxCache and UsdImaging engines do. + + There \\em is a pattern one can deploy for organizing the prototypes + such that they will automatically be skipped by basic UsdPrim::GetChildren() + or UsdPrimRange traversals. Usd prims each have a + \\ref Usd_PrimSpecifiers "specifier" of "def", "over", or "class". The + default traversals skip over prims that are "pure overs" or classes. So + to protect prototypes from all generic traversals and processing, place + them under a prim that is just an "over". For example, + \\code + 01 def PointInstancer "Crowd_Mid" + 02 { + 03 rel prototypes = [ , ] + 04 + 05 over "Prototypes" + 06 { + 07 def "MaleThin_Business" ( + 08 references = [@MaleGroupA/usd/MaleGroupA.usd@] + 09 variants = { + 10 string modelingVariant = "Thin" + 11 string costumeVariant = "BusinessAttire" + 12 } + 13 ) + 14 { ... } + 15 + 16 def "MaleThin_Casual" + 17 ... + 18 } + 19 } + \\endcode + """ + + inherits = + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + dictionary schemaTokens = { + dictionary inactiveIds = { + string doc = """int64listop prim metadata that specifies + the PointInstancer ids that should be masked (unrenderable) + over all time.""" + } + } + } +) { + rel prototypes ( + doc = """Required property. Orders and targets the prototype root + prims, which can be located anywhere in the scenegraph that is convenient, + although we promote organizing prototypes as children of the + PointInstancer. The position of a prototype in this relationship defines + the value an instance would specify in the \\em protoIndices attribute to + instance that prototype. Since relationships are uniform, this property + cannot be animated.""" + ) + + int[] protoIndices ( + doc = """Required property. Per-instance index into + \\em prototypes relationship that identifies what geometry should be + drawn for each instance. Topology attribute - can be animated, + but at a potential performance impact for streaming.""" + ) + + int64[] ids ( + doc = """Ids are optional; if authored, the ids array should be the same + length as the \\em protoIndices array, specifying (at each timeSample if + instance identities are changing) the id of each instance. The + type is signed intentionally, so that clients can encode some + binary state on Id'd instances without adding a separate primvar. + See also \\ref UsdGeomPointInstancer_varyingTopo""" + ) + + point3f[] positions ( + doc = """Required property. Per-instance position. See also + \\ref UsdGeomPointInstancer_transform .""" + ) + + quath[] orientations ( + doc="""If authored, per-instance orientation of each instance about its + prototype's origin, represented as a unit length quaternion, which + allows us to encode it with sufficient precision in a compact GfQuath. + + It is client's responsibility to ensure that authored quaternions are + unit length; the convenience API below for authoring orientations from + rotation matrices will ensure that quaternions are unit length, though + it will not make any attempt to select the "better (for interpolation + with respect to neighboring samples)" of the two possible quaternions + that encode the rotation. + + See also \\ref UsdGeomPointInstancer_transform .""" ) + + quatf[] orientationsf ( + doc="""If authored, per-instance orientation of each instance about its + prototype's origin, represented as a unit length quaternion, encoded + as a GfQuatf to support higher precision computations. + + It is client's responsibility to ensure that authored quaternions are + unit length; the convenience API below for authoring orientations from + rotation matrices will ensure that quaternions are unit length, though + it will not make any attempt to select the "better (for interpolation + with respect to neighboring samples)" of the two possible quaternions + that encode the rotation. Note that if the earliest time sample (or + default value if there are no time samples) of orientationsf is not empty + orientationsf will be preferred over orientations if both are authored. + + See also \\ref UsdGeomPointInstancer_transform .""" ) + + float3[] scales ( + doc="""If authored, per-instance scale to be applied to + each instance, before any rotation is applied. + + See also \\ref UsdGeomPointInstancer_transform .""" + ) + + vector3f[] velocities ( + doc = """If provided, per-instance 'velocities' will be used to + compute positions between samples for the 'positions' attribute, + rather than interpolating between neighboring 'positions' samples. + Velocities should be considered mandatory if both \\em protoIndices + and \\em positions are animated. Velocity is measured in position + units per second, as per most simulation software. To convert to + position units per UsdTimeCode, divide by + UsdStage::GetTimeCodesPerSecond(). + + See also \\ref UsdGeomPointInstancer_transform, + \\ref UsdGeom_VelocityInterpolation .""" + ) + + vector3f[] accelerations ( + doc = """If authored, per-instance 'accelerations' will be used with + velocities to compute positions between samples for the 'positions' + attribute rather than interpolating between neighboring 'positions' + samples. Acceleration is measured in position units per second-squared. + To convert to position units per squared UsdTimeCode, divide by the + square of UsdStage::GetTimeCodesPerSecond().""" + ) + + vector3f[] angularVelocities ( + doc="""If authored, per-instance angular velocity vector to be used for + interoplating orientations. Angular velocities should be considered + mandatory if both \\em protoIndices and \\em orientations are animated. + Angular velocity is measured in degrees per second. To convert + to degrees per UsdTimeCode, divide by + UsdStage::GetTimeCodesPerSecond(). + + See also \\ref UsdGeomPointInstancer_transform .""" + ) + + int64[] invisibleIds = [] ( + doc="""A list of id's to make invisible at the evaluation time. + See \\ref UsdGeomPointInstancer_invisibleIds .""" + ) +} + + +class Camera "Camera" ( + doc = """Transformable camera. + + Describes optical properties of a camera via a common set of attributes + that provide control over the camera's frustum as well as its depth of + field. For stereo, the left and right camera are individual prims tagged + through the \\ref UsdGeomCamera::GetStereoRoleAttr() "stereoRole attribute". + + There is a corresponding class GfCamera, which can hold the state of a + camera (at a particular time). \\ref UsdGeomCamera::GetCamera() and + \\ref UsdGeomCamera::SetFromCamera() convert between a USD camera prim and + a GfCamera. + + To obtain the camera's location in world space, call the following on a + UsdGeomCamera 'camera': + \\code + GfMatrix4d camXform = camera.ComputeLocalToWorldTransform(time); + \\endcode + \\note + Cameras in USD are always "Y up", regardless of the stage's orientation + (i.e. UsdGeomGetStageUpAxis()). This means that the inverse of + 'camXform' (the VIEW half of the MODELVIEW transform in OpenGL parlance) + will transform the world such that the camera is at the origin, looking + down the -Z axis, with +Y as the up axis, and +X pointing to the right. + This describes a __right handed coordinate system__. + + \\section UsdGeom_CameraUnits Units of Measure for Camera Properties + + Despite the familiarity of millimeters for specifying some physical + camera properties, UsdGeomCamera opts for greater consistency with all + other UsdGeom schemas, which measure geometric properties in scene units, + as determined by UsdGeomGetStageMetersPerUnit(). We do make a + concession, however, in that lens and filmback properties are measured in + __tenths of a scene unit__ rather than "raw" scene units. This means + that with the fallback value of .01 for _metersPerUnit_ - i.e. scene unit + of centimeters - then these "tenth of scene unit" properties are + effectively millimeters. + + \\note If one adds a Camera prim to a UsdStage whose scene unit is not + centimeters, the fallback values for filmback properties will be + incorrect (or at the least, unexpected) in an absolute sense; however, + proper imaging through a "default camera" with focusing disabled depends + only on ratios of the other properties, so the camera is still usable. + However, it follows that if even one property is authored in the correct + scene units, then they all must be. + + + \\sa \\ref UsdGeom_LinAlgBasics + """ + inherits = + customData = { + string extraIncludes = """ +#include "pxr/base/gf/camera.h" """ + } +) { + # viewing frustum + token projection = "perspective" ( + allowedTokens = ["perspective", "orthographic"]) + float horizontalAperture = 20.9550 ( + doc = """Horizontal aperture in tenths of a scene unit; see + \\ref UsdGeom_CameraUnits . Default is the equivalent of + the standard 35mm spherical projector aperture.""") + float verticalAperture = 15.2908 ( + doc = """Vertical aperture in tenths of a scene unit; see + \\ref UsdGeom_CameraUnits . Default is the equivalent of + the standard 35mm spherical projector aperture.""") + float horizontalApertureOffset = 0.0 ( + doc = """Horizontal aperture offset in the same units as + horizontalAperture. Defaults to 0.""") + float verticalApertureOffset = 0.0 ( + doc = """Vertical aperture offset in the same units as + verticalAperture. Defaults to 0.""") + float focalLength = 50.0 ( + doc = """Perspective focal length in tenths of a scene unit; see + \\ref UsdGeom_CameraUnits .""") + float2 clippingRange = (1, 1000000) ( + doc = """Near and far clipping distances in scene units; see + \\ref UsdGeom_CameraUnits .""") + float4[] clippingPlanes = [] ( + doc = """Additional, arbitrarily oriented clipping planes. + A vector (a,b,c,d) encodes a clipping plane that cuts off + (x,y,z) with a * x + b * y + c * z + d * 1 < 0 where (x,y,z) + are the coordinates in the camera's space.""") + + # depth of field + float fStop = 0.0 ( + doc = """Lens aperture. Defaults to 0.0, which turns off focusing.""") + float focusDistance = 0.0 ( + doc = """Distance from the camera to the focus plane in scene units; see + \\ref UsdGeom_CameraUnits .""") + + # stereoscopic 3D + uniform token stereoRole = "mono" ( + allowedTokens = ["mono", "left", "right"] + doc = """If different from mono, the camera is intended to be the left + or right camera of a stereo setup.""") + + # Parameters for motion blur + double shutter:open = 0.0 ( + doc = """Frame relative shutter open time in UsdTimeCode units (negative + value indicates that the shutter opens before the current + frame time). Used for motion blur.""" + ) + double shutter:close = 0.0 ( + doc = """Frame relative shutter close time, analogous comments from + shutter:open apply. A value greater or equal to shutter:open + should be authored, otherwise there is no exposure and a + renderer should produce a black image.""" + ) + + # exposure adjustment + float exposure = 0.0 ( + doc = """Exposure adjustment, as a log base-2 value. The default + of 0.0 has no effect. A value of 1.0 will double the + image-plane intensities in a rendered image; a value of + -1.0 will halve them.""" + ) +} + +class "GeomModelAPI" +( + inherits = + customData = { + string className = "ModelAPI" + string extraIncludes = """ +#include "pxr/usd/usdGeom/bboxCache.h" +#include "pxr/usd/usdGeom/constraintTarget.h" +#include "pxr/usd/usdGeom/imageable.h" """ + dictionary schemaTokens = { + dictionary extentsHint = { + string doc = """Name of the attribute used to author extents + hints at the root of leaf models. Extents hints are stored by purpose + as a vector of GfVec3f values. They are ordered based on the order + of purpose tokens returned by + UsdGeomImageable::GetOrderedPurposeTokens.""" + } + } + } + doc = """UsdGeomModelAPI extends the generic UsdModelAPI schema with + geometry specific concepts such as cached extents for the entire model, + constraint targets, and geometry-inspired extensions to the payload + lofting process. + + As described in GetExtentsHint() below, it is useful to cache extents + at the model level. UsdGeomModelAPI provides schema for computing and + storing these cached extents, which can be consumed by UsdGeomBBoxCache to + provide fast access to precomputed extents that will be used as the model's + bounds ( see UsdGeomBBoxCache::UsdGeomBBoxCache() ). + + \\section UsdGeomModelAPI_drawMode Draw Modes + + Draw modes provide optional alternate imaging behavior for USD subtrees with + kind model. \\em model:drawMode (which is inheritable) and + \\em model:applyDrawMode (which is not) are resolved into a decision to stop + traversing the scene graph at a certain point, and replace a USD subtree + with proxy geometry. + + The value of \\em model:drawMode determines the type of proxy geometry: + - \\em origin - Draw the model-space basis vectors of the replaced prim. + - \\em bounds - Draw the model-space bounding box of the replaced prim. + - \\em cards - Draw textured quads as a placeholder for the replaced prim. + - \\em default - An explicit opinion to draw the USD subtree as normal. + - \\em inherited - Defer to the parent opinion. + + \\em model:drawMode falls back to _inherited_ so that a whole scene, + a large group, or all prototypes of a model hierarchy PointInstancer can + be assigned a draw mode with a single attribute edit. If no draw mode is + explicitly set in a hierarchy, the resolved value is _default_. + + \\em model:applyDrawMode is meant to be written when an asset is authored, + and provides flexibility for different asset types. For example, + a character assembly (composed of character, clothes, etc) might have + \\em model:applyDrawMode set at the top of the subtree so the whole group + can be drawn as a single card object. An effects subtree might have + \\em model:applyDrawMode set at a lower level so each particle + group draws individually. + + Models of kind component are automatically treated as if + \\em model:applyDrawMode were true if \\em model:applyDrawMode is not + authored on the component prim. A component prim will be drawn drawn with a + simplified representation when the prim has kind component, + \\em model:applyDrawMode is not authored (or authored to be true), and the + resolved (i.e. inherited down namespace) value for \\em model:drawMode is + not _default_. If you don't want component prims to use the resolved + non-default drawMode, you must apply the UsdGeomModelAPI schema on the prim + and explicitly set \\em model:applyDrawMode to false. + + \\section UsdGeomModelAPI_cardGeometry Cards Geometry + + The specific geometry used in cards mode is controlled by the + \\em model:cardGeometry attribute: + - \\em cross - Generate a quad normal to each basis direction and negative. + Locate each quad so that it bisects the model extents. + - \\em box - Generate a quad normal to each basis direction and negative. + Locate each quad on a face of the model extents, facing out. + - \\em fromTexture - Generate a quad for each supplied texture from + attributes stored in that texture's metadata. + + For \\em cross and \\em box mode, the extents are calculated for purposes + \\em default, \\em proxy, and \\em render, at their earliest authored time. + If the model has no textures, all six card faces are rendered using + \\em model:drawModeColor. If one or more textures are present, only axes + with one or more textures assigned are drawn. For each axis, if both + textures (positive and negative) are specified, they'll be used on the + corresponding card faces; if only one texture is specified, it will be + mapped to the opposite card face after being flipped on the texture's + s-axis. Any card faces with invalid asset paths will be drawn with + \\em model:drawModeColor. + + Both \\em model:cardGeometry and \\em model:drawModeColor should be + authored on the prim where the draw mode takes effect, since these + attributes are not inherited. + + For \\em fromTexture mode, only card faces with valid textures assigned + are drawn. The geometry is generated by pulling the \\em worldtoscreen + attribute out of texture metadata. This is expected to be a 4x4 matrix + mapping the model-space position of the card quad to the clip-space quad + with corners (-1,-1,0) and (1,1,0). The card vertices are generated by + transforming the clip-space corners by the inverse of \\em worldtoscreen. + Textures are mapped so that (s) and (t) map to (+x) and (+y) in clip space. + If the metadata cannot be read in the right format, or the matrix can't + be inverted, the card face is not drawn. + + All card faces are drawn and textured as single-sided. + + \\todo CreatePayload() """ +) +{ + uniform token model:drawMode = "inherited" ( + allowedTokens = ["origin", "bounds", "cards", "default", "inherited"] + doc = """Alternate imaging mode; applied to this prim or child prims + where \\em model:applyDrawMode is true, or where the prim + has kind \\em component and \\em model:applyDrawMode is not + authored. See \\ref UsdGeomModelAPI_drawMode + for mode descriptions.""" + ) + uniform bool model:applyDrawMode = false ( + doc = """If true, and the resolved value of \\em model:drawMode is + non-default, apply an alternate imaging mode to this prim. See + \\ref UsdGeomModelAPI_drawMode.""" + ) + uniform float3 model:drawModeColor = (0.18, 0.18, 0.18) ( + doc = """The base color of imaging prims inserted for alternate + imaging modes. For \\em origin and \\em bounds modes, this + controls line color; for \\em cards mode, this controls the + fallback quad color.""" + ) + uniform token model:cardGeometry = "cross" ( + allowedTokens = ["cross", "box", "fromTexture"] + doc = """The geometry to generate for imaging prims inserted for \\em + cards imaging mode. See \\ref UsdGeomModelAPI_cardGeometry for + geometry descriptions.""" + ) + asset model:cardTextureXPos ( + doc = """In \\em cards imaging mode, the texture applied to the X+ quad. + The texture axes (s,t) are mapped to model-space axes (-y, -z).""" + ) + asset model:cardTextureYPos ( + doc = """In \\em cards imaging mode, the texture applied to the Y+ quad. + The texture axes (s,t) are mapped to model-space axes (x, -z).""" + ) + asset model:cardTextureZPos ( + doc = """In \\em cards imaging mode, the texture applied to the Z+ quad. + The texture axes (s,t) are mapped to model-space axes (x, -y).""" + ) + asset model:cardTextureXNeg ( + doc = """In \\em cards imaging mode, the texture applied to the X- quad. + The texture axes (s,t) are mapped to model-space axes (y, -z).""" + ) + asset model:cardTextureYNeg ( + doc = """In \\em cards imaging mode, the texture applied to the Y- quad. + The texture axes (s,t) are mapped to model-space axes (-x, -z).""" + ) + asset model:cardTextureZNeg ( + doc = """In \\em cards imaging mode, the texture applied to the Z- quad. + The texture axes (s,t) are mapped to model-space axes (-x, -y).""" + ) +} + +class "MotionAPI" +( + inherits = + doc = """UsdGeomMotionAPI encodes data that can live on any prim that + may affect computations involving: + - computed motion for motion blur + - sampling for motion blur + + The \\ref GetMotionBlurScaleAttr() "motion:blurScale" attribute allows + artists to scale the __amount__ of motion blur to be rendered for parts + of the scene without changing the recorded animation. See + \\ref UsdGeomMotionAPI_blurScale for use and implementation details. + + """ +) +{ + float motion:blurScale = 1.0 ( + doc = """BlurScale is an __inherited__ float attribute that stipulates + the rendered motion blur (as typically specified via UsdGeomCamera's + _shutter:open_ and _shutter:close_ properties) should be scaled for + __all objects__ at and beneath the prim in namespace on which the + _motion:blurScale_ value is specified. + + Without changing any other data in the scene, _blurScale_ allows artists to + "dial in" the amount of blur on a per-object basis. A _blurScale_ + value of zero removes all blur, a value of 0.5 reduces blur by half, + and a value of 2.0 doubles the blur. The legal range for _blurScale_ + is [0, inf), although very high values may result in extremely expensive + renders, and may exceed the capabilities of some renderers. + + Although renderers are free to implement this feature however they see + fit, see \\ref UsdGeomMotionAPI_blurScale for our guidance on implementing + the feature universally and efficiently. + + \\sa ComputeMotionBlurScale() + """ + ) + + float motion:velocityScale = 1.0 ( + customData = { + string apiName = "velocityScale" + } + doc = """\\deprecated + + VelocityScale is an **inherited** float attribute that + velocity-based schemas (e.g. PointBased, PointInstancer) can consume + to compute interpolated positions and orientations by applying + velocity and angularVelocity, which is required for interpolating + between samples when topology is varying over time. Although these + quantities are generally physically computed by a simulator, sometimes + we require more or less motion-blur to achieve the desired look. + VelocityScale allows artists to dial-in, as a post-sim correction, + a scale factor to be applied to the velocity prior to computing + interpolated positions from it.""" + ) + + int motion:nonlinearSampleCount = 3 ( + customData = { + string apiName = "nonlinearSampleCount" + } + doc = """Determines the number of position or transformation samples + created when motion is described by attributes contributing non-linear + terms. + + To give an example, imagine an application (such as a + renderer) consuming 'points' and the USD document also + contains 'accelerations' for the same prim. Unless the + application can consume these 'accelerations' itself, an + intermediate layer has to compute samples within the sampling + interval for the point positions based on the value of + 'points', 'velocities' and 'accelerations'. The number of these + samples is given by 'nonlinearSampleCount'. The samples are + equally spaced within the sampling interval. + + Another example involves the PointInstancer where + 'nonlinearSampleCount' is relevant when 'angularVelocities' + or 'accelerations' are authored. + + 'nonlinearSampleCount' is an **inherited** attribute, also + see ComputeNonlinearSampleCount()""" + ) +} + +class "XformCommonAPI" +( + inherits = + doc = """This class provides API for authoring and retrieving a standard set + of component transformations which include a scale, a rotation, a + scale-rotate pivot and a translation. The goal of the API is to enhance + component-wise interchange. It achieves this by limiting the set of allowed + basic ops and by specifying the order in which they are applied. In addition + to the basic set of ops, the 'resetXformStack' bit can also be set to + indicate whether the underlying xformable resets the parent transformation + (i.e. does not inherit it's parent's transformation). + + \\sa UsdGeomXformCommonAPI::GetResetXformStack() + \\sa UsdGeomXformCommonAPI::SetResetXformStack() + + The operator-bool for the class will inform you whether an existing + xformable is compatible with this API. + + The scale-rotate pivot is represented by a pair of (translate, + inverse-translate) xformOps around the scale and rotate operations. + The rotation operation can be any of the six allowed Euler angle sets. + \\sa UsdGeomXformOp::Type. + + The xformOpOrder of an xformable that has all of the supported basic ops + is as follows: + ["xformOp:translate", "xformOp:translate:pivot", "xformOp:rotateXYZ", + "xformOp:scale", "!invert!xformOp:translate:pivot"]. + + It is worth noting that all of the ops are optional. For example, an + xformable may have only a translate or a rotate. It would still be + considered as compatible with this API. Individual SetTranslate(), + SetRotate(), SetScale() and SetPivot() methods are provided by this API + to allow such sparse authoring.""" + customData = { + string apiSchemaType = "nonApplied" + string extraIncludes = """ +#include "pxr/usd/usdGeom/xformable.h" +#include "pxr/usd/usdGeom/xformOp.h" """ + dictionary schemaTokens = { + dictionary pivot = { + string doc = """Op suffix for the standard scale-rotate pivot + on a UsdGeomXformCommonAPI-compatible prim. + """ + } + } + } +) +{ +} + +class HermiteCurves "HermiteCurves" ( + inherits = + doc = """This schema specifies a cubic hermite interpolated curve batch as + sometimes used for defining guides for animation. While hermite curves can + be useful because they interpolate through their control points, they are + not well supported by high-end renderers for imaging. Therefore, while we + include this schema for interchange, we strongly recommend the use of + UsdGeomBasisCurves as the representation of curves intended to be rendered + (ie. hair or grass). Hermite curves can be converted to a Bezier + representation (though not from Bezier back to Hermite in general). + + \\section UsdGeomHermiteCurves_Interpolation Point Interpolation + + The initial cubic curve segment is defined by the first two points and + first two tangents. Additional segments are defined by additional + point / tangent pairs. The number of segments for each non-batched hermite + curve would be len(curve.points) - 1. The total number of segments + for the batched UsdGeomHermiteCurves representation is + len(points) - len(curveVertexCounts). + + \\section UsdGeomHermiteCurves_Primvars Primvar, Width, and Normal Interpolation + + Primvar interpolation is not well specified for this type as it is not + intended as a rendering representation. We suggest that per point + primvars would be linearly interpolated across each segment and should + be tagged as 'varying'. + + It is not immediately clear how to specify cubic or 'vertex' interpolation + for this type, as we lack a specification for primvar tangents. This + also means that width and normal interpolation should be restricted to + varying (linear), uniform (per curve element), or constant (per prim). + """ +) { + vector3f[] tangents = [] ( + doc = """Defines the outgoing trajectory tangent for each point. + Tangents should be the same size as the points attribute.""") +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class "HydraGenerativeProceduralAPI" ( + doc = """ + This API extends and configures the core UsdProcGenerativeProcedural schema + defined within usdProc for use with hydra generative procedurals as defined + within hdGp. + """ +) +{ + token primvars:hdGp:proceduralType ( + doc = """The registered name of a HdGpGenerativeProceduralPlugin to + be executed.""" + ) + token proceduralSystem = "hydraGenerativeProcedural" ( + doc = ''' + This value should correspond to a configured instance of + HdGpGenerativeProceduralResolvingSceneIndex which will evaluate the + procedural. The default value of "hydraGenerativeProcedural" matches + the equivalent default of HdGpGenerativeProceduralResolvingSceneIndex. + Multiple instances of the scene index can be used to determine where + within a scene index chain a given procedural will be evaluated. + ''' + ) +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "Types": { + "UsdHydraDiscoveryPlugin": { + "bases": [ + "NdrDiscoveryPlugin" + ], + "displayName": "Discovery plugin for deprecated hydra shaders." + }, + "UsdHydraGenerativeProceduralAPI": { + "alias": { + "UsdSchemaBase": "HydraGenerativeProceduralAPI" + }, + "apiSchemaCanOnlyApplyTo": [ + "GenerativeProcedural" + ], + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + } + } + }, + "LibraryPath": "", + "Name": "usdHydra", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +-- glslfx version 0.1 + +// +// Copyright 2018 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// + +-- configuration +{ + "techniques": { + "default": { + } + } +} + +-- This file is intentionally empty. +#usda 1.0 + +def Shader "HwPtexTexture_1" ( + sdrMetadata = { + token role = "texture" + token isPtex = "1" + } +) +{ + uniform token info:id = "HwPtexTexture_1" + uniform token info:implementationSource = "sourceAsset" + + # Add a dummy sourceAsset attribute with sourceType="glslfx", so that + # an entry gets created for this deprecated shader in the registry. + uniform asset info:glslfx:sourceAsset = @./empty.glslfx@ + + token inputs:faceIndexPrimvar = "ptexFaceIndex" ( + sdrMetadata = { + token primvarProperty = "1" + } + ) + + token inputs:faceOffsetPrimvar = "ptexFaceOffset" ( + sdrMetadata = { + token primvarProperty = "1" + } + ) + + asset inputs:file = @@ ( + doc = "Asset path to the file containg the image data." + ) + + float inputs:frame ( + doc = "The frame offset for animated textures." + ) + + float inputs:textureMemory ( + doc = """Amount of memory used to store the texture (in Mb). A value of + zero specifies the native resolution.""" + ) + + int inputs:faceIndex ( + doc = """The Ptex face index from which to sample. By default, this + parameter will be bound to the ptexFaceIndex primvar.""" + ) + + int inputs:faceOffset ( + doc = """The Ptex face offset to be applied to the face index. By + default, this parameter will be bound to the ptexFaceOffset primvar.""" + ) + + float outputs:r ( + doc = "Outputs the red channel." + sdrMetadata = { + token swizzle = "x" + } + ) + + float outputs:g ( + doc = "Outputs the green channel." + sdrMetadata = { + token swizzle = "y" + } + ) + + float outputs:b ( + doc = "Outputs the blue channnel." + sdrMetadata = { + token swizzle = "z" + } + ) + + float outputs:a ( + doc = "Outputs the alpha channnel." + sdrMetadata = { + token swizzle = "w" + } + ) + + float3 outputs:rgb ( + doc = "Outputs the red, green and blue channels." + sdrMetadata = { + token swizzle = "xyz" + } + ) + + float4 outputs:rgba ( + doc = "Outputs all 4 channels (red, green, blue and alpha)." + sdrMetadata = { + token swizzle = "xyzw" + } + ) +} + +def Shader "HwUvTexture_1" ( + sdrMetadata = { + token role = "texture" + token primvars = "uv" + } +) +{ + uniform token info:id = "HwUvTexture_1" + uniform token info:implementationSource = "sourceAsset" + + # Add a dummy sourceAsset attribute with sourceType="glslfx", so that + # an entry gets created for this deprecated shader in the registry. + uniform asset info:glslfx:sourceAsset = @./empty.glslfx@ + + asset inputs:file = @@ ( + doc = "Asset path to the file containg the image data." + ) + + float inputs:frame ( + doc = "The frame offset for animated textures." + ) + + float inputs:textureMemory ( + doc = """Amount of memory used to store the texture (in Mb). A value of + zero specifies the native resolution.""" + ) + + float2 inputs:uv ( + doc = "The uv coordinates at which to sample the texture." + ) + + token inputs:wrapS ( + allowedTokens = ["clamp", "repeat", "mirror", "black"] + doc = "Specifies the wrap mode for this texture." + ) + + token inputs:wrapT ( + allowedTokens = ["clamp", "repeat", "mirror", "black"] + doc = "Specifies the wrap mode for this texture." + ) + + token inputs:minFilter ( + allowedTokens = ["nearest", "linear", + "linearMipmapLinear", "linearMipmapNearest", + "nearestMipmapLinear", "nearestMipmapNearest" ] + doc = "Specifies the minification filter mode for this texture." + ) + + token inputs:magFilter ( + allowedTokens = ["nearest", "linear"] + doc = "Specifies the magnification filter mode for this texture." + ) + + float4 inputs:fallback = (0.0, 0.0, 0.0, 1.0) ( + doc = """Fallback value to be used when no texture is connected.""" + sdrMetadata = { + token defaultInput = "1" + } + ) +} + +def Shader "HwFieldReader_1" ( + sdrMetadata = { + token role = "field" + } + doc = """Samples from a usdVol FieldAsset.""" +) +{ + uniform asset info:glslfx:sourceAsset = @./empty.glslfx@ + uniform token info:implementationSource = "sourceAsset" + token inputs:fieldname = "" ( + connectability = "interfaceOnly" + doc = """Name of the field to be fetched from volume + (e.g., FOO if the relationship from the volume to field is called field::FOO).""" + sdrMetadata = { + token fieldProperty = "1" + } + ) +} + +def Shader "HwFieldReader_float" ( + inherits = +) +{ + uniform token info:id = "HwFieldReader_float" + float inputs:fallback = 0 ( + doc = "Fallback value to be returned when fetch failed." + sdrMetadata = { + token defaultInput = "1" + } + ) + float outputs:result ( + sdrMetadata = { + token swizzle = "x" + } + ) +} + +def Shader "HwFieldReader_float2" ( + inherits = +) +{ + uniform token info:id = "HwFieldReader_float2" + float2 inputs:fallback = (0, 0) ( + doc = "Fallback value to be returned when fetch failed." + sdrMetadata = { + token defaultInput = "1" + } + ) + float2 outputs:result ( + sdrMetadata = { + token swizzle = "xy" + } + ) +} + +def Shader "HwFieldReader_float3" ( + inherits = +) +{ + uniform token info:id = "HwFieldReader_float3" + float3 inputs:fallback = (0, 0, 0) ( + doc = "Fallback value to be returned when fetch failed." + sdrMetadata = { + token defaultInput = "1" + } + ) + float3 outputs:result ( + sdrMetadata = { + token swizzle = "xyz" + } + ) +} + +def Shader "HwPrimvar_1" ( + sdrMetadata = { + token role = "primvar" + } +) +{ + uniform token info:id = "HwPrimvar_1" + uniform token info:implementationSource = "sourceAsset" + + # Add a dummy sourceAsset attribute with sourceType="glslfx", so that + # an entry gets created for this deprecated shader in the registry. + uniform asset info:glslfx:sourceAsset = @./empty.glslfx@ + + token inputs:varname = "" ( + sdrMetadata = { + bool primvarProperty = 1 + } + doc = """The name of the primvar. Note that on the gprim, this primvar + must follow the standard UsdGeom primvar declaration. + Further note that this name should not contain the UsdGeom primvar + namespace prefix. + """ + ) +} +#usda 1.0 +( + "This file describes the Pixar-specific USD Geometric schemata for code generation." + subLayers = [ + @usd/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdHydra" + string libraryPath = "pxr/usd/usdHydra" + dictionary libraryTokens = { + + dictionary HwPrimvar_1 = { + string doc = """The id value of a Primvar shader.""" + } + + dictionary HwPtexTexture_1 = { + string doc = """The id value of a PtexTexture shader.""" + } + + dictionary HwUvTexture_1 = { + string doc = """The id value of a UvTexture shader.""" + } + + dictionary displayLookBxdf = { + string value = "displayLook:bxdf" + string doc = """\deprecated This has been deprecated in favor of + the glslfx:surface output. + + Relationship on a material that targets the "bxdf" or the + surface shader prim.""" + } + + dictionary infoFilename = { + string value = "inputs:file" + string doc = """ The special "info:filename" property of a hydra + Texture shader, which points to a resolvable texture asset.""" + } + + + dictionary infoVarname = { + string value = "inputs:varname" + string doc = """ + """ + } + + dictionary textureMemory = { + string doc = """A shader input on a hydra Texture shader.""" + } + + dictionary frame = { + string doc = """A shader input on a "Texture" shader.""" + } + + dictionary uv = { + string doc = """A shader input on a hydra UvTexture shader.""" + } + + dictionary wrapS = { + string doc = """A shader input on a hydra UvTexture shader which + defines the behavior of texture coordinates that are outside the + bounds of the texture.""" + } + + + dictionary wrapT = { + string doc = """A shader input on a hydra UvTexture shader which + defines the behavior of texture coordinates that are outside the + bounds of the texture.""" + } + + dictionary black = { + string doc = """Possible value for "wrapT" and "wrapS" inputs on + a "UvTexture" shader prim. + Causes black to be returned when sampling outside the bounds of + the texture.""" + } + + dictionary clamp = { + string doc = """Possible value for "wrapT" and "wrapS" inputs on + a "UvTexture" shader prim. + Causes the the texture coordinate to be clamped to [0,1].""" + } + + dictionary mirror = { + string doc = """Possible value for "wrapT" and "wrapS" inputs on + a "UvTexture" shader prim. + Causes the texture coordinate to wrap around like a mirror. -0.2 + becomes 0.2, -1.2 becomes 0.8, etc. ,""" + } + + dictionary repeat = { + string doc = """Possible value for "wrapT" and "wrapS" inputs on + a "UvTexture" shader prim. + Causes the texture coordinate to wrap around the texture. So a + texture coordinate of -0.2 becomes the equivalent of 0.8.""" + } + + dictionary useMetadata = { + string doc = """Possible value for "wrapT" and "wrapS" inputs on + a "UvTexture" shader prim. + Causes the wrap value to be loaded from the texture file instead + of being specified in the prim. If the texture file doesn't + support metadata or the metadata doesn't contain a wrap mode, + the "black" wrap mode is used.""" + } + + dictionary magFilter = { + string doc = """An input on a UvTexture shader.""" + } + + dictionary minFilter = { + string doc = """An input on a UvTexture shader.""" + } + + dictionary linearMipmapLinear = { + string doc = """See https://www.opengl.org/wiki/Sampler_Object , + Possible value for the "minFilter" input on a UvTexture shader. + """ + } + + dictionary linearMipmapNearest = { + string doc = """See https://www.opengl.org/wiki/Sampler_Object + Possible value for the "minFilter" input on a UvTexture shader. + """ + } + + dictionary nearestMipmapNearest = { + string doc = """See https://www.opengl.org/wiki/Sampler_Object + Possible value for the "minFilter" input on a UvTexture shader. + """ + } + + dictionary linear = { + string doc = """A weighted linear blend of nearest adjacent + samples. + Possible value for "minFilter" and "magFilter" inputs on a + UvTextureshader.""" + } + + dictionary nearest = { + string doc = """Selects the nearest sample for the given + coordinate + Possible value for "minFilter" and "magFilter" inputs on a + UvTexture shader.""" + } + + dictionary nearestMipmapLinear = { + string doc = """See https://www.opengl.org/wiki/Sampler_Object + Possible value for "minFilter" and "magFilter" inputs on a + UvTexture shader.""" + } + + dictionary faceIndex = { + string doc = """The "faceIndex" shader input on a hydra + "PtexTexture" shader.""" + } + + dictionary faceOffset = { + string doc = """The "faceOffset" shader input on a hydra + "PtexTexture" shader.""" + } + } + } +){ +} + +class "HydraGenerativeProceduralAPI" ( + inherits = + doc = """ + This API extends and configures the core UsdProcGenerativeProcedural schema + defined within usdProc for use with hydra generative procedurals as defined + within hdGp. + """ + customData = { + string className = "GenerativeProceduralAPI" + token[] apiSchemaCanOnlyApplyTo = ["GenerativeProcedural"] + } +){ + token primvars:hdGp:proceduralType ( + doc = """The registered name of a HdGpGenerativeProceduralPlugin to + be executed.""" + + customData = { + string apiName = "proceduralType" + } + ) + + token proceduralSystem = "hydraGenerativeProcedural" ( + doc = """ + This value should correspond to a configured instance of + HdGpGenerativeProceduralResolvingSceneIndex which will evaluate the + procedural. The default value of "hydraGenerativeProcedural" matches + the equivalent default of HdGpGenerativeProceduralResolvingSceneIndex. + Multiple instances of the scene index can be used to determine where + within a scene index chain a given procedural will be evaluated. + """ + ) +} +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "faceIndexPrimvar": { + "appliesTo": [ + "attributes" + ], + "default": "ptexFaceIndex", + "documentation": "Specifies an array of face indices used for ptex mapping", + "type": "token" + }, + "faceOffsetPrimvar": { + "appliesTo": [ + "attributes" + ], + "default": "ptexFaceOffset", + "documentation": "Specifies the ptex face index offset for aggregated ptex files", + "type": "token" + }, + "uvPrimvar": { + "appliesTo": [ + "attributes" + ], + "default": "", + "documentation": "Specifies the UV primvar for texture mapping", + "type": "token" + } + }, + "Types": { + "UsdImagingBasisCurvesAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "BasisCurves" + }, + "UsdImagingCameraAdapter": { + "bases": [ + "UsdImagingPrimAdapter" + ], + "isInternal": true, + "primTypeName": "Camera" + }, + "UsdImagingCapsuleAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "includeSchemaFamily": true, + "primTypeName": "Capsule" + }, + "UsdImagingCollectionAPIAdapter" : { + "bases": ["UsdImagingAPISchemaAdapter"], + "isInternal": true, + "apiSchemaName": "CollectionAPI" + }, + "UsdImagingConeAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Cone" + }, + "UsdImagingCoordSysAdapter": { + "bases": [ + "UsdImagingPrimAdapter" + ], + "isInternal": true, + "primTypeName": "coordSys" + }, + "UsdImagingCoordSysAPIAdapter" : { + "bases": ["UsdImagingAPISchemaAdapter"], + "isInternal": true, + "apiSchemaName": "CoordSysAPI" + }, + "UsdImagingCubeAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Cube" + }, + "UsdImagingCylinderAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "includeSchemaFamily": true, + "primTypeName": "Cylinder" + }, + "UsdImagingDrawModeAdapter" : { + "bases": ["UsdImagingInstanceablePrimAdapter"], + "isInternal": true, + "primTypeName": "__drawModeAdapter" + }, + "UsdImagingGeomSubsetAdapter" : { + "bases": ["UsdImagingPrimAdapter"], + "isInternal": true, + "primTypeName": "GeomSubset" + }, + "UsdImagingHermiteCurvesAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "HermiteCurves" + }, + "UsdImagingMaterialAdapter" : { + "bases": ["UsdImagingPrimAdapter"], + "isInternal": true, + "primTypeName": "Material" + }, + + "UsdImagingShaderAdapter" : { + "bases": ["UsdImagingRepresentedByAncestorPrimAdapter"], + "isInternal": true, + "primTypeName": "Shader" + }, + + "UsdImagingNodeGraphAdapter" : { + "bases": ["UsdImagingRepresentedByAncestorPrimAdapter"], + "isInternal": true, + "primTypeName": "NodeGraph" + }, + + "UsdImagingMaterialBindingAPIAdapter" : { + "bases": ["UsdImagingAPISchemaAdapter"], + "isInternal": true, + "apiSchemaName": "MaterialBindingAPI" + }, + "UsdImagingMeshAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Mesh" + }, + "UsdImagingTetMeshAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "TetMesh" + }, + "UsdImagingNurbsCurvesAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "NurbsCurves" + }, + "UsdImagingNurbsPatchAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "NurbsPatch" + }, + "UsdImagingPlaneAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Plane" + }, + "UsdImagingPointsAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Points" + }, + "UsdImagingPointInstancerAdapter": { + "bases": [ + "UsdImagingInstanceablePrimAdapter" + ], + "isInternal": true, + "primTypeName": "PointInstancer" + }, + "UsdImagingSphereAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Sphere" + }, + "UsdImagingRenderSettingsAdapter": { + "bases": [ + "UsdImagingPrimAdapter" + ], + "isInternal": true, + "primTypeName": "RenderSettings" + }, + "UsdImagingRenderProductAdapter": { + "bases": [ + "UsdImagingPrimAdapter" + ], + "isInternal": true, + "primTypeName": "RenderProduct" + }, + "UsdImagingRenderVarAdapter": { + "bases": [ + "UsdImagingPrimAdapter" + ], + "isInternal": true, + "primTypeName": "RenderVar" + }, + "UsdImagingVolumeAdapter": { + "bases": [ + "UsdImagingGprimAdapter" + ], + "isInternal": true, + "primTypeName": "Volume" + }, + "UsdImagingLightAdapter": { + "bases": [ + "UsdImagingInstanceablePrimAdapter" + ], + "isInternal": true, + "primTypeName": "LightAPI", + "includeDerivedPrimTypes" : true + }, + "UsdImagingLightAPIAdapter": { + "bases": [ + "UsdImagingAPISchemaAdapter" + ], + "isInternal": true, + "apiSchemaName": "LightAPI" + }, + "UsdImagingLightFilterAdapter": { + "bases": [ + "UsdImagingPrimAdapter" + ], + "isInternal": true, + "primTypeName": "LightFilter", + "includeDerivedPrimTypes" : true + }, + "UsdImagingDomeLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "DomeLight" + }, + "UsdImagingDomeLight_1Adapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "DomeLight_1" + }, + "UsdImagingRectLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "RectLight" + }, + "UsdImagingSphereLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "SphereLight" + }, + "UsdImagingCylinderLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "CylinderLight" + }, + "UsdImagingDiskLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "DiskLight" + }, + "UsdImagingDistantLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "DistantLight" + }, + "UsdImagingPluginLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "PluginLight" + }, + "UsdImagingGeometryLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "GeometryLight" + }, + "UsdImagingPortalLightAdapter": { + "bases": [ + "UsdImagingLightAdapter" + ], + "isInternal": true, + "primTypeName": "PortalLight" + }, + "UsdImagingPluginLightFilterAdapter": { + "bases": [ + "UsdImagingLightFilterAdapter" + ], + "isInternal": true, + "primTypeName": "PluginLightFilter" + }, + "UsdImagingGeomModelAPIAdapter": { + "bases": [ + "UsdImagingAPISchemaAdapter" + ], + "isInternal": true, + "apiSchemaName": "GeomModelAPI" + } + } + }, + "LibraryPath": "", + "Name": "usdImaging", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class "LightAPI" ( + apiSchemas = ["CollectionAPI:lightLink", "CollectionAPI:shadowLink"] + customData = { + token[] apiSchemaOverridePropertyNames = ["collection:lightLink:includeRoot", "collection:shadowLink:includeRoot"] + } + doc = """API schema that imparts the quality of being a light onto a prim. + + A light is any prim that has this schema applied to it. This is true + regardless of whether LightAPI is included as a built-in API of the prim + type (e.g. RectLight or DistantLight) or is applied directly to a Gprim + that should be treated as a light. + + Linking + + Lights can be linked to geometry. Linking controls which geometry + a light illuminates, and which geometry casts shadows from the light. + + Linking is specified as collections (UsdCollectionAPI) which can + be accessed via GetLightLinkCollection() and GetShadowLinkCollection(). + Note that these collections have their includeRoot set to true, + so that lights will illuminate and cast shadows from all objects + by default. To illuminate only a specific set of objects, there + are two options. One option is to modify the collection paths + to explicitly exclude everything else, assuming it is known; + the other option is to set includeRoot to false and explicitly + include the desired objects. These are complementary approaches + that may each be preferable depending on the scenario and how + to best express the intent of the light setup. + """ +) +{ + uniform bool collection:lightLink:includeRoot = 1 + uniform bool collection:shadowLink:includeRoot = 1 + color3f inputs:color = (1, 1, 1) ( + displayGroup = "Basic" + displayName = "Color" + doc = "The color of emitted light, in energy-linear terms." + ) + float inputs:colorTemperature = 6500 ( + displayGroup = "Basic" + displayName = "Color Temperature" + doc = """Color temperature, in degrees Kelvin, representing the + white point. The default is a common white point, D65. Lower + values are warmer and higher values are cooler. The valid range + is from 1000 to 10000. Only takes effect when + enableColorTemperature is set to true. When active, the + computed result multiplies against the color attribute. + See UsdLuxBlackbodyTemperatureAsRgb().""" + ) + float inputs:diffuse = 1 ( + displayGroup = "Refine" + displayName = "Diffuse Multiplier" + doc = """A multiplier for the effect of this light on the diffuse + response of materials. This is a non-physical control.""" + ) + bool inputs:enableColorTemperature = 0 ( + displayGroup = "Basic" + displayName = "Enable Color Temperature" + doc = "Enables using colorTemperature." + ) + float inputs:exposure = 0 ( + displayGroup = "Basic" + displayName = "Exposure" + doc = """Scales the power of the light exponentially as a power + of 2 (similar to an F-stop control over exposure). The result + is multiplied against the intensity.""" + ) + float inputs:intensity = 1 ( + displayGroup = "Basic" + displayName = "Intensity" + doc = "Scales the power of the light linearly." + ) + bool inputs:normalize = 0 ( + displayGroup = "Advanced" + displayName = "Normalize Power" + doc = """Normalizes power by the surface area of the light. + This makes it easier to independently adjust the power and shape + of the light, by causing the power to not vary with the area or + angular size of the light.""" + ) + float inputs:specular = 1 ( + displayGroup = "Refine" + displayName = "Specular Multiplier" + doc = """A multiplier for the effect of this light on the specular + response of materials. This is a non-physical control.""" + ) + rel light:filters ( + doc = "Relationship to the light filters that apply to this light." + ) + uniform token light:materialSyncMode = "noMaterialResponse" ( + allowedTokens = ["materialGlowTintsLight", "independent", "noMaterialResponse"] + displayGroup = "Geometry" + displayName = "Material Sync Mode" + doc = """For a LightAPI applied to geometry that has a bound Material, + which is entirely or partly emissive, this specifies the relationship + of the Material response to the lighting response. + Valid values are: + - materialGlowTintsLight: All primary and secondary rays see the + emissive/glow response as dictated by the bound Material while the + base color seen by light rays (which is then modulated by all of the + other LightAPI controls) is the multiplication of the color feeding + the emission/glow input of the Material (i.e. its surface or volume + shader) with the scalar or pattern input to *inputs:color*. + This allows the light's color to tint the geometry's glow color while + preserving access to intensity and other light controls as ways to + further modulate the illumination. + - independent: All primary and secondary rays see the emissive/glow + response as dictated by the bound Material, while the base color seen + by light rays is determined solely by *inputs:color*. Note that for + partially emissive geometry (in which some parts are reflective + rather than emissive), a suitable pattern must be connected to the + light's color input, or else the light will radiate uniformly from + the geometry. + - noMaterialResponse: The geometry behaves as if there is no Material + bound at all, i.e. there is no diffuse, specular, or transmissive + response. The base color of light rays is entirely controlled by the + *inputs:color*. This is the standard mode for \"canonical\" lights in + UsdLux and indicates to renderers that a Material will either never + be bound or can always be ignored. + """ + ) + uniform token light:shaderId = "" ( + displayGroup = "Internal" + doc = """Default ID for the light's shader. + This defines the shader ID for this light when a render context specific + shader ID is not available. + + The default shaderId for the intrinsic UsdLux lights (RectLight, + DistantLight, etc.) are set to default to the light's type name. For + each intrinsic UsdLux light, we will always register an SdrShaderNode in + the SdrRegistry, with the identifier matching the type name and the + source type \"USD\", that corresponds to the light's inputs. + \\see GetShaderId + \\see GetShaderIdAttrForRenderContext + \\see SdrRegistry::GetShaderNodeByIdentifier + \\see SdrRegistry::GetShaderNodeByIdentifierAndType + """ + ) +} + +class "MeshLightAPI" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:materialSyncMode", "light:shaderId"] + } + doc = '''This is the preferred API schema to apply to + "Mesh" type prims when adding light behaviors to a mesh. + At its base, this API schema has the built-in behavior of applying LightAPI + to the mesh and overriding the default materialSyncMode to allow the + emission/glow of the bound material to affect the color of the light. + But, it additionally serves as a hook for plugins to attach additional + properties to "mesh lights" through the creation of API schemas which are + authored to auto-apply to MeshLightAPI. + \\see \\ref Usd_AutoAppliedAPISchemas + ''' +) +{ + uniform token light:materialSyncMode = "materialGlowTintsLight" + uniform token light:shaderId = "MeshLight" +} + +class "VolumeLightAPI" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:materialSyncMode", "light:shaderId"] + } + doc = '''This is the preferred API schema to apply to + "Volume" type prims when adding light behaviors to a + volume. At its base, this API schema has the built-in behavior of applying + LightAPI to the volume and overriding the default materialSyncMode to allow + the emission/glow of the bound material to affect the color of the light. + But, it additionally serves as a hook for plugins to attach additional + properties to "volume lights" through the creation of API schemas which are + authored to auto-apply to VolumeLightAPI. + \\see \\ref Usd_AutoAppliedAPISchemas + ''' +) +{ + uniform token light:materialSyncMode = "materialGlowTintsLight" + uniform token light:shaderId = "VolumeLight" +} + +class "LightListAPI" ( + doc = '''API schema to support discovery and publishing of lights in a scene. + + Discovering Lights via Traversal + + To motivate this API, consider what is required to discover all + lights in a scene. We must load all payloads and traverse all prims: + + \\code + 01 // Load everything on the stage so we can find all lights, + 02 // including those inside payloads + 03 stage->Load(); + 04 + 05 // Traverse all prims, checking if they have an applied UsdLuxLightAPI + 06 // (Note: ignoring instancing and a few other things for simplicity) + 07 SdfPathVector lights; + 08 for (UsdPrim prim: stage->Traverse()) { + 09 if (prim.HasAPI()) { + 10 lights.push_back(i->GetPath()); + 11 } + 12 } + \\endcode + + This traversal -- suitably elaborated to handle certain details -- + is the first and simplest thing UsdLuxLightListAPI provides. + UsdLuxLightListAPI::ComputeLightList() performs this traversal and returns + all lights in the scene: + + \\code + 01 UsdLuxLightListAPI listAPI(stage->GetPseudoRoot()); + 02 SdfPathVector lights = listAPI.ComputeLightList(); + \\endcode + + Publishing a Cached Light List + + Consider a USD client that needs to quickly discover lights but + wants to defer loading payloads and traversing the entire scene + where possible, and is willing to do up-front computation and + caching to achieve that. + + UsdLuxLightListAPI provides a way to cache the computed light list, + by publishing the list of lights onto prims in the model + hierarchy. Consider a big set that contains lights: + + \\code + 01 def Xform "BigSetWithLights" ( + 02 kind = "assembly" + 03 payload = @BigSetWithLights.usd@ // Heavy payload + 04 ) { + 05 // Pre-computed, cached list of lights inside payload + 06 rel lightList = [ + 07 <./Lights/light_1>, + 08 <./Lights/light_2>, + 09 ... + 10 ] + 11 token lightList:cacheBehavior = "consumeAndContinue"; + 12 } + \\endcode + + The lightList relationship encodes a set of lights, and the + lightList:cacheBehavior property provides fine-grained + control over how to use that cache. (See details below.) + + The cache can be created by first invoking + ComputeLightList(ComputeModeIgnoreCache) to pre-compute the list + and then storing the result with UsdLuxLightListAPI::StoreLightList(). + + To enable efficient retrieval of the cache, it should be stored + on a model hierarchy prim. Furthermore, note that while you can + use a UsdLuxLightListAPI bound to the pseudo-root prim to query the + lights (as in the example above) because it will perform a + traversal over descendants, you cannot store the cache back to the + pseduo-root prim. + + To consult the cached list, we invoke + ComputeLightList(ComputeModeConsultModelHierarchyCache): + + \\code + 01 // Find and load all lights, using lightList cache where available + 02 UsdLuxLightListAPI list(stage->GetPseudoRoot()); + 03 SdfPathSet lights = list.ComputeLightList( + 04 UsdLuxLightListAPI::ComputeModeConsultModelHierarchyCache); + 05 stage.LoadAndUnload(lights, SdfPathSet()); + \\endcode + + In this mode, ComputeLightList() will traverse the model + hierarchy, accumulating cached light lists. + + Controlling Cache Behavior + + The lightList:cacheBehavior property gives additional fine-grained + control over cache behavior: + + - The fallback value, "ignore", indicates that the lightList should + be disregarded. This provides a way to invalidate cache entries. + Note that unless "ignore" is specified, a lightList with an empty + list of targets is considered a cache indicating that no lights + are present. + + - The value "consumeAndContinue" indicates that the cache should + be consulted to contribute lights to the scene, and that recursion + should continue down the model hierarchy in case additional lights + are added as descedants. This is the default value established when + StoreLightList() is invoked. This behavior allows the lights within + a large model, such as the BigSetWithLights example above, to be + published outside the payload, while also allowing referencing and + layering to add additional lights over that set. + + - The value "consumeAndHalt" provides a way to terminate recursive + traversal of the scene for light discovery. The cache will be + consulted but no descendant prims will be examined. + + Instancing + + Where instances are present, UsdLuxLightListAPI::ComputeLightList() will + return the instance-unique paths to any lights discovered within + those instances. Lights within a UsdGeomPointInstancer will + not be returned, however, since they cannot be referred to + solely via paths. +''' +) +{ + rel lightList ( + doc = "Relationship to lights in the scene." + ) + token lightList:cacheBehavior ( + allowedTokens = ["consumeAndHalt", "consumeAndContinue", "ignore"] + doc = """Controls how the lightList should be interpreted. + Valid values are: + - consumeAndHalt: The lightList should be consulted, + and if it exists, treated as a final authoritative statement + of any lights that exist at or below this prim, halting + recursive discovery of lights. + - consumeAndContinue: The lightList should be consulted, + but recursive traversal over nameChildren should continue + in case additional lights are added by descendants. + - ignore: The lightList should be entirely ignored. This + provides a simple way to temporarily invalidate an existing + cache. This is the fallback behavior. + """ + ) +} + +class "ListAPI" ( + doc = """ + \\deprecated + Use LightListAPI instead +""" +) +{ + rel lightList ( + doc = "Relationship to lights in the scene." + ) + token lightList:cacheBehavior ( + allowedTokens = ["consumeAndHalt", "consumeAndContinue", "ignore"] + doc = """Controls how the lightList should be interpreted. + Valid values are: + - consumeAndHalt: The lightList should be consulted, + and if it exists, treated as a final authoritative statement + of any lights that exist at or below this prim, halting + recursive discovery of lights. + - consumeAndContinue: The lightList should be consulted, + but recursive traversal over nameChildren should continue + in case additional lights are added by descendants. + - ignore: The lightList should be entirely ignored. This + provides a simple way to temporarily invalidate an existing + cache. This is the fallback behavior. + """ + ) +} + +class "ShapingAPI" ( + doc = "Controls for shaping a light's emission." +) +{ + float inputs:shaping:cone:angle = 90 ( + displayGroup = "Shaping" + displayName = "Cone Angle" + doc = """Angular limit off the primary axis to restrict the + light spread.""" + ) + float inputs:shaping:cone:softness = 0 ( + displayGroup = "Shaping" + displayName = "Cone Softness" + doc = """Controls the cutoff softness for cone angle. + TODO: clarify semantics""" + ) + float inputs:shaping:focus = 0 ( + displayGroup = "Shaping" + displayName = "Emission Focus" + doc = """A control to shape the spread of light. Higher focus + values pull light towards the center and narrow the spread. + Implemented as an off-axis cosine power exponent. + TODO: clarify semantics""" + ) + color3f inputs:shaping:focusTint = (0, 0, 0) ( + displayGroup = "Shaping" + displayName = "Emission Focus Tint" + doc = """Off-axis color tint. This tints the emission in the + falloff region. The default tint is black. + TODO: clarify semantics""" + ) + float inputs:shaping:ies:angleScale = 0 ( + displayGroup = "Shaping" + displayName = "Profile Scale" + doc = """Rescales the angular distribution of the IES profile. + TODO: clarify semantics""" + ) + asset inputs:shaping:ies:file ( + displayGroup = "Shaping" + displayName = "IES Profile" + doc = """An IES (Illumination Engineering Society) light + profile describing the angular distribution of light.""" + ) + bool inputs:shaping:ies:normalize = 0 ( + displayGroup = "Shaping" + displayName = "Profile Normalization" + doc = """Normalizes the IES profile so that it affects the shaping + of the light while preserving the overall energy output.""" + ) +} + +class "ShadowAPI" ( + doc = """Controls to refine a light's shadow behavior. These are + non-physical controls that are valuable for visual lighting work.""" +) +{ + color3f inputs:shadow:color = (0, 0, 0) ( + displayGroup = "Shadows" + displayName = "Shadow Color" + doc = """The color of shadows cast by the light. This is a + non-physical control. The default is to cast black shadows.""" + ) + float inputs:shadow:distance = -1 ( + displayGroup = "Shadows" + displayName = "Shadow Max Distance" + doc = """The maximum distance shadows are cast. The distance is + measured as the distance between the point on the surface and the + occluder. + The default value (-1) indicates no limit. + """ + ) + bool inputs:shadow:enable = 1 ( + displayGroup = "Shadows" + displayName = "Enable Shadows" + doc = "Enables shadows to be cast by this light." + ) + float inputs:shadow:falloff = -1 ( + displayGroup = "Shadows" + displayName = "Shadow Falloff" + doc = """The size of the shadow falloff zone within the shadow max + distance, which can be used to hide the hard cut-off for shadows seen + stretching past the max distance. The falloff zone is the area that + fades from full shadowing at the beginning of the falloff zone to no + shadowing at the max distance from the occluder. The falloff zone + distance cannot exceed the shadow max distance. A falloff value equal + to or less than zero (with -1 as the default) indicates no falloff. + """ + ) + float inputs:shadow:falloffGamma = 1 ( + displayGroup = "Shadows" + displayName = "Shadow Falloff Gamma" + doc = """A gamma (i.e., exponential) control over shadow strength + with linear distance within the falloff zone. This controls the rate + of the falloff. + This requires the use of shadowDistance and shadowFalloff.""" + ) +} + +class LightFilter "LightFilter" ( + apiSchemas = ["CollectionAPI:filterLink"] + customData = { + token[] apiSchemaOverridePropertyNames = ["collection:filterLink:includeRoot"] + } + doc = """A light filter modifies the effect of a light. + Lights refer to filters via relationships so that filters may be + shared. + + Linking + + Filters can be linked to geometry. Linking controls which geometry + a light-filter affects, when considering the light filters attached + to a light illuminating the geometry. + + Linking is specified as a collection (UsdCollectionAPI) which can + be accessed via GetFilterLinkCollection(). + """ +) +{ + uniform bool collection:filterLink:includeRoot = 1 + uniform token lightFilter:shaderId = "" ( + displayGroup = "Internal" + doc = """Default ID for the light filter's shader. + This defines the shader ID for this light filter when a render context + specific shader ID is not available. + + \\see GetShaderId + \\see GetShaderIdAttrForRenderContext + \\see SdrRegistry::GetShaderNodeByIdentifier + \\see SdrRegistry::GetShaderNodeByIdentifierAndType + """ + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "BoundableLightBase" ( + apiSchemas = ["LightAPI"] + doc = """Base class for intrinsic lights that are boundable. + + The primary purpose of this class is to provide a direct API to the + functions provided by LightAPI for concrete derived light types. + """ +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "NonboundableLightBase" ( + apiSchemas = ["LightAPI"] + doc = """Base class for intrinsic lights that are not boundable. + + The primary purpose of this class is to provide a direct API to the + functions provided by LightAPI for concrete derived light types. + """ +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class DistantLight "DistantLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["inputs:intensity", "light:shaderId"] + } + doc = """Light emitted from a distant source along the -Z axis. + Also known as a directional light.""" +) +{ + float inputs:angle = 0.53 ( + displayGroup = "Basic" + displayName = "Angle Extent" + doc = """Angular size of the light in degrees. + As an example, the Sun is approximately 0.53 degrees as seen from Earth. + Higher values broaden the light and therefore soften shadow edges. + """ + ) + float inputs:intensity = 50000 ( + doc = """Scales the emission of the light linearly. + The DistantLight has a high default intensity to approximate the Sun.""" + ) + uniform token light:shaderId = "DistantLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class DiskLight "DiskLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """Light emitted from one side of a circular disk. + The disk is centered in the XY plane and emits light along the -Z axis.""" +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + float inputs:radius = 0.5 ( + displayGroup = "Geometry" + displayName = "Radius" + doc = "Radius of the disk." + ) + uniform token light:shaderId = "DiskLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class RectLight "RectLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """Light emitted from one side of a rectangle. + The rectangle is centered in the XY plane and emits light along the -Z axis. + The rectangle is 1 unit in length in the X and Y axis. In the default + position, a texture file's min coordinates should be at (+X, +Y) and + max coordinates at (-X, -Y).""" +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + float inputs:height = 1 ( + displayGroup = "Geometry" + displayName = "Height" + doc = "Height of the rectangle, in the local Y axis." + ) + asset inputs:texture:file ( + displayGroup = "Basic" + displayName = "Color Map" + doc = "A color texture to use on the rectangle." + ) + float inputs:width = 1 ( + displayGroup = "Geometry" + displayName = "Width" + doc = "Width of the rectangle, in the local X axis." + ) + uniform token light:shaderId = "RectLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class SphereLight "SphereLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = "Light emitted outward from a sphere." +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + float inputs:radius = 0.5 ( + displayGroup = "Geometry" + displayName = "Radius" + doc = "Radius of the sphere." + ) + uniform token light:shaderId = "SphereLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + bool treatAsPoint = 0 ( + displayGroup = "Advanced" + displayName = "Treat As Point" + doc = """A hint that this light can be treated as a 'point' + light (effectively, a zero-radius sphere) by renderers that + benefit from non-area lighting. Renderers that only support + area lights can disregard this.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class CylinderLight "CylinderLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """Light emitted outward from a cylinder. + The cylinder is centered at the origin and has its major axis on the X axis. + The cylinder does not emit light from the flat end-caps. + """ +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + float inputs:length = 1 ( + displayGroup = "Geometry" + displayName = "Length" + doc = "Length of the cylinder, in the local X axis." + ) + float inputs:radius = 0.5 ( + displayGroup = "Geometry" + displayName = "Radius" + doc = "Radius of the cylinder." + ) + uniform token light:shaderId = "CylinderLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + bool treatAsLine = 0 ( + displayGroup = "Advanced" + displayName = "Treat As Line" + doc = """A hint that this light can be treated as a 'line' + light (effectively, a zero-radius cylinder) by renderers that + benefit from non-area lighting. Renderers that only support + area lights can disregard this.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class GeometryLight "GeometryLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """\\deprecated + Light emitted outward from a geometric prim (UsdGeomGprim), + which is typically a mesh.""" +) +{ + rel geometry ( + doc = "Relationship to the geometry to use as the light source." + ) + uniform token light:shaderId = "GeometryLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class DomeLight "DomeLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """Light emitted inward from a distant external environment, + such as a sky or IBL light probe. + + In this version of the dome light, the dome's default orientation is such + that its top pole is aligned with the world's +Y axis. This adheres to the + OpenEXR specification for latlong environment maps. From the OpenEXR + documentation: + + ------------------------------------------------------------------------- + Latitude-Longitude Map: + + The environment is projected onto the image using polar coordinates + (latitude and longitude). A pixel's x coordinate corresponds to + its longitude, and the y coordinate corresponds to its latitude. + Pixel (dataWindow.min.x, dataWindow.min.y) has latitude +pi/2 and + longitude +pi; pixel (dataWindow.max.x, dataWindow.max.y) has + latitude -pi/2 and longitude -pi. + + In 3D space, latitudes -pi/2 and +pi/2 correspond to the negative and + positive y direction. Latitude 0, longitude 0 points into positive + z direction; and latitude 0, longitude pi/2 points into positive x + direction. + + The size of the data window should be 2*N by N pixels (width by height), + where N can be any integer greater than 0. + ------------------------------------------------------------------------- +""" +) +{ + float guideRadius = 100000 ( + displayGroup = "Guides" + displayName = "Radius" + doc = "The radius of guide geometry to use to visualize the dome light. The default is 1 km for scenes whose metersPerUnit is the USD default of 0.01 (i.e., 1 world unit is 1 cm)." + ) + asset inputs:texture:file ( + displayGroup = "Basic" + displayName = "Color Map" + doc = """A color texture to use on the dome, such as an HDR (high + dynamic range) texture intended for IBL (image based lighting).""" + ) + token inputs:texture:format = "automatic" ( + allowedTokens = ["automatic", "latlong", "mirroredBall", "angular", "cubeMapVerticalCross"] + displayGroup = "Basic" + displayName = "Color Map Format" + doc = """Specifies the parameterization of the color map file. + Valid values are: + - automatic: Tries to determine the layout from the file itself. + For example, Renderman texture files embed an explicit + parameterization. + - latlong: Latitude as X, longitude as Y. + - mirroredBall: An image of the environment reflected in a + sphere, using an implicitly orthogonal projection. + - angular: Similar to mirroredBall but the radial dimension + is mapped linearly to the angle, providing better sampling + at the edges. + - cubeMapVerticalCross: A cube map with faces laid out as a + vertical cross. + """ + ) + uniform token light:shaderId = "DomeLight" + rel portals ( + doc = "Optional portals to guide light sampling." + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class DomeLight_1 "DomeLight_1" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """Light emitted inward from a distant external environment, + such as a sky or IBL light probe. + + In this version of the dome light, the dome's default orientation is + determined by its *poleAxis* property. The fallback value, \"scene\", means + that the dome starts with its top pole aligned with the stage's up axis. + + Note that the rotation necessary to align the dome light with its *poleAxis* + is intended to be applied by a renderer to only the dome itself, and *not* + to inherit down to any USD namespace children of the dome light prim. + + If *poleAxis* is set to \"Y\" or \"scene\" and the stage's up axis is \"Y\", the + dome's default orientation will adhere to the OpenEXR specification for + latlong environment maps. From the OpenEXR documentation: + + ------------------------------------------------------------------------- + Latitude-Longitude Map: + + The environment is projected onto the image using polar coordinates + (latitude and longitude). A pixel's x coordinate corresponds to + its longitude, and the y coordinate corresponds to its latitude. + Pixel (dataWindow.min.x, dataWindow.min.y) has latitude +pi/2 and + longitude +pi; pixel (dataWindow.max.x, dataWindow.max.y) has + latitude -pi/2 and longitude -pi. + + In 3D space, latitudes -pi/2 and +pi/2 correspond to the negative and + positive y direction. Latitude 0, longitude 0 points into positive + z direction; and latitude 0, longitude pi/2 points into positive x + direction. + + The size of the data window should be 2*N by N pixels (width by height), + where N can be any integer greater than 0. + ------------------------------------------------------------------------- + + If *poleAxis* is set to \"Z\" or \"scene\" and the stage's up axis is \"Z\", + latitudes -pi/2 and +pi/2 will instead correspond to the negative and + positive Z direction, and latitude 0, longitude 0 will instead point into + the negative Y direction in 3D space. +""" +) +{ + float guideRadius = 100000 ( + displayGroup = "Guides" + displayName = "Radius" + doc = "The radius of guide geometry to use to visualize the dome light. The default is 1 km for scenes whose metersPerUnit is the USD default of 0.01 (i.e., 1 world unit is 1 cm)." + ) + asset inputs:texture:file ( + displayGroup = "Basic" + displayName = "Color Map" + doc = """A color texture to use on the dome, such as an HDR (high + dynamic range) texture intended for IBL (image based lighting).""" + ) + token inputs:texture:format = "automatic" ( + allowedTokens = ["automatic", "latlong", "mirroredBall", "angular", "cubeMapVerticalCross"] + displayGroup = "Basic" + displayName = "Color Map Format" + doc = """Specifies the parameterization of the color map file. + Valid values are: + - automatic: Tries to determine the layout from the file itself. + For example, Renderman texture files embed an explicit + parameterization. + - latlong: Latitude as X, longitude as Y. + - mirroredBall: An image of the environment reflected in a + sphere, using an implicitly orthogonal projection. + - angular: Similar to mirroredBall but the radial dimension + is mapped linearly to the angle, providing better sampling + at the edges. + - cubeMapVerticalCross: A cube map with faces laid out as a + vertical cross. + """ + ) + uniform token light:shaderId = "DomeLight" + uniform token poleAxis = "scene" ( + allowedTokens = ["scene", "Y", "Z"] + displayGroup = "Advanced" + displayName = "Pole Axis" + doc = """A token which indicates the starting alignment of the dome + light's top pole. This alignment is for the dome itself and is *not* + inherited by the namespace children of the dome. + Valid values are: + - scene: The dome light's top pole is aligned with the stage's up axis. + - Y: The dome light's top pole is aligned with the +Y axis. + - Z: The dome light's top pole is aligned with the +Z axis. + """ + ) + rel portals ( + doc = "Optional portals to guide light sampling." + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class PortalLight "PortalLight" ( + apiSchemas = ["LightAPI"] + customData = { + token[] apiSchemaOverridePropertyNames = ["light:shaderId"] + } + doc = """A rectangular portal in the local XY plane that guides sampling + of a dome light. Transmits light in the -Z direction. + The rectangle is 1 unit in length.""" +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + float inputs:height = 1 ( + displayGroup = "Geometry" + displayName = "Height" + doc = "Height of the portal rectangle in the local Y axis." + ) + float inputs:width = 1 ( + displayGroup = "Geometry" + displayName = "Width" + doc = "Width of the portal rectangle in the local X axis." + ) + uniform token light:shaderId = "PortalLight" + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class PluginLight "PluginLight" ( + apiSchemas = ["NodeDefAPI", "LightAPI"] + doc = """Light that provides properties that allow it to identify an + external SdrShadingNode definition, through UsdShadeNodeDefAPI, that can be + provided to render delegates without the need to provide a schema + definition for the light's type. + + \\see \\ref usdLux_PluginSchemas +""" +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class PluginLightFilter "PluginLightFilter" ( + apiSchemas = ["NodeDefAPI", "CollectionAPI:filterLink"] + customData = { + token[] apiSchemaOverridePropertyNames = ["collection:filterLink:includeRoot"] + } + doc = """Light filter that provides properties that allow it to identify an + external SdrShadingNode definition, through UsdShadeNodeDefAPI, that can be + provided to render delegates without the need to provide a schema + definition for the light filter's type. + + \\see \\ref usdLux_PluginSchemas +""" +) +{ + uniform bool collection:filterLink:includeRoot = 1 + uniform token lightFilter:shaderId = "" ( + displayGroup = "Internal" + doc = """Default ID for the light filter's shader. + This defines the shader ID for this light filter when a render context + specific shader ID is not available. + + \\see GetShaderId + \\see GetShaderIdAttrForRenderContext + \\see SdrRegistry::GetShaderNodeByIdentifier + \\see SdrRegistry::GetShaderNodeByIdentifierAndType + """ + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "Types": { + "UsdLuxBoundableLightBase": { + "alias": { + "UsdSchemaBase": "BoundableLightBase" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomBoundable" + ], + "schemaKind": "abstractTyped" + }, + "UsdLuxCylinderLight": { + "alias": { + "UsdSchemaBase": "CylinderLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxBoundableLightBase" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdLuxDiskLight": { + "alias": { + "UsdSchemaBase": "DiskLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxBoundableLightBase" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdLuxDistantLight": { + "alias": { + "UsdSchemaBase": "DistantLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxNonboundableLightBase" + ], + "schemaKind": "concreteTyped" + }, + "UsdLuxDomeLight": { + "alias": { + "UsdSchemaBase": "DomeLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxNonboundableLightBase" + ], + "schemaKind": "concreteTyped" + }, + "UsdLuxDomeLight_1": { + "alias": { + "UsdSchemaBase": "DomeLight_1" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxNonboundableLightBase" + ], + "schemaKind": "concreteTyped" + }, + "UsdLuxGeometryLight": { + "alias": { + "UsdSchemaBase": "GeometryLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxNonboundableLightBase" + ], + "schemaKind": "concreteTyped" + }, + "UsdLuxLightAPI": { + "alias": { + "UsdSchemaBase": "LightAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "providesUsdShadeConnectableAPIBehavior": true, + "schemaKind": "singleApplyAPI" + }, + "UsdLuxLightFilter": { + "alias": { + "UsdSchemaBase": "LightFilter" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "providesUsdShadeConnectableAPIBehavior": true, + "schemaKind": "concreteTyped" + }, + "UsdLuxLightListAPI": { + "alias": { + "UsdSchemaBase": "LightListAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdLuxListAPI": { + "alias": { + "UsdSchemaBase": "ListAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdLuxMeshLightAPI": { + "alias": { + "UsdSchemaBase": "MeshLightAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdLuxNonboundableLightBase": { + "alias": { + "UsdSchemaBase": "NonboundableLightBase" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "schemaKind": "abstractTyped" + }, + "UsdLuxPluginLight": { + "alias": { + "UsdSchemaBase": "PluginLight" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "schemaKind": "concreteTyped" + }, + "UsdLuxPluginLightFilter": { + "alias": { + "UsdSchemaBase": "PluginLightFilter" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxLightFilter" + ], + "schemaKind": "concreteTyped" + }, + "UsdLuxPortalLight": { + "alias": { + "UsdSchemaBase": "PortalLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxBoundableLightBase" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdLuxRectLight": { + "alias": { + "UsdSchemaBase": "RectLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxBoundableLightBase" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdLuxShadowAPI": { + "alias": { + "UsdSchemaBase": "ShadowAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdLuxShapingAPI": { + "alias": { + "UsdSchemaBase": "ShapingAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdLuxSphereLight": { + "alias": { + "UsdSchemaBase": "SphereLight" + }, + "autoGenerated": true, + "bases": [ + "UsdLuxBoundableLightBase" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdLuxVolumeLightAPI": { + "alias": { + "UsdSchemaBase": "VolumeLightAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdLux_DiscoveryPlugin": { + "bases": [ + "NdrDiscoveryPlugin" + ] + }, + "UsdLux_LightDefParserPlugin": { + "bases": [ + "NdrParserPlugin" + ] + } + } + }, + "LibraryPath": "", + "Name": "usdLux", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + "This file describes the USD Lux light schemata for code generation." + subLayers = [ + @usdGeom/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdLux" + string libraryPath = "pxr/usd/usdLux" + dictionary libraryTokens = { + dictionary lightLink = { + string doc = """ + This token represents the collection name to use + with UsdCollectionAPI to represent light-linking + of a prim with an applied UsdLuxLightAPI. + """ + } + dictionary shadowLink = { + string doc = """ + This token represents the collection name to use + with UsdCollectionAPI to represent shadow-linking + of a prim with an applied UsdLuxLightAPI. + """ + } + dictionary filterLink = { + string doc = """ + This token represents the collection name to use + with UsdCollectionAPI to represent filter-linking + of a UsdLuxLightFilter prim. + """ + } + dictionary orientToStageUpAxis = { + string doc = """ + This token represents the suffix for a UsdGeomXformOp + used to orient a light with the stage's up axis. + """ + } + } + } +) +{ +} + +class "LightAPI" ( + inherits = + doc = """API schema that imparts the quality of being a light onto a prim. + + A light is any prim that has this schema applied to it. This is true + regardless of whether LightAPI is included as a built-in API of the prim + type (e.g. RectLight or DistantLight) or is applied directly to a Gprim + that should be treated as a light. + + Linking + + Lights can be linked to geometry. Linking controls which geometry + a light illuminates, and which geometry casts shadows from the light. + + Linking is specified as collections (UsdCollectionAPI) which can + be accessed via GetLightLinkCollection() and GetShadowLinkCollection(). + Note that these collections have their includeRoot set to true, + so that lights will illuminate and cast shadows from all objects + by default. To illuminate only a specific set of objects, there + are two options. One option is to modify the collection paths + to explicitly exclude everything else, assuming it is known; + the other option is to set includeRoot to false and explicitly + include the desired objects. These are complementary approaches + that may each be preferable depending on the scenario and how + to best express the intent of the light setup. + """ + customData = { + dictionary extraPlugInfo = { + bool providesUsdShadeConnectableAPIBehavior = 1 + } + string extraIncludes = """ +#include "pxr/usd/usd/collectionAPI.h" +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" """ + } + prepend apiSchemas = ["CollectionAPI:lightLink", "CollectionAPI:shadowLink"] +) { + uniform bool collection:lightLink:includeRoot = 1 ( + customData = { + bool apiSchemaOverride = true + } + ) + uniform bool collection:shadowLink:includeRoot = 1 ( + customData = { + bool apiSchemaOverride = true + } + ) + uniform token light:shaderId = "" ( + displayGroup = "Internal" + doc = """Default ID for the light's shader. + This defines the shader ID for this light when a render context specific + shader ID is not available. + + The default shaderId for the intrinsic UsdLux lights (RectLight, + DistantLight, etc.) are set to default to the light's type name. For + each intrinsic UsdLux light, we will always register an SdrShaderNode in + the SdrRegistry, with the identifier matching the type name and the + source type "USD", that corresponds to the light's inputs. + \\see GetShaderId + \\see GetShaderIdAttrForRenderContext + \\see SdrRegistry::GetShaderNodeByIdentifier + \\see SdrRegistry::GetShaderNodeByIdentifierAndType + """ + customData = { + token apiName = "shaderId" + } + ) + uniform token light:materialSyncMode = "noMaterialResponse" ( + displayGroup = "Geometry" + displayName = "Material Sync Mode" + doc = """For a LightAPI applied to geometry that has a bound Material, + which is entirely or partly emissive, this specifies the relationship + of the Material response to the lighting response. + Valid values are: + - materialGlowTintsLight: All primary and secondary rays see the + emissive/glow response as dictated by the bound Material while the + base color seen by light rays (which is then modulated by all of the + other LightAPI controls) is the multiplication of the color feeding + the emission/glow input of the Material (i.e. its surface or volume + shader) with the scalar or pattern input to *inputs:color*. + This allows the light's color to tint the geometry's glow color while + preserving access to intensity and other light controls as ways to + further modulate the illumination. + - independent: All primary and secondary rays see the emissive/glow + response as dictated by the bound Material, while the base color seen + by light rays is determined solely by *inputs:color*. Note that for + partially emissive geometry (in which some parts are reflective + rather than emissive), a suitable pattern must be connected to the + light's color input, or else the light will radiate uniformly from + the geometry. + - noMaterialResponse: The geometry behaves as if there is no Material + bound at all, i.e. there is no diffuse, specular, or transmissive + response. The base color of light rays is entirely controlled by the + *inputs:color*. This is the standard mode for "canonical" lights in + UsdLux and indicates to renderers that a Material will either never + be bound or can always be ignored. + """ + allowedTokens = ["materialGlowTintsLight", + "independent", + "noMaterialResponse"] + customData = { + token apiName = "materialSyncMode" + } + ) + float inputs:intensity = 1 ( + displayGroup = "Basic" + displayName = "Intensity" + doc = """Scales the power of the light linearly.""" + customData = { + token apiName = "intensity" + } + ) + float inputs:exposure = 0 ( + displayGroup = "Basic" + displayName = "Exposure" + doc = """Scales the power of the light exponentially as a power + of 2 (similar to an F-stop control over exposure). The result + is multiplied against the intensity.""" + customData = { + token apiName = "exposure" + } + ) + float inputs:diffuse = 1.0 ( + displayGroup = "Refine" + displayName = "Diffuse Multiplier" + doc = """A multiplier for the effect of this light on the diffuse + response of materials. This is a non-physical control.""" + customData = { + token apiName = "diffuse" + } + ) + float inputs:specular = 1.0 ( + displayGroup = "Refine" + displayName = "Specular Multiplier" + doc = """A multiplier for the effect of this light on the specular + response of materials. This is a non-physical control.""" + customData = { + token apiName = "specular" + } + ) + bool inputs:normalize = false ( + displayGroup = "Advanced" + displayName = "Normalize Power" + doc = """Normalizes power by the surface area of the light. + This makes it easier to independently adjust the power and shape + of the light, by causing the power to not vary with the area or + angular size of the light.""" + customData = { + token apiName = "normalize" + } + ) + color3f inputs:color = (1, 1, 1) ( + displayGroup = "Basic" + displayName = "Color" + doc = """The color of emitted light, in energy-linear terms.""" + customData = { + token apiName = "color" + } + ) + bool inputs:enableColorTemperature = false ( + displayGroup = "Basic" + displayName = "Enable Color Temperature" + doc = """Enables using colorTemperature.""" + customData = { + token apiName = "enableColorTemperature" + } + ) + float inputs:colorTemperature = 6500 ( + displayGroup = "Basic" + displayName = "Color Temperature" + doc = """Color temperature, in degrees Kelvin, representing the + white point. The default is a common white point, D65. Lower + values are warmer and higher values are cooler. The valid range + is from 1000 to 10000. Only takes effect when + enableColorTemperature is set to true. When active, the + computed result multiplies against the color attribute. + See UsdLuxBlackbodyTemperatureAsRgb().""" + customData = { + token apiName = "colorTemperature" + } + ) + rel light:filters ( + doc = """Relationship to the light filters that apply to this light.""" + customData = { + token apiName = "filters" + } + ) +} + +class "MeshLightAPI" ( + inherits = + doc = """This is the preferred API schema to apply to + \\ref UsdGeomMesh "Mesh" type prims when adding light behaviors to a mesh. + At its base, this API schema has the built-in behavior of applying LightAPI + to the mesh and overriding the default materialSyncMode to allow the + emission/glow of the bound material to affect the color of the light. + But, it additionally serves as a hook for plugins to attach additional + properties to "mesh lights" through the creation of API schemas which are + authored to auto-apply to MeshLightAPI. + \\see \\ref Usd_AutoAppliedAPISchemas + """ + prepend apiSchemas = ["LightAPI"] +) { + uniform token light:shaderId = "MeshLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + uniform token light:materialSyncMode = "materialGlowTintsLight" ( + customData = { + bool apiSchemaOverride = true + } + ) +} + +class "VolumeLightAPI" ( + inherits = + doc = """This is the preferred API schema to apply to + \\ref UsdVolVolume "Volume" type prims when adding light behaviors to a + volume. At its base, this API schema has the built-in behavior of applying + LightAPI to the volume and overriding the default materialSyncMode to allow + the emission/glow of the bound material to affect the color of the light. + But, it additionally serves as a hook for plugins to attach additional + properties to "volume lights" through the creation of API schemas which are + authored to auto-apply to VolumeLightAPI. + \\see \\ref Usd_AutoAppliedAPISchemas + """ + prepend apiSchemas = ["LightAPI"] +) { + uniform token light:shaderId = "VolumeLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + uniform token light:materialSyncMode = "materialGlowTintsLight" ( + customData = { + bool apiSchemaOverride = true + } + ) +} + +class "LightListAPI" ( + inherits = + doc = """API schema to support discovery and publishing of lights in a scene. + + \\section UsdLuxLightListAPI_Discovery Discovering Lights via Traversal + + To motivate this API, consider what is required to discover all + lights in a scene. We must load all payloads and traverse all prims: + + \\code + 01 // Load everything on the stage so we can find all lights, + 02 // including those inside payloads + 03 stage->Load(); + 04 + 05 // Traverse all prims, checking if they have an applied UsdLuxLightAPI + 06 // (Note: ignoring instancing and a few other things for simplicity) + 07 SdfPathVector lights; + 08 for (UsdPrim prim: stage->Traverse()) { + 09 if (prim.HasAPI()) { + 10 lights.push_back(i->GetPath()); + 11 } + 12 } + \\endcode + + This traversal -- suitably elaborated to handle certain details -- + is the first and simplest thing UsdLuxLightListAPI provides. + UsdLuxLightListAPI::ComputeLightList() performs this traversal and returns + all lights in the scene: + + \\code + 01 UsdLuxLightListAPI listAPI(stage->GetPseudoRoot()); + 02 SdfPathVector lights = listAPI.ComputeLightList(); + \\endcode + + \\section UsdLuxLightListAPI_LightList Publishing a Cached Light List + + Consider a USD client that needs to quickly discover lights but + wants to defer loading payloads and traversing the entire scene + where possible, and is willing to do up-front computation and + caching to achieve that. + + UsdLuxLightListAPI provides a way to cache the computed light list, + by publishing the list of lights onto prims in the model + hierarchy. Consider a big set that contains lights: + + \\code + 01 def Xform "BigSetWithLights" ( + 02 kind = "assembly" + 03 payload = @BigSetWithLights.usd@ // Heavy payload + 04 ) { + 05 // Pre-computed, cached list of lights inside payload + 06 rel lightList = [ + 07 <./Lights/light_1>, + 08 <./Lights/light_2>, + 09 ... + 10 ] + 11 token lightList:cacheBehavior = "consumeAndContinue"; + 12 } + \\endcode + + The lightList relationship encodes a set of lights, and the + lightList:cacheBehavior property provides fine-grained + control over how to use that cache. (See details below.) + + The cache can be created by first invoking + ComputeLightList(ComputeModeIgnoreCache) to pre-compute the list + and then storing the result with UsdLuxLightListAPI::StoreLightList(). + + To enable efficient retrieval of the cache, it should be stored + on a model hierarchy prim. Furthermore, note that while you can + use a UsdLuxLightListAPI bound to the pseudo-root prim to query the + lights (as in the example above) because it will perform a + traversal over descendants, you cannot store the cache back to the + pseduo-root prim. + + To consult the cached list, we invoke + ComputeLightList(ComputeModeConsultModelHierarchyCache): + + \\code + 01 // Find and load all lights, using lightList cache where available + 02 UsdLuxLightListAPI list(stage->GetPseudoRoot()); + 03 SdfPathSet lights = list.ComputeLightList( + 04 UsdLuxLightListAPI::ComputeModeConsultModelHierarchyCache); + 05 stage.LoadAndUnload(lights, SdfPathSet()); + \\endcode + + In this mode, ComputeLightList() will traverse the model + hierarchy, accumulating cached light lists. + + \\section UsdLuxLightListAPI_CacheBehavior Controlling Cache Behavior + + The lightList:cacheBehavior property gives additional fine-grained + control over cache behavior: + + \\li The fallback value, "ignore", indicates that the lightList should + be disregarded. This provides a way to invalidate cache entries. + Note that unless "ignore" is specified, a lightList with an empty + list of targets is considered a cache indicating that no lights + are present. + + \\li The value "consumeAndContinue" indicates that the cache should + be consulted to contribute lights to the scene, and that recursion + should continue down the model hierarchy in case additional lights + are added as descedants. This is the default value established when + StoreLightList() is invoked. This behavior allows the lights within + a large model, such as the BigSetWithLights example above, to be + published outside the payload, while also allowing referencing and + layering to add additional lights over that set. + + \\li The value "consumeAndHalt" provides a way to terminate recursive + traversal of the scene for light discovery. The cache will be + consulted but no descendant prims will be examined. + + \\section UsdLuxLightListAPI_Instancing Instancing + + Where instances are present, UsdLuxLightListAPI::ComputeLightList() will + return the instance-unique paths to any lights discovered within + those instances. Lights within a UsdGeomPointInstancer will + not be returned, however, since they cannot be referred to + solely via paths. +""" +) { + rel lightList ( + doc = """Relationship to lights in the scene.""" + ) + token lightList:cacheBehavior ( + doc = """Controls how the lightList should be interpreted. + Valid values are: + - consumeAndHalt: The lightList should be consulted, + and if it exists, treated as a final authoritative statement + of any lights that exist at or below this prim, halting + recursive discovery of lights. + - consumeAndContinue: The lightList should be consulted, + but recursive traversal over nameChildren should continue + in case additional lights are added by descendants. + - ignore: The lightList should be entirely ignored. This + provides a simple way to temporarily invalidate an existing + cache. This is the fallback behavior. + """ + allowedTokens = ["consumeAndHalt", "consumeAndContinue", "ignore"] + ) +} + +class "ListAPI" ( + inherits = + doc = """ + \\deprecated + Use LightListAPI instead +""" +) { + rel lightList ( + doc = """Relationship to lights in the scene.""" + ) + token lightList:cacheBehavior ( + doc = """Controls how the lightList should be interpreted. + Valid values are: + - consumeAndHalt: The lightList should be consulted, + and if it exists, treated as a final authoritative statement + of any lights that exist at or below this prim, halting + recursive discovery of lights. + - consumeAndContinue: The lightList should be consulted, + but recursive traversal over nameChildren should continue + in case additional lights are added by descendants. + - ignore: The lightList should be entirely ignored. This + provides a simple way to temporarily invalidate an existing + cache. This is the fallback behavior. + """ + allowedTokens = ["consumeAndHalt", "consumeAndContinue", "ignore"] + ) +} + +class "ShapingAPI" ( + inherits = + doc = """Controls for shaping a light's emission.""" + customData = { + string extraIncludes = """ +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" """ + } + +) { + float inputs:shaping:focus = 0 ( + displayGroup = "Shaping" + displayName = "Emission Focus" + doc = """A control to shape the spread of light. Higher focus + values pull light towards the center and narrow the spread. + Implemented as an off-axis cosine power exponent. + TODO: clarify semantics""" + customData = { + token apiName = "shaping:focus" + } + ) + color3f inputs:shaping:focusTint = (0, 0, 0) ( + displayGroup = "Shaping" + displayName = "Emission Focus Tint" + doc = """Off-axis color tint. This tints the emission in the + falloff region. The default tint is black. + TODO: clarify semantics""" + customData = { + token apiName = "shaping:focusTint" + } + ) + float inputs:shaping:cone:angle = 90 ( + displayGroup = "Shaping" + displayName = "Cone Angle" + doc = """Angular limit off the primary axis to restrict the + light spread.""" + customData = { + token apiName = "shaping:cone:angle" + } + ) + float inputs:shaping:cone:softness = 0 ( + displayGroup = "Shaping" + displayName = "Cone Softness" + doc = """Controls the cutoff softness for cone angle. + TODO: clarify semantics""" + customData = { + token apiName = "shaping:cone:softness" + } + ) + asset inputs:shaping:ies:file ( + displayGroup = "Shaping" + displayName = "IES Profile" + doc = """An IES (Illumination Engineering Society) light + profile describing the angular distribution of light.""" + customData = { + token apiName = "shaping:ies:file" + } + ) + float inputs:shaping:ies:angleScale = 0 ( + displayGroup = "Shaping" + displayName = "Profile Scale" + doc = """Rescales the angular distribution of the IES profile. + TODO: clarify semantics""" + customData = { + token apiName = "shaping:ies:angleScale" + } + ) + bool inputs:shaping:ies:normalize = false ( + displayGroup = "Shaping" + displayName = "Profile Normalization" + doc = """Normalizes the IES profile so that it affects the shaping + of the light while preserving the overall energy output.""" + customData = { + token apiName = "shaping:ies:normalize" + } + ) +} + +class "ShadowAPI" ( + inherits = + doc = """Controls to refine a light's shadow behavior. These are + non-physical controls that are valuable for visual lighting work.""" + customData = { + string extraIncludes = """ +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" """ + } + +) { + bool inputs:shadow:enable = true ( + displayGroup = "Shadows" + displayName = "Enable Shadows" + doc = """Enables shadows to be cast by this light.""" + customData = { + token apiName = "shadow:enable" + } + ) + color3f inputs:shadow:color = (0, 0, 0) ( + displayGroup = "Shadows" + displayName = "Shadow Color" + doc = """The color of shadows cast by the light. This is a + non-physical control. The default is to cast black shadows.""" + customData = { + token apiName = "shadow:color" + } + ) + float inputs:shadow:distance = -1.0 ( + displayGroup = "Shadows" + displayName = "Shadow Max Distance" + doc = """The maximum distance shadows are cast. The distance is + measured as the distance between the point on the surface and the + occluder. + The default value (-1) indicates no limit. + """ + customData = { + token apiName = "shadow:distance" + } + ) + float inputs:shadow:falloff = -1.0 ( + displayGroup = "Shadows" + displayName = "Shadow Falloff" + doc = """The size of the shadow falloff zone within the shadow max + distance, which can be used to hide the hard cut-off for shadows seen + stretching past the max distance. The falloff zone is the area that + fades from full shadowing at the beginning of the falloff zone to no + shadowing at the max distance from the occluder. The falloff zone + distance cannot exceed the shadow max distance. A falloff value equal + to or less than zero (with -1 as the default) indicates no falloff. + """ + customData = { + token apiName = "shadow:falloff" + } + ) + float inputs:shadow:falloffGamma = 1.0 ( + displayGroup = "Shadows" + displayName = "Shadow Falloff Gamma" + doc = """A gamma (i.e., exponential) control over shadow strength + with linear distance within the falloff zone. This controls the rate + of the falloff. + This requires the use of shadowDistance and shadowFalloff.""" + customData = { + token apiName = "shadow:falloffGamma" + } + ) +} + +class LightFilter "LightFilter" ( + inherits = + doc = """A light filter modifies the effect of a light. + Lights refer to filters via relationships so that filters may be + shared. + + Linking + + Filters can be linked to geometry. Linking controls which geometry + a light-filter affects, when considering the light filters attached + to a light illuminating the geometry. + + Linking is specified as a collection (UsdCollectionAPI) which can + be accessed via GetFilterLinkCollection(). + """ + customData = { + dictionary extraPlugInfo = { + bool providesUsdShadeConnectableAPIBehavior = 1 + } + string extraIncludes = """ +#include "pxr/usd/usd/collectionAPI.h" +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" """ + } + prepend apiSchemas = ["CollectionAPI:filterLink"] +) { + uniform bool collection:filterLink:includeRoot = 1 ( + customData = { + bool apiSchemaOverride = true + } + ) + uniform token lightFilter:shaderId = "" ( + displayGroup = "Internal" + doc = """Default ID for the light filter's shader. + This defines the shader ID for this light filter when a render context + specific shader ID is not available. + + \\see GetShaderId + \\see GetShaderIdAttrForRenderContext + \\see SdrRegistry::GetShaderNodeByIdentifier + \\see SdrRegistry::GetShaderNodeByIdentifierAndType + """ + customData = { + token apiName = "shaderId" + } + ) + +} + +class "BoundableLightBase" ( + inherits = + doc = """Base class for intrinsic lights that are boundable. + + The primary purpose of this class is to provide a direct API to the + functions provided by LightAPI for concrete derived light types. + """ + customData = { + string extraIncludes = """#include "pxr/usd/usdLux/lightAPI.h" """ + } + prepend apiSchemas = ["LightAPI"] +) { +} + +class "NonboundableLightBase" ( + inherits = + doc = """Base class for intrinsic lights that are not boundable. + + The primary purpose of this class is to provide a direct API to the + functions provided by LightAPI for concrete derived light types. + """ + customData = { + string extraIncludes = """#include "pxr/usd/usdLux/lightAPI.h" """ + } + prepend apiSchemas = ["LightAPI"] +) { +} + +class DistantLight "DistantLight" ( + inherits = + doc = """Light emitted from a distant source along the -Z axis. + Also known as a directional light.""" +) { + uniform token light:shaderId = "DistantLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + float inputs:angle = 0.53 ( + displayGroup = "Basic" + displayName = "Angle Extent" + doc = """Angular size of the light in degrees. + As an example, the Sun is approximately 0.53 degrees as seen from Earth. + Higher values broaden the light and therefore soften shadow edges. + """ + customData = { + token apiName = "angle" + } + ) + float inputs:intensity = 50000 ( + doc = """Scales the emission of the light linearly. + The DistantLight has a high default intensity to approximate the Sun.""" + customData = { + token apiName = "intensity" + bool apiSchemaOverride = true + } + ) +} + +class DiskLight "DiskLight" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = 1 + } + } + inherits = + doc = """Light emitted from one side of a circular disk. + The disk is centered in the XY plane and emits light along the -Z axis.""" +) { + uniform token light:shaderId = "DiskLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + float inputs:radius = 0.5 ( + displayGroup = "Geometry" + displayName = "Radius" + doc = "Radius of the disk." + customData = { + token apiName = "radius" + } + ) +} + +class RectLight "RectLight" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = 1 + } + } + inherits = + doc = """Light emitted from one side of a rectangle. + The rectangle is centered in the XY plane and emits light along the -Z axis. + The rectangle is 1 unit in length in the X and Y axis. In the default + position, a texture file's min coordinates should be at (+X, +Y) and + max coordinates at (-X, -Y).""" +) { + uniform token light:shaderId = "RectLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + float inputs:width = 1 ( + displayGroup = "Geometry" + displayName = "Width" + doc = "Width of the rectangle, in the local X axis." + customData = { + token apiName = "width" + } + + ) + float inputs:height = 1 ( + displayGroup = "Geometry" + displayName = "Height" + doc = "Height of the rectangle, in the local Y axis." + customData = { + token apiName = "height" + } + ) + asset inputs:texture:file ( + displayGroup = "Basic" + displayName = "Color Map" + doc = """A color texture to use on the rectangle.""" + customData = { + token apiName = "textureFile" + } + ) +} + +class SphereLight "SphereLight" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = 1 + } + } + inherits = + doc = """Light emitted outward from a sphere.""" +) { + uniform token light:shaderId = "SphereLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + float inputs:radius = 0.5 ( + displayGroup = "Geometry" + displayName = "Radius" + doc = "Radius of the sphere." + customData = { + token apiName = "radius" + } + ) + bool treatAsPoint = false ( + displayGroup = "Advanced" + displayName = "Treat As Point" + doc = """A hint that this light can be treated as a 'point' + light (effectively, a zero-radius sphere) by renderers that + benefit from non-area lighting. Renderers that only support + area lights can disregard this.""" + ) +} + +class CylinderLight "CylinderLight" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = 1 + } + } + inherits = + doc = """Light emitted outward from a cylinder. + The cylinder is centered at the origin and has its major axis on the X axis. + The cylinder does not emit light from the flat end-caps. + """ +) { + uniform token light:shaderId = "CylinderLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + float inputs:length = 1 ( + displayGroup = "Geometry" + displayName = "Length" + doc = "Length of the cylinder, in the local X axis." + customData = { + token apiName = "length" + } + ) + float inputs:radius = 0.5 ( + displayGroup = "Geometry" + displayName = "Radius" + doc = "Radius of the cylinder." + customData = { + token apiName = "radius" + } + ) + bool treatAsLine = false ( + displayGroup = "Advanced" + displayName = "Treat As Line" + doc = """A hint that this light can be treated as a 'line' + light (effectively, a zero-radius cylinder) by renderers that + benefit from non-area lighting. Renderers that only support + area lights can disregard this.""" + ) +} + +class GeometryLight "GeometryLight" ( + inherits = + doc = """\\deprecated + Light emitted outward from a geometric prim (UsdGeomGprim), + which is typically a mesh.""" +) { + rel geometry ( + doc = """Relationship to the geometry to use as the light source.""" + ) + uniform token light:shaderId = "GeometryLight" ( + customData = { + bool apiSchemaOverride = true + } + ) +} + +class DomeLight "DomeLight" ( + inherits = + doc = """Light emitted inward from a distant external environment, + such as a sky or IBL light probe. + + In this version of the dome light, the dome's default orientation is such + that its top pole is aligned with the world's +Y axis. This adheres to the + OpenEXR specification for latlong environment maps. From the OpenEXR + documentation: + + ------------------------------------------------------------------------- + Latitude-Longitude Map: + + The environment is projected onto the image using polar coordinates + (latitude and longitude). A pixel's x coordinate corresponds to + its longitude, and the y coordinate corresponds to its latitude. + Pixel (dataWindow.min.x, dataWindow.min.y) has latitude +pi/2 and + longitude +pi; pixel (dataWindow.max.x, dataWindow.max.y) has + latitude -pi/2 and longitude -pi. + + In 3D space, latitudes -pi/2 and +pi/2 correspond to the negative and + positive y direction. Latitude 0, longitude 0 points into positive + z direction; and latitude 0, longitude pi/2 points into positive x + direction. + + The size of the data window should be 2*N by N pixels (width by height), + where N can be any integer greater than 0. + ------------------------------------------------------------------------- +""" +) { + uniform token light:shaderId = "DomeLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + asset inputs:texture:file ( + displayGroup = "Basic" + displayName = "Color Map" + doc = """A color texture to use on the dome, such as an HDR (high + dynamic range) texture intended for IBL (image based lighting).""" + customData = { + token apiName = "textureFile" + } + ) + token inputs:texture:format = "automatic" ( + displayGroup = "Basic" + displayName = "Color Map Format" + allowedTokens = ["automatic", "latlong", "mirroredBall", "angular", "cubeMapVerticalCross"] + doc = """Specifies the parameterization of the color map file. + Valid values are: + - automatic: Tries to determine the layout from the file itself. + For example, Renderman texture files embed an explicit + parameterization. + - latlong: Latitude as X, longitude as Y. + - mirroredBall: An image of the environment reflected in a + sphere, using an implicitly orthogonal projection. + - angular: Similar to mirroredBall but the radial dimension + is mapped linearly to the angle, providing better sampling + at the edges. + - cubeMapVerticalCross: A cube map with faces laid out as a + vertical cross. + """ + customData = { + token apiName = "textureFormat" + } + ) + rel portals ( + doc = """Optional portals to guide light sampling.""" + ) + float guideRadius = 1.0e5 ( + displayGroup = "Guides" + displayName = "Radius" + doc = """The radius of guide geometry to use to visualize the dome light. The default is 1 km for scenes whose metersPerUnit is the USD default of 0.01 (i.e., 1 world unit is 1 cm).""" + ) +} + +class DomeLight_1 "DomeLight_1" ( + inherits = + doc = """Light emitted inward from a distant external environment, + such as a sky or IBL light probe. + + In this version of the dome light, the dome's default orientation is + determined by its *poleAxis* property. The fallback value, "scene", means + that the dome starts with its top pole aligned with the stage's up axis. + + Note that the rotation necessary to align the dome light with its *poleAxis* + is intended to be applied by a renderer to only the dome itself, and *not* + to inherit down to any USD namespace children of the dome light prim. + + If *poleAxis* is set to "Y" or "scene" and the stage's up axis is "Y", the + dome's default orientation will adhere to the OpenEXR specification for + latlong environment maps. From the OpenEXR documentation: + + ------------------------------------------------------------------------- + Latitude-Longitude Map: + + The environment is projected onto the image using polar coordinates + (latitude and longitude). A pixel's x coordinate corresponds to + its longitude, and the y coordinate corresponds to its latitude. + Pixel (dataWindow.min.x, dataWindow.min.y) has latitude +pi/2 and + longitude +pi; pixel (dataWindow.max.x, dataWindow.max.y) has + latitude -pi/2 and longitude -pi. + + In 3D space, latitudes -pi/2 and +pi/2 correspond to the negative and + positive y direction. Latitude 0, longitude 0 points into positive + z direction; and latitude 0, longitude pi/2 points into positive x + direction. + + The size of the data window should be 2*N by N pixels (width by height), + where N can be any integer greater than 0. + ------------------------------------------------------------------------- + + If *poleAxis* is set to "Z" or "scene" and the stage's up axis is "Z", + latitudes -pi/2 and +pi/2 will instead correspond to the negative and + positive Z direction, and latitude 0, longitude 0 will instead point into + the negative Y direction in 3D space. +""" +) { + uniform token light:shaderId = "DomeLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + asset inputs:texture:file ( + displayGroup = "Basic" + displayName = "Color Map" + doc = """A color texture to use on the dome, such as an HDR (high + dynamic range) texture intended for IBL (image based lighting).""" + customData = { + token apiName = "textureFile" + } + ) + token inputs:texture:format = "automatic" ( + displayGroup = "Basic" + displayName = "Color Map Format" + allowedTokens = ["automatic", "latlong", "mirroredBall", "angular", "cubeMapVerticalCross"] + doc = """Specifies the parameterization of the color map file. + Valid values are: + - automatic: Tries to determine the layout from the file itself. + For example, Renderman texture files embed an explicit + parameterization. + - latlong: Latitude as X, longitude as Y. + - mirroredBall: An image of the environment reflected in a + sphere, using an implicitly orthogonal projection. + - angular: Similar to mirroredBall but the radial dimension + is mapped linearly to the angle, providing better sampling + at the edges. + - cubeMapVerticalCross: A cube map with faces laid out as a + vertical cross. + """ + customData = { + token apiName = "textureFormat" + } + ) + rel portals ( + doc = """Optional portals to guide light sampling.""" + ) + float guideRadius = 1.0e5 ( + displayGroup = "Guides" + displayName = "Radius" + doc = """The radius of guide geometry to use to visualize the dome light. The default is 1 km for scenes whose metersPerUnit is the USD default of 0.01 (i.e., 1 world unit is 1 cm).""" + ) + uniform token poleAxis = "scene" ( + displayGroup = "Advanced" + displayName = "Pole Axis" + allowedTokens = ["scene", "Y", "Z"] + doc = """A token which indicates the starting alignment of the dome + light's top pole. This alignment is for the dome itself and is *not* + inherited by the namespace children of the dome. + Valid values are: + - scene: The dome light's top pole is aligned with the stage's up axis. + - Y: The dome light's top pole is aligned with the +Y axis. + - Z: The dome light's top pole is aligned with the +Z axis. + """ + ) +} + +class PortalLight "PortalLight" ( + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = 1 + } + } + inherits = + doc = """A rectangular portal in the local XY plane that guides sampling + of a dome light. Transmits light in the -Z direction. + The rectangle is 1 unit in length.""" +) { + uniform token light:shaderId = "PortalLight" ( + customData = { + bool apiSchemaOverride = true + } + ) + float inputs:width = 1 ( + displayGroup = "Geometry" + displayName = "Width" + doc = "Width of the portal rectangle in the local X axis." + customData = { + token apiName = "width" + } + + ) + float inputs:height = 1 ( + displayGroup = "Geometry" + displayName = "Height" + doc = "Height of the portal rectangle in the local Y axis." + customData = { + token apiName = "height" + } + ) +} + +class PluginLight "PluginLight" ( + inherits = + doc = """Light that provides properties that allow it to identify an + external SdrShadingNode definition, through UsdShadeNodeDefAPI, that can be + provided to render delegates without the need to provide a schema + definition for the light's type. + + \\see \\ref usdLux_PluginSchemas +""" + prepend apiSchemas = ["NodeDefAPI", "LightAPI"] + customData = { + string extraIncludes = """ +#include "pxr/usd/usdShade/nodeDefAPI.h" """ + } +) { +} + +class PluginLightFilter "PluginLightFilter" ( + inherits = + doc = """Light filter that provides properties that allow it to identify an + external SdrShadingNode definition, through UsdShadeNodeDefAPI, that can be + provided to render delegates without the need to provide a schema + definition for the light filter's type. + + \\see \\ref usdLux_PluginSchemas +""" + prepend apiSchemas = ["NodeDefAPI"] + customData = { + string extraIncludes = """ +#include "pxr/usd/usdShade/nodeDefAPI.h" """ + } +) { +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class "RenderSettingsBase" ( + doc = """Abstract base class that defines render settings that + can be specified on either a RenderSettings prim or a RenderProduct + prim.""" +) +{ + uniform token aspectRatioConformPolicy = "expandAperture" ( + allowedTokens = ["expandAperture", "cropAperture", "adjustApertureWidth", "adjustApertureHeight", "adjustPixelAspectRatio"] + doc = '''Indicates the policy to use to resolve an aspect + ratio mismatch between the camera aperture and image settings. + + This policy allows a standard render setting to do something + reasonable given varying camera inputs. + + The camera aperture aspect ratio is determined by the + aperture atributes on the UsdGeomCamera. + + The image aspect ratio is determined by the resolution and + pixelAspectRatio attributes in the render settings. + + - "expandAperture": if necessary, expand the aperture to + fit the image, exposing additional scene content + - "cropAperture": if necessary, crop the aperture to fit + the image, cropping scene content + - "adjustApertureWidth": if necessary, adjust aperture width + to make its aspect ratio match the image + - "adjustApertureHeight": if necessary, adjust aperture height + to make its aspect ratio match the image + - "adjustPixelAspectRatio": compute pixelAspectRatio to + make the image exactly cover the aperture; disregards + existing attribute value of pixelAspectRatio + ''' + ) + rel camera ( + doc = """The _camera_ relationship specifies the primary + camera to use in a render. It must target a UsdGeomCamera.""" + ) + uniform float4 dataWindowNDC = (0, 0, 1, 1) ( + doc = """dataWindowNDC specifies the axis-aligned rectangular + region in the adjusted aperture window within which the renderer + should produce data. + + It is specified as (xmin, ymin, xmax, ymax) in normalized + device coordinates, where the range 0 to 1 corresponds to the + aperture. (0,0) corresponds to the bottom-left + corner and (1,1) corresponds to the upper-right corner. + + Specifying a window outside the unit square will produce + overscan data. Specifying a window that does not cover the unit + square will produce a cropped render. + + A pixel is included in the rendered result if the pixel + center is contained by the data window. This is consistent + with standard rules used by polygon rasterization engines. + \\ref UsdRenderRasterization + + The data window is expressed in NDC so that cropping and + overscan may be resolution independent. In interactive + workflows, incremental cropping and resolution adjustment + may be intermixed to isolate and examine parts of the scene. + In compositing workflows, overscan may be used to support + image post-processing kernels, and reduced-resolution proxy + renders may be used for faster iteration. + + The dataWindow:ndc coordinate system references the + aperture after any adjustments required by + aspectRatioConformPolicy. + """ + ) + uniform bool disableDepthOfField = 0 ( + doc = """Disable all depth of field by setting F-stop of the targeted + camera to infinity.""" + ) + uniform bool disableMotionBlur = 0 ( + doc = """Disable all motion blur by setting the shutter interval + of the targeted camera to [0,0] - that is, take only one sample, + namely at the current time code.""" + ) + uniform bool instantaneousShutter = 0 ( + doc = """Deprecated - use disableMotionBlur instead. Override + the targeted _camera_'s _shutterClose_ to be equal to the + value of its _shutterOpen_, to produce a zero-width shutter + interval. This gives us a convenient way to disable motion + blur.""" + ) + uniform float pixelAspectRatio = 1 ( + doc = """The aspect ratio (width/height) of image pixels.. + The default ratio 1.0 indicates square pixels.""" + ) + uniform int2 resolution = (2048, 1080) ( + doc = """The image pixel resolution, corresponding to the + camera's screen window.""" + ) +} + +class RenderSettings "RenderSettings" ( + doc = """A UsdRenderSettings prim specifies global settings for + a render process, including an enumeration of the RenderProducts + that should result, and the UsdGeomImageable purposes that should + be rendered. \\ref UsdRenderHowSettingsAffectRendering""" +) +{ + uniform token aspectRatioConformPolicy = "expandAperture" ( + allowedTokens = ["expandAperture", "cropAperture", "adjustApertureWidth", "adjustApertureHeight", "adjustPixelAspectRatio"] + doc = '''Indicates the policy to use to resolve an aspect + ratio mismatch between the camera aperture and image settings. + + This policy allows a standard render setting to do something + reasonable given varying camera inputs. + + The camera aperture aspect ratio is determined by the + aperture atributes on the UsdGeomCamera. + + The image aspect ratio is determined by the resolution and + pixelAspectRatio attributes in the render settings. + + - "expandAperture": if necessary, expand the aperture to + fit the image, exposing additional scene content + - "cropAperture": if necessary, crop the aperture to fit + the image, cropping scene content + - "adjustApertureWidth": if necessary, adjust aperture width + to make its aspect ratio match the image + - "adjustApertureHeight": if necessary, adjust aperture height + to make its aspect ratio match the image + - "adjustPixelAspectRatio": compute pixelAspectRatio to + make the image exactly cover the aperture; disregards + existing attribute value of pixelAspectRatio + ''' + ) + rel camera ( + doc = """The _camera_ relationship specifies the primary + camera to use in a render. It must target a UsdGeomCamera.""" + ) + uniform float4 dataWindowNDC = (0, 0, 1, 1) ( + doc = """dataWindowNDC specifies the axis-aligned rectangular + region in the adjusted aperture window within which the renderer + should produce data. + + It is specified as (xmin, ymin, xmax, ymax) in normalized + device coordinates, where the range 0 to 1 corresponds to the + aperture. (0,0) corresponds to the bottom-left + corner and (1,1) corresponds to the upper-right corner. + + Specifying a window outside the unit square will produce + overscan data. Specifying a window that does not cover the unit + square will produce a cropped render. + + A pixel is included in the rendered result if the pixel + center is contained by the data window. This is consistent + with standard rules used by polygon rasterization engines. + \\ref UsdRenderRasterization + + The data window is expressed in NDC so that cropping and + overscan may be resolution independent. In interactive + workflows, incremental cropping and resolution adjustment + may be intermixed to isolate and examine parts of the scene. + In compositing workflows, overscan may be used to support + image post-processing kernels, and reduced-resolution proxy + renders may be used for faster iteration. + + The dataWindow:ndc coordinate system references the + aperture after any adjustments required by + aspectRatioConformPolicy. + """ + ) + uniform bool disableDepthOfField = 0 ( + doc = """Disable all depth of field by setting F-stop of the targeted + camera to infinity.""" + ) + uniform bool disableMotionBlur = 0 ( + doc = """Disable all motion blur by setting the shutter interval + of the targeted camera to [0,0] - that is, take only one sample, + namely at the current time code.""" + ) + uniform token[] includedPurposes = ["default", "render"] ( + doc = """The list of UsdGeomImageable _purpose_ values that + should be included in the render. Note this cannot be + specified per-RenderProduct because it is a statement of + which geometry is present.""" + ) + uniform bool instantaneousShutter = 0 ( + doc = """Deprecated - use disableMotionBlur instead. Override + the targeted _camera_'s _shutterClose_ to be equal to the + value of its _shutterOpen_, to produce a zero-width shutter + interval. This gives us a convenient way to disable motion + blur.""" + ) + uniform token[] materialBindingPurposes = ["full", ""] ( + allowedTokens = ["full", "preview", ""] + doc = '''Ordered list of material purposes to consider when + resolving material bindings in the scene. The empty string + indicates the "allPurpose" binding.''' + ) + uniform float pixelAspectRatio = 1 ( + doc = """The aspect ratio (width/height) of image pixels.. + The default ratio 1.0 indicates square pixels.""" + ) + rel products ( + doc = """The set of RenderProducts the render should produce. + This relationship should target UsdRenderProduct prims. + If no _products_ are specified, an application should produce + an rgb image according to the RenderSettings configuration, + to a default display or image name.""" + ) + uniform token renderingColorSpace ( + doc = """Describes a renderer's working (linear) colorSpace where all + the renderer/shader math is expected to happen. When no + renderingColorSpace is provided, renderer should use its own default.""" + ) + uniform int2 resolution = (2048, 1080) ( + doc = """The image pixel resolution, corresponding to the + camera's screen window.""" + ) +} + +class RenderVar "RenderVar" ( + doc = """A UsdRenderVar describes a custom data variable for + a render to produce. The prim describes the source of the data, which + can be a shader output or an LPE (Light Path Expression), and also + allows encoding of (generally renderer-specific) parameters that + configure the renderer for computing the variable. + + \\note The name of the RenderVar prim drives the name of the data + variable that the renderer will produce. + + \\note In the future, UsdRender may standardize RenderVar representation + for well-known variables under the sourceType `intrinsic`, + such as _r_, _g_, _b_, _a_, _z_, or _id_. + """ +) +{ + uniform token dataType = "color3f" ( + doc = "The type of this channel, as a USD attribute type." + ) + uniform string sourceName = "" ( + doc = """The renderer should look for an output of this name + as the computed value for the RenderVar.""" + ) + uniform token sourceType = "raw" ( + allowedTokens = ["raw", "primvar", "lpe", "intrinsic"] + doc = '''Indicates the type of the source. + + - "raw": The name should be passed directly to the + renderer. This is the default behavior. + - "primvar": This source represents the name of a primvar. + Some renderers may use this to ensure that the primvar + is provided; other renderers may require that a suitable + material network be provided, in which case this is simply + an advisory setting. + - "lpe": Specifies a Light Path Expression in the + [OSL Light Path Expressions language](https://github.com/imageworks/OpenShadingLanguage/wiki/OSL-Light-Path-Expressions) as the source for + this RenderVar. Some renderers may use extensions to + that syntax, which will necessarily be non-portable. + - "intrinsic": This setting is currently unimplemented, + but represents a future namespace for UsdRender to provide + portable baseline RenderVars, such as camera depth, that + may have varying implementations for each renderer. + ''' + ) +} + +class RenderProduct "RenderProduct" ( + doc = """A UsdRenderProduct describes an image or other + file-like artifact produced by a render. A RenderProduct + combines one or more RenderVars into a file or interactive + buffer. It also provides all the controls established in + UsdRenderSettingsBase as optional overrides to whatever the + owning UsdRenderSettings prim dictates. + + Specific renderers may support additional settings, such + as a way to configure compression settings, filetype metadata, + and so forth. Such settings can be encoded using + renderer-specific API schemas applied to the product prim. + """ +) +{ + uniform token aspectRatioConformPolicy = "expandAperture" ( + allowedTokens = ["expandAperture", "cropAperture", "adjustApertureWidth", "adjustApertureHeight", "adjustPixelAspectRatio"] + doc = '''Indicates the policy to use to resolve an aspect + ratio mismatch between the camera aperture and image settings. + + This policy allows a standard render setting to do something + reasonable given varying camera inputs. + + The camera aperture aspect ratio is determined by the + aperture atributes on the UsdGeomCamera. + + The image aspect ratio is determined by the resolution and + pixelAspectRatio attributes in the render settings. + + - "expandAperture": if necessary, expand the aperture to + fit the image, exposing additional scene content + - "cropAperture": if necessary, crop the aperture to fit + the image, cropping scene content + - "adjustApertureWidth": if necessary, adjust aperture width + to make its aspect ratio match the image + - "adjustApertureHeight": if necessary, adjust aperture height + to make its aspect ratio match the image + - "adjustPixelAspectRatio": compute pixelAspectRatio to + make the image exactly cover the aperture; disregards + existing attribute value of pixelAspectRatio + ''' + ) + rel camera ( + doc = """The _camera_ relationship specifies the primary + camera to use in a render. It must target a UsdGeomCamera.""" + ) + uniform float4 dataWindowNDC = (0, 0, 1, 1) ( + doc = """dataWindowNDC specifies the axis-aligned rectangular + region in the adjusted aperture window within which the renderer + should produce data. + + It is specified as (xmin, ymin, xmax, ymax) in normalized + device coordinates, where the range 0 to 1 corresponds to the + aperture. (0,0) corresponds to the bottom-left + corner and (1,1) corresponds to the upper-right corner. + + Specifying a window outside the unit square will produce + overscan data. Specifying a window that does not cover the unit + square will produce a cropped render. + + A pixel is included in the rendered result if the pixel + center is contained by the data window. This is consistent + with standard rules used by polygon rasterization engines. + \\ref UsdRenderRasterization + + The data window is expressed in NDC so that cropping and + overscan may be resolution independent. In interactive + workflows, incremental cropping and resolution adjustment + may be intermixed to isolate and examine parts of the scene. + In compositing workflows, overscan may be used to support + image post-processing kernels, and reduced-resolution proxy + renders may be used for faster iteration. + + The dataWindow:ndc coordinate system references the + aperture after any adjustments required by + aspectRatioConformPolicy. + """ + ) + uniform bool disableDepthOfField = 0 ( + doc = """Disable all depth of field by setting F-stop of the targeted + camera to infinity.""" + ) + uniform bool disableMotionBlur = 0 ( + doc = """Disable all motion blur by setting the shutter interval + of the targeted camera to [0,0] - that is, take only one sample, + namely at the current time code.""" + ) + uniform bool instantaneousShutter = 0 ( + doc = """Deprecated - use disableMotionBlur instead. Override + the targeted _camera_'s _shutterClose_ to be equal to the + value of its _shutterOpen_, to produce a zero-width shutter + interval. This gives us a convenient way to disable motion + blur.""" + ) + rel orderedVars ( + doc = """Specifies the RenderVars that should be consumed and + combined into the final product. If ordering is relevant to the + output driver, then the ordering of targets in this relationship + provides the order to use.""" + ) + uniform float pixelAspectRatio = 1 ( + doc = """The aspect ratio (width/height) of image pixels.. + The default ratio 1.0 indicates square pixels.""" + ) + token productName = "" ( + doc = """Specifies the name that the output/display driver + should give the product. This is provided as-authored to the + driver, whose responsibility it is to situate the product on a + filesystem or other storage, in the desired location.""" + ) + uniform token productType = "raster" ( + doc = '''The type of output to produce. + The default, "raster", indicates a 2D image. + + \\note In the future, UsdRender may define additional product + types.''' + ) + uniform int2 resolution = (2048, 1080) ( + doc = """The image pixel resolution, corresponding to the + camera's screen window.""" + ) +} + +class RenderPass "RenderPass" ( + apiSchemas = ["CollectionAPI:renderVisibility"] + customData = { + token[] apiSchemaOverridePropertyNames = ["collection:renderVisibility:includeRoot"] + } + doc = """A RenderPass prim encapsulates the necessary information + to generate multipass renders. It houses properties for generating + dependencies and the necessary commands to run to generate renders, as + well as visibility controls for the scene. While RenderSettings + describes the information needed to generate images from a single + invocation of a renderer, RenderPass describes the additional information + needed to generate a time varying set of images. + + There are two consumers of RenderPass prims - a runtime executable that + generates images from usdRender prims, and pipeline specific code that + translates between usdRender prims and the pipeline's resource scheduling + software. We'll refer to the latter as 'job submission code'. + + \\anchor usdRender_renderVisibility + The objects that are relevant to the render is specified via the + renderVisibility collection (UsdCollectionAPI) and can be accessed via + GetRenderVisibilityCollectionAPI(). This collection has includeRoot set to + true so that all objects participate in the render by default. To render + only a specific set of objects, there are two options. One is to modify the + collection paths to explicitly exclude objects that don't participate in + the render, assuming it is known; the other option is to set includeRoot to + false and explicitly include the desired objects. These are complementary + approaches that may each be preferable depending on the scenario. + + The name of the prim is used as the pass's name. + """ +) +{ + uniform bool collection:renderVisibility:includeRoot = 1 + uniform string[] command ( + doc = '''The command to run in order to generate + renders for this pass. The job submission code can use + this to properly send tasks to the job scheduling software + that will generate products. + + The command can contain variables that will be substituted + appropriately during submission, as seen in the example below + with {fileName}. + + For example: + command[0] = "prman" + command[1] = "-progress" + command[2] = "-pixelvariance" + command[3] = "-0.15" + command[4] = "{fileName}" # the fileName property will be substituted + ''' + ) + uniform bool denoise:enable = 0 ( + doc = "When True, this Pass pass should be denoised." + ) + rel denoise:pass ( + doc = """The The UsdRenderDenoisePass prim from which to + source denoise settings. + """ + ) + uniform asset fileName ( + doc = """The asset that contains the rendering prims or other + information needed to render this pass. + """ + ) + rel inputPasses ( + doc = """The set of other Passes that this Pass depends on + in order to be constructed properly. For example, a Pass A + may generate a texture, which is then used as an input to + Pass B. + + By default, usdRender makes some assumptions about the + relationship between this prim and the prims listed in inputPasses. + Namely, when per-frame tasks are generated from these pass prims, + usdRender will assume a one-to-one relationship between tasks + that share their frame number. Consider a pass named 'composite' + whose _inputPasses_ targets a Pass prim named 'beauty`. + By default, each frame for 'composite' will depend on the + same frame from 'beauty': + beauty.1 -> composite.1 + beauty.2 -> composite.2 + etc + + The consumer of this RenderPass graph of inputs will need to resolve + the transitive dependencies. + """ + ) + uniform token passType ( + doc = """A string used to categorize differently structured + or executed types of passes within a customized pipeline. + + For example, when multiple DCC's (e.g. Houdini, Katana, Nuke) + each compute and contribute different Products to a final result, + it may be clearest and most flexible to create a separate + RenderPass for each. + """ + ) + rel renderSource ( + doc = """The source prim to render from. If _fileName_ is not present, + the source is assumed to be a RenderSettings prim present in the current + Usd stage. If fileName is present, the source should be found in the + file there. This relationship might target a string attribute on this + or another prim that identifies the appropriate object in the external + container. + + For example, for a Usd-backed pass, this would point to a RenderSettings + prim. Houdini passes would point to a Rop. Nuke passes would point to + a write node. + """ + ) +} + +class RenderDenoisePass "RenderDenoisePass" ( + doc = """A RenderDenoisePass generates renders via a denoising process. + This may be the same renderer that a pipeline uses for UsdRender, + or may be a separate one. Notably, a RenderDenoisePass requires + another Pass to be present for it to operate. The denoising process + itself is not generative, and requires images inputs to operate. + + As denoising integration varies so widely across pipelines, all + implementation details are left to pipeline-specific prims + that inherit from RenderDenoisePass. + """ +) +{ +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "renderSettingsPrimPath": { + "appliesTo": "layers", + "default": "", + "type": "string" + } + }, + "Types": { + "UsdRenderDenoisePass": { + "alias": { + "UsdSchemaBase": "RenderDenoisePass" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "concreteTyped" + }, + "UsdRenderPass": { + "alias": { + "UsdSchemaBase": "RenderPass" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "concreteTyped" + }, + "UsdRenderProduct": { + "alias": { + "UsdSchemaBase": "RenderProduct" + }, + "autoGenerated": true, + "bases": [ + "UsdRenderSettingsBase" + ], + "schemaKind": "concreteTyped" + }, + "UsdRenderSettings": { + "alias": { + "UsdSchemaBase": "RenderSettings" + }, + "autoGenerated": true, + "bases": [ + "UsdRenderSettingsBase" + ], + "schemaKind": "concreteTyped" + }, + "UsdRenderSettingsBase": { + "alias": { + "UsdSchemaBase": "RenderSettingsBase" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "abstractTyped" + }, + "UsdRenderVar": { + "alias": { + "UsdSchemaBase": "RenderVar" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "concreteTyped" + } + } + }, + "LibraryPath": "", + "Name": "usdRender", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + "This file describes the USD Render schemata for code generation." + subLayers = [ + @usd/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdRender" + string libraryPath = "pxr/usd/usdRender" + dictionary libraryTokens = { + dictionary renderSettingsPrimPath = { + string doc = """Stage-level metadata that encodes the + path to UsdRenderSettingsPrim to use for rendering.""" + } + dictionary renderVisibility = { + string doc = """ + This token represents the collection name to use + with UsdCollectionAPI to represent renderVisibility + of a RenderPass prim. + """ + } + } + } +) +{ +} + +class "RenderSettingsBase" ( + inherits = + doc = """Abstract base class that defines render settings that + can be specified on either a RenderSettings prim or a RenderProduct + prim.""" + customData = { + string className = "SettingsBase" + } +) +{ + rel camera ( + doc = """The _camera_ relationship specifies the primary + camera to use in a render. It must target a UsdGeomCamera.""" + ) + uniform int2 resolution = (2048, 1080) ( + doc = """The image pixel resolution, corresponding to the + camera's screen window.""" + ) + uniform float pixelAspectRatio = 1.0 ( + doc = """The aspect ratio (width/height) of image pixels.. + The default ratio 1.0 indicates square pixels.""" + ) + uniform token aspectRatioConformPolicy = "expandAperture" ( + doc = """Indicates the policy to use to resolve an aspect + ratio mismatch between the camera aperture and image settings. + + This policy allows a standard render setting to do something + reasonable given varying camera inputs. + + The camera aperture aspect ratio is determined by the + aperture atributes on the UsdGeomCamera. + + The image aspect ratio is determined by the resolution and + pixelAspectRatio attributes in the render settings. + + - "expandAperture": if necessary, expand the aperture to + fit the image, exposing additional scene content + - "cropAperture": if necessary, crop the aperture to fit + the image, cropping scene content + - "adjustApertureWidth": if necessary, adjust aperture width + to make its aspect ratio match the image + - "adjustApertureHeight": if necessary, adjust aperture height + to make its aspect ratio match the image + - "adjustPixelAspectRatio": compute pixelAspectRatio to + make the image exactly cover the aperture; disregards + existing attribute value of pixelAspectRatio + """ + allowedTokens = ["expandAperture", "cropAperture", "adjustApertureWidth", "adjustApertureHeight", "adjustPixelAspectRatio"] + ) + uniform float4 dataWindowNDC = (0.0, 0.0, 1.0, 1.0) ( + doc = """dataWindowNDC specifies the axis-aligned rectangular + region in the adjusted aperture window within which the renderer + should produce data. + + It is specified as (xmin, ymin, xmax, ymax) in normalized + device coordinates, where the range 0 to 1 corresponds to the + aperture. (0,0) corresponds to the bottom-left + corner and (1,1) corresponds to the upper-right corner. + + Specifying a window outside the unit square will produce + overscan data. Specifying a window that does not cover the unit + square will produce a cropped render. + + A pixel is included in the rendered result if the pixel + center is contained by the data window. This is consistent + with standard rules used by polygon rasterization engines. + \\ref UsdRenderRasterization + + The data window is expressed in NDC so that cropping and + overscan may be resolution independent. In interactive + workflows, incremental cropping and resolution adjustment + may be intermixed to isolate and examine parts of the scene. + In compositing workflows, overscan may be used to support + image post-processing kernels, and reduced-resolution proxy + renders may be used for faster iteration. + + The dataWindow:ndc coordinate system references the + aperture after any adjustments required by + aspectRatioConformPolicy. + """ + ) + uniform bool instantaneousShutter = false ( + doc = """Deprecated - use disableMotionBlur instead. Override + the targeted _camera_'s _shutterClose_ to be equal to the + value of its _shutterOpen_, to produce a zero-width shutter + interval. This gives us a convenient way to disable motion + blur.""" + ) + uniform bool disableMotionBlur = false ( + doc = """Disable all motion blur by setting the shutter interval + of the targeted camera to [0,0] - that is, take only one sample, + namely at the current time code.""" + ) + uniform bool disableDepthOfField = false ( + doc = """Disable all depth of field by setting F-stop of the targeted + camera to infinity.""" + ) +} + +class RenderSettings "RenderSettings" ( + inherits = + doc = """A UsdRenderSettings prim specifies global settings for + a render process, including an enumeration of the RenderProducts + that should result, and the UsdGeomImageable purposes that should + be rendered. \\ref UsdRenderHowSettingsAffectRendering""" + customData = { + string className = "Settings" + } +) +{ + rel products ( + doc = """The set of RenderProducts the render should produce. + This relationship should target UsdRenderProduct prims. + If no _products_ are specified, an application should produce + an rgb image according to the RenderSettings configuration, + to a default display or image name.""" + ) + uniform token[] includedPurposes = ["default", "render"] ( + doc = """The list of UsdGeomImageable _purpose_ values that + should be included in the render. Note this cannot be + specified per-RenderProduct because it is a statement of + which geometry is present.""" + ) + uniform token[] materialBindingPurposes = ["full", ""] ( + allowedTokens = ["full", "preview", ""] + doc = """Ordered list of material purposes to consider when + resolving material bindings in the scene. The empty string + indicates the "allPurpose" binding.""" + ) + uniform token renderingColorSpace ( + doc = """Describes a renderer's working (linear) colorSpace where all + the renderer/shader math is expected to happen. When no + renderingColorSpace is provided, renderer should use its own default.""" + ) +} + +class RenderVar "RenderVar" ( + inherits = + doc = """A UsdRenderVar describes a custom data variable for + a render to produce. The prim describes the source of the data, which + can be a shader output or an LPE (Light Path Expression), and also + allows encoding of (generally renderer-specific) parameters that + configure the renderer for computing the variable. + + \\note The name of the RenderVar prim drives the name of the data + variable that the renderer will produce. + + \\note In the future, UsdRender may standardize RenderVar representation + for well-known variables under the sourceType `intrinsic`, + such as _r_, _g_, _b_, _a_, _z_, or _id_. + """ + customData = { + string className = "Var" + } +) { + uniform token dataType = "color3f" ( + doc = """The type of this channel, as a USD attribute type.""" + ) + uniform string sourceName = "" ( + doc = """The renderer should look for an output of this name + as the computed value for the RenderVar.""" + ) + uniform token sourceType = "raw" ( + doc = """Indicates the type of the source. + + - "raw": The name should be passed directly to the + renderer. This is the default behavior. + - "primvar": This source represents the name of a primvar. + Some renderers may use this to ensure that the primvar + is provided; other renderers may require that a suitable + material network be provided, in which case this is simply + an advisory setting. + - "lpe": Specifies a Light Path Expression in the + [OSL Light Path Expressions language](https://github.com/imageworks/OpenShadingLanguage/wiki/OSL-Light-Path-Expressions) as the source for + this RenderVar. Some renderers may use extensions to + that syntax, which will necessarily be non-portable. + - "intrinsic": This setting is currently unimplemented, + but represents a future namespace for UsdRender to provide + portable baseline RenderVars, such as camera depth, that + may have varying implementations for each renderer. + """ + allowedTokens = ["raw", "primvar", "lpe", "intrinsic"] + ) +} + +class RenderProduct "RenderProduct" ( + inherits = + doc = """A UsdRenderProduct describes an image or other + file-like artifact produced by a render. A RenderProduct + combines one or more RenderVars into a file or interactive + buffer. It also provides all the controls established in + UsdRenderSettingsBase as optional overrides to whatever the + owning UsdRenderSettings prim dictates. + + Specific renderers may support additional settings, such + as a way to configure compression settings, filetype metadata, + and so forth. Such settings can be encoded using + renderer-specific API schemas applied to the product prim. + """ + customData = { + string className = "Product" + dictionary schemaTokens = { + dictionary raster = { + string doc = """RenderProduct productType value that + indicates a 2D raster image of pixels.""" + } + } + } +) { + uniform token productType = "raster" ( + doc = """The type of output to produce. + The default, "raster", indicates a 2D image. + + \\note In the future, UsdRender may define additional product + types.""" + ) + token productName = "" ( + doc = """Specifies the name that the output/display driver + should give the product. This is provided as-authored to the + driver, whose responsibility it is to situate the product on a + filesystem or other storage, in the desired location.""" + ) + rel orderedVars ( + doc = """Specifies the RenderVars that should be consumed and + combined into the final product. If ordering is relevant to the + output driver, then the ordering of targets in this relationship + provides the order to use.""" + ) +} + + +class RenderPass "RenderPass" ( + inherits = + doc = """A RenderPass prim encapsulates the necessary information + to generate multipass renders. It houses properties for generating + dependencies and the necessary commands to run to generate renders, as + well as visibility controls for the scene. While RenderSettings + describes the information needed to generate images from a single + invocation of a renderer, RenderPass describes the additional information + needed to generate a time varying set of images. + + There are two consumers of RenderPass prims - a runtime executable that + generates images from usdRender prims, and pipeline specific code that + translates between usdRender prims and the pipeline's resource scheduling + software. We'll refer to the latter as 'job submission code'. + + \\anchor usdRender_renderVisibility + The objects that are relevant to the render is specified via the + renderVisibility collection (UsdCollectionAPI) and can be accessed via + GetRenderVisibilityCollectionAPI(). This collection has includeRoot set to + true so that all objects participate in the render by default. To render + only a specific set of objects, there are two options. One is to modify the + collection paths to explicitly exclude objects that don't participate in + the render, assuming it is known; the other option is to set includeRoot to + false and explicitly include the desired objects. These are complementary + approaches that may each be preferable depending on the scenario. + + The name of the prim is used as the pass's name. + """ + customData = { + string className = "Pass" + string extraIncludes = """ +#include "pxr/usd/usd/collectionAPI.h" """ + } + prepend apiSchemas = ["CollectionAPI:renderVisibility"] +) { + uniform token passType ( + doc = """A string used to categorize differently structured + or executed types of passes within a customized pipeline. + + For example, when multiple DCC's (e.g. Houdini, Katana, Nuke) + each compute and contribute different Products to a final result, + it may be clearest and most flexible to create a separate + RenderPass for each. + """ + ) + + uniform string[] command ( + doc = """The command to run in order to generate + renders for this pass. The job submission code can use + this to properly send tasks to the job scheduling software + that will generate products. + + The command can contain variables that will be substituted + appropriately during submission, as seen in the example below + with {fileName}. + + For example: + command[0] = "prman" + command[1] = "-progress" + command[2] = "-pixelvariance" + command[3] = "-0.15" + command[4] = "{fileName}" # the fileName property will be substituted + """ + ) + + rel renderSource ( + doc = """The source prim to render from. If _fileName_ is not present, + the source is assumed to be a RenderSettings prim present in the current + Usd stage. If fileName is present, the source should be found in the + file there. This relationship might target a string attribute on this + or another prim that identifies the appropriate object in the external + container. + + For example, for a Usd-backed pass, this would point to a RenderSettings + prim. Houdini passes would point to a Rop. Nuke passes would point to + a write node. + """ + ) + + rel inputPasses ( + doc = """The set of other Passes that this Pass depends on + in order to be constructed properly. For example, a Pass A + may generate a texture, which is then used as an input to + Pass B. + + By default, usdRender makes some assumptions about the + relationship between this prim and the prims listed in inputPasses. + Namely, when per-frame tasks are generated from these pass prims, + usdRender will assume a one-to-one relationship between tasks + that share their frame number. Consider a pass named 'composite' + whose _inputPasses_ targets a Pass prim named 'beauty`. + By default, each frame for 'composite' will depend on the + same frame from 'beauty': + beauty.1 -> composite.1 + beauty.2 -> composite.2 + etc + + The consumer of this RenderPass graph of inputs will need to resolve + the transitive dependencies. + """ + ) + + uniform asset fileName ( + doc = """The asset that contains the rendering prims or other + information needed to render this pass. + """ + ) + + uniform bool denoise:enable = false ( + doc = """When True, this Pass pass should be denoised.""" + ) + + rel denoise:pass ( + doc = """The The UsdRenderDenoisePass prim from which to + source denoise settings. + """ + ) + + uniform bool collection:renderVisibility:includeRoot = 1 ( + customData = { + bool apiSchemaOverride = true + } + ) +} + + +class RenderDenoisePass "RenderDenoisePass" ( + inherits = + doc = """A RenderDenoisePass generates renders via a denoising process. + This may be the same renderer that a pipeline uses for UsdRender, + or may be a separate one. Notably, a RenderDenoisePass requires + another Pass to be present for it to operate. The denoising process + itself is not generative, and requires images inputs to operate. + + As denoising integration varies so widely across pipelines, all + implementation details are left to pipeline-specific prims + that inherit from RenderDenoisePass. + """ + customData = { + string className = "DenoisePass" + } +) { +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class NodeGraph "NodeGraph" ( + doc = '''A node-graph is a container for shading nodes, as well as other + node-graphs. It has a public input interface and provides a list of public + outputs. + + Node Graph Interfaces + + One of the most important functions of a node-graph is to host the "interface" + with which clients of already-built shading networks will interact. Please + see "Interface Inputs" for a detailed + explanation of what the interface provides, and how to construct and + use it, to effectively share/instance shader networks. + + Node Graph Outputs + + These behave like outputs on a shader and are typically connected to an + output on a shader inside the node-graph. + ''' +) +{ +} + +class Material "Material" ( + doc = """A Material provides a container into which multiple \"render contexts\" + can add data that defines a \"shading material\" for a renderer. Typically + this consists of one or more UsdShadeOutput properties connected to outputs + of nested Shader prims - though a context/client is free to add + any data that is suitable. We strongly advise that all contexts + adopt the convention that all properties be prefixed with a namespace + that identifies the context e.g. \"token outputs:ri:surface.connect = + resolved Material that will be used to shade the gprim (exceptions, + of course, for gprims that possess UsdGeomSubsets, as each subset can be + shaded by a different Material). A gprim and each of its ancestor + prims can possess, through the MaterialBindingAPI, both a + direct binding to a Material, and any number of + collection-based bindings to Materials; each binding can be generic + or declared for a particular purpose, and given a specific binding + strength. It is the process of \"material resolution\" (see + that examines all of + these bindings, and selects the one Material that best matches the + client's needs. + + The intent of purpose is that each gprim should be able to resolve a + Material for any given purpose, which implies it can have differently bound + materials for different purposes. There are two special values of + purpose defined in UsdShade, although the API fully supports + specifying arbitrary values for it, for the sake of extensibility: +
  • UsdShadeTokens->full: to be used when the purpose of the + render is entirely to visualize the truest representation of a scene, + considering all lighting and material information, at highest fidelity.
    • +
  • UsdShadeTokens->preview: to be used when the render is in + service of a goal other than a high fidelity \"full\" render (such as scene + manipulation, modeling, or realtime playback). Latency and speed are + generally of greater concern for preview renders, therefore preview + materials are generally designed to be \"lighterweight\" compared to full + materials.
+ A binding can also have no specific purpose at all, in which + case, it is considered to be the fallback or all-purpose binding (denoted + by the empty-valued token UsdShadeTokens->allPurpose). + + The purpose of a material binding is encoded in the name of the + binding relationship. +
  • + In the case of a direct binding, the allPurpose binding is + represented by the relationship named material:binding. + Special-purpose direct bindings are represented by relationships named + material:binding:purpose. A direct binding relationship + must have a single target path that points to a UsdShadeMaterial.
    • +
  • + In the case of a collection-based binding, the allPurpose binding is + represented by a relationship named + material:binding:collection:bindingName, where + bindingName establishes an identity for the binding that is unique + on the prim. Attempting to establish two collection bindings of the same + name on the same prim will result in the first binding simply being + overridden. A special-purpose collection-based binding is represented by a + relationship named material:binding:collection:purpose:bindingName. + A collection-based binding relationship must have exacly two targets, one of + which should be a collection-path (see + and the other should point to a + UsdShadeMaterial. In the future, we may allow a single collection + binding to target multiple collections, if we can establish a reasonable + round-tripping pattern for applications that only allow a single collection + to be associated with each Material. +
    • +
+ + Note: Both bindingName and purpose must be + non-namespaced tokens. This allows us to know the role of a binding + relationship simply from the number of tokens in it. +
  • Two tokens: the fallback, \"all purpose\", direct binding, + material:binding
    • +
  • Three tokens: a purpose-restricted, direct, fallback binding, + e.g. material:binding:preview
    • +
  • Four tokens: an all-purpose, collection-based binding, e.g. + material:binding:collection:metalBits
    • +
  • Five tokens: a purpose-restricted, collection-based binding, + e.g. material:binding:collection:full:metalBits
    • +
+ + A binding-strength value is used to specify whether a binding + authored on a prim should be weaker or stronger than bindings that appear + lower in namespace. We encode the binding strength with as token-valued + metadata 'bindMaterialAs' for future flexibility, even though for + now, there are only two possible values: + UsdShadeTokens->weakerThanDescendants and + UsdShadeTokens->strongerThanDescendants. When binding-strength is + not authored (i.e. empty) on a binding-relationship, the default behavior + matches UsdShadeTokens->weakerThanDescendants. + + \\note If a material binding relationship is a built-in property defined as + part of a typed prim's schema, a fallback value should not be provided for + it. This is because the \"material resolution\" algorithm only conisders + authored properties. + """ +) +{ +} + +class "CoordSysAPI" ( + doc = '''UsdShadeCoordSysAPI provides a way to designate, name, + and discover coordinate systems. + + Coordinate systems are implicitly established by UsdGeomXformable + prims, using their local space. That coordinate system may be + bound (i.e., named) from another prim. The binding is encoded + as a single-target relationship. + Coordinate system bindings apply to descendants of the prim + where the binding is expressed, but names may be re-bound by + descendant prims. + + CoordSysAPI is a multi-apply API schema, where instance names + signify the named coordinate systems. The instance names are + used with the "coordSys:" namespace to determine the binding + to the UsdGeomXformable prim. + + Named coordinate systems are useful in shading (and other) workflows. + An example is projection paint, which projects a texture + from a certain view (the paint coordinate system), encoded as + (e.g.) "rel coordSys:paint:binding". Using the paint coordinate frame + avoids the need to assign a UV set to the object, and can be a + concise way to project paint across a collection of objects with + a single shared paint coordinate system. + ''' +) +{ + rel coordSys:__INSTANCE_NAME__:binding ( + displayName = "Bound Coordinate System" + doc = "Prim binding expressing the appropriate coordinate systems." + ) +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "bindMaterialAs": { + "appliesTo": [ + "relationships" + ], + "displayGroup": "Shading", + "documentation": "Metadata authored on collection-based material binding relationship to indicate the strength of the binding relative to bindings authored on descendant prims.", + "type": "token" + }, + "connectability": { + "appliesTo": [ + "attributes" + ], + "default": "full", + "displayGroup": "Shading", + "documentation": "Metadata authored on UsdShadeInput's to specify what they can be connected to. Can be either \"full\" or \"interfaceOnly\". \"full\" implies that the input can be connected to any other input or output. \"interfaceOnly\" implies that the input can only connect to a NodeGraph Input (which represents an interface override, not a render-time dataflow connection), or another Input whose connectability is also \"interfaceOnly\".", + "type": "token" + }, + "outputName": { + "appliesTo": [ + "relationships" + ], + "displayGroup": "deprecated", + "type": "token" + }, + "renderType": { + "appliesTo": [ + "properties" + ], + "displayGroup": "Rendering", + "type": "token" + }, + "sdrMetadata": { + "appliesTo": [ + "prims", + "attributes" + ], + "displayGroup": "Shading", + "type": "dictionary" + } + }, + "Types": { + "UsdShadeConnectableAPI": { + "alias": { + "UsdSchemaBase": "ConnectableAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "nonAppliedAPI" + }, + "UsdShadeCoordSysAPI": { + "alias": { + "UsdSchemaBase": "CoordSysAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "multipleApplyAPI" + }, + "UsdShadeMaterial": { + "alias": { + "UsdSchemaBase": "Material" + }, + "autoGenerated": true, + "bases": [ + "UsdShadeNodeGraph" + ], + "providesUsdShadeConnectableAPIBehavior": true, + "schemaKind": "concreteTyped" + }, + "UsdShadeMaterialBindingAPI": { + "alias": { + "UsdSchemaBase": "MaterialBindingAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdShadeNodeDefAPI": { + "alias": { + "UsdSchemaBase": "NodeDefAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdShadeNodeGraph": { + "alias": { + "UsdSchemaBase": "NodeGraph" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "providesUsdShadeConnectableAPIBehavior": true, + "schemaKind": "concreteTyped" + }, + "UsdShadeShader": { + "alias": { + "UsdSchemaBase": "Shader" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "providesUsdShadeConnectableAPIBehavior": true, + "schemaKind": "concreteTyped" + }, + "UsdShadeShaderDefParserPlugin": { + "bases": [ + "NdrParserPlugin" + ], + "displayName": "USD-based shader definition parser plugin" + } + } + }, + "LibraryPath": "", + "Name": "usdShade", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + "This file describes the USD Shader schemata for code generation." + subLayers = [ + @usd/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdShade" + string libraryPath = "pxr/usd/usdShade" + dictionary libraryTokens = { + dictionary materialBind = { + string doc = """The name of the GeomSubset family used to + identify face subsets defined for the purpose of binding + materials to facesets. + """ + } + dictionary full = { + string doc= """Possible value for 'connectability' metadata on + a UsdShadeInput. When connectability of an input is set to + "full", it implies that it can be connected to any input or + output. + """ + } + dictionary interfaceOnly = { + string doc= """Possible value for 'connectability' metadata on + a UsdShadeInput. It implies that the input can only connect to + a NodeGraph Input (which represents an interface override, not + a render-time dataflow connection), or another Input whose + connectability is also 'interfaceOnly'. + """ + } + dictionary outputs = { + string value = "outputs:" + string doc = """The prefix on shading attributes + denoting an output. + """ + } + dictionary inputs = { + string value = "inputs:" + string doc = """The prefix on shading attributes + denoting an input. + """ + } + } + } +) +{ +} + +class NodeGraph "NodeGraph" ( + inherits = + doc = """A node-graph is a container for shading nodes, as well as other + node-graphs. It has a public input interface and provides a list of public + outputs. + + Node Graph Interfaces + + One of the most important functions of a node-graph is to host the "interface" + with which clients of already-built shading networks will interact. Please + see \\ref UsdShadeNodeGraph_Interfaces "Interface Inputs" for a detailed + explanation of what the interface provides, and how to construct and + use it, to effectively share/instance shader networks. + + Node Graph Outputs + + These behave like outputs on a shader and are typically connected to an + output on a shader inside the node-graph. + """ + customData = { + dictionary extraPlugInfo = { + bool providesUsdShadeConnectableAPIBehavior = 1 + } + string extraIncludes = ''' +#include +#include "pxr/usd/usd/editTarget.h" +#include "pxr/usd/usd/relationship.h" +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" +#include "pxr/usd/usdShade/shader.h" +#include "pxr/usd/usdShade/connectableAPIBehavior.h"''' + } +) { + +} + + +class Material "Material" ( + inherits = + doc = """A Material provides a container into which multiple "render contexts" + can add data that defines a "shading material" for a renderer. Typically + this consists of one or more UsdShadeOutput properties connected to outputs + of nested Shader prims - though a context/client is free to add + any data that is suitable. We strongly advise that all contexts + adopt the convention that all properties be prefixed with a namespace + that identifies the context e.g. "token outputs:ri:surface.connect = + surface output + terminal on a UsdShadeMaterial. It is used to define the + terminal UsdShadeShader describing the surface of a + UsdShadeMaterial. + """ + } + dictionary displacement = { + string doc = """Describes the displacement output + terminal on a UsdShadeMaterial. It is used to define the + terminal UsdShadeShader describing the displacement of a + UsdShadeMaterial. + """ + } + dictionary volume = { + string doc = """Describes the volume output + terminal on a UsdShadeMaterial. It is used to define the + terminal UsdShadeShader describing the volume of a + UsdShadeMaterial. + """ + } + dictionary universalRenderContext = { + string value = "" + string doc = """Possible value for the "renderContext" parameter + in \\ref UsdShadeMaterial_Outputs API. Represents the universal + renderContext. An output with a universal renderContext is + applicable to all possible rendering contexts. + """ + } + } + } +) +{ + token outputs:surface ( + doc = """Represents the universal "surface" output terminal of a + material.""" + displayGroup = "Outputs" + customData = { + string apiName = "surface" + } + ) + token outputs:displacement ( + doc = """Represents the universal "displacement" output terminal of a + material.""" + displayGroup = "Outputs" + customData = { + string apiName = "displacement" + } + ) + token outputs:volume ( + doc = """Represents the universal "volume" output terminal of a + material.""" + displayGroup = "Outputs" + customData = { + string apiName = "volume" + } + ) +} + +class Shader "Shader" ( + inherits = + prepend apiSchemas = ["NodeDefAPI"] + doc = """Base class for all USD shaders. Shaders are the building blocks + of shading networks. While UsdShadeShader objects are not target specific, + each renderer or application target may derive its own renderer-specific + shader object types from this base, if needed. + + Objects of this class generally represent a single shading object, whether + it exists in the target renderer or not. For example, a texture, a fractal, + or a mix node. + + The UsdShadeNodeDefAPI provides attributes to uniquely identify the + type of this node. The id resolution into a renderable shader target + type of this node. The id resolution into a renderable shader target + is deferred to the consuming application. + + The purpose of representing them in Usd is two-fold: + \\li To represent, via "connections" the topology of the shading network + that must be reconstructed in the renderer. Facilities for authoring and + manipulating connections are encapsulated in the API schema + UsdShadeConnectableAPI. + \\li To present a (partial or full) interface of typed input parameters + whose values can be set and overridden in Usd, to be provided later at + render-time as parameter values to the actual render shader objects. Shader + input parameters are encapsulated in the property schema UsdShadeInput. + """ + customData = { + dictionary extraPlugInfo = { + bool providesUsdShadeConnectableAPIBehavior = 1 + } + string extraIncludes = ''' +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" +#include "pxr/usd/usdShade/tokens.h" +#include "pxr/usd/ndr/declare.h" +#include "pxr/usd/sdr/shaderNode.h"''' + } +) { +} + +class "NodeDefAPI" +( + inherits = + doc = """UsdShadeNodeDefAPI is an API schema that provides attributes + for a prim to select a corresponding Shader Node Definition ("Sdr Node"), + as well as to look up a runtime entry for that shader node in the + form of an SdrShaderNode. + + UsdShadeNodeDefAPI is intended to be a pre-applied API schema for any + prim type that wants to refer to the SdrRegistry for further implementation + details about the behavior of that prim. The primary use in UsdShade + itself is as UsdShadeShader, which is a basis for material shading networks + (UsdShadeMaterial), but this is intended to be used in other domains + that also use the Sdr node mechanism. + + This schema provides properties that allow a prim to identify an external + node definition, either by a direct identifier key into the SdrRegistry + (info:id), an asset to be parsed by a suitable NdrParserPlugin + (info:sourceAsset), or an inline source code that must also be parsed + (info:sourceCode); as well as a selector attribute to determine which + specifier is active (info:implementationSource). + """ + customData = { + token apiSchemaType = "singleApply" + string extraIncludes = """ +#include "pxr/usd/ndr/declare.h" +#include "pxr/usd/sdr/shaderNode.h" + """ + dictionary schemaTokens = { + dictionary universalSourceType = { + string value = "" + string doc = """Possible value for the "sourceType" parameter + in \\ref UsdShadeNodeDefAPI_ImplementationSource API. Represents + the universal or fallback source type. + """ + } + dictionary sdrMetadata = { + string doc = """Dictionary valued metadata key authored on + Shader prims with implementationSource value of sourceAsset or + sourceCode to pass along metadata to the shader parser or + compiler. It is also used to author metadata on shader + properties in a UsdShade-based shader definition file. + """ + } + dictionary subIdentifier = { + string doc = """This identifier is used in conjunction with a + specific source asset to indicate a particular definition within + the source asset, if the source asset specifies more than one + shader node definition. + """ + } + } + } +) +{ + uniform token info:implementationSource = "id" ( + allowedTokens = ["id", "sourceAsset", "sourceCode"] + doc = """Specifies the attribute that should be consulted to get the + shader's implementation or its source code. + + * If set to "id", the "info:id" attribute's value is used to + determine the shader source from the shader registry. + * If set to "sourceAsset", the resolved value of the "info:sourceAsset" + attribute corresponding to the desired implementation (or source-type) + is used to locate the shader source. A source asset file may also + specify multiple shader definitions, so there is an optional attribute + "info:sourceAsset:subIdentifier" whose value should be used to indicate + a particular shader definition from a source asset file. + * If set to "sourceCode", the value of "info:sourceCode" attribute + corresponding to the desired implementation (or source type) is used as + the shader source. + """ + customData = { + string apiName = "implementationSource" + } + ) + + uniform token info:id ( + doc = """The id is an identifier for the type or purpose of the + shader. E.g.: Texture or FractalFloat. + The use of this id will depend on the render context: some will turn it + into an actual shader path, some will use it to generate shader source + code dynamically. + + \\sa SetShaderId() + """ + customData = { + string apiName = "id" + } + ) +} + +class "ConnectableAPI" +( + inherits = + doc = """UsdShadeConnectableAPI is an API schema that provides a common + interface for creating outputs and making connections between shading + parameters and outputs. The interface is common to all UsdShade schemas + that support Inputs and Outputs, which currently includes UsdShadeShader, + UsdShadeNodeGraph, and UsdShadeMaterial . + + One can construct a UsdShadeConnectableAPI directly from a UsdPrim, or + from objects of any of the schema classes listed above. If it seems + onerous to need to construct a secondary schema object to interact with + Inputs and Outputs, keep in mind that any function whose purpose is either + to walk material/shader networks via their connections, or to create such + networks, can typically be written entirely in terms of + UsdShadeConnectableAPI objects, without needing to care what the underlying + prim type is. + + Additionally, the most common UsdShadeConnectableAPI behaviors + (creating Inputs and Outputs, and making connections) are wrapped as + convenience methods on the prim schema classes (creation) and + UsdShadeInput and UsdShadeOutput. + """ + customData = { + token apiSchemaType = "nonApplied" + string extraIncludes = ''' +#include "pxr/usd/usd/typed.h" +#include "pxr/usd/usdShade/input.h" +#include "pxr/usd/usdShade/output.h" +#include "pxr/usd/usdShade/tokens.h" +#include "pxr/usd/usdShade/types.h"''' + } +) +{ +} + +class "MaterialBindingAPI" +( + inherits = + doc = """UsdShadeMaterialBindingAPI is an API schema that provides an + interface for binding materials to prims or collections of prims + (represented by UsdCollectionAPI objects). + + In the USD shading model, each renderable gprim computes a single + resolved Material that will be used to shade the gprim (exceptions, + of course, for gprims that possess UsdGeomSubsets, as each subset can be + shaded by a different Material). A gprim and each of its ancestor + prims can possess, through the MaterialBindingAPI, both a + direct binding to a Material, and any number of + collection-based bindings to Materials; each binding can be generic + or declared for a particular purpose, and given a specific binding + strength. It is the process of "material resolution" (see + \\ref UsdShadeMaterialBindingAPI_MaterialResolution) that examines all of + these bindings, and selects the one Material that best matches the + client's needs. + + The intent of purpose is that each gprim should be able to resolve a + Material for any given purpose, which implies it can have differently bound + materials for different purposes. There are two special values of + purpose defined in UsdShade, although the API fully supports + specifying arbitrary values for it, for the sake of extensibility: +
  • UsdShadeTokens->full: to be used when the purpose of the + render is entirely to visualize the truest representation of a scene, + considering all lighting and material information, at highest fidelity.
    • +
  • UsdShadeTokens->preview: to be used when the render is in + service of a goal other than a high fidelity "full" render (such as scene + manipulation, modeling, or realtime playback). Latency and speed are + generally of greater concern for preview renders, therefore preview + materials are generally designed to be "lighterweight" compared to full + materials.
+ A binding can also have no specific purpose at all, in which + case, it is considered to be the fallback or all-purpose binding (denoted + by the empty-valued token UsdShadeTokens->allPurpose). + + The purpose of a material binding is encoded in the name of the + binding relationship. +
  • + In the case of a direct binding, the allPurpose binding is + represented by the relationship named material:binding. + Special-purpose direct bindings are represented by relationships named + material:binding:purpose. A direct binding relationship + must have a single target path that points to a UsdShadeMaterial.
    • +
  • + In the case of a collection-based binding, the allPurpose binding is + represented by a relationship named + material:binding:collection:bindingName, where + bindingName establishes an identity for the binding that is unique + on the prim. Attempting to establish two collection bindings of the same + name on the same prim will result in the first binding simply being + overridden. A special-purpose collection-based binding is represented by a + relationship named material:binding:collection:purpose:bindingName. + A collection-based binding relationship must have exacly two targets, one of + which should be a collection-path (see + \ref UsdCollectionAPI::GetCollectionPath()) and the other should point to a + UsdShadeMaterial. In the future, we may allow a single collection + binding to target multiple collections, if we can establish a reasonable + round-tripping pattern for applications that only allow a single collection + to be associated with each Material. +
    • +
+ + Note: Both bindingName and purpose must be + non-namespaced tokens. This allows us to know the role of a binding + relationship simply from the number of tokens in it. +
  • Two tokens: the fallback, "all purpose", direct binding, + material:binding
    • +
  • Three tokens: a purpose-restricted, direct, fallback binding, + e.g. material:binding:preview
    • +
  • Four tokens: an all-purpose, collection-based binding, e.g. + material:binding:collection:metalBits
    • +
  • Five tokens: a purpose-restricted, collection-based binding, + e.g. material:binding:collection:full:metalBits
    • +
+ + A binding-strength value is used to specify whether a binding + authored on a prim should be weaker or stronger than bindings that appear + lower in namespace. We encode the binding strength with as token-valued + metadata 'bindMaterialAs' for future flexibility, even though for + now, there are only two possible values: + UsdShadeTokens->weakerThanDescendants and + UsdShadeTokens->strongerThanDescendants. When binding-strength is + not authored (i.e. empty) on a binding-relationship, the default behavior + matches UsdShadeTokens->weakerThanDescendants. + + \\note If a material binding relationship is a built-in property defined as + part of a typed prim's schema, a fallback value should not be provided for + it. This is because the "material resolution" algorithm only conisders + authored properties. + """ + customData = { + string extraIncludes = """ +#include "pxr/usd/usd/collectionAPI.h" +#include "pxr/usd/usdGeom/subset.h" +#include "pxr/usd/usdShade/material.h" +#include """ + dictionary schemaTokens = { + dictionary materialBinding = { + string value = "material:binding" + string doc = """ + The relationship name on non-shading prims to + denote a binding to a UsdShadeMaterial. + """ + } + dictionary materialBindingCollection = { + string value = "material:binding:collection" + string doc = """ + The relationship name on non-shading prims to + denote a collection-based binding to a UsdShadeMaterial. + """ + } + dictionary allPurpose = { + string value = "" + string doc = """Possible value for the 'materialPurpose' parameter + in the various methods available in UsdShadeMaterialBindingAPI. + Its value is empty and its purpose is to represent a general + purpose material-binding that applies in the absence of a + specific-purpose binding. + """ + } + dictionary preview = { + string doc = """Possible value for the 'materialPurpose' + parameter in UsdShadeMaterialBindingAPI, to be used when the + render is in service of a goal other than a high fidelity "full" + render (such as scene manipulation, modeling, or realtime + playback). Latency and speed are generally of greater concern + for preview renders, therefore preview materials are generally + designed to be "lighterweight" compared to full materials. + """ + } + + dictionary full = { + string doc= """Possible value for the 'materialPurpose' + parameter in UsdShadeMaterialBindingAPI, to be used when the + purpose of the render is entirely about visualizing the truest + representation of a scene, considering all lighting and material + information, at highest fidelity. + """ + } + dictionary bindMaterialAs = { + string doc = """Token valued metadata key authored on a material + binding relationship to indicate the strength of the binding + relative to bindings authored on descendants. + """ + } + dictionary weakerThanDescendants = { + string doc = """Possible value for 'bindMaterialAs' metadata on the + collection-based material binding relationship. Indicates + that the binding represented by the relationship is weaker than + any bindings authored on the descendants.""" + } + dictionary strongerThanDescendants = { + string doc = """Possible value for 'bindMaterialAs' metadata on the + collection-based material binding relationship. Indicates + that the binding represented by the relationship is stronger than + any bindings authored on the descendants.""" + } + dictionary fallbackStrength = { + string doc = """Sentinal value to be used for 'bindMaterialAs' + metadata's default value. Clients should pass this in for the + 'bindingStrength' argument to UsdShadeMaterialBindingAPI::Bind(), + if they want to author the default value (weakerThanDescendants) + sparsely. The value "fallbackStrength" never gets authored + into scene description.""" + } + } + } +) +{ + +} + +class "CoordSysAPI" +( + inherits = + doc = """UsdShadeCoordSysAPI provides a way to designate, name, + and discover coordinate systems. + + Coordinate systems are implicitly established by UsdGeomXformable + prims, using their local space. That coordinate system may be + bound (i.e., named) from another prim. The binding is encoded + as a single-target relationship. + Coordinate system bindings apply to descendants of the prim + where the binding is expressed, but names may be re-bound by + descendant prims. + + CoordSysAPI is a multi-apply API schema, where instance names + signify the named coordinate systems. The instance names are + used with the "coordSys:" namespace to determine the binding + to the UsdGeomXformable prim. + + Named coordinate systems are useful in shading (and other) workflows. + An example is projection paint, which projects a texture + from a certain view (the paint coordinate system), encoded as + (e.g.) "rel coordSys:paint:binding". Using the paint coordinate frame + avoids the need to assign a UV set to the object, and can be a + concise way to project paint across a collection of objects with + a single shared paint coordinate system. + """ + customData = { + token apiSchemaType = "multipleApply" + token propertyNamespacePrefix = "coordSys" + string extraIncludes = ''' +#include "pxr/usd/usdGeom/xformable.h"''' + } +) +{ + rel binding ( + displayName = "Bound Coordinate System" + doc = "Prim binding expressing the appropriate coordinate systems." + ) +} +{ + "Plugins": [ + { + "Info": { + "Types": { + "UsdShadersDiscoveryPlugin" : { + "bases": ["NdrDiscoveryPlugin"], + "displayName": "USD-based shader definition discovery plugin." + } + }, + # Allow usdShaders/shaders to be accessible by hio/glslfx.cpp's + # ShaderResourceRegistry + "ShaderResources": "shaders" + }, + "LibraryPath": "", + "Name": "usdShaders", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +-- glslfx version 0.1 + +// +// Copyright 2018 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// + +#import $TOOLS/hdSt/shaders/surfaceHelpers.glslfx + +-- configuration +{ + "techniques": { + "default": { + "displacementShader": { + "source": [ "Preview.Displacement" ] + }, + "surfaceShader": { + "source": [ "Preview.LightStructures", + "SurfaceHelpers.Lighting", + "Preview.Lighting", + "Preview.LightIntegration", + "SurfaceHelpers.TangentSpace", + "Preview.NormalMapping", + "Preview.Surface" ] + } + } + } +} + + +-- glsl Preview.Displacement + +vec4 +displacementShader(int index, vec4 Peye, vec3 Neye, vec4 patchCoord) +{ + // Calculate scalar displacement. + float texDisplacement = HdGetScalar_displacement(index); + return Peye + vec4(Neye*texDisplacement, 0); +} + + +-- glsl Preview.Surface + +vec4 +surfaceShader(vec4 Peye, vec3 Neye, vec4 color, vec4 patchCoord) +{ + float clearcoatAmount = HdGetScalar_clearcoat(); + float clearcoatRoughness = HdGetScalar_clearcoatRoughness(); + vec3 diffuseColor = HdGet_diffuseColor().xyz; + vec3 emissiveColor = HdGet_emissiveColor().xyz; + float ior = HdGetScalar_ior(); + float metallic = HdGetScalar_metallic(); + float occlusion = HdGetScalar_occlusion(); + float opacity = HdGetScalar_opacity(); + float opacityThreshold = HdGetScalar_opacityThreshold(); + float roughness = HdGetScalar_roughness(); + vec3 specularColor = HdGet_specularColor().xyz; + bool useSpecularWorkflow = (HdGetScalar_useSpecularWorkflow() == 1); + + vec3 clearcoatColor = vec3(1.0); + float specularAmount = 1.0; + +#ifdef HD_MATERIAL_TAG_MASKED + if (opacity < opacityThreshold) { + discard; + return vec4(1.0); + } + opacity = 1.0; +#endif + + // Selection highlighting. + vec4 colorAndOpacity = vec4(diffuseColor, opacity); + diffuseColor = ApplyColorOverrides(colorAndOpacity).rgb; + + // Pre-multiply diffuse color by opacity if not done so already +#ifndef diffuseColor_IS_PREMULTIPLIED + diffuseColor *= opacity; +#endif + + // Evaluate all lights. + vec3 c = evaluateLights( + emissiveColor, + diffuseColor, + useSpecularWorkflow, + ior, + metallic, + specularAmount, + specularColor, + roughness, + clearcoatAmount, + clearcoatColor, + clearcoatRoughness, + occlusion, + Peye, + perturbFragmentNormal(Peye.xyz, Neye)); + + return vec4(c, colorAndOpacity.a); +} + + +-- glsl Preview.LightStructures + +struct LightingContributions +{ + vec3 diffuse; + vec3 specular; +}; + + +-- glsl Preview.Lighting + +#define EPSILON 0.001 + + +float +SchlickFresnel(float EdotH) +{ + return pow(max(0.0, 1.0 - EdotH), 5.0); +} + +float +NormalDistribution(float specularRoughness, float NdotH) +{ + float alpha = specularRoughness * specularRoughness; + float alpha2 = alpha * alpha; + float NdotH2 = NdotH * NdotH; + float DDenom = (NdotH2 * (alpha2 - 1.0)) + 1.0; + DDenom *= DDenom; + DDenom *= PI; + float D = (alpha2 + EPSILON) / DDenom; + return D; +} + +float +Geometric( + float specularRoughness, + float NdotL, + float NdotE, + float NdotH, + float EdotH) +{ + float alpha = specularRoughness * specularRoughness; + float k = alpha * 0.5; + float G = NdotE / (NdotE * (1.0 - k) + k); + G *= NdotL / (NdotL * (1.0 - k) + k); + return G; +} + +vec3 +evaluateDirectDiffuse() +{ + return vec3(1.0 / PI); +} + +vec3 +evaluateDirectSpecular( + vec3 specularColorF0, + vec3 specularColorF90, + float specularRoughness, + float fresnel, + float NdotL, + float NdotE, + float NdotH, + float EdotH) +{ + vec3 F = mix(specularColorF0, specularColorF90, fresnel); + float D = NormalDistribution(specularRoughness, NdotH); + float G = Geometric(specularRoughness, NdotL, NdotE, NdotH, EdotH); + vec3 RNum = F * G * D; + float RDenom = 4.0f * NdotL * NdotE + EPSILON; + return RNum / RDenom; +} + +LightingContributions +evaluateLight( + vec3 diffuseColor, + bool useSpecularWorkflow, + float ior, + float metallic, + float specularAmount, + vec3 specularColor, + float specularRoughness, + float clearcoatAmount, + vec3 clearcoatColor, + float clearcoatRoughness, + float occlusion, + float NdotL, + float NdotE, + float NdotH, + float EdotH, + vec3 lightDiffuseIrradiance, + vec3 lightSpecularIrradiance) +{ + specularRoughness = max(0.001, specularRoughness); + clearcoatRoughness = max(0.001, clearcoatRoughness); + + float fresnel = SchlickFresnel(EdotH); + + // Evaluate diffuse + vec3 d = diffuseColor * evaluateDirectDiffuse(); + + // Evaluate specular first lobe + vec3 s1 = vec3(0.0); + const float R = (1.0 - ior) / (1.0 + ior); + if (specularAmount > 0.0) { + vec3 F0 = specularColor; + vec3 F90 = vec3(1.0); + + if (!useSpecularWorkflow) { + vec3 specColor = mix(vec3(1.0), diffuseColor, metallic); + F0 = mix(R * R * specColor, specColor, metallic); + F90 = specColor; + + // For metallic workflows, pure metals have no diffuse + d *= 1.0 - metallic; + } + + s1 = specularAmount * evaluateDirectSpecular( + F0, // Specular color 0 + F90, // Specular color 90 + specularRoughness, // Roughness + fresnel, // Fresnel + NdotL, NdotE, NdotH, EdotH); // Dot products needed for lights + + // Adjust the diffuse so glazing angles have less diffuse + d *= (1.0 - mix(F0, F90, fresnel)); + } + + // Evaluate clearcoat + vec3 s2 = vec3(0.0); + if (clearcoatAmount > 0.0) { + s2 = clearcoatAmount * evaluateDirectSpecular( + R * R * clearcoatColor, // Clearcoat color 0 + clearcoatColor, // Clearcoat color 90 + clearcoatRoughness, // Roughness + fresnel, // Fresnel + NdotL, NdotE, NdotH, EdotH); // Dot products needed for lights + } + + LightingContributions lightingContrib; + + lightingContrib.diffuse = + occlusion * NdotL * d * lightDiffuseIrradiance; + + lightingContrib.specular = + occlusion * NdotL * (s1 + s2) * lightSpecularIrradiance; + + return lightingContrib; +} + + +-- glsl Preview.LightIntegration + +mat4 GetDomeLightTransform(mat4 worldToLightTransform) +{ + // transform from view space to light space + mat4 worldToViewInverse = GetWorldToViewInverseMatrix(); + return worldToLightTransform * worldToViewInverse; +} + +LightingContributions +evaluateIndirectLighting( + vec3 diffuseColor, + vec3 specularColor, + vec3 Neye, + vec3 Reye, + float NdotE, + float EdotH, + float ior, + float metallic, + float occlusion, + float roughness, + bool useSpecularWorkflow, + float clearcoatAmount, + vec3 clearcoatColor, + float clearcoatRoughness, + mat4 worldToLightTransform) +{ + LightingContributions indirect; + indirect.diffuse = vec3(0.0); + indirect.specular = vec3(0.0); + +#ifdef HD_HAS_domeLightIrradiance + vec3 F0 = specularColor; + vec3 F90 = vec3(1.0); + vec3 d = diffuseColor; + const float R = (1.0 - ior) / (1.0 + ior); + if (!useSpecularWorkflow) { + vec3 specColor = mix(vec3(1.0), diffuseColor, metallic); + F0 = mix(R * R * specColor, specColor, metallic); + F90 = specColor; + + // For metallic workflows, pure metals have no diffuse + d *= 1.0 - metallic; + } + // Adjust the diffuse so glazing angles have less diffuse + float fresnel = SchlickFresnel(EdotH); + vec3 F = mix(F0, F90, fresnel); + d *= (1.0 - F); + + mat4 transformationMatrix = GetDomeLightTransform(worldToLightTransform); + + // Diffuse Component + vec3 dir = normalize((transformationMatrix * vec4(Neye,0.0)).xyz); + vec2 coord = ProjectToLatLong(dir); + vec3 diffuse = HdGet_domeLightIrradiance(coord).rgb; + + // Specular Component + const float MAX_REFLECTION_LOD = + textureQueryLevels(HdGetSampler_domeLightPrefilter()); + float lod = roughness * MAX_REFLECTION_LOD; + vec3 Rdir = normalize((transformationMatrix * vec4(Reye,0.0)).xyz); + vec2 Rcoord = ProjectToLatLong(Rdir); + vec3 prefilter = HdTextureLod_domeLightPrefilter(Rcoord, lod).rgb; + + vec2 brdf = HdGet_domeLightBRDF(vec2(NdotE, roughness)).rg; + + vec3 specular = prefilter * (F * brdf.x + brdf.y); + + // Clearcoat Component + vec3 clearcoat = vec3(0.0); + if (clearcoatAmount > 0.0) { + const vec3 clearcoatF = clearcoatAmount * mix( + R * R * clearcoatColor, // Clearcoat F0 + clearcoatColor, // Clearcoat F90 + fresnel); + lod = clearcoatRoughness * MAX_REFLECTION_LOD; + prefilter = HdTextureLod_domeLightPrefilter(Rcoord, lod).rgb; + clearcoat = prefilter * (clearcoatF * brdf.x + brdf.y); + } + + // Indirect Lighting + indirect.diffuse = (d * diffuse) * occlusion; + indirect.specular = (specular + clearcoat) * occlusion; + +#endif + + return indirect; +} + +vec3 +evaluateLights( + vec3 emissiveColor, + vec3 diffuseColor, + bool useSpecularWorkflow, + float ior, + float metallic, + float specularAmount, + vec3 specularColor, + float specularRoughness, + float clearcoatAmount, + vec3 clearcoatColor, + float clearcoatRoughness, + float occlusion, + vec4 Peye, + vec3 Neye) +{ + vec3 n = Neye; + vec3 e = normalize(-Peye.xyz); + float NdotE = max(0.0, dot(n, e)); + + vec3 Reye = reflect(-e, n); + + vec3 directLight = vec3(0.0); + vec3 indirectLight = vec3(0.0); + +#if NUM_LIGHTS > 0 + for (int i = 0; i < NUM_LIGHTS; ++i) { + LightSource light = GetLightSource(i); + + // Calculate necessary vector information for lighting + vec4 Plight = light.isIndirectLight + ? vec4(0,0,0,1) + : light.position; + vec3 l = (Plight.w == 0.0) + ? normalize(Plight.xyz) + : normalize(Plight - Peye).xyz; + vec3 h = normalize(e + l); + float NdotL = max(0.0, dot(n, l)); + float NdotH = max(0.0, dot(n, h)); + float EdotH = max(0.0, dot(e, h)); + + // Calculate light intensity + float atten = lightDistanceAttenuation(Peye, i); + float spot = lightSpotAttenuation(l, i); + + // Calculate the shadow factor + float shadow = 1.0; + #if USE_SHADOWS + shadow = light.hasShadow ? + shadowing(/*lightIndex=*/i, Peye) : 1.0; + #endif + + float intensity = atten * spot * shadow; + + vec3 lightDiffuseIrradiance = intensity * light.diffuse.rgb; + vec3 lightSpecularIrradiance = intensity * light.specular.rgb; + + LightingContributions lightingContrib = evaluateLight( + diffuseColor, + useSpecularWorkflow, + ior, + metallic, + specularAmount, + specularColor, + specularRoughness, + clearcoatAmount, + clearcoatColor, + clearcoatRoughness, + occlusion, + NdotL, + NdotE, + NdotH, + EdotH, + lightDiffuseIrradiance, + lightSpecularIrradiance); + + // calculate the indirect light (DomeLight) + if (light.isIndirectLight) { + + LightingContributions indirectLightContrib = + evaluateIndirectLighting(diffuseColor, specularColor, + Neye, Reye, NdotE, EdotH, ior, metallic, occlusion, + specularRoughness, useSpecularWorkflow, + clearcoatAmount, clearcoatColor, clearcoatRoughness, + light.worldToLightTransform); + indirectLight = (indirectLightContrib.diffuse * light.diffuse.rgb + + indirectLightContrib.specular * light.specular.rgb); + } + // all other light sources contribute to the direct lighting + else { + directLight += (lightingContrib.diffuse + lightingContrib.specular); + } + } +#endif + + return (emissiveColor + directLight + indirectLight); +} + + +-- glsl Preview.NormalMapping + +vec3 +perturbFragmentNormal(vec3 P, vec3 N) +{ +#ifdef HD_HAS_COORD_normal + vec3 Nt = normalize(HdGet_normal().xyz); + vec2 st = HdGetCoord_normal().xy; + return PerturbNormal(P, N, st, Nt); +#endif + return N; +} + + +-- glslfx version 0.1 + +// +// Copyright 2018 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// + +-- configuration +{ + "techniques": { + "default": { + } + } +} + +-- This file is intentionally empty. +#usda 1.0 + +def Shader "UsdPreviewSurface" ( + doc = "Preview surface specification" +) +{ + uniform token info:id = "UsdPreviewSurface" + uniform token info:implementationSource = "sourceAsset" + + # XXX: This doesn't resolve if it's defined as a search path. + # Might require special resolver configuration, to include the resources + # directory. + uniform asset info:glslfx:sourceAsset = @./previewSurface.glslfx@ + + # Outputs + token outputs:surface ( + sdrMetadata = { + string renderType = "terminal surface" + } + ) + token outputs:displacement ( + sdrMetadata = { + string renderType = "terminal displacement" + } + ) + + # Inputs + color3f inputs:diffuseColor = (0.18, 0.18, 0.18) ( + doc = """Parameter used as diffuseColor when using the specular + workflow, when using metallic workflow this is interpreted + as albedo.""" + ) + + color3f inputs:emissiveColor = (0.0, 0.0, 0.0) ( + doc = """Emissive component.""" + ) + + int inputs:useSpecularWorkflow = 0 ( + connectability = "interfaceOnly" + doc = """This node can fundamentally operate in two modes : + Specular workflow where you provide a texture/value to the + "specularColor" input. Or, Metallic workflow where you + provide a texture/value to the "metallic" input.""" + ) + + color3f inputs:specularColor = (0.0, 0.0, 0.0) ( + doc = """Used only in the specular workflow. + Specular color to be used. + This is the color at 0 incidence. Edge color is assumed white. + Transition between the two colors according to Schlick fresnel + approximation.""" + ) + + float inputs:metallic = 0.0 ( + doc = """Used only in the metalness workflow. + 1 for metallic surfaces and 0 for non-metallic. + - If metallic is 1, then both F0 (reflectivity at 0 degree + incidence) and edge F90 reflectivity will simply be the Albedo. + - If metallic is 0, then Albedo is ignored in the calculation of F0 + and F90; F0 is derived from ior via ( (1-ior)/(1+ior) )^2 and F90 is + white. + In between, we interpolate.""" + ) + + float inputs:roughness = 0.5 ( + doc = """Roughness for the specular lobe. The value ranges from 0 to 1, + which goes from a perfectly specular surface at 0.0 to maximum roughness + of the specular lobe. This value is usually squared before use with a + GGX or Beckmann lobe.""" + ) + + float inputs:clearcoat = 0.0 ( + doc = """Second specular lobe amount. The color is white.""" + ) + + float inputs:clearcoatRoughness = 0.01 ( + doc = """Roughness for the second specular lobe.""" + ) + + float inputs:opacity = 1.0 ( + doc = """Opacity of the material.""" + ) + + float inputs:opacityThreshold = 0.0 ( + connectability = "interfaceOnly" + doc = """Threshold used to determine opacity values that will be + considered fully transparent. A value of 0.0 indicates that no masking + is applied to the opacity input, while a value greater than 0.0 indicates + that rendering of the surface is limited to the areas where the opacity + is greater or equal to that value. Note that when opacityThreshold is + greater than zero, the opacity values less than the opacityThreshold will + not be rendered, and the opacity values greater than or equal to the + opacityThreshold will be fully visible.""" + ) + + float inputs:ior = 1.5 ( + doc = """Index of Refraction to be used for translucent objects.""" + ) + + normal3f inputs:normal = (0.0, 0.0, 1.0) ( + doc = """Expects normal in tangent space [(-1,-1,-1), (1,1,1)] + This means your texture reader implementation should provide + data to this node that is properly scaled and ready + to be consumed as a tangent space normal. + If the texture has 8 bits per component, then scale and bias must be + adjusted to be (2.0, 2.0, 2.0, 1.0) and (-1, -1, -1, 0) respectively + in order to satisfy tangent space requirements. + Normal map data is commonly expected to be linearly encoded. + However, many image-writing tools automatically set the profile of + three-channel, 8-bit images to SRGB. To prevent an unwanted + transformation, the sourceColorSpace must also be set to "raw".""" + ) + + float inputs:displacement = 0.0 ( + doc = """Displacement in the direction of the normal. """ + ) + + float inputs:occlusion = 1.0 ( + doc = """Occlusion signal. This provides extra information about the + occlusion of different parts of the mesh that this material is applied + to. Occlusion only makes sense as a surface-varying signal, and + pathtracers will likely choose to ignore it. An occlusion value of 0.0 + means the surface point is fully occluded by other parts of the surface, + and a value of 1.0 means the surface point is completely unoccluded by + other parts of the surface. """ + ) +} + +def Shader "UsdUVTexture" ( + doc = """Texture Node Specification represents a node that can be used to + read UV textures, including tiled textures such as Mari UDIM's. + + Reads from a texture file and outputs one or more values. If the texture has + 8 bits per component, [0, 255] values will first be converted to floating + point in the range [0, 1] and then any transformations (bias, scale) + indicated are applied. Otherwise any indicated transformation (bias, + scale) is just applied. If a single-channel texture is fed into a + UsdUVTexture, the r, g, and b components of the rgb output will repeat the + channel's value, while the single 'a' output will be set to 1.0. If a + two-channel texture is fed into a UsdUVTexture, the r, g, and b components + of the rgb output will repeat the first channel's value, while the single + 'a' output will be set to the second channel's value. If a three-channel + texture is fed into a UsdUVTexture, the r, g, and b components of the rgb + outputs will contain the assigned texture channel's value, while the single + 'a' output will be set to 1.0. +""" + sdrMetadata = { + token role = "texture" + } +) +{ + uniform token info:id = "UsdUVTexture" + uniform token info:implementationSource = "sourceAsset" + uniform asset info:glslfx:sourceAsset = @./uvTexture.glslfx@ + + asset inputs:file = @@ ( + connectability = "interfaceOnly" + doc = """Path to the texture this node uses.""" + ) + + float2 inputs:st = (0.0, 0.0) ( + doc = """This input provides the texture coordinates. It is usually + connected to a (primvar) node that will provide the texture + coords.""" + ) + + token inputs:wrapS = "useMetadata" ( + allowedTokens = ["black", "clamp", "repeat", "mirror", "useMetadata"] + connectability = "interfaceOnly" + doc = """ black, clamp, repeat, mirror, useMetadata.""" + ) + + token inputs:wrapT = "useMetadata" ( + allowedTokens = ["black", "clamp", "repeat", "mirror", "useMetadata"] + connectability = "interfaceOnly" + doc = """ black, clamp, repeat, mirror, useMetadata.""" + ) + + float4 inputs:fallback = (0.0, 0.0, 0.0, 1.0) ( + doc = """Fallback value to be used when no texture is connected.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + float4 inputs:scale = (1.0, 1.0, 1.0, 1.0) ( + connectability = "interfaceOnly" + doc = """Scale to be applied to all components of the texture. + value * scale + bias. + Please see UsdPreviewSurface.inputs:normal for special + considerations for reading normal maps.""" + ) + + float4 inputs:bias = (0.0, 0.0, 0.0, 0.0) ( + connectability = "interfaceOnly" + doc = """Bias to be applied to all components of the texture. + value * scale + bias). + Please see UsdPreviewSurface.inputs:normal for special + considerations for reading normal maps.""" + ) + + token inputs:sourceColorSpace = "auto" ( + connectability = "interfaceOnly" + allowedTokens = ["raw", "sRGB", "auto"] + doc = """ raw, sRGB, auto. Flag indicating the color + space in which the source texture is encoded. If set to sRGB, + the texture will be read using the sRGB transfer curve, but + not filtered against the sRGB gamut. Please see + UsdPreviewSurface.inputs:normal for special considerations for + reading normal maps.""" + ) + + float outputs:r ( + doc = "Outputs the red channel." + sdrMetadata = { + token swizzle = "x" + } + ) + + float outputs:g ( + doc = "Outputs the green channel." + sdrMetadata = { + token swizzle = "y" + } + ) + + float outputs:b ( + doc = "Outputs the blue channnel." + sdrMetadata = { + token swizzle = "z" + } + ) + + float outputs:a ( + doc = "Outputs the alpha channnel." + sdrMetadata = { + token swizzle = "w" + } + ) + + float3 outputs:rgb ( + doc = "Outputs the red, green and blue channels." + sdrMetadata = { + token swizzle = "xyz" + } + ) +} + +class "UsdPrimvarReader" ( + sdrMetadata = { + token role = "primvar" + } +) +{ + uniform token info:implementationSource = "sourceAsset" + uniform asset info:glslfx:sourceAsset = @./primvarReader.glslfx@ + string inputs:varname = "" ( + connectability = "interfaceOnly" + doc = """Name of the primvar to be fetched from the geometry.""" + sdrMetadata = { + token primvarProperty = "1" + } + ) +} + +def Shader "UsdPrimvarReader_float" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_float" + + float inputs:fallback = 0.0 ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + float outputs:result +} + +def Shader "UsdPrimvarReader_float2" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_float2" + + float2 inputs:fallback = (0.0, 0.0) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + float2 outputs:result +} + +def Shader "UsdPrimvarReader_float3" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_float3" + + float3 inputs:fallback = (0.0, 0.0, 0.0) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + float3 outputs:result +} + +def Shader "UsdPrimvarReader_float4" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_float4" + + float4 inputs:fallback = (0.0, 0.0, 0.0, 0.0) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + float4 outputs:result +} + +def Shader "UsdPrimvarReader_int" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_int" + + int inputs:fallback = 0 ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + int outputs:result +} + +def Shader "UsdPrimvarReader_string" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_string" + + string inputs:fallback = "" ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + string outputs:result +} + +def Shader "UsdPrimvarReader_normal" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_normal" + + normal3f inputs:fallback = (0.0, 0.0, 0.0) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + normal3f outputs:result +} + +def Shader "UsdPrimvarReader_point" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_point" + + point3f inputs:fallback = (0.0, 0.0, 0.0) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + point3f outputs:result +} + +def Shader "UsdPrimvarReader_vector" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_vector" + + vector3f inputs:fallback = (0.0, 0.0, 0.0) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + vector3f outputs:result +} + +def Shader "UsdPrimvarReader_matrix" ( + inherits = +) +{ + uniform token info:id = "UsdPrimvarReader_matrix" + + matrix4d inputs:fallback = ( (1, 0, 0, 0), (0, 1, 0, 0), (0, 0, 1, 0), (0, 0, 0, 1) ) ( + doc = """Fallback value to be returned when fetch failed.""" + sdrMetadata = { + token defaultInput = "1" + } + ) + + matrix4d outputs:result +} + +def Shader "UsdTransform2d" ( + doc = """Transform 2d represents a node that can be used to + transform 2d data (for instance, texture coordinates). + The node applies the following transformation : + in * scale * rotate + translation""" + sdrMetadata = { + token role = "math" + } +) +{ + uniform token info:id = "UsdTransform2d" + uniform token info:implementationSource = "sourceAsset" + uniform asset info:glslfx:sourceAsset = @./transform2d.glslfx@ + + float2 inputs:in = (0.0, 0.0) ( + doc = """This input provides the data. It is usually + connected to a UsdPrimvarReader_float2 that + will provide the data.""" + ) + + float inputs:rotation = 0.0 ( + connectability = "interfaceOnly" + doc = """Counter-clockwise rotation in degrees around the origin to be applied + to all components of the data.""" + ) + + float2 inputs:scale = (1.0, 1.0) ( + connectability = "interfaceOnly" + doc = """Scale around the origin to be applied to all components of the data.""" + ) + + float2 inputs:translation = (0.0, 0.0) ( + connectability = "interfaceOnly" + doc = """Translation to be applied to all components of the data.""" + ) + + float2 outputs:result ( + doc = "Outputs transformed float2 values." + ) +} +-- glslfx version 0.1 + +// +// Copyright 2020 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// + +-- configuration +{ + "techniques": { + "default": { + } + } +} + +-- This file is intentionally empty. +-- glslfx version 0.1 + +// +// Copyright 2018 Pixar +// +// Licensed under the Apache License, Version 2.0 (the "Apache License") +// with the following modification; you may not use this file except in +// compliance with the Apache License and the following modification to it: +// Section 6. Trademarks. is deleted and replaced with: +// +// 6. Trademarks. This License does not grant permission to use the trade +// names, trademarks, service marks, or product names of the Licensor +// and its affiliates, except as required to comply with Section 4(c) of +// the License and to reproduce the content of the NOTICE file. +// +// You may obtain a copy of the Apache License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the Apache License with the above modification is +// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the Apache License for the specific +// language governing permissions and limitations under the Apache License. +// + +-- configuration +{ + "techniques": { + "default": { + } + } +} + +-- This file is intentionally empty. +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class SkelRoot "SkelRoot" ( + doc = '''Boundable prim type used to identify a scope beneath which + skeletally-posed primitives are defined. + + A SkelRoot must be defined at or above a skinned primitive for any skinning + behaviors in UsdSkel. + + See the extended "Skel Root Schema" documentation for + more information.''' +) +{ + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Skeleton "Skeleton" ( + doc = '''Describes a skeleton. + + See the extended "Skeleton Schema" documentation for + more information. + ''' +) +{ + uniform matrix4d[] bindTransforms ( + doc = """Specifies the bind-pose transforms of each joint in + **world space**, in the ordering imposed by *joints*.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + uniform token[] jointNames ( + doc = """If authored, provides a unique name per joint. This may be + optionally set to provide better names when translating to DCC apps + that require unique joint names.""" + ) + uniform token[] joints ( + doc = """An array of path tokens identifying the set of joints that make + up the skeleton, and their order. Each token in the array must be valid + when parsed as an SdfPath. The parent-child relationships of the + corresponding paths determine the parent-child relationships of each + joint. It is not required that the name at the end of each path be + unique, but rather only that the paths themselves be unique.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + uniform matrix4d[] restTransforms ( + doc = """Specifies the rest-pose transforms of each joint in + **local space**, in the ordering imposed by *joints*. This provides + fallback values for joint transforms when a Skeleton either has no + bound animation source, or when that animation source only contains + animation for a subset of a Skeleton's joints.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class SkelAnimation "SkelAnimation" ( + doc = '''Describes a skel animation, where joint animation is stored in a + vectorized form. + + See the extended "Skel Animation" + documentation for more information. + ''' +) +{ + uniform token[] blendShapes ( + doc = """Array of tokens identifying which blend shapes this + animation's data applies to. The tokens for blendShapes correspond to + the tokens set in the *skel:blendShapes* binding property of the + UsdSkelBindingAPI.""" + ) + float[] blendShapeWeights ( + doc = """Array of weight values for each blend shape. Each weight value + is associated with the corresponding blend shape identified within the + *blendShapes* token array, and therefore must have the same length as + *blendShapes.""" + ) + uniform token[] joints ( + doc = """Array of tokens identifying which joints this animation's + data applies to. The tokens for joints correspond to the tokens of + Skeleton primitives. The order of the joints as listed here may + vary from the order of joints on the Skeleton itself.""" + ) + quatf[] rotations ( + doc = """Joint-local unit quaternion rotations of all affected joints, + in 32-bit precision. Array length should match the size of the + *joints* attribute.""" + ) + half3[] scales ( + doc = """Joint-local scales of all affected joints, in + 16 bit precision. Array length should match the size of the *joints* + attribute.""" + ) + float3[] translations ( + doc = """Joint-local translations of all affected joints. Array length + should match the size of the *joints* attribute.""" + ) +} + +class "SkelBindingAPI" ( + doc = '''Provides API for authoring and extracting all the skinning-related + data that lives in the "geometry hierarchy" of prims and models that want + to be skeletally deformed. + + See the extended "UsdSkelBindingAPI schema" + documentation for more about bindings and how they apply in a scene graph. + ''' +) +{ + matrix4d primvars:skel:geomBindTransform ( + doc = '''Encodes the bind-time world space transforms of the prim. + If the transform is identical for a group of gprims that share a common + ancestor, the transform may be authored on the ancestor, to "inherit" + down to all the leaf gprims. If this transform is unset, an identity + transform is used instead.''' + ) + int[] primvars:skel:jointIndices ( + doc = """Indices into the *joints* attribute of the closest + (in namespace) bound Skeleton that affect each point of a PointBased + gprim. The primvar can have either *constant* or *vertex* interpolation. + This primvar's *elementSize* will determine how many joint influences + apply to each point. Indices must point be valid. Null influences should + be defined by setting values in jointWeights to zero. + See UsdGeomPrimvar for more information on interpolation and + elementSize.""" + ) + float[] primvars:skel:jointWeights ( + doc = """Weights for the joints that affect each point of a PointBased + gprim. The primvar can have either *constant* or *vertex* interpolation. + This primvar's *elementSize* will determine how many joints influences + apply to each point. The length, interpolation, and elementSize of + *jointWeights* must match that of *jointIndices*. See UsdGeomPrimvar + for more information on interpolation and elementSize.""" + ) + uniform token primvars:skel:skinningMethod = "classicLinear" ( + allowedTokens = ["classicLinear", "dualQuaternion"] + doc = "The skinningMethod specifies the skinning method for the prim." + ) + rel skel:animationSource ( + doc = """Animation source to be bound to Skeleton primitives at or + beneath the location at which this property is defined. + """ + ) + uniform token[] skel:blendShapes ( + doc = """An array of tokens defining the order onto which blend shape + weights from an animation source map onto the *skel:blendShapeTargets* + rel of a binding site. If authored, the number of elements must be equal + to the number of targets in the _blendShapeTargets_ rel. This property + is not inherited hierarchically, and is expected to be authored directly + on the skinnable primitive to which the blend shapes apply.""" + ) + rel skel:blendShapeTargets ( + doc = """Ordered list of all target blend shapes. This property is not + inherited hierarchically, and is expected to be authored directly on + the skinnable primitive to which the the blend shapes apply.""" + ) + uniform token[] skel:joints ( + doc = """An (optional) array of tokens defining the list of + joints to which jointIndices apply. If not defined, jointIndices applies + to the ordered list of joints defined in the bound Skeleton's *joints* + attribute. If undefined on a primitive, the primitive inherits the + value of the nearest ancestor prim, if any.""" + ) + rel skel:skeleton ( + doc = """Skeleton to be bound to this prim and its descendents that + possess a mapping and weighting to the joints of the identified + Skeleton.""" + ) +} + +class BlendShape "BlendShape" ( + doc = '''Describes a target blend shape, possibly containing inbetween + shapes. + + See the extended "Blend Shape Schema + documentation for information. + ''' +) +{ + uniform vector3f[] normalOffsets ( + doc = """**Required property**. Normal offsets which, when added to the + base pose, provides the normals of the target shape.""" + ) + uniform vector3f[] offsets ( + doc = """**Required property**. Position offsets which, when added to the + base pose, provides the target shape.""" + ) + uniform int[] pointIndices ( + doc = """**Optional property**. Indices into the original mesh that + correspond to the values in *offsets* and of any inbetween shapes. If + authored, the number of elements must be equal to the number of elements + in the *offsets* array.""" + ) +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "SdfMetadata": { + "weight": { + "appliesTo": [ + "attributes" + ], + "default": 0, + "displayGroup": "BlendShape", + "documentation": "The weight value at which an inbeteen shape is applied.", + "type": "float" + } + }, + "Types": { + "UsdSkelAnimation": { + "alias": { + "UsdSchemaBase": "SkelAnimation" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "concreteTyped" + }, + "UsdSkelBindingAPI": { + "alias": { + "UsdSchemaBase": "SkelBindingAPI" + }, + "autoGenerated": true, + "bases": [ + "UsdAPISchemaBase" + ], + "schemaKind": "singleApplyAPI" + }, + "UsdSkelBlendShape": { + "alias": { + "UsdSchemaBase": "BlendShape" + }, + "autoGenerated": true, + "bases": [ + "UsdTyped" + ], + "schemaKind": "concreteTyped" + }, + "UsdSkelRoot": { + "alias": { + "UsdSchemaBase": "SkelRoot" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomBoundable" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + }, + "UsdSkelSkeleton": { + "alias": { + "UsdSchemaBase": "Skeleton" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomBoundable" + ], + "implementsComputeExtent": true, + "schemaKind": "concreteTyped" + } + } + }, + "LibraryPath": "", + "Name": "usdSkel", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 +( + """ This file contains a schema for supporting skeletal animations in USD. + """ + subLayers = [ + @usdGeom/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdSkel" + string libraryPath = "pxr/usd/usdSkel" + + dictionary libraryTokens = { + dictionary weight = { + string doc = """UsdSkelInbetweenShape - The weight location at + which the inbetween shape applies.""" + } + } + } +) { +} + + +class SkelRoot "SkelRoot" ( + inherits = + doc = """Boundable prim type used to identify a scope beneath which + skeletally-posed primitives are defined. + + A SkelRoot must be defined at or above a skinned primitive for any skinning + behaviors in UsdSkel. + + See the extended \\ref UsdSkel_SkelRoot "Skel Root Schema" documentation for + more information.""" + customData = { + string className = "Root" + + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + } +) { +} + + +class Skeleton "Skeleton" ( + inherits = + doc = """Describes a skeleton. + + See the extended \\ref UsdSkel_Skeleton "Skeleton Schema" documentation for + more information. + """ + customData = { + dictionary extraPlugInfo = { + bool implementsComputeExtent = true + } + + string extraIncludes = """ +#include "pxr/usd/usdSkel/topology.h" """ + } +) { + uniform token[] joints ( + doc = """An array of path tokens identifying the set of joints that make + up the skeleton, and their order. Each token in the array must be valid + when parsed as an SdfPath. The parent-child relationships of the + corresponding paths determine the parent-child relationships of each + joint. It is not required that the name at the end of each path be + unique, but rather only that the paths themselves be unique.""" + ) + + uniform token[] jointNames ( + doc = """If authored, provides a unique name per joint. This may be + optionally set to provide better names when translating to DCC apps + that require unique joint names.""" + ) + + uniform matrix4d[] bindTransforms ( + doc = """Specifies the bind-pose transforms of each joint in + **world space**, in the ordering imposed by *joints*.""" + ) + uniform matrix4d[] restTransforms ( + doc = """Specifies the rest-pose transforms of each joint in + **local space**, in the ordering imposed by *joints*. This provides + fallback values for joint transforms when a Skeleton either has no + bound animation source, or when that animation source only contains + animation for a subset of a Skeleton's joints.""" + ) +} + + +class SkelAnimation "SkelAnimation" ( + inherits = + doc = """Describes a skel animation, where joint animation is stored in a + vectorized form. + + See the extended \\ref UsdSkel_SkelAnimation "Skel Animation" + documentation for more information. + """ + customData = { + string className = "Animation" + } +) { + uniform token[] joints ( + doc = """Array of tokens identifying which joints this animation's + data applies to. The tokens for joints correspond to the tokens of + Skeleton primitives. The order of the joints as listed here may + vary from the order of joints on the Skeleton itself.""" + ) + + float3[] translations ( + doc = """Joint-local translations of all affected joints. Array length + should match the size of the *joints* attribute.""" + ) + + quatf[] rotations ( + doc = """Joint-local unit quaternion rotations of all affected joints, + in 32-bit precision. Array length should match the size of the + *joints* attribute.""" + ) + + half3[] scales ( + doc = """Joint-local scales of all affected joints, in + 16 bit precision. Array length should match the size of the *joints* + attribute.""" + ) + + uniform token[] blendShapes ( + doc = """Array of tokens identifying which blend shapes this + animation's data applies to. The tokens for blendShapes correspond to + the tokens set in the *skel:blendShapes* binding property of the + UsdSkelBindingAPI.""" + ) + + float[] blendShapeWeights ( + doc = """Array of weight values for each blend shape. Each weight value + is associated with the corresponding blend shape identified within the + *blendShapes* token array, and therefore must have the same length as + *blendShapes.""" + ) +} + +class "SkelBindingAPI" ( + inherits = + doc = """Provides API for authoring and extracting all the skinning-related + data that lives in the "geometry hierarchy" of prims and models that want + to be skeletally deformed. + + See the extended \\ref UsdSkel_BindingAPI "UsdSkelBindingAPI schema" + documentation for more about bindings and how they apply in a scene graph. + """ + customData = { + string className = "BindingAPI" + string extraIncludes = """ +#include "pxr/base/tf/span.h" +#include "pxr/usd/usdGeom/primvar.h" +#include "pxr/usd/usdSkel/skeleton.h" """ + } +) +{ + rel skel:animationSource ( + customData = { + string apiName = "animationSource" + } + doc = """Animation source to be bound to Skeleton primitives at or + beneath the location at which this property is defined. + """ + ) + + rel skel:skeleton ( + customData = { + string apiName = "skeleton" + } + doc = """Skeleton to be bound to this prim and its descendents that + possess a mapping and weighting to the joints of the identified + Skeleton.""" + ) + + uniform token primvars:skel:skinningMethod = "classicLinear" ( + customData = { + string apiName = "skinningMethod" + } + allowedTokens = ["classicLinear", "dualQuaternion"] + doc = """The skinningMethod specifies the skinning method for the prim.""" + ) + + matrix4d primvars:skel:geomBindTransform ( + customData = { + string apiName = "geomBindTransform" + } + doc = """Encodes the bind-time world space transforms of the prim. + If the transform is identical for a group of gprims that share a common + ancestor, the transform may be authored on the ancestor, to "inherit" + down to all the leaf gprims. If this transform is unset, an identity + transform is used instead.""" + ) + + uniform token[] skel:joints ( + customData = { + string apiName = "joints" + } + doc = """An (optional) array of tokens defining the list of + joints to which jointIndices apply. If not defined, jointIndices applies + to the ordered list of joints defined in the bound Skeleton's *joints* + attribute. If undefined on a primitive, the primitive inherits the + value of the nearest ancestor prim, if any.""" + ) + + int[] primvars:skel:jointIndices ( + customData = { + string apiName = "jointIndices" + } + doc = """Indices into the *joints* attribute of the closest + (in namespace) bound Skeleton that affect each point of a PointBased + gprim. The primvar can have either *constant* or *vertex* interpolation. + This primvar's *elementSize* will determine how many joint influences + apply to each point. Indices must point be valid. Null influences should + be defined by setting values in jointWeights to zero. + See UsdGeomPrimvar for more information on interpolation and + elementSize.""" + ) + + float[] primvars:skel:jointWeights ( + customData = { + string apiName = "jointWeights" + } + doc = """Weights for the joints that affect each point of a PointBased + gprim. The primvar can have either *constant* or *vertex* interpolation. + This primvar's *elementSize* will determine how many joints influences + apply to each point. The length, interpolation, and elementSize of + *jointWeights* must match that of *jointIndices*. See UsdGeomPrimvar + for more information on interpolation and elementSize.""" + ) + + uniform token[] skel:blendShapes ( + customData = { + string apiName = "blendShapes" + } + doc = """An array of tokens defining the order onto which blend shape + weights from an animation source map onto the *skel:blendShapeTargets* + rel of a binding site. If authored, the number of elements must be equal + to the number of targets in the _blendShapeTargets_ rel. This property + is not inherited hierarchically, and is expected to be authored directly + on the skinnable primitive to which the blend shapes apply.""" + ) + rel skel:blendShapeTargets ( + customData = { + string apiName= "blendShapeTargets" + } + doc = """Ordered list of all target blend shapes. This property is not + inherited hierarchically, and is expected to be authored directly on + the skinnable primitive to which the the blend shapes apply.""" + ) +} + + +class BlendShape "BlendShape" ( + inherits = + doc = """Describes a target blend shape, possibly containing inbetween + shapes. + + See the extended \\ref UsdSkel_BlendShape "Blend Shape Schema + documentation for information. + """ + customData = { + string extraIncludes = """ +#include "pxr/base/tf/span.h" +#include "pxr/usd/usdSkel/inbetweenShape.h" """ + } +) +{ + uniform vector3f[] offsets ( + doc = """**Required property**. Position offsets which, when added to the + base pose, provides the target shape.""" + ) + + uniform vector3f[] normalOffsets ( + doc = """**Required property**. Normal offsets which, when added to the + base pose, provides the normals of the target shape.""" + ) + + uniform int[] pointIndices ( + doc = """**Optional property**. Indices into the original mesh that + correspond to the values in *offsets* and of any inbetween shapes. If + authored, the number of elements must be equal to the number of elements + in the *offsets* array.""" + ) +} +#usda 1.0 +( + "WARNING: THIS FILE IS GENERATED BY usdGenSchema. DO NOT EDIT." +) + +class Volume "Volume" ( + doc = """A renderable volume primitive. A volume is made up of any number + of FieldBase primitives bound together in this volume. Each + FieldBase primitive is specified as a relationship with a + namespace prefix of \"field\". + + The relationship name is used by the renderer to associate + individual fields with the named input parameters on the volume + shader. Using this indirect approach to connecting fields to + shader parameters (rather than using the field prim's name) + allows a single field to be reused for different shader inputs, or + to be used as different shader parameters when rendering different + Volumes. This means that the name of the field prim is not + relevant to its contribution to the volume prims which refer to + it. Nor does the field prim's location in the scene graph have + any relevance, and Volumes may refer to fields anywhere in the + scene graph. **However**, unless Field prims need to be shared + by multiple Volumes, a Volume's Field prims should be located + under the Volume in namespace, for enhanced organization.""" +) +{ + uniform bool doubleSided = 0 ( + doc = """Although some renderers treat all parametric or polygonal + surfaces as if they were effectively laminae with outward-facing + normals on both sides, some renderers derive significant optimizations + by considering these surfaces to have only a single outward side, + typically determined by control-point winding order and/or + orientation. By doing so they can perform \"backface culling\" to + avoid drawing the many polygons of most closed surfaces that face away + from the viewer. + + However, it is often advantageous to model thin objects such as paper + and cloth as single, open surfaces that must be viewable from both + sides, always. Setting a gprim's doubleSided attribute to + \\c true instructs all renderers to disable optimizations such as + backface culling for the gprim, and attempt (not all renderers are able + to do so, but the USD reference GL renderer always will) to provide + forward-facing normals on each side of the surface for lighting + calculations.""" + ) + float3[] extent ( + doc = """Extent is a three dimensional range measuring the geometric + extent of the authored gprim in its own local space (i.e. its own + transform not applied), without accounting for any shader-induced + displacement. If __any__ extent value has been authored for a given + Boundable, then it should be authored at every timeSample at which + geometry-affecting properties are authored, to ensure correct + evaluation via ComputeExtent(). If __no__ extent value has been + authored, then ComputeExtent() will call the Boundable's registered + ComputeExtentFunction(), which may be expensive, which is why we + strongly encourage proper authoring of extent. + \\sa ComputeExtent() + \\sa \\ref UsdGeom_Boundable_Extent. + + An authored extent on a prim which has children is expected to include + the extent of all children, as they will be pruned from BBox computation + during traversal.""" + ) + uniform token orientation = "rightHanded" ( + allowedTokens = ["rightHanded", "leftHanded"] + doc = """Orientation specifies whether the gprim's surface normal + should be computed using the right hand rule, or the left hand rule. + Please see for a deeper explanation and + generalization of orientation to composed scenes with transformation + hierarchies.""" + ) + color3f[] primvars:displayColor ( + doc = '''It is useful to have an "official" colorSet that can be used + as a display or modeling color, even in the absence of any specified + shader for a gprim. DisplayColor serves this role; because it is a + UsdGeomPrimvar, it can also be used as a gprim override for any shader + that consumes a displayColor parameter.''' + ) + float[] primvars:displayOpacity ( + doc = """Companion to displayColor that specifies opacity, broken + out as an independent attribute rather than an rgba color, both so that + each can be independently overridden, and because shaders rarely consume + rgba parameters.""" + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "FieldBase" ( + doc = "Base class for field primitives." +) +{ + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class "FieldAsset" ( + doc = "Base class for field primitives defined by an external file." +) +{ + token fieldDataType ( + doc = """Token which is used to indicate the data type of an + individual field. Authors use this to tell consumers more + about the field without opening the file on disk. The list of + allowed tokens is specified with the specific asset type. + A missing value is considered an error.""" + ) + int fieldIndex ( + doc = """A file can contain multiple fields with the same + name. This optional attribute is an index used to + disambiguate between these multiple fields with the same + name.""" + ) + token fieldName ( + doc = """Name of an individual field within the file specified by + the filePath attribute.""" + ) + asset filePath ( + doc = """An asset path attribute that points to a file on disk. + For each supported file format, a separate FieldAsset + subclass is required. + + This attribute's value can be animated over time, as most + volume asset formats represent just a single timeSample of + a volume. However, it does not, at this time, support + any pattern substitutions like \"$F\". """ + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token vectorDataRoleHint = "None" ( + allowedTokens = ["None", "Point", "Normal", "Vector", "Color"] + doc = """Optional token which is used to indicate the role of a vector + valued field. This can drive the data type in which fields + are made available in a renderer or whether the vector values + are to be transformed.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class Field3DAsset "Field3DAsset" ( + doc = """Field3D field primitive. The FieldAsset filePath attribute must + specify a file in the Field3D format on disk.""" +) +{ + token fieldDataType ( + allowedTokens = ["half", "float", "double", "half3", "float3", "double3"] + doc = """Token which is used to indicate the data type of an + individual field. Authors use this to tell consumers more + about the field without opening the file on disk. The list of + allowed tokens reflects the available choices for Field3d + volumes.""" + ) + int fieldIndex ( + doc = """A file can contain multiple fields with the same + name. This optional attribute is an index used to + disambiguate between these multiple fields with the same + name.""" + ) + token fieldName ( + doc = """Name of an individual field within the file specified by + the filePath attribute.""" + ) + token fieldPurpose ( + doc = """Optional token which can be used to indicate the purpose or + grouping of an individual field. Clients which consume Field3D + files should treat this as the Field3D field name.""" + ) + asset filePath ( + doc = """An asset path attribute that points to a file on disk. + For each supported file format, a separate FieldAsset + subclass is required. + + This attribute's value can be animated over time, as most + volume asset formats represent just a single timeSample of + a volume. However, it does not, at this time, support + any pattern substitutions like \"$F\". """ + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token vectorDataRoleHint = "None" ( + allowedTokens = ["None", "Point", "Normal", "Vector", "Color"] + doc = """Optional token which is used to indicate the role of a vector + valued field. This can drive the data type in which fields + are made available in a renderer or whether the vector values + are to be transformed.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +class OpenVDBAsset "OpenVDBAsset" ( + doc = """OpenVDB field primitive. The FieldAsset filePath attribute must + specify a file in the OpenVDB format on disk.""" +) +{ + token fieldClass ( + allowedTokens = ["levelSet", "fogVolume", "staggered", "unknown"] + doc = """Optional token which can be used to indicate the class of + an individual grid. This is a mapping to openvdb::GridClass + where the values are GRID_LEVEL_SET, GRID_FOG_VOLUME, + GRID_STAGGERED, and GRID_UNKNOWN.""" + ) + token fieldDataType ( + allowedTokens = ["half", "float", "double", "int", "uint", "int64", "half2", "float2", "double2", "int2", "half3", "float3", "double3", "int3", "matrix3d", "matrix4d", "quatd", "bool", "mask", "string"] + doc = """Token which is used to indicate the data type of an + individual field. Authors use this to tell consumers more + about the field without opening the file on disk. The list of + allowed tokens reflects the available choices for OpenVDB + volumes.""" + ) + int fieldIndex ( + doc = """A file can contain multiple fields with the same + name. This optional attribute is an index used to + disambiguate between these multiple fields with the same + name.""" + ) + token fieldName ( + doc = """Name of an individual field within the file specified by + the filePath attribute.""" + ) + asset filePath ( + doc = """An asset path attribute that points to a file on disk. + For each supported file format, a separate FieldAsset + subclass is required. + + This attribute's value can be animated over time, as most + volume asset formats represent just a single timeSample of + a volume. However, it does not, at this time, support + any pattern substitutions like \"$F\". """ + ) + rel proxyPrim ( + doc = '''The proxyPrim relationship allows us to link a + prim whose purpose is "render" to its (single target) + purpose="proxy" prim. This is entirely optional, but can be + useful in several scenarios: + + - In a pipeline that does pruning (for complexity management) + by deactivating prims composed from asset references, when we + deactivate a purpose="render" prim, we will be able to discover + and additionally deactivate its associated purpose="proxy" prim, + so that preview renders reflect the pruning accurately. + + - DCC importers may be able to make more aggressive optimizations + for interactive processing and display if they can discover the proxy + for a given render prim. + + - With a little more work, a Hydra-based application will be able + to map a picked proxy prim back to its render geometry for selection. + + \\note It is only valid to author the proxyPrim relationship on + prims whose purpose is "render".''' + ) + uniform token purpose = "default" ( + allowedTokens = ["default", "render", "proxy", "guide"] + doc = """Purpose is a classification of geometry into categories that + can each be independently included or excluded from traversals of prims + on a stage, such as rendering or bounding-box computation traversals. + + See for more detail about how + purpose is computed and used.""" + ) + token vectorDataRoleHint = "None" ( + allowedTokens = ["None", "Point", "Normal", "Vector", "Color"] + doc = """Optional token which is used to indicate the role of a vector + valued field. This can drive the data type in which fields + are made available in a renderer or whether the vector values + are to be transformed.""" + ) + token visibility = "inherited" ( + allowedTokens = ["inherited", "invisible"] + doc = '''Visibility is meant to be the simplest form of "pruning" + visibility that is supported by most DCC apps. Visibility is + animatable, allowing a sub-tree of geometry to be present for some + segment of a shot, and absent from others; unlike the action of + deactivating geometry prims, invisible geometry is still + available for inspection, for positioning, for defining volumes, etc.''' + ) + uniform token[] xformOpOrder ( + doc = """Encodes the sequence of transformation operations in the + order in which they should be pushed onto a transform stack while + visiting a UsdStage's prims in a graph traversal that will effect + the desired positioning for this prim and its descendant prims. + + You should rarely, if ever, need to manipulate this attribute directly. + It is managed by the AddXformOp(), SetResetXformStack(), and + SetXformOpOrder(), and consulted by GetOrderedXformOps() and + GetLocalTransformation().""" + ) +} + +# Portions of this file auto-generated by usdGenSchema. +# Edits will survive regeneration except for comments and +# changes to types with autoGenerated=true. +{ + "Plugins": [ + { + "Info": { + "Types": { + "UsdVolField3DAsset": { + "alias": { + "UsdSchemaBase": "Field3DAsset" + }, + "autoGenerated": true, + "bases": [ + "UsdVolFieldAsset" + ], + "schemaKind": "concreteTyped" + }, + "UsdVolFieldAsset": { + "alias": { + "UsdSchemaBase": "FieldAsset" + }, + "autoGenerated": true, + "bases": [ + "UsdVolFieldBase" + ], + "schemaKind": "abstractTyped" + }, + "UsdVolFieldBase": { + "alias": { + "UsdSchemaBase": "FieldBase" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomXformable" + ], + "schemaKind": "abstractTyped" + }, + "UsdVolOpenVDBAsset": { + "alias": { + "UsdSchemaBase": "OpenVDBAsset" + }, + "autoGenerated": true, + "bases": [ + "UsdVolFieldAsset" + ], + "schemaKind": "concreteTyped" + }, + "UsdVolVolume": { + "alias": { + "UsdSchemaBase": "Volume" + }, + "autoGenerated": true, + "bases": [ + "UsdGeomGprim" + ], + "schemaKind": "concreteTyped" + } + } + }, + "LibraryPath": "", + "Name": "usdVol", + "ResourcePath": "resources", + "Root": "..", + "Type": "library" + } + ] +} +#usda 1.0 + +( + subLayers = [ + @usdGeom/schema.usda@ + ] +) + +over "GLOBAL" ( + customData = { + string libraryName = "usdVol" + string libraryPath = "pxr/usd/usdVol" + dictionary libraryTokens = { + dictionary field = { + string doc = """This is the namespace prefix used to + specify the fields that make up a volume primitive.""" + } + } + } +) +{ +} + +class Volume "Volume" ( + inherits = + doc = """A renderable volume primitive. A volume is made up of any number + of FieldBase primitives bound together in this volume. Each + FieldBase primitive is specified as a relationship with a + namespace prefix of "field". + + The relationship name is used by the renderer to associate + individual fields with the named input parameters on the volume + shader. Using this indirect approach to connecting fields to + shader parameters (rather than using the field prim's name) + allows a single field to be reused for different shader inputs, or + to be used as different shader parameters when rendering different + Volumes. This means that the name of the field prim is not + relevant to its contribution to the volume prims which refer to + it. Nor does the field prim's location in the scene graph have + any relevance, and Volumes may refer to fields anywhere in the + scene graph. **However**, unless Field prims need to be shared + by multiple Volumes, a Volume's Field prims should be located + under the Volume in namespace, for enhanced organization.""" +) +{ +} + +class "FieldBase" ( + inherits = + doc = """Base class for field primitives.""" +) +{ +} + +class "FieldAsset" ( + doc = "Base class for field primitives defined by an external file." + inherits = +) +{ + asset filePath ( + doc = """An asset path attribute that points to a file on disk. + For each supported file format, a separate FieldAsset + subclass is required. + + This attribute's value can be animated over time, as most + volume asset formats represent just a single timeSample of + a volume. However, it does not, at this time, support + any pattern substitutions like \"$F\". """ + ) + token fieldName ( + doc = """Name of an individual field within the file specified by + the filePath attribute.""" + ) + int fieldIndex ( + doc = """A file can contain multiple fields with the same + name. This optional attribute is an index used to + disambiguate between these multiple fields with the same + name.""" + ) + token fieldDataType ( + doc = """Token which is used to indicate the data type of an + individual field. Authors use this to tell consumers more + about the field without opening the file on disk. The list of + allowed tokens is specified with the specific asset type. + A missing value is considered an error.""" + ) + token vectorDataRoleHint = "None" ( + allowedTokens = ["None", "Point", "Normal", "Vector", "Color"] + doc = """Optional token which is used to indicate the role of a vector + valued field. This can drive the data type in which fields + are made available in a renderer or whether the vector values + are to be transformed.""" + ) +} + +class Field3DAsset "Field3DAsset" ( + doc = """Field3D field primitive. The FieldAsset filePath attribute must + specify a file in the Field3D format on disk.""" + inherits = +) +{ + token fieldDataType ( + allowedTokens = ["half", "float", "double", + "half3", "float3", "double3"] + doc = """Token which is used to indicate the data type of an + individual field. Authors use this to tell consumers more + about the field without opening the file on disk. The list of + allowed tokens reflects the available choices for Field3d + volumes.""" + ) + token fieldPurpose ( + doc = """Optional token which can be used to indicate the purpose or + grouping of an individual field. Clients which consume Field3D + files should treat this as the Field3D field \\em name.""" + ) +} + +class OpenVDBAsset "OpenVDBAsset" ( + doc = """OpenVDB field primitive. The FieldAsset filePath attribute must + specify a file in the OpenVDB format on disk.""" + inherits = +) +{ + token fieldDataType ( + allowedTokens = ["half", "float", "double", "int", "uint", "int64", + "half2", "float2", "double2", "int2", + "half3", "float3", "double3", "int3", + "matrix3d", "matrix4d", "quatd", + "bool", "mask", "string"] + doc = """Token which is used to indicate the data type of an + individual field. Authors use this to tell consumers more + about the field without opening the file on disk. The list of + allowed tokens reflects the available choices for OpenVDB + volumes.""" + ) + token fieldClass ( + allowedTokens = ["levelSet", "fogVolume", "staggered", "unknown"] + doc = """Optional token which can be used to indicate the class of + an individual grid. This is a mapping to openvdb::GridClass + where the values are GRID_LEVEL_SET, GRID_FOG_VOLUME, + GRID_STAGGERED, and GRID_UNKNOWN.""" + ) +} + diff --git a/usd-wasm/src/bindings-debug/emHdBindings.js b/usd-wasm/src/bindings-debug/emHdBindings.js new file mode 100644 index 0000000..c94a89e --- /dev/null +++ b/usd-wasm/src/bindings-debug/emHdBindings.js @@ -0,0 +1,13005 @@ +var getUsdModule = (() => { + var _scriptDir = + typeof document !== "undefined" && document.currentScript + ? document.currentScript.src + : undefined; + if (typeof __filename !== "undefined") _scriptDir = _scriptDir || __filename; + return function (moduleArg = {}) { + // Support for growable heap + pthreads, where the buffer may change, so JS views + // must be updated. + function GROWABLE_HEAP_I8() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAP8; + } + function GROWABLE_HEAP_U8() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAPU8; + } + function GROWABLE_HEAP_I16() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAP16; + } + function GROWABLE_HEAP_U16() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAPU16; + } + function GROWABLE_HEAP_I32() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAP32; + } + function GROWABLE_HEAP_U32() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAPU32; + } + function GROWABLE_HEAP_F32() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAPF32; + } + function GROWABLE_HEAP_F64() { + if (wasmMemory.buffer != HEAP8.buffer) { + updateMemoryViews(); + } + return HEAPF64; + } + + var Module = moduleArg; + + var readyPromiseResolve, readyPromiseReject; + + Module["ready"] = new Promise((resolve, reject) => { + readyPromiseResolve = resolve; + readyPromiseReject = reject; + }); + + if (!Module.expectedDataFileDownloads) { + Module.expectedDataFileDownloads = 0; + } + + Module.expectedDataFileDownloads++; + + (function () { + if (Module["ENVIRONMENT_IS_PTHREAD"] || Module["$ww"]) return; + var loadPackage = function (metadata) { + var PACKAGE_PATH = ""; + if (typeof window === "object") { + PACKAGE_PATH = window["encodeURIComponent"]( + window.location.pathname + .toString() + .substring( + 0, + window.location.pathname.toString().lastIndexOf("/"), + ) + "/", + ); + } else if ( + typeof process === "undefined" && + typeof location !== "undefined" + ) { + PACKAGE_PATH = encodeURIComponent( + location.pathname + .toString() + .substring(0, location.pathname.toString().lastIndexOf("/")) + + "/", + ); + } + var PACKAGE_NAME = "emHdBindings.data"; + var REMOTE_PACKAGE_BASE = "emHdBindings.data"; + if ( + typeof Module["locateFilePackage"] === "function" && + !Module["locateFile"] + ) { + Module["locateFile"] = Module["locateFilePackage"]; + err( + "warning: you defined Module.locateFilePackage, that has been renamed to Module.locateFile (using your locateFilePackage for now)", + ); + } + var REMOTE_PACKAGE_NAME = Module["locateFile"] + ? Module["locateFile"](REMOTE_PACKAGE_BASE, "") + : REMOTE_PACKAGE_BASE; + var REMOTE_PACKAGE_SIZE = metadata["remote_package_size"]; + function fetchRemotePackage( + packageName, + packageSize, + callback, + errback, + ) { + if ( + typeof process === "object" && + typeof process.versions === "object" && + typeof process.versions.node === "string" + ) { + require("fs").readFile(packageName, function (err, contents) { + if (err) { + errback(err); + } else { + callback(contents.buffer); + } + }); + return; + } + var xhr = new XMLHttpRequest(); + xhr.open("GET", packageName, true); + xhr.responseType = "arraybuffer"; + xhr.onprogress = function (event) { + var url = packageName; + var size = packageSize; + if (event.total) size = event.total; + if (event.loaded) { + if (!xhr.addedTotal) { + xhr.addedTotal = true; + if (!Module.dataFileDownloads) Module.dataFileDownloads = {}; + Module.dataFileDownloads[url] = { + loaded: event.loaded, + total: size, + }; + } else { + Module.dataFileDownloads[url].loaded = event.loaded; + } + var total = 0; + var loaded = 0; + var num = 0; + for (var download in Module.dataFileDownloads) { + var data = Module.dataFileDownloads[download]; + total += data.total; + loaded += data.loaded; + num++; + } + total = Math.ceil( + (total * Module.expectedDataFileDownloads) / num, + ); + if (Module["setStatus"]) + Module["setStatus"](`Downloading data... (${loaded}/${total})`); + } else if (!Module.dataFileDownloads) { + if (Module["setStatus"]) + Module["setStatus"]("Downloading data..."); + } + }; + xhr.onerror = function (event) { + throw new Error("NetworkError for: " + packageName); + }; + xhr.onload = function (event) { + if ( + xhr.status == 200 || + xhr.status == 304 || + xhr.status == 206 || + (xhr.status == 0 && xhr.response) + ) { + var packageData = xhr.response; + callback(packageData); + } else { + throw new Error(xhr.statusText + " : " + xhr.responseURL); + } + }; + xhr.send(null); + } + function handleError(error) { + console.error("package error:", error); + } + var fetchedCallback = null; + var fetched = Module["getPreloadedPackage"] + ? Module["getPreloadedPackage"]( + REMOTE_PACKAGE_NAME, + REMOTE_PACKAGE_SIZE, + ) + : null; + if (!fetched) + fetchRemotePackage( + REMOTE_PACKAGE_NAME, + REMOTE_PACKAGE_SIZE, + function (data) { + if (fetchedCallback) { + fetchedCallback(data); + fetchedCallback = null; + } else { + fetched = data; + } + }, + handleError, + ); + function runWithFS() { + function assert(check, msg) { + if (!check) throw msg + new Error().stack; + } + Module["FS_createPath"]("/", "usd", true, true); + Module["FS_createPath"]("/usd", "ar", true, true); + Module["FS_createPath"]("/usd/ar", "resources", true, true); + Module["FS_createPath"]("/usd", "hd", true, true); + Module["FS_createPath"]("/usd/hd", "resources", true, true); + Module["FS_createPath"]( + "/usd/hd/resources", + "codegenTemplates", + true, + true, + ); + Module["FS_createPath"]("/usd", "httpResolver", true, true); + Module["FS_createPath"]("/usd/httpResolver", "resources", true, true); + Module["FS_createPath"]("/usd", "ndr", true, true); + Module["FS_createPath"]("/usd/ndr", "resources", true, true); + Module["FS_createPath"]("/usd", "sdf", true, true); + Module["FS_createPath"]("/usd/sdf", "resources", true, true); + Module["FS_createPath"]("/usd", "usd", true, true); + Module["FS_createPath"]("/usd/usd", "resources", true, true); + Module["FS_createPath"]( + "/usd/usd/resources", + "codegenTemplates", + true, + true, + ); + Module["FS_createPath"]("/usd/usd/resources", "usd", true, true); + Module["FS_createPath"]("/usd", "usdGeom", true, true); + Module["FS_createPath"]("/usd/usdGeom", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdGeom/resources", + "usdGeom", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdHydra", true, true); + Module["FS_createPath"]("/usd/usdHydra", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdHydra/resources", + "shaders", + true, + true, + ); + Module["FS_createPath"]( + "/usd/usdHydra/resources", + "usdHydra", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdImaging", true, true); + Module["FS_createPath"]("/usd/usdImaging", "resources", true, true); + Module["FS_createPath"]("/usd", "usdLux", true, true); + Module["FS_createPath"]("/usd/usdLux", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdLux/resources", + "usdLux", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdRender", true, true); + Module["FS_createPath"]("/usd/usdRender", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdRender/resources", + "usdRender", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdShade", true, true); + Module["FS_createPath"]("/usd/usdShade", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdShade/resources", + "usdShade", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdShaders", true, true); + Module["FS_createPath"]("/usd/usdShaders", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdShaders/resources", + "shaders", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdSkel", true, true); + Module["FS_createPath"]("/usd/usdSkel", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdSkel/resources", + "usdSkel", + true, + true, + ); + Module["FS_createPath"]("/usd", "usdVol", true, true); + Module["FS_createPath"]("/usd/usdVol", "resources", true, true); + Module["FS_createPath"]( + "/usd/usdVol/resources", + "usdVol", + true, + true, + ); + /** @constructor */ function DataRequest(start, end, audio) { + this.start = start; + this.end = end; + this.audio = audio; + } + DataRequest.prototype = { + requests: {}, + open: function (mode, name) { + this.name = name; + this.requests[name] = this; + Module["addRunDependency"](`fp ${this.name}`); + }, + send: function () {}, + onload: function () { + var byteArray = this.byteArray.subarray(this.start, this.end); + this.finish(byteArray); + }, + finish: function (byteArray) { + var that = this; + Module["FS_createDataFile"]( + this.name, + null, + byteArray, + true, + true, + true, + ); + Module["removeRunDependency"](`fp ${that.name}`); + this.requests[this.name] = null; + }, + }; + var files = metadata["files"]; + for (var i = 0; i < files.length; ++i) { + new DataRequest( + files[i]["start"], + files[i]["end"], + files[i]["audio"] || 0, + ).open("GET", files[i]["filename"]); + } + function processPackageData(arrayBuffer) { + assert(arrayBuffer, "Loading data file failed."); + assert( + arrayBuffer.constructor.name === ArrayBuffer.name, + "bad input to processPackageData", + ); + var byteArray = new Uint8Array(arrayBuffer); + var curr; + DataRequest.prototype.byteArray = byteArray; + var files = metadata["files"]; + for (var i = 0; i < files.length; ++i) { + DataRequest.prototype.requests[files[i].filename].onload(); + } + Module["removeRunDependency"]("datafile_emHdBindings.data"); + } + Module["addRunDependency"]("datafile_emHdBindings.data"); + if (!Module.preloadResults) Module.preloadResults = {}; + Module.preloadResults[PACKAGE_NAME] = { + fromCache: false, + }; + if (fetched) { + processPackageData(fetched); + fetched = null; + } else { + fetchedCallback = processPackageData; + } + } + if (Module["calledRun"]) { + runWithFS(); + } else { + if (!Module["preRun"]) Module["preRun"] = []; + Module["preRun"].push(runWithFS); + } + }; + loadPackage({ + files: [ + { + filename: "/usd/ar/resources/plugInfo.json", + start: 0, + end: 589, + }, + { + filename: "/usd/hd/resources/codegenTemplates/schemaClass.cpp", + start: 589, + end: 9620, + }, + { + filename: "/usd/hd/resources/codegenTemplates/schemaClass.h", + start: 9620, + end: 20258, + }, + { + filename: "/usd/hd/resources/plugInfo.json", + start: 20258, + end: 20483, + }, + { + filename: "/usd/httpResolver/resources/plugInfo.json", + start: 20483, + end: 20823, + }, + { + filename: "/usd/ndr/resources/plugInfo.json", + start: 20823, + end: 21397, + }, + { + filename: "/usd/plugInfo.json", + start: 21397, + end: 21448, + }, + { + filename: "/usd/sdf/resources/plugInfo.json", + start: 21448, + end: 22544, + }, + { + filename: "/usd/usd/resources/codegenTemplates/api.h", + start: 22544, + end: 24646, + }, + { + filename: "/usd/usd/resources/codegenTemplates/plugInfo.json", + start: 24646, + end: 25003, + }, + { + filename: "/usd/usd/resources/codegenTemplates/schemaClass.cpp", + start: 25003, + end: 37342, + }, + { + filename: "/usd/usd/resources/codegenTemplates/schemaClass.h", + start: 37342, + end: 54229, + }, + { + filename: "/usd/usd/resources/codegenTemplates/tokens.cpp", + start: 54229, + end: 55817, + }, + { + filename: "/usd/usd/resources/codegenTemplates/tokens.h", + start: 55817, + end: 59072, + }, + { + filename: "/usd/usd/resources/codegenTemplates/wrapSchemaClass.cpp", + start: 59072, + end: 68578, + }, + { + filename: "/usd/usd/resources/codegenTemplates/wrapTokens.cpp", + start: 68578, + end: 71099, + }, + { + filename: "/usd/usd/resources/generatedSchema.usda", + start: 71099, + end: 86803, + }, + { + filename: "/usd/usd/resources/plugInfo.json", + start: 86803, + end: 92530, + }, + { + filename: "/usd/usd/resources/usd/schema.usda", + start: 92530, + end: 110774, + }, + { + filename: "/usd/usdGeom/resources/generatedSchema.usda", + start: 110774, + end: 355640, + }, + { + filename: "/usd/usdGeom/resources/plugInfo.json", + start: 355640, + end: 371761, + }, + { + filename: "/usd/usdGeom/resources/usdGeom/schema.usda", + start: 371761, + end: 500520, + }, + { + filename: "/usd/usdHydra/resources/generatedSchema.usda", + start: 500520, + end: 501538, + }, + { + filename: "/usd/usdHydra/resources/plugInfo.json", + start: 501538, + end: 502826, + }, + { + filename: "/usd/usdHydra/resources/shaders/empty.glslfx", + start: 502826, + end: 504049, + }, + { + filename: "/usd/usdHydra/resources/shaders/shaderDefs.usda", + start: 504049, + end: 510806, + }, + { + filename: "/usd/usdHydra/resources/usdHydra/schema.usda", + start: 510806, + end: 518107, + }, + { + filename: "/usd/usdImaging/resources/plugInfo.json", + start: 518107, + end: 531776, + }, + { + filename: "/usd/usdLux/resources/generatedSchema.usda", + start: 531776, + end: 610666, + }, + { + filename: "/usd/usdLux/resources/plugInfo.json", + start: 610666, + end: 620463, + }, + { + filename: "/usd/usdLux/resources/usdLux/schema.usda", + start: 620463, + end: 662394, + }, + { + filename: "/usd/usdRender/resources/generatedSchema.usda", + start: 662394, + end: 685685, + }, + { + filename: "/usd/usdRender/resources/plugInfo.json", + start: 685685, + end: 688784, + }, + { + filename: "/usd/usdRender/resources/usdRender/schema.usda", + start: 688784, + end: 705492, + }, + { + filename: "/usd/usdShade/resources/generatedSchema.usda", + start: 705492, + end: 721492, + }, + { + filename: "/usd/usdShade/resources/plugInfo.json", + start: 721492, + end: 727378, + }, + { + filename: "/usd/usdShade/resources/usdShade/schema.usda", + start: 727378, + end: 754223, + }, + { + filename: "/usd/usdShaders/resources/plugInfo.json", + start: 754223, + end: 754902, + }, + { + filename: "/usd/usdShaders/resources/shaders/previewSurface.glslfx", + start: 754902, + end: 768823, + }, + { + filename: "/usd/usdShaders/resources/shaders/primvarReader.glslfx", + start: 768823, + end: 770046, + }, + { + filename: "/usd/usdShaders/resources/shaders/shaderDefs.usda", + start: 770046, + end: 784976, + }, + { + filename: "/usd/usdShaders/resources/shaders/transform2d.glslfx", + start: 784976, + end: 786199, + }, + { + filename: "/usd/usdShaders/resources/shaders/uvTexture.glslfx", + start: 786199, + end: 787422, + }, + { + filename: "/usd/usdSkel/resources/generatedSchema.usda", + start: 787422, + end: 802913, + }, + { + filename: "/usd/usdSkel/resources/plugInfo.json", + start: 802913, + end: 805907, + }, + { + filename: "/usd/usdSkel/resources/usdSkel/schema.usda", + start: 805907, + end: 816312, + }, + { + filename: "/usd/usdVol/resources/generatedSchema.usda", + start: 816312, + end: 840757, + }, + { + filename: "/usd/usdVol/resources/plugInfo.json", + start: 840757, + end: 843193, + }, + { + filename: "/usd/usdVol/resources/usdVol/schema.usda", + start: 843193, + end: 849069, + }, + ], + remote_package_size: 849069, + }); + })(); + + if (!Module["ENVIRONMENT_IS_PTHREAD"]) { + function isMobileDevice() { + return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test( + navigator.userAgent, + ); + } + const MAX_MEMORY_MOBILE = 1024 * 1024 * 1024; + const MAX_MEMORY_DESKTOP = 4 * 1024 * 1024 * 1024; + const MAX_DEVICE_MEMORY = isMobileDevice() + ? MAX_MEMORY_MOBILE + : MAX_MEMORY_DESKTOP; + Module["wasmMemory"] = new WebAssembly.Memory({ + initial: 16777216 / 65536, + maximum: MAX_DEVICE_MEMORY / 65536, + shared: true, + }); + } + + var moduleOverrides = Object.assign({}, Module); + + var arguments_ = []; + + var thisProgram = "./this.program"; + + var quit_ = (status, toThrow) => { + throw toThrow; + }; + + var ENVIRONMENT_IS_WEB = typeof window == "object"; + + var ENVIRONMENT_IS_WORKER = typeof importScripts == "function"; + + var ENVIRONMENT_IS_NODE = + typeof process == "object" && + typeof process.versions == "object" && + typeof process.versions.node == "string"; + + var ENVIRONMENT_IS_SHELL = + !ENVIRONMENT_IS_WEB && !ENVIRONMENT_IS_NODE && !ENVIRONMENT_IS_WORKER; + + var ENVIRONMENT_IS_PTHREAD = Module["ENVIRONMENT_IS_PTHREAD"] || false; + + var scriptDirectory = ""; + + function locateFile(path) { + if (Module["locateFile"]) { + return Module["locateFile"](path, scriptDirectory); + } + return scriptDirectory + path; + } + + var read_, readAsync, readBinary; + + if (ENVIRONMENT_IS_NODE) { + var fs = require("fs"); + var nodePath = require("path"); + if (ENVIRONMENT_IS_WORKER) { + scriptDirectory = nodePath.dirname(scriptDirectory) + "/"; + } else { + scriptDirectory = __dirname + "/"; + } + read_ = (filename, binary) => { + filename = isFileURI(filename) + ? new URL(filename) + : nodePath.normalize(filename); + return fs.readFileSync(filename, binary ? undefined : "utf8"); + }; + readBinary = (filename) => { + var ret = read_(filename, true); + if (!ret.buffer) { + ret = new Uint8Array(ret); + } + return ret; + }; + readAsync = (filename, onload, onerror, binary = true) => { + filename = isFileURI(filename) + ? new URL(filename) + : nodePath.normalize(filename); + fs.readFile(filename, binary ? undefined : "utf8", (err, data) => { + if (err) onerror(err); + else onload(binary ? data.buffer : data); + }); + }; + if (!Module["thisProgram"] && process.argv.length > 1) { + thisProgram = process.argv[1].replace(/\\/g, "/"); + } + arguments_ = process.argv.slice(2); + quit_ = (status, toThrow) => { + process.exitCode = status; + throw toThrow; + }; + Module["inspect"] = () => "[Emscripten Module object]"; + let nodeWorkerThreads; + try { + nodeWorkerThreads = require("worker_threads"); + } catch (e) { + console.error( + 'The "worker_threads" module is not supported in this node.js build - perhaps a newer version is needed?', + ); + throw e; + } + global.Worker = nodeWorkerThreads.Worker; + } else if (ENVIRONMENT_IS_WEB || ENVIRONMENT_IS_WORKER) { + if (ENVIRONMENT_IS_WORKER) { + scriptDirectory = self.location.href; + } else if (typeof document != "undefined" && document.currentScript) { + scriptDirectory = document.currentScript.src; + } + if (_scriptDir) { + scriptDirectory = _scriptDir; + } + if (scriptDirectory.indexOf("blob:") !== 0) { + scriptDirectory = scriptDirectory.substr( + 0, + scriptDirectory.replace(/[?#].*/, "").lastIndexOf("/") + 1, + ); + } else { + scriptDirectory = ""; + } + if (!ENVIRONMENT_IS_NODE) { + read_ = (url) => { + var xhr = new XMLHttpRequest(); + xhr.open("GET", url, false); + xhr.send(null); + return xhr.responseText; + }; + if (ENVIRONMENT_IS_WORKER) { + readBinary = (url) => { + var xhr = new XMLHttpRequest(); + xhr.open("GET", url, false); + xhr.responseType = "arraybuffer"; + xhr.send(null); + return new Uint8Array(/** @type{!ArrayBuffer} */ (xhr.response)); + }; + } + readAsync = (url, onload, onerror) => { + var xhr = new XMLHttpRequest(); + xhr.open("GET", url, true); + xhr.responseType = "arraybuffer"; + xhr.onload = () => { + if (xhr.status == 200 || (xhr.status == 0 && xhr.response)) { + onload(xhr.response); + return; + } + onerror(); + }; + xhr.onerror = onerror; + xhr.send(null); + }; + } + } else { + } + + if (ENVIRONMENT_IS_NODE) { + if (typeof performance == "undefined") { + global.performance = require("perf_hooks").performance; + } + } + + var defaultPrint = console.log.bind(console); + + var defaultPrintErr = console.error.bind(console); + + if (ENVIRONMENT_IS_NODE) { + defaultPrint = (...args) => fs.writeSync(1, args.join(" ") + "\n"); + defaultPrintErr = (...args) => fs.writeSync(2, args.join(" ") + "\n"); + } + + var out = Module["print"] || defaultPrint; + + var err = Module["printErr"] || defaultPrintErr; + + Object.assign(Module, moduleOverrides); + + moduleOverrides = null; + + if (Module["arguments"]) arguments_ = Module["arguments"]; + + if (Module["thisProgram"]) thisProgram = Module["thisProgram"]; + + if (Module["quit"]) quit_ = Module["quit"]; + + var wasmBinary; + + if (Module["wasmBinary"]) wasmBinary = Module["wasmBinary"]; + + if (typeof WebAssembly != "object") { + abort("no native wasm support detected"); + } + + var wasmMemory; + + var wasmModule; + + var ABORT = false; + + var EXITSTATUS; + + /** @type {function(*, string=)} */ function assert(condition, text) { + if (!condition) { + abort(text); + } + } + + var HEAP, + /** @type {!Int8Array} */ HEAP8, + /** @type {!Uint8Array} */ HEAPU8, + /** @type {!Int16Array} */ HEAP16, + /** @type {!Uint16Array} */ HEAPU16, + /** @type {!Int32Array} */ HEAP32, + /** @type {!Uint32Array} */ HEAPU32, + /** @type {!Float32Array} */ HEAPF32, + /** @type {!Float64Array} */ HEAPF64; + + function updateMemoryViews() { + var b = wasmMemory.buffer; + Module["HEAP8"] = HEAP8 = new Int8Array(b); + Module["HEAP16"] = HEAP16 = new Int16Array(b); + Module["HEAPU8"] = HEAPU8 = new Uint8Array(b); + Module["HEAPU16"] = HEAPU16 = new Uint16Array(b); + Module["HEAP32"] = HEAP32 = new Int32Array(b); + Module["HEAPU32"] = HEAPU32 = new Uint32Array(b); + Module["HEAPF32"] = HEAPF32 = new Float32Array(b); + Module["HEAPF64"] = HEAPF64 = new Float64Array(b); + } + + var INITIAL_MEMORY = Module["INITIAL_MEMORY"] || 16777216; + + assert( + INITIAL_MEMORY >= 5242880, + "INITIAL_MEMORY should be larger than STACK_SIZE, was " + + INITIAL_MEMORY + + "! (STACK_SIZE=" + + 5242880 + + ")", + ); + + if (ENVIRONMENT_IS_PTHREAD) { + wasmMemory = Module["wasmMemory"]; + } else { + if (Module["wasmMemory"]) { + wasmMemory = Module["wasmMemory"]; + } else { + wasmMemory = new WebAssembly.Memory({ + initial: INITIAL_MEMORY / 65536, + maximum: 4294967296 / 65536, + shared: true, + }); + if (!(wasmMemory.buffer instanceof SharedArrayBuffer)) { + err( + "requested a shared WebAssembly.Memory but the returned buffer is not a SharedArrayBuffer, indicating that while the browser has SharedArrayBuffer it does not have WebAssembly threads support - you may need to set a flag", + ); + if (ENVIRONMENT_IS_NODE) { + err( + "(on node you may need: --experimental-wasm-threads --experimental-wasm-bulk-memory and/or recent version)", + ); + } + throw Error("bad memory"); + } + } + } + + updateMemoryViews(); + + INITIAL_MEMORY = wasmMemory.buffer.byteLength; + + var __ATPRERUN__ = []; + + var __ATINIT__ = []; + + var __ATEXIT__ = []; + + var __ATPOSTRUN__ = []; + + var runtimeInitialized = false; + + function preRun() { + if (Module["preRun"]) { + if (typeof Module["preRun"] == "function") + Module["preRun"] = [Module["preRun"]]; + while (Module["preRun"].length) { + addOnPreRun(Module["preRun"].shift()); + } + } + callRuntimeCallbacks(__ATPRERUN__); + } + + function initRuntime() { + runtimeInitialized = true; + if (ENVIRONMENT_IS_PTHREAD) return; + if (!Module["noFSInit"] && !FS.init.initialized) FS.init(); + FS.ignorePermissions = false; + TTY.init(); + callRuntimeCallbacks(__ATINIT__); + } + + function postRun() { + if (ENVIRONMENT_IS_PTHREAD) return; + if (Module["postRun"]) { + if (typeof Module["postRun"] == "function") + Module["postRun"] = [Module["postRun"]]; + while (Module["postRun"].length) { + addOnPostRun(Module["postRun"].shift()); + } + } + callRuntimeCallbacks(__ATPOSTRUN__); + } + + function addOnPreRun(cb) { + __ATPRERUN__.unshift(cb); + } + + function addOnInit(cb) { + __ATINIT__.unshift(cb); + } + + function addOnExit(cb) {} + + function addOnPostRun(cb) { + __ATPOSTRUN__.unshift(cb); + } + + var runDependencies = 0; + + var runDependencyWatcher = null; + + var dependenciesFulfilled = null; + + function getUniqueRunDependency(id) { + return id; + } + + function addRunDependency(id) { + runDependencies++; + if (Module["monitorRunDependencies"]) { + Module["monitorRunDependencies"](runDependencies); + } + } + + function removeRunDependency(id) { + runDependencies--; + if (Module["monitorRunDependencies"]) { + Module["monitorRunDependencies"](runDependencies); + } + if (runDependencies == 0) { + if (runDependencyWatcher !== null) { + clearInterval(runDependencyWatcher); + runDependencyWatcher = null; + } + if (dependenciesFulfilled) { + var callback = dependenciesFulfilled; + dependenciesFulfilled = null; + callback(); + } + } + } + + /** @param {string|number=} what */ function abort(what) { + if (Module["onAbort"]) { + Module["onAbort"](what); + } + what = "Aborted(" + what + ")"; + err(what); + ABORT = true; + EXITSTATUS = 1; + what += ". Build with -sASSERTIONS for more info."; + /** @suppress {checkTypes} */ var e = new WebAssembly.RuntimeError(what); + readyPromiseReject(e); + throw e; + } + + var dataURIPrefix = "data:application/octet-stream;base64,"; + + /** + * Indicates whether filename is a base64 data URI. + * @noinline + */ var isDataURI = (filename) => filename.startsWith(dataURIPrefix); + + /** + * Indicates whether filename is delivered via file protocol (as opposed to http/https) + * @noinline + */ var isFileURI = (filename) => filename.startsWith("file://"); + + var wasmBinaryFile; + + wasmBinaryFile = "emHdBindings.wasm"; + + if (!isDataURI(wasmBinaryFile)) { + wasmBinaryFile = locateFile(wasmBinaryFile); + } + + function getBinarySync(file) { + if (file == wasmBinaryFile && wasmBinary) { + return new Uint8Array(wasmBinary); + } + if (readBinary) { + return readBinary(file); + } + throw "both async and sync fetching of the wasm failed"; + } + + function getBinaryPromise(binaryFile) { + if (!wasmBinary && (ENVIRONMENT_IS_WEB || ENVIRONMENT_IS_WORKER)) { + if (typeof fetch == "function" && !isFileURI(binaryFile)) { + return fetch(binaryFile, { + credentials: "same-origin", + }) + .then((response) => { + if (!response["ok"]) { + throw "failed to load wasm binary file at '" + binaryFile + "'"; + } + return response["arrayBuffer"](); + }) + .catch(() => getBinarySync(binaryFile)); + } else if (readAsync) { + return new Promise((resolve, reject) => { + readAsync( + binaryFile, + (response) => + resolve(new Uint8Array(/** @type{!ArrayBuffer} */ (response))), + reject, + ); + }); + } + } + return Promise.resolve().then(() => getBinarySync(binaryFile)); + } + + function instantiateArrayBuffer(binaryFile, imports, receiver) { + return getBinaryPromise(binaryFile) + .then((binary) => WebAssembly.instantiate(binary, imports)) + .then((instance) => instance) + .then(receiver, (reason) => { + err(`failed to asynchronously prepare wasm: ${reason}`); + abort(reason); + }); + } + + function instantiateAsync(binary, binaryFile, imports, callback) { + if ( + !binary && + typeof WebAssembly.instantiateStreaming == "function" && + !isDataURI(binaryFile) && + !isFileURI(binaryFile) && + !ENVIRONMENT_IS_NODE && + typeof fetch == "function" + ) { + return fetch(binaryFile, { + credentials: "same-origin", + }).then((response) => { + /** @suppress {checkTypes} */ var result = + WebAssembly.instantiateStreaming(response, imports); + return result.then(callback, function (reason) { + err(`wasm streaming compile failed: ${reason}`); + err("falling back to ArrayBuffer instantiation"); + return instantiateArrayBuffer(binaryFile, imports, callback); + }); + }); + } + return instantiateArrayBuffer(binaryFile, imports, callback); + } + + function createWasm() { + var info = { + env: wasmImports, + wasi_snapshot_preview1: wasmImports, + }; + /** @param {WebAssembly.Module=} module*/ function receiveInstance( + instance, + module, + ) { + wasmExports = instance.exports; + wasmExports = Asyncify.instrumentWasmExports(wasmExports); + wasmExports = applySignatureConversions(wasmExports); + registerTLSInit(wasmExports["_emscripten_tls_init"]); + wasmTable = wasmExports["__indirect_function_table"]; + addOnInit(wasmExports["__wasm_call_ctors"]); + wasmModule = module; + removeRunDependency("wasm-instantiate"); + return wasmExports; + } + addRunDependency("wasm-instantiate"); + function receiveInstantiationResult(result) { + receiveInstance(result["instance"], result["module"]); + } + if (Module["instantiateWasm"]) { + try { + return Module["instantiateWasm"](info, receiveInstance); + } catch (e) { + err(`Module.instantiateWasm callback failed with error: ${e}`); + readyPromiseReject(e); + } + } + instantiateAsync( + wasmBinary, + wasmBinaryFile, + info, + receiveInstantiationResult, + ).catch(readyPromiseReject); + return {}; + } + + var tempDouble; + + var tempI64; + + function __asyncjs__fetch_asset(route, dataPtr) { + return Asyncify.handleAsync(async () => { + const routeString = UTF8ToString(route); + const absoluteUrl = new URL(routeString); + try { + const response = await fetch(absoluteUrl); + if (!response.ok) + throw new Error("Fetch failed: " + response.statusText); + const buffer = await response.arrayBuffer(); + const length = buffer.byteLength; + const ptr = _malloc(length); + GROWABLE_HEAP_U8().set(new Uint8Array(buffer), ptr >>> 0); + Module.HEAP32[dataPtr >> 2] = ptr; + Module.HEAP32[(dataPtr >> 2) + 1] = length; + } catch (err) { + console.error("Error in fetch_asset: ", err); + Module.HEAP32[dataPtr >> 2] = 0; + Module.HEAP32[(dataPtr >> 2) + 1] = 0; + } + }); + } + + function addToLoadedFiles(path) { + if (typeof self !== "undefined") { + if (typeof self.loadedFiles === "undefined") { + self.loadedFiles = []; + } + } else { + console.log("Neither window nor self is defined"); + } + self.loadedFiles.push(UTF8ToString(path)); + } + + function downloadJS(data, filenamedata) { + const text = UTF8ToString(data); + const filename = UTF8ToString(filenamedata); + let element = document.createElement("a"); + element.setAttribute( + "href", + "data:text/plain;charset=utf-8," + encodeURIComponent(text), + ); + element.setAttribute("download", filename); + element.style.display = "none"; + document.body.appendChild(element); + element.click(); + document.body.removeChild(element); + } + + /** @constructor */ function ExitStatus(status) { + this.name = "ExitStatus"; + this.message = `Program terminated with exit(${status})`; + this.status = status; + } + + var terminateWorker = (worker) => { + worker.terminate(); + worker.onmessage = (e) => {}; + }; + + var killThread = (pthread_ptr) => { + var worker = PThread.pthreads[pthread_ptr]; + delete PThread.pthreads[pthread_ptr]; + terminateWorker(worker); + __emscripten_thread_free_data(pthread_ptr); + PThread.runningWorkers.splice(PThread.runningWorkers.indexOf(worker), 1); + worker.pthread_ptr = 0; + }; + + var cancelThread = (pthread_ptr) => { + var worker = PThread.pthreads[pthread_ptr]; + worker.postMessage({ + cmd: "cancel", + }); + }; + + var cleanupThread = (pthread_ptr) => { + var worker = PThread.pthreads[pthread_ptr]; + assert(worker); + PThread.returnWorkerToPool(worker); + }; + + var zeroMemory = (address, size) => { + GROWABLE_HEAP_U8().fill(0, address, address + size); + return address; + }; + + var spawnThread = (threadParams) => { + var worker = PThread.getNewWorker(); + if (!worker) { + return 6; + } + PThread.runningWorkers.push(worker); + PThread.pthreads[threadParams.pthread_ptr] = worker; + worker.pthread_ptr = threadParams.pthread_ptr; + var msg = { + cmd: "run", + start_routine: threadParams.startRoutine, + arg: threadParams.arg, + pthread_ptr: threadParams.pthread_ptr, + }; + if (ENVIRONMENT_IS_NODE) { + worker.unref(); + } + worker.postMessage(msg, threadParams.transferList); + return 0; + }; + + var runtimeKeepaliveCounter = 0; + + var keepRuntimeAlive = () => noExitRuntime || runtimeKeepaliveCounter > 0; + + var PATH = { + isAbs: (path) => path.charAt(0) === "/", + splitPath: (filename) => { + var splitPathRe = + /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/; + return splitPathRe.exec(filename).slice(1); + }, + normalizeArray: (parts, allowAboveRoot) => { + var up = 0; + for (var i = parts.length - 1; i >= 0; i--) { + var last = parts[i]; + if (last === ".") { + parts.splice(i, 1); + } else if (last === "..") { + parts.splice(i, 1); + up++; + } else if (up) { + parts.splice(i, 1); + up--; + } + } + if (allowAboveRoot) { + for (; up; up--) { + parts.unshift(".."); + } + } + return parts; + }, + normalize: (path) => { + var isAbsolute = PATH.isAbs(path), + trailingSlash = path.substr(-1) === "/"; + path = PATH.normalizeArray( + path.split("/").filter((p) => !!p), + !isAbsolute, + ).join("/"); + if (!path && !isAbsolute) { + path = "."; + } + if (path && trailingSlash) { + path += "/"; + } + return (isAbsolute ? "/" : "") + path; + }, + dirname: (path) => { + var result = PATH.splitPath(path), + root = result[0], + dir = result[1]; + if (!root && !dir) { + return "."; + } + if (dir) { + dir = dir.substr(0, dir.length - 1); + } + return root + dir; + }, + basename: (path) => { + if (path === "/") return "/"; + path = PATH.normalize(path); + path = path.replace(/\/$/, ""); + var lastSlash = path.lastIndexOf("/"); + if (lastSlash === -1) return path; + return path.substr(lastSlash + 1); + }, + join: function () { + var paths = Array.prototype.slice.call(arguments); + return PATH.normalize(paths.join("/")); + }, + join2: (l, r) => PATH.normalize(l + "/" + r), + }; + + var initRandomFill = () => { + if ( + typeof crypto == "object" && + typeof crypto["getRandomValues"] == "function" + ) { + return (view) => ( + view.set(crypto.getRandomValues(new Uint8Array(view.byteLength))), + view + ); + } else if (ENVIRONMENT_IS_NODE) { + try { + var crypto_module = require("crypto"); + var randomFillSync = crypto_module["randomFillSync"]; + if (randomFillSync) { + return (view) => crypto_module["randomFillSync"](view); + } + var randomBytes = crypto_module["randomBytes"]; + return (view) => (view.set(randomBytes(view.byteLength)), view); + } catch (e) {} + } + abort("initRandomDevice"); + }; + + var randomFill = (view) => (randomFill = initRandomFill())(view); + + var PATH_FS = { + resolve: function () { + var resolvedPath = "", + resolvedAbsolute = false; + for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) { + var path = i >= 0 ? arguments[i] : FS.cwd(); + if (typeof path != "string") { + throw new TypeError("Arguments to path.resolve must be strings"); + } else if (!path) { + return ""; + } + resolvedPath = path + "/" + resolvedPath; + resolvedAbsolute = PATH.isAbs(path); + } + resolvedPath = PATH.normalizeArray( + resolvedPath.split("/").filter((p) => !!p), + !resolvedAbsolute, + ).join("/"); + return (resolvedAbsolute ? "/" : "") + resolvedPath || "."; + }, + relative: (from, to) => { + from = PATH_FS.resolve(from).substr(1); + to = PATH_FS.resolve(to).substr(1); + function trim(arr) { + var start = 0; + for (; start < arr.length; start++) { + if (arr[start] !== "") break; + } + var end = arr.length - 1; + for (; end >= 0; end--) { + if (arr[end] !== "") break; + } + if (start > end) return []; + return arr.slice(start, end - start + 1); + } + var fromParts = trim(from.split("/")); + var toParts = trim(to.split("/")); + var length = Math.min(fromParts.length, toParts.length); + var samePartsLength = length; + for (var i = 0; i < length; i++) { + if (fromParts[i] !== toParts[i]) { + samePartsLength = i; + break; + } + } + var outputParts = []; + for (var i = samePartsLength; i < fromParts.length; i++) { + outputParts.push(".."); + } + outputParts = outputParts.concat(toParts.slice(samePartsLength)); + return outputParts.join("/"); + }, + }; + + var UTF8Decoder = + typeof TextDecoder != "undefined" ? new TextDecoder("utf8") : undefined; + + /** + * Given a pointer 'idx' to a null-terminated UTF8-encoded string in the given + * array that contains uint8 values, returns a copy of that string as a + * Javascript String object. + * heapOrArray is either a regular array, or a JavaScript typed array view. + * @param {number} idx + * @param {number=} maxBytesToRead + * @return {string} + */ var UTF8ArrayToString = (heapOrArray, idx, maxBytesToRead) => { + idx >>>= 0; + var endIdx = idx + maxBytesToRead; + var endPtr = idx; + while (heapOrArray[endPtr] && !(endPtr >= endIdx)) ++endPtr; + if (endPtr - idx > 16 && heapOrArray.buffer && UTF8Decoder) { + return UTF8Decoder.decode(heapOrArray.slice(idx, endPtr)); + } + var str = ""; + while (idx < endPtr) { + var u0 = heapOrArray[idx++]; + if (!(u0 & 128)) { + str += String.fromCharCode(u0); + continue; + } + var u1 = heapOrArray[idx++] & 63; + if ((u0 & 224) == 192) { + str += String.fromCharCode(((u0 & 31) << 6) | u1); + continue; + } + var u2 = heapOrArray[idx++] & 63; + if ((u0 & 240) == 224) { + u0 = ((u0 & 15) << 12) | (u1 << 6) | u2; + } else { + u0 = + ((u0 & 7) << 18) | + (u1 << 12) | + (u2 << 6) | + (heapOrArray[idx++] & 63); + } + if (u0 < 65536) { + str += String.fromCharCode(u0); + } else { + var ch = u0 - 65536; + str += String.fromCharCode(55296 | (ch >> 10), 56320 | (ch & 1023)); + } + } + return str; + }; + + var FS_stdin_getChar_buffer = []; + + var lengthBytesUTF8 = (str) => { + var len = 0; + for (var i = 0; i < str.length; ++i) { + var c = str.charCodeAt(i); + if (c <= 127) { + len++; + } else if (c <= 2047) { + len += 2; + } else if (c >= 55296 && c <= 57343) { + len += 4; + ++i; + } else { + len += 3; + } + } + return len; + }; + + var stringToUTF8Array = (str, heap, outIdx, maxBytesToWrite) => { + outIdx >>>= 0; + if (!(maxBytesToWrite > 0)) return 0; + var startIdx = outIdx; + var endIdx = outIdx + maxBytesToWrite - 1; + for (var i = 0; i < str.length; ++i) { + var u = str.charCodeAt(i); + if (u >= 55296 && u <= 57343) { + var u1 = str.charCodeAt(++i); + u = (65536 + ((u & 1023) << 10)) | (u1 & 1023); + } + if (u <= 127) { + if (outIdx >= endIdx) break; + heap[outIdx++ >>> 0] = u; + } else if (u <= 2047) { + if (outIdx + 1 >= endIdx) break; + heap[outIdx++ >>> 0] = 192 | (u >> 6); + heap[outIdx++ >>> 0] = 128 | (u & 63); + } else if (u <= 65535) { + if (outIdx + 2 >= endIdx) break; + heap[outIdx++ >>> 0] = 224 | (u >> 12); + heap[outIdx++ >>> 0] = 128 | ((u >> 6) & 63); + heap[outIdx++ >>> 0] = 128 | (u & 63); + } else { + if (outIdx + 3 >= endIdx) break; + heap[outIdx++ >>> 0] = 240 | (u >> 18); + heap[outIdx++ >>> 0] = 128 | ((u >> 12) & 63); + heap[outIdx++ >>> 0] = 128 | ((u >> 6) & 63); + heap[outIdx++ >>> 0] = 128 | (u & 63); + } + } + heap[outIdx >>> 0] = 0; + return outIdx - startIdx; + }; + + /** @type {function(string, boolean=, number=)} */ function intArrayFromString( + stringy, + dontAddNull, + length, + ) { + var len = length > 0 ? length : lengthBytesUTF8(stringy) + 1; + var u8array = new Array(len); + var numBytesWritten = stringToUTF8Array( + stringy, + u8array, + 0, + u8array.length, + ); + if (dontAddNull) u8array.length = numBytesWritten; + return u8array; + } + + var FS_stdin_getChar = () => { + if (!FS_stdin_getChar_buffer.length) { + var result = null; + if (ENVIRONMENT_IS_NODE) { + var BUFSIZE = 256; + var buf = Buffer.alloc(BUFSIZE); + var bytesRead = 0; + /** @suppress {missingProperties} */ var fd = process.stdin.fd; + try { + bytesRead = fs.readSync(fd, buf); + } catch (e) { + if (e.toString().includes("EOF")) bytesRead = 0; + else throw e; + } + if (bytesRead > 0) { + result = buf.slice(0, bytesRead).toString("utf-8"); + } else { + result = null; + } + } else if ( + typeof window != "undefined" && + typeof window.prompt == "function" + ) { + result = window.prompt("Input: "); + if (result !== null) { + result += "\n"; + } + } else if (typeof readline == "function") { + result = readline(); + if (result !== null) { + result += "\n"; + } + } + if (!result) { + return null; + } + FS_stdin_getChar_buffer = intArrayFromString(result, true); + } + return FS_stdin_getChar_buffer.shift(); + }; + + var TTY = { + ttys: [], + init() {}, + shutdown() {}, + register(dev, ops) { + TTY.ttys[dev] = { + input: [], + output: [], + ops: ops, + }; + FS.registerDevice(dev, TTY.stream_ops); + }, + stream_ops: { + open(stream) { + var tty = TTY.ttys[stream.node.rdev]; + if (!tty) { + throw new FS.ErrnoError(43); + } + stream.tty = tty; + stream.seekable = false; + }, + close(stream) { + stream.tty.ops.fsync(stream.tty); + }, + fsync(stream) { + stream.tty.ops.fsync(stream.tty); + }, + read(stream, buffer, offset, length, pos) { + /* ignored */ if (!stream.tty || !stream.tty.ops.get_char) { + throw new FS.ErrnoError(60); + } + var bytesRead = 0; + for (var i = 0; i < length; i++) { + var result; + try { + result = stream.tty.ops.get_char(stream.tty); + } catch (e) { + throw new FS.ErrnoError(29); + } + if (result === undefined && bytesRead === 0) { + throw new FS.ErrnoError(6); + } + if (result === null || result === undefined) break; + bytesRead++; + buffer[offset + i] = result; + } + if (bytesRead) { + stream.node.timestamp = Date.now(); + } + return bytesRead; + }, + write(stream, buffer, offset, length, pos) { + if (!stream.tty || !stream.tty.ops.put_char) { + throw new FS.ErrnoError(60); + } + try { + for (var i = 0; i < length; i++) { + stream.tty.ops.put_char(stream.tty, buffer[offset + i]); + } + } catch (e) { + throw new FS.ErrnoError(29); + } + if (length) { + stream.node.timestamp = Date.now(); + } + return i; + }, + }, + default_tty_ops: { + get_char(tty) { + return FS_stdin_getChar(); + }, + put_char(tty, val) { + if (val === null || val === 10) { + out(UTF8ArrayToString(tty.output, 0)); + tty.output = []; + } else { + if (val != 0) tty.output.push(val); + } + }, + fsync(tty) { + if (tty.output && tty.output.length > 0) { + out(UTF8ArrayToString(tty.output, 0)); + tty.output = []; + } + }, + ioctl_tcgets(tty) { + return { + c_iflag: 25856, + c_oflag: 5, + c_cflag: 191, + c_lflag: 35387, + c_cc: [ + 3, 28, 127, 21, 4, 0, 1, 0, 17, 19, 26, 0, 18, 15, 23, 22, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + ], + }; + }, + ioctl_tcsets(tty, optional_actions, data) { + return 0; + }, + ioctl_tiocgwinsz(tty) { + return [24, 80]; + }, + }, + default_tty1_ops: { + put_char(tty, val) { + if (val === null || val === 10) { + err(UTF8ArrayToString(tty.output, 0)); + tty.output = []; + } else { + if (val != 0) tty.output.push(val); + } + }, + fsync(tty) { + if (tty.output && tty.output.length > 0) { + err(UTF8ArrayToString(tty.output, 0)); + tty.output = []; + } + }, + }, + }; + + var alignMemory = (size, alignment) => + Math.ceil(size / alignment) * alignment; + + var mmapAlloc = (size) => { + size = alignMemory(size, 65536); + var ptr = _emscripten_builtin_memalign(65536, size); + if (!ptr) return 0; + return zeroMemory(ptr, size); + }; + + var MEMFS = { + ops_table: null, + mount(mount) { + return MEMFS.createNode(null, "/", 16384 | 511, /* 0777 */ 0); + }, + createNode(parent, name, mode, dev) { + if (FS.isBlkdev(mode) || FS.isFIFO(mode)) { + throw new FS.ErrnoError(63); + } + if (!MEMFS.ops_table) { + MEMFS.ops_table = { + dir: { + node: { + getattr: MEMFS.node_ops.getattr, + setattr: MEMFS.node_ops.setattr, + lookup: MEMFS.node_ops.lookup, + mknod: MEMFS.node_ops.mknod, + rename: MEMFS.node_ops.rename, + unlink: MEMFS.node_ops.unlink, + rmdir: MEMFS.node_ops.rmdir, + readdir: MEMFS.node_ops.readdir, + symlink: MEMFS.node_ops.symlink, + }, + stream: { + llseek: MEMFS.stream_ops.llseek, + }, + }, + file: { + node: { + getattr: MEMFS.node_ops.getattr, + setattr: MEMFS.node_ops.setattr, + }, + stream: { + llseek: MEMFS.stream_ops.llseek, + read: MEMFS.stream_ops.read, + write: MEMFS.stream_ops.write, + allocate: MEMFS.stream_ops.allocate, + mmap: MEMFS.stream_ops.mmap, + msync: MEMFS.stream_ops.msync, + }, + }, + link: { + node: { + getattr: MEMFS.node_ops.getattr, + setattr: MEMFS.node_ops.setattr, + readlink: MEMFS.node_ops.readlink, + }, + stream: {}, + }, + chrdev: { + node: { + getattr: MEMFS.node_ops.getattr, + setattr: MEMFS.node_ops.setattr, + }, + stream: FS.chrdev_stream_ops, + }, + }; + } + var node = FS.createNode(parent, name, mode, dev); + if (FS.isDir(node.mode)) { + node.node_ops = MEMFS.ops_table.dir.node; + node.stream_ops = MEMFS.ops_table.dir.stream; + node.contents = {}; + } else if (FS.isFile(node.mode)) { + node.node_ops = MEMFS.ops_table.file.node; + node.stream_ops = MEMFS.ops_table.file.stream; + node.usedBytes = 0; + node.contents = null; + } else if (FS.isLink(node.mode)) { + node.node_ops = MEMFS.ops_table.link.node; + node.stream_ops = MEMFS.ops_table.link.stream; + } else if (FS.isChrdev(node.mode)) { + node.node_ops = MEMFS.ops_table.chrdev.node; + node.stream_ops = MEMFS.ops_table.chrdev.stream; + } + node.timestamp = Date.now(); + if (parent) { + parent.contents[name] = node; + parent.timestamp = node.timestamp; + } + return node; + }, + getFileDataAsTypedArray(node) { + if (!node.contents) return new Uint8Array(0); + if (node.contents.subarray) + return node.contents.subarray(0, node.usedBytes); + return new Uint8Array(node.contents); + }, + expandFileStorage(node, newCapacity) { + var prevCapacity = node.contents ? node.contents.length : 0; + if (prevCapacity >= newCapacity) return; + var CAPACITY_DOUBLING_MAX = 1024 * 1024; + newCapacity = Math.max( + newCapacity, + (prevCapacity * + (prevCapacity < CAPACITY_DOUBLING_MAX ? 2 : 1.125)) >>> + 0, + ); + if (prevCapacity != 0) newCapacity = Math.max(newCapacity, 256); + var oldContents = node.contents; + node.contents = new Uint8Array(newCapacity); + if (node.usedBytes > 0) + node.contents.set(oldContents.subarray(0, node.usedBytes), 0); + }, + resizeFileStorage(node, newSize) { + if (node.usedBytes == newSize) return; + if (newSize == 0) { + node.contents = null; + node.usedBytes = 0; + } else { + var oldContents = node.contents; + node.contents = new Uint8Array(newSize); + if (oldContents) { + node.contents.set( + oldContents.subarray(0, Math.min(newSize, node.usedBytes)), + ); + } + node.usedBytes = newSize; + } + }, + node_ops: { + getattr(node) { + var attr = {}; + attr.dev = FS.isChrdev(node.mode) ? node.id : 1; + attr.ino = node.id; + attr.mode = node.mode; + attr.nlink = 1; + attr.uid = 0; + attr.gid = 0; + attr.rdev = node.rdev; + if (FS.isDir(node.mode)) { + attr.size = 4096; + } else if (FS.isFile(node.mode)) { + attr.size = node.usedBytes; + } else if (FS.isLink(node.mode)) { + attr.size = node.link.length; + } else { + attr.size = 0; + } + attr.atime = new Date(node.timestamp); + attr.mtime = new Date(node.timestamp); + attr.ctime = new Date(node.timestamp); + attr.blksize = 4096; + attr.blocks = Math.ceil(attr.size / attr.blksize); + return attr; + }, + setattr(node, attr) { + if (attr.mode !== undefined) { + node.mode = attr.mode; + } + if (attr.timestamp !== undefined) { + node.timestamp = attr.timestamp; + } + if (attr.size !== undefined) { + MEMFS.resizeFileStorage(node, attr.size); + } + }, + lookup(parent, name) { + throw FS.genericErrors[44]; + }, + mknod(parent, name, mode, dev) { + return MEMFS.createNode(parent, name, mode, dev); + }, + rename(old_node, new_dir, new_name) { + if (FS.isDir(old_node.mode)) { + var new_node; + try { + new_node = FS.lookupNode(new_dir, new_name); + } catch (e) {} + if (new_node) { + for (var i in new_node.contents) { + throw new FS.ErrnoError(55); + } + } + } + delete old_node.parent.contents[old_node.name]; + old_node.parent.timestamp = Date.now(); + old_node.name = new_name; + new_dir.contents[new_name] = old_node; + new_dir.timestamp = old_node.parent.timestamp; + old_node.parent = new_dir; + }, + unlink(parent, name) { + delete parent.contents[name]; + parent.timestamp = Date.now(); + }, + rmdir(parent, name) { + var node = FS.lookupNode(parent, name); + for (var i in node.contents) { + throw new FS.ErrnoError(55); + } + delete parent.contents[name]; + parent.timestamp = Date.now(); + }, + readdir(node) { + var entries = [".", ".."]; + for (var key in node.contents) { + if (!node.contents.hasOwnProperty(key)) { + continue; + } + entries.push(key); + } + return entries; + }, + symlink(parent, newname, oldpath) { + var node = MEMFS.createNode( + parent, + newname, + 511 | /* 0777 */ 40960, + 0, + ); + node.link = oldpath; + return node; + }, + readlink(node) { + if (!FS.isLink(node.mode)) { + throw new FS.ErrnoError(28); + } + return node.link; + }, + }, + stream_ops: { + read(stream, buffer, offset, length, position) { + var contents = stream.node.contents; + if (position >= stream.node.usedBytes) return 0; + var size = Math.min(stream.node.usedBytes - position, length); + if (size > 8 && contents.subarray) { + buffer.set(contents.subarray(position, position + size), offset); + } else { + for (var i = 0; i < size; i++) + buffer[offset + i] = contents[position + i]; + } + return size; + }, + write(stream, buffer, offset, length, position, canOwn) { + if (buffer.buffer === GROWABLE_HEAP_I8().buffer) { + canOwn = false; + } + if (!length) return 0; + var node = stream.node; + node.timestamp = Date.now(); + if (buffer.subarray && (!node.contents || node.contents.subarray)) { + if (canOwn) { + node.contents = buffer.subarray(offset, offset + length); + node.usedBytes = length; + return length; + } else if (node.usedBytes === 0 && position === 0) { + node.contents = buffer.slice(offset, offset + length); + node.usedBytes = length; + return length; + } else if (position + length <= node.usedBytes) { + node.contents.set( + buffer.subarray(offset, offset + length), + position, + ); + return length; + } + } + MEMFS.expandFileStorage(node, position + length); + if (node.contents.subarray && buffer.subarray) { + node.contents.set( + buffer.subarray(offset, offset + length), + position, + ); + } else { + for (var i = 0; i < length; i++) { + node.contents[position + i] = buffer[offset + i]; + } + } + node.usedBytes = Math.max(node.usedBytes, position + length); + return length; + }, + llseek(stream, offset, whence) { + var position = offset; + if (whence === 1) { + position += stream.position; + } else if (whence === 2) { + if (FS.isFile(stream.node.mode)) { + position += stream.node.usedBytes; + } + } + if (position < 0) { + throw new FS.ErrnoError(28); + } + return position; + }, + allocate(stream, offset, length) { + MEMFS.expandFileStorage(stream.node, offset + length); + stream.node.usedBytes = Math.max( + stream.node.usedBytes, + offset + length, + ); + }, + mmap(stream, length, position, prot, flags) { + if (!FS.isFile(stream.node.mode)) { + throw new FS.ErrnoError(43); + } + var ptr; + var allocated; + var contents = stream.node.contents; + if (!(flags & 2) && contents.buffer === GROWABLE_HEAP_I8().buffer) { + allocated = false; + ptr = contents.byteOffset; + } else { + if (position > 0 || position + length < contents.length) { + if (contents.subarray) { + contents = contents.subarray(position, position + length); + } else { + contents = Array.prototype.slice.call( + contents, + position, + position + length, + ); + } + } + allocated = true; + ptr = mmapAlloc(length); + if (!ptr) { + throw new FS.ErrnoError(48); + } + GROWABLE_HEAP_I8().set(contents, ptr >>> 0); + } + return { + ptr: ptr, + allocated: allocated, + }; + }, + msync(stream, buffer, offset, length, mmapFlags) { + MEMFS.stream_ops.write(stream, buffer, 0, length, offset, false); + return 0; + }, + }, + }; + + /** @param {boolean=} noRunDep */ var asyncLoad = ( + url, + onload, + onerror, + noRunDep, + ) => { + var dep = !noRunDep ? getUniqueRunDependency(`al ${url}`) : ""; + readAsync( + url, + (arrayBuffer) => { + assert( + arrayBuffer, + `Loading data file "${url}" failed (no arrayBuffer).`, + ); + onload(new Uint8Array(arrayBuffer)); + if (dep) removeRunDependency(dep); + }, + (event) => { + if (onerror) { + onerror(); + } else { + throw `Loading data file "${url}" failed.`; + } + }, + ); + if (dep) addRunDependency(dep); + }; + + var FS_createDataFile = ( + parent, + name, + fileData, + canRead, + canWrite, + canOwn, + ) => FS.createDataFile(parent, name, fileData, canRead, canWrite, canOwn); + + var preloadPlugins = Module["preloadPlugins"] || []; + + var FS_handledByPreloadPlugin = (byteArray, fullname, finish, onerror) => { + if (typeof Browser != "undefined") Browser.init(); + var handled = false; + preloadPlugins.forEach((plugin) => { + if (handled) return; + if (plugin["canHandle"](fullname)) { + plugin["handle"](byteArray, fullname, finish, onerror); + handled = true; + } + }); + return handled; + }; + + var FS_createPreloadedFile = ( + parent, + name, + url, + canRead, + canWrite, + onload, + onerror, + dontCreateFile, + canOwn, + preFinish, + ) => { + var fullname = name ? PATH_FS.resolve(PATH.join2(parent, name)) : parent; + var dep = getUniqueRunDependency(`cp ${fullname}`); + function processData(byteArray) { + function finish(byteArray) { + if (preFinish) preFinish(); + if (!dontCreateFile) { + FS_createDataFile( + parent, + name, + byteArray, + canRead, + canWrite, + canOwn, + ); + } + if (onload) onload(); + removeRunDependency(dep); + } + if ( + FS_handledByPreloadPlugin(byteArray, fullname, finish, () => { + if (onerror) onerror(); + removeRunDependency(dep); + }) + ) { + return; + } + finish(byteArray); + } + addRunDependency(dep); + if (typeof url == "string") { + asyncLoad(url, (byteArray) => processData(byteArray), onerror); + } else { + processData(url); + } + }; + + var FS_modeStringToFlags = (str) => { + var flagModes = { + r: 0, + "r+": 2, + w: 512 | 64 | 1, + "w+": 512 | 64 | 2, + a: 1024 | 64 | 1, + "a+": 1024 | 64 | 2, + }; + var flags = flagModes[str]; + if (typeof flags == "undefined") { + throw new Error(`Unknown file open mode: ${str}`); + } + return flags; + }; + + var FS_getMode = (canRead, canWrite) => { + var mode = 0; + if (canRead) mode |= 292 | 73; + if (canWrite) mode |= 146; + return mode; + }; + + var FS = { + root: null, + mounts: [], + devices: {}, + streams: [], + nextInode: 1, + nameTable: null, + currentPath: "/", + initialized: false, + ignorePermissions: true, + ErrnoError: null, + genericErrors: {}, + filesystems: null, + syncFSRequests: 0, + lookupPath(path, opts = {}) { + path = PATH_FS.resolve(path); + if (!path) + return { + path: "", + node: null, + }; + var defaults = { + follow_mount: true, + recurse_count: 0, + }; + opts = Object.assign(defaults, opts); + if (opts.recurse_count > 8) { + throw new FS.ErrnoError(32); + } + var parts = path.split("/").filter((p) => !!p); + var current = FS.root; + var current_path = "/"; + for (var i = 0; i < parts.length; i++) { + var islast = i === parts.length - 1; + if (islast && opts.parent) { + break; + } + current = FS.lookupNode(current, parts[i]); + current_path = PATH.join2(current_path, parts[i]); + if (FS.isMountpoint(current)) { + if (!islast || (islast && opts.follow_mount)) { + current = current.mounted.root; + } + } + if (!islast || opts.follow) { + var count = 0; + while (FS.isLink(current.mode)) { + var link = FS.readlink(current_path); + current_path = PATH_FS.resolve(PATH.dirname(current_path), link); + var lookup = FS.lookupPath(current_path, { + recurse_count: opts.recurse_count + 1, + }); + current = lookup.node; + if (count++ > 40) { + throw new FS.ErrnoError(32); + } + } + } + } + return { + path: current_path, + node: current, + }; + }, + getPath(node) { + var path; + while (true) { + if (FS.isRoot(node)) { + var mount = node.mount.mountpoint; + if (!path) return mount; + return mount[mount.length - 1] !== "/" + ? `${mount}/${path}` + : mount + path; + } + path = path ? `${node.name}/${path}` : node.name; + node = node.parent; + } + }, + hashName(parentid, name) { + var hash = 0; + for (var i = 0; i < name.length; i++) { + hash = ((hash << 5) - hash + name.charCodeAt(i)) | 0; + } + return ((parentid + hash) >>> 0) % FS.nameTable.length; + }, + hashAddNode(node) { + var hash = FS.hashName(node.parent.id, node.name); + node.name_next = FS.nameTable[hash]; + FS.nameTable[hash] = node; + }, + hashRemoveNode(node) { + var hash = FS.hashName(node.parent.id, node.name); + if (FS.nameTable[hash] === node) { + FS.nameTable[hash] = node.name_next; + } else { + var current = FS.nameTable[hash]; + while (current) { + if (current.name_next === node) { + current.name_next = node.name_next; + break; + } + current = current.name_next; + } + } + }, + lookupNode(parent, name) { + var errCode = FS.mayLookup(parent); + if (errCode) { + throw new FS.ErrnoError(errCode, parent); + } + var hash = FS.hashName(parent.id, name); + for (var node = FS.nameTable[hash]; node; node = node.name_next) { + var nodeName = node.name; + if (node.parent.id === parent.id && nodeName === name) { + return node; + } + } + return FS.lookup(parent, name); + }, + createNode(parent, name, mode, rdev) { + var node = new FS.FSNode(parent, name, mode, rdev); + FS.hashAddNode(node); + return node; + }, + destroyNode(node) { + FS.hashRemoveNode(node); + }, + isRoot(node) { + return node === node.parent; + }, + isMountpoint(node) { + return !!node.mounted; + }, + isFile(mode) { + return (mode & 61440) === 32768; + }, + isDir(mode) { + return (mode & 61440) === 16384; + }, + isLink(mode) { + return (mode & 61440) === 40960; + }, + isChrdev(mode) { + return (mode & 61440) === 8192; + }, + isBlkdev(mode) { + return (mode & 61440) === 24576; + }, + isFIFO(mode) { + return (mode & 61440) === 4096; + }, + isSocket(mode) { + return (mode & 49152) === 49152; + }, + flagsToPermissionString(flag) { + var perms = ["r", "w", "rw"][flag & 3]; + if (flag & 512) { + perms += "w"; + } + return perms; + }, + nodePermissions(node, perms) { + if (FS.ignorePermissions) { + return 0; + } + if (perms.includes("r") && !(node.mode & 292)) { + return 2; + } else if (perms.includes("w") && !(node.mode & 146)) { + return 2; + } else if (perms.includes("x") && !(node.mode & 73)) { + return 2; + } + return 0; + }, + mayLookup(dir) { + var errCode = FS.nodePermissions(dir, "x"); + if (errCode) return errCode; + if (!dir.node_ops.lookup) return 2; + return 0; + }, + mayCreate(dir, name) { + try { + var node = FS.lookupNode(dir, name); + return 20; + } catch (e) {} + return FS.nodePermissions(dir, "wx"); + }, + mayDelete(dir, name, isdir) { + var node; + try { + node = FS.lookupNode(dir, name); + } catch (e) { + return e.errno; + } + var errCode = FS.nodePermissions(dir, "wx"); + if (errCode) { + return errCode; + } + if (isdir) { + if (!FS.isDir(node.mode)) { + return 54; + } + if (FS.isRoot(node) || FS.getPath(node) === FS.cwd()) { + return 10; + } + } else { + if (FS.isDir(node.mode)) { + return 31; + } + } + return 0; + }, + mayOpen(node, flags) { + if (!node) { + return 44; + } + if (FS.isLink(node.mode)) { + return 32; + } else if (FS.isDir(node.mode)) { + if (FS.flagsToPermissionString(flags) !== "r" || flags & 512) { + return 31; + } + } + return FS.nodePermissions(node, FS.flagsToPermissionString(flags)); + }, + MAX_OPEN_FDS: 4096, + nextfd() { + for (var fd = 0; fd <= FS.MAX_OPEN_FDS; fd++) { + if (!FS.streams[fd]) { + return fd; + } + } + throw new FS.ErrnoError(33); + }, + getStreamChecked(fd) { + var stream = FS.getStream(fd); + if (!stream) { + throw new FS.ErrnoError(8); + } + return stream; + }, + getStream: (fd) => FS.streams[fd], + createStream(stream, fd = -1) { + if (!FS.FSStream) { + FS.FSStream = /** @constructor */ function () { + this.shared = {}; + }; + FS.FSStream.prototype = {}; + Object.defineProperties(FS.FSStream.prototype, { + object: { + /** @this {FS.FSStream} */ get() { + return this.node; + }, + /** @this {FS.FSStream} */ set(val) { + this.node = val; + }, + }, + isRead: { + /** @this {FS.FSStream} */ get() { + return (this.flags & 2097155) !== 1; + }, + }, + isWrite: { + /** @this {FS.FSStream} */ get() { + return (this.flags & 2097155) !== 0; + }, + }, + isAppend: { + /** @this {FS.FSStream} */ get() { + return this.flags & 1024; + }, + }, + flags: { + /** @this {FS.FSStream} */ get() { + return this.shared.flags; + }, + /** @this {FS.FSStream} */ set(val) { + this.shared.flags = val; + }, + }, + position: { + /** @this {FS.FSStream} */ get() { + return this.shared.position; + }, + /** @this {FS.FSStream} */ set(val) { + this.shared.position = val; + }, + }, + }); + } + stream = Object.assign(new FS.FSStream(), stream); + if (fd == -1) { + fd = FS.nextfd(); + } + stream.fd = fd; + FS.streams[fd] = stream; + return stream; + }, + closeStream(fd) { + FS.streams[fd] = null; + }, + chrdev_stream_ops: { + open(stream) { + var device = FS.getDevice(stream.node.rdev); + stream.stream_ops = device.stream_ops; + if (stream.stream_ops.open) { + stream.stream_ops.open(stream); + } + }, + llseek() { + throw new FS.ErrnoError(70); + }, + }, + major: (dev) => dev >> 8, + minor: (dev) => dev & 255, + makedev: (ma, mi) => (ma << 8) | mi, + registerDevice(dev, ops) { + FS.devices[dev] = { + stream_ops: ops, + }; + }, + getDevice: (dev) => FS.devices[dev], + getMounts(mount) { + var mounts = []; + var check = [mount]; + while (check.length) { + var m = check.pop(); + mounts.push(m); + check.push.apply(check, m.mounts); + } + return mounts; + }, + syncfs(populate, callback) { + if (typeof populate == "function") { + callback = populate; + populate = false; + } + FS.syncFSRequests++; + if (FS.syncFSRequests > 1) { + err( + `warning: ${FS.syncFSRequests} FS.syncfs operations in flight at once, probably just doing extra work`, + ); + } + var mounts = FS.getMounts(FS.root.mount); + var completed = 0; + function doCallback(errCode) { + FS.syncFSRequests--; + return callback(errCode); + } + function done(errCode) { + if (errCode) { + if (!done.errored) { + done.errored = true; + return doCallback(errCode); + } + return; + } + if (++completed >= mounts.length) { + doCallback(null); + } + } + mounts.forEach((mount) => { + if (!mount.type.syncfs) { + return done(null); + } + mount.type.syncfs(mount, populate, done); + }); + }, + mount(type, opts, mountpoint) { + var root = mountpoint === "/"; + var pseudo = !mountpoint; + var node; + if (root && FS.root) { + throw new FS.ErrnoError(10); + } else if (!root && !pseudo) { + var lookup = FS.lookupPath(mountpoint, { + follow_mount: false, + }); + mountpoint = lookup.path; + node = lookup.node; + if (FS.isMountpoint(node)) { + throw new FS.ErrnoError(10); + } + if (!FS.isDir(node.mode)) { + throw new FS.ErrnoError(54); + } + } + var mount = { + type: type, + opts: opts, + mountpoint: mountpoint, + mounts: [], + }; + var mountRoot = type.mount(mount); + mountRoot.mount = mount; + mount.root = mountRoot; + if (root) { + FS.root = mountRoot; + } else if (node) { + node.mounted = mount; + if (node.mount) { + node.mount.mounts.push(mount); + } + } + return mountRoot; + }, + unmount(mountpoint) { + var lookup = FS.lookupPath(mountpoint, { + follow_mount: false, + }); + if (!FS.isMountpoint(lookup.node)) { + throw new FS.ErrnoError(28); + } + var node = lookup.node; + var mount = node.mounted; + var mounts = FS.getMounts(mount); + Object.keys(FS.nameTable).forEach((hash) => { + var current = FS.nameTable[hash]; + while (current) { + var next = current.name_next; + if (mounts.includes(current.mount)) { + FS.destroyNode(current); + } + current = next; + } + }); + node.mounted = null; + var idx = node.mount.mounts.indexOf(mount); + node.mount.mounts.splice(idx, 1); + }, + lookup(parent, name) { + return parent.node_ops.lookup(parent, name); + }, + mknod(path, mode, dev) { + var lookup = FS.lookupPath(path, { + parent: true, + }); + var parent = lookup.node; + var name = PATH.basename(path); + if (!name || name === "." || name === "..") { + throw new FS.ErrnoError(28); + } + var errCode = FS.mayCreate(parent, name); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + if (!parent.node_ops.mknod) { + throw new FS.ErrnoError(63); + } + return parent.node_ops.mknod(parent, name, mode, dev); + }, + create(path, mode) { + mode = mode !== undefined ? mode : 438; + /* 0666 */ mode &= 4095; + mode |= 32768; + return FS.mknod(path, mode, 0); + }, + mkdir(path, mode) { + mode = mode !== undefined ? mode : 511; + /* 0777 */ mode &= 511 | 512; + mode |= 16384; + return FS.mknod(path, mode, 0); + }, + mkdirTree(path, mode) { + var dirs = path.split("/"); + var d = ""; + for (var i = 0; i < dirs.length; ++i) { + if (!dirs[i]) continue; + d += "/" + dirs[i]; + try { + FS.mkdir(d, mode); + } catch (e) { + if (e.errno != 20) throw e; + } + } + }, + mkdev(path, mode, dev) { + if (typeof dev == "undefined") { + dev = mode; + mode = 438; + } + /* 0666 */ mode |= 8192; + return FS.mknod(path, mode, dev); + }, + symlink(oldpath, newpath) { + if (!PATH_FS.resolve(oldpath)) { + throw new FS.ErrnoError(44); + } + var lookup = FS.lookupPath(newpath, { + parent: true, + }); + var parent = lookup.node; + if (!parent) { + throw new FS.ErrnoError(44); + } + var newname = PATH.basename(newpath); + var errCode = FS.mayCreate(parent, newname); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + if (!parent.node_ops.symlink) { + throw new FS.ErrnoError(63); + } + return parent.node_ops.symlink(parent, newname, oldpath); + }, + rename(old_path, new_path) { + var old_dirname = PATH.dirname(old_path); + var new_dirname = PATH.dirname(new_path); + var old_name = PATH.basename(old_path); + var new_name = PATH.basename(new_path); + var lookup, old_dir, new_dir; + lookup = FS.lookupPath(old_path, { + parent: true, + }); + old_dir = lookup.node; + lookup = FS.lookupPath(new_path, { + parent: true, + }); + new_dir = lookup.node; + if (!old_dir || !new_dir) throw new FS.ErrnoError(44); + if (old_dir.mount !== new_dir.mount) { + throw new FS.ErrnoError(75); + } + var old_node = FS.lookupNode(old_dir, old_name); + var relative = PATH_FS.relative(old_path, new_dirname); + if (relative.charAt(0) !== ".") { + throw new FS.ErrnoError(28); + } + relative = PATH_FS.relative(new_path, old_dirname); + if (relative.charAt(0) !== ".") { + throw new FS.ErrnoError(55); + } + var new_node; + try { + new_node = FS.lookupNode(new_dir, new_name); + } catch (e) {} + if (old_node === new_node) { + return; + } + var isdir = FS.isDir(old_node.mode); + var errCode = FS.mayDelete(old_dir, old_name, isdir); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + errCode = new_node + ? FS.mayDelete(new_dir, new_name, isdir) + : FS.mayCreate(new_dir, new_name); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + if (!old_dir.node_ops.rename) { + throw new FS.ErrnoError(63); + } + if ( + FS.isMountpoint(old_node) || + (new_node && FS.isMountpoint(new_node)) + ) { + throw new FS.ErrnoError(10); + } + if (new_dir !== old_dir) { + errCode = FS.nodePermissions(old_dir, "w"); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + } + FS.hashRemoveNode(old_node); + try { + old_dir.node_ops.rename(old_node, new_dir, new_name); + } catch (e) { + throw e; + } finally { + FS.hashAddNode(old_node); + } + }, + rmdir(path) { + var lookup = FS.lookupPath(path, { + parent: true, + }); + var parent = lookup.node; + var name = PATH.basename(path); + var node = FS.lookupNode(parent, name); + var errCode = FS.mayDelete(parent, name, true); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + if (!parent.node_ops.rmdir) { + throw new FS.ErrnoError(63); + } + if (FS.isMountpoint(node)) { + throw new FS.ErrnoError(10); + } + parent.node_ops.rmdir(parent, name); + FS.destroyNode(node); + }, + readdir(path) { + var lookup = FS.lookupPath(path, { + follow: true, + }); + var node = lookup.node; + if (!node.node_ops.readdir) { + throw new FS.ErrnoError(54); + } + return node.node_ops.readdir(node); + }, + unlink(path) { + var lookup = FS.lookupPath(path, { + parent: true, + }); + var parent = lookup.node; + if (!parent) { + throw new FS.ErrnoError(44); + } + var name = PATH.basename(path); + var node = FS.lookupNode(parent, name); + var errCode = FS.mayDelete(parent, name, false); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + if (!parent.node_ops.unlink) { + throw new FS.ErrnoError(63); + } + if (FS.isMountpoint(node)) { + throw new FS.ErrnoError(10); + } + parent.node_ops.unlink(parent, name); + FS.destroyNode(node); + }, + readlink(path) { + var lookup = FS.lookupPath(path); + var link = lookup.node; + if (!link) { + throw new FS.ErrnoError(44); + } + if (!link.node_ops.readlink) { + throw new FS.ErrnoError(28); + } + return PATH_FS.resolve( + FS.getPath(link.parent), + link.node_ops.readlink(link), + ); + }, + stat(path, dontFollow) { + var lookup = FS.lookupPath(path, { + follow: !dontFollow, + }); + var node = lookup.node; + if (!node) { + throw new FS.ErrnoError(44); + } + if (!node.node_ops.getattr) { + throw new FS.ErrnoError(63); + } + return node.node_ops.getattr(node); + }, + lstat(path) { + return FS.stat(path, true); + }, + chmod(path, mode, dontFollow) { + var node; + if (typeof path == "string") { + var lookup = FS.lookupPath(path, { + follow: !dontFollow, + }); + node = lookup.node; + } else { + node = path; + } + if (!node.node_ops.setattr) { + throw new FS.ErrnoError(63); + } + node.node_ops.setattr(node, { + mode: (mode & 4095) | (node.mode & ~4095), + timestamp: Date.now(), + }); + }, + lchmod(path, mode) { + FS.chmod(path, mode, true); + }, + fchmod(fd, mode) { + var stream = FS.getStreamChecked(fd); + FS.chmod(stream.node, mode); + }, + chown(path, uid, gid, dontFollow) { + var node; + if (typeof path == "string") { + var lookup = FS.lookupPath(path, { + follow: !dontFollow, + }); + node = lookup.node; + } else { + node = path; + } + if (!node.node_ops.setattr) { + throw new FS.ErrnoError(63); + } + node.node_ops.setattr(node, { + timestamp: Date.now(), + }); + }, + lchown(path, uid, gid) { + FS.chown(path, uid, gid, true); + }, + fchown(fd, uid, gid) { + var stream = FS.getStreamChecked(fd); + FS.chown(stream.node, uid, gid); + }, + truncate(path, len) { + if (len < 0) { + throw new FS.ErrnoError(28); + } + var node; + if (typeof path == "string") { + var lookup = FS.lookupPath(path, { + follow: true, + }); + node = lookup.node; + } else { + node = path; + } + if (!node.node_ops.setattr) { + throw new FS.ErrnoError(63); + } + if (FS.isDir(node.mode)) { + throw new FS.ErrnoError(31); + } + if (!FS.isFile(node.mode)) { + throw new FS.ErrnoError(28); + } + var errCode = FS.nodePermissions(node, "w"); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + node.node_ops.setattr(node, { + size: len, + timestamp: Date.now(), + }); + }, + ftruncate(fd, len) { + var stream = FS.getStreamChecked(fd); + if ((stream.flags & 2097155) === 0) { + throw new FS.ErrnoError(28); + } + FS.truncate(stream.node, len); + }, + utime(path, atime, mtime) { + var lookup = FS.lookupPath(path, { + follow: true, + }); + var node = lookup.node; + node.node_ops.setattr(node, { + timestamp: Math.max(atime, mtime), + }); + }, + open(path, flags, mode) { + if (path === "") { + throw new FS.ErrnoError(44); + } + flags = typeof flags == "string" ? FS_modeStringToFlags(flags) : flags; + mode = typeof mode == "undefined" ? 438 : /* 0666 */ mode; + if (flags & 64) { + mode = (mode & 4095) | 32768; + } else { + mode = 0; + } + var node; + if (typeof path == "object") { + node = path; + } else { + path = PATH.normalize(path); + try { + var lookup = FS.lookupPath(path, { + follow: !(flags & 131072), + }); + node = lookup.node; + } catch (e) {} + } + var created = false; + if (flags & 64) { + if (node) { + if (flags & 128) { + throw new FS.ErrnoError(20); + } + } else { + node = FS.mknod(path, mode, 0); + created = true; + } + } + if (!node) { + throw new FS.ErrnoError(44); + } + if (FS.isChrdev(node.mode)) { + flags &= ~512; + } + if (flags & 65536 && !FS.isDir(node.mode)) { + throw new FS.ErrnoError(54); + } + if (!created) { + var errCode = FS.mayOpen(node, flags); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + } + if (flags & 512 && !created) { + FS.truncate(node, 0); + } + flags &= ~(128 | 512 | 131072); + var stream = FS.createStream({ + node: node, + path: FS.getPath(node), + flags: flags, + seekable: true, + position: 0, + stream_ops: node.stream_ops, + ungotten: [], + error: false, + }); + if (stream.stream_ops.open) { + stream.stream_ops.open(stream); + } + if (Module["logReadFiles"] && !(flags & 1)) { + if (!FS.readFiles) FS.readFiles = {}; + if (!(path in FS.readFiles)) { + FS.readFiles[path] = 1; + } + } + return stream; + }, + close(stream) { + if (FS.isClosed(stream)) { + throw new FS.ErrnoError(8); + } + if (stream.getdents) stream.getdents = null; + try { + if (stream.stream_ops.close) { + stream.stream_ops.close(stream); + } + } catch (e) { + throw e; + } finally { + FS.closeStream(stream.fd); + } + stream.fd = null; + }, + isClosed(stream) { + return stream.fd === null; + }, + llseek(stream, offset, whence) { + if (FS.isClosed(stream)) { + throw new FS.ErrnoError(8); + } + if (!stream.seekable || !stream.stream_ops.llseek) { + throw new FS.ErrnoError(70); + } + if (whence != 0 && whence != 1 && whence != 2) { + throw new FS.ErrnoError(28); + } + stream.position = stream.stream_ops.llseek(stream, offset, whence); + stream.ungotten = []; + return stream.position; + }, + read(stream, buffer, offset, length, position) { + if (length < 0 || position < 0) { + throw new FS.ErrnoError(28); + } + if (FS.isClosed(stream)) { + throw new FS.ErrnoError(8); + } + if ((stream.flags & 2097155) === 1) { + throw new FS.ErrnoError(8); + } + if (FS.isDir(stream.node.mode)) { + throw new FS.ErrnoError(31); + } + if (!stream.stream_ops.read) { + throw new FS.ErrnoError(28); + } + var seeking = typeof position != "undefined"; + if (!seeking) { + position = stream.position; + } else if (!stream.seekable) { + throw new FS.ErrnoError(70); + } + var bytesRead = stream.stream_ops.read( + stream, + buffer, + offset, + length, + position, + ); + if (!seeking) stream.position += bytesRead; + return bytesRead; + }, + write(stream, buffer, offset, length, position, canOwn) { + if (length < 0 || position < 0) { + throw new FS.ErrnoError(28); + } + if (FS.isClosed(stream)) { + throw new FS.ErrnoError(8); + } + if ((stream.flags & 2097155) === 0) { + throw new FS.ErrnoError(8); + } + if (FS.isDir(stream.node.mode)) { + throw new FS.ErrnoError(31); + } + if (!stream.stream_ops.write) { + throw new FS.ErrnoError(28); + } + if (stream.seekable && stream.flags & 1024) { + FS.llseek(stream, 0, 2); + } + var seeking = typeof position != "undefined"; + if (!seeking) { + position = stream.position; + } else if (!stream.seekable) { + throw new FS.ErrnoError(70); + } + var bytesWritten = stream.stream_ops.write( + stream, + buffer, + offset, + length, + position, + canOwn, + ); + if (!seeking) stream.position += bytesWritten; + return bytesWritten; + }, + allocate(stream, offset, length) { + if (FS.isClosed(stream)) { + throw new FS.ErrnoError(8); + } + if (offset < 0 || length <= 0) { + throw new FS.ErrnoError(28); + } + if ((stream.flags & 2097155) === 0) { + throw new FS.ErrnoError(8); + } + if (!FS.isFile(stream.node.mode) && !FS.isDir(stream.node.mode)) { + throw new FS.ErrnoError(43); + } + if (!stream.stream_ops.allocate) { + throw new FS.ErrnoError(138); + } + stream.stream_ops.allocate(stream, offset, length); + }, + mmap(stream, length, position, prot, flags) { + if ( + (prot & 2) !== 0 && + (flags & 2) === 0 && + (stream.flags & 2097155) !== 2 + ) { + throw new FS.ErrnoError(2); + } + if ((stream.flags & 2097155) === 1) { + throw new FS.ErrnoError(2); + } + if (!stream.stream_ops.mmap) { + throw new FS.ErrnoError(43); + } + return stream.stream_ops.mmap(stream, length, position, prot, flags); + }, + msync(stream, buffer, offset, length, mmapFlags) { + if (!stream.stream_ops.msync) { + return 0; + } + return stream.stream_ops.msync( + stream, + buffer, + offset, + length, + mmapFlags, + ); + }, + munmap: (stream) => 0, + ioctl(stream, cmd, arg) { + if (!stream.stream_ops.ioctl) { + throw new FS.ErrnoError(59); + } + return stream.stream_ops.ioctl(stream, cmd, arg); + }, + readFile(path, opts = {}) { + opts.flags = opts.flags || 0; + opts.encoding = opts.encoding || "binary"; + if (opts.encoding !== "utf8" && opts.encoding !== "binary") { + throw new Error(`Invalid encoding type "${opts.encoding}"`); + } + var ret; + var stream = FS.open(path, opts.flags); + var stat = FS.stat(path); + var length = stat.size; + var buf = new Uint8Array(length); + FS.read(stream, buf, 0, length, 0); + if (opts.encoding === "utf8") { + ret = UTF8ArrayToString(buf, 0); + } else if (opts.encoding === "binary") { + ret = buf; + } + FS.close(stream); + return ret; + }, + writeFile(path, data, opts = {}) { + opts.flags = opts.flags || 577; + var stream = FS.open(path, opts.flags, opts.mode); + if (typeof data == "string") { + var buf = new Uint8Array(lengthBytesUTF8(data) + 1); + var actualNumBytes = stringToUTF8Array(data, buf, 0, buf.length); + FS.write(stream, buf, 0, actualNumBytes, undefined, opts.canOwn); + } else if (ArrayBuffer.isView(data)) { + FS.write(stream, data, 0, data.byteLength, undefined, opts.canOwn); + } else { + throw new Error("Unsupported data type"); + } + FS.close(stream); + }, + cwd: () => FS.currentPath, + chdir(path) { + var lookup = FS.lookupPath(path, { + follow: true, + }); + if (lookup.node === null) { + throw new FS.ErrnoError(44); + } + if (!FS.isDir(lookup.node.mode)) { + throw new FS.ErrnoError(54); + } + var errCode = FS.nodePermissions(lookup.node, "x"); + if (errCode) { + throw new FS.ErrnoError(errCode); + } + FS.currentPath = lookup.path; + }, + createDefaultDirectories() { + FS.mkdir("/tmp"); + FS.mkdir("/home"); + FS.mkdir("/home/web_user"); + }, + createDefaultDevices() { + FS.mkdir("/dev"); + FS.registerDevice(FS.makedev(1, 3), { + read: () => 0, + write: (stream, buffer, offset, length, pos) => length, + }); + FS.mkdev("/dev/null", FS.makedev(1, 3)); + TTY.register(FS.makedev(5, 0), TTY.default_tty_ops); + TTY.register(FS.makedev(6, 0), TTY.default_tty1_ops); + FS.mkdev("/dev/tty", FS.makedev(5, 0)); + FS.mkdev("/dev/tty1", FS.makedev(6, 0)); + var randomBuffer = new Uint8Array(1024), + randomLeft = 0; + var randomByte = () => { + if (randomLeft === 0) { + randomLeft = randomFill(randomBuffer).byteLength; + } + return randomBuffer[--randomLeft]; + }; + FS.createDevice("/dev", "random", randomByte); + FS.createDevice("/dev", "urandom", randomByte); + FS.mkdir("/dev/shm"); + FS.mkdir("/dev/shm/tmp"); + }, + createSpecialDirectories() { + FS.mkdir("/proc"); + var proc_self = FS.mkdir("/proc/self"); + FS.mkdir("/proc/self/fd"); + FS.mount( + { + mount() { + var node = FS.createNode( + proc_self, + "fd", + 16384 | 511, + /* 0777 */ 73, + ); + node.node_ops = { + lookup(parent, name) { + var fd = +name; + var stream = FS.getStreamChecked(fd); + var ret = { + parent: null, + mount: { + mountpoint: "fake", + }, + node_ops: { + readlink: () => stream.path, + }, + }; + ret.parent = ret; + return ret; + }, + }; + return node; + }, + }, + {}, + "/proc/self/fd", + ); + }, + createStandardStreams() { + if (Module["stdin"]) { + FS.createDevice("/dev", "stdin", Module["stdin"]); + } else { + FS.symlink("/dev/tty", "/dev/stdin"); + } + if (Module["stdout"]) { + FS.createDevice("/dev", "stdout", null, Module["stdout"]); + } else { + FS.symlink("/dev/tty", "/dev/stdout"); + } + if (Module["stderr"]) { + FS.createDevice("/dev", "stderr", null, Module["stderr"]); + } else { + FS.symlink("/dev/tty1", "/dev/stderr"); + } + var stdin = FS.open("/dev/stdin", 0); + var stdout = FS.open("/dev/stdout", 1); + var stderr = FS.open("/dev/stderr", 1); + }, + ensureErrnoError() { + if (FS.ErrnoError) return; + FS.ErrnoError = /** @this{Object} */ function ErrnoError(errno, node) { + this.name = "ErrnoError"; + this.node = node; + this.setErrno = /** @this{Object} */ function (errno) { + this.errno = errno; + }; + this.setErrno(errno); + this.message = "FS error"; + }; + FS.ErrnoError.prototype = new Error(); + FS.ErrnoError.prototype.constructor = FS.ErrnoError; + [44].forEach((code) => { + FS.genericErrors[code] = new FS.ErrnoError(code); + FS.genericErrors[code].stack = ""; + }); + }, + staticInit() { + FS.ensureErrnoError(); + FS.nameTable = new Array(4096); + FS.mount(MEMFS, {}, "/"); + FS.createDefaultDirectories(); + FS.createDefaultDevices(); + FS.createSpecialDirectories(); + FS.filesystems = { + MEMFS: MEMFS, + }; + }, + init(input, output, error) { + FS.init.initialized = true; + FS.ensureErrnoError(); + Module["stdin"] = input || Module["stdin"]; + Module["stdout"] = output || Module["stdout"]; + Module["stderr"] = error || Module["stderr"]; + FS.createStandardStreams(); + }, + quit() { + FS.init.initialized = false; + for (var i = 0; i < FS.streams.length; i++) { + var stream = FS.streams[i]; + if (!stream) { + continue; + } + FS.close(stream); + } + }, + findObject(path, dontResolveLastLink) { + var ret = FS.analyzePath(path, dontResolveLastLink); + if (!ret.exists) { + return null; + } + return ret.object; + }, + analyzePath(path, dontResolveLastLink) { + try { + var lookup = FS.lookupPath(path, { + follow: !dontResolveLastLink, + }); + path = lookup.path; + } catch (e) {} + var ret = { + isRoot: false, + exists: false, + error: 0, + name: null, + path: null, + object: null, + parentExists: false, + parentPath: null, + parentObject: null, + }; + try { + var lookup = FS.lookupPath(path, { + parent: true, + }); + ret.parentExists = true; + ret.parentPath = lookup.path; + ret.parentObject = lookup.node; + ret.name = PATH.basename(path); + lookup = FS.lookupPath(path, { + follow: !dontResolveLastLink, + }); + ret.exists = true; + ret.path = lookup.path; + ret.object = lookup.node; + ret.name = lookup.node.name; + ret.isRoot = lookup.path === "/"; + } catch (e) { + ret.error = e.errno; + } + return ret; + }, + createPath(parent, path, canRead, canWrite) { + parent = typeof parent == "string" ? parent : FS.getPath(parent); + var parts = path.split("/").reverse(); + while (parts.length) { + var part = parts.pop(); + if (!part) continue; + var current = PATH.join2(parent, part); + try { + FS.mkdir(current); + } catch (e) {} + parent = current; + } + return current; + }, + createFile(parent, name, properties, canRead, canWrite) { + var path = PATH.join2( + typeof parent == "string" ? parent : FS.getPath(parent), + name, + ); + var mode = FS_getMode(canRead, canWrite); + return FS.create(path, mode); + }, + createDataFile(parent, name, data, canRead, canWrite, canOwn) { + var path = name; + if (parent) { + parent = typeof parent == "string" ? parent : FS.getPath(parent); + path = name ? PATH.join2(parent, name) : parent; + } + var mode = FS_getMode(canRead, canWrite); + var node = FS.create(path, mode); + if (data) { + if (typeof data == "string") { + var arr = new Array(data.length); + for (var i = 0, len = data.length; i < len; ++i) + arr[i] = data.charCodeAt(i); + data = arr; + } + FS.chmod(node, mode | 146); + var stream = FS.open(node, 577); + FS.write(stream, data, 0, data.length, 0, canOwn); + FS.close(stream); + FS.chmod(node, mode); + } + return node; + }, + createDevice(parent, name, input, output) { + var path = PATH.join2( + typeof parent == "string" ? parent : FS.getPath(parent), + name, + ); + var mode = FS_getMode(!!input, !!output); + if (!FS.createDevice.major) FS.createDevice.major = 64; + var dev = FS.makedev(FS.createDevice.major++, 0); + FS.registerDevice(dev, { + open(stream) { + stream.seekable = false; + }, + close(stream) { + if (output && output.buffer && output.buffer.length) { + output(10); + } + }, + read(stream, buffer, offset, length, pos) { + /* ignored */ var bytesRead = 0; + for (var i = 0; i < length; i++) { + var result; + try { + result = input(); + } catch (e) { + throw new FS.ErrnoError(29); + } + if (result === undefined && bytesRead === 0) { + throw new FS.ErrnoError(6); + } + if (result === null || result === undefined) break; + bytesRead++; + buffer[offset + i] = result; + } + if (bytesRead) { + stream.node.timestamp = Date.now(); + } + return bytesRead; + }, + write(stream, buffer, offset, length, pos) { + for (var i = 0; i < length; i++) { + try { + output(buffer[offset + i]); + } catch (e) { + throw new FS.ErrnoError(29); + } + } + if (length) { + stream.node.timestamp = Date.now(); + } + return i; + }, + }); + return FS.mkdev(path, mode, dev); + }, + forceLoadFile(obj) { + if (obj.isDevice || obj.isFolder || obj.link || obj.contents) + return true; + if (typeof XMLHttpRequest != "undefined") { + throw new Error( + "Lazy loading should have been performed (contents set) in createLazyFile, but it was not. Lazy loading only works in web workers. Use --embed-file or --preload-file in emcc on the main thread.", + ); + } else if (read_) { + try { + obj.contents = intArrayFromString(read_(obj.url), true); + obj.usedBytes = obj.contents.length; + } catch (e) { + throw new FS.ErrnoError(29); + } + } else { + throw new Error("Cannot load without read() or XMLHttpRequest."); + } + }, + createLazyFile(parent, name, url, canRead, canWrite) { + /** @constructor */ function LazyUint8Array() { + this.lengthKnown = false; + this.chunks = []; + } + LazyUint8Array.prototype.get = + /** @this{Object} */ function LazyUint8Array_get(idx) { + if (idx > this.length - 1 || idx < 0) { + return undefined; + } + var chunkOffset = idx % this.chunkSize; + var chunkNum = (idx / this.chunkSize) | 0; + return this.getter(chunkNum)[chunkOffset]; + }; + LazyUint8Array.prototype.setDataGetter = + function LazyUint8Array_setDataGetter(getter) { + this.getter = getter; + }; + LazyUint8Array.prototype.cacheLength = + function LazyUint8Array_cacheLength() { + var xhr = new XMLHttpRequest(); + xhr.open("HEAD", url, false); + xhr.send(null); + if ( + !((xhr.status >= 200 && xhr.status < 300) || xhr.status === 304) + ) + throw new Error( + "Couldn't load " + url + ". Status: " + xhr.status, + ); + var datalength = Number(xhr.getResponseHeader("Content-length")); + var header; + var hasByteServing = + (header = xhr.getResponseHeader("Accept-Ranges")) && + header === "bytes"; + var usesGzip = + (header = xhr.getResponseHeader("Content-Encoding")) && + header === "gzip"; + var chunkSize = 1024 * 1024; + if (!hasByteServing) chunkSize = datalength; + var doXHR = (from, to) => { + if (from > to) + throw new Error( + "invalid range (" + + from + + ", " + + to + + ") or no bytes requested!", + ); + if (to > datalength - 1) + throw new Error( + "only " + datalength + " bytes available! programmer error!", + ); + var xhr = new XMLHttpRequest(); + xhr.open("GET", url, false); + if (datalength !== chunkSize) + xhr.setRequestHeader("Range", "bytes=" + from + "-" + to); + xhr.responseType = "arraybuffer"; + if (xhr.overrideMimeType) { + xhr.overrideMimeType("text/plain; charset=x-user-defined"); + } + xhr.send(null); + if ( + !((xhr.status >= 200 && xhr.status < 300) || xhr.status === 304) + ) + throw new Error( + "Couldn't load " + url + ". Status: " + xhr.status, + ); + if (xhr.response !== undefined) { + return new Uint8Array( + /** @type{Array} */ (xhr.response || []), + ); + } + return intArrayFromString(xhr.responseText || "", true); + }; + var lazyArray = this; + lazyArray.setDataGetter((chunkNum) => { + var start = chunkNum * chunkSize; + var end = (chunkNum + 1) * chunkSize - 1; + end = Math.min(end, datalength - 1); + if (typeof lazyArray.chunks[chunkNum] == "undefined") { + lazyArray.chunks[chunkNum] = doXHR(start, end); + } + if (typeof lazyArray.chunks[chunkNum] == "undefined") + throw new Error("doXHR failed!"); + return lazyArray.chunks[chunkNum]; + }); + if (usesGzip || !datalength) { + chunkSize = datalength = 1; + datalength = this.getter(0).length; + chunkSize = datalength; + out( + "LazyFiles on gzip forces download of the whole file when length is accessed", + ); + } + this._length = datalength; + this._chunkSize = chunkSize; + this.lengthKnown = true; + }; + if (typeof XMLHttpRequest != "undefined") { + if (!ENVIRONMENT_IS_WORKER) + throw "Cannot do synchronous binary XHRs outside webworkers in modern browsers. Use --embed-file or --preload-file in emcc"; + var lazyArray = new LazyUint8Array(); + Object.defineProperties(lazyArray, { + length: { + get: /** @this{Object} */ function () { + if (!this.lengthKnown) { + this.cacheLength(); + } + return this._length; + }, + }, + chunkSize: { + get: /** @this{Object} */ function () { + if (!this.lengthKnown) { + this.cacheLength(); + } + return this._chunkSize; + }, + }, + }); + var properties = { + isDevice: false, + contents: lazyArray, + }; + } else { + var properties = { + isDevice: false, + url: url, + }; + } + var node = FS.createFile(parent, name, properties, canRead, canWrite); + if (properties.contents) { + node.contents = properties.contents; + } else if (properties.url) { + node.contents = null; + node.url = properties.url; + } + Object.defineProperties(node, { + usedBytes: { + get: /** @this {FSNode} */ function () { + return this.contents.length; + }, + }, + }); + var stream_ops = {}; + var keys = Object.keys(node.stream_ops); + keys.forEach((key) => { + var fn = node.stream_ops[key]; + stream_ops[key] = function forceLoadLazyFile() { + FS.forceLoadFile(node); + return fn.apply(null, arguments); + }; + }); + function writeChunks(stream, buffer, offset, length, position) { + var contents = stream.node.contents; + if (position >= contents.length) return 0; + var size = Math.min(contents.length - position, length); + if (contents.slice) { + for (var i = 0; i < size; i++) { + buffer[offset + i] = contents[position + i]; + } + } else { + for (var i = 0; i < size; i++) { + buffer[offset + i] = contents.get(position + i); + } + } + return size; + } + stream_ops.read = (stream, buffer, offset, length, position) => { + FS.forceLoadFile(node); + return writeChunks(stream, buffer, offset, length, position); + }; + stream_ops.mmap = (stream, length, position, prot, flags) => { + FS.forceLoadFile(node); + var ptr = mmapAlloc(length); + if (!ptr) { + throw new FS.ErrnoError(48); + } + writeChunks(stream, GROWABLE_HEAP_I8(), ptr, length, position); + return { + ptr: ptr, + allocated: true, + }; + }; + node.stream_ops = stream_ops; + return node; + }, + }; + + /** + * Given a pointer 'ptr' to a null-terminated UTF8-encoded string in the + * emscripten HEAP, returns a copy of that string as a Javascript String object. + * + * @param {number} ptr + * @param {number=} maxBytesToRead - An optional length that specifies the + * maximum number of bytes to read. You can omit this parameter to scan the + * string until the first 0 byte. If maxBytesToRead is passed, and the string + * at [ptr, ptr+maxBytesToReadr[ contains a null byte in the middle, then the + * string will cut short at that byte index (i.e. maxBytesToRead will not + * produce a string of exact length [ptr, ptr+maxBytesToRead[) N.B. mixing + * frequent uses of UTF8ToString() with and without maxBytesToRead may throw + * JS JIT optimizations off, so it is worth to consider consistently using one + * @return {string} + */ var UTF8ToString = (ptr, maxBytesToRead) => { + ptr >>>= 0; + return ptr + ? UTF8ArrayToString(GROWABLE_HEAP_U8(), ptr, maxBytesToRead) + : ""; + }; + + var SYSCALLS = { + DEFAULT_POLLMASK: 5, + calculateAt(dirfd, path, allowEmpty) { + if (PATH.isAbs(path)) { + return path; + } + var dir; + if (dirfd === -100) { + dir = FS.cwd(); + } else { + var dirstream = SYSCALLS.getStreamFromFD(dirfd); + dir = dirstream.path; + } + if (path.length == 0) { + if (!allowEmpty) { + throw new FS.ErrnoError(44); + } + return dir; + } + return PATH.join2(dir, path); + }, + doStat(func, path, buf) { + try { + var stat = func(path); + } catch (e) { + if ( + e && + e.node && + PATH.normalize(path) !== PATH.normalize(FS.getPath(e.node)) + ) { + return -54; + } + throw e; + } + GROWABLE_HEAP_I32()[(buf >>> 2) >>> 0] = stat.dev; + GROWABLE_HEAP_I32()[((buf + 4) >>> 2) >>> 0] = stat.mode; + GROWABLE_HEAP_U32()[((buf + 8) >>> 2) >>> 0] = stat.nlink; + GROWABLE_HEAP_I32()[((buf + 12) >>> 2) >>> 0] = stat.uid; + GROWABLE_HEAP_I32()[((buf + 16) >>> 2) >>> 0] = stat.gid; + GROWABLE_HEAP_I32()[((buf + 20) >>> 2) >>> 0] = stat.rdev; + (tempI64 = [ + stat.size >>> 0, + ((tempDouble = stat.size), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((buf + 24) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((buf + 28) >>> 2) >>> 0] = tempI64[1]); + GROWABLE_HEAP_I32()[((buf + 32) >>> 2) >>> 0] = 4096; + GROWABLE_HEAP_I32()[((buf + 36) >>> 2) >>> 0] = stat.blocks; + var atime = stat.atime.getTime(); + var mtime = stat.mtime.getTime(); + var ctime = stat.ctime.getTime(); + (tempI64 = [ + Math.floor(atime / 1e3) >>> 0, + ((tempDouble = Math.floor(atime / 1e3)), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((buf + 40) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((buf + 44) >>> 2) >>> 0] = tempI64[1]); + GROWABLE_HEAP_U32()[((buf + 48) >>> 2) >>> 0] = (atime % 1e3) * 1e3; + (tempI64 = [ + Math.floor(mtime / 1e3) >>> 0, + ((tempDouble = Math.floor(mtime / 1e3)), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((buf + 56) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((buf + 60) >>> 2) >>> 0] = tempI64[1]); + GROWABLE_HEAP_U32()[((buf + 64) >>> 2) >>> 0] = (mtime % 1e3) * 1e3; + (tempI64 = [ + Math.floor(ctime / 1e3) >>> 0, + ((tempDouble = Math.floor(ctime / 1e3)), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((buf + 72) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((buf + 76) >>> 2) >>> 0] = tempI64[1]); + GROWABLE_HEAP_U32()[((buf + 80) >>> 2) >>> 0] = (ctime % 1e3) * 1e3; + (tempI64 = [ + stat.ino >>> 0, + ((tempDouble = stat.ino), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((buf + 88) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((buf + 92) >>> 2) >>> 0] = tempI64[1]); + return 0; + }, + doMsync(addr, stream, len, flags, offset) { + if (!FS.isFile(stream.node.mode)) { + throw new FS.ErrnoError(43); + } + if (flags & 2) { + return 0; + } + var buffer = GROWABLE_HEAP_U8().slice(addr, addr + len); + FS.msync(stream, buffer, offset, len, flags); + }, + varargs: undefined, + get() { + var ret = GROWABLE_HEAP_I32()[(+SYSCALLS.varargs >>> 2) >>> 0]; + SYSCALLS.varargs += 4; + return ret; + }, + getp() { + return SYSCALLS.get(); + }, + getStr(ptr) { + var ret = UTF8ToString(ptr); + return ret; + }, + getStreamFromFD(fd) { + var stream = FS.getStreamChecked(fd); + return stream; + }, + }; + + function _proc_exit(code) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(0, 1, code); + EXITSTATUS = code; + if (!keepRuntimeAlive()) { + PThread.terminateAllThreads(); + if (Module["onExit"]) Module["onExit"](code); + ABORT = true; + } + quit_(code, new ExitStatus(code)); + } + + /** @param {boolean|number=} implicit */ var exitJS = ( + status, + implicit, + ) => { + EXITSTATUS = status; + if (ENVIRONMENT_IS_PTHREAD) { + exitOnMainThread(status); + throw "unwind"; + } + _proc_exit(status); + }; + + var _exit = exitJS; + + var handleException = (e) => { + if (e instanceof ExitStatus || e == "unwind") { + return EXITSTATUS; + } + quit_(1, e); + }; + + var PThread = { + unusedWorkers: [], + runningWorkers: [], + tlsInitFunctions: [], + pthreads: {}, + init() { + if (ENVIRONMENT_IS_PTHREAD) { + PThread.initWorker(); + } else { + PThread.initMainThread(); + } + }, + initMainThread() { + var pthreadPoolSize = 10; + while (pthreadPoolSize--) { + PThread.allocateUnusedWorker(); + } + addOnPreRun(() => { + addRunDependency("loading-workers"); + PThread.loadWasmModuleToAllWorkers(() => + removeRunDependency("loading-workers"), + ); + }); + }, + initWorker() { + PThread["receiveObjectTransfer"] = PThread.receiveObjectTransfer; + PThread["threadInitTLS"] = PThread.threadInitTLS; + PThread["setExitStatus"] = PThread.setExitStatus; + noExitRuntime = false; + }, + setExitStatus: (status) => { + EXITSTATUS = status; + }, + terminateAllThreads__deps: ["$terminateWorker"], + terminateAllThreads: () => { + for (var worker of PThread.runningWorkers) { + terminateWorker(worker); + } + for (var worker of PThread.unusedWorkers) { + terminateWorker(worker); + } + PThread.unusedWorkers = []; + PThread.runningWorkers = []; + PThread.pthreads = []; + }, + returnWorkerToPool: (worker) => { + var pthread_ptr = worker.pthread_ptr; + delete PThread.pthreads[pthread_ptr]; + PThread.unusedWorkers.push(worker); + PThread.runningWorkers.splice( + PThread.runningWorkers.indexOf(worker), + 1, + ); + worker.pthread_ptr = 0; + __emscripten_thread_free_data(pthread_ptr); + }, + receiveObjectTransfer(data) {}, + threadInitTLS() { + PThread.tlsInitFunctions.forEach((f) => f()); + }, + loadWasmModuleToWorker: (worker) => + new Promise((onFinishedLoading) => { + worker.onmessage = (e) => { + var d = e["data"]; + var cmd = d["cmd"]; + if (d["targetThread"] && d["targetThread"] != _pthread_self()) { + var targetWorker = PThread.pthreads[d["targetThread"]]; + if (targetWorker) { + targetWorker.postMessage(d, d["transferList"]); + } else { + err( + `Internal error! Worker sent a message "${cmd}" to target pthread ${d["targetThread"]}, but that thread no longer exists!`, + ); + } + return; + } + if (cmd === "checkMailbox") { + checkMailbox(); + } else if (cmd === "spawnThread") { + spawnThread(d); + } else if (cmd === "cleanupThread") { + cleanupThread(d["thread"]); + } else if (cmd === "killThread") { + killThread(d["thread"]); + } else if (cmd === "cancelThread") { + cancelThread(d["thread"]); + } else if (cmd === "loaded") { + worker.loaded = true; + if (ENVIRONMENT_IS_NODE && !worker.pthread_ptr) { + worker.unref(); + } + onFinishedLoading(worker); + } else if (cmd === "alert") { + alert(`Thread ${d["threadId"]}: ${d["text"]}`); + } else if (d.target === "setimmediate") { + worker.postMessage(d); + } else if (cmd === "callHandler") { + Module[d["handler"]](...d["args"]); + } else if (cmd) { + err(`worker sent an unknown command ${cmd}`); + } + }; + worker.onerror = (e) => { + var message = "worker sent an error!"; + err(`${message} ${e.filename}:${e.lineno}: ${e.message}`); + throw e; + }; + if (ENVIRONMENT_IS_NODE) { + worker.on("message", (data) => + worker.onmessage({ + data: data, + }), + ); + worker.on("error", (e) => worker.onerror(e)); + } + var handlers = []; + var knownHandlers = ["onExit", "onAbort", "print", "printErr"]; + for (var handler of knownHandlers) { + if (Module.hasOwnProperty(handler)) { + handlers.push(handler); + } + } + worker.postMessage({ + cmd: "load", + handlers: handlers, + urlOrBlob: Module["mainScriptUrlOrBlob"] || _scriptDir, + wasmMemory: wasmMemory, + wasmModule: wasmModule, + }); + }), + loadWasmModuleToAllWorkers(onMaybeReady) { + if (ENVIRONMENT_IS_PTHREAD) { + return onMaybeReady(); + } + let pthreadPoolReady = Promise.all( + PThread.unusedWorkers.map(PThread.loadWasmModuleToWorker), + ); + pthreadPoolReady.then(onMaybeReady); + }, + allocateUnusedWorker() { + var worker; + var pthreadMainJs = locateFile("emHdBindings.worker.js"); + worker = new Worker(pthreadMainJs); + PThread.unusedWorkers.push(worker); + }, + getNewWorker() { + if (PThread.unusedWorkers.length == 0) { + PThread.allocateUnusedWorker(); + PThread.loadWasmModuleToWorker(PThread.unusedWorkers[0]); + } + return PThread.unusedWorkers.pop(); + }, + }; + + Module["PThread"] = PThread; + + var callRuntimeCallbacks = (callbacks) => { + while (callbacks.length > 0) { + callbacks.shift()(Module); + } + }; + + var establishStackSpace = () => { + var pthread_ptr = _pthread_self(); + var stackHigh = GROWABLE_HEAP_U32()[((pthread_ptr + 52) >>> 2) >>> 0]; + var stackSize = GROWABLE_HEAP_U32()[((pthread_ptr + 56) >>> 2) >>> 0]; + var stackLow = stackHigh - stackSize; + _emscripten_stack_set_limits(stackHigh, stackLow); + stackRestore(stackHigh); + }; + + Module["establishStackSpace"] = establishStackSpace; + + function exitOnMainThread(returnCode) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(1, 0, returnCode); + _exit(returnCode); + } + + /** + * @param {number} ptr + * @param {string} type + */ function getValue(ptr, type = "i8") { + if (type.endsWith("*")) type = "*"; + switch (type) { + case "i1": + return GROWABLE_HEAP_I8()[(ptr >>> 0) >>> 0]; + + case "i8": + return GROWABLE_HEAP_I8()[(ptr >>> 0) >>> 0]; + + case "i16": + return GROWABLE_HEAP_I16()[(ptr >>> 1) >>> 0]; + + case "i32": + return GROWABLE_HEAP_I32()[(ptr >>> 2) >>> 0]; + + case "i64": + abort("to do getValue(i64) use WASM_BIGINT"); + + case "float": + return GROWABLE_HEAP_F32()[(ptr >>> 2) >>> 0]; + + case "double": + return GROWABLE_HEAP_F64()[(ptr >>> 3) >>> 0]; + + case "*": + return GROWABLE_HEAP_U32()[(ptr >>> 2) >>> 0]; + + default: + abort(`invalid type for getValue: ${type}`); + } + } + + var invokeEntryPoint = (ptr, arg) => { + var result = ((a1) => dynCall_ii.apply(null, [ptr, a1]))(arg); + function finish(result) { + if (keepRuntimeAlive()) { + PThread.setExitStatus(result); + } else { + __emscripten_thread_exit(result); + } + } + finish(result); + }; + + Module["invokeEntryPoint"] = invokeEntryPoint; + + var noExitRuntime = Module["noExitRuntime"] || true; + + var registerTLSInit = (tlsInitFunc) => { + PThread.tlsInitFunctions.push(tlsInitFunc); + }; + + /** + * @param {number} ptr + * @param {number} value + * @param {string} type + */ function setValue(ptr, value, type = "i8") { + if (type.endsWith("*")) type = "*"; + switch (type) { + case "i1": + GROWABLE_HEAP_I8()[(ptr >>> 0) >>> 0] = value; + break; + + case "i8": + GROWABLE_HEAP_I8()[(ptr >>> 0) >>> 0] = value; + break; + + case "i16": + GROWABLE_HEAP_I16()[(ptr >>> 1) >>> 0] = value; + break; + + case "i32": + GROWABLE_HEAP_I32()[(ptr >>> 2) >>> 0] = value; + break; + + case "i64": + abort("to do setValue(i64) use WASM_BIGINT"); + + case "float": + GROWABLE_HEAP_F32()[(ptr >>> 2) >>> 0] = value; + break; + + case "double": + GROWABLE_HEAP_F64()[(ptr >>> 3) >>> 0] = value; + break; + + case "*": + GROWABLE_HEAP_U32()[(ptr >>> 2) >>> 0] = value; + break; + + default: + abort(`invalid type for setValue: ${type}`); + } + } + + var convertI32PairToI53Checked = (lo, hi) => + (hi + 2097152) >>> 0 < 4194305 - !!lo + ? (lo >>> 0) + hi * 4294967296 + : NaN; + + function ___assert_fail(condition, filename, line, func) { + condition >>>= 0; + filename >>>= 0; + func >>>= 0; + abort( + `Assertion failed: ${UTF8ToString(condition)}, at: ` + + [ + filename ? UTF8ToString(filename) : "unknown filename", + line, + func ? UTF8ToString(func) : "unknown function", + ], + ); + } + + var ___call_sighandler = function (fp, sig) { + fp >>>= 0; + return ((a1) => dynCall_vi.apply(null, [fp, a1]))(sig); + }; + + var exceptionCaught = []; + + var uncaughtExceptionCount = 0; + + function ___cxa_begin_catch(ptr) { + ptr >>>= 0; + var info = new ExceptionInfo(ptr); + if (!info.get_caught()) { + info.set_caught(true); + uncaughtExceptionCount--; + } + info.set_rethrown(false); + exceptionCaught.push(info); + ___cxa_increment_exception_refcount(info.excPtr); + return info.get_exception_ptr(); + } + + var exceptionLast = 0; + + var ___cxa_end_catch = () => { + _setThrew(0, 0); + var info = exceptionCaught.pop(); + ___cxa_decrement_exception_refcount(info.excPtr); + exceptionLast = 0; + }; + + /** @constructor */ function ExceptionInfo(excPtr) { + this.excPtr = excPtr; + this.ptr = excPtr - 24; + this.set_type = function (type) { + GROWABLE_HEAP_U32()[((this.ptr + 4) >>> 2) >>> 0] = type; + }; + this.get_type = function () { + return GROWABLE_HEAP_U32()[((this.ptr + 4) >>> 2) >>> 0]; + }; + this.set_destructor = function (destructor) { + GROWABLE_HEAP_U32()[((this.ptr + 8) >>> 2) >>> 0] = destructor; + }; + this.get_destructor = function () { + return GROWABLE_HEAP_U32()[((this.ptr + 8) >>> 2) >>> 0]; + }; + this.set_caught = function (caught) { + caught = caught ? 1 : 0; + GROWABLE_HEAP_I8()[((this.ptr + 12) >>> 0) >>> 0] = caught; + }; + this.get_caught = function () { + return GROWABLE_HEAP_I8()[((this.ptr + 12) >>> 0) >>> 0] != 0; + }; + this.set_rethrown = function (rethrown) { + rethrown = rethrown ? 1 : 0; + GROWABLE_HEAP_I8()[((this.ptr + 13) >>> 0) >>> 0] = rethrown; + }; + this.get_rethrown = function () { + return GROWABLE_HEAP_I8()[((this.ptr + 13) >>> 0) >>> 0] != 0; + }; + this.init = function (type, destructor) { + this.set_adjusted_ptr(0); + this.set_type(type); + this.set_destructor(destructor); + }; + this.set_adjusted_ptr = function (adjustedPtr) { + GROWABLE_HEAP_U32()[((this.ptr + 16) >>> 2) >>> 0] = adjustedPtr; + }; + this.get_adjusted_ptr = function () { + return GROWABLE_HEAP_U32()[((this.ptr + 16) >>> 2) >>> 0]; + }; + this.get_exception_ptr = function () { + var isPointer = ___cxa_is_pointer_type(this.get_type()); + if (isPointer) { + return GROWABLE_HEAP_U32()[(this.excPtr >>> 2) >>> 0]; + } + var adjusted = this.get_adjusted_ptr(); + if (adjusted !== 0) return adjusted; + return this.excPtr; + }; + } + + function ___resumeException(ptr) { + ptr >>>= 0; + if (!exceptionLast) { + exceptionLast = ptr; + } + throw exceptionLast; + } + + var findMatchingCatch = (args) => { + var thrown = exceptionLast; + if (!thrown) { + setTempRet0(0); + return 0; + } + var info = new ExceptionInfo(thrown); + info.set_adjusted_ptr(thrown); + var thrownType = info.get_type(); + if (!thrownType) { + setTempRet0(0); + return thrown; + } + for (var arg in args) { + var caughtType = args[arg]; + if (caughtType === 0 || caughtType === thrownType) { + break; + } + var adjusted_ptr_addr = info.ptr + 16; + if (___cxa_can_catch(caughtType, thrownType, adjusted_ptr_addr)) { + setTempRet0(caughtType); + return thrown; + } + } + setTempRet0(thrownType); + return thrown; + }; + + function ___cxa_find_matching_catch_2() { + return findMatchingCatch([]); + } + + function ___cxa_find_matching_catch_3(arg0) { + arg0 >>>= 0; + return findMatchingCatch([arg0]); + } + + function ___cxa_find_matching_catch_4(arg0, arg1) { + arg0 >>>= 0; + arg1 >>>= 0; + return findMatchingCatch([arg0, arg1]); + } + + function ___cxa_get_exception_ptr(ptr) { + ptr >>>= 0; + var rtn = new ExceptionInfo(ptr).get_exception_ptr(); + return rtn; + } + + var ___cxa_rethrow = () => { + var info = exceptionCaught.pop(); + if (!info) { + abort("no exception to throw"); + } + var ptr = info.excPtr; + if (!info.get_rethrown()) { + exceptionCaught.push(info); + info.set_rethrown(true); + info.set_caught(false); + uncaughtExceptionCount++; + } + exceptionLast = ptr; + throw exceptionLast; + }; + + function ___cxa_rethrow_primary_exception(ptr) { + ptr >>>= 0; + if (!ptr) return; + var info = new ExceptionInfo(ptr); + exceptionCaught.push(info); + info.set_rethrown(true); + ___cxa_rethrow(); + } + + function ___cxa_throw(ptr, type, destructor) { + ptr >>>= 0; + type >>>= 0; + destructor >>>= 0; + var info = new ExceptionInfo(ptr); + info.init(type, destructor); + exceptionLast = ptr; + uncaughtExceptionCount++; + throw exceptionLast; + } + + var ___cxa_uncaught_exceptions = () => uncaughtExceptionCount; + + function ___emscripten_init_main_thread_js(tb) { + tb >>>= 0; + __emscripten_thread_init( + tb, + /*is_main=*/ !ENVIRONMENT_IS_WORKER, + /*is_runtime=*/ 1, + /*can_block=*/ !ENVIRONMENT_IS_WEB, + /*default_stacksize=*/ 2097152, + /*start_profiling=*/ false, + ); + PThread.threadInitTLS(); + } + + function ___emscripten_thread_cleanup(thread) { + thread >>>= 0; + if (!ENVIRONMENT_IS_PTHREAD) cleanupThread(thread); + else + postMessage({ + cmd: "cleanupThread", + thread: thread, + }); + } + + function pthreadCreateProxied(pthread_ptr, attr, startRoutine, arg) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(2, 1, pthread_ptr, attr, startRoutine, arg); + return ___pthread_create_js(pthread_ptr, attr, startRoutine, arg); + } + + function ___pthread_create_js(pthread_ptr, attr, startRoutine, arg) { + pthread_ptr >>>= 0; + attr >>>= 0; + startRoutine >>>= 0; + arg >>>= 0; + if (typeof SharedArrayBuffer == "undefined") { + err( + "Current environment does not support SharedArrayBuffer, pthreads are not available!", + ); + return 6; + } + var transferList = []; + var error = 0; + if (ENVIRONMENT_IS_PTHREAD && (transferList.length === 0 || error)) { + return pthreadCreateProxied(pthread_ptr, attr, startRoutine, arg); + } + if (error) return error; + var threadParams = { + startRoutine: startRoutine, + pthread_ptr: pthread_ptr, + arg: arg, + transferList: transferList, + }; + if (ENVIRONMENT_IS_PTHREAD) { + threadParams.cmd = "spawnThread"; + postMessage(threadParams, transferList); + return 0; + } + return spawnThread(threadParams); + } + + function ___syscall_chmod(path, mode) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(3, 1, path, mode); + path >>>= 0; + try { + path = SYSCALLS.getStr(path); + FS.chmod(path, mode); + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_faccessat(dirfd, path, amode, flags) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(4, 1, dirfd, path, amode, flags); + path >>>= 0; + try { + path = SYSCALLS.getStr(path); + path = SYSCALLS.calculateAt(dirfd, path); + if (amode & ~7) { + return -28; + } + var lookup = FS.lookupPath(path, { + follow: true, + }); + var node = lookup.node; + if (!node) { + return -44; + } + var perms = ""; + if (amode & 4) perms += "r"; + if (amode & 2) perms += "w"; + if (amode & 1) perms += "x"; + if ( + perms && + /* otherwise, they've just passed F_OK */ FS.nodePermissions( + node, + perms, + ) + ) { + return -2; + } + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_fadvise64(fd, offset, len, advice) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(5, 0, fd, offset, len, advice); + return 0; + } + + function ___syscall_fchmod(fd, mode) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(6, 1, fd, mode); + try { + FS.fchmod(fd, mode); + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + var setErrNo = (value) => { + GROWABLE_HEAP_I32()[(___errno_location() >>> 2) >>> 0] = value; + return value; + }; + + function ___syscall_fcntl64(fd, cmd, varargs) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(7, 1, fd, cmd, varargs); + varargs >>>= 0; + SYSCALLS.varargs = varargs; + try { + var stream = SYSCALLS.getStreamFromFD(fd); + switch (cmd) { + case 0: { + var arg = SYSCALLS.get(); + if (arg < 0) { + return -28; + } + while (FS.streams[arg]) { + arg++; + } + var newStream; + newStream = FS.createStream(stream, arg); + return newStream.fd; + } + + case 1: + case 2: + return 0; + + case 3: + return stream.flags; + + case 4: { + var arg = SYSCALLS.get(); + stream.flags |= arg; + return 0; + } + + case 5: { + var arg = SYSCALLS.getp(); + var offset = 0; + GROWABLE_HEAP_I16()[((arg + offset) >>> 1) >>> 0] = 2; + return 0; + } + + case 6: + case 7: + return 0; + + case 16: + case 8: + return -28; + + case 9: + setErrNo(28); + return -1; + + default: { + return -28; + } + } + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_fstat64(fd, buf) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(8, 1, fd, buf); + buf >>>= 0; + try { + var stream = SYSCALLS.getStreamFromFD(fd); + return SYSCALLS.doStat(FS.stat, stream.path, buf); + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + var stringToUTF8 = (str, outPtr, maxBytesToWrite) => + stringToUTF8Array(str, GROWABLE_HEAP_U8(), outPtr, maxBytesToWrite); + + function ___syscall_getcwd(buf, size) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(9, 1, buf, size); + buf >>>= 0; + size >>>= 0; + try { + if (size === 0) return -28; + var cwd = FS.cwd(); + var cwdLengthInBytes = lengthBytesUTF8(cwd) + 1; + if (size < cwdLengthInBytes) return -68; + stringToUTF8(cwd, buf, size); + return cwdLengthInBytes; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_getdents64(fd, dirp, count) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(10, 1, fd, dirp, count); + dirp >>>= 0; + count >>>= 0; + try { + var stream = SYSCALLS.getStreamFromFD(fd); + if (!stream.getdents) { + stream.getdents = FS.readdir(stream.path); + } + var struct_size = 280; + var pos = 0; + var off = FS.llseek(stream, 0, 1); + var idx = Math.floor(off / struct_size); + while (idx < stream.getdents.length && pos + struct_size <= count) { + var id; + var type; + var name = stream.getdents[idx]; + if (name === ".") { + id = stream.node.id; + type = 4; + } else if (name === "..") { + var lookup = FS.lookupPath(stream.path, { + parent: true, + }); + id = lookup.node.id; + type = 4; + } else { + var child = FS.lookupNode(stream.node, name); + id = child.id; + type = FS.isChrdev(child.mode) + ? 2 + : FS.isDir(child.mode) + ? 4 + : FS.isLink(child.mode) + ? 10 + : 8; + } + (tempI64 = [ + id >>> 0, + ((tempDouble = id), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((dirp + pos) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((dirp + pos + 4) >>> 2) >>> 0] = tempI64[1]); + (tempI64 = [ + ((idx + 1) * struct_size) >>> 0, + ((tempDouble = (idx + 1) * struct_size), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((dirp + pos + 8) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((dirp + pos + 12) >>> 2) >>> 0] = tempI64[1]); + GROWABLE_HEAP_I16()[((dirp + pos + 16) >>> 1) >>> 0] = 280; + GROWABLE_HEAP_I8()[((dirp + pos + 18) >>> 0) >>> 0] = type; + stringToUTF8(name, dirp + pos + 19, 256); + pos += struct_size; + idx += 1; + } + FS.llseek(stream, idx * struct_size, 0); + return pos; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_ioctl(fd, op, varargs) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(11, 1, fd, op, varargs); + varargs >>>= 0; + SYSCALLS.varargs = varargs; + try { + var stream = SYSCALLS.getStreamFromFD(fd); + switch (op) { + case 21509: { + if (!stream.tty) return -59; + return 0; + } + + case 21505: { + if (!stream.tty) return -59; + if (stream.tty.ops.ioctl_tcgets) { + var termios = stream.tty.ops.ioctl_tcgets(stream); + var argp = SYSCALLS.getp(); + GROWABLE_HEAP_I32()[(argp >>> 2) >>> 0] = termios.c_iflag || 0; + GROWABLE_HEAP_I32()[((argp + 4) >>> 2) >>> 0] = + termios.c_oflag || 0; + GROWABLE_HEAP_I32()[((argp + 8) >>> 2) >>> 0] = + termios.c_cflag || 0; + GROWABLE_HEAP_I32()[((argp + 12) >>> 2) >>> 0] = + termios.c_lflag || 0; + for (var i = 0; i < 32; i++) { + GROWABLE_HEAP_I8()[((argp + i + 17) >>> 0) >>> 0] = + termios.c_cc[i] || 0; + } + return 0; + } + return 0; + } + + case 21510: + case 21511: + case 21512: { + if (!stream.tty) return -59; + return 0; + } + + case 21506: + case 21507: + case 21508: { + if (!stream.tty) return -59; + if (stream.tty.ops.ioctl_tcsets) { + var argp = SYSCALLS.getp(); + var c_iflag = GROWABLE_HEAP_I32()[(argp >>> 2) >>> 0]; + var c_oflag = GROWABLE_HEAP_I32()[((argp + 4) >>> 2) >>> 0]; + var c_cflag = GROWABLE_HEAP_I32()[((argp + 8) >>> 2) >>> 0]; + var c_lflag = GROWABLE_HEAP_I32()[((argp + 12) >>> 2) >>> 0]; + var c_cc = []; + for (var i = 0; i < 32; i++) { + c_cc.push(GROWABLE_HEAP_I8()[((argp + i + 17) >>> 0) >>> 0]); + } + return stream.tty.ops.ioctl_tcsets(stream.tty, op, { + c_iflag: c_iflag, + c_oflag: c_oflag, + c_cflag: c_cflag, + c_lflag: c_lflag, + c_cc: c_cc, + }); + } + return 0; + } + + case 21519: { + if (!stream.tty) return -59; + var argp = SYSCALLS.getp(); + GROWABLE_HEAP_I32()[(argp >>> 2) >>> 0] = 0; + return 0; + } + + case 21520: { + if (!stream.tty) return -59; + return -28; + } + + case 21531: { + var argp = SYSCALLS.getp(); + return FS.ioctl(stream, op, argp); + } + + case 21523: { + if (!stream.tty) return -59; + if (stream.tty.ops.ioctl_tiocgwinsz) { + var winsize = stream.tty.ops.ioctl_tiocgwinsz(stream.tty); + var argp = SYSCALLS.getp(); + GROWABLE_HEAP_I16()[(argp >>> 1) >>> 0] = winsize[0]; + GROWABLE_HEAP_I16()[((argp + 2) >>> 1) >>> 0] = winsize[1]; + } + return 0; + } + + case 21524: { + if (!stream.tty) return -59; + return 0; + } + + case 21515: { + if (!stream.tty) return -59; + return 0; + } + + default: + return -28; + } + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_lstat64(path, buf) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(12, 1, path, buf); + path >>>= 0; + buf >>>= 0; + try { + path = SYSCALLS.getStr(path); + return SYSCALLS.doStat(FS.lstat, path, buf); + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_mkdirat(dirfd, path, mode) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(13, 1, dirfd, path, mode); + path >>>= 0; + try { + path = SYSCALLS.getStr(path); + path = SYSCALLS.calculateAt(dirfd, path); + path = PATH.normalize(path); + if (path[path.length - 1] === "/") + path = path.substr(0, path.length - 1); + FS.mkdir(path, mode, 0); + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_newfstatat(dirfd, path, buf, flags) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(14, 1, dirfd, path, buf, flags); + path >>>= 0; + buf >>>= 0; + try { + path = SYSCALLS.getStr(path); + var nofollow = flags & 256; + var allowEmpty = flags & 4096; + flags = flags & ~6400; + path = SYSCALLS.calculateAt(dirfd, path, allowEmpty); + return SYSCALLS.doStat(nofollow ? FS.lstat : FS.stat, path, buf); + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_openat(dirfd, path, flags, varargs) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(15, 1, dirfd, path, flags, varargs); + path >>>= 0; + varargs >>>= 0; + SYSCALLS.varargs = varargs; + try { + path = SYSCALLS.getStr(path); + path = SYSCALLS.calculateAt(dirfd, path); + var mode = varargs ? SYSCALLS.get() : 0; + return FS.open(path, flags, mode).fd; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_readlinkat(dirfd, path, buf, bufsize) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(16, 1, dirfd, path, buf, bufsize); + path >>>= 0; + buf >>>= 0; + bufsize >>>= 0; + try { + path = SYSCALLS.getStr(path); + path = SYSCALLS.calculateAt(dirfd, path); + if (bufsize <= 0) return -28; + var ret = FS.readlink(path); + var len = Math.min(bufsize, lengthBytesUTF8(ret)); + var endChar = GROWABLE_HEAP_I8()[(buf + len) >>> 0]; + stringToUTF8(ret, buf, bufsize + 1); + GROWABLE_HEAP_I8()[(buf + len) >>> 0] = endChar; + return len; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_renameat(olddirfd, oldpath, newdirfd, newpath) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(17, 1, olddirfd, oldpath, newdirfd, newpath); + oldpath >>>= 0; + newpath >>>= 0; + try { + oldpath = SYSCALLS.getStr(oldpath); + newpath = SYSCALLS.getStr(newpath); + oldpath = SYSCALLS.calculateAt(olddirfd, oldpath); + newpath = SYSCALLS.calculateAt(newdirfd, newpath); + FS.rename(oldpath, newpath); + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_stat64(path, buf) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(18, 1, path, buf); + path >>>= 0; + buf >>>= 0; + try { + path = SYSCALLS.getStr(path); + return SYSCALLS.doStat(FS.stat, path, buf); + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function ___syscall_unlinkat(dirfd, path, flags) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(19, 1, dirfd, path, flags); + path >>>= 0; + try { + path = SYSCALLS.getStr(path); + path = SYSCALLS.calculateAt(dirfd, path); + if (flags === 0) { + FS.unlink(path); + } else if (flags === 512) { + FS.rmdir(path); + } else { + abort("Invalid flags passed to unlinkat"); + } + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function __embind_register_bigint( + primitiveType, + name, + size, + minRange, + maxRange, + ) { + primitiveType >>>= 0; + name >>>= 0; + size >>>= 0; + } + + var embind_init_charCodes = () => { + var codes = new Array(256); + for (var i = 0; i < 256; ++i) { + codes[i] = String.fromCharCode(i); + } + embind_charCodes = codes; + }; + + var embind_charCodes; + + var readLatin1String = (ptr) => { + var ret = ""; + var c = ptr; + while (GROWABLE_HEAP_U8()[c >>> 0]) { + ret += embind_charCodes[GROWABLE_HEAP_U8()[c++ >>> 0]]; + } + return ret; + }; + + var awaitingDependencies = {}; + + var registeredTypes = {}; + + var typeDependencies = {}; + + var BindingError; + + var throwBindingError = (message) => { + throw new BindingError(message); + }; + + var InternalError; + + var throwInternalError = (message) => { + throw new InternalError(message); + }; + + var whenDependentTypesAreResolved = ( + myTypes, + dependentTypes, + getTypeConverters, + ) => { + myTypes.forEach(function (type) { + typeDependencies[type] = dependentTypes; + }); + function onComplete(typeConverters) { + var myTypeConverters = getTypeConverters(typeConverters); + if (myTypeConverters.length !== myTypes.length) { + throwInternalError("Mismatched type converter count"); + } + for (var i = 0; i < myTypes.length; ++i) { + registerType(myTypes[i], myTypeConverters[i]); + } + } + var typeConverters = new Array(dependentTypes.length); + var unregisteredTypes = []; + var registered = 0; + dependentTypes.forEach((dt, i) => { + if (registeredTypes.hasOwnProperty(dt)) { + typeConverters[i] = registeredTypes[dt]; + } else { + unregisteredTypes.push(dt); + if (!awaitingDependencies.hasOwnProperty(dt)) { + awaitingDependencies[dt] = []; + } + awaitingDependencies[dt].push(() => { + typeConverters[i] = registeredTypes[dt]; + ++registered; + if (registered === unregisteredTypes.length) { + onComplete(typeConverters); + } + }); + } + }); + if (0 === unregisteredTypes.length) { + onComplete(typeConverters); + } + }; + + /** @param {Object=} options */ function sharedRegisterType( + rawType, + registeredInstance, + options = {}, + ) { + var name = registeredInstance.name; + if (!rawType) { + throwBindingError( + `type "${name}" must have a positive integer typeid pointer`, + ); + } + if (registeredTypes.hasOwnProperty(rawType)) { + if (options.ignoreDuplicateRegistrations) { + return; + } else { + throwBindingError(`Cannot register type '${name}' twice`); + } + } + registeredTypes[rawType] = registeredInstance; + delete typeDependencies[rawType]; + if (awaitingDependencies.hasOwnProperty(rawType)) { + var callbacks = awaitingDependencies[rawType]; + delete awaitingDependencies[rawType]; + callbacks.forEach((cb) => cb()); + } + } + + /** @param {Object=} options */ function registerType( + rawType, + registeredInstance, + options = {}, + ) { + if (!("argPackAdvance" in registeredInstance)) { + throw new TypeError( + "registerType registeredInstance requires argPackAdvance", + ); + } + return sharedRegisterType(rawType, registeredInstance, options); + } + + var GenericWireTypeSize = 8; + + /** @suppress {globalThis} */ function __embind_register_bool( + rawType, + name, + trueValue, + falseValue, + ) { + rawType >>>= 0; + name >>>= 0; + name = readLatin1String(name); + registerType(rawType, { + name: name, + fromWireType: function (wt) { + return !!wt; + }, + toWireType: function (destructors, o) { + return o ? trueValue : falseValue; + }, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: function (pointer) { + return this["fromWireType"](GROWABLE_HEAP_U8()[pointer >>> 0]); + }, + destructorFunction: null, + }); + } + + var shallowCopyInternalPointer = (o) => ({ + count: o.count, + deleteScheduled: o.deleteScheduled, + preservePointerOnDelete: o.preservePointerOnDelete, + ptr: o.ptr, + ptrType: o.ptrType, + smartPtr: o.smartPtr, + smartPtrType: o.smartPtrType, + }); + + var throwInstanceAlreadyDeleted = (obj) => { + function getInstanceTypeName(handle) { + return handle.$$.ptrType.registeredClass.name; + } + throwBindingError(getInstanceTypeName(obj) + " instance already deleted"); + }; + + var finalizationRegistry = false; + + var detachFinalizer = (handle) => {}; + + var runDestructor = ($$) => { + if ($$.smartPtr) { + $$.smartPtrType.rawDestructor($$.smartPtr); + } else { + $$.ptrType.registeredClass.rawDestructor($$.ptr); + } + }; + + var releaseClassHandle = ($$) => { + $$.count.value -= 1; + var toDelete = 0 === $$.count.value; + if (toDelete) { + runDestructor($$); + } + }; + + var downcastPointer = (ptr, ptrClass, desiredClass) => { + if (ptrClass === desiredClass) { + return ptr; + } + if (undefined === desiredClass.baseClass) { + return null; + } + var rv = downcastPointer(ptr, ptrClass, desiredClass.baseClass); + if (rv === null) { + return null; + } + return desiredClass.downcast(rv); + }; + + var registeredPointers = {}; + + var getInheritedInstanceCount = () => + Object.keys(registeredInstances).length; + + var getLiveInheritedInstances = () => { + var rv = []; + for (var k in registeredInstances) { + if (registeredInstances.hasOwnProperty(k)) { + rv.push(registeredInstances[k]); + } + } + return rv; + }; + + var deletionQueue = []; + + var flushPendingDeletes = () => { + while (deletionQueue.length) { + var obj = deletionQueue.pop(); + obj.$$.deleteScheduled = false; + obj["delete"](); + } + }; + + var delayFunction; + + var setDelayFunction = (fn) => { + delayFunction = fn; + if (deletionQueue.length && delayFunction) { + delayFunction(flushPendingDeletes); + } + }; + + var init_embind = () => { + Module["getInheritedInstanceCount"] = getInheritedInstanceCount; + Module["getLiveInheritedInstances"] = getLiveInheritedInstances; + Module["flushPendingDeletes"] = flushPendingDeletes; + Module["setDelayFunction"] = setDelayFunction; + }; + + var registeredInstances = {}; + + var getBasestPointer = (class_, ptr) => { + if (ptr === undefined) { + throwBindingError("ptr should not be undefined"); + } + while (class_.baseClass) { + ptr = class_.upcast(ptr); + class_ = class_.baseClass; + } + return ptr; + }; + + var getInheritedInstance = (class_, ptr) => { + ptr = getBasestPointer(class_, ptr); + return registeredInstances[ptr]; + }; + + var makeClassHandle = (prototype, record) => { + if (!record.ptrType || !record.ptr) { + throwInternalError("makeClassHandle requires ptr and ptrType"); + } + var hasSmartPtrType = !!record.smartPtrType; + var hasSmartPtr = !!record.smartPtr; + if (hasSmartPtrType !== hasSmartPtr) { + throwInternalError("Both smartPtrType and smartPtr must be specified"); + } + record.count = { + value: 1, + }; + return attachFinalizer( + Object.create(prototype, { + $$: { + value: record, + }, + }), + ); + }; + + /** @suppress {globalThis} */ function RegisteredPointer_fromWireType(ptr) { + var rawPointer = this.getPointee(ptr); + if (!rawPointer) { + this.destructor(ptr); + return null; + } + var registeredInstance = getInheritedInstance( + this.registeredClass, + rawPointer, + ); + if (undefined !== registeredInstance) { + if (0 === registeredInstance.$$.count.value) { + registeredInstance.$$.ptr = rawPointer; + registeredInstance.$$.smartPtr = ptr; + return registeredInstance["clone"](); + } else { + var rv = registeredInstance["clone"](); + this.destructor(ptr); + return rv; + } + } + function makeDefaultHandle() { + if (this.isSmartPointer) { + return makeClassHandle(this.registeredClass.instancePrototype, { + ptrType: this.pointeeType, + ptr: rawPointer, + smartPtrType: this, + smartPtr: ptr, + }); + } else { + return makeClassHandle(this.registeredClass.instancePrototype, { + ptrType: this, + ptr: ptr, + }); + } + } + var actualType = this.registeredClass.getActualType(rawPointer); + var registeredPointerRecord = registeredPointers[actualType]; + if (!registeredPointerRecord) { + return makeDefaultHandle.call(this); + } + var toType; + if (this.isConst) { + toType = registeredPointerRecord.constPointerType; + } else { + toType = registeredPointerRecord.pointerType; + } + var dp = downcastPointer( + rawPointer, + this.registeredClass, + toType.registeredClass, + ); + if (dp === null) { + return makeDefaultHandle.call(this); + } + if (this.isSmartPointer) { + return makeClassHandle(toType.registeredClass.instancePrototype, { + ptrType: toType, + ptr: dp, + smartPtrType: this, + smartPtr: ptr, + }); + } else { + return makeClassHandle(toType.registeredClass.instancePrototype, { + ptrType: toType, + ptr: dp, + }); + } + } + + var attachFinalizer = (handle) => { + if ("undefined" === typeof FinalizationRegistry) { + attachFinalizer = (handle) => handle; + return handle; + } + finalizationRegistry = new FinalizationRegistry((info) => { + releaseClassHandle(info.$$); + }); + attachFinalizer = (handle) => { + var $$ = handle.$$; + var hasSmartPtr = !!$$.smartPtr; + if (hasSmartPtr) { + var info = { + $$: $$, + }; + finalizationRegistry.register(handle, info, handle); + } + return handle; + }; + detachFinalizer = (handle) => finalizationRegistry.unregister(handle); + return attachFinalizer(handle); + }; + + var init_ClassHandle = () => { + Object.assign(ClassHandle.prototype, { + isAliasOf(other) { + if (!(this instanceof ClassHandle)) { + return false; + } + if (!(other instanceof ClassHandle)) { + return false; + } + var leftClass = this.$$.ptrType.registeredClass; + var left = this.$$.ptr; + other.$$ = /** @type {Object} */ (other.$$); + var rightClass = other.$$.ptrType.registeredClass; + var right = other.$$.ptr; + while (leftClass.baseClass) { + left = leftClass.upcast(left); + leftClass = leftClass.baseClass; + } + while (rightClass.baseClass) { + right = rightClass.upcast(right); + rightClass = rightClass.baseClass; + } + return leftClass === rightClass && left === right; + }, + clone() { + if (!this.$$.ptr) { + throwInstanceAlreadyDeleted(this); + } + if (this.$$.preservePointerOnDelete) { + this.$$.count.value += 1; + return this; + } else { + var clone = attachFinalizer( + Object.create(Object.getPrototypeOf(this), { + $$: { + value: shallowCopyInternalPointer(this.$$), + }, + }), + ); + clone.$$.count.value += 1; + clone.$$.deleteScheduled = false; + return clone; + } + }, + delete() { + if (!this.$$.ptr) { + throwInstanceAlreadyDeleted(this); + } + if (this.$$.deleteScheduled && !this.$$.preservePointerOnDelete) { + throwBindingError("Object already scheduled for deletion"); + } + detachFinalizer(this); + releaseClassHandle(this.$$); + if (!this.$$.preservePointerOnDelete) { + this.$$.smartPtr = undefined; + this.$$.ptr = undefined; + } + }, + isDeleted() { + return !this.$$.ptr; + }, + deleteLater() { + if (!this.$$.ptr) { + throwInstanceAlreadyDeleted(this); + } + if (this.$$.deleteScheduled && !this.$$.preservePointerOnDelete) { + throwBindingError("Object already scheduled for deletion"); + } + deletionQueue.push(this); + if (deletionQueue.length === 1 && delayFunction) { + delayFunction(flushPendingDeletes); + } + this.$$.deleteScheduled = true; + return this; + }, + }); + }; + + /** @constructor */ function ClassHandle() {} + + var char_0 = 48; + + var char_9 = 57; + + var makeLegalFunctionName = (name) => { + if (undefined === name) { + return "_unknown"; + } + name = name.replace(/[^a-zA-Z0-9_]/g, "$"); + var f = name.charCodeAt(0); + if (f >= char_0 && f <= char_9) { + return `_${name}`; + } + return name; + }; + + function createNamedFunction(name, body) { + name = makeLegalFunctionName(name); + return { + [name]: function () { + return body.apply(this, arguments); + }, + }[name]; + } + + var ensureOverloadTable = (proto, methodName, humanName) => { + if (undefined === proto[methodName].overloadTable) { + var prevFunc = proto[methodName]; + proto[methodName] = function () { + if ( + !proto[methodName].overloadTable.hasOwnProperty(arguments.length) + ) { + throwBindingError( + `Function '${humanName}' called with an invalid number of arguments (${arguments.length}) - expects one of (${proto[methodName].overloadTable})!`, + ); + } + return proto[methodName].overloadTable[arguments.length].apply( + this, + arguments, + ); + }; + proto[methodName].overloadTable = []; + proto[methodName].overloadTable[prevFunc.argCount] = prevFunc; + } + }; + + /** @param {number=} numArguments */ var exposePublicSymbol = ( + name, + value, + numArguments, + ) => { + if (Module.hasOwnProperty(name)) { + if ( + undefined === numArguments || + (undefined !== Module[name].overloadTable && + undefined !== Module[name].overloadTable[numArguments]) + ) { + throwBindingError(`Cannot register public name '${name}' twice`); + } + ensureOverloadTable(Module, name, name); + if (Module.hasOwnProperty(numArguments)) { + throwBindingError( + `Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`, + ); + } + Module[name].overloadTable[numArguments] = value; + } else { + Module[name] = value; + if (undefined !== numArguments) { + Module[name].numArguments = numArguments; + } + } + }; + + /** @constructor */ function RegisteredClass( + name, + constructor, + instancePrototype, + rawDestructor, + baseClass, + getActualType, + upcast, + downcast, + ) { + this.name = name; + this.constructor = constructor; + this.instancePrototype = instancePrototype; + this.rawDestructor = rawDestructor; + this.baseClass = baseClass; + this.getActualType = getActualType; + this.upcast = upcast; + this.downcast = downcast; + this.pureVirtualFunctions = []; + } + + var upcastPointer = (ptr, ptrClass, desiredClass) => { + while (ptrClass !== desiredClass) { + if (!ptrClass.upcast) { + throwBindingError( + `Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`, + ); + } + ptr = ptrClass.upcast(ptr); + ptrClass = ptrClass.baseClass; + } + return ptr; + }; + + /** @suppress {globalThis} */ function constNoSmartPtrRawPointerToWireType( + destructors, + handle, + ) { + if (handle === null) { + if (this.isReference) { + throwBindingError(`null is not a valid ${this.name}`); + } + return 0; + } + if (!handle.$$) { + throwBindingError( + `Cannot pass "${embindRepr(handle)}" as a ${this.name}`, + ); + } + if (!handle.$$.ptr) { + throwBindingError( + `Cannot pass deleted object as a pointer of type ${this.name}`, + ); + } + var handleClass = handle.$$.ptrType.registeredClass; + var ptr = upcastPointer(handle.$$.ptr, handleClass, this.registeredClass); + return ptr; + } + + /** @suppress {globalThis} */ function genericPointerToWireType( + destructors, + handle, + ) { + var ptr; + if (handle === null) { + if (this.isReference) { + throwBindingError(`null is not a valid ${this.name}`); + } + if (this.isSmartPointer) { + ptr = this.rawConstructor(); + if (destructors !== null) { + destructors.push(this.rawDestructor, ptr); + } + return ptr; + } else { + return 0; + } + } + if (!handle.$$) { + throwBindingError( + `Cannot pass "${embindRepr(handle)}" as a ${this.name}`, + ); + } + if (!handle.$$.ptr) { + throwBindingError( + `Cannot pass deleted object as a pointer of type ${this.name}`, + ); + } + if (!this.isConst && handle.$$.ptrType.isConst) { + throwBindingError( + `Cannot convert argument of type ${handle.$$.smartPtrType ? handle.$$.smartPtrType.name : handle.$$.ptrType.name} to parameter type ${this.name}`, + ); + } + var handleClass = handle.$$.ptrType.registeredClass; + ptr = upcastPointer(handle.$$.ptr, handleClass, this.registeredClass); + if (this.isSmartPointer) { + if (undefined === handle.$$.smartPtr) { + throwBindingError("Passing raw pointer to smart pointer is illegal"); + } + switch (this.sharingPolicy) { + case 0: + if (handle.$$.smartPtrType === this) { + ptr = handle.$$.smartPtr; + } else { + throwBindingError( + `Cannot convert argument of type ${handle.$$.smartPtrType ? handle.$$.smartPtrType.name : handle.$$.ptrType.name} to parameter type ${this.name}`, + ); + } + break; + + case 1: + ptr = handle.$$.smartPtr; + break; + + case 2: + if (handle.$$.smartPtrType === this) { + ptr = handle.$$.smartPtr; + } else { + var clonedHandle = handle["clone"](); + ptr = this.rawShare( + ptr, + Emval.toHandle(() => clonedHandle["delete"]()), + ); + if (destructors !== null) { + destructors.push(this.rawDestructor, ptr); + } + } + break; + + default: + throwBindingError("Unsupporting sharing policy"); + } + } + return ptr; + } + + /** @suppress {globalThis} */ function nonConstNoSmartPtrRawPointerToWireType( + destructors, + handle, + ) { + if (handle === null) { + if (this.isReference) { + throwBindingError(`null is not a valid ${this.name}`); + } + return 0; + } + if (!handle.$$) { + throwBindingError( + `Cannot pass "${embindRepr(handle)}" as a ${this.name}`, + ); + } + if (!handle.$$.ptr) { + throwBindingError( + `Cannot pass deleted object as a pointer of type ${this.name}`, + ); + } + if (handle.$$.ptrType.isConst) { + throwBindingError( + `Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`, + ); + } + var handleClass = handle.$$.ptrType.registeredClass; + var ptr = upcastPointer(handle.$$.ptr, handleClass, this.registeredClass); + return ptr; + } + + /** @suppress {globalThis} */ function readPointer(pointer) { + return this["fromWireType"](GROWABLE_HEAP_U32()[(pointer >>> 2) >>> 0]); + } + + var init_RegisteredPointer = () => { + Object.assign(RegisteredPointer.prototype, { + getPointee(ptr) { + if (this.rawGetPointee) { + ptr = this.rawGetPointee(ptr); + } + return ptr; + }, + destructor(ptr) { + if (this.rawDestructor) { + this.rawDestructor(ptr); + } + }, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: readPointer, + deleteObject(handle) { + if (handle !== null) { + handle["delete"](); + } + }, + fromWireType: RegisteredPointer_fromWireType, + }); + }; + + /** @constructor + @param {*=} pointeeType, + @param {*=} sharingPolicy, + @param {*=} rawGetPointee, + @param {*=} rawConstructor, + @param {*=} rawShare, + @param {*=} rawDestructor, + */ function RegisteredPointer( + name, + registeredClass, + isReference, + isConst, + isSmartPointer, + pointeeType, + sharingPolicy, + rawGetPointee, + rawConstructor, + rawShare, + rawDestructor, + ) { + this.name = name; + this.registeredClass = registeredClass; + this.isReference = isReference; + this.isConst = isConst; + this.isSmartPointer = isSmartPointer; + this.pointeeType = pointeeType; + this.sharingPolicy = sharingPolicy; + this.rawGetPointee = rawGetPointee; + this.rawConstructor = rawConstructor; + this.rawShare = rawShare; + this.rawDestructor = rawDestructor; + if (!isSmartPointer && registeredClass.baseClass === undefined) { + if (isConst) { + this["toWireType"] = constNoSmartPtrRawPointerToWireType; + this.destructorFunction = null; + } else { + this["toWireType"] = nonConstNoSmartPtrRawPointerToWireType; + this.destructorFunction = null; + } + } else { + this["toWireType"] = genericPointerToWireType; + } + } + + /** @param {number=} numArguments */ var replacePublicSymbol = ( + name, + value, + numArguments, + ) => { + if (!Module.hasOwnProperty(name)) { + throwInternalError("Replacing nonexistant public symbol"); + } + if ( + undefined !== Module[name].overloadTable && + undefined !== numArguments + ) { + Module[name].overloadTable[numArguments] = value; + } else { + Module[name] = value; + Module[name].argCount = numArguments; + } + }; + + var dynCallLegacy = (sig, ptr, args) => { + var f = Module["dynCall_" + sig]; + return args && args.length + ? f.apply(null, [ptr].concat(args)) + : f.call(null, ptr); + }; + + var wasmTable; + + var getWasmTableEntry = (funcPtr) => wasmTable.get(funcPtr); + + /** @param {Object=} args */ var dynCall = (sig, ptr, args) => { + var rtn = dynCallLegacy(sig, ptr, args); + return rtn; + }; + + var getDynCaller = (sig, ptr) => { + var argCache = []; + return function () { + argCache.length = 0; + Object.assign(argCache, arguments); + return dynCall(sig, ptr, argCache); + }; + }; + + var embind__requireFunction = (signature, rawFunction) => { + signature = readLatin1String(signature); + function makeDynCaller() { + return getDynCaller(signature, rawFunction); + } + var fp = makeDynCaller(); + if (typeof fp != "function") { + throwBindingError( + `unknown function pointer with signature ${signature}: ${rawFunction}`, + ); + } + return fp; + }; + + var extendError = (baseErrorType, errorName) => { + var errorClass = createNamedFunction(errorName, function (message) { + this.name = errorName; + this.message = message; + var stack = new Error(message).stack; + if (stack !== undefined) { + this.stack = + this.toString() + "\n" + stack.replace(/^Error(:[^\n]*)?\n/, ""); + } + }); + errorClass.prototype = Object.create(baseErrorType.prototype); + errorClass.prototype.constructor = errorClass; + errorClass.prototype.toString = function () { + if (this.message === undefined) { + return this.name; + } else { + return `${this.name}: ${this.message}`; + } + }; + return errorClass; + }; + + var UnboundTypeError; + + var getTypeName = (type) => { + var ptr = ___getTypeName(type); + var rv = readLatin1String(ptr); + _free(ptr); + return rv; + }; + + var throwUnboundTypeError = (message, types) => { + var unboundTypes = []; + var seen = {}; + function visit(type) { + if (seen[type]) { + return; + } + if (registeredTypes[type]) { + return; + } + if (typeDependencies[type]) { + typeDependencies[type].forEach(visit); + return; + } + unboundTypes.push(type); + seen[type] = true; + } + types.forEach(visit); + throw new UnboundTypeError( + `${message}: ` + unboundTypes.map(getTypeName).join([", "]), + ); + }; + + function __embind_register_class( + rawType, + rawPointerType, + rawConstPointerType, + baseClassRawType, + getActualTypeSignature, + getActualType, + upcastSignature, + upcast, + downcastSignature, + downcast, + name, + destructorSignature, + rawDestructor, + ) { + rawType >>>= 0; + rawPointerType >>>= 0; + rawConstPointerType >>>= 0; + baseClassRawType >>>= 0; + getActualTypeSignature >>>= 0; + getActualType >>>= 0; + upcastSignature >>>= 0; + upcast >>>= 0; + downcastSignature >>>= 0; + downcast >>>= 0; + name >>>= 0; + destructorSignature >>>= 0; + rawDestructor >>>= 0; + name = readLatin1String(name); + getActualType = embind__requireFunction( + getActualTypeSignature, + getActualType, + ); + if (upcast) { + upcast = embind__requireFunction(upcastSignature, upcast); + } + if (downcast) { + downcast = embind__requireFunction(downcastSignature, downcast); + } + rawDestructor = embind__requireFunction( + destructorSignature, + rawDestructor, + ); + var legalFunctionName = makeLegalFunctionName(name); + exposePublicSymbol(legalFunctionName, function () { + throwUnboundTypeError(`Cannot construct ${name} due to unbound types`, [ + baseClassRawType, + ]); + }); + whenDependentTypesAreResolved( + [rawType, rawPointerType, rawConstPointerType], + baseClassRawType ? [baseClassRawType] : [], + function (base) { + base = base[0]; + var baseClass; + var basePrototype; + if (baseClassRawType) { + baseClass = base.registeredClass; + basePrototype = baseClass.instancePrototype; + } else { + basePrototype = ClassHandle.prototype; + } + var constructor = createNamedFunction(legalFunctionName, function () { + if (Object.getPrototypeOf(this) !== instancePrototype) { + throw new BindingError("Use 'new' to construct " + name); + } + if (undefined === registeredClass.constructor_body) { + throw new BindingError(name + " has no accessible constructor"); + } + var body = registeredClass.constructor_body[arguments.length]; + if (undefined === body) { + throw new BindingError( + `Tried to invoke ctor of ${name} with invalid number of parameters (${arguments.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`, + ); + } + return body.apply(this, arguments); + }); + var instancePrototype = Object.create(basePrototype, { + constructor: { + value: constructor, + }, + }); + constructor.prototype = instancePrototype; + var registeredClass = new RegisteredClass( + name, + constructor, + instancePrototype, + rawDestructor, + baseClass, + getActualType, + upcast, + downcast, + ); + if (registeredClass.baseClass) { + if (registeredClass.baseClass.__derivedClasses === undefined) { + registeredClass.baseClass.__derivedClasses = []; + } + registeredClass.baseClass.__derivedClasses.push(registeredClass); + } + var referenceConverter = new RegisteredPointer( + name, + registeredClass, + true, + false, + false, + ); + var pointerConverter = new RegisteredPointer( + name + "*", + registeredClass, + false, + false, + false, + ); + var constPointerConverter = new RegisteredPointer( + name + " const*", + registeredClass, + false, + true, + false, + ); + registeredPointers[rawType] = { + pointerType: pointerConverter, + constPointerType: constPointerConverter, + }; + replacePublicSymbol(legalFunctionName, constructor); + return [referenceConverter, pointerConverter, constPointerConverter]; + }, + ); + } + + var runDestructors = (destructors) => { + while (destructors.length) { + var ptr = destructors.pop(); + var del = destructors.pop(); + del(ptr); + } + }; + + function newFunc(constructor, argumentList) { + if (!(constructor instanceof Function)) { + throw new TypeError( + `new_ called with constructor type ${typeof constructor} which is not a function`, + ); + } + /* + * Previously, the following line was just: + * function dummy() {}; + * Unfortunately, Chrome was preserving 'dummy' as the object's name, even + * though at creation, the 'dummy' has the correct constructor name. Thus, + * objects created with IMVU.new would show up in the debugger as 'dummy', + * which isn't very helpful. Using IMVU.createNamedFunction addresses the + * issue. Doublely-unfortunately, there's no way to write a test for this + * behavior. -NRD 2013.02.22 + */ var dummy = createNamedFunction( + constructor.name || "unknownFunctionName", + function () {}, + ); + dummy.prototype = constructor.prototype; + var obj = new dummy(); + var r = constructor.apply(obj, argumentList); + return r instanceof Object ? r : obj; + } + + var runAndAbortIfError = (func) => { + try { + return func(); + } catch (e) { + abort(e); + } + }; + + var maybeExit = () => { + if (!keepRuntimeAlive()) { + try { + if (ENVIRONMENT_IS_PTHREAD) __emscripten_thread_exit(EXITSTATUS); + else _exit(EXITSTATUS); + } catch (e) { + handleException(e); + } + } + }; + + var callUserCallback = (func) => { + if (ABORT) { + return; + } + try { + func(); + maybeExit(); + } catch (e) { + handleException(e); + } + }; + + var sigToWasmTypes = (sig) => { + var typeNames = { + i: "i32", + j: "i64", + f: "f32", + d: "f64", + e: "externref", + p: "i32", + }; + var type = { + parameters: [], + results: sig[0] == "v" ? [] : [typeNames[sig[0]]], + }; + for (var i = 1; i < sig.length; ++i) { + type.parameters.push(typeNames[sig[i]]); + } + return type; + }; + + var runtimeKeepalivePush = () => { + runtimeKeepaliveCounter += 1; + }; + + var runtimeKeepalivePop = () => { + runtimeKeepaliveCounter -= 1; + }; + + var Asyncify = { + instrumentWasmImports(imports) { + var importPattern = /^(invoke_.*|__asyncjs__.*)$/; + for (var x in imports) { + (function (x) { + var original = imports[x]; + var sig = original.sig; + if (typeof original == "function") { + var isAsyncifyImport = original.isAsync || importPattern.test(x); + } + })(x); + } + }, + instrumentWasmExports(exports) { + var ret = {}; + for (var x in exports) { + (function (x) { + var original = exports[x]; + if (typeof original == "function") { + ret[x] = function () { + Asyncify.exportCallStack.push(x); + try { + return original.apply(null, arguments); + } finally { + if (!ABORT) { + var y = Asyncify.exportCallStack.pop(); + assert(y === x); + Asyncify.maybeStopUnwind(); + } + } + }; + } else { + ret[x] = original; + } + })(x); + } + return ret; + }, + State: { + Normal: 0, + Unwinding: 1, + Rewinding: 2, + Disabled: 3, + }, + state: 0, + StackSize: 4096, + currData: null, + handleSleepReturnValue: 0, + exportCallStack: [], + callStackNameToId: {}, + callStackIdToName: {}, + callStackId: 0, + asyncPromiseHandlers: null, + sleepCallbacks: [], + getCallStackId(funcName) { + var id = Asyncify.callStackNameToId[funcName]; + if (id === undefined) { + id = Asyncify.callStackId++; + Asyncify.callStackNameToId[funcName] = id; + Asyncify.callStackIdToName[id] = funcName; + } + return id; + }, + maybeStopUnwind() { + if ( + Asyncify.currData && + Asyncify.state === Asyncify.State.Unwinding && + Asyncify.exportCallStack.length === 0 + ) { + Asyncify.state = Asyncify.State.Normal; + runtimeKeepalivePush(); + runAndAbortIfError(_asyncify_stop_unwind); + if (typeof Fibers != "undefined") { + Fibers.trampoline(); + } + } + }, + whenDone() { + return new Promise((resolve, reject) => { + Asyncify.asyncPromiseHandlers = { + resolve: resolve, + reject: reject, + }; + }); + }, + allocateData() { + var ptr = _malloc(12 + Asyncify.StackSize); + Asyncify.setDataHeader(ptr, ptr + 12, Asyncify.StackSize); + Asyncify.setDataRewindFunc(ptr); + return ptr; + }, + setDataHeader(ptr, stack, stackSize) { + GROWABLE_HEAP_U32()[(ptr >>> 2) >>> 0] = stack; + GROWABLE_HEAP_U32()[((ptr + 4) >>> 2) >>> 0] = stack + stackSize; + }, + setDataRewindFunc(ptr) { + var bottomOfCallStack = Asyncify.exportCallStack[0]; + var rewindId = Asyncify.getCallStackId(bottomOfCallStack); + GROWABLE_HEAP_I32()[((ptr + 8) >>> 2) >>> 0] = rewindId; + }, + getDataRewindFunc(ptr) { + var id = GROWABLE_HEAP_I32()[((ptr + 8) >>> 2) >>> 0]; + var name = Asyncify.callStackIdToName[id]; + var func = wasmExports[name]; + return func; + }, + doRewind(ptr) { + var start = Asyncify.getDataRewindFunc(ptr); + runtimeKeepalivePop(); + return start(); + }, + handleSleep(startAsync) { + if (ABORT) return; + if (Asyncify.state === Asyncify.State.Normal) { + var reachedCallback = false; + var reachedAfterCallback = false; + startAsync((handleSleepReturnValue = 0) => { + if (ABORT) return; + Asyncify.handleSleepReturnValue = handleSleepReturnValue; + reachedCallback = true; + if (!reachedAfterCallback) { + return; + } + Asyncify.state = Asyncify.State.Rewinding; + runAndAbortIfError(() => _asyncify_start_rewind(Asyncify.currData)); + if (typeof Browser != "undefined" && Browser.mainLoop.func) { + Browser.mainLoop.resume(); + } + var asyncWasmReturnValue, + isError = false; + try { + asyncWasmReturnValue = Asyncify.doRewind(Asyncify.currData); + } catch (err) { + asyncWasmReturnValue = err; + isError = true; + } + var handled = false; + if (!Asyncify.currData) { + var asyncPromiseHandlers = Asyncify.asyncPromiseHandlers; + if (asyncPromiseHandlers) { + Asyncify.asyncPromiseHandlers = null; + (isError + ? asyncPromiseHandlers.reject + : asyncPromiseHandlers.resolve)(asyncWasmReturnValue); + handled = true; + } + } + if (isError && !handled) { + throw asyncWasmReturnValue; + } + }); + reachedAfterCallback = true; + if (!reachedCallback) { + Asyncify.state = Asyncify.State.Unwinding; + Asyncify.currData = Asyncify.allocateData(); + if (typeof Browser != "undefined" && Browser.mainLoop.func) { + Browser.mainLoop.pause(); + } + runAndAbortIfError(() => _asyncify_start_unwind(Asyncify.currData)); + } + } else if (Asyncify.state === Asyncify.State.Rewinding) { + Asyncify.state = Asyncify.State.Normal; + runAndAbortIfError(_asyncify_stop_rewind); + _free(Asyncify.currData); + Asyncify.currData = null; + Asyncify.sleepCallbacks.forEach((func) => callUserCallback(func)); + } else { + abort(`invalid state: ${Asyncify.state}`); + } + return Asyncify.handleSleepReturnValue; + }, + handleAsync(startAsync) { + return Asyncify.handleSleep((wakeUp) => { + startAsync().then(wakeUp); + }); + }, + }; + + function craftInvokerFunction( + humanName, + argTypes, + classType, + cppInvokerFunc, + cppTargetFunc, + /** boolean= */ isAsync, + ) { + var argCount = argTypes.length; + if (argCount < 2) { + throwBindingError( + "argTypes array size mismatch! Must at least get return value and 'this' types!", + ); + } + var isClassMethodFunc = argTypes[1] !== null && classType !== null; + var needsDestructorStack = false; + for (var i = 1; i < argTypes.length; ++i) { + if ( + argTypes[i] !== null && + argTypes[i].destructorFunction === undefined + ) { + needsDestructorStack = true; + break; + } + } + var returns = argTypes[0].name !== "void"; + var argsList = ""; + var argsListWired = ""; + for (var i = 0; i < argCount - 2; ++i) { + argsList += (i !== 0 ? ", " : "") + "arg" + i; + argsListWired += (i !== 0 ? ", " : "") + "arg" + i + "Wired"; + } + var invokerFnBody = `\n return function ${makeLegalFunctionName(humanName)}(${argsList}) {\n if (arguments.length !== ${argCount - 2}) {\n throwBindingError('function ${humanName} called with ' + arguments.length + ' arguments, expected ${argCount - 2}');\n }`; + if (needsDestructorStack) { + invokerFnBody += "var destructors = [];\n"; + } + var dtorStack = needsDestructorStack ? "destructors" : "null"; + var args1 = [ + "throwBindingError", + "invoker", + "fn", + "runDestructors", + "retType", + "classParam", + ]; + var args2 = [ + throwBindingError, + cppInvokerFunc, + cppTargetFunc, + runDestructors, + argTypes[0], + argTypes[1], + ]; + if (isClassMethodFunc) { + invokerFnBody += + "var thisWired = classParam.toWireType(" + dtorStack + ", this);\n"; + } + for (var i = 0; i < argCount - 2; ++i) { + invokerFnBody += + "var arg" + + i + + "Wired = argType" + + i + + ".toWireType(" + + dtorStack + + ", arg" + + i + + "); // " + + argTypes[i + 2].name + + "\n"; + args1.push("argType" + i); + args2.push(argTypes[i + 2]); + } + if (isClassMethodFunc) { + argsListWired = + "thisWired" + (argsListWired.length > 0 ? ", " : "") + argsListWired; + } + invokerFnBody += + (returns || isAsync ? "var rv = " : "") + + "invoker(fn" + + (argsListWired.length > 0 ? ", " : "") + + argsListWired + + ");\n"; + args1.push("Asyncify"); + args2.push(Asyncify); + invokerFnBody += "function onDone(" + (returns ? "rv" : "") + ") {\n"; + if (needsDestructorStack) { + invokerFnBody += "runDestructors(destructors);\n"; + } else { + for (var i = isClassMethodFunc ? 1 : 2; i < argTypes.length; ++i) { + var paramName = i === 1 ? "thisWired" : "arg" + (i - 2) + "Wired"; + if (argTypes[i].destructorFunction !== null) { + invokerFnBody += + paramName + + "_dtor(" + + paramName + + "); // " + + argTypes[i].name + + "\n"; + args1.push(paramName + "_dtor"); + args2.push(argTypes[i].destructorFunction); + } + } + } + if (returns) { + invokerFnBody += + "var ret = retType.fromWireType(rv);\n" + "return ret;\n"; + } else { + } + invokerFnBody += "}\n"; + invokerFnBody += + "return Asyncify.currData ? Asyncify.whenDone().then(onDone) : onDone(" + + (returns ? "rv" : "") + + ");\n"; + invokerFnBody += "}\n"; + args1.push(invokerFnBody); + return newFunc(Function, args1).apply(null, args2); + } + + var heap32VectorToArray = (count, firstElement) => { + var array = []; + for (var i = 0; i < count; i++) { + array.push(GROWABLE_HEAP_U32()[((firstElement + i * 4) >>> 2) >>> 0]); + } + return array; + }; + + var getFunctionName = (signature) => { + signature = signature.trim(); + const argsIndex = signature.indexOf("("); + if (argsIndex !== -1) { + assert( + signature[signature.length - 1] == ")", + "Parentheses for argument names should match.", + ); + return signature.substr(0, argsIndex); + } else { + return signature; + } + }; + + function __embind_register_class_class_function( + rawClassType, + methodName, + argCount, + rawArgTypesAddr, + invokerSignature, + rawInvoker, + fn, + isAsync, + ) { + rawClassType >>>= 0; + methodName >>>= 0; + rawArgTypesAddr >>>= 0; + invokerSignature >>>= 0; + rawInvoker >>>= 0; + fn >>>= 0; + var rawArgTypes = heap32VectorToArray(argCount, rawArgTypesAddr); + methodName = readLatin1String(methodName); + methodName = getFunctionName(methodName); + rawInvoker = embind__requireFunction(invokerSignature, rawInvoker); + whenDependentTypesAreResolved([], [rawClassType], function (classType) { + classType = classType[0]; + var humanName = `${classType.name}.${methodName}`; + function unboundTypesHandler() { + throwUnboundTypeError( + `Cannot call ${humanName} due to unbound types`, + rawArgTypes, + ); + } + if (methodName.startsWith("@@")) { + methodName = Symbol[methodName.substring(2)]; + } + var proto = classType.registeredClass.constructor; + if (undefined === proto[methodName]) { + unboundTypesHandler.argCount = argCount - 1; + proto[methodName] = unboundTypesHandler; + } else { + ensureOverloadTable(proto, methodName, humanName); + proto[methodName].overloadTable[argCount - 1] = unboundTypesHandler; + } + whenDependentTypesAreResolved([], rawArgTypes, function (argTypes) { + var invokerArgsArray = [argTypes[0], /* return value */ null].concat( + /* no class 'this'*/ argTypes.slice(1), + ); + /* actual params */ var func = craftInvokerFunction( + humanName, + invokerArgsArray, + null, + /* no class 'this'*/ rawInvoker, + fn, + isAsync, + ); + if (undefined === proto[methodName].overloadTable) { + func.argCount = argCount - 1; + proto[methodName] = func; + } else { + proto[methodName].overloadTable[argCount - 1] = func; + } + if (classType.registeredClass.__derivedClasses) { + for (const derivedClass of classType.registeredClass + .__derivedClasses) { + if (!derivedClass.constructor.hasOwnProperty(methodName)) { + derivedClass.constructor[methodName] = func; + } + } + } + return []; + }); + return []; + }); + } + + var validateThis = (this_, classType, humanName) => { + if (!(this_ instanceof Object)) { + throwBindingError(`${humanName} with invalid "this": ${this_}`); + } + if (!(this_ instanceof classType.registeredClass.constructor)) { + throwBindingError( + `${humanName} incompatible with "this" of type ${this_.constructor.name}`, + ); + } + if (!this_.$$.ptr) { + throwBindingError( + `cannot call emscripten binding method ${humanName} on deleted object`, + ); + } + return upcastPointer( + this_.$$.ptr, + this_.$$.ptrType.registeredClass, + classType.registeredClass, + ); + }; + + function __embind_register_class_class_property( + rawClassType, + fieldName, + rawFieldType, + rawFieldPtr, + getterSignature, + getter, + setterSignature, + setter, + ) { + rawClassType >>>= 0; + fieldName >>>= 0; + rawFieldType >>>= 0; + rawFieldPtr >>>= 0; + getterSignature >>>= 0; + getter >>>= 0; + setterSignature >>>= 0; + setter >>>= 0; + fieldName = readLatin1String(fieldName); + getter = embind__requireFunction(getterSignature, getter); + whenDependentTypesAreResolved([], [rawClassType], function (classType) { + classType = classType[0]; + var humanName = `${classType.name}.${fieldName}`; + var desc = { + get() { + throwUnboundTypeError( + `Cannot access ${humanName} due to unbound types`, + [rawFieldType], + ); + }, + enumerable: true, + configurable: true, + }; + if (setter) { + desc.set = () => { + throwUnboundTypeError( + `Cannot access ${humanName} due to unbound types`, + [rawFieldType], + ); + }; + } else { + desc.set = (v) => { + throwBindingError(`${humanName} is a read-only property`); + }; + } + Object.defineProperty( + classType.registeredClass.constructor, + fieldName, + desc, + ); + whenDependentTypesAreResolved([], [rawFieldType], function (fieldType) { + fieldType = fieldType[0]; + var desc = { + get() { + return fieldType["fromWireType"](getter(rawFieldPtr)); + }, + enumerable: true, + }; + if (setter) { + setter = embind__requireFunction(setterSignature, setter); + desc.set = (v) => { + var destructors = []; + setter(rawFieldPtr, fieldType["toWireType"](destructors, v)); + runDestructors(destructors); + }; + } + Object.defineProperty( + classType.registeredClass.constructor, + fieldName, + desc, + ); + return []; + }); + return []; + }); + } + + function __embind_register_class_constructor( + rawClassType, + argCount, + rawArgTypesAddr, + invokerSignature, + invoker, + rawConstructor, + ) { + rawClassType >>>= 0; + rawArgTypesAddr >>>= 0; + invokerSignature >>>= 0; + invoker >>>= 0; + rawConstructor >>>= 0; + var rawArgTypes = heap32VectorToArray(argCount, rawArgTypesAddr); + invoker = embind__requireFunction(invokerSignature, invoker); + var args = [rawConstructor]; + var destructors = []; + whenDependentTypesAreResolved([], [rawClassType], function (classType) { + classType = classType[0]; + var humanName = `constructor ${classType.name}`; + if (undefined === classType.registeredClass.constructor_body) { + classType.registeredClass.constructor_body = []; + } + if ( + undefined !== classType.registeredClass.constructor_body[argCount - 1] + ) { + throw new BindingError( + `Cannot register multiple constructors with identical number of parameters (${argCount - 1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`, + ); + } + classType.registeredClass.constructor_body[argCount - 1] = () => { + throwUnboundTypeError( + `Cannot construct ${classType.name} due to unbound types`, + rawArgTypes, + ); + }; + whenDependentTypesAreResolved([], rawArgTypes, (argTypes) => { + argTypes.splice(1, 0, null); + classType.registeredClass.constructor_body[argCount - 1] = + craftInvokerFunction( + humanName, + argTypes, + null, + invoker, + rawConstructor, + ); + return []; + }); + return []; + }); + } + + function __embind_register_class_function( + rawClassType, + methodName, + argCount, + rawArgTypesAddr, + invokerSignature, + rawInvoker, + context, + isPureVirtual, + isAsync, + ) { + rawClassType >>>= 0; + methodName >>>= 0; + rawArgTypesAddr >>>= 0; + invokerSignature >>>= 0; + rawInvoker >>>= 0; + context >>>= 0; + var rawArgTypes = heap32VectorToArray(argCount, rawArgTypesAddr); + methodName = readLatin1String(methodName); + methodName = getFunctionName(methodName); + rawInvoker = embind__requireFunction(invokerSignature, rawInvoker); + whenDependentTypesAreResolved([], [rawClassType], function (classType) { + classType = classType[0]; + var humanName = `${classType.name}.${methodName}`; + if (methodName.startsWith("@@")) { + methodName = Symbol[methodName.substring(2)]; + } + if (isPureVirtual) { + classType.registeredClass.pureVirtualFunctions.push(methodName); + } + function unboundTypesHandler() { + throwUnboundTypeError( + `Cannot call ${humanName} due to unbound types`, + rawArgTypes, + ); + } + var proto = classType.registeredClass.instancePrototype; + var method = proto[methodName]; + if ( + undefined === method || + (undefined === method.overloadTable && + method.className !== classType.name && + method.argCount === argCount - 2) + ) { + unboundTypesHandler.argCount = argCount - 2; + unboundTypesHandler.className = classType.name; + proto[methodName] = unboundTypesHandler; + } else { + ensureOverloadTable(proto, methodName, humanName); + proto[methodName].overloadTable[argCount - 2] = unboundTypesHandler; + } + whenDependentTypesAreResolved([], rawArgTypes, function (argTypes) { + var memberFunction = craftInvokerFunction( + humanName, + argTypes, + classType, + rawInvoker, + context, + isAsync, + ); + if (undefined === proto[methodName].overloadTable) { + memberFunction.argCount = argCount - 2; + proto[methodName] = memberFunction; + } else { + proto[methodName].overloadTable[argCount - 2] = memberFunction; + } + return []; + }); + return []; + }); + } + + function __embind_register_class_property( + classType, + fieldName, + getterReturnType, + getterSignature, + getter, + getterContext, + setterArgumentType, + setterSignature, + setter, + setterContext, + ) { + classType >>>= 0; + fieldName >>>= 0; + getterReturnType >>>= 0; + getterSignature >>>= 0; + getter >>>= 0; + getterContext >>>= 0; + setterArgumentType >>>= 0; + setterSignature >>>= 0; + setter >>>= 0; + setterContext >>>= 0; + fieldName = readLatin1String(fieldName); + getter = embind__requireFunction(getterSignature, getter); + whenDependentTypesAreResolved([], [classType], function (classType) { + classType = classType[0]; + var humanName = `${classType.name}.${fieldName}`; + var desc = { + get() { + throwUnboundTypeError( + `Cannot access ${humanName} due to unbound types`, + [getterReturnType, setterArgumentType], + ); + }, + enumerable: true, + configurable: true, + }; + if (setter) { + desc.set = () => + throwUnboundTypeError( + `Cannot access ${humanName} due to unbound types`, + [getterReturnType, setterArgumentType], + ); + } else { + desc.set = (v) => + throwBindingError(humanName + " is a read-only property"); + } + Object.defineProperty( + classType.registeredClass.instancePrototype, + fieldName, + desc, + ); + whenDependentTypesAreResolved( + [], + setter ? [getterReturnType, setterArgumentType] : [getterReturnType], + function (types) { + var getterReturnType = types[0]; + var desc = { + get() { + var ptr = validateThis(this, classType, humanName + " getter"); + return getterReturnType["fromWireType"]( + getter(getterContext, ptr), + ); + }, + enumerable: true, + }; + if (setter) { + setter = embind__requireFunction(setterSignature, setter); + var setterArgumentType = types[1]; + desc.set = function (v) { + var ptr = validateThis(this, classType, humanName + " setter"); + var destructors = []; + setter( + setterContext, + ptr, + setterArgumentType["toWireType"](destructors, v), + ); + runDestructors(destructors); + }; + } + Object.defineProperty( + classType.registeredClass.instancePrototype, + fieldName, + desc, + ); + return []; + }, + ); + return []; + }); + } + + function handleAllocatorInit() { + Object.assign( + HandleAllocator.prototype, + /** @lends {HandleAllocator.prototype} */ { + get(id) { + return this.allocated[id]; + }, + has(id) { + return this.allocated[id] !== undefined; + }, + allocate(handle) { + var id = this.freelist.pop() || this.allocated.length; + this.allocated[id] = handle; + return id; + }, + free(id) { + this.allocated[id] = undefined; + this.freelist.push(id); + }, + }, + ); + } + + /** @constructor */ function HandleAllocator() { + this.allocated = [undefined]; + this.freelist = []; + } + + var emval_handles = new HandleAllocator(); + + function __emval_decref(handle) { + handle >>>= 0; + if ( + handle >= emval_handles.reserved && + 0 === --emval_handles.get(handle).refcount + ) { + emval_handles.free(handle); + } + } + + var count_emval_handles = () => { + var count = 0; + for ( + var i = emval_handles.reserved; + i < emval_handles.allocated.length; + ++i + ) { + if (emval_handles.allocated[i] !== undefined) { + ++count; + } + } + return count; + }; + + var init_emval = () => { + emval_handles.allocated.push( + { + value: undefined, + }, + { + value: null, + }, + { + value: true, + }, + { + value: false, + }, + ); + emval_handles.reserved = emval_handles.allocated.length; + Module["count_emval_handles"] = count_emval_handles; + }; + + var Emval = { + toValue: (handle) => { + if (!handle) { + throwBindingError("Cannot use deleted val. handle = " + handle); + } + return emval_handles.get(handle).value; + }, + toHandle: (value) => { + switch (value) { + case undefined: + return 1; + + case null: + return 2; + + case true: + return 3; + + case false: + return 4; + + default: { + return emval_handles.allocate({ + refcount: 1, + value: value, + }); + } + } + }, + }; + + /** @suppress {globalThis} */ function simpleReadValueFromPointer(pointer) { + return this["fromWireType"](GROWABLE_HEAP_I32()[(pointer >>> 2) >>> 0]); + } + + var __embind_register_emval = function (rawType, name) { + rawType >>>= 0; + name >>>= 0; + name = readLatin1String(name); + registerType(rawType, { + name: name, + fromWireType: (handle) => { + var rv = Emval.toValue(handle); + __emval_decref(handle); + return rv; + }, + toWireType: (destructors, value) => Emval.toHandle(value), + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: simpleReadValueFromPointer, + destructorFunction: null, + }); + }; + + var enumReadValueFromPointer = (name, width, signed) => { + switch (width) { + case 1: + return signed + ? function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_I8()[(pointer >>> 0) >>> 0], + ); + } + : function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_U8()[(pointer >>> 0) >>> 0], + ); + }; + + case 2: + return signed + ? function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_I16()[(pointer >>> 1) >>> 0], + ); + } + : function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_U16()[(pointer >>> 1) >>> 0], + ); + }; + + case 4: + return signed + ? function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_I32()[(pointer >>> 2) >>> 0], + ); + } + : function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_U32()[(pointer >>> 2) >>> 0], + ); + }; + + default: + throw new TypeError(`invalid integer width (${width}): ${name}`); + } + }; + + /** @suppress {globalThis} */ function __embind_register_enum( + rawType, + name, + size, + isSigned, + ) { + rawType >>>= 0; + name >>>= 0; + size >>>= 0; + name = readLatin1String(name); + function ctor() {} + ctor.values = {}; + registerType(rawType, { + name: name, + constructor: ctor, + fromWireType: function (c) { + return this.constructor.values[c]; + }, + toWireType: (destructors, c) => c.value, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: enumReadValueFromPointer(name, size, isSigned), + destructorFunction: null, + }); + exposePublicSymbol(name, ctor); + } + + var requireRegisteredType = (rawType, humanName) => { + var impl = registeredTypes[rawType]; + if (undefined === impl) { + throwBindingError( + humanName + " has unknown type " + getTypeName(rawType), + ); + } + return impl; + }; + + function __embind_register_enum_value(rawEnumType, name, enumValue) { + rawEnumType >>>= 0; + name >>>= 0; + enumValue >>>= 0; + var enumType = requireRegisteredType(rawEnumType, "enum"); + name = readLatin1String(name); + var Enum = enumType.constructor; + var Value = Object.create(enumType.constructor.prototype, { + value: { + value: enumValue, + }, + constructor: { + value: createNamedFunction( + `${enumType.name}_${name}`, + function () {}, + ), + }, + }); + Enum.values[enumValue] = Value; + Enum[name] = Value; + } + + var embindRepr = (v) => { + if (v === null) { + return "null"; + } + var t = typeof v; + if (t === "object" || t === "array" || t === "function") { + return v.toString(); + } else { + return "" + v; + } + }; + + var floatReadValueFromPointer = (name, width) => { + switch (width) { + case 4: + return function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_F32()[(pointer >>> 2) >>> 0], + ); + }; + + case 8: + return function (pointer) { + return this["fromWireType"]( + GROWABLE_HEAP_F64()[(pointer >>> 3) >>> 0], + ); + }; + + default: + throw new TypeError(`invalid float width (${width}): ${name}`); + } + }; + + var __embind_register_float = function (rawType, name, size) { + rawType >>>= 0; + name >>>= 0; + size >>>= 0; + name = readLatin1String(name); + registerType(rawType, { + name: name, + fromWireType: (value) => value, + toWireType: (destructors, value) => value, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: floatReadValueFromPointer(name, size), + destructorFunction: null, + }); + }; + + function __embind_register_function( + name, + argCount, + rawArgTypesAddr, + signature, + rawInvoker, + fn, + isAsync, + ) { + name >>>= 0; + rawArgTypesAddr >>>= 0; + signature >>>= 0; + rawInvoker >>>= 0; + fn >>>= 0; + var argTypes = heap32VectorToArray(argCount, rawArgTypesAddr); + name = readLatin1String(name); + name = getFunctionName(name); + rawInvoker = embind__requireFunction(signature, rawInvoker); + exposePublicSymbol( + name, + function () { + throwUnboundTypeError( + `Cannot call ${name} due to unbound types`, + argTypes, + ); + }, + argCount - 1, + ); + whenDependentTypesAreResolved([], argTypes, function (argTypes) { + var invokerArgsArray = [argTypes[0], /* return value */ null].concat( + /* no class 'this'*/ argTypes.slice(1), + ); + /* actual params */ replacePublicSymbol( + name, + craftInvokerFunction( + name, + invokerArgsArray, + null, + /* no class 'this'*/ rawInvoker, + fn, + isAsync, + ), + argCount - 1, + ); + return []; + }); + } + + var integerReadValueFromPointer = (name, width, signed) => { + switch (width) { + case 1: + return signed + ? (pointer) => GROWABLE_HEAP_I8()[(pointer >>> 0) >>> 0] + : (pointer) => GROWABLE_HEAP_U8()[(pointer >>> 0) >>> 0]; + + case 2: + return signed + ? (pointer) => GROWABLE_HEAP_I16()[(pointer >>> 1) >>> 0] + : (pointer) => GROWABLE_HEAP_U16()[(pointer >>> 1) >>> 0]; + + case 4: + return signed + ? (pointer) => GROWABLE_HEAP_I32()[(pointer >>> 2) >>> 0] + : (pointer) => GROWABLE_HEAP_U32()[(pointer >>> 2) >>> 0]; + + default: + throw new TypeError(`invalid integer width (${width}): ${name}`); + } + }; + + /** @suppress {globalThis} */ function __embind_register_integer( + primitiveType, + name, + size, + minRange, + maxRange, + ) { + primitiveType >>>= 0; + name >>>= 0; + size >>>= 0; + name = readLatin1String(name); + if (maxRange === -1) { + maxRange = 4294967295; + } + var fromWireType = (value) => value; + if (minRange === 0) { + var bitshift = 32 - 8 * size; + fromWireType = (value) => (value << bitshift) >>> bitshift; + } + var isUnsignedType = name.includes("unsigned"); + var checkAssertions = (value, toTypeName) => {}; + var toWireType; + if (isUnsignedType) { + toWireType = function (destructors, value) { + checkAssertions(value, this.name); + return value >>> 0; + }; + } else { + toWireType = function (destructors, value) { + checkAssertions(value, this.name); + return value; + }; + } + registerType(primitiveType, { + name: name, + fromWireType: fromWireType, + toWireType: toWireType, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: integerReadValueFromPointer( + name, + size, + minRange !== 0, + ), + destructorFunction: null, + }); + } + + function __embind_register_memory_view(rawType, dataTypeIndex, name) { + rawType >>>= 0; + name >>>= 0; + var typeMapping = [ + Int8Array, + Uint8Array, + Int16Array, + Uint16Array, + Int32Array, + Uint32Array, + Float32Array, + Float64Array, + ]; + var TA = typeMapping[dataTypeIndex]; + function decodeMemoryView(handle) { + var size = GROWABLE_HEAP_U32()[(handle >>> 2) >>> 0]; + var data = GROWABLE_HEAP_U32()[((handle + 4) >>> 2) >>> 0]; + return new TA(GROWABLE_HEAP_I8().buffer, data, size); + } + name = readLatin1String(name); + registerType( + rawType, + { + name: name, + fromWireType: decodeMemoryView, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: decodeMemoryView, + }, + { + ignoreDuplicateRegistrations: true, + }, + ); + } + + function __embind_register_smart_ptr( + rawType, + rawPointeeType, + name, + sharingPolicy, + getPointeeSignature, + rawGetPointee, + constructorSignature, + rawConstructor, + shareSignature, + rawShare, + destructorSignature, + rawDestructor, + ) { + rawType >>>= 0; + rawPointeeType >>>= 0; + name >>>= 0; + getPointeeSignature >>>= 0; + rawGetPointee >>>= 0; + constructorSignature >>>= 0; + rawConstructor >>>= 0; + shareSignature >>>= 0; + rawShare >>>= 0; + destructorSignature >>>= 0; + rawDestructor >>>= 0; + name = readLatin1String(name); + rawGetPointee = embind__requireFunction( + getPointeeSignature, + rawGetPointee, + ); + rawConstructor = embind__requireFunction( + constructorSignature, + rawConstructor, + ); + rawShare = embind__requireFunction(shareSignature, rawShare); + rawDestructor = embind__requireFunction( + destructorSignature, + rawDestructor, + ); + whenDependentTypesAreResolved( + [rawType], + [rawPointeeType], + function (pointeeType) { + pointeeType = pointeeType[0]; + var registeredPointer = new RegisteredPointer( + name, + pointeeType.registeredClass, + false, + false, + true, + pointeeType, + sharingPolicy, + rawGetPointee, + rawConstructor, + rawShare, + rawDestructor, + ); + return [registeredPointer]; + }, + ); + } + + function __embind_register_std_string(rawType, name) { + rawType >>>= 0; + name >>>= 0; + name = readLatin1String(name); + var stdStringIsUTF8 = name === "std::string"; + registerType(rawType, { + name: name, + fromWireType(value) { + var length = GROWABLE_HEAP_U32()[(value >>> 2) >>> 0]; + var payload = value + 4; + var str; + if (stdStringIsUTF8) { + var decodeStartPtr = payload; + for (var i = 0; i <= length; ++i) { + var currentBytePtr = payload + i; + if ( + i == length || + GROWABLE_HEAP_U8()[currentBytePtr >>> 0] == 0 + ) { + var maxRead = currentBytePtr - decodeStartPtr; + var stringSegment = UTF8ToString(decodeStartPtr, maxRead); + if (str === undefined) { + str = stringSegment; + } else { + str += String.fromCharCode(0); + str += stringSegment; + } + decodeStartPtr = currentBytePtr + 1; + } + } + } else { + var a = new Array(length); + for (var i = 0; i < length; ++i) { + a[i] = String.fromCharCode( + GROWABLE_HEAP_U8()[(payload + i) >>> 0], + ); + } + str = a.join(""); + } + _free(value); + return str; + }, + toWireType(destructors, value) { + if (value instanceof ArrayBuffer) { + value = new Uint8Array(value); + } + var length; + var valueIsOfTypeString = typeof value == "string"; + if ( + !( + valueIsOfTypeString || + value instanceof Uint8Array || + value instanceof Uint8ClampedArray || + value instanceof Int8Array + ) + ) { + throwBindingError("Cannot pass non-string to std::string"); + } + if (stdStringIsUTF8 && valueIsOfTypeString) { + length = lengthBytesUTF8(value); + } else { + length = value.length; + } + var base = _malloc(4 + length + 1); + var ptr = base + 4; + GROWABLE_HEAP_U32()[(base >>> 2) >>> 0] = length; + if (stdStringIsUTF8 && valueIsOfTypeString) { + stringToUTF8(value, ptr, length + 1); + } else { + if (valueIsOfTypeString) { + for (var i = 0; i < length; ++i) { + var charCode = value.charCodeAt(i); + if (charCode > 255) { + _free(ptr); + throwBindingError( + "String has UTF-16 code units that do not fit in 8 bits", + ); + } + GROWABLE_HEAP_U8()[(ptr + i) >>> 0] = charCode; + } + } else { + for (var i = 0; i < length; ++i) { + GROWABLE_HEAP_U8()[(ptr + i) >>> 0] = value[i]; + } + } + } + if (destructors !== null) { + destructors.push(_free, base); + } + return base; + }, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: readPointer, + destructorFunction(ptr) { + _free(ptr); + }, + }); + } + + var UTF16Decoder = + typeof TextDecoder != "undefined" + ? new TextDecoder("utf-16le") + : undefined; + + var UTF16ToString = (ptr, maxBytesToRead) => { + var endPtr = ptr; + var idx = endPtr >> 1; + var maxIdx = idx + maxBytesToRead / 2; + while (!(idx >= maxIdx) && GROWABLE_HEAP_U16()[idx >>> 0]) ++idx; + endPtr = idx << 1; + if (endPtr - ptr > 32 && UTF16Decoder) + return UTF16Decoder.decode(GROWABLE_HEAP_U8().slice(ptr, endPtr)); + var str = ""; + for (var i = 0; !(i >= maxBytesToRead / 2); ++i) { + var codeUnit = GROWABLE_HEAP_I16()[((ptr + i * 2) >>> 1) >>> 0]; + if (codeUnit == 0) break; + str += String.fromCharCode(codeUnit); + } + return str; + }; + + var stringToUTF16 = (str, outPtr, maxBytesToWrite) => { + if (maxBytesToWrite === undefined) { + maxBytesToWrite = 2147483647; + } + if (maxBytesToWrite < 2) return 0; + maxBytesToWrite -= 2; + var startPtr = outPtr; + var numCharsToWrite = + maxBytesToWrite < str.length * 2 ? maxBytesToWrite / 2 : str.length; + for (var i = 0; i < numCharsToWrite; ++i) { + var codeUnit = str.charCodeAt(i); + GROWABLE_HEAP_I16()[(outPtr >>> 1) >>> 0] = codeUnit; + outPtr += 2; + } + GROWABLE_HEAP_I16()[(outPtr >>> 1) >>> 0] = 0; + return outPtr - startPtr; + }; + + var lengthBytesUTF16 = (str) => str.length * 2; + + var UTF32ToString = (ptr, maxBytesToRead) => { + var i = 0; + var str = ""; + while (!(i >= maxBytesToRead / 4)) { + var utf32 = GROWABLE_HEAP_I32()[((ptr + i * 4) >>> 2) >>> 0]; + if (utf32 == 0) break; + ++i; + if (utf32 >= 65536) { + var ch = utf32 - 65536; + str += String.fromCharCode(55296 | (ch >> 10), 56320 | (ch & 1023)); + } else { + str += String.fromCharCode(utf32); + } + } + return str; + }; + + var stringToUTF32 = (str, outPtr, maxBytesToWrite) => { + outPtr >>>= 0; + if (maxBytesToWrite === undefined) { + maxBytesToWrite = 2147483647; + } + if (maxBytesToWrite < 4) return 0; + var startPtr = outPtr; + var endPtr = startPtr + maxBytesToWrite - 4; + for (var i = 0; i < str.length; ++i) { + var codeUnit = str.charCodeAt(i); + if (codeUnit >= 55296 && codeUnit <= 57343) { + var trailSurrogate = str.charCodeAt(++i); + codeUnit = + (65536 + ((codeUnit & 1023) << 10)) | (trailSurrogate & 1023); + } + GROWABLE_HEAP_I32()[(outPtr >>> 2) >>> 0] = codeUnit; + outPtr += 4; + if (outPtr + 4 > endPtr) break; + } + GROWABLE_HEAP_I32()[(outPtr >>> 2) >>> 0] = 0; + return outPtr - startPtr; + }; + + var lengthBytesUTF32 = (str) => { + var len = 0; + for (var i = 0; i < str.length; ++i) { + var codeUnit = str.charCodeAt(i); + if (codeUnit >= 55296 && codeUnit <= 57343) ++i; + len += 4; + } + return len; + }; + + var __embind_register_std_wstring = function (rawType, charSize, name) { + rawType >>>= 0; + charSize >>>= 0; + name >>>= 0; + name = readLatin1String(name); + var decodeString, encodeString, getHeap, lengthBytesUTF, shift; + if (charSize === 2) { + decodeString = UTF16ToString; + encodeString = stringToUTF16; + lengthBytesUTF = lengthBytesUTF16; + getHeap = () => GROWABLE_HEAP_U16(); + shift = 1; + } else if (charSize === 4) { + decodeString = UTF32ToString; + encodeString = stringToUTF32; + lengthBytesUTF = lengthBytesUTF32; + getHeap = () => GROWABLE_HEAP_U32(); + shift = 2; + } + registerType(rawType, { + name: name, + fromWireType: (value) => { + var length = GROWABLE_HEAP_U32()[(value >>> 2) >>> 0]; + var HEAP = getHeap(); + var str; + var decodeStartPtr = value + 4; + for (var i = 0; i <= length; ++i) { + var currentBytePtr = value + 4 + i * charSize; + if (i == length || HEAP[currentBytePtr >>> shift] == 0) { + var maxReadBytes = currentBytePtr - decodeStartPtr; + var stringSegment = decodeString(decodeStartPtr, maxReadBytes); + if (str === undefined) { + str = stringSegment; + } else { + str += String.fromCharCode(0); + str += stringSegment; + } + decodeStartPtr = currentBytePtr + charSize; + } + } + _free(value); + return str; + }, + toWireType: (destructors, value) => { + if (!(typeof value == "string")) { + throwBindingError( + `Cannot pass non-string to C++ string type ${name}`, + ); + } + var length = lengthBytesUTF(value); + var ptr = _malloc(4 + length + charSize); + GROWABLE_HEAP_U32()[ptr >>> 2] = length >> shift; + encodeString(value, ptr + 4, length + charSize); + if (destructors !== null) { + destructors.push(_free, ptr); + } + return ptr; + }, + argPackAdvance: GenericWireTypeSize, + readValueFromPointer: simpleReadValueFromPointer, + destructorFunction(ptr) { + _free(ptr); + }, + }); + }; + + var __embind_register_void = function (rawType, name) { + rawType >>>= 0; + name >>>= 0; + name = readLatin1String(name); + registerType(rawType, { + isVoid: true, + name: name, + argPackAdvance: 0, + fromWireType: () => undefined, + toWireType: (destructors, o) => undefined, + }); + }; + + var nowIsMonotonic = true; + + var __emscripten_get_now_is_monotonic = () => nowIsMonotonic; + + function __emscripten_thread_mailbox_await(pthread_ptr) { + pthread_ptr >>>= 0; + if (typeof Atomics.waitAsync === "function") { + var wait = Atomics.waitAsync( + GROWABLE_HEAP_I32(), + pthread_ptr >>> 2, + pthread_ptr, + ); + wait.value.then(checkMailbox); + var waitingAsync = pthread_ptr + 128; + Atomics.store(GROWABLE_HEAP_I32(), waitingAsync >>> 2, 1); + } + } + + Module["__emscripten_thread_mailbox_await"] = + __emscripten_thread_mailbox_await; + + var checkMailbox = () => { + var pthread_ptr = _pthread_self(); + if (pthread_ptr) { + __emscripten_thread_mailbox_await(pthread_ptr); + callUserCallback(() => __emscripten_check_mailbox()); + } + }; + + Module["checkMailbox"] = checkMailbox; + + var __emscripten_notify_mailbox_postmessage = function ( + targetThreadId, + currThreadId, + mainThreadId, + ) { + targetThreadId >>>= 0; + currThreadId >>>= 0; + mainThreadId >>>= 0; + if (targetThreadId == currThreadId) { + setTimeout(() => checkMailbox()); + } else if (ENVIRONMENT_IS_PTHREAD) { + postMessage({ + targetThread: targetThreadId, + cmd: "checkMailbox", + }); + } else { + var worker = PThread.pthreads[targetThreadId]; + if (!worker) { + return; + } + worker.postMessage({ + cmd: "checkMailbox", + }); + } + }; + + var withStackSave = (f) => { + var stack = stackSave(); + var ret = f(); + stackRestore(stack); + return ret; + }; + + /** @type{function(number, (number|boolean), ...(number|boolean))} */ var proxyToMainThread = + function (index, sync) { + var numCallArgs = arguments.length - 2; + var outerArgs = arguments; + return withStackSave(() => { + var serializedNumCallArgs = numCallArgs; + var args = stackAlloc(serializedNumCallArgs * 8); + var b = args >>> 3; + for (var i = 0; i < numCallArgs; i++) { + var arg = outerArgs[2 + i]; + GROWABLE_HEAP_F64()[(b + i) >>> 0] = arg; + } + return __emscripten_run_on_main_thread_js( + index, + serializedNumCallArgs, + args, + sync, + ); + }); + }; + + var proxiedJSCallArgs = []; + + function __emscripten_receive_on_main_thread_js( + index, + callingThread, + numCallArgs, + args, + ) { + callingThread >>>= 0; + args >>>= 0; + proxiedJSCallArgs.length = numCallArgs; + var b = args >>> 3; + for (var i = 0; i < numCallArgs; i++) { + proxiedJSCallArgs[i] = GROWABLE_HEAP_F64()[(b + i) >>> 0]; + } + var func = proxiedFunctionTable[index]; + PThread.currentProxiedOperationCallerThread = callingThread; + var rtn = func.apply(null, proxiedJSCallArgs); + PThread.currentProxiedOperationCallerThread = 0; + return rtn; + } + + function __emscripten_runtime_keepalive_clear() { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(20, 1); + noExitRuntime = false; + runtimeKeepaliveCounter = 0; + } + + function __emscripten_thread_set_strongref(thread) { + thread >>>= 0; + if (ENVIRONMENT_IS_NODE) { + PThread.pthreads[thread].ref(); + } + } + + function __emval_as(handle, returnType, destructorsRef) { + handle >>>= 0; + returnType >>>= 0; + destructorsRef >>>= 0; + handle = Emval.toValue(handle); + returnType = requireRegisteredType(returnType, "emval::as"); + var destructors = []; + var rd = Emval.toHandle(destructors); + GROWABLE_HEAP_U32()[(destructorsRef >>> 2) >>> 0] = rd; + return returnType["toWireType"](destructors, handle); + } + + function __emval_as_int64(handle, returnType) { + handle >>>= 0; + returnType >>>= 0; + handle = Emval.toValue(handle); + returnType = requireRegisteredType(returnType, "emval::as"); + return returnType["toWireType"](null, handle); + } + + function __emval_as_uint64(handle, returnType) { + handle >>>= 0; + returnType >>>= 0; + handle = Emval.toValue(handle); + returnType = requireRegisteredType(returnType, "emval::as"); + return returnType["toWireType"](null, handle); + } + + var emval_lookupTypes = (argCount, argTypes) => { + var a = new Array(argCount); + for (var i = 0; i < argCount; ++i) { + a[i] = requireRegisteredType( + GROWABLE_HEAP_U32()[((argTypes + i * 4) >>> 2) >>> 0], + "parameter " + i, + ); + } + return a; + }; + + function __emval_call(handle, argCount, argTypes, argv) { + handle >>>= 0; + argTypes >>>= 0; + argv >>>= 0; + handle = Emval.toValue(handle); + var types = emval_lookupTypes(argCount, argTypes); + var args = new Array(argCount); + for (var i = 0; i < argCount; ++i) { + var type = types[i]; + args[i] = type["readValueFromPointer"](argv); + argv += type["argPackAdvance"]; + } + var rv = handle.apply(undefined, args); + return Emval.toHandle(rv); + } + + var emval_symbols = {}; + + var getStringOrSymbol = (address) => { + var symbol = emval_symbols[address]; + if (symbol === undefined) { + return readLatin1String(address); + } + return symbol; + }; + + var emval_methodCallers = []; + + function __emval_call_method( + caller, + handle, + methodName, + destructorsRef, + args, + ) { + caller >>>= 0; + handle >>>= 0; + methodName >>>= 0; + destructorsRef >>>= 0; + args >>>= 0; + caller = emval_methodCallers[caller]; + handle = Emval.toValue(handle); + methodName = getStringOrSymbol(methodName); + var destructors = []; + var result = caller(handle, methodName, destructors, args); + if (destructors.length) { + GROWABLE_HEAP_U32()[(destructorsRef >>> 2) >>> 0] = + Emval.toHandle(destructors); + } + return result; + } + + function __emval_equals(first, second) { + first >>>= 0; + second >>>= 0; + first = Emval.toValue(first); + second = Emval.toValue(second); + return first == second; + } + + var emval_get_global = () => { + if (typeof globalThis == "object") { + return globalThis; + } + return (function () { + return Function; + })()("return this")(); + }; + + function __emval_get_global(name) { + name >>>= 0; + if (name === 0) { + return Emval.toHandle(emval_get_global()); + } else { + name = getStringOrSymbol(name); + return Emval.toHandle(emval_get_global()[name]); + } + } + + var emval_addMethodCaller = (caller) => { + var id = emval_methodCallers.length; + emval_methodCallers.push(caller); + return id; + }; + + function __emval_get_method_caller(argCount, argTypes) { + argTypes >>>= 0; + var types = emval_lookupTypes(argCount, argTypes); + var retType = types.shift(); + argCount--; + var params = ["retType"]; + var args = [retType]; + var argsList = ""; + for (var i = 0; i < argCount; ++i) { + argsList += (i !== 0 ? ", " : "") + "arg" + i; + params.push("argType" + i); + args.push(types[i]); + } + var signatureName = + retType.name + "_$" + types.map((t) => t.name).join("_") + "$"; + var functionName = makeLegalFunctionName("methodCaller_" + signatureName); + var functionBody = + "return function " + + functionName + + "(handle, name, destructors, args) {\n"; + var offset = 0; + for (var i = 0; i < argCount; ++i) { + functionBody += + " var arg" + + i + + " = argType" + + i + + ".readValueFromPointer(args" + + (offset ? "+" + offset : "") + + ");\n"; + offset += types[i]["argPackAdvance"]; + } + functionBody += " var rv = handle[name](" + argsList + ");\n"; + for (var i = 0; i < argCount; ++i) { + if (types[i]["deleteObject"]) { + functionBody += " argType" + i + ".deleteObject(arg" + i + ");\n"; + } + } + if (!retType.isVoid) { + functionBody += " return retType.toWireType(destructors, rv);\n"; + } + functionBody += "};\n"; + params.push(functionBody); + var invokerFunction = newFunc(Function, params).apply(null, args); + return emval_addMethodCaller(invokerFunction); + } + + function __emval_get_property(handle, key) { + handle >>>= 0; + key >>>= 0; + handle = Emval.toValue(handle); + key = Emval.toValue(key); + return Emval.toHandle(handle[key]); + } + + function __emval_incref(handle) { + handle >>>= 0; + if (handle > 4) { + emval_handles.get(handle).refcount += 1; + } + } + + function __emval_instanceof(object, constructor) { + object >>>= 0; + constructor >>>= 0; + object = Emval.toValue(object); + constructor = Emval.toValue(constructor); + return object instanceof constructor; + } + + function __emval_new_array() { + return Emval.toHandle([]); + } + + function __emval_new_cstring(v) { + v >>>= 0; + return Emval.toHandle(getStringOrSymbol(v)); + } + + function __emval_new_object() { + return Emval.toHandle({}); + } + + function __emval_run_destructors(handle) { + handle >>>= 0; + var destructors = Emval.toValue(handle); + runDestructors(destructors); + __emval_decref(handle); + } + + function __emval_set_property(handle, key, value) { + handle >>>= 0; + key >>>= 0; + value >>>= 0; + handle = Emval.toValue(handle); + key = Emval.toValue(key); + value = Emval.toValue(value); + handle[key] = value; + } + + function __emval_take_value(type, arg) { + type >>>= 0; + arg >>>= 0; + type = requireRegisteredType(type, "_emval_take_value"); + var v = type["readValueFromPointer"](arg); + return Emval.toHandle(v); + } + + function __emval_typeof(handle) { + handle >>>= 0; + handle = Emval.toValue(handle); + return Emval.toHandle(typeof handle); + } + + function __mmap_js( + len, + prot, + flags, + fd, + offset_low, + offset_high, + allocated, + addr, + ) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread( + 21, + 1, + len, + prot, + flags, + fd, + offset_low, + offset_high, + allocated, + addr, + ); + len >>>= 0; + var offset = convertI32PairToI53Checked(offset_low, offset_high); + allocated >>>= 0; + addr >>>= 0; + try { + if (isNaN(offset)) return 61; + var stream = SYSCALLS.getStreamFromFD(fd); + var res = FS.mmap(stream, len, offset, prot, flags); + var ptr = res.ptr; + GROWABLE_HEAP_I32()[(allocated >>> 2) >>> 0] = res.allocated; + GROWABLE_HEAP_U32()[(addr >>> 2) >>> 0] = ptr; + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + function __munmap_js(addr, len, prot, flags, fd, offset_low, offset_high) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread( + 22, + 1, + addr, + len, + prot, + flags, + fd, + offset_low, + offset_high, + ); + addr >>>= 0; + len >>>= 0; + var offset = convertI32PairToI53Checked(offset_low, offset_high); + try { + if (isNaN(offset)) return 61; + var stream = SYSCALLS.getStreamFromFD(fd); + if (prot & 2) { + SYSCALLS.doMsync(addr, stream, len, flags, offset); + } + FS.munmap(stream); + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return -e.errno; + } + } + + var timers = {}; + + var _emscripten_get_now; + + _emscripten_get_now = () => performance.timeOrigin + performance.now(); + + function __setitimer_js(which, timeout_ms) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(23, 1, which, timeout_ms); + if (timers[which]) { + clearTimeout(timers[which].id); + delete timers[which]; + } + if (!timeout_ms) return 0; + var id = setTimeout(() => { + delete timers[which]; + callUserCallback(() => + __emscripten_timeout(which, _emscripten_get_now()), + ); + }, timeout_ms); + timers[which] = { + id: id, + timeout_ms: timeout_ms, + }; + return 0; + } + + var _abort = () => { + abort(""); + }; + + var warnOnce = (text) => { + if (!warnOnce.shown) warnOnce.shown = {}; + if (!warnOnce.shown[text]) { + warnOnce.shown[text] = 1; + if (ENVIRONMENT_IS_NODE) text = "warning: " + text; + err(text); + } + }; + + var _emscripten_check_blocking_allowed = () => {}; + + var _emscripten_date_now = () => Date.now(); + + var _emscripten_exit_with_live_runtime = () => { + runtimeKeepalivePush(); + throw "unwind"; + }; + + function _emscripten_force_exit(status) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(24, 1, status); + __emscripten_runtime_keepalive_clear(); + _exit(status); + } + + var getHeapMax = () => 4294901760; + + function _emscripten_get_heap_max() { + return getHeapMax(); + } + + var _emscripten_num_logical_cores = () => { + if (ENVIRONMENT_IS_NODE) return require("os").cpus().length; + return navigator["hardwareConcurrency"]; + }; + + var growMemory = (size) => { + var b = wasmMemory.buffer; + var pages = (size - b.byteLength + 65535) / 65536; + try { + wasmMemory.grow(pages); + updateMemoryViews(); + return 1; + } /*success*/ catch (e) {} + }; + + function _emscripten_resize_heap(requestedSize) { + requestedSize >>>= 0; + var oldSize = GROWABLE_HEAP_U8().length; + if (requestedSize <= oldSize) { + return false; + } + var maxHeapSize = getHeapMax(); + if (requestedSize > maxHeapSize) { + return false; + } + var alignUp = (x, multiple) => + x + ((multiple - (x % multiple)) % multiple); + for (var cutDown = 1; cutDown <= 4; cutDown *= 2) { + var overGrownHeapSize = oldSize * (1 + 0.2 / cutDown); + overGrownHeapSize = Math.min( + overGrownHeapSize, + requestedSize + 100663296, + ); + var newSize = Math.min( + maxHeapSize, + alignUp(Math.max(requestedSize, overGrownHeapSize), 65536), + ); + var replacement = growMemory(newSize); + if (replacement) { + return true; + } + } + return false; + } + + var ENV = {}; + + var getExecutableName = () => thisProgram || "./this.program"; + + var getEnvStrings = () => { + if (!getEnvStrings.strings) { + var lang = + ( + (typeof navigator == "object" && + navigator.languages && + navigator.languages[0]) || + "C" + ).replace("-", "_") + ".UTF-8"; + var env = { + USER: "web_user", + LOGNAME: "web_user", + PATH: "/", + PWD: "/", + HOME: "/home/web_user", + LANG: lang, + _: getExecutableName(), + }; + for (var x in ENV) { + if (ENV[x] === undefined) delete env[x]; + else env[x] = ENV[x]; + } + var strings = []; + for (var x in env) { + strings.push(`${x}=${env[x]}`); + } + getEnvStrings.strings = strings; + } + return getEnvStrings.strings; + }; + + var stringToAscii = (str, buffer) => { + for (var i = 0; i < str.length; ++i) { + GROWABLE_HEAP_I8()[(buffer++ >>> 0) >>> 0] = str.charCodeAt(i); + } + GROWABLE_HEAP_I8()[(buffer >>> 0) >>> 0] = 0; + }; + + var _environ_get = function (__environ, environ_buf) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(25, 1, __environ, environ_buf); + __environ >>>= 0; + environ_buf >>>= 0; + var bufSize = 0; + getEnvStrings().forEach((string, i) => { + var ptr = environ_buf + bufSize; + GROWABLE_HEAP_U32()[((__environ + i * 4) >>> 2) >>> 0] = ptr; + stringToAscii(string, ptr); + bufSize += string.length + 1; + }); + return 0; + }; + + var _environ_sizes_get = function (penviron_count, penviron_buf_size) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(26, 1, penviron_count, penviron_buf_size); + penviron_count >>>= 0; + penviron_buf_size >>>= 0; + var strings = getEnvStrings(); + GROWABLE_HEAP_U32()[(penviron_count >>> 2) >>> 0] = strings.length; + var bufSize = 0; + strings.forEach((string) => (bufSize += string.length + 1)); + GROWABLE_HEAP_U32()[(penviron_buf_size >>> 2) >>> 0] = bufSize; + return 0; + }; + + function _fd_close(fd) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(27, 1, fd); + try { + var stream = SYSCALLS.getStreamFromFD(fd); + FS.close(stream); + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + function _fd_fdstat_get(fd, pbuf) { + if (ENVIRONMENT_IS_PTHREAD) return proxyToMainThread(28, 1, fd, pbuf); + pbuf >>>= 0; + try { + var rightsBase = 0; + var rightsInheriting = 0; + var flags = 0; + { + var stream = SYSCALLS.getStreamFromFD(fd); + var type = stream.tty + ? 2 + : FS.isDir(stream.mode) + ? 3 + : FS.isLink(stream.mode) + ? 7 + : 4; + } + GROWABLE_HEAP_I8()[(pbuf >>> 0) >>> 0] = type; + GROWABLE_HEAP_I16()[((pbuf + 2) >>> 1) >>> 0] = flags; + (tempI64 = [ + rightsBase >>> 0, + ((tempDouble = rightsBase), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((pbuf + 8) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((pbuf + 12) >>> 2) >>> 0] = tempI64[1]); + (tempI64 = [ + rightsInheriting >>> 0, + ((tempDouble = rightsInheriting), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[((pbuf + 16) >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((pbuf + 20) >>> 2) >>> 0] = tempI64[1]); + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + /** @param {number=} offset */ var doReadv = ( + stream, + iov, + iovcnt, + offset, + ) => { + var ret = 0; + for (var i = 0; i < iovcnt; i++) { + var ptr = GROWABLE_HEAP_U32()[(iov >>> 2) >>> 0]; + var len = GROWABLE_HEAP_U32()[((iov + 4) >>> 2) >>> 0]; + iov += 8; + var curr = FS.read(stream, GROWABLE_HEAP_I8(), ptr, len, offset); + if (curr < 0) return -1; + ret += curr; + if (curr < len) break; + if (typeof offset !== "undefined") { + offset += curr; + } + } + return ret; + }; + + function _fd_pread(fd, iov, iovcnt, offset_low, offset_high, pnum) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread( + 29, + 1, + fd, + iov, + iovcnt, + offset_low, + offset_high, + pnum, + ); + iov >>>= 0; + iovcnt >>>= 0; + var offset = convertI32PairToI53Checked(offset_low, offset_high); + pnum >>>= 0; + try { + if (isNaN(offset)) return 61; + var stream = SYSCALLS.getStreamFromFD(fd); + var num = doReadv(stream, iov, iovcnt, offset); + GROWABLE_HEAP_U32()[(pnum >>> 2) >>> 0] = num; + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + /** @param {number=} offset */ var doWritev = ( + stream, + iov, + iovcnt, + offset, + ) => { + var ret = 0; + for (var i = 0; i < iovcnt; i++) { + var ptr = GROWABLE_HEAP_U32()[(iov >>> 2) >>> 0]; + var len = GROWABLE_HEAP_U32()[((iov + 4) >>> 2) >>> 0]; + iov += 8; + var curr = FS.write(stream, GROWABLE_HEAP_I8(), ptr, len, offset); + if (curr < 0) return -1; + ret += curr; + if (typeof offset !== "undefined") { + offset += curr; + } + } + return ret; + }; + + function _fd_pwrite(fd, iov, iovcnt, offset_low, offset_high, pnum) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread( + 30, + 1, + fd, + iov, + iovcnt, + offset_low, + offset_high, + pnum, + ); + iov >>>= 0; + iovcnt >>>= 0; + var offset = convertI32PairToI53Checked(offset_low, offset_high); + pnum >>>= 0; + try { + if (isNaN(offset)) return 61; + var stream = SYSCALLS.getStreamFromFD(fd); + var num = doWritev(stream, iov, iovcnt, offset); + GROWABLE_HEAP_U32()[(pnum >>> 2) >>> 0] = num; + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + function _fd_read(fd, iov, iovcnt, pnum) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(31, 1, fd, iov, iovcnt, pnum); + iov >>>= 0; + iovcnt >>>= 0; + pnum >>>= 0; + try { + var stream = SYSCALLS.getStreamFromFD(fd); + var num = doReadv(stream, iov, iovcnt); + GROWABLE_HEAP_U32()[(pnum >>> 2) >>> 0] = num; + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + function _fd_seek(fd, offset_low, offset_high, whence, newOffset) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread( + 32, + 1, + fd, + offset_low, + offset_high, + whence, + newOffset, + ); + var offset = convertI32PairToI53Checked(offset_low, offset_high); + newOffset >>>= 0; + try { + if (isNaN(offset)) return 61; + var stream = SYSCALLS.getStreamFromFD(fd); + FS.llseek(stream, offset, whence); + (tempI64 = [ + stream.position >>> 0, + ((tempDouble = stream.position), + +Math.abs(tempDouble) >= 1 + ? tempDouble > 0 + ? +Math.floor(tempDouble / 4294967296) >>> 0 + : ~~+Math.ceil( + (tempDouble - +(~~tempDouble >>> 0)) / 4294967296, + ) >>> 0 + : 0), + ]), + (GROWABLE_HEAP_I32()[(newOffset >>> 2) >>> 0] = tempI64[0]), + (GROWABLE_HEAP_I32()[((newOffset + 4) >>> 2) >>> 0] = tempI64[1]); + if (stream.getdents && offset === 0 && whence === 0) + stream.getdents = null; + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + function _fd_write(fd, iov, iovcnt, pnum) { + if (ENVIRONMENT_IS_PTHREAD) + return proxyToMainThread(33, 1, fd, iov, iovcnt, pnum); + iov >>>= 0; + iovcnt >>>= 0; + pnum >>>= 0; + try { + var stream = SYSCALLS.getStreamFromFD(fd); + var num = doWritev(stream, iov, iovcnt); + GROWABLE_HEAP_U32()[(pnum >>> 2) >>> 0] = num; + return 0; + } catch (e) { + if (typeof FS == "undefined" || !(e.name === "ErrnoError")) throw e; + return e.errno; + } + } + + function _llvm_eh_typeid_for(type) { + type >>>= 0; + return type; + } + + var isLeapYear = (year) => + year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0); + + var arraySum = (array, index) => { + var sum = 0; + for (var i = 0; i <= index; sum += array[i++]) {} + return sum; + }; + + var MONTH_DAYS_LEAP = [31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; + + var MONTH_DAYS_REGULAR = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]; + + var addDays = (date, days) => { + var newDate = new Date(date.getTime()); + while (days > 0) { + var leap = isLeapYear(newDate.getFullYear()); + var currentMonth = newDate.getMonth(); + var daysInCurrentMonth = (leap ? MONTH_DAYS_LEAP : MONTH_DAYS_REGULAR)[ + currentMonth + ]; + if (days > daysInCurrentMonth - newDate.getDate()) { + days -= daysInCurrentMonth - newDate.getDate() + 1; + newDate.setDate(1); + if (currentMonth < 11) { + newDate.setMonth(currentMonth + 1); + } else { + newDate.setMonth(0); + newDate.setFullYear(newDate.getFullYear() + 1); + } + } else { + newDate.setDate(newDate.getDate() + days); + return newDate; + } + } + return newDate; + }; + + var writeArrayToMemory = (array, buffer) => { + GROWABLE_HEAP_I8().set(array, buffer >>> 0); + }; + + function _strftime(s, maxsize, format, tm) { + s >>>= 0; + maxsize >>>= 0; + format >>>= 0; + tm >>>= 0; + var tm_zone = GROWABLE_HEAP_U32()[((tm + 40) >>> 2) >>> 0]; + var date = { + tm_sec: GROWABLE_HEAP_I32()[(tm >>> 2) >>> 0], + tm_min: GROWABLE_HEAP_I32()[((tm + 4) >>> 2) >>> 0], + tm_hour: GROWABLE_HEAP_I32()[((tm + 8) >>> 2) >>> 0], + tm_mday: GROWABLE_HEAP_I32()[((tm + 12) >>> 2) >>> 0], + tm_mon: GROWABLE_HEAP_I32()[((tm + 16) >>> 2) >>> 0], + tm_year: GROWABLE_HEAP_I32()[((tm + 20) >>> 2) >>> 0], + tm_wday: GROWABLE_HEAP_I32()[((tm + 24) >>> 2) >>> 0], + tm_yday: GROWABLE_HEAP_I32()[((tm + 28) >>> 2) >>> 0], + tm_isdst: GROWABLE_HEAP_I32()[((tm + 32) >>> 2) >>> 0], + tm_gmtoff: GROWABLE_HEAP_I32()[((tm + 36) >>> 2) >>> 0], + tm_zone: tm_zone ? UTF8ToString(tm_zone) : "", + }; + var pattern = UTF8ToString(format); + var EXPANSION_RULES_1 = { + "%c": "%a %b %d %H:%M:%S %Y", + "%D": "%m/%d/%y", + "%F": "%Y-%m-%d", + "%h": "%b", + "%r": "%I:%M:%S %p", + "%R": "%H:%M", + "%T": "%H:%M:%S", + "%x": "%m/%d/%y", + "%X": "%H:%M:%S", + "%Ec": "%c", + "%EC": "%C", + "%Ex": "%m/%d/%y", + "%EX": "%H:%M:%S", + "%Ey": "%y", + "%EY": "%Y", + "%Od": "%d", + "%Oe": "%e", + "%OH": "%H", + "%OI": "%I", + "%Om": "%m", + "%OM": "%M", + "%OS": "%S", + "%Ou": "%u", + "%OU": "%U", + "%OV": "%V", + "%Ow": "%w", + "%OW": "%W", + "%Oy": "%y", + }; + for (var rule in EXPANSION_RULES_1) { + pattern = pattern.replace( + new RegExp(rule, "g"), + EXPANSION_RULES_1[rule], + ); + } + var WEEKDAYS = [ + "Sunday", + "Monday", + "Tuesday", + "Wednesday", + "Thursday", + "Friday", + "Saturday", + ]; + var MONTHS = [ + "January", + "February", + "March", + "April", + "May", + "June", + "July", + "August", + "September", + "October", + "November", + "December", + ]; + function leadingSomething(value, digits, character) { + var str = typeof value == "number" ? value.toString() : value || ""; + while (str.length < digits) { + str = character[0] + str; + } + return str; + } + function leadingNulls(value, digits) { + return leadingSomething(value, digits, "0"); + } + function compareByDay(date1, date2) { + function sgn(value) { + return value < 0 ? -1 : value > 0 ? 1 : 0; + } + var compare; + if ((compare = sgn(date1.getFullYear() - date2.getFullYear())) === 0) { + if ((compare = sgn(date1.getMonth() - date2.getMonth())) === 0) { + compare = sgn(date1.getDate() - date2.getDate()); + } + } + return compare; + } + function getFirstWeekStartDate(janFourth) { + switch (janFourth.getDay()) { + case 0: + return new Date(janFourth.getFullYear() - 1, 11, 29); + + case 1: + return janFourth; + + case 2: + return new Date(janFourth.getFullYear(), 0, 3); + + case 3: + return new Date(janFourth.getFullYear(), 0, 2); + + case 4: + return new Date(janFourth.getFullYear(), 0, 1); + + case 5: + return new Date(janFourth.getFullYear() - 1, 11, 31); + + case 6: + return new Date(janFourth.getFullYear() - 1, 11, 30); + } + } + function getWeekBasedYear(date) { + var thisDate = addDays( + new Date(date.tm_year + 1900, 0, 1), + date.tm_yday, + ); + var janFourthThisYear = new Date(thisDate.getFullYear(), 0, 4); + var janFourthNextYear = new Date(thisDate.getFullYear() + 1, 0, 4); + var firstWeekStartThisYear = getFirstWeekStartDate(janFourthThisYear); + var firstWeekStartNextYear = getFirstWeekStartDate(janFourthNextYear); + if (compareByDay(firstWeekStartThisYear, thisDate) <= 0) { + if (compareByDay(firstWeekStartNextYear, thisDate) <= 0) { + return thisDate.getFullYear() + 1; + } + return thisDate.getFullYear(); + } + return thisDate.getFullYear() - 1; + } + var EXPANSION_RULES_2 = { + "%a": (date) => WEEKDAYS[date.tm_wday].substring(0, 3), + "%A": (date) => WEEKDAYS[date.tm_wday], + "%b": (date) => MONTHS[date.tm_mon].substring(0, 3), + "%B": (date) => MONTHS[date.tm_mon], + "%C": (date) => { + var year = date.tm_year + 1900; + return leadingNulls((year / 100) | 0, 2); + }, + "%d": (date) => leadingNulls(date.tm_mday, 2), + "%e": (date) => leadingSomething(date.tm_mday, 2, " "), + "%g": (date) => getWeekBasedYear(date).toString().substring(2), + "%G": (date) => getWeekBasedYear(date), + "%H": (date) => leadingNulls(date.tm_hour, 2), + "%I": (date) => { + var twelveHour = date.tm_hour; + if (twelveHour == 0) twelveHour = 12; + else if (twelveHour > 12) twelveHour -= 12; + return leadingNulls(twelveHour, 2); + }, + "%j": (date) => + leadingNulls( + date.tm_mday + + arraySum( + isLeapYear(date.tm_year + 1900) + ? MONTH_DAYS_LEAP + : MONTH_DAYS_REGULAR, + date.tm_mon - 1, + ), + 3, + ), + "%m": (date) => leadingNulls(date.tm_mon + 1, 2), + "%M": (date) => leadingNulls(date.tm_min, 2), + "%n": () => "\n", + "%p": (date) => { + if (date.tm_hour >= 0 && date.tm_hour < 12) { + return "AM"; + } + return "PM"; + }, + "%S": (date) => leadingNulls(date.tm_sec, 2), + "%t": () => "\t", + "%u": (date) => date.tm_wday || 7, + "%U": (date) => { + var days = date.tm_yday + 7 - date.tm_wday; + return leadingNulls(Math.floor(days / 7), 2); + }, + "%V": (date) => { + var val = Math.floor( + (date.tm_yday + 7 - ((date.tm_wday + 6) % 7)) / 7, + ); + if ((date.tm_wday + 371 - date.tm_yday - 2) % 7 <= 2) { + val++; + } + if (!val) { + val = 52; + var dec31 = (date.tm_wday + 7 - date.tm_yday - 1) % 7; + if ( + dec31 == 4 || + (dec31 == 5 && isLeapYear((date.tm_year % 400) - 1)) + ) { + val++; + } + } else if (val == 53) { + var jan1 = (date.tm_wday + 371 - date.tm_yday) % 7; + if (jan1 != 4 && (jan1 != 3 || !isLeapYear(date.tm_year))) val = 1; + } + return leadingNulls(val, 2); + }, + "%w": (date) => date.tm_wday, + "%W": (date) => { + var days = date.tm_yday + 7 - ((date.tm_wday + 6) % 7); + return leadingNulls(Math.floor(days / 7), 2); + }, + "%y": (date) => (date.tm_year + 1900).toString().substring(2), + "%Y": (date) => date.tm_year + 1900, + "%z": (date) => { + var off = date.tm_gmtoff; + var ahead = off >= 0; + off = Math.abs(off) / 60; + off = (off / 60) * 100 + (off % 60); + return (ahead ? "+" : "-") + String("0000" + off).slice(-4); + }, + "%Z": (date) => date.tm_zone, + "%%": () => "%", + }; + pattern = pattern.replace(/%%/g, "\0\0"); + for (var rule in EXPANSION_RULES_2) { + if (pattern.includes(rule)) { + pattern = pattern.replace( + new RegExp(rule, "g"), + EXPANSION_RULES_2[rule](date), + ); + } + } + pattern = pattern.replace(/\0\0/g, "%"); + var bytes = intArrayFromString(pattern, false); + if (bytes.length > maxsize) { + return 0; + } + writeArrayToMemory(bytes, s); + return bytes.length - 1; + } + + function _strftime_l(s, maxsize, format, tm, loc) { + s >>>= 0; + maxsize >>>= 0; + format >>>= 0; + tm >>>= 0; + loc >>>= 0; + return _strftime(s, maxsize, format, tm); + } + + var FS_unlink = (path) => FS.unlink(path); + + PThread.init(); + + var FSNode = /** @constructor */ function (parent, name, mode, rdev) { + if (!parent) { + parent = this; + } + this.parent = parent; + this.mount = parent.mount; + this.mounted = null; + this.id = FS.nextInode++; + this.name = name; + this.mode = mode; + this.node_ops = {}; + this.stream_ops = {}; + this.rdev = rdev; + }; + + var readMode = 292 | /*292*/ 73; + + /*73*/ var writeMode = 146; + + /*146*/ Object.defineProperties(FSNode.prototype, { + read: { + get: /** @this{FSNode} */ function () { + return (this.mode & readMode) === readMode; + }, + set: /** @this{FSNode} */ function (val) { + val ? (this.mode |= readMode) : (this.mode &= ~readMode); + }, + }, + write: { + get: /** @this{FSNode} */ function () { + return (this.mode & writeMode) === writeMode; + }, + set: /** @this{FSNode} */ function (val) { + val ? (this.mode |= writeMode) : (this.mode &= ~writeMode); + }, + }, + isFolder: { + get: /** @this{FSNode} */ function () { + return FS.isDir(this.mode); + }, + }, + isDevice: { + get: /** @this{FSNode} */ function () { + return FS.isChrdev(this.mode); + }, + }, + }); + + FS.FSNode = FSNode; + + FS.createPreloadedFile = FS_createPreloadedFile; + + FS.staticInit(); + + Module["FS_createPath"] = FS.createPath; + + Module["FS_createDataFile"] = FS.createDataFile; + + Module["FS_createPreloadedFile"] = FS.createPreloadedFile; + + Module["FS_unlink"] = FS.unlink; + + Module["FS_createLazyFile"] = FS.createLazyFile; + + Module["FS_createDevice"] = FS.createDevice; + + embind_init_charCodes(); + + BindingError = Module["BindingError"] = class BindingError extends Error { + constructor(message) { + super(message); + this.name = "BindingError"; + } + }; + + InternalError = Module["InternalError"] = class InternalError extends ( + Error + ) { + constructor(message) { + super(message); + this.name = "InternalError"; + } + }; + + init_ClassHandle(); + + init_embind(); + + init_RegisteredPointer(); + + UnboundTypeError = Module["UnboundTypeError"] = extendError( + Error, + "UnboundTypeError", + ); + + handleAllocatorInit(); + + init_emval(); + + var proxiedFunctionTable = [ + _proc_exit, + exitOnMainThread, + pthreadCreateProxied, + ___syscall_chmod, + ___syscall_faccessat, + ___syscall_fadvise64, + ___syscall_fchmod, + ___syscall_fcntl64, + ___syscall_fstat64, + ___syscall_getcwd, + ___syscall_getdents64, + ___syscall_ioctl, + ___syscall_lstat64, + ___syscall_mkdirat, + ___syscall_newfstatat, + ___syscall_openat, + ___syscall_readlinkat, + ___syscall_renameat, + ___syscall_stat64, + ___syscall_unlinkat, + __emscripten_runtime_keepalive_clear, + __mmap_js, + __munmap_js, + __setitimer_js, + _emscripten_force_exit, + _environ_get, + _environ_sizes_get, + _fd_close, + _fd_fdstat_get, + _fd_pread, + _fd_pwrite, + _fd_read, + _fd_seek, + _fd_write, + ]; + + var wasmImports = { + /** @export */ __assert_fail: ___assert_fail, + /** @export */ __asyncjs__fetch_asset: __asyncjs__fetch_asset, + /** @export */ __call_sighandler: ___call_sighandler, + /** @export */ __cxa_begin_catch: ___cxa_begin_catch, + /** @export */ __cxa_end_catch: ___cxa_end_catch, + /** @export */ __cxa_find_matching_catch_2: ___cxa_find_matching_catch_2, + /** @export */ __cxa_find_matching_catch_3: ___cxa_find_matching_catch_3, + /** @export */ __cxa_find_matching_catch_4: ___cxa_find_matching_catch_4, + /** @export */ __cxa_get_exception_ptr: ___cxa_get_exception_ptr, + /** @export */ __cxa_rethrow: ___cxa_rethrow, + /** @export */ __cxa_rethrow_primary_exception: + ___cxa_rethrow_primary_exception, + /** @export */ __cxa_throw: ___cxa_throw, + /** @export */ __cxa_uncaught_exceptions: ___cxa_uncaught_exceptions, + /** @export */ __emscripten_init_main_thread_js: + ___emscripten_init_main_thread_js, + /** @export */ __emscripten_thread_cleanup: ___emscripten_thread_cleanup, + /** @export */ __pthread_create_js: ___pthread_create_js, + /** @export */ __resumeException: ___resumeException, + /** @export */ __syscall_chmod: ___syscall_chmod, + /** @export */ __syscall_faccessat: ___syscall_faccessat, + /** @export */ __syscall_fadvise64: ___syscall_fadvise64, + /** @export */ __syscall_fchmod: ___syscall_fchmod, + /** @export */ __syscall_fcntl64: ___syscall_fcntl64, + /** @export */ __syscall_fstat64: ___syscall_fstat64, + /** @export */ __syscall_getcwd: ___syscall_getcwd, + /** @export */ __syscall_getdents64: ___syscall_getdents64, + /** @export */ __syscall_ioctl: ___syscall_ioctl, + /** @export */ __syscall_lstat64: ___syscall_lstat64, + /** @export */ __syscall_mkdirat: ___syscall_mkdirat, + /** @export */ __syscall_newfstatat: ___syscall_newfstatat, + /** @export */ __syscall_openat: ___syscall_openat, + /** @export */ __syscall_readlinkat: ___syscall_readlinkat, + /** @export */ __syscall_renameat: ___syscall_renameat, + /** @export */ __syscall_stat64: ___syscall_stat64, + /** @export */ __syscall_unlinkat: ___syscall_unlinkat, + /** @export */ _embind_register_bigint: __embind_register_bigint, + /** @export */ _embind_register_bool: __embind_register_bool, + /** @export */ _embind_register_class: __embind_register_class, + /** @export */ _embind_register_class_class_function: + __embind_register_class_class_function, + /** @export */ _embind_register_class_class_property: + __embind_register_class_class_property, + /** @export */ _embind_register_class_constructor: + __embind_register_class_constructor, + /** @export */ _embind_register_class_function: + __embind_register_class_function, + /** @export */ _embind_register_class_property: + __embind_register_class_property, + /** @export */ _embind_register_emval: __embind_register_emval, + /** @export */ _embind_register_enum: __embind_register_enum, + /** @export */ _embind_register_enum_value: __embind_register_enum_value, + /** @export */ _embind_register_float: __embind_register_float, + /** @export */ _embind_register_function: __embind_register_function, + /** @export */ _embind_register_integer: __embind_register_integer, + /** @export */ _embind_register_memory_view: + __embind_register_memory_view, + /** @export */ _embind_register_smart_ptr: __embind_register_smart_ptr, + /** @export */ _embind_register_std_string: __embind_register_std_string, + /** @export */ _embind_register_std_wstring: + __embind_register_std_wstring, + /** @export */ _embind_register_void: __embind_register_void, + /** @export */ _emscripten_get_now_is_monotonic: + __emscripten_get_now_is_monotonic, + /** @export */ _emscripten_notify_mailbox_postmessage: + __emscripten_notify_mailbox_postmessage, + /** @export */ _emscripten_receive_on_main_thread_js: + __emscripten_receive_on_main_thread_js, + /** @export */ _emscripten_runtime_keepalive_clear: + __emscripten_runtime_keepalive_clear, + /** @export */ _emscripten_thread_mailbox_await: + __emscripten_thread_mailbox_await, + /** @export */ _emscripten_thread_set_strongref: + __emscripten_thread_set_strongref, + /** @export */ _emval_as: __emval_as, + /** @export */ _emval_as_int64: __emval_as_int64, + /** @export */ _emval_as_uint64: __emval_as_uint64, + /** @export */ _emval_call: __emval_call, + /** @export */ _emval_call_method: __emval_call_method, + /** @export */ _emval_decref: __emval_decref, + /** @export */ _emval_equals: __emval_equals, + /** @export */ _emval_get_global: __emval_get_global, + /** @export */ _emval_get_method_caller: __emval_get_method_caller, + /** @export */ _emval_get_property: __emval_get_property, + /** @export */ _emval_incref: __emval_incref, + /** @export */ _emval_instanceof: __emval_instanceof, + /** @export */ _emval_new_array: __emval_new_array, + /** @export */ _emval_new_cstring: __emval_new_cstring, + /** @export */ _emval_new_object: __emval_new_object, + /** @export */ _emval_run_destructors: __emval_run_destructors, + /** @export */ _emval_set_property: __emval_set_property, + /** @export */ _emval_take_value: __emval_take_value, + /** @export */ _emval_typeof: __emval_typeof, + /** @export */ _mmap_js: __mmap_js, + /** @export */ _munmap_js: __munmap_js, + /** @export */ _setitimer_js: __setitimer_js, + /** @export */ abort: _abort, + /** @export */ addToLoadedFiles: addToLoadedFiles, + /** @export */ downloadJS: downloadJS, + /** @export */ emscripten_check_blocking_allowed: + _emscripten_check_blocking_allowed, + /** @export */ emscripten_date_now: _emscripten_date_now, + /** @export */ emscripten_exit_with_live_runtime: + _emscripten_exit_with_live_runtime, + /** @export */ emscripten_force_exit: _emscripten_force_exit, + /** @export */ emscripten_get_heap_max: _emscripten_get_heap_max, + /** @export */ emscripten_get_now: _emscripten_get_now, + /** @export */ emscripten_num_logical_cores: + _emscripten_num_logical_cores, + /** @export */ emscripten_resize_heap: _emscripten_resize_heap, + /** @export */ environ_get: _environ_get, + /** @export */ environ_sizes_get: _environ_sizes_get, + /** @export */ exit: _exit, + /** @export */ fd_close: _fd_close, + /** @export */ fd_fdstat_get: _fd_fdstat_get, + /** @export */ fd_pread: _fd_pread, + /** @export */ fd_pwrite: _fd_pwrite, + /** @export */ fd_read: _fd_read, + /** @export */ fd_seek: _fd_seek, + /** @export */ fd_write: _fd_write, + /** @export */ invoke_dddd: invoke_dddd, + /** @export */ invoke_ddiiiii: invoke_ddiiiii, + /** @export */ invoke_di: invoke_di, + /** @export */ invoke_did: invoke_did, + /** @export */ invoke_didii: invoke_didii, + /** @export */ invoke_dif: invoke_dif, + /** @export */ invoke_dii: invoke_dii, + /** @export */ invoke_diii: invoke_diii, + /** @export */ invoke_dj: invoke_dj, + /** @export */ invoke_fi: invoke_fi, + /** @export */ invoke_fid: invoke_fid, + /** @export */ invoke_fif: invoke_fif, + /** @export */ invoke_fii: invoke_fii, + /** @export */ invoke_fiii: invoke_fiii, + /** @export */ invoke_fiiid: invoke_fiiid, + /** @export */ invoke_i: invoke_i, + /** @export */ invoke_idddii: invoke_idddii, + /** @export */ invoke_idddiii: invoke_idddiii, + /** @export */ invoke_iddii: invoke_iddii, + /** @export */ invoke_iddiii: invoke_iddiii, + /** @export */ invoke_idi: invoke_idi, + /** @export */ invoke_idii: invoke_idii, + /** @export */ invoke_idiiiiii: invoke_idiiiiii, + /** @export */ invoke_idiiiiiii: invoke_idiiiiiii, + /** @export */ invoke_ifii: invoke_ifii, + /** @export */ invoke_ii: invoke_ii, + /** @export */ invoke_iid: invoke_iid, + /** @export */ invoke_iidd: invoke_iidd, + /** @export */ invoke_iiddddddiiii: invoke_iiddddddiiii, + /** @export */ invoke_iidi: invoke_iidi, + /** @export */ invoke_iidii: invoke_iidii, + /** @export */ invoke_iidiii: invoke_iidiii, + /** @export */ invoke_iidiiii: invoke_iidiiii, + /** @export */ invoke_iidiiiii: invoke_iidiiiii, + /** @export */ invoke_iif: invoke_iif, + /** @export */ invoke_iiffi: invoke_iiffi, + /** @export */ invoke_iifi: invoke_iifi, + /** @export */ invoke_iii: invoke_iii, + /** @export */ invoke_iiid: invoke_iiid, + /** @export */ invoke_iiidd: invoke_iiidd, + /** @export */ invoke_iiidddii: invoke_iiidddii, + /** @export */ invoke_iiiddi: invoke_iiiddi, + /** @export */ invoke_iiiddii: invoke_iiiddii, + /** @export */ invoke_iiidi: invoke_iiidi, + /** @export */ invoke_iiidii: invoke_iiidii, + /** @export */ invoke_iiidiiidiiiidiif: invoke_iiidiiidiiiidiif, + /** @export */ invoke_iiidiiiii: invoke_iiidiiiii, + /** @export */ invoke_iiiff: invoke_iiiff, + /** @export */ invoke_iiifi: invoke_iiifi, + /** @export */ invoke_iiii: invoke_iiii, + /** @export */ invoke_iiiid: invoke_iiiid, + /** @export */ invoke_iiiiddd: invoke_iiiiddd, + /** @export */ invoke_iiiidii: invoke_iiiidii, + /** @export */ invoke_iiiidiii: invoke_iiiidiii, + /** @export */ invoke_iiiidiiii: invoke_iiiidiiii, + /** @export */ invoke_iiiidiiiiii: invoke_iiiidiiiiii, + /** @export */ invoke_iiiifffffiiff: invoke_iiiifffffiiff, + /** @export */ invoke_iiiii: invoke_iiiii, + /** @export */ invoke_iiiiid: invoke_iiiiid, + /** @export */ invoke_iiiiidiiii: invoke_iiiiidiiii, + /** @export */ invoke_iiiiii: invoke_iiiiii, + /** @export */ invoke_iiiiiid: invoke_iiiiiid, + /** @export */ invoke_iiiiiii: invoke_iiiiiii, + /** @export */ invoke_iiiiiiidddi: invoke_iiiiiiidddi, + /** @export */ invoke_iiiiiiii: invoke_iiiiiiii, + /** @export */ invoke_iiiiiiiidi: invoke_iiiiiiiidi, + /** @export */ invoke_iiiiiiiii: invoke_iiiiiiiii, + /** @export */ invoke_iiiiiiiiii: invoke_iiiiiiiiii, + /** @export */ invoke_iiiiiiiiiii: invoke_iiiiiiiiiii, + /** @export */ invoke_iiiiiiiiiiii: invoke_iiiiiiiiiiii, + /** @export */ invoke_iiiiiiiiiiiii: invoke_iiiiiiiiiiiii, + /** @export */ invoke_iiiiiiiiiiiiii: invoke_iiiiiiiiiiiiii, + /** @export */ invoke_iiiiiiiiiiiiiiiiiiii: invoke_iiiiiiiiiiiiiiiiiiii, + /** @export */ invoke_iiiiij: invoke_iiiiij, + /** @export */ invoke_iiiij: invoke_iiiij, + /** @export */ invoke_iiiijii: invoke_iiiijii, + /** @export */ invoke_iiiijjii: invoke_iiiijjii, + /** @export */ invoke_iiijj: invoke_iiijj, + /** @export */ invoke_iiijji: invoke_iiijji, + /** @export */ invoke_iij: invoke_iij, + /** @export */ invoke_j: invoke_j, + /** @export */ invoke_ji: invoke_ji, + /** @export */ invoke_jii: invoke_jii, + /** @export */ invoke_jiii: invoke_jiii, + /** @export */ invoke_jiiii: invoke_jiiii, + /** @export */ invoke_jiij: invoke_jiij, + /** @export */ invoke_v: invoke_v, + /** @export */ invoke_vd: invoke_vd, + /** @export */ invoke_vdiii: invoke_vdiii, + /** @export */ invoke_vfiiii: invoke_vfiiii, + /** @export */ invoke_vi: invoke_vi, + /** @export */ invoke_vid: invoke_vid, + /** @export */ invoke_vidddi: invoke_vidddi, + /** @export */ invoke_viddi: invoke_viddi, + /** @export */ invoke_vidi: invoke_vidi, + /** @export */ invoke_vidii: invoke_vidii, + /** @export */ invoke_vidiii: invoke_vidiii, + /** @export */ invoke_vidiiii: invoke_vidiiii, + /** @export */ invoke_vif: invoke_vif, + /** @export */ invoke_vifii: invoke_vifii, + /** @export */ invoke_vii: invoke_vii, + /** @export */ invoke_viid: invoke_viid, + /** @export */ invoke_viiddddi: invoke_viiddddi, + /** @export */ invoke_viiddi: invoke_viiddi, + /** @export */ invoke_viidi: invoke_viidi, + /** @export */ invoke_viidii: invoke_viidii, + /** @export */ invoke_viif: invoke_viif, + /** @export */ invoke_viii: invoke_viii, + /** @export */ invoke_viiid: invoke_viiid, + /** @export */ invoke_viiiddddi: invoke_viiiddddi, + /** @export */ invoke_viiidi: invoke_viiidi, + /** @export */ invoke_viiidii: invoke_viiidii, + /** @export */ invoke_viiidiiiii: invoke_viiidiiiii, + /** @export */ invoke_viiif: invoke_viiif, + /** @export */ invoke_viiii: invoke_viiii, + /** @export */ invoke_viiiid: invoke_viiiid, + /** @export */ invoke_viiiidi: invoke_viiiidi, + /** @export */ invoke_viiiidiiiiii: invoke_viiiidiiiiii, + /** @export */ invoke_viiiii: invoke_viiiii, + /** @export */ invoke_viiiiid: invoke_viiiiid, + /** @export */ invoke_viiiiidi: invoke_viiiiidi, + /** @export */ invoke_viiiiii: invoke_viiiiii, + /** @export */ invoke_viiiiiii: invoke_viiiiiii, + /** @export */ invoke_viiiiiiid: invoke_viiiiiiid, + /** @export */ invoke_viiiiiiii: invoke_viiiiiiii, + /** @export */ invoke_viiiiiiiii: invoke_viiiiiiiii, + /** @export */ invoke_viiiiiiiiii: invoke_viiiiiiiiii, + /** @export */ invoke_viiiiiiiiiiiii: invoke_viiiiiiiiiiiii, + /** @export */ invoke_viiiiiiiiiiiiiii: invoke_viiiiiiiiiiiiiii, + /** @export */ invoke_viiiijii: invoke_viiiijii, + /** @export */ invoke_viiijii: invoke_viiijii, + /** @export */ invoke_viiijjii: invoke_viiijjii, + /** @export */ invoke_viij: invoke_viij, + /** @export */ invoke_viiji: invoke_viiji, + /** @export */ invoke_vij: invoke_vij, + /** @export */ invoke_viji: invoke_viji, + /** @export */ invoke_vijii: invoke_vijii, + /** @export */ invoke_vijji: invoke_vijji, + /** @export */ llvm_eh_typeid_for: _llvm_eh_typeid_for, + /** @export */ memory: wasmMemory || Module["wasmMemory"], + /** @export */ proc_exit: _proc_exit, + /** @export */ strftime_l: _strftime_l, + }; + + var wasmExports = createWasm(); + + var ___wasm_call_ctors = () => + (___wasm_call_ctors = wasmExports["__wasm_call_ctors"])(); + + var _pthread_self = (Module["_pthread_self"] = () => + (_pthread_self = Module["_pthread_self"] = + wasmExports["pthread_self"])()); + + var ___cxa_free_exception = (a0) => + (___cxa_free_exception = wasmExports["__cxa_free_exception"])(a0); + + var _free = (a0) => (_free = wasmExports["free"])(a0); + + var _malloc = (a0) => (_malloc = wasmExports["malloc"])(a0); + + var ___errno_location = () => + (___errno_location = wasmExports["__errno_location"])(); + + var __emscripten_tls_init = (Module["__emscripten_tls_init"] = () => + (__emscripten_tls_init = Module["__emscripten_tls_init"] = + wasmExports["_emscripten_tls_init"])()); + + var _emscripten_builtin_memalign = (a0, a1) => + (_emscripten_builtin_memalign = + wasmExports["emscripten_builtin_memalign"])(a0, a1); + + var ___getTypeName = (a0) => + (___getTypeName = wasmExports["__getTypeName"])(a0); + + var __embind_initialize_bindings = (Module["__embind_initialize_bindings"] = + () => + (__embind_initialize_bindings = Module["__embind_initialize_bindings"] = + wasmExports["_embind_initialize_bindings"])()); + + var __emscripten_thread_init = (Module["__emscripten_thread_init"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + ) => + (__emscripten_thread_init = Module["__emscripten_thread_init"] = + wasmExports["_emscripten_thread_init"])(a0, a1, a2, a3, a4, a5)); + + var __emscripten_thread_crashed = (Module["__emscripten_thread_crashed"] = + () => + (__emscripten_thread_crashed = Module["__emscripten_thread_crashed"] = + wasmExports["_emscripten_thread_crashed"])()); + + var _emscripten_main_thread_process_queued_calls = () => + (_emscripten_main_thread_process_queued_calls = + wasmExports["emscripten_main_thread_process_queued_calls"])(); + + var _emscripten_main_runtime_thread_id = () => + (_emscripten_main_runtime_thread_id = + wasmExports["emscripten_main_runtime_thread_id"])(); + + var __emscripten_run_on_main_thread_js = (a0, a1, a2, a3) => + (__emscripten_run_on_main_thread_js = + wasmExports["_emscripten_run_on_main_thread_js"])(a0, a1, a2, a3); + + var __emscripten_thread_free_data = (a0) => + (__emscripten_thread_free_data = + wasmExports["_emscripten_thread_free_data"])(a0); + + var __emscripten_thread_exit = (Module["__emscripten_thread_exit"] = (a0) => + (__emscripten_thread_exit = Module["__emscripten_thread_exit"] = + wasmExports["_emscripten_thread_exit"])(a0)); + + var __emscripten_timeout = (a0, a1) => + (__emscripten_timeout = wasmExports["_emscripten_timeout"])(a0, a1); + + var __emscripten_check_mailbox = (Module["__emscripten_check_mailbox"] = + () => + (__emscripten_check_mailbox = Module["__emscripten_check_mailbox"] = + wasmExports["_emscripten_check_mailbox"])()); + + var _setThrew = (a0, a1) => (_setThrew = wasmExports["setThrew"])(a0, a1); + + var setTempRet0 = (a0) => (setTempRet0 = wasmExports["setTempRet0"])(a0); + + var _emscripten_stack_set_limits = (a0, a1) => + (_emscripten_stack_set_limits = + wasmExports["emscripten_stack_set_limits"])(a0, a1); + + var stackSave = () => (stackSave = wasmExports["stackSave"])(); + + var stackRestore = (a0) => (stackRestore = wasmExports["stackRestore"])(a0); + + var stackAlloc = (a0) => (stackAlloc = wasmExports["stackAlloc"])(a0); + + var ___cxa_decrement_exception_refcount = (a0) => + (___cxa_decrement_exception_refcount = + wasmExports["__cxa_decrement_exception_refcount"])(a0); + + var ___cxa_increment_exception_refcount = (a0) => + (___cxa_increment_exception_refcount = + wasmExports["__cxa_increment_exception_refcount"])(a0); + + var ___cxa_can_catch = (a0, a1, a2) => + (___cxa_can_catch = wasmExports["__cxa_can_catch"])(a0, a1, a2); + + var ___cxa_is_pointer_type = (a0) => + (___cxa_is_pointer_type = wasmExports["__cxa_is_pointer_type"])(a0); + + var dynCall_iii = (Module["dynCall_iii"] = (a0, a1, a2) => + (dynCall_iii = Module["dynCall_iii"] = wasmExports["dynCall_iii"])( + a0, + a1, + a2, + )); + + var dynCall_iiii = (Module["dynCall_iiii"] = (a0, a1, a2, a3) => + (dynCall_iiii = Module["dynCall_iiii"] = wasmExports["dynCall_iiii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_vi = (Module["dynCall_vi"] = (a0, a1) => + (dynCall_vi = Module["dynCall_vi"] = wasmExports["dynCall_vi"])(a0, a1)); + + var dynCall_ii = (Module["dynCall_ii"] = (a0, a1) => + (dynCall_ii = Module["dynCall_ii"] = wasmExports["dynCall_ii"])(a0, a1)); + + var dynCall_iiiiii = (Module["dynCall_iiiiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iiiiii = Module["dynCall_iiiiii"] = + wasmExports["dynCall_iiiiii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_vii = (Module["dynCall_vii"] = (a0, a1, a2) => + (dynCall_vii = Module["dynCall_vii"] = wasmExports["dynCall_vii"])( + a0, + a1, + a2, + )); + + var dynCall_i = (Module["dynCall_i"] = (a0) => + (dynCall_i = Module["dynCall_i"] = wasmExports["dynCall_i"])(a0)); + + var dynCall_viiiii = (Module["dynCall_viiiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viiiii = Module["dynCall_viiiii"] = + wasmExports["dynCall_viiiii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_v = (Module["dynCall_v"] = (a0) => + (dynCall_v = Module["dynCall_v"] = wasmExports["dynCall_v"])(a0)); + + var dynCall_viii = (Module["dynCall_viii"] = (a0, a1, a2, a3) => + (dynCall_viii = Module["dynCall_viii"] = wasmExports["dynCall_viii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_vid = (Module["dynCall_vid"] = (a0, a1, a2) => + (dynCall_vid = Module["dynCall_vid"] = wasmExports["dynCall_vid"])( + a0, + a1, + a2, + )); + + var dynCall_di = (Module["dynCall_di"] = (a0, a1) => + (dynCall_di = Module["dynCall_di"] = wasmExports["dynCall_di"])(a0, a1)); + + var dynCall_iiiii = (Module["dynCall_iiiii"] = (a0, a1, a2, a3, a4) => + (dynCall_iiiii = Module["dynCall_iiiii"] = wasmExports["dynCall_iiiii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viiii = (Module["dynCall_viiii"] = (a0, a1, a2, a3, a4) => + (dynCall_viiii = Module["dynCall_viiii"] = wasmExports["dynCall_viiii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viid = (Module["dynCall_viid"] = (a0, a1, a2, a3) => + (dynCall_viid = Module["dynCall_viid"] = wasmExports["dynCall_viid"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_dii = (Module["dynCall_dii"] = (a0, a1, a2) => + (dynCall_dii = Module["dynCall_dii"] = wasmExports["dynCall_dii"])( + a0, + a1, + a2, + )); + + var dynCall_viiid = (Module["dynCall_viiid"] = (a0, a1, a2, a3, a4) => + (dynCall_viiid = Module["dynCall_viiid"] = wasmExports["dynCall_viiid"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiid = (Module["dynCall_iiiid"] = (a0, a1, a2, a3, a4) => + (dynCall_iiiid = Module["dynCall_iiiid"] = wasmExports["dynCall_iiiid"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiiiiii = (Module["dynCall_iiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iiiiiiii = Module["dynCall_iiiiiiii"] = + wasmExports["dynCall_iiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_viiiiii = (Module["dynCall_viiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_viiiiii = Module["dynCall_viiiiii"] = + wasmExports["dynCall_viiiiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_iiiiiii = (Module["dynCall_iiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiiiiii = Module["dynCall_iiiiiii"] = + wasmExports["dynCall_iiiiiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_diii = (Module["dynCall_diii"] = (a0, a1, a2, a3) => + (dynCall_diii = Module["dynCall_diii"] = wasmExports["dynCall_diii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_j = (Module["dynCall_j"] = (a0) => + (dynCall_j = Module["dynCall_j"] = wasmExports["dynCall_j"])(a0)); + + var dynCall_iiid = (Module["dynCall_iiid"] = (a0, a1, a2, a3) => + (dynCall_iiid = Module["dynCall_iiid"] = wasmExports["dynCall_iiid"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iiiiid = (Module["dynCall_iiiiid"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iiiiid = Module["dynCall_iiiiid"] = + wasmExports["dynCall_iiiiid"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_vd = (Module["dynCall_vd"] = (a0, a1) => + (dynCall_vd = Module["dynCall_vd"] = wasmExports["dynCall_vd"])(a0, a1)); + + var dynCall_iiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) => + (dynCall_iiiiiiiiiiii = Module["dynCall_iiiiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + )); + + var dynCall_iid = (Module["dynCall_iid"] = (a0, a1, a2) => + (dynCall_iid = Module["dynCall_iid"] = wasmExports["dynCall_iid"])( + a0, + a1, + a2, + )); + + var dynCall_viidi = (Module["dynCall_viidi"] = (a0, a1, a2, a3, a4) => + (dynCall_viidi = Module["dynCall_viidi"] = wasmExports["dynCall_viidi"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iidiii = (Module["dynCall_iidiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iidiii = Module["dynCall_iidiii"] = + wasmExports["dynCall_iidiii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_iiiiiiiii = (Module["dynCall_iiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_iiiiiiiii = Module["dynCall_iiiiiiiii"] = + wasmExports["dynCall_iiiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_iiiiiiiiii = (Module["dynCall_iiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_iiiiiiiiii = Module["dynCall_iiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_iiidi = (Module["dynCall_iiidi"] = (a0, a1, a2, a3, a4) => + (dynCall_iiidi = Module["dynCall_iiidi"] = wasmExports["dynCall_iiidi"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_fiii = (Module["dynCall_fiii"] = (a0, a1, a2, a3) => + (dynCall_fiii = Module["dynCall_fiii"] = wasmExports["dynCall_fiii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iiifi = (Module["dynCall_iiifi"] = (a0, a1, a2, a3, a4) => + (dynCall_iiifi = Module["dynCall_iiifi"] = wasmExports["dynCall_iiifi"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_fii = (Module["dynCall_fii"] = (a0, a1, a2) => + (dynCall_fii = Module["dynCall_fii"] = wasmExports["dynCall_fii"])( + a0, + a1, + a2, + )); + + var dynCall_viif = (Module["dynCall_viif"] = (a0, a1, a2, a3) => + (dynCall_viif = Module["dynCall_viif"] = wasmExports["dynCall_viif"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iiffi = (Module["dynCall_iiffi"] = (a0, a1, a2, a3, a4) => + (dynCall_iiffi = Module["dynCall_iiffi"] = wasmExports["dynCall_iiffi"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_fif = (Module["dynCall_fif"] = (a0, a1, a2) => + (dynCall_fif = Module["dynCall_fif"] = wasmExports["dynCall_fif"])( + a0, + a1, + a2, + )); + + var dynCall_iif = (Module["dynCall_iif"] = (a0, a1, a2) => + (dynCall_iif = Module["dynCall_iif"] = wasmExports["dynCall_iif"])( + a0, + a1, + a2, + )); + + var dynCall_dif = (Module["dynCall_dif"] = (a0, a1, a2) => + (dynCall_dif = Module["dynCall_dif"] = wasmExports["dynCall_dif"])( + a0, + a1, + a2, + )); + + var dynCall_viiiiiii = (Module["dynCall_viiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_viiiiiii = Module["dynCall_viiiiiii"] = + wasmExports["dynCall_viiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_viiiiiiii = (Module["dynCall_viiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_viiiiiiii = Module["dynCall_viiiiiiii"] = + wasmExports["dynCall_viiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_iidii = (Module["dynCall_iidii"] = (a0, a1, a2, a3, a4) => + (dynCall_iidii = Module["dynCall_iidii"] = wasmExports["dynCall_iidii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viiidiiiii = (Module["dynCall_viiidiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_viiidiiiii = Module["dynCall_viiidiiiii"] = + wasmExports["dynCall_viiidiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_viiiidi = (Module["dynCall_viiiidi"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_viiiidi = Module["dynCall_viiiidi"] = + wasmExports["dynCall_viiiidi"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_viiidii = (Module["dynCall_viiidii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_viiidii = Module["dynCall_viiidii"] = + wasmExports["dynCall_viiidii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_viiiid = (Module["dynCall_viiiid"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viiiid = Module["dynCall_viiiid"] = + wasmExports["dynCall_viiiid"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_iiiidiii = (Module["dynCall_iiiidiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iiiidiii = Module["dynCall_iiiidiii"] = + wasmExports["dynCall_iiiidiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_iiiiidiiii = (Module["dynCall_iiiiidiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_iiiiidiiii = Module["dynCall_iiiiidiiii"] = + wasmExports["dynCall_iiiiidiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_viiiiid = (Module["dynCall_viiiiid"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_viiiiid = Module["dynCall_viiiiid"] = + wasmExports["dynCall_viiiiid"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_viiiiidi = (Module["dynCall_viiiiidi"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_viiiiidi = Module["dynCall_viiiiidi"] = + wasmExports["dynCall_viiiiidi"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_viiiddddi = (Module["dynCall_viiiddddi"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_viiiddddi = Module["dynCall_viiiddddi"] = + wasmExports["dynCall_viiiddddi"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_viiddi = (Module["dynCall_viiddi"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viiddi = Module["dynCall_viiddi"] = + wasmExports["dynCall_viiddi"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_vidddi = (Module["dynCall_vidddi"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_vidddi = Module["dynCall_vidddi"] = + wasmExports["dynCall_vidddi"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_viiddddi = (Module["dynCall_viiddddi"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_viiddddi = Module["dynCall_viiddddi"] = + wasmExports["dynCall_viiddddi"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_fid = (Module["dynCall_fid"] = (a0, a1, a2) => + (dynCall_fid = Module["dynCall_fid"] = wasmExports["dynCall_fid"])( + a0, + a1, + a2, + )); + + var dynCall_iiiiiid = (Module["dynCall_iiiiiid"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiiiiid = Module["dynCall_iiiiiid"] = + wasmExports["dynCall_iiiiiid"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_vif = (Module["dynCall_vif"] = (a0, a1, a2) => + (dynCall_vif = Module["dynCall_vif"] = wasmExports["dynCall_vif"])( + a0, + a1, + a2, + )); + + var dynCall_viiidi = (Module["dynCall_viiidi"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viiidi = Module["dynCall_viiidi"] = + wasmExports["dynCall_viiidi"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_viddi = (Module["dynCall_viddi"] = (a0, a1, a2, a3, a4) => + (dynCall_viddi = Module["dynCall_viddi"] = wasmExports["dynCall_viddi"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viiiiiiid = (Module["dynCall_viiiiiiid"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_viiiiiiid = Module["dynCall_viiiiiiid"] = + wasmExports["dynCall_viiiiiiid"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_jiij = (Module["dynCall_jiij"] = (a0, a1, a2, a3, a4) => + (dynCall_jiij = Module["dynCall_jiij"] = wasmExports["dynCall_jiij"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_ji = (Module["dynCall_ji"] = (a0, a1) => + (dynCall_ji = Module["dynCall_ji"] = wasmExports["dynCall_ji"])(a0, a1)); + + var dynCall_iiiifffffiiff = (Module["dynCall_iiiifffffiiff"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ) => + (dynCall_iiiifffffiiff = Module["dynCall_iiiifffffiiff"] = + wasmExports["dynCall_iiiifffffiiff"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + )); + + var dynCall_jif = (Module["dynCall_jif"] = (a0, a1, a2) => + (dynCall_jif = Module["dynCall_jif"] = wasmExports["dynCall_jif"])( + a0, + a1, + a2, + )); + + var dynCall_vifii = (Module["dynCall_vifii"] = (a0, a1, a2, a3, a4) => + (dynCall_vifii = Module["dynCall_vifii"] = wasmExports["dynCall_vifii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_vfiiii = (Module["dynCall_vfiiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_vfiiii = Module["dynCall_vfiiii"] = + wasmExports["dynCall_vfiiii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_ifii = (Module["dynCall_ifii"] = (a0, a1, a2, a3) => + (dynCall_ifii = Module["dynCall_ifii"] = wasmExports["dynCall_ifii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_jiiijji = (Module["dynCall_jiiijji"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_jiiijji = Module["dynCall_jiiijji"] = + wasmExports["dynCall_jiiijji"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_viiif = (Module["dynCall_viiif"] = (a0, a1, a2, a3, a4) => + (dynCall_viiif = Module["dynCall_viiif"] = wasmExports["dynCall_viiif"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiiiiiiiiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiiiiiiiiiii"] = + ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + a16, + a17, + a18, + a19, + ) => + (dynCall_iiiiiiiiiiiiiiiiiiii = Module["dynCall_iiiiiiiiiiiiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiiiiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + a16, + a17, + a18, + a19, + )); + + var dynCall_viiiiiiiiii = (Module["dynCall_viiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) => + (dynCall_viiiiiiiiii = Module["dynCall_viiiiiiiiii"] = + wasmExports["dynCall_viiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + )); + + var dynCall_viiiiiiiii = (Module["dynCall_viiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_viiiiiiiii = Module["dynCall_viiiiiiiii"] = + wasmExports["dynCall_viiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_iiiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ) => + (dynCall_iiiiiiiiiiiii = Module["dynCall_iiiiiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + )); + + var dynCall_ff = (Module["dynCall_ff"] = (a0, a1) => + (dynCall_ff = Module["dynCall_ff"] = wasmExports["dynCall_ff"])(a0, a1)); + + var dynCall_fff = (Module["dynCall_fff"] = (a0, a1, a2) => + (dynCall_fff = Module["dynCall_fff"] = wasmExports["dynCall_fff"])( + a0, + a1, + a2, + )); + + var dynCall_iiijiii = (Module["dynCall_iiijiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iiijiii = Module["dynCall_iiijiii"] = + wasmExports["dynCall_iiijiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_jii = (Module["dynCall_jii"] = (a0, a1, a2) => + (dynCall_jii = Module["dynCall_jii"] = wasmExports["dynCall_jii"])( + a0, + a1, + a2, + )); + + var dynCall_iiij = (Module["dynCall_iiij"] = (a0, a1, a2, a3, a4) => + (dynCall_iiij = Module["dynCall_iiij"] = wasmExports["dynCall_iiij"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiji = (Module["dynCall_iiiji"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iiiji = Module["dynCall_iiiji"] = wasmExports["dynCall_iiiji"])( + a0, + a1, + a2, + a3, + a4, + a5, + )); + + var dynCall_iiiiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + ) => + (dynCall_iiiiiiiiiiiiii = Module["dynCall_iiiiiiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + )); + + var dynCall_iiddddddiiii = (Module["dynCall_iiddddddiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) => + (dynCall_iiddddddiiii = Module["dynCall_iiddddddiiii"] = + wasmExports["dynCall_iiddddddiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + )); + + var dynCall_iidiiiii = (Module["dynCall_iidiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iidiiiii = Module["dynCall_iidiiiii"] = + wasmExports["dynCall_iidiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_iddiii = (Module["dynCall_iddiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iddiii = Module["dynCall_iddiii"] = + wasmExports["dynCall_iddiii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_iddii = (Module["dynCall_iddii"] = (a0, a1, a2, a3, a4) => + (dynCall_iddii = Module["dynCall_iddii"] = wasmExports["dynCall_iddii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_idddiii = (Module["dynCall_idddiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_idddiii = Module["dynCall_idddiii"] = + wasmExports["dynCall_idddiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_idddii = (Module["dynCall_idddii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_idddii = Module["dynCall_idddii"] = + wasmExports["dynCall_idddii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_idii = (Module["dynCall_idii"] = (a0, a1, a2, a3) => + (dynCall_idii = Module["dynCall_idii"] = wasmExports["dynCall_idii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_idi = (Module["dynCall_idi"] = (a0, a1, a2) => + (dynCall_idi = Module["dynCall_idi"] = wasmExports["dynCall_idi"])( + a0, + a1, + a2, + )); + + var dynCall_fiiid = (Module["dynCall_fiiid"] = (a0, a1, a2, a3, a4) => + (dynCall_fiiid = Module["dynCall_fiiid"] = wasmExports["dynCall_fiiid"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iidi = (Module["dynCall_iidi"] = (a0, a1, a2, a3) => + (dynCall_iidi = Module["dynCall_iidi"] = wasmExports["dynCall_iidi"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iiiidii = (Module["dynCall_iiiidii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiiidii = Module["dynCall_iiiidii"] = + wasmExports["dynCall_iiiidii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_iiiidiiiiii = (Module["dynCall_iiiidiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) => + (dynCall_iiiidiiiiii = Module["dynCall_iiiidiiiiii"] = + wasmExports["dynCall_iiiidiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + )); + + var dynCall_iiidiiiii = (Module["dynCall_iiidiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_iiidiiiii = Module["dynCall_iiidiiiii"] = + wasmExports["dynCall_iiidiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_iiidiiidiiiidiif = (Module["dynCall_iiidiiidiiiidiif"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + ) => + (dynCall_iiidiiidiiiidiif = Module["dynCall_iiidiiidiiiidiif"] = + wasmExports["dynCall_iiidiiidiiiidiif"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + )); + + var dynCall_dddd = (Module["dynCall_dddd"] = (a0, a1, a2, a3) => + (dynCall_dddd = Module["dynCall_dddd"] = wasmExports["dynCall_dddd"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iidiiii = (Module["dynCall_iidiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iidiiii = Module["dynCall_iidiiii"] = + wasmExports["dynCall_iidiiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_iiiddii = (Module["dynCall_iiiddii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiiddii = Module["dynCall_iiiddii"] = + wasmExports["dynCall_iiiddii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_iiiiiiiidi = (Module["dynCall_iiiiiiiidi"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_iiiiiiiidi = Module["dynCall_iiiiiiiidi"] = + wasmExports["dynCall_iiiiiiiidi"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_iiiddi = (Module["dynCall_iiiddi"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iiiddi = Module["dynCall_iiiddi"] = + wasmExports["dynCall_iiiddi"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_iiidd = (Module["dynCall_iiidd"] = (a0, a1, a2, a3, a4) => + (dynCall_iiidd = Module["dynCall_iiidd"] = wasmExports["dynCall_iiidd"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiif = (Module["dynCall_iiiif"] = (a0, a1, a2, a3, a4) => + (dynCall_iiiif = Module["dynCall_iiiif"] = wasmExports["dynCall_iiiif"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_fi = (Module["dynCall_fi"] = (a0, a1) => + (dynCall_fi = Module["dynCall_fi"] = wasmExports["dynCall_fi"])(a0, a1)); + + var dynCall_did = (Module["dynCall_did"] = (a0, a1, a2) => + (dynCall_did = Module["dynCall_did"] = wasmExports["dynCall_did"])( + a0, + a1, + a2, + )); + + var dynCall_iiidii = (Module["dynCall_iiidii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iiidii = Module["dynCall_iiidii"] = + wasmExports["dynCall_iiidii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_iiidddii = (Module["dynCall_iiidddii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iiidddii = Module["dynCall_iiidddii"] = + wasmExports["dynCall_iiidddii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_didii = (Module["dynCall_didii"] = (a0, a1, a2, a3, a4) => + (dynCall_didii = Module["dynCall_didii"] = wasmExports["dynCall_didii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiiiiidddi = (Module["dynCall_iiiiiiidddi"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) => + (dynCall_iiiiiiidddi = Module["dynCall_iiiiiiidddi"] = + wasmExports["dynCall_iiiiiiidddi"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + )); + + var dynCall_iidd = (Module["dynCall_iidd"] = (a0, a1, a2, a3) => + (dynCall_iidd = Module["dynCall_iidd"] = wasmExports["dynCall_iidd"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_viij = (Module["dynCall_viij"] = (a0, a1, a2, a3, a4) => + (dynCall_viij = Module["dynCall_viij"] = wasmExports["dynCall_viij"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viji = (Module["dynCall_viji"] = (a0, a1, a2, a3, a4) => + (dynCall_viji = Module["dynCall_viji"] = wasmExports["dynCall_viji"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_vijii = (Module["dynCall_vijii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_vijii = Module["dynCall_vijii"] = wasmExports["dynCall_vijii"])( + a0, + a1, + a2, + a3, + a4, + a5, + )); + + var dynCall_iiijj = (Module["dynCall_iiijj"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiijj = Module["dynCall_iiijj"] = wasmExports["dynCall_iiijj"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + )); + + var dynCall_iiijji = (Module["dynCall_iiijji"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iiijji = Module["dynCall_iiijji"] = + wasmExports["dynCall_iiijji"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_vij = (Module["dynCall_vij"] = (a0, a1, a2, a3) => + (dynCall_vij = Module["dynCall_vij"] = wasmExports["dynCall_vij"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_vijji = (Module["dynCall_vijji"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_vijji = Module["dynCall_vijji"] = wasmExports["dynCall_vijji"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + )); + + var dynCall_viiji = (Module["dynCall_viiji"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viiji = Module["dynCall_viiji"] = wasmExports["dynCall_viiji"])( + a0, + a1, + a2, + a3, + a4, + a5, + )); + + var dynCall_jiii = (Module["dynCall_jiii"] = (a0, a1, a2, a3) => + (dynCall_jiii = Module["dynCall_jiii"] = wasmExports["dynCall_jiii"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iiiiddd = (Module["dynCall_iiiiddd"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiiiddd = Module["dynCall_iiiiddd"] = + wasmExports["dynCall_iiiiddd"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_vidii = (Module["dynCall_vidii"] = (a0, a1, a2, a3, a4) => + (dynCall_vidii = Module["dynCall_vidii"] = wasmExports["dynCall_vidii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_vidiiii = (Module["dynCall_vidiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_vidiiii = Module["dynCall_vidiiii"] = + wasmExports["dynCall_vidiiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_vidiii = (Module["dynCall_vidiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_vidiii = Module["dynCall_vidiii"] = + wasmExports["dynCall_vidiii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_dj = (Module["dynCall_dj"] = (a0, a1, a2) => + (dynCall_dj = Module["dynCall_dj"] = wasmExports["dynCall_dj"])( + a0, + a1, + a2, + )); + + var dynCall_vdiii = (Module["dynCall_vdiii"] = (a0, a1, a2, a3, a4) => + (dynCall_vdiii = Module["dynCall_vdiii"] = wasmExports["dynCall_vdiii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_idiiiiii = (Module["dynCall_idiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_idiiiiii = Module["dynCall_idiiiiii"] = + wasmExports["dynCall_idiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_idiiiiiii = (Module["dynCall_idiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_idiiiiiii = Module["dynCall_idiiiiiii"] = + wasmExports["dynCall_idiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_iiiidiiii = (Module["dynCall_iiiidiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_iiiidiiii = Module["dynCall_iiiidiiii"] = + wasmExports["dynCall_iiiidiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_viiiidiiiiii = (Module["dynCall_viiiidiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) => + (dynCall_viiiidiiiiii = Module["dynCall_viiiidiiiiii"] = + wasmExports["dynCall_viiiidiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + )); + + var dynCall_iiiff = (Module["dynCall_iiiff"] = (a0, a1, a2, a3, a4) => + (dynCall_iiiff = Module["dynCall_iiiff"] = wasmExports["dynCall_iiiff"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viiiiiiiiiii = (Module["dynCall_viiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) => + (dynCall_viiiiiiiiiii = Module["dynCall_viiiiiiiiiii"] = + wasmExports["dynCall_viiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + )); + + var dynCall_iij = (Module["dynCall_iij"] = (a0, a1, a2, a3) => + (dynCall_iij = Module["dynCall_iij"] = wasmExports["dynCall_iij"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_vidi = (Module["dynCall_vidi"] = (a0, a1, a2, a3) => + (dynCall_vidi = Module["dynCall_vidi"] = wasmExports["dynCall_vidi"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_viiiiiiiiiiiii = (Module["dynCall_viiiiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + ) => + (dynCall_viiiiiiiiiiiii = Module["dynCall_viiiiiiiiiiiii"] = + wasmExports["dynCall_viiiiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + )); + + var dynCall_iiiiiiiiiii = (Module["dynCall_iiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) => + (dynCall_iiiiiiiiiii = Module["dynCall_iiiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + )); + + var dynCall_viidii = (Module["dynCall_viidii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viidii = Module["dynCall_viidii"] = + wasmExports["dynCall_viidii"])(a0, a1, a2, a3, a4, a5)); + + var dynCall_viiiijii = (Module["dynCall_viiiijii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_viiiijii = Module["dynCall_viiiijii"] = + wasmExports["dynCall_viiiijii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_viiijjii = (Module["dynCall_viiijjii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_viiijjii = Module["dynCall_viiijjii"] = + wasmExports["dynCall_viiijjii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_iiiijjii = (Module["dynCall_iiiijjii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_iiiijjii = Module["dynCall_iiiijjii"] = + wasmExports["dynCall_iiiijjii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var dynCall_viiijii = (Module["dynCall_viiijii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_viiijii = Module["dynCall_viiijii"] = + wasmExports["dynCall_viiijii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_iiiijii = (Module["dynCall_iiiijii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_iiiijii = Module["dynCall_iiiijii"] = + wasmExports["dynCall_iiiijii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_ddiiiii = (Module["dynCall_ddiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_ddiiiii = Module["dynCall_ddiiiii"] = + wasmExports["dynCall_ddiiiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_iifi = (Module["dynCall_iifi"] = (a0, a1, a2, a3) => + (dynCall_iifi = Module["dynCall_iifi"] = wasmExports["dynCall_iifi"])( + a0, + a1, + a2, + a3, + )); + + var dynCall_iiiij = (Module["dynCall_iiiij"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_iiiij = Module["dynCall_iiiij"] = wasmExports["dynCall_iiiij"])( + a0, + a1, + a2, + a3, + a4, + a5, + )); + + var dynCall_jiji = (Module["dynCall_jiji"] = (a0, a1, a2, a3, a4) => + (dynCall_jiji = Module["dynCall_jiji"] = wasmExports["dynCall_jiji"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_iiiiij = (Module["dynCall_iiiiij"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_iiiiij = Module["dynCall_iiiiij"] = + wasmExports["dynCall_iiiiij"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_viijii = (Module["dynCall_viijii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_viijii = Module["dynCall_viijii"] = + wasmExports["dynCall_viijii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_jiiii = (Module["dynCall_jiiii"] = (a0, a1, a2, a3, a4) => + (dynCall_jiiii = Module["dynCall_jiiii"] = wasmExports["dynCall_jiiii"])( + a0, + a1, + a2, + a3, + a4, + )); + + var dynCall_viiiiiiiiiiiiiii = (Module["dynCall_viiiiiiiiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + ) => + (dynCall_viiiiiiiiiiiiiii = Module["dynCall_viiiiiiiiiiiiiii"] = + wasmExports["dynCall_viiiiiiiiiiiiiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + )); + + var dynCall_iiiiijj = (Module["dynCall_iiiiijj"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_iiiiijj = Module["dynCall_iiiiijj"] = + wasmExports["dynCall_iiiiijj"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_iiiiiijj = (Module["dynCall_iiiiiijj"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + ) => + (dynCall_iiiiiijj = Module["dynCall_iiiiiijj"] = + wasmExports["dynCall_iiiiiijj"])( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + )); + + var _asyncify_start_unwind = (a0) => + (_asyncify_start_unwind = wasmExports["asyncify_start_unwind"])(a0); + + var _asyncify_stop_unwind = () => + (_asyncify_stop_unwind = wasmExports["asyncify_stop_unwind"])(); + + var _asyncify_start_rewind = (a0) => + (_asyncify_start_rewind = wasmExports["asyncify_start_rewind"])(a0); + + var _asyncify_stop_rewind = () => + (_asyncify_stop_rewind = wasmExports["asyncify_stop_rewind"])(); + + var ___start_em_js = (Module["___start_em_js"] = 3947564); + + var ___stop_em_js = (Module["___stop_em_js"] = 3948888); + + function invoke_iii(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_iii(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iiii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vi(index, a1) { + var sp = stackSave(); + try { + dynCall_vi(index, a1); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_ii(index, a1) { + var sp = stackSave(); + try { + return dynCall_ii(index, a1); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iiiiii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vii(index, a1, a2) { + var sp = stackSave(); + try { + dynCall_vii(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_i(index) { + var sp = stackSave(); + try { + return dynCall_i(index); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_viiiii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiiii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viii(index, a1, a2, a3) { + var sp = stackSave(); + try { + dynCall_viii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viiii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_v(index) { + var sp = stackSave(); + try { + dynCall_v(index); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vid(index, a1, a2) { + var sp = stackSave(); + try { + dynCall_vid(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_iiiiiiii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + dynCall_viiiiii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiiiiii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + dynCall_viiiiiii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiidi(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiidi(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiidi(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_viiidi(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viid(index, a1, a2, a3) { + var sp = stackSave(); + try { + dynCall_viid(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viidi(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viidi(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiid(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iiid(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_di(index, a1) { + var sp = stackSave(); + try { + return dynCall_di(index, a1); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iid(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_iid(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_dii(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_dii(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiid(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iiiiid(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vd(index, a1) { + var sp = stackSave(); + try { + dynCall_vd(index, a1); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iif(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_iif(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iidiii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iidiii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiid(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viiid(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiid(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiiid(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_fiii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_fiii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiifi(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiifi(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_fii(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_fii(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiffi(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiffi(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viif(index, a1, a2, a3) { + var sp = stackSave(); + try { + dynCall_viif(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_diii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_diii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + dynCall_viiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iidii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iidii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_dif(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_dif(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiid(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_viiiid(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiidi(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + dynCall_viiiidi(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiidiii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_iiiidiii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiidi(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + dynCall_viiiiidi(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiidiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + return dynCall_iiiiidiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiidii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + dynCall_viiidii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiid(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + dynCall_viiiiid(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiidiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + dynCall_viiidiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vidi(index, a1, a2, a3) { + var sp = stackSave(); + try { + dynCall_vidi(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiddddi(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + dynCall_viiiddddi(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiddi(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_viiddi(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vidddi(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_vidddi(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiddddi(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + dynCall_viiddddi(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_fid(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_fid(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiid(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiiiiid(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vif(index, a1, a2) { + var sp = stackSave(); + try { + dynCall_vif(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viddi(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viddi(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiiid(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + dynCall_viiiiiiid(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiifffffiiff( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ) { + var sp = stackSave(); + try { + return dynCall_iiiifffffiiff( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_fif(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_fif(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vifii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_vifii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vfiiii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_vfiiii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_ifii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_ifii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + ) { + var sp = stackSave(); + try { + dynCall_viiiiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) { + var sp = stackSave(); + try { + dynCall_viiiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + dynCall_viiiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiif(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viiif(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_fi(index, a1) { + var sp = stackSave(); + try { + return dynCall_fi(index, a1); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiiiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + a16, + a17, + a18, + a19, + ) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiiiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + a16, + a17, + a18, + a19, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + ) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiddddddiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) { + var sp = stackSave(); + try { + return dynCall_iiddddddiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iidiiiii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_iidiiiii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiddii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiiddii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iddiii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iddiii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iddii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iddii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_idddiii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_idddiii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_idddii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_idddii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_idii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_idii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_idi(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_idi(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_fiiid(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_fiiid(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiidiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) { + var sp = stackSave(); + try { + return dynCall_iiiidiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iidi(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iidi(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiidii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiiidii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiidiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + return dynCall_iiidiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiidiiidiiiidiif( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + ) { + var sp = stackSave(); + try { + return dynCall_iiidiiidiiiidiif( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + a14, + a15, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_dddd(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_dddd(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iidiiii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iidiiii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiidi(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiidi(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiddi(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iiiddi(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiidd(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiidd(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_did(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_did(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiidii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iiidii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiidddii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_iiidddii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_didii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_didii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiidddi( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) { + var sp = stackSave(); + try { + return dynCall_iiiiiiidddi( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iidd(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iidd(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiddd(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiiiddd(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vidii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_vidii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vidiiii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + dynCall_vidiiii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vidiii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_vidiii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vdiii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_vdiii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiidiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + return dynCall_iiiidiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_idiiiiii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_idiiiiii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_idiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + return dynCall_idiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiidiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ) { + var sp = stackSave(); + try { + dynCall_viiiidiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiff(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iiiff(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + ) { + var sp = stackSave(); + try { + dynCall_viiiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + a13, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ) { + var sp = stackSave(); + try { + return dynCall_iiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viidii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_viidii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_ddiiiii(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_ddiiiii(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iifi(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iifi(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_j(index) { + var sp = stackSave(); + try { + return dynCall_j(index); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_jiii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_jiii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_jiij(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_jiij(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_ji(index, a1) { + var sp = stackSave(); + try { + return dynCall_ji(index, a1); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viij(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viij(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viji(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + dynCall_viji(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vijii(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_vijii(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiijj(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiijj(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiijji(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_iiijji(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vij(index, a1, a2, a3) { + var sp = stackSave(); + try { + dynCall_vij(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_jii(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_jii(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_vijji(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + dynCall_vijji(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiji(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + dynCall_viiji(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_dj(index, a1, a2) { + var sp = stackSave(); + try { + return dynCall_dj(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iij(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iij(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiiijii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + var sp = stackSave(); + try { + dynCall_viiiijii(index, a1, a2, a3, a4, a5, a6, a7, a8); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + dynCall_viiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + var sp = stackSave(); + try { + return dynCall_iiiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_viiijii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + dynCall_viiijii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiijii(index, a1, a2, a3, a4, a5, a6, a7) { + var sp = stackSave(); + try { + return dynCall_iiiijii(index, a1, a2, a3, a4, a5, a6, a7); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiij(index, a1, a2, a3, a4, a5) { + var sp = stackSave(); + try { + return dynCall_iiiij(index, a1, a2, a3, a4, a5); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_iiiiij(index, a1, a2, a3, a4, a5, a6) { + var sp = stackSave(); + try { + return dynCall_iiiiij(index, a1, a2, a3, a4, a5, a6); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function invoke_jiiii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_jiiii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + + function applySignatureConversions(wasmExports) { + wasmExports = Object.assign({}, wasmExports); + var makeWrapper_p = (f) => () => f() >>> 0; + var makeWrapper_pp = (f) => (a0) => f(a0) >>> 0; + var makeWrapper_ppp = (f) => (a0, a1) => f(a0, a1) >>> 0; + wasmExports["pthread_self"] = makeWrapper_p(wasmExports["pthread_self"]); + wasmExports["malloc"] = makeWrapper_pp(wasmExports["malloc"]); + wasmExports["__errno_location"] = makeWrapper_p( + wasmExports["__errno_location"], + ); + wasmExports["emscripten_builtin_memalign"] = makeWrapper_ppp( + wasmExports["emscripten_builtin_memalign"], + ); + wasmExports["__getTypeName"] = makeWrapper_pp( + wasmExports["__getTypeName"], + ); + wasmExports["stackSave"] = makeWrapper_p(wasmExports["stackSave"]); + wasmExports["stackAlloc"] = makeWrapper_pp(wasmExports["stackAlloc"]); + return wasmExports; + } + + function intArrayFromBase64(s) { + if (typeof ENVIRONMENT_IS_NODE != "undefined" && ENVIRONMENT_IS_NODE) { + var buf = Buffer.from(s, "base64"); + return new Uint8Array(buf.buffer, buf.byteOffset, buf.length); + } + var decoded = atob(s); + var bytes = new Uint8Array(decoded.length); + for (var i = 0; i < decoded.length; ++i) { + bytes[i] = decoded.charCodeAt(i); + } + return bytes; + } + + function tryParseAsDataURI(filename) { + if (!isDataURI(filename)) { + return; + } + return intArrayFromBase64(filename.slice(dataURIPrefix.length)); + } + + Module["addRunDependency"] = addRunDependency; + + Module["removeRunDependency"] = removeRunDependency; + + Module["FS_createPath"] = FS.createPath; + + Module["FS_createLazyFile"] = FS.createLazyFile; + + Module["FS_createDevice"] = FS.createDevice; + + Module["wasmMemory"] = wasmMemory; + + Module["keepRuntimeAlive"] = keepRuntimeAlive; + + Module["ExitStatus"] = ExitStatus; + + Module["FS_createPreloadedFile"] = FS.createPreloadedFile; + + Module["FS_createDataFile"] = FS.createDataFile; + + Module["FS_unlink"] = FS.unlink; + + Module["PThread"] = PThread; + + var calledRun; + + dependenciesFulfilled = function runCaller() { + if (!calledRun) run(); + if (!calledRun) dependenciesFulfilled = runCaller; + }; + + function run() { + if (runDependencies > 0) { + return; + } + if (ENVIRONMENT_IS_PTHREAD) { + readyPromiseResolve(Module); + initRuntime(); + startWorker(Module); + return; + } + preRun(); + if (runDependencies > 0) { + return; + } + function doRun() { + if (calledRun) return; + calledRun = true; + Module["calledRun"] = true; + if (ABORT) return; + initRuntime(); + readyPromiseResolve(Module); + if (Module["onRuntimeInitialized"]) Module["onRuntimeInitialized"](); + postRun(); + } + if (Module["setStatus"]) { + Module["setStatus"]("Running..."); + setTimeout(function () { + setTimeout(function () { + Module["setStatus"](""); + }, 1); + doRun(); + }, 1); + } else { + doRun(); + } + } + + if (Module["preInit"]) { + if (typeof Module["preInit"] == "function") + Module["preInit"] = [Module["preInit"]]; + while (Module["preInit"].length > 0) { + Module["preInit"].pop()(); + } + } + + run(); + + return moduleArg.ready; + }; +})(); +if (typeof exports === "object" && typeof module === "object") + module.exports = getUsdModule; +else if (typeof define === "function" && define["amd"]) + define([], () => getUsdModule); diff --git a/usd-wasm/src/bindings-debug/emHdBindings.worker.js b/usd-wasm/src/bindings-debug/emHdBindings.worker.js new file mode 100644 index 0000000..b43d548 --- /dev/null +++ b/usd-wasm/src/bindings-debug/emHdBindings.worker.js @@ -0,0 +1,181 @@ +/** + * @license + * Copyright 2015 The Emscripten Authors + * SPDX-License-Identifier: MIT + */ + +// Pthread Web Worker startup routine: +// This is the entry point file that is loaded first by each Web Worker +// that executes pthreads on the Emscripten application. + +'use strict'; + +var Module = {}; + +// Node.js support +var ENVIRONMENT_IS_NODE = typeof process == 'object' && typeof process.versions == 'object' && typeof process.versions.node == 'string'; +if (ENVIRONMENT_IS_NODE) { + // Create as web-worker-like an environment as we can. + + var nodeWorkerThreads = require('worker_threads'); + + var parentPort = nodeWorkerThreads.parentPort; + + parentPort.on('message', (data) => onmessage({ data: data })); + + var fs = require('fs'); + + Object.assign(global, { + self: global, + require, + Module, + location: { + href: __filename + }, + Worker: nodeWorkerThreads.Worker, + importScripts: (f) => (0, eval)(fs.readFileSync(f, 'utf8') + '//# sourceURL=' + f), + postMessage: (msg) => parentPort.postMessage(msg), + performance: global.performance || { now: Date.now }, + }); +} + +// Thread-local guard variable for one-time init of the JS state +var initializedJS = false; + +function threadPrintErr() { + var text = Array.prototype.slice.call(arguments).join(' '); + // See https://github.com/emscripten-core/emscripten/issues/14804 + if (ENVIRONMENT_IS_NODE) { + fs.writeSync(2, text + '\n'); + return; + } + console.error(text); +} +function threadAlert() { + var text = Array.prototype.slice.call(arguments).join(' '); + postMessage({cmd: 'alert', text, threadId: Module['_pthread_self']()}); +} +var err = threadPrintErr; +self.alert = threadAlert; + +Module['instantiateWasm'] = (info, receiveInstance) => { + // Instantiate from the module posted from the main thread. + // We can just use sync instantiation in the worker. + var module = Module['wasmModule']; + // We don't need the module anymore; new threads will be spawned from the main thread. + Module['wasmModule'] = null; + var instance = new WebAssembly.Instance(module, info); + // TODO: Due to Closure regression https://github.com/google/closure-compiler/issues/3193, + // the above line no longer optimizes out down to the following line. + // When the regression is fixed, we can remove this if/else. + return receiveInstance(instance); +} + +// Turn unhandled rejected promises into errors so that the main thread will be +// notified about them. +self.onunhandledrejection = (e) => { + throw e.reason || e; +}; + +function handleMessage(e) { + try { + if (e.data.cmd === 'load') { // Preload command that is called once per worker to parse and load the Emscripten code. + + // Until we initialize the runtime, queue up any further incoming messages. + let messageQueue = []; + self.onmessage = (e) => messageQueue.push(e); + + // And add a callback for when the runtime is initialized. + self.startWorker = (instance) => { + Module = instance; + // Notify the main thread that this thread has loaded. + postMessage({ 'cmd': 'loaded' }); + // Process any messages that were queued before the thread was ready. + for (let msg of messageQueue) { + handleMessage(msg); + } + // Restore the real message handler. + self.onmessage = handleMessage; + }; + + // Module and memory were sent from main thread + Module['wasmModule'] = e.data.wasmModule; + + // Use `const` here to ensure that the variable is scoped only to + // that iteration, allowing safe reference from a closure. + for (const handler of e.data.handlers) { + Module[handler] = (...args) => { + postMessage({ cmd: 'callHandler', handler, args: args }); + } + } + + Module['wasmMemory'] = e.data.wasmMemory; + + Module['buffer'] = Module['wasmMemory'].buffer; + + Module['ENVIRONMENT_IS_PTHREAD'] = true; + + if (typeof e.data.urlOrBlob == 'string') { + importScripts(e.data.urlOrBlob); + } else { + var objectUrl = URL.createObjectURL(e.data.urlOrBlob); + importScripts(objectUrl); + URL.revokeObjectURL(objectUrl); + } + getUsdModule(Module); + } else if (e.data.cmd === 'run') { + // Pass the thread address to wasm to store it for fast access. + Module['__emscripten_thread_init'](e.data.pthread_ptr, /*is_main=*/0, /*is_runtime=*/0, /*can_block=*/1); + + // Await mailbox notifications with `Atomics.waitAsync` so we can start + // using the fast `Atomics.notify` notification path. + Module['__emscripten_thread_mailbox_await'](e.data.pthread_ptr); + + // Also call inside JS module to set up the stack frame for this pthread in JS module scope + Module['establishStackSpace'](); + Module['PThread'].receiveObjectTransfer(e.data); + Module['PThread'].threadInitTLS(); + + if (!initializedJS) { + // Embind must initialize itself on all threads, as it generates support JS. + // We only do this once per worker since they get reused + Module['__embind_initialize_bindings'](); + initializedJS = true; + } + + try { + Module['invokeEntryPoint'](e.data.start_routine, e.data.arg); + } catch(ex) { + if (ex != 'unwind') { + // The pthread "crashed". Do not call `_emscripten_thread_exit` (which + // would make this thread joinable). Instead, re-throw the exception + // and let the top level handler propagate it back to the main thread. + throw ex; + } + } + } else if (e.data.cmd === 'cancel') { // Main thread is asking for a pthread_cancel() on this thread. + if (Module['_pthread_self']()) { + Module['__emscripten_thread_exit'](-1); + } + } else if (e.data.target === 'setimmediate') { + // no-op + } else if (e.data.cmd === 'checkMailbox') { + if (initializedJS) { + Module['checkMailbox'](); + } + } else if (e.data.cmd) { + // The received message looks like something that should be handled by this message + // handler, (since there is a e.data.cmd field present), but is not one of the + // recognized commands: + err(`worker.js received unknown command ${e.data.cmd}`); + err(e.data); + } + } catch(ex) { + if (Module['__emscripten_thread_crashed']) { + Module['__emscripten_thread_crashed'](); + } + throw ex; + } +}; + +self.onmessage = handleMessage; From 2fd09520b11e545dd78507f0416ea04fd7dbf2e7 Mon Sep 17 00:00:00 2001 From: andy Date: Fri, 28 Jun 2024 12:35:02 -0400 Subject: [PATCH 2/7] feat: update debug bindings with patches --- .idea/workspace.xml | 24 +++++++++++++++++++++ usd-wasm/src/bindings-debug/emHdBindings.js | 19 +++++++++++++--- 2 files changed, 40 insertions(+), 3 deletions(-) create mode 100644 .idea/workspace.xml diff --git a/.idea/workspace.xml b/.idea/workspace.xml new file mode 100644 index 0000000..b1cc20c --- /dev/null +++ b/.idea/workspace.xml @@ -0,0 +1,24 @@ + + + + + + + + + + + + \ No newline at end of file diff --git a/usd-wasm/src/bindings-debug/emHdBindings.js b/usd-wasm/src/bindings-debug/emHdBindings.js index c94a89e..d55f7d8 100644 --- a/usd-wasm/src/bindings-debug/emHdBindings.js +++ b/usd-wasm/src/bindings-debug/emHdBindings.js @@ -1,10 +1,17 @@ -var getUsdModule = (() => { +var getUsdModule = ((args) => { var _scriptDir = typeof document !== "undefined" && document.currentScript ? document.currentScript.src : undefined; if (typeof __filename !== "undefined") _scriptDir = _scriptDir || __filename; - return function (moduleArg = {}) { + return function (moduleArg = { + // module overrides can be supplied here + locateFile: (path, prefix) => { + if (!prefix && _scriptDir) prefix = _scriptDir.substr(0, _scriptDir.lastIndexOf('/') + 1); + return prefix + path; + }, + ...args +}) { // Support for growable heap + pthreads, where the buffer may change, so JS views // must be updated. function GROWABLE_HEAP_I8() { @@ -999,7 +1006,7 @@ var getUsdModule = (() => { } what = "Aborted(" + what + ")"; err(what); - ABORT = true; + // ABORT = true; // this does not allow anything to work after being set, however we're actually okay to try other assets so we shouldn't do this EXITSTATUS = 1; what += ". Build with -sASSERTIONS for more info."; /** @suppress {checkTypes} */ var e = new WebAssembly.RuntimeError(what); @@ -12942,6 +12949,10 @@ var getUsdModule = (() => { Module["PThread"] = PThread; + Module["FS_readdir"] = FS.readdir; + + Module["FS_analyzePath"] = FS.analyzePath; + var calledRun; dependenciesFulfilled = function runCaller() { @@ -13003,3 +13014,5 @@ if (typeof exports === "object" && typeof module === "object") module.exports = getUsdModule; else if (typeof define === "function" && define["amd"]) define([], () => getUsdModule); + +globalThis["NEEDLE:USD:GET"] = getUsdModule; From 9098bda70623ba822bf238f346b2919050107eee Mon Sep 17 00:00:00 2001 From: andy Date: Fri, 28 Jun 2024 12:35:37 -0400 Subject: [PATCH 3/7] docs: update readme - include build script updates - update features and links --- README.md | 81 ++++++++++--------------------------------------------- 1 file changed, 14 insertions(+), 67 deletions(-) diff --git a/README.md b/README.md index c3c7de2..09036b6 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ A USD viewer on the web. [Open USD Viewer](https://usd-viewer.glitch.me/) There are two main parts: -- [USD WASM bindings by Autodesk](https://autodesk-forks.github.io/USD/usd_for_web_demos/) +- [USD WASM bindings by Autodesk](https://github.com/needle-tools/OpenUSD/tree/needle/feature/wasm-improvements) - A [Three.js](https://threejs.org/) Hydra Delegate for rendering, originally by Autodesk and improved by hybridherbst ## Info and Known Issues @@ -19,13 +19,10 @@ There are two main parts: ### Limitations -- Skinned meshes aren't supported. - Vertex colors aren't supported. - Point instancing isn't supported. - MaterialX isn't supported. -- LightsAPI isn't supported. -- Texture paths currently can't be resolved correctly for nested USDZ files. One level is fine. - - Fixing this would require adjustments to the WASM bindings. +- LightsAPI isn't supported. ## Contribute @@ -87,37 +84,14 @@ NOTE: Origins for these instructions can be found [here](https://github.com/auto 4. Run `wasm-opt -Oz -o "../build_dir/bin/emHdBindings.wasm" "../build_dir/bin/emHdBindings.wasm" --enable-bulk-memory --enable-threads` to shrink the wasm file more. 5. Patch emHdBindings.js to enable the following support, unable to currently do these things as part of the normal build process 1. Support for arguments - - `patch emHdBindings.js < patches/arguments_1.patch` - - `patch emHdBindings.js < patches/arguments_2.patch` - - THIS PATCH DOES NOT WORK - - Copy the following lines: - ``` - return function ( - moduleArg = { - // module overrides can be supplied here - locateFile: (path, prefix) => { - if (!prefix) - prefix = _scriptDir.substr(0, _scriptDir.lastIndexOf("/") + 1); - return prefix + path; - }, - ...args, - }, - ) { - ``` - And replace this line: - - `return function (moduleArg = {}) {` + - `patch emHdBindings.js < arguments_1.patch` + - `patch emHdBindings.js -R < arguments_2.patch` 2. Disable ABORT so that one bad file doesn't corrupt the entire session - - `patch emHdBindings.js < patches/abort.patch` + - `patch emHdBindings.js < abort.patch` 3. Add file system functions to the module - - `patch emHdBindings.js < patches/fileSystem.patch` - - THIS PATCH DOES NOT WORK - - Add these lines - ``` - Module["FS_readdir"] = FS.readdir; - Module["FS_analyzePath"] = FS.analyzePath; - ``` - right after - - `Module["PThread"] = PThread;` + - `patch emHdBindings.js -R < fileSystem.patch` + 4. Include global export + - `echo -e '\nglobalThis["NEEDLE:USD:GET"] = getUsdModule;' >> "emHdBindings.js"` ##### Debug 1. Install [ C/C++ DevTools Support (DWARF)](https://chromewebstore.google.com/detail/cc++-devtools-support-dwa/pdcpmagijalfljmkmjngeonclgbbannb) @@ -135,36 +109,13 @@ NOTE: Origins for these instructions can be found [here](https://github.com/auto 6. Patch emHdBindings.js to enable the following support, unable to currently do these things as part of the normal build process 1. Support for arguments - `patch emHdBindings.js < arguments_1.patch` - - `patch emHdBindings.js < arguments_2.patch` - - THIS PATCH DOES NOT WORK - - Copy the following lines: - ``` - return function ( - moduleArg = { - // module overrides can be supplied here - locateFile: (path, prefix) => { - if (!prefix) - prefix = _scriptDir.substr(0, _scriptDir.lastIndexOf("/") + 1); - return prefix + path; - }, - ...args, - }, - ) { - ``` - And replace this line: - - `return function (moduleArg = {}) {` + - `patch emHdBindings.js -R < arguments_2.patch` 2. Disable ABORT so that one bad file doesn't corrupt the entire session - `patch emHdBindings.js < abort.patch` 3. Add file system functions to the module - - `patch emHdBindings.js < fileSystem.patch` - - THIS PATCH DOES NOT WORK - - Add these lines - ``` - Module["FS_readdir"] = FS.readdir; - Module["FS_analyzePath"] = FS.analyzePath; - ``` - right after - - `Module["PThread"] = PThread;` + - `patch emHdBindings.js -R < fileSystem.patch` + 4. Include global export + - `echo -e '\nglobalThis["NEEDLE:USD:GET"] = getUsdModule;' >> "emHdBindings.js"` 7. Run `npm start` 8. Go to http://localhost:3003 (or wherever the app is running) 9. Open up Chrome Dev Tools @@ -172,13 +123,9 @@ NOTE: Origins for these instructions can be found [here](https://github.com/auto 11. Under Authored, you can go through to the pxr files to set breakpoints in the c++ code. ##### Build Script -There is a build script [here](https://github.com/needle-tools/OpenUSD/blob/needle/feature/wasm-improvements/buildAndMove.sh) which tries to make building easier. Set the mode, build directory and destination directory to deal with the file movement. - -Usage: `./buildAndMove.sh --mode release --build-dir ../build-wasm --destination-dir /Users/andrewbeers/git/needle/usd-viewer/public` - -NOTE: this does not support patching yet as patching doesn't completely work yet -NOTE: this does not update CMakeLists.txt for debug mode automatically +There is a build script [here](https://github.com/needle-tools/OpenUSD/blob/needle/feature/wasm-improvements/buildAndMove.sh) which tries to make building easier. Set the mode, build directory and destination directory to deal with the file movement. This does not update CMakeLists.txt for debug mode automatically. Follow step 2 above to configure this. +Usage: `./buildAndMove.sh --mode release --build-dir ../build-wasm --destination-dir /Users/andrewbeers/git/needle/usd-viewer/usd-wasm/src/bindings --patch-dir /Users/andrewbeers/git/needle/OpenUSD/pxr/usdImaging/hdEmscripten/patches` ## Origin From 9b69b50b083bf7f7be30d7c5131d94e3b8ce1480 Mon Sep 17 00:00:00 2001 From: andy Date: Fri, 28 Jun 2024 12:36:45 -0400 Subject: [PATCH 4/7] revert readme update --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 09036b6..d0771f6 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,8 @@ There are two main parts: - Up axis is only supported for the root file (and very hacky). - Variants are loaded but can't be switched. - The viewer uses SharedArrayBuffers, which have strict header and origin requirements and are not supported on all platforms. +- Texture paths currently can't be resolved correctly for nested USDZ files. One level is fine. + - Fixing this would require adjustments to the WASM bindings. ### Limitations From 3d9781968b1eb26a0c354bfe5fd63ad16bce939d Mon Sep 17 00:00:00 2001 From: andy Date: Fri, 28 Jun 2024 12:37:29 -0400 Subject: [PATCH 5/7] fix typo --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d0771f6..24d9175 100644 --- a/README.md +++ b/README.md @@ -16,8 +16,6 @@ There are two main parts: - Up axis is only supported for the root file (and very hacky). - Variants are loaded but can't be switched. - The viewer uses SharedArrayBuffers, which have strict header and origin requirements and are not supported on all platforms. -- Texture paths currently can't be resolved correctly for nested USDZ files. One level is fine. - - Fixing this would require adjustments to the WASM bindings. ### Limitations @@ -25,6 +23,8 @@ There are two main parts: - Point instancing isn't supported. - MaterialX isn't supported. - LightsAPI isn't supported. +- Texture paths currently can't be resolved correctly for nested USDZ files. One level is fine. + - Fixing this would require adjustments to the WASM bindings. ## Contribute From c7c239d6cbdf9b8635755ab13c49ffdd98a8b087 Mon Sep 17 00:00:00 2001 From: andy Date: Fri, 28 Jun 2024 12:39:27 -0400 Subject: [PATCH 6/7] update: updating with what is built from usd branch - update to sync generated assets with the needle OpenUSD repo - future updates will diff with this cleaner --- usd-wasm/src/bindings/emHdBindings.js | 8 ++++---- usd-wasm/src/bindings/emHdBindings.wasm | Bin 15564546 -> 15563055 bytes 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/usd-wasm/src/bindings/emHdBindings.js b/usd-wasm/src/bindings/emHdBindings.js index 0df0321..e9ac7af 100644 --- a/usd-wasm/src/bindings/emHdBindings.js +++ b/usd-wasm/src/bindings/emHdBindings.js @@ -8,7 +8,7 @@ var getUsdModule = ((args) => { // module overrides can be supplied here locateFile: (path, prefix) => { if (!prefix && _scriptDir) prefix = _scriptDir.substr(0, _scriptDir.lastIndexOf('/') + 1); - return prefix + path; + return prefix + path; }, ...args }) { @@ -10163,8 +10163,8 @@ var getUsdModule = ((args) => { (_asyncify_start_rewind = wasmExports["Ug"])(a0); var _asyncify_stop_rewind = () => (_asyncify_stop_rewind = wasmExports["Vg"])(); - var ___start_em_js = (Module["___start_em_js"] = 3895468); - var ___stop_em_js = (Module["___stop_em_js"] = 3896792); + var ___start_em_js = (Module["___start_em_js"] = 3890876); + var ___stop_em_js = (Module["___stop_em_js"] = 3892200); function invoke_iii(index, a1, a2) { var sp = stackSave(); try { @@ -12019,4 +12019,4 @@ if (typeof exports === "object" && typeof module === "object") else if (typeof define === "function" && define["amd"]) define([], () => getUsdModule); -globalThis["NEEDLE:USD:GET"] = getUsdModule; \ No newline at end of file +globalThis["NEEDLE:USD:GET"] = getUsdModule; diff --git a/usd-wasm/src/bindings/emHdBindings.wasm b/usd-wasm/src/bindings/emHdBindings.wasm index 03f2b218d1558c1de6793c3a7691b0add78354fa..38f0c680f4f43ece95e60384c243fda02c5ed798 100644 GIT binary patch delta 627593 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

3R}wqv{} z!vb{@e*xJ!A&}0z9@Q8z@;uGd`bt0`#ciwX0Xwp9i)bB6J*AaisQ%3Ho1-Wx*S#%e zE>hE>znQ#P1t;qmg>~nlU%RD(kusCiAbyb--7aD*K+l(|Ln$Fy&Eb#PC?>Q#w9%HU zg}@E?d$~H0YAuEzjBWVIdjTlPPN(B>uTAnogNwFzfD z_dOI(mz8Qfe=aWy&&QSOF+S}A3&2wZ-w9*E*Q?YuU_CEdt-_{nzxHK~>cxSdhR{2) zkSIy()Ij67c2Jg2%Zc$%Jp8wbLfch$qi$7;_tb3b)kd6ga}+c#zswpQNb&|%D$ML1 zbnj9V*lBeg8;u*A9DcStuqd2fzHK)a+Sp$cHmZ|2{y^TC9&lc)A6}|>oE)3gVTPPE zm^@vn*br`Ylq(f$X}z~FIx_FUZTk-on|G+{w>Q*nxB5t*rura&>r<59|%`k z2ieAU*-htNfL!I-E^6CE+56Nz;Dv2SQ(JJiw13jnID#C&*Fi_t2E)VR zR)pDA{j3kMI9-ChL8~DE?4xPWZLHe{3#&;xL=3Nhm@c-Zo4qvuL#hcvXsyWq!`OR( zMR9%q!_0Ma3lF-}`@j9+#Q9_s*Sr?kV@w!?9TmT$@iHfuMU|o^ll81oJ@lKL*(i zx3?XST?xf}j}s7Y9#YncSl*zx{h}@q(lG|C$b`qK5y{3nodj$8D6cxH40@k7oQmBG z0eQ%2h_;Vt`{~%*fYXv(Ts@{oxv{qm=ce0y2P(qK7~5E1N!0>9p};d}`GD-sqUBQ* zbi>tNs&@`oA86{i*jrF}5B&pI1+?Q2ko1po-Sap|fccNV5c`v1I(VXzceD{LbBy++ z_Ju#1$n9cmdAJAGyNF)LXzIn-zraX`Uy2=tn|Cka(_hp4%aDBw#<>YmU}(+FT*N?Z7FZNNYQ`BR-|G1u_Y-tp_$(P z(s%0DtR|4UTJtBQ=t6S& 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

OZn6I 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

=* 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 delta 631878 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

NOvQlZ7&Nsug{NGR?}kqs0|plG2X!P_DU?gW=2 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

    q*e#c?t8qSyfSX|f`K_1GS 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 z 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

    |6Ui`6Cr)F;F0~Qs5^_%T0UD? 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 Qnl1&i)$zLBo-~aA1=WjI-2eap From a5bbb10a1d988b33cc2a73b400893cbe7d833d15 Mon Sep 17 00:00:00 2001 From: andy Date: Mon, 8 Jul 2024 15:31:53 -0400 Subject: [PATCH 7/7] feat: update debug bindings file --- usd-wasm/src/bindings-debug/emHdBindings.js | 927 +++++++++----------- 1 file changed, 437 insertions(+), 490 deletions(-) diff --git a/usd-wasm/src/bindings-debug/emHdBindings.js b/usd-wasm/src/bindings-debug/emHdBindings.js index d55f7d8..67627b7 100644 --- a/usd-wasm/src/bindings-debug/emHdBindings.js +++ b/usd-wasm/src/bindings-debug/emHdBindings.js @@ -1426,7 +1426,11 @@ var getUsdModule = ((args) => { var endPtr = idx; while (heapOrArray[endPtr] && !(endPtr >= endIdx)) ++endPtr; if (endPtr - idx > 16 && heapOrArray.buffer && UTF8Decoder) { - return UTF8Decoder.decode(heapOrArray.slice(idx, endPtr)); + return UTF8Decoder.decode( + heapOrArray.buffer instanceof SharedArrayBuffer + ? heapOrArray.slice(idx, endPtr) + : heapOrArray.subarray(idx, endPtr), + ); } var str = ""; while (idx < endPtr) { @@ -5707,9 +5711,19 @@ var getUsdModule = ((args) => { : f.call(null, ptr); }; + var wasmTableMirror = []; + var wasmTable; - var getWasmTableEntry = (funcPtr) => wasmTable.get(funcPtr); + var getWasmTableEntry = (funcPtr) => { + var func = wasmTableMirror[funcPtr]; + if (!func) { + if (funcPtr >= wasmTableMirror.length) + wasmTableMirror.length = funcPtr + 1; + wasmTableMirror[funcPtr] = func = wasmTable.get(funcPtr); + } + return func; + }; /** @param {Object=} args */ var dynCall = (sig, ptr, args) => { var rtn = dynCallLegacy(sig, ptr, args); @@ -8883,6 +8897,7 @@ var getUsdModule = ((args) => { /** @export */ fd_read: _fd_read, /** @export */ fd_seek: _fd_seek, /** @export */ fd_write: _fd_write, + /** @export */ invoke_d: invoke_d, /** @export */ invoke_dddd: invoke_dddd, /** @export */ invoke_ddiiiii: invoke_ddiiiii, /** @export */ invoke_di: invoke_di, @@ -8891,6 +8906,7 @@ var getUsdModule = ((args) => { /** @export */ invoke_dif: invoke_dif, /** @export */ invoke_dii: invoke_dii, /** @export */ invoke_diii: invoke_diii, + /** @export */ invoke_diiiii: invoke_diiiii, /** @export */ invoke_dj: invoke_dj, /** @export */ invoke_fi: invoke_fi, /** @export */ invoke_fid: invoke_fid, @@ -8903,15 +8919,12 @@ var getUsdModule = ((args) => { /** @export */ invoke_idddiii: invoke_idddiii, /** @export */ invoke_iddii: invoke_iddii, /** @export */ invoke_iddiii: invoke_iddiii, - /** @export */ invoke_idi: invoke_idi, /** @export */ invoke_idii: invoke_idii, /** @export */ invoke_idiiiiii: invoke_idiiiiii, /** @export */ invoke_idiiiiiii: invoke_idiiiiiii, - /** @export */ invoke_ifii: invoke_ifii, /** @export */ invoke_ii: invoke_ii, /** @export */ invoke_iid: invoke_iid, /** @export */ invoke_iidd: invoke_iidd, - /** @export */ invoke_iiddddddiiii: invoke_iiddddddiiii, /** @export */ invoke_iidi: invoke_iidi, /** @export */ invoke_iidii: invoke_iidii, /** @export */ invoke_iidiii: invoke_iidiii, @@ -8919,10 +8932,8 @@ var getUsdModule = ((args) => { /** @export */ invoke_iidiiiii: invoke_iidiiiii, /** @export */ invoke_iif: invoke_iif, /** @export */ invoke_iiffi: invoke_iiffi, - /** @export */ invoke_iifi: invoke_iifi, /** @export */ invoke_iii: invoke_iii, /** @export */ invoke_iiid: invoke_iiid, - /** @export */ invoke_iiidd: invoke_iiidd, /** @export */ invoke_iiidddii: invoke_iiidddii, /** @export */ invoke_iiiddi: invoke_iiiddi, /** @export */ invoke_iiiddii: invoke_iiiddii, @@ -8930,7 +8941,6 @@ var getUsdModule = ((args) => { /** @export */ invoke_iiidii: invoke_iiidii, /** @export */ invoke_iiidiiidiiiidiif: invoke_iiidiiidiiiidiif, /** @export */ invoke_iiidiiiii: invoke_iiidiiiii, - /** @export */ invoke_iiiff: invoke_iiiff, /** @export */ invoke_iiifi: invoke_iiifi, /** @export */ invoke_iiii: invoke_iiii, /** @export */ invoke_iiiid: invoke_iiiid, @@ -8957,42 +8967,42 @@ var getUsdModule = ((args) => { /** @export */ invoke_iiiiiiiiiiiiii: invoke_iiiiiiiiiiiiii, /** @export */ invoke_iiiiiiiiiiiiiiiiiiii: invoke_iiiiiiiiiiiiiiiiiiii, /** @export */ invoke_iiiiij: invoke_iiiiij, - /** @export */ invoke_iiiij: invoke_iiiij, - /** @export */ invoke_iiiijii: invoke_iiiijii, /** @export */ invoke_iiiijjii: invoke_iiiijjii, /** @export */ invoke_iiijj: invoke_iiijj, - /** @export */ invoke_iiijji: invoke_iiijji, /** @export */ invoke_iij: invoke_iij, + /** @export */ invoke_ij: invoke_ij, /** @export */ invoke_j: invoke_j, /** @export */ invoke_ji: invoke_ji, /** @export */ invoke_jii: invoke_jii, /** @export */ invoke_jiii: invoke_jiii, /** @export */ invoke_jiiii: invoke_jiiii, + /** @export */ invoke_jiiij: invoke_jiiij, /** @export */ invoke_jiij: invoke_jiij, + /** @export */ invoke_jjiii: invoke_jjiii, /** @export */ invoke_v: invoke_v, /** @export */ invoke_vd: invoke_vd, /** @export */ invoke_vdiii: invoke_vdiii, + /** @export */ invoke_vfffi: invoke_vfffi, /** @export */ invoke_vfiiii: invoke_vfiiii, /** @export */ invoke_vi: invoke_vi, /** @export */ invoke_vid: invoke_vid, - /** @export */ invoke_vidddi: invoke_vidddi, /** @export */ invoke_viddi: invoke_viddi, - /** @export */ invoke_vidi: invoke_vidi, /** @export */ invoke_vidii: invoke_vidii, /** @export */ invoke_vidiii: invoke_vidiii, /** @export */ invoke_vidiiii: invoke_vidiiii, /** @export */ invoke_vif: invoke_vif, + /** @export */ invoke_viffffi: invoke_viffffi, + /** @export */ invoke_vifffi: invoke_vifffi, /** @export */ invoke_vifii: invoke_vifii, /** @export */ invoke_vii: invoke_vii, /** @export */ invoke_viid: invoke_viid, - /** @export */ invoke_viiddddi: invoke_viiddddi, - /** @export */ invoke_viiddi: invoke_viiddi, /** @export */ invoke_viidi: invoke_viidi, /** @export */ invoke_viidii: invoke_viidii, /** @export */ invoke_viif: invoke_viif, + /** @export */ invoke_viiffffi: invoke_viiffffi, + /** @export */ invoke_viiffi: invoke_viiffi, /** @export */ invoke_viii: invoke_viii, /** @export */ invoke_viiid: invoke_viiid, - /** @export */ invoke_viiiddddi: invoke_viiiddddi, /** @export */ invoke_viiidi: invoke_viiidi, /** @export */ invoke_viiidii: invoke_viiidii, /** @export */ invoke_viiidiiiii: invoke_viiidiiiii, @@ -9010,17 +9020,19 @@ var getUsdModule = ((args) => { /** @export */ invoke_viiiiiiii: invoke_viiiiiiii, /** @export */ invoke_viiiiiiiii: invoke_viiiiiiiii, /** @export */ invoke_viiiiiiiiii: invoke_viiiiiiiiii, + /** @export */ invoke_viiiiiiiiiiii: invoke_viiiiiiiiiiii, /** @export */ invoke_viiiiiiiiiiiii: invoke_viiiiiiiiiiiii, /** @export */ invoke_viiiiiiiiiiiiiii: invoke_viiiiiiiiiiiiiii, /** @export */ invoke_viiiijii: invoke_viiiijii, - /** @export */ invoke_viiijii: invoke_viiijii, - /** @export */ invoke_viiijjii: invoke_viiijjii, /** @export */ invoke_viij: invoke_viij, /** @export */ invoke_viiji: invoke_viiji, /** @export */ invoke_vij: invoke_vij, /** @export */ invoke_viji: invoke_viji, /** @export */ invoke_vijii: invoke_vijii, + /** @export */ invoke_vijiiiii: invoke_vijiiiii, /** @export */ invoke_vijji: invoke_vijji, + /** @export */ invoke_vjiii: invoke_vjiii, + /** @export */ invoke_vjiiii: invoke_vjiiii, /** @export */ llvm_eh_typeid_for: _llvm_eh_typeid_for, /** @export */ memory: wasmMemory || Module["wasmMemory"], /** @export */ proc_exit: _proc_exit, @@ -9141,17 +9153,26 @@ var getUsdModule = ((args) => { a2, )); - var dynCall_iiii = (Module["dynCall_iiii"] = (a0, a1, a2, a3) => - (dynCall_iiii = Module["dynCall_iiii"] = wasmExports["dynCall_iiii"])( + var dynCall_viiii = (Module["dynCall_viiii"] = (a0, a1, a2, a3, a4) => + (dynCall_viiii = Module["dynCall_viiii"] = wasmExports["dynCall_viiii"])( a0, a1, a2, a3, + a4, )); var dynCall_vi = (Module["dynCall_vi"] = (a0, a1) => (dynCall_vi = Module["dynCall_vi"] = wasmExports["dynCall_vi"])(a0, a1)); + var dynCall_iiii = (Module["dynCall_iiii"] = (a0, a1, a2, a3) => + (dynCall_iiii = Module["dynCall_iiii"] = wasmExports["dynCall_iiii"])( + a0, + a1, + a2, + a3, + )); + var dynCall_ii = (Module["dynCall_ii"] = (a0, a1) => (dynCall_ii = Module["dynCall_ii"] = wasmExports["dynCall_ii"])(a0, a1)); @@ -9173,9 +9194,6 @@ var getUsdModule = ((args) => { (dynCall_viiiii = Module["dynCall_viiiii"] = wasmExports["dynCall_viiiii"])(a0, a1, a2, a3, a4, a5)); - var dynCall_v = (Module["dynCall_v"] = (a0) => - (dynCall_v = Module["dynCall_v"] = wasmExports["dynCall_v"])(a0)); - var dynCall_viii = (Module["dynCall_viii"] = (a0, a1, a2, a3) => (dynCall_viii = Module["dynCall_viii"] = wasmExports["dynCall_viii"])( a0, @@ -9191,40 +9209,34 @@ var getUsdModule = ((args) => { a2, )); - var dynCall_di = (Module["dynCall_di"] = (a0, a1) => - (dynCall_di = Module["dynCall_di"] = wasmExports["dynCall_di"])(a0, a1)); - - var dynCall_iiiii = (Module["dynCall_iiiii"] = (a0, a1, a2, a3, a4) => - (dynCall_iiiii = Module["dynCall_iiiii"] = wasmExports["dynCall_iiiii"])( + var dynCall_viid = (Module["dynCall_viid"] = (a0, a1, a2, a3) => + (dynCall_viid = Module["dynCall_viid"] = wasmExports["dynCall_viid"])( a0, a1, a2, a3, - a4, )); - var dynCall_viiii = (Module["dynCall_viiii"] = (a0, a1, a2, a3, a4) => - (dynCall_viiii = Module["dynCall_viiii"] = wasmExports["dynCall_viiii"])( - a0, - a1, - a2, - a3, - a4, - )); + var dynCall_di = (Module["dynCall_di"] = (a0, a1) => + (dynCall_di = Module["dynCall_di"] = wasmExports["dynCall_di"])(a0, a1)); - var dynCall_viid = (Module["dynCall_viid"] = (a0, a1, a2, a3) => - (dynCall_viid = Module["dynCall_viid"] = wasmExports["dynCall_viid"])( + var dynCall_dii = (Module["dynCall_dii"] = (a0, a1, a2) => + (dynCall_dii = Module["dynCall_dii"] = wasmExports["dynCall_dii"])( a0, a1, a2, - a3, )); - var dynCall_dii = (Module["dynCall_dii"] = (a0, a1, a2) => - (dynCall_dii = Module["dynCall_dii"] = wasmExports["dynCall_dii"])( + var dynCall_v = (Module["dynCall_v"] = (a0) => + (dynCall_v = Module["dynCall_v"] = wasmExports["dynCall_v"])(a0)); + + var dynCall_iiiii = (Module["dynCall_iiiii"] = (a0, a1, a2, a3, a4) => + (dynCall_iiiii = Module["dynCall_iiiii"] = wasmExports["dynCall_iiiii"])( a0, a1, a2, + a3, + a4, )); var dynCall_viiid = (Module["dynCall_viiid"] = (a0, a1, a2, a3, a4) => @@ -9270,6 +9282,10 @@ var getUsdModule = ((args) => { (dynCall_viiiiii = Module["dynCall_viiiiii"] = wasmExports["dynCall_viiiiii"])(a0, a1, a2, a3, a4, a5, a6)); + var dynCall_diiiii = (Module["dynCall_diiiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_diiiii = Module["dynCall_diiiii"] = + wasmExports["dynCall_diiiii"])(a0, a1, a2, a3, a4, a5)); + var dynCall_iiiiiii = (Module["dynCall_iiiiiii"] = ( a0, a1, @@ -9290,8 +9306,8 @@ var getUsdModule = ((args) => { a3, )); - var dynCall_j = (Module["dynCall_j"] = (a0) => - (dynCall_j = Module["dynCall_j"] = wasmExports["dynCall_j"])(a0)); + var dynCall_d = (Module["dynCall_d"] = (a0) => + (dynCall_d = Module["dynCall_d"] = wasmExports["dynCall_d"])(a0)); var dynCall_iiid = (Module["dynCall_iiid"] = (a0, a1, a2, a3) => (dynCall_iiid = Module["dynCall_iiid"] = wasmExports["dynCall_iiid"])( @@ -9305,6 +9321,20 @@ var getUsdModule = ((args) => { (dynCall_iiiiid = Module["dynCall_iiiiid"] = wasmExports["dynCall_iiiiid"])(a0, a1, a2, a3, a4, a5)); + var dynCall_iiiiiiiii = (Module["dynCall_iiiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_iiiiiiiii = Module["dynCall_iiiiiiiii"] = + wasmExports["dynCall_iiiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + var dynCall_vd = (Module["dynCall_vd"] = (a0, a1) => (dynCall_vd = Module["dynCall_vd"] = wasmExports["dynCall_vd"])(a0, a1)); @@ -9358,20 +9388,6 @@ var getUsdModule = ((args) => { (dynCall_iidiii = Module["dynCall_iidiii"] = wasmExports["dynCall_iidiii"])(a0, a1, a2, a3, a4, a5)); - var dynCall_iiiiiiiii = (Module["dynCall_iiiiiiiii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - a8, - ) => - (dynCall_iiiiiiiii = Module["dynCall_iiiiiiiii"] = - wasmExports["dynCall_iiiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); - var dynCall_iiiiiiiiii = (Module["dynCall_iiiiiiiiii"] = ( a0, a1, @@ -9424,12 +9440,18 @@ var getUsdModule = ((args) => { a4, )); - var dynCall_fii = (Module["dynCall_fii"] = (a0, a1, a2) => - (dynCall_fii = Module["dynCall_fii"] = wasmExports["dynCall_fii"])( - a0, - a1, - a2, - )); + var dynCall_viiiiiii = (Module["dynCall_viiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + ) => + (dynCall_viiiiiii = Module["dynCall_viiiiiii"] = + wasmExports["dynCall_viiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); var dynCall_viif = (Module["dynCall_viif"] = (a0, a1, a2, a3) => (dynCall_viif = Module["dynCall_viif"] = wasmExports["dynCall_viif"])( @@ -9469,18 +9491,14 @@ var getUsdModule = ((args) => { a2, )); - var dynCall_viiiiiii = (Module["dynCall_viiiiiii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - ) => - (dynCall_viiiiiii = Module["dynCall_viiiiiii"] = - wasmExports["dynCall_viiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + var dynCall_viiif = (Module["dynCall_viiif"] = (a0, a1, a2, a3, a4) => + (dynCall_viiif = Module["dynCall_viiif"] = wasmExports["dynCall_viiif"])( + a0, + a1, + a2, + a3, + a4, + )); var dynCall_viiiiiiii = (Module["dynCall_viiiiiiii"] = ( a0, @@ -9496,15 +9514,6 @@ var getUsdModule = ((args) => { (dynCall_viiiiiiii = Module["dynCall_viiiiiiii"] = wasmExports["dynCall_viiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); - var dynCall_iidii = (Module["dynCall_iidii"] = (a0, a1, a2, a3, a4) => - (dynCall_iidii = Module["dynCall_iidii"] = wasmExports["dynCall_iidii"])( - a0, - a1, - a2, - a3, - a4, - )); - var dynCall_viiidiiiii = (Module["dynCall_viiidiiiii"] = ( a0, a1, @@ -9623,7 +9632,7 @@ var getUsdModule = ((args) => { (dynCall_viiiiidi = Module["dynCall_viiiiidi"] = wasmExports["dynCall_viiiiidi"])(a0, a1, a2, a3, a4, a5, a6, a7)); - var dynCall_viiiddddi = (Module["dynCall_viiiddddi"] = ( + var dynCall_viiffffi = (Module["dynCall_viiffffi"] = ( a0, a1, a2, @@ -9632,20 +9641,24 @@ var getUsdModule = ((args) => { a5, a6, a7, - a8, ) => - (dynCall_viiiddddi = Module["dynCall_viiiddddi"] = - wasmExports["dynCall_viiiddddi"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + (dynCall_viiffffi = Module["dynCall_viiffffi"] = + wasmExports["dynCall_viiffffi"])(a0, a1, a2, a3, a4, a5, a6, a7)); - var dynCall_viiddi = (Module["dynCall_viiddi"] = (a0, a1, a2, a3, a4, a5) => - (dynCall_viiddi = Module["dynCall_viiddi"] = - wasmExports["dynCall_viiddi"])(a0, a1, a2, a3, a4, a5)); + var dynCall_vifffi = (Module["dynCall_vifffi"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_vifffi = Module["dynCall_vifffi"] = + wasmExports["dynCall_vifffi"])(a0, a1, a2, a3, a4, a5)); - var dynCall_vidddi = (Module["dynCall_vidddi"] = (a0, a1, a2, a3, a4, a5) => - (dynCall_vidddi = Module["dynCall_vidddi"] = - wasmExports["dynCall_vidddi"])(a0, a1, a2, a3, a4, a5)); + var dynCall_vfffi = (Module["dynCall_vfffi"] = (a0, a1, a2, a3, a4) => + (dynCall_vfffi = Module["dynCall_vfffi"] = wasmExports["dynCall_vfffi"])( + a0, + a1, + a2, + a3, + a4, + )); - var dynCall_viiddddi = (Module["dynCall_viiddddi"] = ( + var dynCall_viffffi = (Module["dynCall_viffffi"] = ( a0, a1, a2, @@ -9653,10 +9666,9 @@ var getUsdModule = ((args) => { a4, a5, a6, - a7, ) => - (dynCall_viiddddi = Module["dynCall_viiddddi"] = - wasmExports["dynCall_viiddddi"])(a0, a1, a2, a3, a4, a5, a6, a7)); + (dynCall_viffffi = Module["dynCall_viffffi"] = + wasmExports["dynCall_viffffi"])(a0, a1, a2, a3, a4, a5, a6)); var dynCall_fid = (Module["dynCall_fid"] = (a0, a1, a2) => (dynCall_fid = Module["dynCall_fid"] = wasmExports["dynCall_fid"])( @@ -9677,13 +9689,6 @@ var getUsdModule = ((args) => { (dynCall_iiiiiid = Module["dynCall_iiiiiid"] = wasmExports["dynCall_iiiiiid"])(a0, a1, a2, a3, a4, a5, a6)); - var dynCall_vif = (Module["dynCall_vif"] = (a0, a1, a2) => - (dynCall_vif = Module["dynCall_vif"] = wasmExports["dynCall_vif"])( - a0, - a1, - a2, - )); - var dynCall_viiidi = (Module["dynCall_viiidi"] = (a0, a1, a2, a3, a4, a5) => (dynCall_viiidi = Module["dynCall_viiidi"] = wasmExports["dynCall_viiidi"])(a0, a1, a2, a3, a4, a5)); @@ -9711,6 +9716,10 @@ var getUsdModule = ((args) => { (dynCall_viiiiiiid = Module["dynCall_viiiiiiid"] = wasmExports["dynCall_viiiiiiid"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + var dynCall_viiffi = (Module["dynCall_viiffi"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_viiffi = Module["dynCall_viiffi"] = + wasmExports["dynCall_viiffi"])(a0, a1, a2, a3, a4, a5)); + var dynCall_jiij = (Module["dynCall_jiij"] = (a0, a1, a2, a3, a4) => (dynCall_jiij = Module["dynCall_jiij"] = wasmExports["dynCall_jiij"])( a0, @@ -9755,6 +9764,13 @@ var getUsdModule = ((args) => { a12, )); + var dynCall_vif = (Module["dynCall_vif"] = (a0, a1, a2) => + (dynCall_vif = Module["dynCall_vif"] = wasmExports["dynCall_vif"])( + a0, + a1, + a2, + )); + var dynCall_jif = (Module["dynCall_jif"] = (a0, a1, a2) => (dynCall_jif = Module["dynCall_jif"] = wasmExports["dynCall_jif"])( a0, @@ -9775,12 +9791,13 @@ var getUsdModule = ((args) => { (dynCall_vfiiii = Module["dynCall_vfiiii"] = wasmExports["dynCall_vfiiii"])(a0, a1, a2, a3, a4, a5)); - var dynCall_ifii = (Module["dynCall_ifii"] = (a0, a1, a2, a3) => - (dynCall_ifii = Module["dynCall_ifii"] = wasmExports["dynCall_ifii"])( + var dynCall_vidii = (Module["dynCall_vidii"] = (a0, a1, a2, a3, a4) => + (dynCall_vidii = Module["dynCall_vidii"] = wasmExports["dynCall_vidii"])( a0, a1, a2, a3, + a4, )); var dynCall_jiiijji = (Module["dynCall_jiiijji"] = ( @@ -9797,15 +9814,6 @@ var getUsdModule = ((args) => { (dynCall_jiiijji = Module["dynCall_jiiijji"] = wasmExports["dynCall_jiiijji"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); - var dynCall_viiif = (Module["dynCall_viiif"] = (a0, a1, a2, a3, a4) => - (dynCall_viiif = Module["dynCall_viiif"] = wasmExports["dynCall_viiif"])( - a0, - a1, - a2, - a3, - a4, - )); - var dynCall_iiiiiiiiiiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiiiiiiiiiii"] = ( a0, @@ -9853,7 +9861,7 @@ var getUsdModule = ((args) => { a19, )); - var dynCall_viiiiiiiiii = (Module["dynCall_viiiiiiiiii"] = ( + var dynCall_viiiiiiiiiiii = (Module["dynCall_viiiiiiiiiiii"] = ( a0, a1, a2, @@ -9865,9 +9873,11 @@ var getUsdModule = ((args) => { a8, a9, a10, + a11, + a12, ) => - (dynCall_viiiiiiiiii = Module["dynCall_viiiiiiiiii"] = - wasmExports["dynCall_viiiiiiiiii"])( + (dynCall_viiiiiiiiiiii = Module["dynCall_viiiiiiiiiiii"] = + wasmExports["dynCall_viiiiiiiiiiii"])( a0, a1, a2, @@ -9879,6 +9889,8 @@ var getUsdModule = ((args) => { a8, a9, a10, + a11, + a12, )); var dynCall_viiiiiiiii = (Module["dynCall_viiiiiiiii"] = ( @@ -9988,7 +10000,7 @@ var getUsdModule = ((args) => { a5, )); - var dynCall_iiiiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiiiii"] = ( + var dynCall_viiiiiiiiii = (Module["dynCall_viiiiiiiiii"] = ( a0, a1, a2, @@ -10000,12 +10012,9 @@ var getUsdModule = ((args) => { a8, a9, a10, - a11, - a12, - a13, ) => - (dynCall_iiiiiiiiiiiiii = Module["dynCall_iiiiiiiiiiiiii"] = - wasmExports["dynCall_iiiiiiiiiiiiii"])( + (dynCall_viiiiiiiiii = Module["dynCall_viiiiiiiiii"] = + wasmExports["dynCall_viiiiiiiiii"])( a0, a1, a2, @@ -10017,12 +10026,9 @@ var getUsdModule = ((args) => { a8, a9, a10, - a11, - a12, - a13, )); - var dynCall_iiddddddiiii = (Module["dynCall_iiddddddiiii"] = ( + var dynCall_iiiiiiiiiiiiii = (Module["dynCall_iiiiiiiiiiiiii"] = ( a0, a1, a2, @@ -10035,9 +10041,11 @@ var getUsdModule = ((args) => { a9, a10, a11, + a12, + a13, ) => - (dynCall_iiddddddiiii = Module["dynCall_iiddddddiiii"] = - wasmExports["dynCall_iiddddddiiii"])( + (dynCall_iiiiiiiiiiiiii = Module["dynCall_iiiiiiiiiiiiii"] = + wasmExports["dynCall_iiiiiiiiiiiiii"])( a0, a1, a2, @@ -10050,6 +10058,8 @@ var getUsdModule = ((args) => { a9, a10, a11, + a12, + a13, )); var dynCall_iidiiiii = (Module["dynCall_iidiiiii"] = ( @@ -10102,13 +10112,6 @@ var getUsdModule = ((args) => { a3, )); - var dynCall_idi = (Module["dynCall_idi"] = (a0, a1, a2) => - (dynCall_idi = Module["dynCall_idi"] = wasmExports["dynCall_idi"])( - a0, - a1, - a2, - )); - var dynCall_fiiid = (Module["dynCall_fiiid"] = (a0, a1, a2, a3, a4) => (dynCall_fiiid = Module["dynCall_fiiid"] = wasmExports["dynCall_fiiid"])( a0, @@ -10280,15 +10283,6 @@ var getUsdModule = ((args) => { (dynCall_iiiddi = Module["dynCall_iiiddi"] = wasmExports["dynCall_iiiddi"])(a0, a1, a2, a3, a4, a5)); - var dynCall_iiidd = (Module["dynCall_iiidd"] = (a0, a1, a2, a3, a4) => - (dynCall_iiidd = Module["dynCall_iiidd"] = wasmExports["dynCall_iiidd"])( - a0, - a1, - a2, - a3, - a4, - )); - var dynCall_iiiif = (Module["dynCall_iiiif"] = (a0, a1, a2, a3, a4) => (dynCall_iiiif = Module["dynCall_iiiif"] = wasmExports["dynCall_iiiif"])( a0, @@ -10298,9 +10292,6 @@ var getUsdModule = ((args) => { a4, )); - var dynCall_fi = (Module["dynCall_fi"] = (a0, a1) => - (dynCall_fi = Module["dynCall_fi"] = wasmExports["dynCall_fi"])(a0, a1)); - var dynCall_did = (Module["dynCall_did"] = (a0, a1, a2) => (dynCall_did = Module["dynCall_did"] = wasmExports["dynCall_did"])( a0, @@ -10325,6 +10316,15 @@ var getUsdModule = ((args) => { (dynCall_iiidddii = Module["dynCall_iiidddii"] = wasmExports["dynCall_iiidddii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + var dynCall_iidii = (Module["dynCall_iidii"] = (a0, a1, a2, a3, a4) => + (dynCall_iidii = Module["dynCall_iidii"] = wasmExports["dynCall_iidii"])( + a0, + a1, + a2, + a3, + a4, + )); + var dynCall_didii = (Module["dynCall_didii"] = (a0, a1, a2, a3, a4) => (dynCall_didii = Module["dynCall_didii"] = wasmExports["dynCall_didii"])( a0, @@ -10370,8 +10370,8 @@ var getUsdModule = ((args) => { a3, )); - var dynCall_viij = (Module["dynCall_viij"] = (a0, a1, a2, a3, a4) => - (dynCall_viij = Module["dynCall_viij"] = wasmExports["dynCall_viij"])( + var dynCall_viji = (Module["dynCall_viji"] = (a0, a1, a2, a3, a4) => + (dynCall_viji = Module["dynCall_viji"] = wasmExports["dynCall_viji"])( a0, a1, a2, @@ -10379,8 +10379,8 @@ var getUsdModule = ((args) => { a4, )); - var dynCall_viji = (Module["dynCall_viji"] = (a0, a1, a2, a3, a4) => - (dynCall_viji = Module["dynCall_viji"] = wasmExports["dynCall_viji"])( + var dynCall_viij = (Module["dynCall_viij"] = (a0, a1, a2, a3, a4) => + (dynCall_viij = Module["dynCall_viij"] = wasmExports["dynCall_viij"])( a0, a1, a2, @@ -10398,26 +10398,17 @@ var getUsdModule = ((args) => { a5, )); - var dynCall_iiijj = (Module["dynCall_iiijj"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - ) => - (dynCall_iiijj = Module["dynCall_iiijj"] = wasmExports["dynCall_iiijj"])( + var dynCall_jiiij = (Module["dynCall_jiiij"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_jiiij = Module["dynCall_jiiij"] = wasmExports["dynCall_jiiij"])( a0, a1, a2, a3, a4, a5, - a6, )); - var dynCall_iiijji = (Module["dynCall_iiijji"] = ( + var dynCall_iiijj = (Module["dynCall_iiijj"] = ( a0, a1, a2, @@ -10425,17 +10416,15 @@ var getUsdModule = ((args) => { a4, a5, a6, - a7, ) => - (dynCall_iiijji = Module["dynCall_iiijji"] = - wasmExports["dynCall_iiijji"])(a0, a1, a2, a3, a4, a5, a6, a7)); - - var dynCall_vij = (Module["dynCall_vij"] = (a0, a1, a2, a3) => - (dynCall_vij = Module["dynCall_vij"] = wasmExports["dynCall_vij"])( + (dynCall_iiijj = Module["dynCall_iiijj"] = wasmExports["dynCall_iiijj"])( a0, a1, a2, a3, + a4, + a5, + a6, )); var dynCall_vijji = (Module["dynCall_vijji"] = ( @@ -10487,16 +10476,7 @@ var getUsdModule = ((args) => { (dynCall_iiiiddd = Module["dynCall_iiiiddd"] = wasmExports["dynCall_iiiiddd"])(a0, a1, a2, a3, a4, a5, a6)); - var dynCall_vidii = (Module["dynCall_vidii"] = (a0, a1, a2, a3, a4) => - (dynCall_vidii = Module["dynCall_vidii"] = wasmExports["dynCall_vidii"])( - a0, - a1, - a2, - a3, - a4, - )); - - var dynCall_vidiiii = (Module["dynCall_vidiiii"] = ( + var dynCall_idiiiiii = (Module["dynCall_idiiiiii"] = ( a0, a1, a2, @@ -10504,8 +10484,35 @@ var getUsdModule = ((args) => { a4, a5, a6, + a7, ) => - (dynCall_vidiiii = Module["dynCall_vidiiii"] = + (dynCall_idiiiiii = Module["dynCall_idiiiiii"] = + wasmExports["dynCall_idiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + + var dynCall_idiiiiiii = (Module["dynCall_idiiiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_idiiiiiii = Module["dynCall_idiiiiiii"] = + wasmExports["dynCall_idiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + + var dynCall_vidiiii = (Module["dynCall_vidiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_vidiiii = Module["dynCall_vidiiii"] = wasmExports["dynCall_vidiiii"])(a0, a1, a2, a3, a4, a5, a6)); var dynCall_vidiii = (Module["dynCall_vidiii"] = (a0, a1, a2, a3, a4, a5) => @@ -10528,33 +10535,6 @@ var getUsdModule = ((args) => { a4, )); - var dynCall_idiiiiii = (Module["dynCall_idiiiiii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - ) => - (dynCall_idiiiiii = Module["dynCall_idiiiiii"] = - wasmExports["dynCall_idiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7)); - - var dynCall_idiiiiiii = (Module["dynCall_idiiiiiii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - a8, - ) => - (dynCall_idiiiiiii = Module["dynCall_idiiiiiii"] = - wasmExports["dynCall_idiiiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); - var dynCall_iiiidiiii = (Module["dynCall_iiiidiiii"] = ( a0, a1, @@ -10599,15 +10579,47 @@ var getUsdModule = ((args) => { a11, )); - var dynCall_iiiff = (Module["dynCall_iiiff"] = (a0, a1, a2, a3, a4) => - (dynCall_iiiff = Module["dynCall_iiiff"] = wasmExports["dynCall_iiiff"])( + var dynCall_vjiiii = (Module["dynCall_vjiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + ) => + (dynCall_vjiiii = Module["dynCall_vjiiii"] = + wasmExports["dynCall_vjiiii"])(a0, a1, a2, a3, a4, a5, a6)); + + var dynCall_ij = (Module["dynCall_ij"] = (a0, a1, a2) => + (dynCall_ij = Module["dynCall_ij"] = wasmExports["dynCall_ij"])( + a0, + a1, + a2, + )); + + var dynCall_vij = (Module["dynCall_vij"] = (a0, a1, a2, a3) => + (dynCall_vij = Module["dynCall_vij"] = wasmExports["dynCall_vij"])( a0, a1, a2, a3, - a4, )); + var dynCall_vijiiiii = (Module["dynCall_vijiiiii"] = ( + a0, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + ) => + (dynCall_vijiiiii = Module["dynCall_vijiiiii"] = + wasmExports["dynCall_vijiiiii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); + var dynCall_viiiiiiiiiii = (Module["dynCall_viiiiiiiiiii"] = ( a0, a1, @@ -10646,12 +10658,14 @@ var getUsdModule = ((args) => { a3, )); - var dynCall_vidi = (Module["dynCall_vidi"] = (a0, a1, a2, a3) => - (dynCall_vidi = Module["dynCall_vidi"] = wasmExports["dynCall_vidi"])( + var dynCall_fi = (Module["dynCall_fi"] = (a0, a1) => + (dynCall_fi = Module["dynCall_fi"] = wasmExports["dynCall_fi"])(a0, a1)); + + var dynCall_fii = (Module["dynCall_fii"] = (a0, a1, a2) => + (dynCall_fii = Module["dynCall_fii"] = wasmExports["dynCall_fii"])( a0, a1, a2, - a3, )); var dynCall_viiiiiiiiiiiii = (Module["dynCall_viiiiiiiiiiiii"] = ( @@ -10720,6 +10734,16 @@ var getUsdModule = ((args) => { (dynCall_viidii = Module["dynCall_viidii"] = wasmExports["dynCall_viidii"])(a0, a1, a2, a3, a4, a5)); + var dynCall_vjiii = (Module["dynCall_vjiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_vjiii = Module["dynCall_vjiii"] = wasmExports["dynCall_vjiii"])( + a0, + a1, + a2, + a3, + a4, + a5, + )); + var dynCall_viiiijii = (Module["dynCall_viiiijii"] = ( a0, a1, @@ -10734,7 +10758,7 @@ var getUsdModule = ((args) => { (dynCall_viiiijii = Module["dynCall_viiiijii"] = wasmExports["dynCall_viiiijii"])(a0, a1, a2, a3, a4, a5, a6, a7, a8)); - var dynCall_viiijjii = (Module["dynCall_viiijjii"] = ( + var dynCall_iiiijjii = (Module["dynCall_iiiijjii"] = ( a0, a1, a2, @@ -10746,8 +10770,8 @@ var getUsdModule = ((args) => { a8, a9, ) => - (dynCall_viiijjii = Module["dynCall_viiijjii"] = - wasmExports["dynCall_viiijjii"])( + (dynCall_iiiijjii = Module["dynCall_iiiijjii"] = + wasmExports["dynCall_iiiijjii"])( a0, a1, a2, @@ -10760,57 +10784,18 @@ var getUsdModule = ((args) => { a9, )); - var dynCall_iiiijjii = (Module["dynCall_iiiijjii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - a8, - a9, - ) => - (dynCall_iiiijjii = Module["dynCall_iiiijjii"] = - wasmExports["dynCall_iiiijjii"])( + var dynCall_jjiii = (Module["dynCall_jjiii"] = (a0, a1, a2, a3, a4, a5) => + (dynCall_jjiii = Module["dynCall_jjiii"] = wasmExports["dynCall_jjiii"])( a0, a1, a2, a3, a4, a5, - a6, - a7, - a8, - a9, )); - var dynCall_viiijii = (Module["dynCall_viiijii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - ) => - (dynCall_viiijii = Module["dynCall_viiijii"] = - wasmExports["dynCall_viiijii"])(a0, a1, a2, a3, a4, a5, a6, a7)); - - var dynCall_iiiijii = (Module["dynCall_iiiijii"] = ( - a0, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - ) => - (dynCall_iiiijii = Module["dynCall_iiiijii"] = - wasmExports["dynCall_iiiijii"])(a0, a1, a2, a3, a4, a5, a6, a7)); + var dynCall_j = (Module["dynCall_j"] = (a0) => + (dynCall_j = Module["dynCall_j"] = wasmExports["dynCall_j"])(a0)); var dynCall_ddiiiii = (Module["dynCall_ddiiiii"] = ( a0, @@ -10824,24 +10809,6 @@ var getUsdModule = ((args) => { (dynCall_ddiiiii = Module["dynCall_ddiiiii"] = wasmExports["dynCall_ddiiiii"])(a0, a1, a2, a3, a4, a5, a6)); - var dynCall_iifi = (Module["dynCall_iifi"] = (a0, a1, a2, a3) => - (dynCall_iifi = Module["dynCall_iifi"] = wasmExports["dynCall_iifi"])( - a0, - a1, - a2, - a3, - )); - - var dynCall_iiiij = (Module["dynCall_iiiij"] = (a0, a1, a2, a3, a4, a5) => - (dynCall_iiiij = Module["dynCall_iiiij"] = wasmExports["dynCall_iiiij"])( - a0, - a1, - a2, - a3, - a4, - a5, - )); - var dynCall_jiji = (Module["dynCall_jiji"] = (a0, a1, a2, a3, a4) => (dynCall_jiji = Module["dynCall_jiji"] = wasmExports["dynCall_jiji"])( a0, @@ -10974,9 +10941,9 @@ var getUsdModule = ((args) => { var _asyncify_stop_rewind = () => (_asyncify_stop_rewind = wasmExports["asyncify_stop_rewind"])(); - var ___start_em_js = (Module["___start_em_js"] = 3947564); + var ___start_em_js = (Module["___start_em_js"] = 3906828); - var ___stop_em_js = (Module["___stop_em_js"] = 3948888); + var ___stop_em_js = (Module["___stop_em_js"] = 3908152); function invoke_iii(index, a1, a2) { var sp = stackSave(); @@ -10989,10 +10956,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiii(index, a1, a2, a3) { + function invoke_viiii(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_iiii(index, a1, a2, a3); + dynCall_viiii(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11011,6 +10978,17 @@ var getUsdModule = ((args) => { } } + function invoke_iiii(index, a1, a2, a3) { + var sp = stackSave(); + try { + return dynCall_iiii(index, a1, a2, a3); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + function invoke_ii(index, a1) { var sp = stackSave(); try { @@ -11066,17 +11044,6 @@ var getUsdModule = ((args) => { } } - function invoke_iiiii(index, a1, a2, a3, a4) { - var sp = stackSave(); - try { - return dynCall_iiiii(index, a1, a2, a3, a4); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - function invoke_viii(index, a1, a2, a3) { var sp = stackSave(); try { @@ -11088,10 +11055,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiii(index, a1, a2, a3, a4) { + function invoke_v(index) { var sp = stackSave(); try { - dynCall_viiii(index, a1, a2, a3, a4); + dynCall_v(index); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11099,10 +11066,10 @@ var getUsdModule = ((args) => { } } - function invoke_v(index) { + function invoke_iiiii(index, a1, a2, a3, a4) { var sp = stackSave(); try { - dynCall_v(index); + return dynCall_iiiii(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11110,10 +11077,10 @@ var getUsdModule = ((args) => { } } - function invoke_vid(index, a1, a2) { + function invoke_iiiiiiii(index, a1, a2, a3, a4, a5, a6, a7) { var sp = stackSave(); try { - dynCall_vid(index, a1, a2); + return dynCall_iiiiiiii(index, a1, a2, a3, a4, a5, a6, a7); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11121,10 +11088,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiiiiii(index, a1, a2, a3, a4, a5, a6, a7) { + function invoke_viiiiii(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - return dynCall_iiiiiiii(index, a1, a2, a3, a4, a5, a6, a7); + dynCall_viiiiii(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11132,10 +11099,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiiiii(index, a1, a2, a3, a4, a5, a6) { + function invoke_diiiii(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - dynCall_viiiiii(index, a1, a2, a3, a4, a5, a6); + return dynCall_diiiii(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11187,6 +11154,17 @@ var getUsdModule = ((args) => { } } + function invoke_d(index) { + var sp = stackSave(); + try { + return dynCall_d(index); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + function invoke_viid(index, a1, a2, a3) { var sp = stackSave(); try { @@ -11209,6 +11187,45 @@ var getUsdModule = ((args) => { } } + function invoke_viiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ) { + var sp = stackSave(); + try { + dynCall_viiiiiiiiiiii( + index, + a1, + a2, + a3, + a4, + a5, + a6, + a7, + a8, + a9, + a10, + a11, + a12, + ); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + function invoke_iiid(index, a1, a2, a3) { var sp = stackSave(); try { @@ -11231,10 +11248,10 @@ var getUsdModule = ((args) => { } } - function invoke_di(index, a1) { + function invoke_vid(index, a1, a2) { var sp = stackSave(); try { - return dynCall_di(index, a1); + dynCall_vid(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11242,10 +11259,10 @@ var getUsdModule = ((args) => { } } - function invoke_iid(index, a1, a2) { + function invoke_di(index, a1) { var sp = stackSave(); try { - return dynCall_iid(index, a1, a2); + return dynCall_di(index, a1); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11323,10 +11340,10 @@ var getUsdModule = ((args) => { } } - function invoke_iif(index, a1, a2) { + function invoke_viiid(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_iif(index, a1, a2); + dynCall_viiid(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11334,10 +11351,10 @@ var getUsdModule = ((args) => { } } - function invoke_iidiii(index, a1, a2, a3, a4, a5) { + function invoke_iid(index, a1, a2) { var sp = stackSave(); try { - return dynCall_iidiii(index, a1, a2, a3, a4, a5); + return dynCall_iid(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11345,10 +11362,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiid(index, a1, a2, a3, a4) { + function invoke_iif(index, a1, a2) { var sp = stackSave(); try { - dynCall_viiid(index, a1, a2, a3, a4); + return dynCall_iif(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11356,10 +11373,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiid(index, a1, a2, a3, a4) { + function invoke_iidiii(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - return dynCall_iiiid(index, a1, a2, a3, a4); + return dynCall_iidiii(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11400,21 +11417,10 @@ var getUsdModule = ((args) => { } } - function invoke_fii(index, a1, a2) { - var sp = stackSave(); - try { - return dynCall_fii(index, a1, a2); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - - function invoke_iiffi(index, a1, a2, a3, a4) { + function invoke_iiiid(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_iiffi(index, a1, a2, a3, a4); + return dynCall_iiiid(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11433,10 +11439,10 @@ var getUsdModule = ((args) => { } } - function invoke_diii(index, a1, a2, a3) { + function invoke_iiffi(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_diii(index, a1, a2, a3); + return dynCall_iiffi(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11444,10 +11450,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + function invoke_diii(index, a1, a2, a3) { var sp = stackSave(); try { - dynCall_viiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); + return dynCall_diii(index, a1, a2, a3); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11455,10 +11461,10 @@ var getUsdModule = ((args) => { } } - function invoke_iidii(index, a1, a2, a3, a4) { + function invoke_viiif(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_iidii(index, a1, a2, a3, a4); + dynCall_viiif(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11466,10 +11472,10 @@ var getUsdModule = ((args) => { } } - function invoke_dif(index, a1, a2) { + function invoke_viiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { var sp = stackSave(); try { - return dynCall_dif(index, a1, a2); + dynCall_viiiiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11565,10 +11571,10 @@ var getUsdModule = ((args) => { } } - function invoke_vidi(index, a1, a2, a3) { + function invoke_viiffffi(index, a1, a2, a3, a4, a5, a6, a7) { var sp = stackSave(); try { - dynCall_vidi(index, a1, a2, a3); + dynCall_viiffffi(index, a1, a2, a3, a4, a5, a6, a7); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11576,10 +11582,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiiddddi(index, a1, a2, a3, a4, a5, a6, a7, a8) { + function invoke_vifffi(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - dynCall_viiiddddi(index, a1, a2, a3, a4, a5, a6, a7, a8); + dynCall_vifffi(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11587,10 +11593,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiddi(index, a1, a2, a3, a4, a5) { + function invoke_vfffi(index, a1, a2, a3, a4) { var sp = stackSave(); try { - dynCall_viiddi(index, a1, a2, a3, a4, a5); + dynCall_vfffi(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11598,10 +11604,10 @@ var getUsdModule = ((args) => { } } - function invoke_vidddi(index, a1, a2, a3, a4, a5) { + function invoke_viffffi(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - dynCall_vidddi(index, a1, a2, a3, a4, a5); + dynCall_viffffi(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11609,10 +11615,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiddddi(index, a1, a2, a3, a4, a5, a6, a7) { + function invoke_fid(index, a1, a2) { var sp = stackSave(); try { - dynCall_viiddddi(index, a1, a2, a3, a4, a5, a6, a7); + return dynCall_fid(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11620,10 +11626,10 @@ var getUsdModule = ((args) => { } } - function invoke_fid(index, a1, a2) { + function invoke_iiiiiid(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - return dynCall_fid(index, a1, a2); + return dynCall_iiiiiid(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11631,10 +11637,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiiiid(index, a1, a2, a3, a4, a5, a6) { + function invoke_dif(index, a1, a2) { var sp = stackSave(); try { - return dynCall_iiiiiid(index, a1, a2, a3, a4, a5, a6); + return dynCall_dif(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11642,10 +11648,10 @@ var getUsdModule = ((args) => { } } - function invoke_vif(index, a1, a2) { + function invoke_viddi(index, a1, a2, a3, a4) { var sp = stackSave(); try { - dynCall_vif(index, a1, a2); + dynCall_viddi(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11653,10 +11659,10 @@ var getUsdModule = ((args) => { } } - function invoke_viddi(index, a1, a2, a3, a4) { + function invoke_viiiiiiid(index, a1, a2, a3, a4, a5, a6, a7, a8) { var sp = stackSave(); try { - dynCall_viddi(index, a1, a2, a3, a4); + dynCall_viiiiiiid(index, a1, a2, a3, a4, a5, a6, a7, a8); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11664,10 +11670,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiiiiiid(index, a1, a2, a3, a4, a5, a6, a7, a8) { + function invoke_viiffi(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - dynCall_viiiiiiid(index, a1, a2, a3, a4, a5, a6, a7, a8); + dynCall_viiffi(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11714,6 +11720,17 @@ var getUsdModule = ((args) => { } } + function invoke_vif(index, a1, a2) { + var sp = stackSave(); + try { + dynCall_vif(index, a1, a2); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + function invoke_fif(index, a1, a2) { var sp = stackSave(); try { @@ -11747,10 +11764,10 @@ var getUsdModule = ((args) => { } } - function invoke_ifii(index, a1, a2, a3) { + function invoke_vidii(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_ifii(index, a1, a2, a3); + dynCall_vidii(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -11837,17 +11854,6 @@ var getUsdModule = ((args) => { } } - function invoke_viiif(index, a1, a2, a3, a4) { - var sp = stackSave(); - try { - dynCall_viiif(index, a1, a2, a3, a4); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - function invoke_fi(index, a1) { var sp = stackSave(); try { @@ -11992,43 +11998,6 @@ var getUsdModule = ((args) => { } } - function invoke_iiddddddiiii( - index, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - a8, - a9, - a10, - a11, - ) { - var sp = stackSave(); - try { - return dynCall_iiddddddiiii( - index, - a1, - a2, - a3, - a4, - a5, - a6, - a7, - a8, - a9, - a10, - a11, - ); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - function invoke_iidiiiii(index, a1, a2, a3, a4, a5, a6, a7) { var sp = stackSave(); try { @@ -12106,17 +12075,6 @@ var getUsdModule = ((args) => { } } - function invoke_idi(index, a1, a2) { - var sp = stackSave(); - try { - return dynCall_idi(index, a1, a2); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - function invoke_fiiid(index, a1, a2, a3, a4) { var sp = stackSave(); try { @@ -12285,10 +12243,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiidd(index, a1, a2, a3, a4) { + function invoke_did(index, a1, a2) { var sp = stackSave(); try { - return dynCall_iiidd(index, a1, a2, a3, a4); + return dynCall_did(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12296,10 +12254,10 @@ var getUsdModule = ((args) => { } } - function invoke_did(index, a1, a2) { + function invoke_iiidii(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - return dynCall_did(index, a1, a2); + return dynCall_iiidii(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12307,10 +12265,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiidii(index, a1, a2, a3, a4, a5) { + function invoke_iiiiddd(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - return dynCall_iiidii(index, a1, a2, a3, a4, a5); + return dynCall_iiiiddd(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12329,6 +12287,17 @@ var getUsdModule = ((args) => { } } + function invoke_iidii(index, a1, a2, a3, a4) { + var sp = stackSave(); + try { + return dynCall_iidii(index, a1, a2, a3, a4); + } catch (e) { + stackRestore(sp); + if (e !== e + 0) throw e; + _setThrew(1, 0); + } + } + function invoke_didii(index, a1, a2, a3, a4) { var sp = stackSave(); try { @@ -12386,28 +12355,6 @@ var getUsdModule = ((args) => { } } - function invoke_iiiiddd(index, a1, a2, a3, a4, a5, a6) { - var sp = stackSave(); - try { - return dynCall_iiiiddd(index, a1, a2, a3, a4, a5, a6); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - - function invoke_vidii(index, a1, a2, a3, a4) { - var sp = stackSave(); - try { - dynCall_vidii(index, a1, a2, a3, a4); - } catch (e) { - stackRestore(sp); - if (e !== e + 0) throw e; - _setThrew(1, 0); - } - } - function invoke_vidiiii(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { @@ -12511,10 +12458,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiff(index, a1, a2, a3, a4) { + function invoke_fii(index, a1, a2) { var sp = stackSave(); try { - return dynCall_iiiff(index, a1, a2, a3, a4); + return dynCall_fii(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12620,10 +12567,10 @@ var getUsdModule = ((args) => { } } - function invoke_iifi(index, a1, a2, a3) { + function invoke_viji(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_iifi(index, a1, a2, a3); + dynCall_viji(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12631,10 +12578,10 @@ var getUsdModule = ((args) => { } } - function invoke_j(index) { + function invoke_jiii(index, a1, a2, a3) { var sp = stackSave(); try { - return dynCall_j(index); + return dynCall_jiii(index, a1, a2, a3); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12642,10 +12589,10 @@ var getUsdModule = ((args) => { } } - function invoke_jiii(index, a1, a2, a3) { + function invoke_jiij(index, a1, a2, a3, a4) { var sp = stackSave(); try { - return dynCall_jiii(index, a1, a2, a3); + return dynCall_jiij(index, a1, a2, a3, a4); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12653,10 +12600,10 @@ var getUsdModule = ((args) => { } } - function invoke_jiij(index, a1, a2, a3, a4) { + function invoke_vij(index, a1, a2, a3) { var sp = stackSave(); try { - return dynCall_jiij(index, a1, a2, a3, a4); + dynCall_vij(index, a1, a2, a3); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12686,10 +12633,10 @@ var getUsdModule = ((args) => { } } - function invoke_viji(index, a1, a2, a3, a4) { + function invoke_vijii(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - dynCall_viji(index, a1, a2, a3, a4); + dynCall_vijii(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12697,10 +12644,10 @@ var getUsdModule = ((args) => { } } - function invoke_vijii(index, a1, a2, a3, a4, a5) { + function invoke_iiijj(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - dynCall_vijii(index, a1, a2, a3, a4, a5); + return dynCall_iiijj(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12708,10 +12655,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiijj(index, a1, a2, a3, a4, a5, a6) { + function invoke_jii(index, a1, a2) { var sp = stackSave(); try { - return dynCall_iiijj(index, a1, a2, a3, a4, a5, a6); + return dynCall_jii(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12719,10 +12666,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiijji(index, a1, a2, a3, a4, a5, a6, a7) { + function invoke_vijji(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - return dynCall_iiijji(index, a1, a2, a3, a4, a5, a6, a7); + dynCall_vijji(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12730,10 +12677,10 @@ var getUsdModule = ((args) => { } } - function invoke_vij(index, a1, a2, a3) { + function invoke_jiiij(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - dynCall_vij(index, a1, a2, a3); + return dynCall_jiiij(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12741,10 +12688,10 @@ var getUsdModule = ((args) => { } } - function invoke_jii(index, a1, a2) { + function invoke_viiji(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - return dynCall_jii(index, a1, a2); + dynCall_viiji(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12752,10 +12699,10 @@ var getUsdModule = ((args) => { } } - function invoke_vijji(index, a1, a2, a3, a4, a5, a6) { + function invoke_dj(index, a1, a2) { var sp = stackSave(); try { - dynCall_vijji(index, a1, a2, a3, a4, a5, a6); + return dynCall_dj(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12763,10 +12710,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiji(index, a1, a2, a3, a4, a5) { + function invoke_vjiiii(index, a1, a2, a3, a4, a5, a6) { var sp = stackSave(); try { - dynCall_viiji(index, a1, a2, a3, a4, a5); + dynCall_vjiiii(index, a1, a2, a3, a4, a5, a6); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12774,10 +12721,10 @@ var getUsdModule = ((args) => { } } - function invoke_dj(index, a1, a2) { + function invoke_ij(index, a1, a2) { var sp = stackSave(); try { - return dynCall_dj(index, a1, a2); + return dynCall_ij(index, a1, a2); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12785,10 +12732,10 @@ var getUsdModule = ((args) => { } } - function invoke_iij(index, a1, a2, a3) { + function invoke_vijiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8) { var sp = stackSave(); try { - return dynCall_iij(index, a1, a2, a3); + dynCall_vijiiiii(index, a1, a2, a3, a4, a5, a6, a7, a8); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12796,10 +12743,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiiijii(index, a1, a2, a3, a4, a5, a6, a7, a8) { + function invoke_iij(index, a1, a2, a3) { var sp = stackSave(); try { - dynCall_viiiijii(index, a1, a2, a3, a4, a5, a6, a7, a8); + return dynCall_iij(index, a1, a2, a3); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12807,10 +12754,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + function invoke_vjiii(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - dynCall_viiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + dynCall_vjiii(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12818,10 +12765,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { + function invoke_viiiijii(index, a1, a2, a3, a4, a5, a6, a7, a8) { var sp = stackSave(); try { - return dynCall_iiiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); + dynCall_viiiijii(index, a1, a2, a3, a4, a5, a6, a7, a8); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12829,10 +12776,10 @@ var getUsdModule = ((args) => { } } - function invoke_viiijii(index, a1, a2, a3, a4, a5, a6, a7) { + function invoke_iiiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9) { var sp = stackSave(); try { - dynCall_viiijii(index, a1, a2, a3, a4, a5, a6, a7); + return dynCall_iiiijjii(index, a1, a2, a3, a4, a5, a6, a7, a8, a9); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12840,10 +12787,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiijii(index, a1, a2, a3, a4, a5, a6, a7) { + function invoke_jjiii(index, a1, a2, a3, a4, a5) { var sp = stackSave(); try { - return dynCall_iiiijii(index, a1, a2, a3, a4, a5, a6, a7); + return dynCall_jjiii(index, a1, a2, a3, a4, a5); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e; @@ -12851,10 +12798,10 @@ var getUsdModule = ((args) => { } } - function invoke_iiiij(index, a1, a2, a3, a4, a5) { + function invoke_j(index) { var sp = stackSave(); try { - return dynCall_iiiij(index, a1, a2, a3, a4, a5); + return dynCall_j(index); } catch (e) { stackRestore(sp); if (e !== e + 0) throw e;