[ { "path": ".gitignore", "content": ".venv*\n.nox\ndist\n__pycache__\n*.pyc\nusd/stubs/**/__DOC.pyi\nusd/stubs/**/_[a-z]*.pyi\n*.egg-info\n.env\n\n# moon\n.moon/cache\n.moon/docker\n" }, { "path": ".moon/hooks/pre-commit.sh", "content": "#!/usr/bin/env bash\nset -eo pipefail\n\n# Automatically generated by moon. DO NOT MODIFY!\n# https://moonrepo.dev/docs/guides/vcs-hooks\n\nmoon run common:black --affected\n\n" }, { "path": ".moon/tasks/tag-stubs.yml", "content": "tasks:\n generate:\n description: 'Create the stubs'\n command: 'generate'\n inputs:\n - 'stubgen_*'\n\n publish:\n description: 'Publish the stub package to PyPI'\n deps: ['~:generate']\n command: 'publish'\n inputs:\n - 'pyproject.toml'\n - 'README.md'\n\n develop:\n description: 'Install the stubs into the current venv'\n command: 'develop'\n" }, { "path": ".moon/tasks.yml", "content": "tasks:\n mypy:\n script: uv run mypy\n\n mypy-silent:\n # don't use uv run because we do NOT want the real library present in the venv.\n # specificallly target ./stubs to silencing errors in tests, etc\n script: uvx mypy ./stubs | uvx mypy-silent\n\n generate:\n script: ./stubgen_${project}.sh\n\n build:\n script: uv build --wheel\n\n publish:\n script: uv publish\n deps: [^:build]\n\n format:\n script: uvx ruff==0.11.13 format --exit-non-zero-on-format\n\n check:\n script: uvx ruff==0.11.13 check --fix --exit-non-zero-on-fix\n\n lint:\n deps: [format, check]\n\n test:\n script: uv run pytest tests\n" }, { "path": ".moon/toolchain.yml", "content": "python:\n# rootRequirementsOnly: true\n version: '3.11.10'\n pip: {}\n" }, { "path": ".moon/workspace.yml", "content": "# https://moonrepo.dev/docs/config/workspace\n$schema: 'https://moonrepo.dev/schemas/workspace.json'\n\n# Require a specific version of moon while running commands, otherwise fail.\n# versionConstraint: '>=1.0.0'\n\n# Extend and inherit an external configuration file. Must be a valid HTTPS URL or file system path.\n# extends: './shared/workspace.yml'\n\n# REQUIRED: A map of all projects found within the workspace, or a list or file system globs.\n# When using a map, each entry requires a unique project ID as the map key, and a file system\n# path to the project folder as the map value. File paths are relative from the workspace root,\n# and cannot reference projects located outside the workspace boundary.\nprojects:\n - '.'\n - '*/moon.yml'\n\nvcs:\n hooks:\n pre-commit:\n - 'moon run :lint'\n" }, { "path": ".pre-commit-config.yaml", "content": "\nrepos:\n- repo: local\n hooks:\n\n - id: precommit_gen\n name: precommit_gen\n entry: nox\n args: [-s, precommit_gen, --no-install, --]\n language: system\n pass_filenames: false\n require_serial: false\n stages: [commit, push]\n files: ^noxfile[.]py$\n" }, { "path": "LICENSE.txt", "content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\n TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n 1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n 2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n 3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n 4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n 5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n 6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n 7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n 8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n 9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\n END OF TERMS AND CONDITIONS\n\n APPENDIX: How to apply the Apache License to your work.\n\n To apply the Apache License to your work, attach the following\n boilerplate notice, with the fields enclosed by brackets \"[]\"\n replaced with your own identifying information. (Don't include\n the brackets!) The text should be enclosed in the appropriate\n comment syntax for the file format. We also recommend that a\n file or class name and description of purpose be included on the\n same \"printed page\" as the copyright notice for easier\n identification within third-party archives.\n\n Copyright [yyyy] [name of copyright owner]\n\n Licensed under the Apache License, Version 2.0 (the \"License\");\n you may not use this file except in compliance with the License.\n You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software\n distributed under the License is distributed on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n See the License for the specific language governing permissions and\n limitations under the License.\n" }, { "path": "README.md", "content": "# CG Stubs\n\n## Python stubs for VFX and Animation\n\nThese stubs are intended to be used with a type checker like [`mypy`](https://mypy.readthedocs.io/en/stable/) to provide [static type checking](https://realpython.com/python-type-checking/) of python code, as well as analysis and completion in IDEs like PyCharm and VSCode with Pylance.\n\nSupported libraries and applications:\n\n- [USD](https://pypi.org/project/types-usd/)\n- [houdini](https://pypi.org/project/types-houdini/)\n- [katana](https://pypi.org/project/types-katana/)\n- [mari](https://pypi.org/project/types-mari/)\n- [maya](https://pypi.org/project/types-maya-strict/)\n- [nuke](https://pypi.org/project/types-nuke/)\n- [opencolorio](https://pypi.org/project/types-opencolorio/)\n- [PySide2](https://pypi.org/project/types-PySide2/)\n- [substance_painter](https://pypi.org/project/types-substance_painter/)\n\nNote that [pymel](https://pypi.org/project/pymel/) now has very excellent stubs included (more info [here](https://dev.to/chadrik/pymels-new-type-stubs-2die)).\n\n## Installing\n\nThese are distributed as \"stubs-only\" python packages, so you can just `pip install` whichever packages you need:\n\n```\npip install types-usd types-houdini types-katana types-mari types-nuke types-opencolorio types-PySide2 types-substance_painter\n```\n\n## Generating the stubs\n\nYou only need to do this if your goal is to help improve the stubs. Otherwise, just use `pip`,\nas explained above.\n\nBuilding the stubs requires python 3.9 or greater.\n\n### Step 1: Install `uv`\n\nYou can do this using [`pipx`](https://github.com/pypa/pipx):\n\n```bash\npipx install uv\n```\n\n### Step 2: Configure your environment\n\nLook at the `.env` file within the project that you want to build. Either uncomment the necessary\nenvironment variables and paste in the proper values, or configure your shell environment to set\nthese variables before the next step, for example using a package manager like `rez`.\n\n### Step 3: Run the generate task\n\nReplace `maya` with the project you want to build:\n\n```bash\nuv run --dev nox -s 'generate(maya)'\n```\n\n> [!NOTE]\n> Some generators have extra options. For example, you can generate stubs for\n> specific Maya versions by running `nox -s 'generate(maya) --\n> --maya-version=2025`. See each individual subfolders to learn more.\n\n\n### Testing while Developing\n\nThe easiest way to use the stubs while you're developing them is to create an editable install.\nSimply create a `.pth` file in the site-packages directory of the venv where your other deps live:\n\n```\necho \"/path/to/cg-stubs/maya/stubs/\" > /path/to/venv/lib/python3.7/site-packages/maya.pth\n```\n\nThe name of the .pth file does not matter.\nNote that if you're using the mypy daemon, be sure to run `dmypy stop` to reread freshly modified stubs.\n\n### Generating the USD stubs\n\nThe USD stubs currently require you to build a special fork of USD, until the necessary changes are merged.\n\n```\ngit clone https://github.com/chadrik/USD\ngit checkout doc-stubs2\npython3.9 -m venv .venv\n. .venv/bin/activate\npip install PySide6 PyOpenGL\npython3.9 build_scripts/build_usd.py --python-docs --docs .build-23.08-py39\n```\n\nThen update the variables in `stubgen_usd.sh` and generate as normal.\n\n### Generating the Substance Painter stubs\n\nThese must be generated from within the UI, because I could not figure out how to run a standlone interpreter.\n\n```\nimport mypy.stubgen;mypy.stubgen.main(['-p', '_substance_painter'])\n```\n\nThen generate as normal to cleanup the stubs.\n\n[Detailed instructions here](/substance_painter/README.md).\n\n## Publishing to PyPI\n\nTo publish to pypi.org, first run the nox installation steps from the Generating section, then run\nthe `publish` task (replacing `maya` with the package to publish):\n\n```\nnox -s 'publish(maya)'\n```\n\n> [!NOTE]\n> Publishing to PyPI requires an [API token](https://pypi.org/help/#apitoken).\n>\n> the `nox -s 'publish(xyz)'` command will forward additional arguments through to the underlying `uv publish` command, so passing in `--token ` will work for authentication. Example: `nox -s 'publish(maya)' -- --token TOKEN`\n>\n> Since `uv publish` also [currently does not support `~/.pypirc`](https://github.com/astral-sh/uv/issues/7676) , the token must be copied in during the publish command itself.\n>\n> If the token is not provided on the command line, since the password field does not display the token after pasting, it is important that the pasted token does not include any newlines or control characters.\n" }, { "path": "common/moon.yml", "content": "type: 'library'\n" }, { "path": "common/pyproject.toml", "content": "[project]\nname = \"stubgenlib\"\nversion = \"0.3.0\"\n\ndependencies = [\n \"mypy >= 1.15.0, < 1.20.0\",\n \"typeguard\",\n]\n\n#readme = \"README.md\"\nauthors = [{name=\"Chad Dombrova\"}]\ndescription = \"Utilities for improving the output of mypy's stubgen tool\"\nlicense = \"MIT\"\n\nclassifiers = [\n \"Development Status :: 4 - Beta\",\n \"Programming Language :: Python :: 2\",\n \"Programming Language :: Python :: 3\",\n \"License :: OSI Approved :: MIT License\",\n \"Operating System :: OS Independent\",\n \"Intended Audience :: Developers\",\n]\nrepository = \"https://github.com/LumaPictures/cg-stubs\"\nhomepage = \"https://github.com/LumaPictures/cg-stubs\"\n\nkeywords = [\"mypy\", \"typing\", \"stubs\"]\n\n[dependency-groups]\ndev = [\n \"pytest\",\n]\n\n[build-system]\nrequires = [\"hatchling\"]\nbuild-backend = \"hatchling.build\"\n\n\n[tool.mypy]\nfollow_imports = \"silent\"\ncheck_untyped_defs = true\nfiles = [\"src\", \"tests\"]\n\n#[mypy-PySide2.*]\n#ignore_missing_imports = true\n#\n#[mypy-lark.*]\n#ignore_missing_imports =\n" }, { "path": "common/src/stubgenlib/__init__.py", "content": "from __future__ import absolute_import, print_function\n" }, { "path": "common/src/stubgenlib/build.py", "content": "from __future__ import absolute_import, print_function\n\nimport pathlib\n\n\ndef add_stubs_suffix(path: pathlib.Path) -> None:\n \"\"\"Add a -stubs suffix to packages prior to building.\n\n This ensures that they are PEP 561 compatible when we distribute them, but\n will be found by mypy as a normal package.\n \"\"\"\n import shutil\n\n # do these at the end to improve time to git refresh\n to_delete = []\n for child in path.iterdir():\n if child.is_dir() and not child.name.endswith(\"-stubs\"):\n name = child.stem + \"-stubs\"\n newpath = child.with_name(name)\n if newpath.exists():\n backup = newpath.with_suffix(\".bak\")\n newpath.rename(backup)\n to_delete.append(backup)\n print(f\"Renaming to {newpath}\")\n child.rename(newpath)\n marker = newpath / \"py.typed\"\n marker.touch()\n\n for dir in to_delete:\n shutil.rmtree(dir)\n" }, { "path": "common/src/stubgenlib/cpptypeconvert.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nimport pathlib\nimport re\nfrom functools import lru_cache\nfrom typing import Iterator\n\n\nclass CppTypeConverter:\n IDENTIFIER = r\"([a-zA-Z_][a-zA-Z0-9_]*)\"\n TYPE_DEF_INCLUDES: list[str] = []\n\n STRIP = r\"\\b(?:const|friend|constexpr|class)\\b\"\n ARG_TYPE_MAP = [\n (r\"\\bstd::vector\\b\", \"typing.Iterable\"),\n (r\"\\bstd::set\\b\", \"typing.Iterable\"),\n (r\"\\bstd::unordered_set\\b\", \"typing.Iterable\"),\n ]\n RESULT_TYPE_MAP = [\n (r\"\\bstd::vector\\b\", \"list\"),\n (r\"\\bstd::set\\b\", \"list\"),\n (r\"\\bstd::unordered_set\\b\", \"list\"),\n ]\n TYPE_MAP = [\n (r\"\\bstd::string\\b\", \"str\"),\n (r\"\\bstd::map\\b\", \"dict\"),\n (r\"\\bstd::unordered_map\\b\", \"dict\"),\n (r\"\\bstd::unique_ptr\\b\", \"\"),\n (r\"\\bstd::ostream\\b\", \"typing.TextIO\"),\n (r\"\\bstring\\b\", \"str\"),\n (r\"\\bsize_t\\b\", \"int\"),\n (r\"\\bint64\\b\", \"int\"),\n (r\"\\bshort\\b\", \"int\"),\n (r\"\\bchar\\b\", \"str\"),\n # note that argname gets stripped. see stubgen_usd.test\n (\n r\"\\bstd::function\\s*<\\s*(?P.+)\\(\\s*(?P\\w+)(?P.*)\\)>\",\n r\"typing.Callable[[\\g], \\g]\",\n ),\n (r\"\\bstd::pair\\b\", \"tuple\"),\n (r\"\\bdouble\\b\", \"float\"),\n (r\"\\bvoid\\b\", \"None\"),\n ]\n RENAMES: list[tuple[str, str]] = []\n\n def __init__(\n self,\n srcdir: str | None = None,\n verbose: bool = False,\n ) -> None:\n self.srcdir = srcdir\n self._typedefs: list[tuple[str, str]] | None = None\n self.verbose = verbose\n\n self._typedef_reg = re.compile(r\"\\btypedef ([^;]+);\")\n self._using_reg = re.compile(\n r\"\\busing\\s+([a-zA-Z_][a-zA-Z0-9_]*)\\s*=\\s*([^;]+);\"\n )\n\n def _get_typedefs(self) -> list[tuple[str, str]]:\n if not self.srcdir:\n return []\n\n if self._typedefs is None:\n self._typedefs = []\n\n srcdir = pathlib.Path(self.srcdir)\n for include_file in self.TYPE_DEF_INCLUDES:\n for alias, type in self._parse_typedefs(srcdir.joinpath(include_file)):\n self._typedefs.append((alias, type))\n\n return self._typedefs\n\n def _parse_typedefs(self, include_file: pathlib.Path) -> Iterator[tuple[str, str]]:\n text = include_file.read_text().replace(\"\\n\", \" \")\n for match in self._typedef_reg.finditer(text):\n typedef_str = match.group(1)\n type, alias = typedef_str.rsplit(\" \", 1)\n alias = alias.replace(\" \", \"\")\n type = type.strip()\n # fixup type. kinda ugly, but it's easier to do it now before types are\n # full expanded\n if type.startswith(\"std::unordered_map<\"):\n parts = type.split(\",\")\n if len(parts) == 3:\n type = \",\".join(parts[:-1]) + \">\"\n yield alias, type\n for match in self._using_reg.finditer(text):\n alias = match.group(1).strip()\n type = match.group(2).strip()\n yield alias, type\n\n def _replace_typedefs(self, typestr: str) -> str:\n typedefs = self._get_typedefs()\n if not typedefs:\n return typestr\n\n def replace_typedefs(typ: str) -> str:\n for alias, replace in typedefs:\n typ = re.sub(rf\"\\b{alias}\\b\", replace, typ)\n return typ\n\n replacements = [typestr]\n while True:\n new_typestr = replace_typedefs(typestr)\n if new_typestr == typestr:\n break\n replacements.append(new_typestr)\n typestr = new_typestr\n if len(replacements) > 1:\n chain = \" >> \".join(repr(r) for r in replacements)\n print(f\"Typedef resolution: {chain}\")\n return typestr\n\n @lru_cache\n def cpp_arg_to_py_type(self, cpp_type: str, is_result: bool) -> str:\n \"\"\"\n Convert a c++ type string to a python type string\n\n Returns the new typestring and whether the type appears to be a return value\n \"\"\"\n typestr = cpp_type\n is_ptr = \"*\" in typestr\n\n typestr = self._replace_typedefs(typestr)\n\n parts = typestr.split()\n\n # remove extraneous bits\n parts = [\n re.sub(self.STRIP, \"\", x).replace(\"*\", \"\").replace(\"&\", \"\").strip()\n for x in parts\n ]\n parts = [x for x in parts if not self.should_strip_part(x)]\n typestr = \" \".join(parts)\n\n renames = dict(self.RENAMES)\n new_typestr = renames.get(typestr.replace(\" \", \"\"))\n if new_typestr is not None:\n return new_typestr\n\n for pattern, replace in self.TYPE_MAP + (\n self.RESULT_TYPE_MAP if is_ptr or is_result else self.ARG_TYPE_MAP\n ):\n typestr = re.sub(pattern, replace, typestr)\n\n # swap container syntax\n typestr = typestr.replace(\"<\", \"[\")\n typestr = typestr.replace(\">\", \"]\")\n\n # convert to python identifers\n parts = [x for x in re.split(self.IDENTIFIER, typestr) if x]\n parts = [(self.to_python_id(x) or x) for x in parts]\n\n typestr = \"\".join(parts)\n typestr = typestr.replace(\"::\", \".\")\n\n typestr = typestr.replace(\" \", \"\")\n typestr = typestr.replace(\",\", \", \")\n\n if is_ptr:\n typestr = self.process_ptr(typestr, is_result)\n return typestr\n\n def process_ptr(self, converted_type: str, is_result: bool) -> str:\n return converted_type\n\n def to_python_id(self, cpp_type: str) -> str:\n return cpp_type\n\n def should_strip_part(self, x: str) -> bool:\n \"\"\"\n whether the part looks like a c++ keyword\n \"\"\"\n return not x\n" }, { "path": "common/src/stubgenlib/moduleinspect.py", "content": "from __future__ import absolute_import, print_function\n\nimport mypy.moduleinspect\n\n\nclass ModuleInspect:\n \"\"\"\n Patch ModuleInspect so that it imports modules directly into the current process rather than\n using multiprocessing.\n \"\"\"\n\n def get_package_properties(\n self, package_id: str\n ) -> mypy.moduleinspect.ModuleProperties:\n return mypy.moduleinspect.get_package_properties(package_id)\n\n def __enter__(self):\n print(\"Bypassing multiprocessing for module inspection\")\n return self\n\n def __exit__(self, exc_type, exc_val, exc_tb):\n return\n\n\ndef patch():\n import mypy.stubgen\n import mypy.stubutil\n\n mypy.moduleinspect.ModuleInspect = ModuleInspect\n mypy.stubutil.ModuleInspect = ModuleInspect\n mypy.stubgen.ModuleInspect = ModuleInspect\n" }, { "path": "common/src/stubgenlib/notifier.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nfrom collections import defaultdict\n\n\nclass Notifier:\n \"\"\"\n Class to display and filter warnings\n \"\"\"\n\n def __init__(self) -> None:\n self._seen_msgs: defaultdict[tuple[str, str, str], int] = defaultdict(int)\n self._seen_keys: defaultdict[str, int] = defaultdict(int)\n self._modules: list[str] | None = None\n self._keys: list[str] | None = None\n\n def set_modules(self, modules: list[str]) -> None:\n self._modules = modules\n\n def set_keys(self, keys: list[str]) -> None:\n self._keys = keys\n\n def warn(self, key: str, module: str, msg: str) -> None:\n if (key, module, msg) not in self._seen_msgs:\n if (self._modules is None or module in self._modules) and (\n self._keys is None or key in self._keys\n ):\n print(f\"({module}) {key}: {msg}\")\n self._seen_msgs[(key, module, msg)] += 1\n self._seen_keys[key] += 1\n\n def accumulate(self, key: str) -> None:\n self._seen_keys[key] += 1\n\n def print_summary(self) -> None:\n print()\n print(\"Warning Summary:\")\n for key in sorted(self._seen_keys):\n count = self._seen_keys[key]\n print(f\" {key}: {count}\")\n\n def get_key_count(self, key: str) -> int:\n return self._seen_keys[key]\n" }, { "path": "common/src/stubgenlib/py.typed", "content": "" }, { "path": "common/src/stubgenlib/siggen/__init__.py", "content": "from __future__ import absolute_import, print_function\n\nfrom .advanced import (\n AdvancedSigMatcher as AdvancedSigMatcher,\n)\nfrom .advanced import (\n AdvancedSignatureGenerator as AdvancedSignatureGenerator,\n)\nfrom .advanced import (\n Optionality as Optionality,\n)\nfrom .boost import BoostDocstringSignatureGenerator as BoostDocstringSignatureGenerator\nfrom .default import DefaultSigGenerator as DefaultSigGenerator\nfrom .docstring import DocstringSignatureGenerator as DocstringSignatureGenerator\nfrom .sigfixer import (\n DocstringTypeFixer as DocstringTypeFixer,\n)\nfrom .sigfixer import (\n SignatureFixer as SignatureFixer,\n)\n" }, { "path": "common/src/stubgenlib/siggen/advanced.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nimport fnmatch\nimport re\nfrom dataclasses import dataclass, field\nfrom typing import Literal, NamedTuple, TypeVar, cast\n\nfrom mypy.stubdoc import infer_sig_from_docstring\nfrom mypy.stubgenc import (\n ArgSig,\n FunctionContext,\n FunctionSig,\n SignatureGenerator,\n)\nfrom mypy.stubgenc import (\n DocstringSignatureGenerator as CDocstringSignatureGenerator,\n)\n\nT = TypeVar(\"T\")\n\n\nclass Optionality(NamedTuple):\n accepts_none: bool\n has_default: bool = True\n\n\n@dataclass\nclass AdvancedSigMatcher(object):\n \"\"\"\n Defines rules for matching objects within inspected modules and correcting\n or overriding their inspected signature.\n \"\"\"\n\n # Full signature replacements.\n # name_pattern: sig_str\n # e.g. \"*.VolatileBool.set\": \"(self, a: object) -> None\"\n signature_overrides: dict[str, str | list[str]] = field(default_factory=dict)\n\n # Override argument types\n # (name_pattern, arg, type): arg_type\n # e.g. (\"*\", \"flags\", \"int\"): \"typing.SupportsInt\"\n arg_type_overrides: dict[tuple[str, str, str | re.Pattern[str] | None], str] = (\n field(default_factory=dict)\n )\n\n # Override result types\n # (name_pattern, type): result_type\n # e.g. (\"*\", \"int\"): \"typing.SupportsInt\"\n result_type_overrides: dict[tuple[str, str | re.Pattern[str] | None], str] = field(\n default_factory=dict\n )\n\n # Override property types\n # (name_pattern, type): type\n # e.g. (\"*\", \"int\"): \"typing.SupportsInt\"\n property_type_overrides: dict[tuple[str, str | re.Pattern[str] | None], str] = (\n field(default_factory=dict)\n )\n\n # Types that have implicit alternatives.\n # type_str: list of types that can be used instead\n # e.g. \"PySide2.QtGui.QKeySequence\": [\"str\"],\n implicit_arg_types: dict[str, list[str]] = field(default_factory=dict)\n\n # Args which should be made Optional[].\n # (name_pattern, arg, type): Optionality\n optional_args: dict[tuple[str, str, str | re.Pattern[str] | None], Optionality] = (\n field(default_factory=dict)\n )\n\n # Results which should be made Optional[].\n optional_result: list[str] = field(default_factory=list)\n\n # Add new overloads to existing functions.\n # name_pattern: list of sig_str\n # e.g. \"*.VolatileBool.set\": [\"(self, a: object) -> None\"]\n new_overloads: dict[str, list[str]] = field(default_factory=dict)\n\n def __post_init__(self) -> None:\n # insert OptionalKeys\n self.arg_type_overrides.update(\n {\n # method, arg name, type\n (\n \"*\",\n \"*\",\n orig,\n ): \"typing.Union[{},{}]\".format(orig, \",\".join(alt))\n for orig, alt in self.implicit_arg_types.items()\n }\n )\n self.arg_type_overrides.update(\n {\n # method, arg name, type\n (\n \"*\",\n \"*\",\n \"typing.Union[{},NoneType]\".format(orig),\n ): \"typing.Union[{},{},NoneType]\".format(orig, \",\".join(alt))\n for orig, alt in self.implicit_arg_types.items()\n }\n )\n # restructure this so that it can be used with find_result_match\n self._optional_result: dict[tuple[str, str | re.Pattern[str] | None], bool] = {\n (name, \"*\"): True for name in self.optional_result\n }\n # self.arg_name_replacements = {\n # tuple(OptionalKey(k) for k in key): value\n # for key, value in self._arg_name_replacements.items()\n # }\n\n def find_func_match(self, fullname: str, items: dict[str, T]) -> T | None:\n \"\"\"Look for a match in the given dictionary of function/method overrides\"\"\"\n for pattern, value in items.items():\n if fnmatch.fnmatchcase(fullname, pattern):\n return value\n return None\n\n def _type_match(\n self,\n type_match: str | re.Pattern[str] | None,\n new_value: T,\n orig_type: str | None,\n ) -> T | None:\n \"\"\"Return the matched type or None if there was no match.\n\n if type_match is a regular expression, the new_value may be altered by subsitutions,\n otherwise the value returned will be new_value.\n \"\"\"\n if orig_type is None:\n return new_value if (type_match is None or type_match == \"*\") else None\n elif isinstance(type_match, re.Pattern):\n if not isinstance(new_value, str):\n raise ValueError(\n f\"{type_match} is a regex, but {repr(new_value)} is not a string\"\n )\n new_type = type_match.sub(new_value, orig_type)\n if new_type != orig_type:\n return cast(\"T | None\", new_type)\n else:\n return None\n elif type_match:\n return new_value if fnmatch.fnmatchcase(orig_type, type_match) else None\n else:\n return None\n\n def find_arg_match(\n self,\n fullname: str,\n arg_name: str,\n arg_type: str | None,\n items: dict[tuple[str, str, str | re.Pattern[str] | None], T],\n ) -> T | None:\n \"\"\"Look for a match in the given dictionary of argument overrides\n\n arg_type : if None means only replace if the type is unset (None).\n items : key is (name_pattern, arg, type). value is whatever we're trying to find.\n \"\"\"\n for (method_match, arg_name_match, arg_type_match), value in items.items():\n if fnmatch.fnmatchcase(fullname, method_match) and fnmatch.fnmatchcase(\n arg_name, arg_name_match\n ):\n new_value = self._type_match(arg_type_match, value, arg_type)\n if new_value is not None:\n return new_value\n return None\n\n def find_result_match(\n self,\n fullname: str,\n ret_type: str | None,\n items: dict[tuple[str, str | re.Pattern[str] | None], T],\n ) -> T | None:\n \"\"\"Look for a match in the given dictionary of argument overrides\"\"\"\n for (method_match, ret_type_match), value in items.items():\n if fnmatch.fnmatchcase(fullname, method_match):\n new_value = self._type_match(ret_type_match, value, ret_type)\n if new_value is not None:\n return new_value\n return None\n\n\n# FIXME: generate a report of rules that were not used atexit.\nclass AdvancedSignatureGenerator(SignatureGenerator):\n \"\"\"\n A signature generator that uses an AdvancedSigMatcher to override all or\n part of a function signature.\n \"\"\"\n\n WHITESPACE_FIX = re.compile(\",(?=\\w)\")\n\n sig_matcher: AdvancedSigMatcher\n\n def __init__(\n self,\n fallback_sig_gen=CDocstringSignatureGenerator(),\n merge_overrides_with_fallback: bool = False,\n select_overload_to_merge: Literal[\"first\", \"by_index\"] = \"first\",\n ) -> None:\n \"\"\"\n fallback_sig_gen: used to find a signature when signature_overrides has no match.\n \"\"\"\n self.fallback_sig_gen = fallback_sig_gen\n self.merge_overrides_with_fallback = merge_overrides_with_fallback\n self.select_overload_to_merge = select_overload_to_merge\n\n def get_signature_str(self, ctx: FunctionContext) -> str | list[str] | None:\n \"\"\"Look for a docstring signature in signature_overrides\"\"\"\n return self.sig_matcher.find_func_match(\n ctx.fullname, self.sig_matcher.signature_overrides\n )\n\n def process_arg(self, ctx: FunctionContext, arg: ArgSig) -> None:\n \"\"\"Update ArgSig in place\"\"\"\n # if key in self.arg_name_replacements:\n # arg.name = self.arg_name_replacements[key]\n\n optionality = self.sig_matcher.find_arg_match(\n ctx.fullname, arg.name, arg.type, self.sig_matcher.optional_args\n )\n if optionality is not None:\n if optionality.has_default:\n arg.default = True\n if optionality.accepts_none:\n arg.type = \"typing.Union[{},NoneType]\".format(arg.type)\n\n # FIXME: I think we want an else here, since arg.type is set, above\n arg_type_override = self.sig_matcher.find_arg_match(\n ctx.fullname, arg.name, arg.type, self.sig_matcher.arg_type_overrides\n )\n if arg_type_override is not None:\n arg.type = arg_type_override\n\n if arg.type:\n # fixes the removal of whitepsace caused by infer_sig_from_docstring\n arg.type = self.WHITESPACE_FIX.sub(\", \", arg.type)\n\n def process_sig(self, ctx: FunctionContext, sig: FunctionSig) -> FunctionSig:\n \"\"\"\n Check if the AdvancedSigMatcher matches `sig` and if it does, apply\n fixes.\n \"\"\"\n for arg in sig.args:\n self.process_arg(ctx, arg)\n if self.sig_matcher.find_result_match(\n ctx.fullname, sig.ret_type, self.sig_matcher._optional_result\n ):\n # make result optional\n sig = sig._replace(ret_type=f\"typing.Optional[{sig.ret_type}]\")\n else:\n # override result type\n ret_override = self.sig_matcher.find_result_match(\n ctx.fullname, sig.ret_type, self.sig_matcher.result_type_overrides\n )\n if ret_override:\n sig = sig._replace(ret_type=ret_override)\n if sig.ret_type:\n # fixes the removal of whitepsace caused by infer_sig_from_docstring\n fixed_type = self.WHITESPACE_FIX.sub(\", \", sig.ret_type)\n if sig.ret_type != fixed_type:\n sig = sig._replace(ret_type=fixed_type)\n return sig\n\n def process_sigs(\n self, ctx: FunctionContext, results: list[FunctionSig]\n ) -> list[FunctionSig]:\n \"\"\"\n Process all of the signatures\n \"\"\"\n for i, inferred in enumerate(results):\n results[i] = self.process_sig(ctx, inferred)\n\n new_overloads = self.sig_matcher.find_func_match(\n ctx.fullname, self.sig_matcher.new_overloads\n )\n if new_overloads:\n docstr = \"\\n\".join(ctx.name + overload for overload in new_overloads)\n new_sigs = infer_sig_from_docstring(docstr, ctx.name)\n if new_sigs:\n results.extend(new_sigs)\n return results\n\n def get_overridden_signatures(\n self, ctx: FunctionContext\n ) -> list[FunctionSig] | None:\n \"\"\"\n Return a full replacement for the docstring signature, if it has\n been provded by the AdvancedSigMatcher.\n \"\"\"\n docstr_override = self.get_signature_str(ctx)\n if docstr_override:\n name = ctx.name\n docstr = docstr_override\n\n def prep_doc(d: str) -> str:\n if not d.startswith(name):\n d = name + d\n return d\n\n # process our override\n if isinstance(docstr, list):\n docstr = \"\\n\".join(prep_doc(d) for d in docstr)\n else:\n docstr = prep_doc(docstr)\n return infer_sig_from_docstring(docstr, name)\n else:\n return None\n\n def get_function_sig(\n self, default_sig: FunctionSig, ctx: FunctionContext\n ) -> list[FunctionSig] | None:\n \"\"\"Main override to apply the signature overrides\"\"\"\n from stubgenlib.utils import merge_signature_kwargs\n\n results = self.get_overridden_signatures(ctx)\n if results and self.merge_overrides_with_fallback:\n fallback = self.fallback_sig_gen.get_function_sig(default_sig, ctx)\n if fallback:\n if self.select_overload_to_merge == \"first\":\n for i, result in enumerate(results):\n results[i] = merge_signature_kwargs(result, fallback[0])\n elif self.select_overload_to_merge == \"by_index\":\n assert len(results) == len(fallback)\n for i, (result, fb) in enumerate(zip(results, fallback)):\n results[i] = merge_signature_kwargs(result, fb)\n else:\n raise ValueError(self.select_overload_to_merge)\n\n if not results:\n # call the standard docstring-based generator.\n results = self.fallback_sig_gen.get_function_sig(default_sig, ctx)\n if results is None:\n results = [default_sig]\n\n if results:\n return self.process_sigs(ctx, results)\n\n return results\n\n def get_property_type(\n self, default_type: str | None, ctx: FunctionContext\n ) -> str | None:\n \"\"\"Return the type of the given property\"\"\"\n ret_type = self.fallback_sig_gen.get_property_type(default_type, ctx)\n type_override = self.sig_matcher.find_result_match(\n ctx.fullname, ret_type, self.sig_matcher.property_type_overrides\n )\n if type_override is not None:\n return type_override\n else:\n return ret_type\n" }, { "path": "common/src/stubgenlib/siggen/boost.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nimport contextlib\nimport io\nimport re\nimport tokenize\n\nfrom mypy.stubdoc import _ARG_NAME_RE, is_valid_type\nfrom mypy.stubgenc import (\n ArgSig,\n FunctionContext,\n FunctionSig,\n SignatureGenerator,\n)\nfrom typing_extensions import Final\n\n# this is adapted from mypy.stubdoc\n\n# States of the docstring parser.\nSTATE_INIT: Final = 1\nSTATE_FUNCTION_NAME: Final = 2\nSTATE_ARGUMENT_LIST: Final = 3\nSTATE_ARGUMENT_TYPE: Final = 4\nSTATE_ARGUMENT_DEFAULT: Final = 5\nSTATE_RETURN_VALUE: Final = 6\nSTATE_OPEN_BRACKET: Final = 7 # For generic types.\n\n\nclass BoostDocStringParser:\n \"\"\"Parse function signatures in documentation.\"\"\"\n\n def __init__(self, function_name: str, verbose: bool = False) -> None:\n # Only search for signatures of function with this name.\n self.function_name = function_name\n self.state = [STATE_INIT]\n self.accumulator = \"\"\n self.arg_type: str | None = None\n self.arg_name = \"\"\n self.arg_default: str | None = None\n self.ret_type = \"typing.Any\"\n self.defaults: str | bool = False\n self.found = False\n self.args: list[ArgSig] = []\n # Valid signatures found so far.\n self.signatures: list[FunctionSig] = []\n self.verbose = verbose\n\n def debug(self, *msg) -> None:\n if self.verbose:\n print(*msg)\n\n def pop_state(self, reason) -> None:\n prev = self.state.pop()\n self.debug(\"pop state {} {} -> {}\".format(reason, prev, self.state[-1]))\n\n def add_token(self, token: tokenize.TokenInfo) -> None:\n \"\"\"Process next token from the token stream.\"\"\"\n if (\n token.type == tokenize.NAME\n and token.string == self.function_name\n and self.state[-1] == STATE_INIT\n ):\n self.debug()\n self.debug(\"STATE_FUNCTION_NAME\")\n self.state.append(STATE_FUNCTION_NAME)\n\n elif (\n token.type == tokenize.OP\n and token.string == \"(\"\n and self.state[-1] == STATE_FUNCTION_NAME\n ):\n self.pop_state(\"START ARGS\")\n self.accumulator = \"\"\n self.found = True\n self.debug(\"STATE_ARGUMENT_LIST\")\n self.state.append(STATE_ARGUMENT_LIST)\n\n elif self.state[-1] == STATE_FUNCTION_NAME:\n # Reset state, function name not followed by '('.\n self.pop_state(\"RESET\")\n\n elif (\n token.type == tokenize.OP\n and token.string == \"(\"\n and self.state[-1] == STATE_ARGUMENT_LIST\n ):\n self.debug(\"STATE_ARGUMENT_TYPE\")\n self.state.append(STATE_ARGUMENT_TYPE)\n\n elif (\n token.type == tokenize.OP\n and token.string == \"[\"\n and self.state[-1] in (STATE_ARGUMENT_LIST, STATE_ARGUMENT_DEFAULT)\n ):\n self.debug(\"setting defaults\")\n if self.defaults is False:\n self.defaults = \"next\"\n\n elif (\n token.type == tokenize.OP\n and token.string == \"]\"\n and self.state[-1] == STATE_ARGUMENT_LIST\n ):\n pass\n\n elif (\n token.type == tokenize.OP\n and token.string == \")\"\n and self.state[-1] == STATE_ARGUMENT_TYPE\n ):\n self.arg_type = self.accumulator\n self.debug(\"accumulate type\", repr(self.arg_type))\n self.accumulator = \"\"\n self.pop_state(\"END ARG TYPE\")\n\n elif (\n token.type == tokenize.OP\n and token.string in (\"[\", \"(\", \"{\")\n and self.state[-1] != STATE_INIT\n ):\n self.accumulator += token.string\n self.debug(\"STATE_OPEN_BRACKET\", token.string)\n self.state.append(STATE_OPEN_BRACKET)\n\n elif (\n token.type == tokenize.OP\n and token.string in (\"]\", \")\", \"}\")\n and self.state[-1] == STATE_OPEN_BRACKET\n ):\n self.accumulator += token.string\n self.pop_state(f\"END OPEN BRACKET {token.string}\")\n\n elif (\n token.type == tokenize.OP\n and token.string == \"=\"\n and self.state[-1] in (STATE_ARGUMENT_LIST, STATE_ARGUMENT_TYPE)\n ):\n if self.state[-1] == STATE_ARGUMENT_TYPE:\n self.arg_type = self.accumulator\n self.debug(\"STATE_ARGUMENT_DEFAULT. type\", self.arg_type)\n self.pop_state(\"END ARG TYPE\")\n else:\n self.arg_name = self.accumulator\n self.debug(\"STATE_ARGUMENT_DEFAULT. name\", self.arg_name)\n self.accumulator = \"\"\n\n self.state.append(STATE_ARGUMENT_DEFAULT)\n\n elif (\n token.type == tokenize.OP\n and token.string in (\",\", \")\")\n and self.state[-1] in (STATE_ARGUMENT_LIST, STATE_ARGUMENT_DEFAULT)\n ):\n if self.state[-1] == STATE_ARGUMENT_DEFAULT:\n self.arg_default = self.accumulator\n self.debug(\"accumulate default\", repr(self.arg_default))\n self.pop_state(\"END ARG DEFAULT\")\n elif self.state[-1] == STATE_ARGUMENT_LIST:\n self.arg_name = self.accumulator\n self.debug(\"accumulate arg_name\", repr(self.arg_name))\n if not (\n token.string == \")\" and self.accumulator.strip() == \"\"\n ) and not _ARG_NAME_RE.match(self.arg_name):\n # Invalid argument name.\n self.debug(\"reset. invalid arg name\", repr(self.arg_name))\n self.reset()\n return\n\n if token.string == \")\":\n self.pop_state(\"END PAREN\")\n\n # arg_name is empty when there are no args. e.g. func()\n if self.arg_name:\n default = True if self.defaults is True else bool(self.arg_default)\n if self.arg_type and not is_valid_type(self.arg_type):\n arg_type = None\n else:\n arg_type = self.arg_type\n\n self.args.append(\n ArgSig(\n name=self.arg_name,\n type=arg_type,\n default=default,\n )\n )\n if self.defaults == \"next\":\n self.defaults = True\n self.arg_name = \"\"\n self.arg_type = None\n self.arg_default = None\n self.accumulator = \"\"\n\n elif (\n token.type == tokenize.OP\n and token.string == \"->\"\n and self.state[-1] == STATE_INIT\n ):\n self.debug(\"STATE_RETURN_VALUE\", repr(self.accumulator))\n self.accumulator = \"\"\n self.state.append(STATE_RETURN_VALUE)\n\n # ENDMAKER is necessary for python 3.4 and 3.5.\n elif (\n token.type in (tokenize.NEWLINE, tokenize.ENDMARKER)\n or token.type == tokenize.OP\n and token.string == \":\"\n ) and self.state[-1] in (\n STATE_INIT,\n STATE_RETURN_VALUE,\n ):\n if self.state[-1] == STATE_RETURN_VALUE:\n if not is_valid_type(self.accumulator):\n self.debug(\"reset: invalid return\", repr(self.accumulator))\n self.reset()\n return\n self.ret_type = self.accumulator\n self.accumulator = \"\"\n self.pop_state(\"END RETURN\")\n\n if self.found:\n self.signatures.append(\n FunctionSig(\n name=self.function_name, args=self.args, ret_type=self.ret_type\n )\n )\n self.found = False\n self.args = []\n self.ret_type = \"typing.Any\"\n self.defaults = False\n # Leave state as INIT.\n else:\n self.debug(\"catchall\", self.state[-1], repr(token.string))\n self.accumulator += token.string\n\n def reset(self) -> None:\n self.state = [STATE_INIT]\n self.args = []\n self.found = False\n self.accumulator = \"\"\n\n def get_signatures(self) -> list[FunctionSig]:\n \"\"\"Return sorted copy of the list of signatures found so far.\"\"\"\n\n def has_arg(name: str, signature: FunctionSig) -> bool:\n return any(x.name == name for x in signature.args)\n\n def args_kwargs(signature: FunctionSig) -> bool:\n return has_arg(\"*args\", signature) and has_arg(\"**kwargs\", signature)\n\n # Move functions with (*args, **kwargs) in their signature to last place.\n return list(sorted(self.signatures, key=lambda x: 1 if args_kwargs(x) else 0))\n\n\ndef infer_sig_from_boost_docstring(\n docstr: str | None, name: str\n) -> list[FunctionSig] | None:\n if not docstr:\n return None\n\n state = BoostDocStringParser(name)\n # Return all found signatures, even if there is a parse error after some are found.\n with contextlib.suppress(tokenize.TokenError):\n try:\n tokens = tokenize.tokenize(io.BytesIO(docstr.encode(\"utf-8\")).readline)\n for token in tokens:\n state.add_token(token)\n except IndentationError:\n return None\n sigs = state.get_signatures()\n return sigs\n\n # def is_unique_args(sig: FunctionSig) -> bool:\n # \"\"\"return true if function argument names are unique\"\"\"\n # return len(sig.args) == len({arg.name for arg in sig.args})\n\n # # Return only signatures that have unique argument names. Mypy fails on non-unique arg names.\n # return [sig for sig in sigs if is_unique_args(sig)]\n\n\nclass BoostDocstringSignatureGenerator(SignatureGenerator):\n \"\"\"\n Parses boost-python style signatures\n \"\"\"\n\n def get_function_sig(\n self, default_sig: FunctionSig, ctx: FunctionContext\n ) -> list[FunctionSig] | None:\n if ctx.docstring:\n return infer_sig_from_boost_docstring(ctx.docstring, ctx.name)\n return None\n\n @classmethod\n def is_default_boost_arg(cls, arg_name: str) -> bool:\n return bool(re.match(\"^arg[0-9]+$\", arg_name))\n\n\n# def boost_parser() -> None:\n# from lark import Lark\n#\n# parser = Lark(\n# r\"\"\"\n# identifier : (CNAME \".\")* CNAME\n#\n# type_list : type (\",\" type)*\n#\n# generic_type : identifier \"[\" type_list \"]\"\n#\n# ?base_type : [\"unsigned\" \" \"+] identifier | pointer_type | reference_type | const_type\n#\n# ?type : base_type | generic_type\n#\n# signature : identifier \"(\" [type_list] \")\" [\"const\"]\n#\n# %import common.CNAME\n# %import common.WS\n# %ignore WS\n# \"\"\",\n# start='signature',\n# )\n#\n# text = \"Mari::ExportItem::setUvIndexList(QList const&, int, char const*)\"\n# print(parser.parse(text).pretty())\n" }, { "path": "common/src/stubgenlib/siggen/default.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nfrom mypy.stubgenc import (\n FunctionContext,\n FunctionSig,\n SignatureGenerator,\n)\n\n\nclass DefaultSigGenerator(SignatureGenerator):\n \"\"\"Sig Gen that uses the signature extracted from the source code\"\"\"\n\n def get_function_sig(\n self, default_sig: FunctionSig, ctx: FunctionContext\n ) -> list[FunctionSig] | None:\n return [default_sig]\n" }, { "path": "common/src/stubgenlib/siggen/docstring.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nfrom mypy.stubgenc import (\n ArgSig,\n FunctionContext,\n FunctionSig,\n SignatureGenerator,\n)\n\n\nclass DocstringSignatureGenerator(SignatureGenerator):\n \"\"\"\n Generate signatures from docstrings.\n\n Unlike the built-in parser which targets signatures created by C++ binding\n generators, this works with standard docstring formats such as numpy,\n google, and epydoc (which Katana uses).\n \"\"\"\n\n def prepare_docstring(self, docstr: str) -> str:\n return docstr\n\n def get_function_sig(\n self, default_sig: FunctionSig, ctx: FunctionContext\n ) -> list[FunctionSig] | None:\n import docstring_parser\n\n if ctx.docstring:\n parsed = docstring_parser.parse(self.prepare_docstring(ctx.docstring))\n args = []\n return_type = None\n if parsed.params:\n for param in parsed.params:\n # param.default can be unreliable. in the case of google-style docs\n # the default is parsed from human description, whereas is_optional is\n # taken from a more concrete convention: `arg_name(list of in, optional)`\n args.append(\n ArgSig(\n param.arg_name,\n param.type_name,\n default=bool(param.is_optional),\n )\n )\n if parsed.returns:\n if parsed.returns.type_name:\n return_type = parsed.returns.type_name\n elif parsed.returns.description and \":\" in parsed.returns.description:\n # the parser fails to extract the type when it encounters\n # \"list of {blah}\" in google doctrings, so try a last ditch\n # effort to grab the type\n return_type = parsed.returns.description.split(\":\", 1)[0]\n else:\n return_type = None\n\n sig = FunctionSig(ctx.name, args, return_type)\n return [sig]\n return None\n" }, { "path": "common/src/stubgenlib/siggen/sigfixer.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nimport re\n\nfrom mypy.fastparse import parse_type_comment\nfrom mypy.stubgenc import (\n ArgSig,\n FunctionContext,\n FunctionSig,\n SignatureGenerator,\n)\nfrom typing_extensions import Literal\n\nfrom stubgenlib.utils import merge_signatures\n\n\nclass SignatureFixer(SignatureGenerator):\n \"\"\"\n Signature generator that handles the boilerplate of cleaning up a signature\n from an external source, such as documentation.\n\n This class should be subclassed to implement cleanup_type(), then paired\n with a concrete SignatureGenerator class (the fixer should come first).\n It will call super().get_function_sig() then apply the fixes defined by\n cleanup_type() to all types in the signatures.\n \"\"\"\n\n def __init__(\n self,\n sig_gen: SignatureGenerator,\n default_sig_handling: Literal[\"ignore\", \"merge\"] = \"merge\",\n ) -> None:\n \"\"\"\n sig_gen: signature generator to call to get signatures to fix.\n default_sig_handling\n How to use the default signature.\n \"ignore\": only use the sigs from this generator. don't use the default sig.\n \"merge\": merge the sigs from this generator into the default.\n \"\"\"\n self.sig_gen = sig_gen\n self.default_sig_handling = default_sig_handling\n\n @staticmethod\n def is_valid(type_name: str) -> bool:\n try:\n parse_type_comment(type_name, 0, 0, None)\n except Exception:\n return False\n else:\n return True\n\n def cleanup_type(\n self,\n type_name: str,\n ctx: FunctionContext,\n is_result: bool,\n default_value: str | None = None,\n ) -> str:\n \"\"\"Override this to implement logic to fix a type\"\"\"\n return type_name\n\n def cleanup_sigs_types(\n self,\n sigs: list[FunctionSig],\n ctx: FunctionContext,\n ) -> list[FunctionSig]:\n \"\"\"Call cleanup_type on the types of all sigs\"\"\"\n return [self.cleanup_sig_types(sig, ctx) for sig in sigs]\n\n def cleanup_sig_types(\n self, sig: FunctionSig, ctx: FunctionContext, docstring: str | None = None\n ) -> FunctionSig:\n \"\"\"Call cleanup_type on the types of the sig (args and return type)\"\"\"\n args = []\n return_type = None\n invalid = []\n for arg in sig.args:\n type_name = None\n if arg.type:\n type_name = self.cleanup_type(\n arg.type, ctx, is_result=False, default_value=arg.default_value\n )\n if not self.is_valid(type_name):\n invalid.append(\n \"Invalid arg {} (orig: {} converted: {})\".format(\n repr(arg.name), repr(arg.type), repr(type_name)\n )\n )\n type_name = None\n args.append(\n ArgSig(\n arg.name,\n type_name,\n default=arg.default,\n default_value=arg.default_value,\n )\n )\n if sig.ret_type:\n return_type = self.cleanup_type(sig.ret_type, ctx, is_result=True)\n if not self.is_valid(return_type):\n invalid.append(\n \"Invalid ret (orig: {} converted: {})\".format(\n repr(sig.ret_type), repr(return_type)\n )\n )\n return_type = None\n\n # FIXME: only copy if something has changed?\n converted = sig._replace(args=args, ret_type=return_type)\n if docstring:\n converted = converted._replace(docstring=docstring)\n\n if invalid:\n print(f\"Invalid type after cleanup: {ctx.fullname}\")\n print(\" orig: {}\".format(sig.format_sig()))\n print(\" new: {}\".format(converted.format_sig()))\n for item in invalid:\n print(\" {}\".format(item))\n\n return converted\n\n def get_function_sig(\n self, default_sig: FunctionSig, ctx: FunctionContext\n ) -> list[FunctionSig] | None:\n \"\"\"Gets the signatures from sig_gen, then cleans up the types\"\"\"\n sigs = self.sig_gen.get_function_sig(default_sig, ctx)\n if sigs:\n for i, sig in enumerate(sigs):\n sig = self.cleanup_sig_types(sig, ctx)\n if self.default_sig_handling == \"ignore\":\n merged_sig = sig\n elif default_sig.is_catchall_signature() or (\n default_sig.has_catchall_args()\n and default_sig.ret_type == sig.ret_type\n ):\n merged_sig = sig\n else:\n merged_sig = merge_signatures(default_sig, sig)\n sigs[i] = merged_sig\n return sigs\n\n\nclass DocstringTypeFixer(SignatureFixer):\n \"\"\"\n fixes human-defined types in docstrings\n \"\"\"\n\n PYPATH = re.compile(r\"((?:[a-zA-Z_][a-zA-Z0-9_]*)(?:[.][a-zA-Z_][a-zA-Z0-9_]*)*)\")\n EPY_REG = re.compile(r\"([LC]\\{([^}]+)\\})\")\n LIST_OF_REG = re.compile(r\"\\b(list|Sequence|Iterable|Iterator) of (.*)\")\n TUPLE_OF_REG = re.compile(r\"\\btuple of ([a-zA-Z0-9_.,() ]*)\")\n SET_OF_REG = re.compile(r\"\\bset of ([a-zA-Z0-9_.]*)\")\n DICT_OF_REG = re.compile(r\"\\bdict of ([a-zA-Z0-9_.]*) (?:of|to) ([a-zA-Z0-9_.]*)\")\n NUMERIC_TUPLE_REG = re.compile(r\"\\b(int|float)\\[(\\d+)\\]\")\n\n REPLACEMENTS = [\n (\"number\", \"float\"),\n (\"List\", \"list\"),\n (\"Dict\", \"dict\"),\n (\"Type\", \"type\"),\n (\"module\", \"types.ModuleType\"),\n (\"traceback\", \"types.TracebackType\"),\n (\"function\", \"typing.Callable\"),\n (\"callable\", \"typing.Callable\"),\n (\"hashable\", \"typing.Hashable\"),\n (\"iterable\", \"typing.Iterable\"),\n (\"class\", \"type\"),\n (\"sequence\", \"typing.Sequence\"),\n (\"generator\", \"typing.Iterator\"),\n (\"buffer\", \"typing_extensions.Buffer\"),\n (\"long\", \"int\"),\n (\"strings?\", \"str\"),\n (\"Str\", \"str\"),\n (\"int_\", \"int\"),\n (\"none\", \"None\"),\n ]\n\n def get_replacements(self, is_result: bool) -> list[tuple[str, str]]:\n repl = self.REPLACEMENTS\n if is_result:\n return repl + [(\"object\", \"Any\")]\n return repl\n\n def get_full_name(self, obj_name: str) -> str:\n return obj_name\n\n def cleanup_type(\n self,\n type_name: str,\n ctx: FunctionContext,\n is_result: bool,\n default_value: str | None = None,\n ) -> str:\n type_name = type_name.replace(\"`\", \"\")\n type_name = type_name.replace(\"\\n\", \" \")\n type_name = type_name.replace(\"<\", \"[\")\n type_name = type_name.replace(\">\", \"]\")\n type_name = type_name.rstrip(\".\")\n type_name = self.EPY_REG.sub(lambda m: m.group(2), type_name).strip()\n\n type_name = re.sub(r\"\\bNoneType\\b\", \"None\", type_name)\n\n # special case\n optional = False\n if type_name.endswith(\", or None\"):\n optional = True\n type_name = type_name[: len(\", or None\")]\n\n for find, replace in self.get_replacements(is_result):\n type_name = re.sub(r\"\\b{}\\b\".format(find), replace, type_name)\n\n type_name = type_name.replace(\" or \", \" | \")\n\n type_name = type_name.replace(\n \"object convertible to a float\", \"typing.SupportsFloat\"\n )\n\n def list_sub(m) -> str:\n return \"{}[{}]\".format(m.group(1), m.group(2))\n\n type_name = self.LIST_OF_REG.sub(list_sub, type_name, count=1)\n\n def tuple_sub(m) -> str:\n members = [s.strip() for s in m.group(1).replace(\" and \", \" , \").split(\",\")]\n if len(members) == 1:\n members.append(\"...\")\n return \"tuple[{}]\".format(\", \".join(members))\n\n type_name = self.TUPLE_OF_REG.sub(tuple_sub, type_name, count=1)\n\n def set_sub(m) -> str:\n return \"set[{}]\".format(m.group(1))\n\n type_name = self.SET_OF_REG.sub(set_sub, type_name, count=1)\n\n def dict_sub(m) -> str:\n return \"dict[{}, {}]\".format(m.group(1), m.group(2))\n\n type_name = self.DICT_OF_REG.sub(dict_sub, type_name, count=1)\n\n def numeric_tuple_sub(m) -> str:\n count = int(m.group(2))\n return \"tuple[{}]\".format(\", \".join([m.group(1)] * count))\n\n type_name = self.NUMERIC_TUPLE_REG.sub(numeric_tuple_sub, type_name, count=1)\n\n if optional:\n type_name = \"typing.Optional[{}]\".format(type_name)\n\n parts = []\n for part in self.PYPATH.split(type_name):\n if part and part[0].isalpha():\n parts.append(self.get_full_name(part))\n else:\n parts.append(part)\n return \"\".join(parts)\n" }, { "path": "common/src/stubgenlib/stubgen/__init__.py", "content": "from __future__ import absolute_import, print_function\n" }, { "path": "common/src/stubgenlib/stubgen/delegate.py", "content": "from __future__ import absolute_import, print_function\n\nimport fnmatch\nfrom typing import Any, Generic, TypeVar\n\nT = TypeVar(\"T\")\n\n\nclass GeneratorDelegate(Generic[T]):\n \"\"\"Choose a StubGenerator based on module name rules\"\"\"\n\n def __init__(self, rules: dict[str, type[T]], fallback: type[T]):\n \"\"\"\n Args:\n rules: mapping of module names (supports globs) to StubGenerator type\n fallback: StubGenerator type to use if there are no matches\n \"\"\"\n self.rules = rules\n self.fallback = fallback\n\n def __call__(self, module_name: str, *args: Any, **kwargs: Any) -> T:\n for pattern, generator in self.rules.items():\n if fnmatch.fnmatchcase(module_name, pattern):\n return generator(module_name, *args, **kwargs)\n return self.fallback(module_name, *args, **kwargs)\n" }, { "path": "common/src/stubgenlib/test_helpers.py", "content": "from __future__ import absolute_import, print_function\n\nfrom typing import TYPE_CHECKING\n\nimport typeguard\nfrom typeguard import TypeCheckError as TypeCheckError\n\nif TYPE_CHECKING:\n from typing_extensions import assert_type as assert_type\nelse:\n\n def assert_type(val, typ, /):\n return typeguard.check_type(val, typ)\n" }, { "path": "common/src/stubgenlib/utils.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nimport itertools\nfrom dataclasses import dataclass, field\nfrom typing import Iterable, TypeVar\n\nfrom mypy.stubgenc import (\n ArgSig,\n FunctionContext,\n FunctionSig,\n)\n\nT = TypeVar(\"T\")\n\n\n@dataclass\nclass ArgGroups:\n pos_only: list[ArgSig] = field(default_factory=list)\n pos_or_kw: list[ArgSig] = field(default_factory=list)\n star_args: ArgSig | None = None\n kw_only: list[ArgSig] = field(default_factory=list)\n star_kwargs: ArgSig | None = None\n\n def all_args(self) -> list[ArgSig]:\n args = []\n if self.pos_only:\n args += self.pos_only + [ArgSig(\"/\", None)]\n args += self.pos_or_kw\n if self.star_args:\n args += [self.star_args]\n args += self.kw_only\n if self.star_kwargs:\n args += [self.star_kwargs]\n return args\n\n\ndef insert_typevars(import_lines: str, typevars: list[str]) -> str:\n imports = import_lines.split(\"\\n\")\n if \"import typing\" not in imports:\n imports.append(\"import typing\")\n return \"\\n\".join(imports + typevars)\n\n\ndef merge_args_by_name(\n dest: list[ArgSig],\n other: list[ArgSig],\n force: bool = False,\n add_extra: bool = False,\n) -> list[ArgSig]:\n args: list[ArgSig] = []\n other_args = {arg.name: arg for arg in other}\n for arg in dest:\n other_arg = other_args.pop(arg.name, None)\n if other_arg is not None:\n if (arg.type is None or force) and other_arg.type is not None:\n arg = ArgSig(\n arg.name,\n other_arg.type,\n default=arg.default,\n default_value=arg.default_value,\n )\n args.append(arg)\n if add_extra:\n args.extend(other_args.values())\n return args\n\n\ndef merge_signatures(\n dest: FunctionSig, other: FunctionSig, force: bool = False\n) -> FunctionSig:\n \"\"\"Merge the `other` signature into `dest`, returning a new signature.\n\n The other signature can have fewer arguments: args will be matched by position\n for special methods and name otherwise.\n\n If force is True, types from other signature will override dest one even if\n dest has non-None types.\n \"\"\"\n if dest.is_special_method() and len(other.args) == len(dest.args):\n args: list[ArgSig] = []\n # ignore argument names for special methods\n for arg, other_arg in zip(dest.args, other.args):\n if (arg.type is None or force) and other_arg.type is not None:\n arg = ArgSig(\n arg.name,\n other_arg.type,\n default=arg.default,\n default_value=arg.default_value,\n )\n args.append(arg)\n else:\n # TODO: strict mode that ignores donor sig if arg length doesn't match?\n args = merge_args_by_name(dest.args, other.args)\n\n ret_type = dest.ret_type\n if (ret_type is None or force) and other.ret_type:\n ret_type = other.ret_type\n\n new_sig = FunctionSig(name=dest.name, args=args, ret_type=ret_type)\n other_docstring = getattr(other, \"docstring\", None)\n dest_docstring = getattr(dest, \"docstring\", None)\n if other_docstring is not None or dest_docstring is not None:\n new_sig.docstring = dest_docstring or other_docstring\n return new_sig\n\n\ndef is_star_arg(arg_name):\n return arg_name == \"*\" or (\n len(arg_name) >= 2 and arg_name[0] == \"*\" and arg_name[1] != \"*\"\n )\n\n\ndef get_arg_groups(sig: FunctionSig) -> ArgGroups:\n \"\"\"\n def foo(pos_or_kw, **kwargs)\n def foo(pos_only, /, pos_or_kw, **kwargs)\n def foo(pos_only, /, pos_or_kw, *, kw_only, **kwargs)\n def foo(pos_or_kw, *, kw_only, **kwargs)\n \"\"\"\n\n groups = ArgGroups()\n\n current = groups.pos_or_kw\n\n for arg in sig.args:\n if arg.name == \"/\":\n groups.pos_only = groups.pos_or_kw\n current = groups.pos_or_kw = []\n elif is_star_arg(arg.name):\n groups.star_args = arg\n current = groups.kw_only\n elif arg.name.startswith(\"**\"):\n groups.star_kwargs = arg\n current = None\n else:\n current.append(arg)\n return groups\n\n\ndef merge_signature_kwargs(\n dest: FunctionSig,\n other: FunctionSig,\n force: bool = False,\n replace_kwargs=False,\n) -> FunctionSig:\n \"\"\"Replace **kwargs with keyword-only arguments.\n\n This is only safe if dest has **kwargs and source has keyword only args (i.e. a *-arg exists)\n\n Args:\n replace_kwargs: if True, remove **kwargs argumenet if any keyword replacements are made\n \"\"\"\n dest_groups = get_arg_groups(dest)\n\n if dest_groups.star_kwargs is not None:\n # FIXME: handle name conflicts with other arg groups\n source_groups = get_arg_groups(other)\n dest_groups.kw_only = merge_args_by_name(\n dest_groups.kw_only, source_groups.kw_only, force=force, add_extra=True\n )\n if replace_kwargs:\n dest_groups.star_kwargs = None\n if source_groups.kw_only and dest_groups.star_args is None:\n dest_groups.star_args = ArgSig(\"*\")\n\n ret_type = dest.ret_type\n if (ret_type is None or force) and other.ret_type:\n ret_type = other.ret_type\n\n new_sig = FunctionSig(\n name=dest.name, args=dest_groups.all_args(), ret_type=ret_type\n )\n other_docstring = getattr(other, \"docstring\", None)\n dest_docstring = getattr(dest, \"docstring\", None)\n if other_docstring is not None or dest_docstring is not None:\n new_sig.docstring = dest_docstring or other_docstring\n return new_sig\n\n\nclass CFunctionStub:\n \"\"\"\n Class that mimics a C function in order to provide parseable docstrings.\n \"\"\"\n\n def __init__(self, name: str, doc: str, is_abstract=False) -> None:\n # Use special dunder names so that this object is interpreted as desired during inspection.\n self.__name__ = name\n self.__doc__ = doc\n self.__abstractmethod__ = is_abstract\n\n @classmethod\n def _from_sig(cls, sig: FunctionSig, is_abstract=False) -> CFunctionStub:\n return CFunctionStub(\n sig.name, sig.format_sig().replace(\": ...\", \"\"), is_abstract\n )\n\n @classmethod\n def _from_sigs(cls, sigs: list[FunctionSig], is_abstract=False) -> CFunctionStub:\n return CFunctionStub(\n sigs[0].name,\n \"\\n\".join(sig.format_sig().replace(\": ...\", \"\") for sig in sigs),\n is_abstract,\n )\n\n def __get__(self) -> None:\n \"\"\"\n This exists to make this object look like a method descriptor and thus\n return true for InspectionStubGenerator.ismethod()\n \"\"\"\n\n\n# FIXME: should this include the return type?\ndef sig_sort_key(py_sig: FunctionSig) -> tuple[int, tuple[str, ...]]:\n return (len(py_sig.args), tuple([arg.name for arg in py_sig.args]))\n\n\ndef remove_overlapping_overloads(\n sigs: list[FunctionSig], sort: bool = False\n) -> list[FunctionSig]:\n if len(sigs) <= 1:\n return sigs\n\n # when searching for overlapping sigs, we must search in order of decreasing specificity\n sorted_sigs = sorted(sigs, key=sig_sort_key, reverse=True)\n # find singatures that overlap with other overloads\n redundant = []\n for a, b in itertools.combinations(sorted_sigs, 2):\n if contains_other_overload(a, b):\n redundant.append(b)\n elif contains_other_overload(b, a):\n redundant.append(a)\n if sort:\n results = sorted_sigs\n else:\n results = sigs\n\n # now filter\n results = [sig for sig in results if sig not in redundant]\n\n if not results:\n msg = \"removed too many overlapping overloads\\n\"\n msg += f\" signatures:\\n\"\n for x in sigs:\n msg += f\" {x}\\n\"\n msg += f\" redundant:\\n\"\n for x in sigs:\n msg += f\" {x}\\n\"\n raise ValueError(msg)\n return results\n\n\ndef remove_unhashable_duplicates(objects: Iterable[T]) -> list[T]:\n \"\"\"General utility to remove objects from the input iterable that evaluate as equal.\"\"\"\n result = []\n for x in objects:\n if x not in result:\n result.append(x)\n return result\n\n\ndef reduce_overloads(\n sigs: list[FunctionSig],\n sort: bool = False,\n) -> list[FunctionSig]:\n \"\"\"\n Remove unsupported and redundant overloads.\n\n - Some overloads are a subset of other overloads and can be pruned.\n - Some methods implement both classmethod and instancemethod overloads, and mypy prevents\n mixing these and does not correctly analyze them. We have to drop one, and we've chosen\n to remove classmethods. It is possible to implement a \"universalmethod\" decorator, but\n we could not use overloads to distinguish their arguments.\n\n sort : if True, order functions so that functions with more arguments are\n before those with fewer. This is likley the desired behavior, but at some point the order\n was reversed, so it is now opt-in.\n \"\"\"\n classmethods = []\n instancmethods = []\n new_sigs = remove_unhashable_duplicates(sigs)\n for sig in new_sigs:\n if sig.args and sig.args[0].name == \"self\":\n instancmethods.append(sig)\n else:\n classmethods.append(sig)\n if classmethods and instancmethods:\n new_sigs = instancmethods\n return remove_overlapping_overloads(new_sigs, sort=sort)\n\n\ndef contains_other_overload(sig: FunctionSig, other: FunctionSig) -> bool:\n \"\"\"\n Return whether an overload is fully covered by another overload, and thus redundant.\n \"\"\"\n if other.ret_type != sig.ret_type:\n # not compatible\n return False\n num_other_args = len(other.args)\n if len(sig.args) < num_other_args:\n # other has more args, sig cannot contain other\n return False\n if sig.args[:num_other_args] == other.args and all(\n a.default for a in sig.args[num_other_args:]\n ):\n # sig contains all of other's args, and the remaining sig args all have defaults\n return True\n return False\n\n\ndef add_positional_only_args(ctx: FunctionContext, py_sig: FunctionSig) -> FunctionSig:\n \"\"\"\n Analyze the signature and add a '/' argument if necessary to mark\n arguments which cannot be access by name.\n\n Before:\n def foo(arg0, arg1, this=True, that='with_default')\n After:\n def foo(arg0, arg1, /, this=True, that='with_default')\n\n Before:\n def foo(arg0, arg1, this=True, that)\n After:\n def foo(arg0, arg1, /, this=True, *, that)\n \"\"\"\n from stubgenlib.siggen.boost import BoostDocstringSignatureGenerator\n\n args = []\n requires_pos_only: bool | None = None\n has_defaults: bool | None = False\n for arg_num, py_arg in enumerate(py_sig.args):\n if BoostDocstringSignatureGenerator.is_default_boost_arg(py_arg.name):\n if requires_pos_only is False:\n raise ValueError(\n f\"{ctx.fullname}: Unnamed argument appears after named one: {py_sig.format_sig()}\"\n )\n requires_pos_only = True\n else:\n if requires_pos_only:\n # force arguments before this to be positional only\n args.append(ArgSig(\"/\"))\n if not (arg_num == 0 and py_arg.name in (\"self\", \"cls\")):\n requires_pos_only = False\n\n if has_defaults is False and py_arg.default:\n has_defaults = True\n elif has_defaults and not py_arg.default:\n # force arguments after this to be keyword only\n args.append(ArgSig(\"*\"))\n has_defaults = None\n\n args.append(py_arg)\n\n if requires_pos_only:\n # force arguments before this to be positional only\n args.append(ArgSig(\"/\"))\n\n return py_sig._replace(args=args)\n\n\ndef get_mypy_ignore_directive(codes: list[str]) -> str:\n return '# mypy: disable-error-code=\"{}\"\\n\\n'.format(\", \".join(codes))\n" }, { "path": "common/tests/test_stubgenlib.py", "content": "import pytest\nfrom mypy.stubdoc import ArgSig, FunctionSig\n\nfrom stubgenlib.siggen.boost import infer_sig_from_boost_docstring\n\n# def test_boost_docstrings():\n# docstr = \"\"\"\n# __init__( (object)arg1) -> None\n\n# __init__( (object)arg1 [, (Camera)arg2]) -> None\n\n# __init__( (object)arg1 [, (Matrix4d)transform=Gf.Matrix4d(1.0, 0.0, 0.0, 0.0,\n# 0.0, 0.0, 0.0, 1.0) [, (object)projection=Gf.Camera.Perspective [, (float)horizontalAperture=20.955 [, (float)verticalAperture=15.290799999999999 [, (float)horizontalApertureOffset=0.0 [, (float)verticalApertureOffset=0.0 [, (float)focalLength=50.0 [, (Range1f)clippingRange=Gf.Range1f(1.0, 1000000.0) [, (object)clippingPlanes=[] [, (float)fStop=0.0 [, (float)focusDistance=0.0]]]]]]]]]]]) -> None\"\"\"\n\n\n# expected = \"\"\"\n# __init__( arg1: object) -> None\n\n# __init__( arg1: object , arg2: Camera = ...) -> None\n\n# __init__( arg1: object , transform: Matrix4d = ..., projection: object = ..., horizontalAperture: float = ..., verticalAperture: float = ..., horizontalApertureOffset: float = ..., verticalApertureOffset: float = ..., focalLength: float = ..., clippingRange: Range1f = ..., clippingPlanes: object = ..., fStop: float = ..., focusDistance: float = ...) -> None\"\"\"\n# print(stubgenlib.BoostDocstringSignatureGenerator.standardize_docstring(docstr))\n# assert stubgenlib.BoostDocstringSignatureGenerator.standardize_docstring(docstr) == expected\n\n# docstr = \"\"\"\n# __init__( (object)arg1, (object)arg2) -> None\n\n# __init__( (object)arg1 [, (Path)arg2]) -> None\"\"\"\n\n# expected = \"\"\"\n# __init__( arg1: object, arg2: object) -> None\n\n# __init__( arg1: object , arg2: Path = ...) -> None\"\"\"\n# print(stubgenlib.BoostDocstringSignatureGenerator.standardize_docstring(docstr))\n# assert stubgenlib.BoostDocstringSignatureGenerator.standardize_docstring(docstr) == expected\n\n\ndef test_boost_docstring_overloads():\n docstr = \"\"\"\n__init__( (object)arg1) -> None\n\n__init__( (object)arg1 [, (Camera)arg2]) -> None :\n\n__init__( (object)arg1 [, (Matrix4d)transform=Gf.Matrix4d(1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0) [, (object)projection=Gf.Camera.Perspective [, (float)apertureOffset=0.0 [, (Range1f)clippingRange=Gf.Range1f(1.0, 10000.0) [, (object)clippingPlanes=[] [, (float)fStop=0.0]]]]]]) -> None\"\"\"\n\n result = infer_sig_from_boost_docstring(docstr, \"__init__\")\n import pprint\n\n pprint.pprint(result)\n assert result == [\n FunctionSig(\n name=\"__init__\",\n args=[ArgSig(name=\"arg1\", type=\"object\", default=False)],\n ret_type=\"None\",\n ),\n FunctionSig(\n name=\"__init__\",\n args=[\n ArgSig(name=\"arg1\", type=\"object\", default=False),\n ArgSig(name=\"arg2\", type=\"Camera\", default=True),\n ],\n ret_type=\"None\",\n ),\n FunctionSig(\n name=\"__init__\",\n args=[\n ArgSig(name=\"arg1\", type=\"object\", default=False),\n ArgSig(name=\"transform\", type=\"Matrix4d\", default=True),\n ArgSig(name=\"projection\", type=\"object\", default=True),\n ArgSig(name=\"apertureOffset\", type=\"float\", default=True),\n ArgSig(name=\"clippingRange\", type=\"Range1f\", default=True),\n ArgSig(name=\"clippingPlanes\", type=\"object\", default=True),\n ArgSig(name=\"fStop\", type=\"float\", default=True),\n ],\n ret_type=\"None\",\n ),\n ]\n\n\ndef test_boost_docstring_multiline_sig():\n docstr = \"\"\"\n\nWriteToFile( (DrawTarget)arg1, (object)attachment, (object)filename [, (Matrix4d)viewMatrix=Gf.Matrix4d(1.0, 0.0, 0.0, 0.0,\n 0.0, 1.0, 0.0, 0.0,\n 0.0, 0.0, 1.0, 0.0,\n 0.0, 0.0, 0.0, 1.0) [, (Matrix4d)projectionMatrix=Gf.Matrix4d(1.0, 0.0, 0.0, 0.0,\n 0.0, 1.0, 0.0, 0.0,\n 0.0, 0.0, 1.0, 0.0,\n 0.0, 0.0, 0.0, 1.0)]]) -> bool\"\"\"\n\n\n@pytest.mark.skip(reason=\"Unclear if both sigs should be found\")\ndef test_boost_docstring_existing_description():\n docstr = \"\"\"\nFind( (object)identifier [, (dict)args={}]) -> Layer :\n Find(filename) -> LayerPtr\n \n filename : string\n \n Returns the open layer with the given filename, or None. Note that this is a static class method.\n\"\"\"\n result = infer_sig_from_boost_docstring(docstr, \"Find\")\n # FIXME: the original test (which hasn't been run regularly) assumed only one match was found.\n # Does USD rely on this behavior?\n # assert result == [\n # FunctionSig(\n # name=\"Find\",\n # args=[\n # ArgSig(name=\"identifier\", type=\"object\", default=False),\n # ArgSig(name=\"args\", type=\"dict\", default=True),\n # ],\n # ret_type=\"Layer\",\n # )\n # ]\n assert result == [\n FunctionSig(\n name=\"Find\",\n args=[\n ArgSig(name=\"identifier\", type=\"object\", default=False),\n ArgSig(name=\"args\", type=\"dict\", default=True),\n ],\n ret_type=\"Layer\",\n ),\n FunctionSig(\n name=\"Find\",\n args=[ArgSig(name=\"filename\", type=None, default=False)],\n ret_type=\"LayerPtr\",\n type_args=\"\",\n ),\n ]\n" }, { "path": "common/tests/test_utils.py", "content": "from __future__ import absolute_import, print_function\n\nfrom mypy.stubgenc import ArgSig, FunctionSig\n\nfrom stubgenlib.utils import merge_signature_kwargs, merge_signatures\n\n\ndef test_basic_merge():\n # ok if argument length does not match:\n assert merge_signatures(\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"first\"),\n ArgSig(\"second\"),\n ],\n ret_type=\"str\",\n ),\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"second\", type=\"str\"),\n ],\n ret_type=\"str\",\n ),\n ) == FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"first\"),\n ArgSig(\"second\", type=\"str\"),\n ],\n ret_type=\"str\",\n )\n\n # extra arguments in the second sig are not copied to the first\n assert merge_signatures(\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"first\"),\n ArgSig(\"second\"),\n ],\n ret_type=\"str\",\n ),\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"third\", type=\"str\"),\n ],\n ret_type=\"str\",\n ),\n ) == FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"first\"),\n ArgSig(\"second\"),\n ],\n ret_type=\"str\",\n )\n\n\ndef test_special_merge():\n dest = FunctionSig(\n name=\"__getitem__\",\n args=[\n ArgSig(\"self\"),\n ArgSig(\"arg\"),\n ],\n ret_type=\"str\",\n )\n assert dest.is_special_method()\n\n assert merge_signatures(\n dest,\n FunctionSig(\n name=\"__getitem__\",\n args=[\n ArgSig(\"self\"),\n # different name\n ArgSig(\"item\", type=\"str\"),\n ],\n ret_type=\"str\",\n ),\n ) == FunctionSig(\n name=\"__getitem__\",\n args=[\n ArgSig(\"self\"),\n ArgSig(\"arg\", type=\"str\"),\n ],\n ret_type=\"str\",\n )\n\n assert merge_signatures(\n FunctionSig(\n name=\"__getitem__\",\n args=[\n ArgSig(\"self\"),\n ArgSig(\"arg\"),\n ],\n ret_type=\"str\",\n ),\n FunctionSig(\n name=\"__getitem__\",\n args=[\n ArgSig(\"self\"),\n # different number of args\n ArgSig(\"first\"),\n ArgSig(\"second\", type=\"str\"),\n ],\n ret_type=\"str\",\n ),\n ) == FunctionSig(\n name=\"__getitem__\",\n args=[\n ArgSig(\"self\"),\n ArgSig(\"arg\"),\n ],\n ret_type=\"str\",\n )\n\n\ndef test_kwarg_merge():\n assert merge_signature_kwargs(\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"*args\", type=\"str\"),\n ArgSig(\"**kwargs\"),\n ],\n ret_type=None,\n ),\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"arg\"),\n ArgSig(\"*\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n ),\n replace_kwargs=True,\n ) == FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"*args\", type=\"str\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n )\n\n # No change in args, bc kwargs is missing\n assert merge_signature_kwargs(\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"*args\", type=\"str\"),\n ],\n ret_type=None,\n ),\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"arg\"),\n ArgSig(\"*\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n ),\n replace_kwargs=True,\n ) == FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"*args\", type=\"str\"),\n ],\n ret_type=\"str\",\n )\n\n assert merge_signature_kwargs(\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"arg\"),\n ArgSig(\"**kwargs\"),\n ],\n ret_type=None,\n ),\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"*\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n ),\n replace_kwargs=True,\n ) == FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"arg\"),\n ArgSig(\"*\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n )\n\n assert merge_signature_kwargs(\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"pos_only\"),\n ArgSig(\"/\"),\n ArgSig(\"pos_or_kw\"),\n ArgSig(\"*\"),\n ArgSig(\"kw_only\"),\n ArgSig(\"**kwargs\"),\n ],\n ret_type=None,\n ),\n FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"*\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n ),\n replace_kwargs=True,\n ) == FunctionSig(\n name=\"foo\",\n args=[\n ArgSig(\"pos_only\"),\n ArgSig(\"/\"),\n ArgSig(\"pos_or_kw\"),\n ArgSig(\"*\"),\n ArgSig(\"kw_only\"),\n ArgSig(\"keyword1\", type=\"str\"),\n ArgSig(\"keyword2\", type=\"int\"),\n ],\n ret_type=\"str\",\n )\n" }, { "path": "houdini/.interpreter", "content": "hython\n" }, { "path": "houdini/README.md", "content": "# Unofficial python stubs for SideFX Houdini\n\nThese stubs are designed to be used with a type checker like `mypy` to provide static type checking of python code, as well as to provide analysis and completion in IDEs like PyCharm and VSCode (with Pylance).\n\n## Installing\n\n```commandline\npip install types-houdini\n```\n\nThe version of the package corresponds to the version of Houdini that it is generated from,\nplus a version suffix for the revision of the stubs\n" }, { "path": "houdini/hou_cleanup_config.py", "content": "\"\"\"Configuration hou stub generation clean up.\n\nThe constants in this module act as overrides for the automatic type annotations we get from\nthe C++ type analysis.\n\"\"\"\n\n_TYPE_ALIAS_COMPONENTS = {\n \"ATTRIB\": [\"int\", \"float\", \"str\"],\n \"PARM\": [\"bool\", \"int\", \"float\", \"str\", \"dict[str, str]\", \"'Ramp'\", \"'Geometry'\"],\n \"PARM_ARG_ONLY\": [\"'Parm'\"],\n \"PARM_RETURN_ONLY\": [\"'OpNode'\"],\n \"OPTION\": [\n \"bool\",\n \"int\",\n \"float\",\n \"str\",\n \"Vector2\",\n \"Vector3\",\n \"Vector4\",\n \"Quaternion\",\n \"Matrix3\",\n \"Matrix4\",\n ],\n \"OPTION_MULTI_ARG\": [\n \"bool\",\n \"int\",\n \"float\",\n \"str\",\n \"Vector2\",\n \"Vector3\",\n \"Vector4\",\n \"Quaternion\",\n \"Matrix3\",\n \"Matrix4\",\n \"Sequence[int]\",\n \"Sequence[float]\",\n ],\n \"OPTION_MULTI_RETURN\": [\n \"bool\",\n \"int\",\n \"float\",\n \"str\",\n \"Vector2\",\n \"Vector3\",\n \"Vector4\",\n \"Quaternion\",\n \"Matrix3\",\n \"Matrix4\",\n \"Tuple[int, ...]\",\n \"Tuple[float, ...]\",\n ],\n}\n\n\ndef get_type_aliases() -> dict[str, str]:\n attrib_arg_types = _TYPE_ALIAS_COMPONENTS[\"ATTRIB\"] + [\n f\"Sequence[{typ}]\" for typ in _TYPE_ALIAS_COMPONENTS[\"ATTRIB\"]\n ]\n attrib_return_types = _TYPE_ALIAS_COMPONENTS[\"ATTRIB\"] + [\n f\"Tuple[{typ}, ...]\" for typ in _TYPE_ALIAS_COMPONENTS[\"ATTRIB\"]\n ]\n\n parm_arg_types = (\n _TYPE_ALIAS_COMPONENTS[\"PARM\"] + _TYPE_ALIAS_COMPONENTS[\"PARM_ARG_ONLY\"]\n )\n parm_return_types = (\n _TYPE_ALIAS_COMPONENTS[\"PARM\"] + _TYPE_ALIAS_COMPONENTS[\"PARM_RETURN_ONLY\"]\n )\n\n result = {\n \"AttribBasicType\": \" | \".join(_TYPE_ALIAS_COMPONENTS[\"ATTRIB\"]),\n \"AttribArgType\": \" | \".join(attrib_arg_types),\n \"AttribDictArgType\": \" | \".join(\n f\"dict[str, {typ}]\" for typ in attrib_arg_types\n ),\n \"AttribReturnType\": \" | \".join(attrib_return_types),\n \"AttribDictReturnType\": \" | \".join(\n f\"dict[str, {typ}]\" for typ in attrib_return_types\n ),\n \"ParmArgType\": \" | \".join(parm_arg_types),\n \"ParmReturnType\": \" | \".join(parm_return_types),\n \"ParmTupleArgType\": \" | \".join(f\"Sequence[{typ}]\" for typ in parm_arg_types),\n \"ParmTupleReturnType\": \" | \".join(\n f\"Tuple[{typ}, ...]\" for typ in parm_return_types\n ),\n \"OptionType\": \" | \".join(_TYPE_ALIAS_COMPONENTS[\"OPTION\"]),\n \"OptionSequenceType\": \" | \".join(\n f\"Sequence[{typ}]\" for typ in _TYPE_ALIAS_COMPONENTS[\"OPTION\"]\n ),\n \"OptionMultiArgType\": \" | \".join(_TYPE_ALIAS_COMPONENTS[\"OPTION_MULTI_ARG\"]),\n \"OptionMultiReturnType\": \" | \".join(\n _TYPE_ALIAS_COMPONENTS[\"OPTION_MULTI_RETURN\"]\n ),\n }\n\n return result\n\n\nTYPE_ALIASES = get_type_aliases()\n\n\nADDITIONAL_ENUM_NAMES = {\n \"fbxMaterialMode\": {\n \"FBXShaderNodes\",\n \"PrincipledShaders\",\n \"VopNetworks\",\n },\n \"fbxCompatibilityMode\": {\n \"FBXStandard\",\n \"Maya\",\n },\n \"_ik_targetType\": {\n \"All\",\n \"Orientation\",\n \"Position\",\n },\n \"parmTemplateType\": {\n \"Folder\",\n \"Data\",\n },\n \"optionalBool\": {\n \"Yes\",\n \"No\",\n \"NoOpinion\",\n },\n}\n\n\n# These will be added at the end of the stubs.\nMISSING_CLASSES = {\n # hou.data comes from the houpythonportion.data module, but is accessible via hou\n None: {\n \"_PointTupleGenerator\": [\n \"def __getitem__(self, key: int) -> Point\",\n \"def __len__(self) -> int\",\n \"def __repr__(self) -> str\",\n ],\n \"_PrimTupleGenerator\": [\n \"def __getitem__(self, key: int) -> Prim\",\n \"def __len__(self) -> int\",\n \"def __repr__(self) -> str\",\n ],\n \"_EdgeTupleGenerator\": [\n \"def __getitem__(self, key: int) -> Edge\",\n \"def __len__(self) -> int\",\n \"def __repr__(self) -> str\",\n ],\n \"_VertexTupleGenerator\": [\n \"def __getitem__(self, key: int) -> Vertex\",\n \"def __len__(self) -> int\",\n \"def __repr__(self) -> str\",\n ],\n \"data\": [\n \"@staticmethod\\ndef clusterItemsAsData(items: Sequence[NetworkMovableItem], target_node: OpNode, frame_nodes: Sequence[NetworkMovableItem]=..., selected_nodes: Sequence[NetworkMovableItem]=..., current_node: NetworkMovableItem =..., flags: bool=True, nodes_only: bool=False, target_children: bool=False, children: bool=True, target_editables: bool=False, editables: bool=True, target_parms: Union[bool, Sequence[ParmTuple], Sequence[str]]=True, parms: bool=True, default_parmvalues: bool=False, evaluate_parmvalues: bool=False, parms_as_brief: bool=True, parmtemplates: str=..., metadata: bool=False, verbose: bool=False) -> dict[str, Any]\",\n \"@staticmethod\\ndef createClusterItemsFromData(parent: OpNode, data: dict[str, Any], target_node: OpNode=..., clear_content=False, force_item_creation: bool=True, external_connections: bool=True, parms: bool=True, parmtemplates: bool=True, children: bool=True, editables: bool=True, offset_position: Vector2=..., skip_notes: bool=False) -> dict[str, NetworkMovableItem]\",\n \"@staticmethod\\ndef createItemsFromData(parent: OpNode, data: dict[str, Any], clear_content: bool=False, force_item_creation: bool=True, offset_position: Vector2=..., external_connections: bool=True, parms: bool=True, parmtemplates: bool=True, children: bool=True, editables: bool=True, skip_notes: bool=False) -> dict[str, NetworkMovableItem]\",\n \"@staticmethod\\ndef dataFromParms(parms: Sequence[ParmTuple], values: bool=True, evaluate_values: bool=False, locked: bool=True, brief: bool=True, multiparm_instances: bool=True, metadata: bool=False, verbose: bool=False) -> dict[str,Any]\",\n \"@staticmethod\\ndef itemsAsData(items: Sequence[NetworkMovableItem], nodes_only: bool=False, children: bool=True, editables:bool=True, inputs: bool=True, position: bool=True, anchor_position: Vector2=..., flags: bool=True, parms: bool=True, parms_as_brief: bool=True, default_parmvalues: bool=False, evaluate_parmvalues: bool=False, parmtemplates: str=..., metadata: bool=False, verbose: bool=False) -> dict[str, Any]\",\n \"@staticmethod\\ndef selectedItemsAsData(nodes_only: bool=False, children: bool=True, editables: bool=True, inputs: bool=True, position: bool=True, anchor_position: Vector2=..., flags: bool=True, parms: bool=True, parms_as_brief: bool=True, default_parmvalues: bool=False, evaluate_parmvalues: bool=False, parmtemplates: str=..., metadata: bool=False, verbose: bool=False) -> dict[str, Any]\",\n ],\n },\n \"qt\": {\n \"ColorField(QtWidgets.QWidget)\": [\n \"def __init__(self, label: str ='', include_alpha: bool = False) -> None\",\n \"def color(self) -> QtGui.QColor\",\n \"def setColor(self, color: QtGui.QColor) -> None\",\n ],\n \"ColorPalette(QtWidgets.QFrame)\": [\n \"paletteChanged: QtCore.Signal # QtCore.Signal()\",\n \"colorEdited: QtCore.Signal # QtCore.Signal(int, QtGui.QColor, QtGui.QColor)\",\n \"colorSelected: QtCore.Signal # QtCore.Signal(int, QtGui.QColor)\",\n \"colorAccepted: QtCore.Signal # QtCore.Signal(int, QtGui.QColor)\",\n \"colorCancelled: QtCore.Signal # QtCore.Signal()\",\n \"def __init__(self, colors: Sequence[QtGui.QColor] | None =None, size: int = 32, by_column: bool = False, show_at_pointer: bool = True, columns: int | None =None, rows: int | None =None, allow_editing:bool=True, selected_index: int=-1, bg_color: QtGui.QColor | QtGui.QBrush | None=None, empty_color: QtGui.QColor | QtGui.QBrush | None = None, parent: QtWidgets.QWidget | None =None) -> None\",\n \"def color(self, index: int) -> None\",\n \"def colorCount(self) -> int\",\n \"def colorList(self) -> list[QtGui.QColor]\",\n \"def isEditingAllowed(self) -> bool\",\n \"def selectedColor(self) -> QtGui.QColor\",\n \"def selectedIndex(self) -> int\",\n \"def setColor(self, index: int, color: QtGui.QColor) -> None\",\n \"def setColorList(self, colors: Sequence[QtGui.QColor]) -> None\",\n \"def setEditingAllowed(self, allowed: bool) -> None\",\n \"def setSelectedIndex(self, index: int) -> None\",\n \"def setSwatchSize(self, size: int) -> None\",\n \"def swatchSize(self) -> int\",\n ],\n \"ColorSwatchButton(QtWidgets.QPushButton)\": [\n \"PositionOff: int\",\n \"PositionTop: int\",\n \"PositionBottom: int\",\n \"PositionLeft: int\",\n \"PositionRight: int\",\n \"PositionAll: int\",\n \"colorChanged: QtCore.Signal # QtCore.Signal(QtGui.QColor)\",\n \"def __init__(self, include_alpha: bool=False) -> None\",\n \"def color(self) -> QtGui.QColor\",\n \"def hasAlpha(self) -> bool\",\n \"def secondaryColor(self) -> QtGui.QColor\",\n \"def secondaryColorPosition(self) -> int\",\n \"def setColor(self, color: QtGui.QColor) -> None\",\n \"def setSecondaryColor(self, color: QtGui.QColor) -> None\",\n \"def setSecondaryColorPosition(self, position: int) -> None\",\n ],\n \"ComboBox(QtWidgets.QComboBox)\": [\n \"def __init__(self) -> None\",\n ],\n \"Dialog(QtWidgets.QDialog)\": [\n \"def __init__(self) -> None\",\n ],\n \"FieldLabel(QtWidgets.QLabel)\": [\n \"def __init__(self, label: str) -> None\",\n ],\n \"FileChooserButton(QtWidgets.QToolButton)\": [\n \"fileSelected: QtCore.Signal # QtCore.Signal(str)\",\n \"def __init__(self) -> None\",\n \"def setFileChooserDefaultValue(self, default_value: str) -> None\",\n \"def setFileChooserFilter(self, file_filter: EnumValue) -> None\",\n \"def setFileChooserIsImageChooser(self, is_image_chooser: bool) -> None\",\n \"def setFileChooserMode(self, chooser_mode: EnumValue) -> None\",\n \"def setFileChooserMultipleSelect(self, multiple_select: bool) -> None\",\n \"def setFileChooserPattern(self, file_pattern: str) -> None\",\n \"def setFileChooserStartDirectory(self, start_dir: str) -> None\",\n \"def setFileChooserTitle(self, title: str) -> None\",\n ],\n \"FileLineEdit(QtWidgets.QLineEdit)\": [\n \"def __init__(self, icon: QtGui.QIcon | str | None = None, parent: QtWidgets.QWidget | None = None) -> None\",\n ],\n \"GridLayout(QtWidgets.QGridLayout)\": [\n \"def __init__(self) -> None\",\n ],\n \"HelpButton(QtWidgets.QToolButton)\": [\n \"def __init__(self, help_path: str, tooltip: str = ...) -> None\",\n ],\n \"Icon(QtGui.QIcon)\": [\n \"def __init__(self, icon_name: str, width: int | None = None, height: int | None = None) -> None\",\n ],\n \"InputField(QtWidgets.QWidget)\": [\n \"IntegerType: int\",\n \"FloatType: int\",\n \"StringType: int\",\n \"valueChanged: QtCore.Signal # QtCore.Signal()\",\n \"hotkeyInvoked: QtCore.Signal # QtCore.Signal(str)\",\n \"editingFinished: QtCore.Signal # QtCore.Signal(list)\",\n \"ladderChanged: QtCore.Signal # QtCore.Signal()\",\n \"def __init__(self, data_type: int, num_components: int, label: str | None=..., mouse_hotkeys: Any | None = None, size_policy: QtWidgets.QSizePolicy | None=None, notify_pending_changes: bool=True, parent: QtWidgets.QWidget | None=None) -> None\",\n \"def menu(self) -> QtWidgets.QMenu\",\n \"def onContextMenuEvent(self, event: QtGui.QContextMenuEvent, context_menu: QtWidgets.QMenu) -> None\",\n \"def onMousePressEvent(self, event: QtGui.QMouseEvent) -> None\",\n \"def onMouseWheelEvent(self, event: QtGui.QWheelEvent) -> None\",\n \"def setAlignment(self, a: QtCore.Qt.Alignment | QtCore.Qt.AlignmentFlag) -> None\",\n \"def setMenu(self, menu: QtWidgets.QMenu) -> None\",\n \"def setState(self, state_name: str, state_value: bool, index: int = 0) -> None\",\n \"def setValidator(self, validator: QtGui.QValidator) -> None\",\n \"def setValue(self, value: int | float | str | None, index: int = 0) -> None\",\n \"def setValues(self, values: Sequence[int] | Sequence[float] | Sequence[str]) -> None\",\n \"def setWidth(self, width: float) -> None\",\n \"def state(self, state_name: str, index: int = 0) -> bool\",\n \"def value(self, index: int = 0) -> int | float | str\",\n \"def values(self) -> list[int] | list[float] | list[str]\",\n ],\n \"ListEditor(QtWidgets.QFrame)\": [\n \"listChanged: QtCore.Signal # QtCore.Signal()\",\n \"checkChanged: QtCore.Signal # QtCore.Signal(int, str, bool)\",\n \"itemEdited: QtCore.Signal # QtCore.Signal(int, str)\",\n \"def __init__(self, strings: Sequence[str]=..., top_message: str | None=None, bottom_message: str | None=None, allow_editing: bool=True, allow_add_remove: bool=True, allow_reorder: bool=True, allow_empty_string: bool =True, show_checkboxes: bool=False, keep_sorted: bool = False, initial_string: str = '', initial_check: bool = True, exclusive_check: bool = False, allow_empty_list: bool = True, parent: QtWidgets.QWidget | None = None) -> None\",\n \"def addListItem(self, text: str, checked: bool | None=None, insert_at: int=-1) -> None\",\n \"def bottomMessage(self) -> str\",\n \"def checkedRow(self) -> int | None\",\n \"def checkedRows(self) -> list[int]\",\n \"def checkedString(self) -> str | None\",\n \"def checkedStrings(self) -> list[str]\",\n \"def clear(self) -> None\",\n \"def initialCheck(self) -> bool\",\n \"def initialString(self) -> str\",\n \"def isAddRemoveAllowed(self) -> bool\",\n \"def isEditingAllowed(self) -> bool\",\n \"def isEmptyListAllowed(self) -> bool\",\n \"def isEmptyStringAllowed(self) -> bool\",\n \"def isReorderAllowed(self) -> bool\",\n \"def itemCount(self) -> int\",\n \"def keepSorted(self) -> bool\",\n \"def removeRow(self, row_num: int) -> None\",\n \"def rowIsChecked(self, row_num: int) -> bool\",\n \"def rowString(self, row_num: int) -> str\",\n \"def setAllowAddRemove(self, allow: bool) -> None\",\n \"def setAllowEditing(self, allow: bool) -> None\",\n \"def setAllowEmptyList(self, allow: bool) -> None\",\n \"def setAllowEmptyString(self, allow: bool) -> None\",\n \"def setAllowReorder(self, allow: bool) -> None\",\n \"def setBottomMessage(self, text: str) -> None\",\n \"def setInitialCheck(self, checked: bool) -> None\",\n \"def setInitialString(self, text: str) -> None\",\n \"def setKeepSorted(self, keep_sorted: bool) -> None\",\n \"def setRowChecked(self, row_num: int, checked: bool) -> None\",\n \"def setShowCheckboxes(self, show: bool) -> None\",\n \"def setStrings(self, strings: Sequence[str]) -> None\",\n \"def setStringsAndChecks(self, strings_and_checks: Sequence[tuple[str, bool]]) -> None\",\n \"def setTopMessage(self, text: str) -> None\",\n \"def showCheckboxes(self) -> bool\",\n \"def strings(self) -> list[str]\",\n \"def stringsAndChecks(self) -> list[tuple[str, bool]]\",\n \"def topMessage(self) -> str\",\n ],\n \"ListEditorDialog(QtWidgets.QDialog)\": [\n \"def __init__(self, parent: QtWidgets.QWidget | None = None, window_type: QtCore.Qt.WindowType = ..., strings: Sequence[str]=..., top_message: str | None=None, bottom_message: str | None=None, allow_editing: bool=True, allow_add_remove: bool=True, allow_reorder: bool=True, allow_empty_string: bool =True, show_checkboxes: bool=False, keep_sorted: bool = False, initial_string: str = '', initial_check: bool = True, exclusive_check: bool = False, allow_empty_list: bool = True) -> None\",\n \"def editor(self) -> qt.ListEditor\",\n ],\n \"Menu(QtWidgets.QMenu)\": [\n \"def __init__(self) -> None\",\n ],\n \"MenuBar(QtWidgets.QMenuBar)\": [\n \"def __init__(self, parent: QtWidgets.QWidget | None=None) -> None\",\n ],\n \"MenuButton(QtWidgets.QPushButton)\": [\n \"def __init__(self, menu: QtWidgets.QMenu) -> None\",\n ],\n \"MixerFilterProxyModel(QtCore.QSortFilterProxyModel)\": [],\n \"NodeChooserButton(QtWidgets.QToolButton)\": [\n \"nodeSelected: QtCore.Signal # QtCore.Signal(object)\",\n \"nodePathsSelected: QtCore.Signal # QtCore.Signal(str)\",\n \"chooserStarted: QtCore.Signal # QtCore.Signal()\",\n \"def __init__(self) -> None\",\n \"def setNodeChooserFilter(self, node_filter: EnumValue) -> None\",\n \"def setNodeChooserInitialNode(self, initial_node: OpNode) -> None\",\n \"def setNodeChooserRelativeToNode(self, relative_to_node: OpNode) -> None\",\n \"def setSelectMultiple(self, value: bool) -> None\",\n ],\n \"ParmChooserButton(QtWidgets.QToolButton)\": [\n \"parmSelected: QtCore.Signal # QtCore.Signal(object)\",\n \"def __init__(self) -> None\",\n \"def setCategoryFilter(self, category_filter: EnumValue) -> None\",\n \"def setInitialSelection(self, initial_selection: OpNode) -> None\",\n \"def setRelativeToNode(self, relative_to_node: OpNode) -> None\",\n \"def setSelectMultiple(self, value: bool) -> None\",\n ],\n \"ParmDialog(QtWidgets.QWidget)\": [\n \"def __init__(self, node: OpNode | None, showTitleBar: bool = False, compact: bool = False, labelsize: float = -1.0) -> None\",\n \"def multiParmTab(self, parm: str) -> None\",\n \"def node(self) -> OpNode\",\n \"def scrollPosition(self) -> Vector2\",\n \"def setMultiParmTab(self, parm: str, index) -> None\",\n \"def setNode(self, node: OpNode | None) -> None\",\n \"def setScrollPosition(self, pos: Vector2) -> None\",\n \"def visibleParms(self) -> tuple[ParmTuple, ...]\",\n ],\n \"ParmTupleChooserButton(QtWidgets.QToolButton)\": [\n \"parmTupleSelected: QtCore.Signal # QtCore.Signal(object)\",\n \"def __init__(self) -> None\",\n \"def setCategoryFilter(self, category_filter: EnumValue) -> None\",\n \"def setInitialSelection(self, initial_selection: OpNode) -> None\",\n \"def setRelativeToNode(self, relative_to_node: OpNode) -> None\",\n \"def setSelectMultiple(self, value: bool) -> None\",\n ],\n \"SearchLineEdit(QtWidgets.QLineEdit)\": [\n \"searchBackward: QtCore.Signal # QtCore.Signal()\",\n \"def __init__(self, icon: QtGui.QIcon | str | None = None, parent: QtWidgets.QWidget | None = None) -> None\",\n \"def allowSearchBackward(self) -> bool\",\n \"def setAllowSearchBackward(self, on: bool) -> None\",\n ],\n \"Separator(QtWidgets.QFrame)\": [\n \"def __init__(self) -> None\",\n ],\n \"ToolTip(QtWidgets.QWidget)\": [\n \"def __init__(self) -> None\",\n \"def setHelpUrl(self, help_url: str) -> None\",\n \"def setHotkey(self, hotkey: str) -> None\",\n \"def setTargetWidget(self, widget: QtWidgets.QWidget) -> None\",\n \"def setText(self, text: str) -> None\",\n \"def setTitle(self, title: str) -> None\",\n ],\n \"TrackChooserButton(QtWidgets.QToolButton)\": [\n \"trackSelected: QtCore.Signal # QtCore.Signal(object)\",\n \"def __init__(self) -> None\",\n \"def setInitialSelection(self, initial_track: Track) -> None\",\n \"def setNodeChooserFilter(self, node_filter: EnumValue) -> None\",\n \"def setSelectMultiple(self, value: bool) -> None\",\n ],\n \"WindowOverlay(QtWidgets.QWidget)\": [\n \"def __init__(self, parent: qt.Window, win_floating_panel: QtWidgets.QWidget | None) -> None\",\n \"def onContainerWindowEvent(self, event: QtCore.QEvent) -> None\",\n \"def onInitWindow(self) -> None\",\n \"def onParentWindowEvent(self, event: QtCore.QEvent) -> None\",\n \"def windowContainer(self) -> QtWidgets.QWidget\",\n ],\n \"Window(QtWidgets.QWidget)\": [\n \"def __init__(self) -> None\",\n ],\n \"ViewerOverlay(WindowOverlay)\": [\n \"def __init__(self, scene_viewer: SceneViewer) -> None\",\n \"def moveBy(self, delta: QtCore.QPoint) -> None\",\n \"def moveTo(self, pos: QtCore.QPoint) -> None\",\n \"def onBeginResize(self) -> None\",\n \"def onColorSchemeChanged(self) -> None\",\n \"def onEndResize(self) -> None\",\n \"def onInitWindow(self) -> None\",\n \"def onLayoutChanged(self) -> None\",\n \"def onMoveContainerWindow(self, new_pos: QtCore.QPoint, old_pos: QtCore.QPoint) -> None\",\n \"def onResizing(self) -> None\",\n \"def onSizeChanged(self) -> None\",\n \"def onViewerActivated(self) -> None\",\n \"def onViewerDeactivated(self) -> None\",\n \"def onWindowPlacement(self) -> None\",\n \"def sceneViewer(self) -> SceneViewer\",\n ],\n \"XMLMenuParser(object)\": [\n \"def __init__(self, context: str ='', kwargs: dict[str, Any] | None=None, kwargsfunc=Callable, xmlfilename: Path | str | None=None, xmlstring: str | None=None) -> None\",\n \"def generateMenu(self, kwargs: dict[str, Any], menu:qt.Menu | None=None, actionitem_callback: Callable[[str], None] | None=None) -> None\",\n \"def handleKeyPress(self, keystring: str, kwargs: dict[str, Any], actionitem_callback: Callable | None=None, hotkey_context: str | None=None) -> None\",\n \"def hotkeyContext(self) -> str\",\n \"def parseFile(self, xmlfile: Path | str) -> None\",\n \"def parseFiles(self, xmlfilename: str) -> None\",\n \"def parseString(self, xmlstring: str) -> None\",\n \"def setHotkeyContext(self, hotkey_context) -> None\",\n ],\n },\n}\n\n\n# Define functions that are missing entirely from hou.py\n# This may come from the houpythonportion package, which patches these methods\n# in via a setattr decorator.\n# WARNING: Try not to redefine functions that are deprecated and have been removed from hou.py\nMISSING_DEFINITIONS = {\n # Missing module level imports are sorted into the `None` class.\n None: [\n # NOTE: These are left as an example of deprecated functions that should not be added.\n # \"def expandString(text: str) -> str\",\n # \"def expandStringAtFrame(text: str, frame_number: float) -> str\",\n ],\n \"Agent\": [\n \"def clipCatalog(self) -> AgentClip\",\n \"def layers(self) -> AgentLayer\",\n \"def rig(self) -> AgentRig\",\n \"def shapeLibrary(self) -> AgentShapeLibrary\",\n ],\n \"NetworkItem\": [\n \"def __lt__(self, other: object) -> bool\",\n \"def __le__(self, other: object) -> bool\",\n \"def __gt__(self, other: object) -> bool\",\n \"def __ge__(self, other: object) -> bool\",\n \"def __eq__(self, other: object) -> bool\",\n \"def __ne__(self, other: object) -> bool\",\n ],\n \"Node\": [\n \"def createOutputNode(self, node_type_name: str, node_name: str | None = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False) -> Self\",\n \"def createInputNode(self, input_index: int, node_type_name: str, node_name: str | None = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False) -> Self\",\n \"def creationTime(self) -> datetime.datetime\",\n \"def modificationTime(self) -> datetime.datetime\",\n \"def outputsWithIndices(self, ignore_network_dots: bool = False, use_names: bool = False) -> list[tuple[NetworkMovableItem, int | str, int | str]]\",\n ],\n \"OpNode\": [\n \"def appendParmTemplatesFromData(self, data: dict[str, Any], rename_conflicts: bool = True) -> dict[str, ParmTuple]\",\n \"def appendParmTemplatesToFolderFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]\",\n \"def asData(self, nodes_only: bool = False, children: bool = False, editables: bool = False, inputs: bool = False, position: bool = False, flags: bool = False, parms: Union[bool, Sequence[ParmTuple], Sequence[str]]=True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]\",\n \"def children(self) -> Tuple[OpNode, ...]\",\n \"def childrenAsData(self, nodes_only: bool = False, children: bool = True, editables: bool = True, inputs: bool = True, position: bool = True, flags: bool = True, parms: bool = True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]\",\n \"def createDecorationItemsFromData(self, items: Sequence[NetworkMovableItem], frame_nodes: Sequence[NetworkMovableItem] | None=None, selected_nodes: Sequence[NetworkMovableItem] | None=None, current_node: NetworkMovableItem | None=None, flags: bool = True, nodes_only: bool = False, target_children: bool = False, children: bool = True, target_editables: bool = False, editables: bool = True, target_parms: Union[bool, Sequence[ParmTuple], Sequence[str]]=True, parms: bool = True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]\",\n \"def createNode(self, node_type_name: str, node_name: str | None = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False, force_valid_node_name: bool = False) -> OpNode\",\n \"def editablesAsData(self, nodes_only: bool = False, children: bool = True, editables: bool = True, inputs: bool = True, position: bool = True, flags: bool = True, parms: bool = True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]\",\n \"def inputConnections(self) -> Tuple[OpNodeConnection, ...]\",\n \"def inputsAsData(self, ignore_network_dots: bool = False, ignore_subnet_indirect_inputs: bool = False, use_names: bool = False) -> Sequence[dict[str, Any]]\",\n \"def insertParmTemplatesAfterFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]\",\n \"def insertParmTemplatesBeforeFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]\",\n \"def node(self, node_path: str) -> OpNode | None\",\n \"def outputConnections(self) -> Tuple[OpNodeConnection, ...]\",\n \"def outputsAsData(self, ignore_network_dots: bool = False, ignore_subnet_indirect_inputs: bool = False, use_names: bool = False) -> Sequence[dict[str, Any]]\",\n \"def parmTemplateChildrenAsData(self, name: str= '', parmtemplate_order: bool = False) -> dict[str, Any]\",\n \"def parmTemplatesAsData(self, name: str= '', children: bool = True, parmtemplate_order: bool = False) -> dict[str, Any]\",\n \"def parmsAsData(self, values: bool = True, parms: bool = True, default_values: bool = False, evaluate_values: bool = False, locked: bool = True, brief: bool = True, multiparm_instances: bool = True, metadata: bool = False, verbose: bool = False) -> dict[str, Any]\",\n \"def prependParmTemplatesToFolderFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]\",\n \"def replaceParmTemplatesFromData(self, data: dict[str, Any]) -> dict[str, ParmTuple]\",\n \"def setChildrenFromData(self, clear_content: bool = True, force_item_creation: bool = True, offset_position: Vector2=..., external_connections: bool = True, parms: bool = True, parmtemplates: bool = True, children: bool = True, editables: bool = True, skip_notes: bool = False) -> None\",\n \"def setEditablesFromData(self, clear_content: bool = True, force_item_creation: bool = True, offset_position: Vector2=..., external_connections: bool = True, parms: bool = True, parmtemplates: bool = True, children: bool = True, editables: bool = True, skip_notes: bool = False) -> None\",\n \"def setFromData(self, data: dict[str, Any], clear_content: bool = False, force_item_creation: bool = True, parms: bool = True, parmtemplates: bool = True, children: bool = True, editables: bool = True, skip_notes: bool = False) -> None\",\n \"def setInputsFromData(self, data: dict[str, Any]) -> None\",\n \"def setOutputsFromData(self, data: dict[str, Any]) -> None\",\n \"def setParmExpressions(self, parm_dict: Mapping[str, str | Sequence[str]], language: EnumValue | None = None, replace_expressions: bool = True) -> None\",\n \"def setParms(self, parm_dict: Mapping[str, ParmArgType | ParmTupleArgType]) -> None\",\n \"def setParmsFromData(self, data: dict[str, Any]) -> None\",\n \"def type(self) -> OpNodeType\",\n ],\n \"OpNodeType\": [\n \"def category(self) -> OpNodeTypeCategory\",\n ],\n \"OpNodeTypeCategory\": [\n \"def nodeTypes(self) -> dict[str, OpNodeType]\",\n \"def nodeType(self, type_name: str) -> Optional[OpNodeType]\",\n ],\n \"Parm\": [\n \"def appendMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]]) -> None\",\n \"def asData(self, value: bool=True, evaluate_value=False, locked: bool=True, brief: bool=True, multiparm_instances: bool=True, metadata: bool=False, verbose: bool=False, default_values: bool=...) -> dict[str, Any]\",\n \"def clipData(self, start:float|None=None, end:float|None=None, binary:bool=True, use_blosc_compression: bool=True, sample_rate:float=0) -> bytes\",\n \"def insertMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]], index: int=0) -> None\",\n \"def insertTemplatesFromData(self, data: dict[str, Any], operation: str=..., rename_conflicts:bool=True) -> None\",\n \"def multiParmInstancesAsData(self, start_index: int=0, end_index: int=-1, value: bool = True, evaluate_value: bool = False, links: bool = True, locked: bool = True, brief: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]\",\n \"def rampPointsAsData(self, evaluate: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]\",\n \"def saveClip(self, file_name:str, start:float|None=None, end:float|None=None, sample_rate: float=0) -> None\",\n \"def set(self, value: int | float | str | dict[str, str] | Parm | Ramp | Geometry, language: EnumValue | None = None, follow_parm_reference: bool = True) -> None\",\n \"def setFromData(self, data: dict[str, Any]) -> None\",\n \"def setMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]]) -> None\",\n \"def setRampPointsFromData(self, data: Sequence[dict[str, Any]]) -> None\",\n \"def setValueFromData(self, data: int | str | float | dict[str, Any] | Sequence[int] | Sequence[float] | Sequence[str]) -> None\",\n \"def templateAsData(self, children: bool = True) -> dict[str, Any]\",\n \"def templateChildrenAsData(self, parmtemplate_order: bool = False) -> dict[str, Any]\",\n \"def valueAsData(self, evaluate: bool = True, verbose: bool = True) -> int | str | float | dict[str, Any] | list[int] | list[float] | list[str]\",\n ],\n \"ParmTuple\": [\n \"def __iter__(self) -> Iterator[Parm]\",\n \"def asData(self, value: bool=True, evaluate_value=False, locked: bool=True, brief: bool=True, multiparm_instances: bool=True, metadata: bool=False, verbose: bool=False, default_values: bool=...) -> dict[str, Any]\",\n \"def clipData(self, start:float|None=None, end:float|None=None, binary:bool=True, use_blosc_compression: bool=True, sample_rate:float=0) -> bytes\",\n \"def insertMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]], index: int=0) -> None\",\n \"def insertTemplatesFromData(self, data: dict[str, Any], operation: str = ..., rename_conflicts: bool = True) -> None\",\n \"def multiParmInstancesAsData(self, start_index: int=0, end_index: int=-1, value: bool = True, evaluate_value: bool = False, links: bool = True, locked: bool = True, brief: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]\",\n \"def rampPointsAsData(self, evaluate: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]\",\n \"def saveClip(self, file_name:str, start:float|None=None, end:float|None=None, sample_rate: float=0) -> None\",\n \"def set(self, value: Sequence[int] | Sequence[float] | Sequence[str] | Sequence[Parm] | ParmTuple, language: EnumValue | None = None, follow_parm_reference: bool = True) -> None\",\n \"def setFromData(self, data: dict[str, Any]) -> None\",\n \"def setMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]]) -> None\",\n \"def setRampPointsFromData(self, data: Sequence[dict[str, Any]]) -> None\",\n \"def setValueFromData(self, data: int | str | float | dict[str, Any] | Sequence[int] | Sequence[float] | Sequence[str]) -> None\",\n \"def templateAsData(self, children: bool = True, parmtemplate_order: bool = False) -> dict[str, Any]\",\n \"def templateChildrenAsData(self, parmtemplate_order: bool = False) -> dict[str, Any]\",\n \"def valueAsData(self, evaluate: bool = True, verbose: bool = True) -> int | str | float | dict[str, Any] | list[int] | list[float] | list[str]\",\n ],\n \"Prim\": [\n \"def voxelRangeAsBool(self, range: BoundingBox) -> Tuple[bool, ...]\",\n \"def voxelRangeAsInt(self, range: BoundingBox) -> Tuple[int, ...]\",\n \"def voxelRangeAsFloat(self, range: BoundingBox) -> Tuple[float, ...]\",\n \"def voxelRangeAsVector3(self, range: BoundingBox) -> Sequence[Vector3]\",\n ],\n \"Geometry\": [\n \"def pointAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]\",\n \"def primAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]\",\n \"def vertexAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]\",\n \"def globalAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]\",\n ],\n \"Vector2\": [\n \"def __contains__(self, other: float) -> bool\",\n \"def __iter__(self) -> Iterator[float]\",\n \"def __reversed__(self) -> Iterator[float]\",\n ],\n \"Vector3\": [\n \"def __contains__(self, other: float) -> bool\",\n \"def __iter__(self) -> Iterator[float]\",\n \"def __reversed__(self) -> Iterator[float]\",\n ],\n \"Vector4\": [\n \"def __contains__(self, other: float) -> bool\",\n \"def __iter__(self) -> Iterator[float]\",\n \"def __reversed__(self) -> Iterator[float]\",\n ],\n \"hda\": [\n \"@staticmethod\\ndef reloadHDAModule(hda_module: HDAModule) -> None\",\n ],\n \"hipFile\": {\n \"@staticmethod\\ndef addEventCallback(callback: Callable[[EnumValue], None]) -> None\",\n \"@staticmethod\\ndef removeEventCallback(callback: Callable[[EnumValue], None]) -> None\",\n \"@staticmethod\\ndef eventCallbacks() -> Tuple[Callable[[EnumValue], None], ...]\",\n },\n \"qt\": [\n \"@staticmethod\\ndef mainWindow() -> QtWidgets.QMainWindow\",\n ],\n \"ui\": [\n \"@staticmethod\\ndef selectFile(start_directory: str | None = None, title: str | None = None, collapse_sequences: bool = False, file_type: EnumValue = fileType.Any, pattern: str | None = None, default_value: str | None = None, multiple_select: bool = False, image_chooser: bool = False, chooser_mode: EnumValue = fileChooserMode.ReadAndWrite, width: int = 0, height: int = 0) -> str\",\n \"@staticmethod\\ndef selectNode(relative_to_node: Node | None = None, initial_node: Node | None = None, node_type_filter: EnumValue | None = None, title: str | None = None, width: int = 0, height: int = 0, multiple_select: bool = False, custom_node_filter_callback: Callable[[Node], bool] | None = None) -> str | Tuple[str, ...] | None\",\n \"@staticmethod\\ndef openTypePropertiesDialog(node_or_node_type: OpNode | OpNodeType, promote_spare_parms: bool=False, immediately_save: bool=False) -> None\",\n ],\n}\n\n\n# Functions that return these types are never optional.\nNON_OPTIONAL_RETURN_TYPES = {\n \"EnumValue\",\n \"Iterator\",\n \"Matrix2\",\n \"Matrix3\",\n \"Matrix4\",\n \"Quaternion\",\n \"Tuple\",\n \"Vector2\",\n \"Vector3\",\n \"Vector4\",\n \"std.vector\",\n \"tuple\",\n}\n\n\n# Functions that are not Optional returns, even though they are pointers.\nNON_OPTIONAL_RETURN_FUNCTIONS = {\n None: {\n \"root\",\n \"pwd\",\n \"phm\",\n \"currentDopNet\",\n \"createApexRootNode\",\n \"nodeTypeCategories\",\n \"addNodeBundle\",\n },\n \"_clone_Connection\": {\n \"duplicate\",\n \"lopNode\",\n },\n \"_ik_Target\": {\n \"joint\",\n },\n \"Face\": {\n \"addVertex\",\n \"vertex\",\n },\n \"Agent\": {\n \"collisionLayer\",\n \"currentLayer\",\n \"definition\",\n },\n \"AgentClip\": {\n \"freeze\",\n },\n \"AgentDefinition\": {\n \"freeze\",\n \"metadata\",\n \"rig\",\n \"shapeLibrary\",\n },\n \"AgentMetadata\": {\n \"freeze\",\n },\n \"AgentRig\": {\n \"freeze\",\n },\n \"AgentShape\": {\n \"freeze\",\n \"geometry\",\n },\n \"AgentShapeBinding\": {\n \"deformer\",\n \"shape\",\n },\n \"AgentShapeLibrary\": {\n \"addShape\",\n \"data\",\n \"freeze\",\n },\n \"Attrib\": {\n \"dataId\",\n \"geometry\",\n },\n \"ChannelGraphSelection\": {\n \"animBar\",\n \"channelList\",\n \"graph\",\n \"parm\",\n },\n \"ChannelPrim\": {\n \"addVertex\",\n \"vertex\",\n },\n \"ChopNode\": {\n \"addVertex\",\n \"clip\",\n },\n \"Color\": {\n \"ocio_transform\",\n \"ocio_viewTransform\",\n },\n \"ConstructionPlane\": {\n \"sceneViewer\",\n \"transform\",\n },\n \"DataParmTemplate\": {\n \"defaultExpressionLanguage\",\n },\n \"Desktop\": {\n \"createFloatingPane\",\n \"createFloatingPaneTab\",\n \"shelfDock\",\n },\n \"DopData\": {\n \"createSubData\",\n \"freeze\",\n \"options\",\n \"simulation\",\n },\n \"DopNode\": {\n \"pythonSolverData\",\n \"simulation\",\n },\n \"DopSimulation\": {\n \"dopNetNode\",\n },\n \"Edge\": {\n \"geometry\",\n },\n \"EdgeGroup\": {\n \"dataId\",\n \"geometry\",\n },\n \"FlipbookSettings\": {\n \"stash\",\n },\n \"Gallery\": {\n \"createEntry\",\n },\n \"GalleryEntry\": {\n \"createChildNode\",\n },\n \"Geometry\": {\n \"addArrayAttrib\",\n \"createBezierCurve\",\n \"createBezierSurface\",\n \"createChannelPrim\",\n \"createEdgeGroup\",\n \"createHexahedron\",\n \"createHexahedronInPlace\",\n \"createMeshSurface\",\n \"createNURBSCurve\",\n \"createNURBSCurve\",\n \"createNURBSSurface\",\n \"createPacked\",\n \"createPoint\",\n \"createPointGroup\",\n \"createPolygon\",\n \"createPrimGroup\",\n \"createTetrahedron\",\n \"createTetrahedronInPlace\",\n \"createVertexGroup\",\n \"createVolume\",\n \"freeze\",\n \"primitiveIntrinsicsDataId\",\n \"selection\",\n \"topologyDataId\",\n \"unpackFromFolder\",\n },\n \"GeometryDrawable\": {\n \"geometry\",\n },\n \"GeometryDrawableGroup\": {\n \"drawable\",\n \"geometry\",\n },\n \"GeometrySelection\": {\n \"drawable\",\n \"geometry\",\n },\n \"GeometryViewport\": {\n \"camera\",\n \"defaultCamera\",\n \"settings\",\n },\n \"GeometryViewportCamera\": {\n \"stash\",\n },\n \"GeometryViewportSettings\": {\n \"backgroundImage\",\n \"displaySet\",\n },\n \"HDADefinition\": {\n \"addSection\",\n \"nodeType\",\n \"options\",\n \"parmTemplateGroup\",\n },\n \"HDASection\": {\n \"definition\",\n },\n \"IndexPairPropertyTable\": {\n \"attrib\",\n \"propertyDataType\",\n },\n \"InterruptableOperation\": {\n \"__enter__\",\n },\n \"LopNetwork\": {\n \"viewportOverrides\",\n \"viewportLoadMasks\",\n \"loadNamedViewportLoadMasks\",\n \"editablePostLayer\",\n },\n \"LopNode\": {\n \"loadMasks\",\n \"selectionRule\",\n \"viewerNode\",\n },\n \"LopPostLayer\": {\n \"__enter__\",\n },\n \"LopViewportOverrides\": {\n \"__enter__\",\n },\n \"NodeConnection\": {\n \"outputItem\",\n },\n \"Node\": {\n \"childTypeCategory\",\n \"collapseIntoSubnet\",\n \"copyNetworkBox\",\n \"copyStickyNote\",\n \"createInputNode\",\n \"createNetworkBox\",\n \"createNetworkDot\",\n \"createNode\",\n \"createOutputNode\",\n \"createStickyNote\",\n \"creator\",\n \"moveToGoodPosition\",\n \"type\",\n },\n \"NodeGroup\": {\n \"parent\",\n },\n \"NodeType\": {\n \"parmTemplateGroup\",\n },\n \"OpNode\": {\n \"addNodeGroup\",\n \"hdaModule\",\n \"hm\",\n \"parmTemplateGroup\",\n \"expressionLanguage\",\n \"simulation\",\n },\n \"OpNodeTypeCategory\": {\n \"createDigitalAsset\",\n },\n \"PackedGeometry\": {\"getEmbeddedGeometry\"},\n \"PackedPrim\": {\n \"vertex\",\n },\n \"Pane\": {\n \"createTab\",\n \"currentTab\",\n \"splitHorizontally\",\n \"splitVertically\",\n },\n \"PaneTab\": {\n \"clone\",\n \"setType\",\n },\n \"Parm\": {\n \"evalAsRamp\",\n \"evalAsRampAtFrame\",\n \"expressionLanguage\",\n \"getReferencedParm\",\n \"parmTemplate\",\n \"tuple\",\n \"uiBackgroundColor\",\n },\n \"ParmTemplate\": {\n \"clone\",\n },\n \"ParmTemplateGroup\": {\n \"entryAtIndices\",\n },\n \"ParmTuple\": {\n \"__getitem__\",\n \"parmTemplate\",\n },\n \"PathBasedPaneTab\": {\n \"currentNode\",\n \"pwd\",\n },\n \"PerfMonEvent\": {\n \"__enter__\",\n },\n \"Point\": {\n \"geometry\",\n },\n \"PointGroup\": {\n \"dataId\",\n },\n \"Prim\": {\n \"geometry\",\n },\n \"PrimGroup\": {\n \"dataId\",\n },\n \"Quadric\": {\n \"vertex\",\n },\n \"RadialMenu\": {\n \"categories\",\n \"createScriptItem\",\n \"createSubmenu\",\n \"item\",\n \"items\",\n \"label\",\n \"root\",\n \"shortcut\",\n \"sourceFile\",\n },\n \"RadialScriptItem\": {\n \"check\",\n \"icon\",\n \"label\",\n \"script\",\n \"shortcut\",\n },\n \"RadialSubmenu\": {\n \"createScriptItem\",\n \"createSubmenu\",\n \"items\",\n \"label\",\n \"shortcut\",\n },\n \"RedrawBlock\": {\n \"__enter__\",\n },\n \"ReferencePlane\": {\n \"sceneViewer\",\n },\n \"SceneViewer\": {\n \"constructionPlane\",\n \"curViewport\",\n \"flipbookSettings\",\n \"referencePlane\",\n \"selectGeometry\",\n \"selectedViewport\",\n },\n \"ScriptEvalContext\": {\n \"__enter__\",\n },\n \"Selection\": {\n \"freeze\",\n },\n \"Selector\": {\n \"nodeType\",\n },\n \"SimpleDrawable\": {\"geometry\"},\n \"SopNode\": {\n \"curPoint\",\n \"curPrim\",\n \"curVertex\",\n },\n \"SopNodeType\": {\n \"addSelector\",\n },\n \"StyleSheet\": {\n \"clone\",\n \"cloneWithAddedStyleSheet\",\n \"cloneWithObject\",\n \"cloneWithPrim\",\n \"cloneWithShape\",\n },\n \"Surface\": {\n \"vertex\",\n },\n \"Take\": {\n \"addChildTake\",\n \"insertTakeAbove\",\n },\n \"Track\": {\n \"clip\",\n },\n \"UndosDisabler\": {\n \"__enter__\",\n },\n \"UndosGroup\": {\n \"__enter__\",\n },\n \"VDB\": {\n \"vertex\",\n },\n \"Vertex\": {\n \"geometry\",\n \"point\",\n \"prim\",\n },\n \"VertexGroup\": {\n \"dataId\",\n \"geometry\",\n },\n \"VexContext\": {\n \"nodeTypeCategory\",\n },\n \"ViewerDragger\": {\n \"curViewport\",\n \"viewport\",\n },\n \"ViewerState\": {\n \"nodeType\",\n },\n \"ViewportVisualizer\": {\n \"evalParmAsRamp\",\n \"type\",\n },\n \"Volume\": {\n \"vertex\",\n },\n \"VopNetNode\": {\n \"definedType\",\n \"vexContext\",\n },\n \"VopNode\": {\n \"insertParmGenerator\",\n },\n \"anim\": {\n \"newBookmark\",\n },\n \"clone\": {\n \"createClone\",\n },\n \"galleries\": {\n \"createGalleryEntry\",\n },\n \"lop\": {\n \"createConnectionParmsForProperty\",\n \"createParmsForParameter\",\n \"createParmsForProperty\",\n \"outputProcessorParms\",\n \"shaderNodeType\",\n },\n \"perfMon\": {\n \"loadProfile\",\n \"startCookEvent\",\n \"startEvent\",\n \"startPaneEvent\",\n \"startProfile\",\n \"startTimedCookEvent\",\n \"startTimedEvent\",\n },\n \"playbar\": {\n \"animBar\",\n \"channelList\",\n \"channelListFromNodes\",\n \"channelListFromParmTuples\",\n \"channelListFromParms\",\n \"channelListFromSelection\",\n \"frameRange\",\n \"playbackRange\",\n \"selectionRanges\",\n \"timeRange\",\n \"timelineRange\",\n },\n \"properties\": {\n \"parmTemplate\",\n },\n \"shelves\": {\n \"newShelf\",\n \"newShelfSet\",\n \"newTool\",\n },\n \"takes\": {\n \"currentTake\",\n \"rootTake\",\n },\n \"ui\": {\n \"createDialog\",\n \"createRadialItem\",\n \"createRadialMenu\",\n \"curDesktop\",\n \"device\",\n \"sharedAssetGalleryDataSource\",\n \"showFloatingParameterEditor\",\n },\n \"undos\": {\n \"disabler\",\n \"group\",\n },\n \"viewportVisualizer\": {\n \"copyVisualizer\",\n },\n}\n\n# Functions for which we want to declare a specific return type.\nEXPLICIT_RETURN_TYPES = {\n None: {\n \"shopNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"ropNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"dataNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"apexNodeTypeCategory\": \"ApexNodeTypeCategory\",\n \"chopNetNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"chopNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"dopNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"cop2NetNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"cop2NodeTypeCategory\": \"OpNodeTypeCategory\",\n \"copNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"objNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"rootNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"lopNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"managerNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"sopNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"topNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"vopNetNodeTypeCategory\": \"OpNodeTypeCategory\",\n \"vopNodeTypeCategory\": \"OpNodeTypeCategory\",\n },\n \"Bundle\": {\n \"pattern\": \"str | None\",\n },\n \"Color\": {\n \"hsl\": \"Tuple[float, float, float]\",\n \"hsv\": \"Tuple[float, float, float]\",\n \"lab\": \"Tuple[float, float, float]\",\n \"rgb\": \"Tuple[float, float, float]\",\n \"tmi\": \"Tuple[float, float, float]\",\n \"xyz\": \"Tuple[float, float, float]\",\n },\n \"DopData\": {\n \"creator\": \"OpNode\",\n \"dopNetNode\": \"OpNode\",\n },\n \"DopNode\": {\n \"createdObjects\": \"Tuple[DopObject, ...]\",\n \"displayNode\": \"OpNode | None\",\n \"dopNetNode\": \"OpNode\",\n \"objectsToProcess\": \"Tuple[DopObject, ...]\",\n \"processedObjects\": \"Tuple[DopObject, ...]\",\n \"renderNode\": \"OpNode | None\",\n },\n \"GeometrySelection\": {\n \"mergedNode\": \"SopNode\",\n },\n \"HDADefinition\": {\n \"nodeType\": \"OpNodeType\",\n \"nodeTypeCategory\": \"OpNodeTypeCategory\",\n },\n \"LopNode\": {\n \"activeLayer\": \"pxr.Sdf.Layer | None\",\n \"editableLayer\": \"pxr.Sdf.Layer | None\",\n \"editableStage\": \"pxr.Usd.Stage | None\",\n \"inputPrims\": \"Tuple[pxr.Sdf.Path, ...]\",\n \"lastModifiedPrims\": \"Tuple[pxr.Sdf.Path, ...]\",\n \"network\": \"OpNode\",\n \"sourceLayer\": \"pxr.Sdf.Layer | None\",\n \"stage\": \"pxr.Usd.Stage | None\",\n \"uneditableStage\": \"pxr.Usd.Stage | None\",\n },\n \"LopSelectionRule\": {\n \"sourceNode\": \"LopNode | None\",\n },\n \"OpNode\": {\n \"changeNodeType\": \"ChopNode\",\n \"createDigitalAsset\": \"OpNode\",\n \"findOrCreateMotionEffectsNetwork\": \"OpNode\",\n },\n \"OpNodeType\": {\n \"instances\": \"Tuple[OpNode, ...]\",\n },\n \"Parm\": {\n \"createClip\": \"ChopNode\",\n \"node\": \"OpNode\",\n \"evalAsNode\": \"OpNode | None\",\n \"evalAsNodeAtFrame\": \"OpNode | None\",\n },\n \"ParmTuple\": {\n \"createClip\": \"ChopNode\",\n \"node\": \"OpNode\",\n },\n \"PythonPanel\": {\"activeInterfaceRootWidget\": \"QtWidgets.QWidget\"},\n \"ScriptEvalContext\": {\n \"node\": \"OpNode | None\",\n },\n \"VDB\": {\n \"voxelRange\": \"Tuple[bool, ...] | Tuple[int, ...] | Tuple[float, ...] | Tuple[Vector3, ...]\"\n },\n \"ViewerState\": {\n \"categoryNode\": \"OpNode | None\",\n },\n \"ViewportVisualizer\": {\n \"evalParm\": \"int | float | str\",\n },\n \"dop\": {\"scriptSolverNetwork\": \"OpNode | None\"},\n}\n\n# Completely redefine function definitions that are wrong or did not come with C++ type hints.\n# WARNING: mypy.stubdoc._TYPE_RE must be updated the pattern below to accept\n# Tuple subscripts, literals, and modern | characters.\n# Note that even in mypy 1.15, this pattern does not support | characters.\n# _TYPE_RE: Final = re.compile(r\"^[a-zA-Z_][\\w\\[\\], .\\\"\\'|]*(\\.[a-zA-Z_][\\w\\[\\], ]*)*$\")\n# FIXME: The Callables provided to the callback system for most classes take\n# different argument types and numbers of arguments according to the event type associated\n# with the callback. To avoid an overload nightmare and to avoid fully articulating code\n# that is likely to be out of date at some stage, I'm going to leave them as `Callable`\n# with no subscript annotation.\nEXPLICIT_DEFINITIONS = {\n None: {\n # signatures for these special methods include many inaccurate overloads\n \"__ne__\": \"(self, other: object) -> bool\",\n \"__eq__\": \"(self, other: object) -> bool\",\n \"__lt__\": \"(self, other: object) -> bool\",\n \"__le__\": \"(self, other: object) -> bool\",\n \"__gt__\": \"(self, other: object) -> bool\",\n \"__ge__\": \"(self, other: object) -> bool\",\n },\n \"__hou__\": {\n \"addAnimationLayer\": \"(layermixer: ChopNode, layername: str = '') -> ChopNode\",\n \"applicationVersion\": \"(include_patch: bool = False) -> Tuple[int, int, int]\",\n \"addContextOptionChangeCallback\": \"(callback: Callable[[str], None]) -> None\",\n \"removeContextOptionChangeCallback\": \"(callback: Callable[[str], None]) -> None\",\n \"contextOptionChangeCallbacks\": \"() -> Tuple[Callable[[str], None], ...]\",\n \"ch\": \"(path: str) -> ParmArgType\",\n \"contextOption\": \"(opt: str) -> float | str\",\n \"createAnimationClip\": \"(path: str = ..., set_export: bool = False) -> ChopNode\",\n \"createAnimationLayers\": \"(path: str = ...) -> ChopNode\",\n \"evalParm\": \"(path: str) -> ParmReturnType\",\n \"evalParmTuple\": \"(path: str) -> ParmTupleReturnType\",\n \"fileReferences\": \"(project_dir_variable: str = 'HIP', include_all_refs: bool = true) -> Sequence[Tuple[Parm, str]]\",\n \"hscriptExpression\": \"(expression: str) -> float | str | Tuple[float, ...] | Tuple[str, ...]\",\n \"loadCPIODataFromString\": \"(data: bytes) -> Tuple[Tuple[str, bytes], ...]\",\n \"loadIndexDataFromString\": \"(data: bytes) -> dict[str, bytes]\",\n \"loadImageDataFromFile\": \"(file_name: str, arg: EnumValue = ...) -> bytes\",\n \"lvar\": \"(name: str) -> float | str\",\n \"nodeType\": \"(category_or_name: NodeTypeCategory | str, internal_name: str | None = None) -> NodeType | None\",\n \"registerOpdefPath\": \"(path: str, server_name: str, port: str = '') -> None\",\n \"removeAnimationLayer\": \"(layermixer: ChopNode, layername: str, merge_down: bool = False) -> bool\",\n \"runCallbackAndCatchCrashes\": \"(callback: Callable) -> Optional[Any]\",\n \"runVex\": \"(vex_file: str, inputs: Mapping[str, OptionType | OptionSequenceType], precision: Literal['32', '64'] = '32') -> dict[str, Any]\",\n \"saveImageDataToFile\": \"(color_and_alpha_data: Sequence[float] | bytes, width: int, height: int, file_name: str) -> None\",\n \"setContextOption\": \"(option: str, value: str | float | None) -> None\",\n \"startHoudiniEngineDebugger\": \"(portOrPipeName: int | str) -> None\",\n },\n \"_clone_Connection\": {\n \"contextOptionExpression\": \"(self, opt: str) -> str\",\n },\n \"_StringMapDoubleTuple\": {\n \"__iter__\": \"(self) -> Iterator[str]\",\n },\n \"_ik_Skeleton\": {\n \"addJoint\": \"(self, world_transform: Matrix4 = ..., parent: _ik_Joint | None = None, rotation_weights: Vector3 = ..., translation_weights: Vector3 = ..., mass: float = 1.0, local_com: Vector3 = ...) -> _ik_Joint\",\n },\n \"_ik_Target\": {\n \"__init__\": \"(self, joint: _ik_Joint | None = None, goal_transform: Matrix4 = ..., joint_offset: Matrix4 = ..., target_type: EnumValue = _ik_targetType.Position, weight: float = 1.0, priority: int = 0, depth: int = -1) -> None\",\n },\n \"_logging_Sink\": {\n \"setFilterCallback\": \"(self, callback: Callable[[_logging_LogEntry], None]) -> None\",\n },\n \"AdvancedDrawable\": {\n \"draw\": \"(self, handle: Handle, params: Mapping[str, Any] | None = None) -> None\",\n \"setParams\": \"(self, params: Mapping[str, Any] | None = None) -> None\",\n },\n \"AgentClip\": {\n \"__init__\": \"(self, name: str, stage: pxr.Usd.Stage, prim_path: str, rig: AgentRig) -> None\",\n },\n \"AgentLayer\": {\n \"__init__\": \"(self, name: str, rig: AgentRig, shapelib: AgentShapeLibrary, shape_bindings: Sequence[AgentShapeBinding], source_layer: AgentLayer | None = None) -> None\",\n \"bindings\": \"(self, transform: int | None = None) -> Tuple[AgentShapeBinding, ...]\",\n },\n \"AgentMetadata\": {\n \"__init__\": \"(self, data: Mapping[str, Any]) -> None\",\n \"data\": \"(self) -> dict[str, Any]\",\n \"setData\": \"(self, data: Mapping[str, Any]) -> None\",\n \"setMetadata\": \"(self, item_id: str, metadata: Mapping[str, Any]) -> None\",\n },\n \"AgentRig\": {\n \"__init__\": \"(self, name: str, transform_names: Sequence[str], hierarchy: Sequence[int]) -> None\",\n },\n \"AgentShapeBinding\": {\n \"__init__\": \"(self, shape: AgentShape, deformer: AgentShapeDeformer, bounds_scale: float = 1.0) -> None\",\n },\n \"AgentShapeDeformer\": {\n \"__init__\": \"(self, name: str | EnumValue) -> None\",\n },\n \"AgentShapeLibrary\": {\n \"__init__\": \"(self, filename: str, keep_external_ref: bool = True) -> None\",\n },\n \"AgentTransformGroup\": {\n \"__init__\": \"(self, name: str, transforms: Sequence[int], rig: AgentRig, weights: Sequence[float], channels: Sequence[int]) -> None\",\n },\n \"AssetGalleryDataSource\": {\n \"addItem\": \"(self, label: str, file_path: str | None = None, thumbnail: bytes = b'', type_name: str = 'asset', blind_data: bytes = b'', creation_date: int = 0) -> str\",\n },\n \"Attrib\": {\n \"defaultValue\": \"(self) -> AttribReturnType\",\n \"dicts\": \"Tuple[dict[str, AttribBasicType], ...]\",\n \"option\": \"(self, option_name: str) -> OptionMultiReturnType\",\n \"options\": \"(self) -> dict[str, OptionMultiReturnType]\",\n \"setOption\": \"(self, name: str, value: OptionMultiArgType, type_hint: EnumValue = ...) -> None\",\n },\n \"Bookmark\": {\n \"metadata\": \"(self, key: str, default_value: Any = None) -> Any\",\n \"setEndFrame\": \"(self, end: float) -> None\",\n \"setMetadata\": \"(self, key: str, value: Any, type_hint: EnumValue = ...) -> None\",\n \"setStartFrame\": \"(self, start: float) -> None\",\n },\n \"BoundingBox\": {\n \"__init__\": \"(self, bbox_or_xmin: float | BoundingBox = 0.0, ymin: float = 0.0, zmin: float = 0.0, xmax: float = 0.0, ymax: float = 0.0, zmax: float = 0.0) -> None\",\n \"enlargeToContain\": \"(self, point_or_bbox: Sequence[float] | Vector3, BoundingBox) -> None\",\n },\n \"BoundingRect\": {\n \"__init__\": \"(self, brect_or_p1_or_xmin: BoundingRect | Vector2 | float, p2_or_ymin: Vector2 | float, xmax: float = 0.0, ymax: float = 0.0) -> None\",\n \"enlargeToContain\": \"(self, point_or_rect: Sequence[float] | Vector2 | BoundingRect) -> None\",\n \"intersects\": \"(self, rect: BoundingRect) -> bool\",\n \"contains\": \"(self, rect: BoundingRect) -> bool\",\n },\n \"ButtonParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, disable_when: str | None = None, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str=..., script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ...) -> None\",\n },\n \"ChannelGraph\": {\n \"selectedKeyframes\": \"(self) -> dict[Parm, Tuple[BaseKeyframe, ...]]\",\n },\n \"ChannelGraphSelection\": {\n \"__init__\": \"(self, path: str | None = None, flags: Sequence[int] = ...) -> None\",\n },\n \"ChannelList\": {\n \"addGeometryChannels\": \"(self, geometry: Geometry, collection_name: str | None = None, pattern: str | None = None, selected: bool = True, pinned: bool = False, valueselected: bool = False) -> str\",\n \"addNodeGeometryChannels\": \"(self, node: SopNode, pattern: str | None = None, selected: bool = True, pinned: bool = False, valueselected: bool = False) -> str\",\n \"asCode\": \"(self, var_name: str = 'chanlist') -> str\",\n \"containsGeometryChannel\": \"(self, collection_name: str, channel: str | None = None) -> bool\",\n \"deselect\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"deselectGeometryChannel\": \"(self, collection_name: str, channel: str | None = None) -> str\",\n \"deselectGeometryChannelValue\": \"(self, collection_name: str, channel: str | None = None) -> str\",\n \"deselectValue\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"pin\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"pinGeometryChannel\": \"(self, collection_name: str, channel: str | None = None) -> str\",\n \"remove\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"select\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"selectGeometryChannel\": \"(self, collection_name: str, channel: str | None = None) -> str\",\n \"selectGeometryChannelValue\": \"(self, collection_name: str, channel: str | None = None) -> str\",\n \"selectValue\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"unpin\": \"(self, parm: Parm | Sequence[Parm]) -> None\",\n \"unpinGeometryChannel\": \"(self, collection_name: str, channel: str | None = None) -> str\",\n },\n \"ChopNode\": {\n \"clipData\": \"(self, binary: Any) -> bytes\",\n \"saveClip\": \"(self, file_name: str) -> bool\",\n },\n \"Color\": {\n \"__init__\": \"(self, rgb_tuple: Sequence[float] | float = ..., g: float = ..., b: float = ...) -> None\",\n },\n \"CompositorViewer\": {\n \"bindViewerHandle\": \"(self, handle_type: str, name: str, settings: str | None = None, cache_previous_parms: bool = ..., handle_parms: Sequence[str] | None = None) -> None\",\n \"bindViewerHandleStatic\": \"(self, handle_type: str, name: str, bindings: Sequence[tuple[str, str]], settings: str | None = None) -> None\",\n },\n \"Cop2Node\": {\n \"allPixels\": \"(self, plane: str = 'C', component: str | None = None, interleaved: bool = True, time: float = -1.0) -> Tuple[float, ...]\",\n \"allPixelsAsString\": \"(self, plane: str = 'C', component: str | None = None, interleaved: bool = True, time: float = -1.0) -> bytes\",\n \"imageBounds\": \"(self, plane: str = 'C') -> Tuple[int, int, int]\",\n \"saveImage\": \"saveImage(self, file_name: str, frame_range: Sequence[float] = ...) -> None\",\n \"setPixelsOfCookingPlaneFromString\": \"(self, values: bytes, component: str | None = None, interleaved: bool = True, depth: EnumValue | None = None, flip_vertically: bool = False) -> None\",\n },\n \"DataParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, num_components: int, look: EnumValue = ..., naming_scheme: EnumValue = ..., unknown_str: str | None = None, disable_when: str | None = None, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = ..., tags: dict[str, str] = ..., unknown_dict: dict[EnumValue, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[EnumValue] = ...) -> None\",\n },\n \"Desktop\": {\n \"createFloatingPane\": \"(self, pane_tab_type: EnumValue, position: Sequence[float] = ..., size: Sequence[float] = ..., python_panel_interface: PythonPanelInterface | None = ..., immediate: bool = False) -> PaneTab\",\n \"createFloatingPaneTab\": \"(self, pane_tab_type: EnumValue, position: Sequence[float] = ..., size: Sequence[float] = ..., python_panel_interface: PythonPanelInterface | None = ..., immediate: bool = False) -> PaneTab\",\n \"createFloatingPanel\": \"(self, pane_tab_type: EnumValue, position: Sequence[float] = ..., size: Sequence[float] = ..., python_panel_interface: PythonPanelInterface | None = ..., immediate: bool = False) -> FloatingPanel\",\n },\n \"Dialog\": {\n \"addCallback\": \"(self, name: str, callback: Callable[[], None]) -> None\",\n \"callbacks\": \"(self, name: str) -> Tuple[Callable[[], None], ...]\",\n \"removeCallback\": \"(self, name: str, callback: Callable[[], None]) -> None\",\n \"setValue\": \"(self, name: str, value: OptionType) -> None\",\n \"value\": \"(self, name: str) -> OptionType\",\n \"waitForValueToChangeTo\": \"(self, name: str, new_value: OptionType) -> None\",\n },\n \"DopData\": {\n \"createSubData\": \"(self, data_name: str, data_type: str = ..., avoid_name_collisions: bool = False) -> DopData\",\n },\n \"DopRecord\": {\n \"setField\": \"(self, field_name: str, value: OptionType) -> None\",\n \"field\": \"(self, field_name: str) -> OptionType\",\n },\n \"Drawable\": {\n \"draw\": \"(self, handle: Handle, params: dict[str, Any] | None = None) -> None\",\n },\n \"Drawable2D\": {\n \"__init__\": \"(self, scene_viewer: SceneViewer | CompositorViewer, type: EnumValue, name: str, label: str | None = None, pickable: bool = False, params: dict[str, Any] | None = None) -> None\",\n \"draw\": \"(self, handle: Handle, params: dict[str, Any] | None = None) -> None\",\n \"params\": \"(self) -> dict[str, Any]\",\n \"setParams\": \"(self, params: dict[str, Any]) -> None\",\n },\n \"EdgeGroup\": {\n \"add\": \"(self, edge_or_list_or_edge_group: Edge | Sequence[Edge] | EdgeGroup) -> None\",\n \"iterEdges\": \"(self) -> _EdgeTupleGenerator\",\n \"remove\": \"(self, edge_or_list_or_edge_group: Edge | Sequence[Edge] | EdgeGroup) -> None\",\n },\n \"Face\": {\n \"attribValueAt\": \"(self, attrib_or_name: Attrib | str, u: float, du: float = 0) -> int | float | str | Tuple[int, ...] | Tuple[float, ...]\"\n },\n \"FlipbookSettings\": {\n # FIXME: Most of these methods are both setters and getters, where it will set the value if\n # one is provided and return None, or will return the current value if none is provided.\n # We would have better results if we overloaded each of these.\n \"LUT\": \"(self, value: str | None = None) -> str | None\",\n \"antialias\": \"(self, value: EnumValue | None = None) -> EnumValue | None\",\n \"aperture\": \"(self, value: float | None = None) -> float | None\",\n \"appendFramesToCurrent\": \"(self, value: bool | None = None) -> bool | None\",\n \"audioFilename\": \"(self, audio_file: str | None = None) -> str | None\",\n \"audioFrameStart\": \"(self, audio_file: float | None = None) -> float | None\",\n \"audioTimeOffset\": \"(self, value: float | None = None) -> float | None\",\n \"backgroundImage\": \"(self, value: str | None = None) -> str | None\",\n \"beautyPassOnly\": \"(self, value: bool | None = None) -> bool | None\",\n \"blockEditing\": \"(self, value: bool | None = None) -> bool | None\",\n \"cropOutMaskOverlay\": \"(self, value: bool | None = None) -> bool | None\",\n \"depthOfFieldFromCamera\": \"(self, value: bool | None = None) -> bool | None\",\n \"depthOfFieldQuality\": \"(self, value: float | None = None) -> float | None\",\n \"fStop\": \"(self, value: float | None = None) -> float | None\",\n \"focusDistance\": \"(self, value: float | None = None) -> float | None\",\n \"frameIncrement\": \"(self, value: float | None = None) -> float | None\",\n \"frameRange\": \"(self, value: Sequence[float] | None = None) -> Tuple[float, float] | None\",\n \"fromAudioPanel\": \"(self, value: bool | None = None) -> bool | None\",\n \"gamma\": \"(self, value: float | None = None) -> float | None\",\n \"initializeSimulations\": \"(self, value: bool | None = None) -> bool | None\",\n \"leaveFrameAtEnd\": \"(self, value: bool | None = None) -> bool | None\",\n \"motionBlurFrameRange\": \"(self, value: EnumValue | None = None) -> EnumValue | None\",\n \"motionBlurSegments\": \"(self, value: int | None = None) -> int | None\",\n \"output\": \"(self, value: str | None = None) -> str | None\",\n \"outputToMPlay\": \"(self, value: bool | None = None) -> bool | None\",\n \"outputZoom\": \"(self, value: int | None = None) -> int | None\",\n \"overrideGamma\": \"(self, value: bool | None = None) -> bool | None\",\n \"overrideLUT\": \"(self, value: bool | None = None) -> bool | None\",\n \"renderAllViewports\": \"(self, value: bool | None = None) -> bool | None\",\n \"resolution\": \"(self, value: Tuple[int, int] | None = None) -> Tuple[int, int] | None\",\n \"scopeChannelKeyframesOnly\": \"(self, value: bool | None = None) -> bool | None\",\n \"sessionLabel\": \"(self, value: str | None = None) -> str | None\",\n \"sheetSize\": \"(self, value: Sequence[int] | None = None) -> Tuple[int, int] | None\",\n \"shutter\": \"(self, value: float | None = None) -> float | None\",\n \"shutterFromCamera\": \"(self, value: bool | None = None) -> bool | None\",\n \"useDepthOfField\": \"(self, value: bool | None = None) -> bool | None\",\n \"useMotionBlur\": \"(self, value: bool | None = None) -> bool | None\",\n \"useResolution\": \"(self, value: bool | None = None) -> bool | None\",\n \"useSheetSize\": \"(self, value: bool | None = None) -> bool | None\",\n \"visibleObjects\": \"(self, value: str | None = None) -> str | None\",\n \"visibleTypes\": \"(self, value: EnumValue | None = None) -> EnumValue | None\",\n },\n \"FloatParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, num_components: int, default_value: Sequence[float] = ..., min: float = 0.0, max: float = 10.0, min_is_strict: bool = False, max_is_strict: bool = False, look: EnumValue = parmLook.Regular, naming_scheme: EnumValue = parmNamingScheme.XYZW, disable_when: str | None = None, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[EnumValue] = ...) -> None\",\n },\n \"FolderParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, parm_templates: Sequence[ParmTemplate] = ..., folder_type: EnumValue = folderType.Tabs, is_hidden: bool = False, ends_tab_group: bool = False, tags: Mapping[str, str] = ..., conditionals: Mapping[EnumValue, str] = ..., tab_conditionals: Mapping[EnumValue, str] = ...) -> None\",\n },\n \"FolderSetParmTemplate\": {\n \"__init__\": \"(self, name: str, folder_names: Sequence[str], folder_type: EnumValue, tags: Mapping[str, str] = ...) -> None\",\n \"folderNames\": \"(self) -> list[str]\",\n \"setFolderNames\": \"(self, folder_names: Sequence[str]) -> None\",\n },\n \"Geometry\": {\n \"addAttrib\": \"(self, type: EnumValue, name: str, default_value: AttribArgType | AttribDictArgType, transform_as_normal: bool = True, create_local_variable: bool = True) -> Attrib\",\n \"attribValue\": \"(self, name_or_attrib: str | Attrib) -> AttribReturnType | AttribDictReturnType\",\n \"containsPrimType\": \"(self, type_or_name: EnumValue | str) -> bool\",\n \"countPrimType\": \"(self, type_or_name: EnumValue | str) -> int\",\n \"createPoints\": \"(self, point_positions: Sequence[Sequence[float]]) -> Tuple[Point, ...]\",\n \"createPolygons\": \"(self, point_positions: Sequence[Point | Sequence[int]], is_closed: bool = True) -> Tuple[Polygon, ...]\",\n \"deletePoints\": \"(self, points: Iterable[Point] | PointGroup) -> None\",\n \"deletePrims\": \"(self, prims: Sequence[Prim] | PrimGroup, keep_points: bool = False) -> None\",\n \"dictAttribValue\": \"(self, attrib: Attrib | str) -> AttribDictReturnType\",\n \"dictListAttribValue\": \"(self, name_or_attrib: Attrib | str) -> Sequence[AttribDictReturnType]\",\n \"edgeGroups\": \"(self, scope: EnumValue = groupScope.Public) -> Tuple[EdgeGroup, ...]\",\n \"edgeLoop\": \"(self, edges: Sequence[Edge], loop_type: EnumValue, full_loop_per_edge: bool, force_ring: bool, allow_ring: bool) -> Tuple[Edge, ...]\",\n \"findEdgeGroup\": \"(self, name: str, scope: EnumValue = groupScope.Public) -> EdgeGroup | None\",\n \"findGlobalAttrib\": \"(self, name: str, scope: EnumValue = attribScope.Public) -> Attrib | None\",\n \"findPointAttrib\": \"(self, name: str, scope: EnumValue = attribScope.Public) -> Attrib | None\",\n \"findPointGroup\": \"(self, name: str, scope: EnumValue = groupScope.Public) -> PointGroup | None\",\n \"findPrimAttrib\": \"(self, name: str, scope: EnumValue = attribScope.Public) -> Attrib | None\",\n \"findPrimGroup\": \"(self, name: str, scope: EnumValue = groupScope.Public) -> PrimGroup | None\",\n \"findVertexAttrib\": \"(self, name: str, scope: EnumValue = attribScope.Public) -> Attrib | None\",\n \"findVertexGroup\": \"(self, name: str, scope: EnumValue = groupScope.Public) -> VertexGroup | None\",\n \"floatAttribValue\": \"(self, name_or_attrib: str | Attrib) -> float\",\n \"floatListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[float, ...]\",\n \"generateAttribMenu\": \"(self, attrib_type: EnumValue | None = None, data_type: EnumValue | None = None, min_size: int = 1, max_size: int = -1, array_type: bool = True, scalar_type: bool = True, case_sensitive: bool = True, pattern: str = '*', decode_tokens: bool = False) -> Tuple[str, ...]\",\n \"importLop\": \"(self, lopnode: LopNode, selectionrule: LopSelectionRule, purpose: str | None = None, traversal: str | None = None, path_attrib_name: str | None = None, name_attrib_name: str | None = None, strip_layers: bool = False, frame: float | None = None) -> LopLockedStage\",\n \"importUsdStage\": \"(self, stage: pxr.Usd.Stage, selectionrule: LopSelectionRule, purpose: str | None = None, traversal: str | None = None, path_attrib_name: str | None = None, name_attrib_name: str | None = None, frame: float | None = None) -> None\",\n \"intAttribValue\": \"(self, attrib: Attrib | str) -> int\",\n \"intListAttribValue\": \"(self, name_or_attrib: Attrib | str) -> Tuple[int, ...]\",\n \"intrinsicValue\": \"(self, intrinsic_name: str) -> AttribReturnType\",\n \"iterPoints\": \"(self) -> _PointTupleGenerator\",\n \"iterPrims\": \"(self) -> _PrimTupleGenerator\",\n \"packedFolderProperties\": \"(self, path: str) -> dict[str, bool]\",\n \"pointFloatAttribValuesAsString\": \"(self, name: str, float_type: EnumValue = numericData.Float32) -> bytes\",\n \"pointGroups\": \"(self, scope: EnumValue = groupScope.Public) -> Tuple[PointGroup, ...]\",\n \"pointIntAttribValuesAsString\": \"(self, name: str, int_type: EnumValue = numericData.Int32) -> bytes\",\n \"pointLoop\": \"(self, points: Sequence[Point], loop_type: EnumValue) -> Tuple[Point, ...]\",\n \"pointNormals\": \"(self, points: Sequence[Point] | PointGroup) -> Sequence[Vector3]\",\n \"primFloatAttribValuesAsString\": \"(self, name: str, float_type: EnumValue = numericData.Float32) -> bytes\",\n \"primGroups\": \"(self, scope: EnumValue = groupScope.Public) -> Tuple[PrimGroup, ...]\",\n \"primIntAttribValuesAsString\": \"(self, name: str, int_type: EnumValue = numericData.Int32) -> bytes\",\n \"primLoop\": \"(self, prims: Sequence[Prim], loop_type: EnumValue) -> Tuple[Prim, ...]\",\n \"setGlobalAttribValue\": \"(self, name_or_attrib: str | Attrib, attrib_value: AttribArgType | AttribDictArgType) -> None\",\n \"setIntrinsicValue\": \"(self, intrinsic_name: str, value: AttribArgType) -> None\",\n \"setPointFloatAttribValuesFromString\": \"(self, name: str, values: bytes, float_type: EnumValue = numericData.Float32) -> None\",\n \"setPointIntAttribValuesFromString\": \"(self, name: str, values: bytes, int_type: EnumValue = numericData.Float32) -> None\",\n \"setPrimFloatAttribValuesFromString\": \"(self, name: str, values: bytes, float_type: EnumValue = numericData.Float32) -> None\",\n \"setPrimIntAttribValuesFromString\": \"(self, name: str, values: bytes, int_type: EnumValue = numericData.Float32) -> None\",\n \"setVertexFloatAttribValuesFromString\": \"(self, name: str, values: bytes, float_type: EnumValue = numericData.Float32) -> None\",\n \"setVertexIntAttribValuesFromString\": \"(self, name: str, values: bytes, int_type: EnumValue = numericData.Float32) -> None\",\n \"stringAttribValue\": \"(self, attrib: Attrib | str) -> str\",\n \"stringListAttribValue\": \"(self, name_or_attrib: Attrib | str) -> Tuple[str, ...]\",\n \"transformPrims\": \"(self, prims: Sequence[Prim] | PrimGroup, matrix: Matrix4) -> None\",\n \"vertexFloatAttribValuesAsString\": \"(self, name: str, float_type: EnumValue = numericData.Float32) -> bytes\",\n \"vertexGroups\": \"(self, scope: EnumValue = groupScope.Public) -> Tuple[VertexGroup, ...]\",\n \"vertexIntAttribValuesAsString\": \"(self, name: str, int_type: EnumValue = numericData.Int32) -> bytes\",\n },\n \"GeometryDelta\": {\n \"setPointPositionsFromString\": \"(self, positions: bytes, float_type: EnumValue = numericData.Float32) -> None\",\n },\n \"GeometryDrawable\": {\n \"__init__\": \"(self, scene_viewer: SceneViewer, geo_type: EnumValue, name: str, label: str | None = None, geometry: Geometry | None = None, params: Mapping[str, Any] | None = None) -> None\",\n },\n \"GeometryDrawableGroup\": {\n \"__init__\": \"(self, name: str, label: str | None = None) -> None\",\n },\n \"GeometrySelection\": {\n \"__init__\": \"(self) -> None\",\n },\n \"GeometryViewport\": {\n \"addEventCallback\": \"(self, callback: Callable[[dict[str, Any]], None]) -> None\",\n \"changeType\": \"(self, type: EnumValue) -> None\",\n \"eventCallbacks\": \"(self) -> Tuple[Callable[[dict[str, Any]], None], ...]\",\n \"queryWorldPositionAndNormal\": \"(self, x: int, y: int, selectionRestriction: bool = False) -> Tuple[Vector3, Vector3, bool]\",\n \"removeEventCallback\": \"(self, callback: Callable[[dict[str, Any]], None]) -> None\",\n \"setCamera\": \"(self, camera_node: ObjNode) -> None\",\n },\n \"GeometryViewportSettings\": {\n \"allowParticleSprites\": \"(self) -> bool\",\n \"autoGenerateVertexNormals\": \"(self) -> bool\",\n \"closureSelection\": \"(self, arg: EnumValue) -> EnumValue\",\n \"geometryInfo\": \"(self, arg: EnumValue) -> EnumValue\",\n \"guideFontSize\": \"(self) -> EnumValue\",\n \"handleHighlight\": \"(self, arg: EnumValue) -> EnumValue\",\n \"instanceStandInGeometry\": \"(self) -> EnumValue\",\n \"interiorWireAlpha\": \"(self) -> float\",\n \"levelOfDetail\": \"(self) -> float\",\n \"orientDiscToNormal\": \"(self) -> bool\",\n \"particleDiscSize\": \"(self) -> float\",\n \"particleDisplayType\": \"(self) -> EnumValue\",\n \"particlePointSize\": \"(self) -> float\",\n \"pointInstancing\": \"(self) -> bool\",\n \"pointInstancingLimit\": \"(self) -> int\",\n \"pointInstancingPercent\": \"(self) -> float\",\n \"polygonConvexQuality\": \"(self) -> bool\",\n \"selectWireframeAsSolid\": \"(self) -> bool\",\n \"setCamera\": \"(self, camera_node: ObjNode) -> None\",\n \"shadeOpenCurves\": \"(self) -> bool\",\n \"spriteTextureLimit\": \"(self) -> Tuple[int, ...]\",\n \"subdivsionLimit\": \"(self) -> int\",\n \"vertexNormalCuspAngle\": \"(self) -> float\",\n \"vertexNormalLimit\": \"(self) -> int\",\n \"volumeAmbientShadows\": \"(self) -> float\",\n \"volumeBSplines\": \"(self) -> EnumValue\",\n \"volumeQuality\": \"(self) -> EnumValue\",\n \"volumeWireAsPoints\": \"(self) -> bool\",\n \"wireBlend\": \"(self) -> float\",\n \"wireWidth\": \"(self) -> float\",\n },\n \"Handle\": {\n \"disableParms\": \"(self, parm_names: Sequence[str]) -> None\",\n \"enableParms\": \"(self, parm_names: Sequence[str]) -> None\",\n },\n \"HDADefinition\": {\n \"addSection\": \"(self, name: str, contents: str = '', compression_type: EnumValue = compressionType.NoCompression) -> HDASection\",\n \"extraFileOptions\": \"(self) -> dict[str, OptionType]\",\n \"setExtraFileOption\": \"(self, name, value: OptionType, type_hint: EnumValue = fieldType.NoSuchField) -> None\",\n },\n \"HDASection\": {\n \"binaryContents\": \"(self, compressionType: EnumValue = compressionType.NoCompression) -> bytes\",\n \"contents\": \"(self, compressionType: EnumValue = compressionType.NoCompression) -> str\",\n \"setContents\": \"(self, contents: str, compressionType: EnumValue = compressionType.NoCompression) -> None\",\n },\n \"InterruptableOperation\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n },\n \"IntParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, num_components: int, default_value: Sequence[int] = ..., min: int = 0, max: int = 10, min_is_strict=False, max_is_strict: bool = False, look: EnumValue = parmLook.Regular, naming_scheme: EnumValue = parmNamingScheme.XYZW, menu_items: Sequence[str] = ..., menu_labels: Sequence[str] = ..., icon_names: Sequence[str] = ..., item_generator_script: str | None = None, item_generator_script_language: EnumValue | None = None, menu_type: EnumValue = menuType.Normal, disable_when: str | None = None, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[str] = ...) -> None\",\n },\n \"IPRViewer\": {\n \"saveFrame\": \"(self, file_path: str, snapshot: int = 0, xres: int = -1, yres: int = -1, color: str = 'C', alpha: str = 'C', scope: str = '*', lut: str = '', gamma: float = 1.0, convert: bool = True) -> bool\",\n },\n \"Keyframe\": {\n \"__init__\": \"(self, value: float | None = None, time: float | None = None) -> None\",\n },\n \"LabelParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, column_labels: Sequence[str] = ..., is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, tags: Mapping[str, str] = ...) -> None\",\n },\n \"LopNetwork\": {\n \"activeLayer\": \"(self, output_index: int = ..., ignore_errors: bool = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, str | float] = ...) -> pxr.Sdf.Layer\",\n \"postLayer\": \"(self, name: str) -> pxr.Sdf.Layer | None\",\n \"sourceLayer\": \"(self, layer_index: int = ..., output_index: int = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, str | float] = ...) -> pxr.Sdf.Layer\",\n \"stage\": \"(self, output_index: int = ..., apply_viewport_overrides: bool = ..., ignore_errors: bool = ..., use_last_cook_context_options: bool = ..., apply_post_layers: bool = ..., frame: float|None = ..., context_options: Mapping[str, str | float] = ...) -> pxr.Usd.Stage\",\n \"viewportOverridesLayer\": \"(self, layer_id: EnumValue) -> pxr.Sdf.Layer\",\n },\n \"LopNode\": {\n \"activeLayer\": \"(self, output_index: int = 0, ignore_errors: bool = False, use_last_cook_context_options: bool = True, frame: float | None = None, context_options: Mapping[str, Any] = ...) -> pxr.Sdf.Layer\",\n \"addLockedGeometry\": \"(self, identifier: str, geo: Geometry, args: Mapping[str, str] | None = None) -> str\",\n \"displayNode\": \"(self) -> LopNode\",\n \"layersAboveLayerBreak\": \"(self, output_index: int = 0, use_last_cook_context_options: bool = True, frame: float | None = None, context_options: Mapping[str, str | float] | None = None) -> Tuple[str, ...]\",\n \"loadMasks\": \"(self, output_index: int = 0, force_cook: bool = False, use_last_cook_context_options: bool = True, frame: float | None = None, context_options: Mapping[str, str | float] | None = None) -> LopViewportLoadMasks\",\n \"setLastModifiedPrims\": \"(self, primPaths: Sequence[str]) -> None\",\n \"sourceLayer\": \"(self, layer_index: int = 0, output_index: int = 0, use_last_cook_context_options: bool = True, frame: float | None = None, context_options: Mapping[str, Any] = ...) -> pxr.Sdf.Layer\",\n \"sourceLayerCount\": \"(self, output_index: int = 0, use_last_cook_context_options: bool = True, frame: float | None = None, context_options: Mapping[str, str | float] | None = None) -> LopViewportLoadMasks\",\n \"stage\": \"(self, output_index: int = 0, apply_viewport_overrides: bool = False, ignore_errors: bool = False, use_last_cook_context_options: bool = True, apply_post_layers: bool = True, frame: float | None = None, context_options: Mapping[str, Any] = ...) -> pxr.Usd.Stage\",\n \"stagePrimStats\": \"(self, primpath: str | None = None, output_index: int = 0, apply_viewport_overrides: bool = False, ignore_errors: bool = False, do_geometry_counts: bool = False, do_separate_purposes: bool = False, use_last_cook_context_options: bool = True, apply_post_layers: bool = True, frame: float | None = None, context_options: Mapping[str, str | float] | None = None) -> dict[str, int]\",\n },\n \"LopPostLayer\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n \"layer\": \"(self) -> pxr.Sdf.Layer\",\n \"stage\": \"(self) -> pxr.Usd.Stage\",\n },\n \"LopSelectionRule\": {\n \"collectionAwarePaths\": \"(self, lopnode: LopNode | None = None, fallback_to_new_paths: bool = False, stage: pxr.Usd.Stage | None = None, use_last_cook_context_options: bool = True) -> Tuple[pxr.Sdf.Path, ...]\",\n \"expandedPaths\": \"(self, lopnode: LopNode | None = None, return_ancestors: bool = False, fallback_to_new_paths: bool = False, stage: pxr.Usd.Stage | None = None, use_last_cook_context_options: bool = True) -> Tuple[pxr.Sdf.Path, ...]\",\n \"firstPath\": \"(self, lopnode: LopNode | None = None, return_ancestors: bool = False, fallback_to_new_paths: bool = False, stage: pxr.Usd.Stage | None = None, use_last_cook_context_options: bool = True) -> pxr.Sdf.Path\",\n \"newPaths\": \"(self, lopnode: LopNode | None = None, stage: pxr.Usd.Stage | None = None, use_last_cook_context_options: bool = True) -> Tuple[pxr.Sdf.Path, ...]\",\n },\n \"LopViewportOverrides\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n \"layer\": \"(self) -> pxr.Sdf.Layer\",\n \"soloGeometry\": \"(self) -> pxr.Sdf.Path\",\n \"soloLights\": \"(self) -> pxr.Sdf.Path\",\n \"stage\": \"(self) -> pxr.Usd.Stage\",\n },\n \"Matrix2\": {\n \"__init__\": \"(self, values: int | float | Sequence[int] | Sequence[float] | Sequence[Sequence[int] | Sequence[float]] | 'Matrix2' = 0) -> None\",\n \"__mul__\": \"(self, matrix2_or_scalar: Matrix2 | float) -> Matrix2\",\n \"setTo\": \"(self, value: Sequence[float]) -> None\",\n },\n \"Matrix3\": {\n \"__init__\": \"(self, values: int | float | Sequence[int] | Sequence[float] | Sequence[Sequence[int] | Sequence[float]] | 'Matrix3' = 0) -> None\",\n \"__mul__\": \"(self, matrix3_or_scalar: Matrix3 | float) -> Matrix4\",\n \"setTo\": \"(self, value: Sequence[float]) -> None\",\n \"removeScalesAndShears\": \"(self, transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt') -> Tuple[Vector3, Vector3]\",\n \"extractRotates\": \"(self, rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz') -> Vector3\",\n },\n \"Matrix4\": {\n \"__init__\": \"(self, values: int | float | Sequence[int] | Sequence[float] | Sequence[Sequence[int] | Sequence[float]] | 'Matrix4' = 0) -> None\",\n \"__mul__\": \"(self, matrix4_or_scalar: Matrix4 | float) -> Matrix4\",\n \"explode\": \"(self, transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt', rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz', pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> dict[str, Vector3]\",\n \"extractRotates\": \"(self, transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt', rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz', pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3\",\n \"extractScales\": \"(self, transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt', pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3\",\n \"extractShears\": \"(self, transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt', pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3\",\n \"extractTranslates\": \"(self, transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt', pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3\",\n \"setTo\": \"(self, value: Sequence[float]) -> None\",\n },\n \"MenuParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, menu_items: Sequence[str], menu_labels: Sequence[str] = ..., default_value: int = 0, icon_names: Sequence[str] = ..., item_generator_script: str = '', item_generator_script_language: EnumValue | None = None, disable_when: str | None = None, menu_type: EnumValue = menuType.Normal, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ..., default_expression: str = '', default_expression_language: EnumValue = scriptLanguage.Hscript, store_default_value_as_string: bool = False, menu_use_token: bool = False, is_button_strip: bool = False, strip_uses_icons: bool = False) -> None\",\n \"setDefaultExpressionLanguage\": \"(self, default_expression_language: EnumValue) -> None\",\n },\n \"NetworkAnimValue\": {\n # FIXME: The value_start and value_end types must be the same, so some overloads are\n # in order to make this type annotation correct.\n \"__init__\": \"(self, duration: float | Vector2 | Vector3 | Vector4 | NetworkAnimValue, value_start: float | Vector2 | Vector3 | Vector4 = ..., value_end: float | Vector2 | Vector3 | Vector4 = ...) -> None\",\n },\n \"NetworkEditor\": {\n \"flashMessage\": \"(self, image: str | None, message: str | None, duration: float) -> None\",\n \"openNodeMenu\": \"(self, node: Node | None = None, items: Sequence[NetworkMovableItem] | None = None) -> None\",\n \"openTabMenu\": \"(self, key: str | None = None, auto_place: bool = False, branch: bool = False, src_item: NetworkMovableItem | None = None, src_connector_index: int = -1, dest_item: NetworkMovableItem | None = None, dest_connector_index: int = -1, node_position: Vector2 | None = None, src_items: Sequence[NetworkMovableItem] | None = None, src_indexes: Sequence[int] | None = None, dest_items: Sequence[NetworkMovableItem] | None = None, dest_indexes: Sequence[int] | None = None) -> None\",\n \"registerPref\": \"(self, pref: str, value: str, _global: bool) -> None\",\n \"setParmFilterCriteria\": \"(self, mode: EnumValue) -> None\",\n \"setParmFilterMode\": \"(self, mode: EnumValue) -> None\",\n },\n \"NetworkFootprint\": {\n \"__init__\": \"(self, condition: EnumValue | str, color: Color, ring: int, use_minimum_size: bool) -> None\",\n },\n \"NetworkImage\": {\n \"__init__\": \"(self, path: str, rect: BoundingRect) -> None\",\n },\n \"NetworkMovableItem\": {\n \"move\": \"(self, amount: Sequence[float] | Vector2) -> None\",\n \"setPosition\": \"(self, position: Sequence[float] | Vector2) -> None\",\n \"shiftPosition\": \"(self, amount: Sequence[float] | Vector2) -> None\",\n },\n \"NetworkDot\": {\n \"setInput\": \"(self, input_index: int, item_to_become_input: NetworkMovableItem | None, output_index: int = 0) -> None\",\n },\n \"NetworkShapeConnection\": {\n \"__init__\": \"(self, input_pos: Vector2, input_dir: Vector2, output_pos: Vector2, output_dir: Vector2, color: Color = ..., alpha: float = 1.0, fade_factor: float = 0.0, smooth: bool = True, dashed: bool = False) -> None\",\n },\n \"NetworkShapeLine\": {\n \"__init__\": \"(self, start: Vector2, end: Vector2, color: Color = ..., alpha: float = 1.0, width: float = 1.0, screen_space: bool = True, smooth: bool = True, dashed: bool = False) -> None\",\n },\n \"NetworkShapeBox\": {\n \"__init__\": \"(self, rect: BoundingRect, color: Color = ..., alpha: float = 1.0, fill: bool = True, screen_space: bool = True, smooth: bool = True) -> None\",\n },\n \"NetworkShapeNodeShape\": {\n \"__init__\": \"(self, rect: BoundingRect, shape: str, color: Color = ..., alpha: float = 1.0, fill: bool = True, screen_space: bool = True, smooth: bool = True) -> None\",\n },\n \"Node\": {\n \"copyItemsToClipboard\": \"(self, items: Iterable[NetworkMovableItem]) -> None\",\n \"deleteItems\": \"(self, items: Iterable[NetworkMovableItem], disable_safety_checks: bool = False) -> None\",\n \"input\": \"(self, input_index: int) -> Self | None\",\n \"inputFollowingOutputs\": \"(self, input_index: int) -> Self | None\",\n \"inputs\": \"(self) -> Tuple[Self | None, ...]\",\n \"layoutChildren\": \"(self, items: Sequence[NetworkMovableItem] = ..., horizontal_spacing: float = 1.0, vertical_spacing: float = 1.0) -> None\",\n \"outputs\": \"(self) -> Tuple[Self, ...]\",\n \"recursiveGlob\": \"(self, pattern: str, filter: EnumValue = nodeTypeFilter.NoFilter, include_subnets: bool = True) -> Tuple[Node, ...]\",\n \"setFirstInput\": \"(self, item_to_become_input: NetworkMovableItem | None, output_index: int = 0) -> None\",\n \"setInput\": \"(self, input_index: int, item_to_become_input: NetworkMovableItem | None, output_index: int = 0) -> None\",\n \"setNamedInput\": \"(self, input_name: str, item_to_become_input: NetworkMovableItem, output_name_or_index: str | int) -> None\",\n \"userData\": \"(self, name: str) -> str | None\",\n },\n \"NodeInfoTree\": {\n \"__init__\": \"(self, tree_root: Any, tree: Any) -> None\",\n },\n \"ObjNode\": {\n \"material\": \"(self, operation: Literal['override', 'select', 'remove', 'rmdefault', 'sync', 'revert', 'addlist'], parameter: Sequence[str] | None = None) -> None\",\n },\n \"OpNode\": {\n \"addError\": \"(self, message: str, severity: EnumValue = ...) -> None\",\n \"addEventCallback\": \"(self, event_types: Sequence[EnumValue], callback: Callable) -> None\",\n \"addParmCallback\": \"(self, callback: Callable[[OpNode, ParmTuple], None], names: Sequence[str]) -> None\",\n \"cook\": \"(self, force: bool = False, frame_range: Sequence[float] = ...) -> None\",\n \"cookCodeGeneratorNode\": \"(self, check_parent: bool = False) -> Node\",\n \"evalParm\": \"(self, parm_path: str) -> ParmArgType\",\n \"evalParmTuple\": \"(self, parm_path: str) -> ParmTupleReturnType\",\n \"eventCallbacks\": \"(self) -> Tuple[Tuple[Tuple[EnumValue, ...], Callable], ...]\",\n \"fileReferences\": \"(self, recurse: bool = True, project_dir_variable: str = 'HIP', include_all_refs: bool = True) -> Sequence[Tuple[Parm, str]]\",\n \"lastCookContextOptions\": \"(self, only_used_options: bool = False) -> dict[str, str | float]\",\n \"needsToCook\": \"(self, time: float = ...) -> bool\",\n \"removeEventCallback\": \"(self, event_types: Sequence[EnumValue], callback: Callable) -> None\",\n \"setDeleteScript\": \"(self, script_text: str, language: EnumValue = ...) -> None\",\n \"setInput\": \"(self, input_index: int, item_to_become_input: NetworkMovableItem | None, output_index: int = 0) -> None\",\n \"stampValue\": \"(self, parm_name: str, default_value: float | str) -> str\",\n },\n \"OpNodeType\": {\n \"deprecationInfo\": \"(self) -> dict[str, str | Self]\",\n },\n \"OperationFailed\": {\n \"__init__\": \"(self, message: str | None = ...) -> None\",\n },\n \"OrientedBoundingBox\": {\n \"__init__\": \"(self, oriented_bbox: OrientedBoundingBox = ...) -> None\",\n },\n \"PaneTab\": {\n \"displayRadialMenu\": \"(self, menu: str | RadialScriptItem) -> None\",\n },\n \"ParameterEditor\": {\n \"setFilterCriteria\": \"(self, criteria: EnumValue) -> None\",\n \"setFilterMode\": \"(self, mode: EnumValue) -> None\",\n },\n \"Parm\": {\n \"eval\": \"(self) -> int | float | str\",\n \"evalAtFrame\": \"(self, frame: float) -> int | float | str\",\n \"evalAtTime\": \"(self, frame: float) -> int | float | str\",\n \"keyframesRefit\": \"(self, refit: bool, refit_tol: float, refit_preserve_extrema: bool, refit_bezier: bool, resample: bool, resample_rate: float, resample_tol: float, range_: bool, range_start: float, range_end: bool, bake_chop: EnumValue, refit_smooth: bool) -> None\",\n \"pressButton\": \"(self, arguments: Mapping[str, int | bool | float | str] = ...) -> None\",\n \"set\": \"(self, value: int | float | str | Parm | Ramp, language: EnumValue | None = None, follow_parm_reference: bool = True) -> None\",\n },\n \"ParmTemplate\": {\n \"conditionals\": \"(self) -> dict[EnumValue, str]\",\n \"setTags\": \"(self, tags: Mapping[str, str]) -> None\",\n },\n \"ParmTemplateGroup\": {\n \"__init__\": \"(self, parm_templates: Sequence[ParmTemplate] = ...) -> None\",\n \"appendToFolder\": \"(self, label_or_labels_or_parm_template_or_indices: str | Sequence[str] | ParmTemplate | Sequence[int], parm_template: ParmTemplate) -> None\",\n \"asDialogScript\": \"(self, rename_conflicting_parms: bool = False, full_info: bool = False, script_name: str | None = None, script_label: str | None = None, script_tags: Mapping[str, str] = ...) -> str\",\n \"containingFolder\": \"(self, name_or_parm_template: str | ParmTemplate) -> FolderParmTemplate\",\n \"containingFolderIndices\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int]) -> Tuple[int, ...]\",\n \"findFolder\": \"(self, label_or_labels: str | Sequence[str]) -> ParmTemplate | None\",\n \"findIndices\": \"(self, name_or_parm_template: ParmTemplate | str) -> Tuple[int, ...]\",\n \"findIndicesForFolder\": \"(self, name_or_parm_template: ParmTemplate | str) -> Tuple[int, ...]\",\n \"hide\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int], on: bool) -> None\",\n \"hideFolder\": \"(self, label_or_labels: str | Sequence[str], on: bool) -> None\",\n \"insertAfter\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int], parm_template: ParmTemplate) -> None\",\n \"insertBefore\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int], parm_template: ParmTemplate) -> None\",\n \"isFolderHidden\": \"(self, label_or_labels: str | Sequence[str]) -> bool\",\n \"isHidden\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int]) -> bool\",\n \"remove\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int]) -> None\",\n \"replace\": \"(self, name_or_parm_template_or_indices: str | ParmTemplate | Sequence[int], parm_template: ParmTemplate) -> None\",\n },\n \"ParmTuple\": {\n \"eval\": \"(self) -> Tuple[int, ...] | Tuple[float, ...] | Tuple[str, ...] | Ramp\",\n \"evalAtFrame\": \"(self, frame: float) -> Tuple[int, ...] | Tuple[float, ...] | Tuple[str, ...] | Ramp\",\n \"evalAtTime\": \"(self, frame: float) -> Tuple[int, ...] | Tuple[float, ...] | Tuple[str, ...] | Ramp\",\n \"lock\": \"(self, bool_values: bool | Sequence[bool]) -> None\",\n \"node\": \"(self) -> OpNode\",\n \"setPending\": \"(self, values: Sequence[float | str]) -> None\",\n },\n \"PerfMonEvent\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n },\n \"PerfMonProfile\": {\n \"stats\": \"(self) -> dict[str, Any]\",\n },\n \"PluginHotkeyDefinitions\": {\n \"addDefaultBinding\": \"(self, context: str, command: str, assignments: Sequence[str], apply_platform_modifier_mappings: bool = True) -> None\",\n },\n \"Point\": {\n \"attribValue\": \"(self, attrib: Attrib | str) -> AttribReturnType | AttribDictReturnType\",\n \"dictAttribValue\": \"(self, name_or_attrib: str | Attrib) -> AttribDictReturnType\",\n \"dictListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Sequence[AttribDictReturnType]\",\n \"floatAttribValue\": \"(self, name_or_attrib: str | Attrib) -> float\",\n \"floatListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[float, ...]\",\n \"intAttribValue\": \"(self, name_or_attrib: str | Attrib) -> int\",\n \"intListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[int, ...]\",\n \"setAttribValue\": \"(self, name_or_attrib: str | Attrib, attrib_value: AttribArgType | AttribDictArgType) -> None\",\n \"stringAttribValue\": \"(self, name_or_attrib: str | Attrib) -> str\",\n \"stringListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[str, ...]\",\n },\n \"PointGroup\": {\n \"add\": \"(self, point_or_list_or_point_group: Point | Sequence[Point] | PointGroup) -> None\",\n \"iterPoints\": \"(self) -> _PointTupleGenerator\",\n \"option\": \"(self, option_name: str) -> OptionMultiReturnType\",\n \"options\": \"(self) -> dict[str, OptionMultiReturnType]\",\n \"remove\": \"(self, point_or_list_or_point_group: Point | Sequence[Point] | PointGroup) -> None\",\n \"setOption\": \"(self, name: str, value: OptionMultiArgType, type_hint: EnumValue = fieldType.NoSuchField) -> None\",\n },\n \"Prim\": {\n \"attribValue\": \"(self, attrib: Attrib | str) -> AttribReturnType | AttribDictReturnType\",\n \"attribValueAtInterior\": \"(self, attrib: Attrib | str, u: float, v: float, w: float = 0.0) -> AttribReturnType\",\n \"dictAttribValue\": \"(self, attrib: Attrib | str) -> AttribDictReturnType\",\n \"dictListAttribValue\": \"(self, name_or_attrib: Attrib | str) -> Sequence[AttribDictReturnType]\",\n \"floatAttribValue\": \"(self, attrib: Attrib | str) -> float\",\n \"floatListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[float, ...]\",\n \"intAttribValue\": \"(self, attrib: Attrib | str) -> int\",\n \"intListAttribValue\": \"(self, name_or_attrib: Attrib | str) -> Tuple[int, ...]\",\n \"intrinsicValue\": \"(self, intrinsic_name: str) -> AttribReturnType\",\n \"primuConvert\": \"(self, u: float, mode: int, tol: float | None = ...) -> float\",\n \"primuvConvert\": \"(self, uv: Sequence[float] | Vector2, mode: int, tol: float | None = ...) -> Vector2\",\n \"setAttribValue\": \"(self, name_or_attrib: Attrib | str, attrib_value: AttribArgType | AttribDictArgType) -> None\",\n \"setIntrinsicValue\": \"(self, intrinsic_name: str, value: AttribArgType) -> None\",\n \"stringAttribValue\": \"(self, attrib: Attrib | str) -> str\",\n \"stringListAttribValue\": \"(self, name_or_attrib: Attrib | str) -> Tuple[str, ...]\",\n \"voxelRange\": \"(self, range: BoundingBox) -> Tuple[bool, ...] | Tuple[int, ...] | Tuple[float, ...] | Tuple[Vector3, ...]\",\n },\n \"PrimGroup\": {\n \"add\": \"(self, prim_or_list_or_prim_group: Prim | Sequence[Prim] | PrimGroup) -> None\",\n \"iterPrims\": \"(self) -> _PrimTupleGenerator\",\n \"option\": \"(self, option_name: str) -> OptionMultiReturnType\",\n \"options\": \"(self) -> dict[str, OptionMultiReturnType]\",\n \"remove\": \"(self, prim_or_list_or_prim_group: Prim | Sequence[Prim] | PrimGroup) -> None\",\n \"setOption\": \"(self, name: str, value: OptionMultiArgType, type_hint: EnumValue = fieldType.NoSuchField) -> None\",\n },\n \"Quaternion\": {\n \"__init__\": \"(self, x: Sequence[float] | float | 'Quaternion' | Matrix3 | Matrix4, y: Sequence[float] | float, z: float = ..., w: float = ...) -> None\",\n \"__mul__\": \"(self, quaternion_or_scalar: Quaternion | float) -> Quaternion\",\n \"extractEulerRotates\": \"(self, rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz') -> Vector3\",\n \"setToEulerRotates\": \"(self, angles_in_deg: float, rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz') -> None\",\n \"setToRotationMatrix\": \"(self, matrix3_or_matrix4: Matrix3 | Matrix4) -> None\",\n },\n \"RadialScriptItem\": {\n \"setActionCallback\": \"(self, callback: Callable) -> None\",\n \"setCheckCallback\": \"(self, callback: Callable) -> None\",\n },\n \"Ramp\": {\n \"__init__\": \"(self, basis: Sequence[EnumValue], keys: Sequence[float], values: Sequence[float] | Sequence[Tuple[float, float, float]]) -> None\",\n \"lookup\": \"(self, pos: float) -> float | Tuple[float, float, float]\",\n \"values\": \"(self) -> Tuple[float | Tuple[float, float, float], ...]\",\n },\n \"RampParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, ramp_parm_type: EnumValue, default_value: int = 2, default_basis: EnumValue | None = None, show_controls: bool = True, color_type: EnumValue | None = None, disable_when: str | None = None, is_hidden: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ..., default_expression_language: EnumValue = scriptLanguage.Hscript) -> None\",\n },\n \"RedrawBlock\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n },\n \"RopNode\": {\n \"addRenderEventCallback\": \"(self, callback: Callable[[RopNode, EnumValue, float], None], run_before_script: bool = False) -> None\",\n \"removeRenderEventCallback\": \"(self, callback: Callable[[RopNode, EnumValue, float], None]) -> None\",\n \"render\": \"(self, frame_range: Sequence[float] | None = None, res: Sequence[int] | None = None, output_file: str | None = None, output_format: str=..., to_flipbook: bool = False, quality: int = 2, ignore_inputs: bool = False, method=RopByRop, ignore_bypass_flags: bool = False, ignore_lock_flags: bool = False, verbose: bool = False, output_progress: bool = False) -> None\",\n },\n \"SceneGraphTree\": {\n \"collapsePrimitives\": \"(self, prims: Sequence[str | pxr.Sdf.Path]) -> None\",\n \"expandPrimitives\": \"(self, prims: Sequence[str | pxr.Sdf.Path], collapse_others: bool = False, expand_leaf_primitives: bool = False) -> None\",\n \"expandedPrimitives\": \"(self, include_leaf_primitives: bool = False) -> Tuple[pxr.Sdf.Path, ...]\",\n },\n \"SceneViewer\": {\n \"addEventCallback\": \"(self, callback: Callable) -> None\",\n \"bindViewerHandle\": \"(self, handle_type: str, name: str, settings: str | None = None, cache_previous_parms: bool = False, handle_parms: Sequence[str] | None = None) -> None\",\n \"bindViewerHandleStatic\": \"(self, handle_type: str, name: str, bindings: Sequence[str], settings: str | None = None) -> None\",\n \"eventCallbacks\": \"(self) -> Tuple[Callable, ...]\",\n \"groupListMask\": \"(self) -> str\",\n \"isGroupPicking\": \"(self) -> bool\",\n \"locateSceneGraphPrim\": \"(self, x: int, y: int) -> Tuple[float, str]\",\n \"qtWindow\": \"(self) -> QtWidgets.QWidget\",\n \"removeEventCallback\": \"(self, callback: Callable) -> None\",\n \"runStateCommand\": \"(self, name: str, args: Mapping[str, Any] | None = None) -> None\",\n \"selectDrawableGeometry\": \"(self, drawable_selection: Mapping[str, Incomplete], selection_modifier: EnumValue = pickModifier.Replace) -> None\",\n \"selectDynamics\": \"(self, prompt: str = 'Select objects', sel_index: int = 0, allow_objects: bool = True, allow_modifiers: bool = False, quick_select: bool = False, use_existing_selection: bool = True, allow_multisel: bool = True, icon: str | None = None, label: str | None = None, prior_selection_paths: Sequence[str] | None = ..., prior_selection_ids: int | None = ..., prior_selections: Sequence[str] = ..., toolbox_templategroup: str | None = None, toolbox1_templategroup: str | None = None, select_parm: str = '') -> Tuple[DopData, ...]\",\n \"selectDynamicsPoints\": \"(self, prompt: str = 'Select objects', sel_index: int = 0, quick_select: bool = False, use_existing_selection: bool = True, allow_multisel: bool = True, only_select_points: bool = True, object_based_point_selection: bool = False, use_last_selected_object: bool = False, icon: str | None = None, label: str | None = None, prior_selection_paths: Sequence[str] | None = ..., prior_selection_ids: int | None = ..., prior_selections: Sequence[str] = ..., toolbox_templategroup: str | None = None, toolbox1_templategroup: str | None = None, select_parm: str = '') -> Sequence[Tuple[DopData, GeometrySelection]]\",\n \"selectDynamicsPolygons\": \"(self, prompt: str = 'Select objects', sel_index: int = 0, quick_select: bool = False, use_existing_selection: bool = True, object_based_point_selection: bool = False, use_last_selected_object: bool = False, icon: str | None = None, label: str | None = None, prior_selection_paths: Sequence[str] | None = ..., prior_selection_ids: int | None = ..., prior_selections: Sequence[str] = ..., toolbox_templategroup: str | None = None, toolbox1_templategroup: str | None = None, select_parm: str = '') -> Sequence[Tuple[DopData, GeometrySelection]]\",\n \"selectGeometry\": \"(self, prompt: str = 'Select geometry', sel_index: int = 0, allow_drag: bool = False, quick_select: bool = False, use_existing_selection: bool = True, initial_selection: str | None = None, initial_selection_type: EnumValue | None = None, ordered: bool = False, geometry_types: Sequence[EnumValue] = ..., primitive_types: Sequence[EnumValue] = ..., allow_obj_sel: bool = True, icon: str | None = None, label: str | None = None, prior_selection_paths: list = ..., prior_selection_ids: list = ..., prior_selections: list = ..., allow_other_sops: bool = True, consume_selections: bool = True) -> GeometrySelection\",\n \"selectObjects\": \"(self, prompt: str = 'Select objects', sel_index: int = 0, allow_drag: bool = False, quick_select: bool = False, use_existing_selection: bool = True, allow_multisel: bool = True, allowed_types: Sequence[str] = ..., icon: str | None = None, label: str | None = None, prior_selection_paths: Sequence[str] | None = ..., prior_selection_ids: int | None = ..., prior_selections: Sequence[str] = ..., toolbox_templategroup: str | None = None, toolbox1_templategroup: str | None = None, select_parm: str = '') -> Tuple[Node, ...]\",\n \"selectOrientedPositions\": \"(self, prompt: str = 'Click to specify a position', number_of_positions: int = 1, min_number_of_positions: int = -1, connect_positions: bool = True, show_coordinates: bool = True, bbox: BoundingBox = ..., icon: str | None = None, label: str | None = None, toolbox_templategroup: str | None = None, toolbox1_templategroup: str | None = None, select_parm: str = '') -> Sequence[Tuple[Vector3, Matrix3]]\",\n \"selectPositions\": \"(self, prompt: str = 'Click to specify a position', number_of_positions: int = 1, min_number_of_positions: int = -1, connect_positions: bool = True, show_coordinates: bool = True, bbox: BoundingBox = ..., position_type: EnumValue = positionType.WorldSpace, icon: str | None = None, label: str | None =None, toolbox_templategroup: str | None = None, toolbox1_templategroup: str | None = None, select_parm: str ='') -> Sequence[Vector3]\",\n \"selectSceneGraph\": \"(self, prompt: str ='Select primitives', preselection: Sequence[str] = ..., prim_mask: EnumValue = scenePrimMask.ViewerSetting, quick_select: bool = False, use_existing_selection: bool = True, confirm_existing: bool = False, allow_multisel: bool = True, allow_drag: bool = True, propagate_selection: bool = True, path_prefix_mask: str = '', prim_kind: str = '', validate_selection_for_node: Incomplete = ..., select_parm: str = '', allow_kind_mismatch: EnumValue = optionalBool.NoOpinion, allow_instance_proxies: EnumValue = optionalBool.NoOpinion, fix_preselection_paths=True) -> Tuple[str, ...]\",\n \"selectSceneGraphInstances\": \"(self, prompt: str = 'Select point instances', preselection: Sequence[str] = ..., quick_select: bool = False, use_existing_selection: bool = True, confirm_existing: bool = False, allow_multisel: bool = True, allow_drag: bool = True, path_prefix_mask: str = '', instance_level: int = 0, instance_indices_only: bool = False, validate_selection_for_node: Incomplete = ..., select_parm: str = '') -> Tuple[str, ...]\",\n \"setCurrentState\": \"(self, state: EnumValue, wait_for_exit: bool = False, generate: EnumValue = stateGenerateMode.Insert, request_new_on_generate: bool = True, ex_situ_generate: bool = False) -> None\",\n \"setPromptMessage\": \"(self, msg: str, msg_type: EnumValue = promptMessageType.Prompt) -> None\",\n \"stage\": \"(self) -> pxr.Usd.Stage\",\n \"triggerStateSelector\": \"(self, action: EnumValue, name: str | None = None) -> None\",\n },\n \"ScriptEvalContext\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n \"__init__\": \"(self, node_or_parm: OpNode | Parm) -> None\",\n },\n \"Selection\": {\n \"__init__\": \"(self, selection: EnumValue | Geometry | Sequence[Prim] | Sequence[Point] | Sequence[Vertex] | Sequence[Edge], geometry_type: EnumValue | Sequence[EnumValue] = ..., selection_string: str = ...) -> None\",\n \"numSelected\": \"(self) -> int\",\n },\n \"SeparatorParmTemplate\": {\n \"__init__\": \"(self, name: str, is_hidden: bool = False, tags: Mapping[str, str] = ...) -> None\",\n },\n \"Shelf\": {\n \"setTools\": \"(self, tools: Sequence[Tool]) -> None\",\n },\n \"ShelfElement\": {\n \"setFilePath\": \"(self, file_path: str | None) -> None\",\n },\n \"ShopNode\": {\n \"shaderCode\": \"(self, shader_type: EnumValue | None = None) -> str\",\n \"shaderString\": \"(self, render_type: str | None = None) -> str\",\n },\n \"ShellIO\": {\n \"CloseCallbacks\": \"(self) -> Tuple[Callable[[], None], ...]\",\n \"addCloseCallback\": \"(self, callback: Callable[[], None]) -> None\",\n \"addExitCallback\": \"(self, callback: Callable[[], None]) -> None\",\n \"closeCallbacks\": \"(self) -> Tuple[Callable[[], None], ...]\",\n \"exitCallbacks\": \"(self) -> Tuple[Callable[[], None], ...]\",\n \"readline\": \"(self, size: int = -1) -> str\",\n \"removeCloseCallback\": \"(self, callback: Callable[[], None]) -> None\",\n \"removeExitCallback\": \"(self, callback: Callable[[], None]) -> None\",\n },\n \"SimpleDrawable\": {\n \"__init__\": \"(self, scene_viewer: SceneViewer, geometry: Geometry | EnumValue, name: str) -> None\",\n \"setOutlineColor\": \"(self, color: Color | Vector4) -> None\",\n },\n \"SopNodeType\": {\n \"addSelector\": \"(self, name: str, selector_type: str, prompt: str = 'Select components', primitive_types: Sequence[EnumValue] = ..., group_parm_name: str | None = None, group_type_parm_name: str | None = None, input_index: int = 0, input_required: bool = True, allow_dragging: bool = False, empty_string_selects_all: bool = True) -> Selector\",\n \"selectors\": \"(self, selector_indices: Sequence[int] = ...) -> Tuple[Selector, ...]\",\n },\n \"OpVerb\": {\n \"parms\": \"(self) -> dict[str, OptionType]\",\n \"setParms\": \"(self, p: Mapping[str, OptionMultiArgType | Sequence[Mapping[str, OptionMultiArgType]]]) -> None\",\n },\n \"StickyNote\": {\n \"setSize\": \"(self, size: Sequence[float] | Vector2) -> None\",\n },\n \"StringKeyframe\": {\n \"__init__\": \"(self, expression: str | None = None, time: float | None = None, language: EnumValue | None = exprLanguage.Python) -> None\",\n },\n \"StringParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, num_components: int, default_value: Sequence[str] = ..., naming_scheme: EnumValue = parmNamingScheme.Base1, string_type: EnumValue = stringParmType.Regular, file_type: EnumValue = fileType.Any, menu_items: Sequence[str] = ..., menu_labels: Sequence[str] = ..., icon_names: Sequence[str] = ..., item_generator_script: str | None = None, item_generator_script_language: EnumValue | None = None, menu_type: EnumValue = menuType.Normal, disable_when: str | None = None, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[EnumValue] = ...) -> None\",\n },\n \"StyleSheet\": {\n \"__init__\": \"(self, json_text: str = ...) -> None\",\n \"cloneWithAddedStyleSheet\": \"(self, stylesheet: StyleSheet, target: str | None = ...) -> StyleSheet\",\n },\n \"Surface\": {\n \"attribValueAt\": \"(self, attrib_or_name: Attrib | str, u: float, v: float, du: float = 0, dv: float = 0) -> int | float | str | Tuple[int, ...] | Tuple[float, ...]\"\n },\n \"SwigPyIterator\": {\n \"__sub__\": \"(self, n: int) -> Any\",\n },\n \"Take\": {\n \"loadChildTakeFromFile\": \"(self, filename: str) -> Tuple[Take, ...]\",\n \"name\": \"(self) -> str\",\n },\n \"TextDrawable\": {\n \"__init__\": \"(self, scene_viewer: SceneViewer, name: str, label: str | None = None, params: Mapping[str, Any] | None = None) -> None\",\n },\n \"ToggleParmTemplate\": {\n \"__init__\": \"(self, name: str, label: str, default_value: bool = False, disable_when: str | None =None, is_hidden: bool = False, is_label_hidden: bool = False, join_with_next: bool = False, help: str | None = None, script_callback: str | None = None, script_callback_language: EnumValue = scriptLanguage.Hscript, tags: Mapping[str, str] = ..., default_expression: str = '', default_expression_language: EnumValue = scriptLanguage.Hscript) -> None\",\n },\n \"Tool\": {\n \"setData\": \"(self, script: str = '', language: EnumValue = scriptLanguage.Python, icon: str = '', help: str = '', help_url: str = '', network_categories: Sequence[NodeTypeCategory] = ..., viewer_categories: Sequence[NodeTypeCategory] = ..., cop_viewer_categories: Sequence[NodeTypeCategory] = ..., network_op_type: str = '', viewer_op_type: str = '', locations: Sequence[str] = ...) -> None\",\n },\n \"TopNode\": {\n \"cookWorkItems\": \"(self, block: bool = False, generate_only: bool = False, tops_only: bool = False, save_prompt: bool = False, nodes: Sequence[TopNode] = ...) -> None\",\n \"generateStaticWorkItems\": \"(self, block: bool = False, nodes: Sequence[TopNode] = ...) -> None\",\n },\n \"UndosDisabler\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n },\n \"UndosGroup\": {\n \"__exit__\": \"(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None\",\n },\n \"Vector2\": {\n \"__init__\": \"(self, x: Sequence[float] | 'Vector2' | float = ..., y: float = ...) -> None\",\n \"__mul__\": \"(self, scalar_or_matrix2: float | Matrix2) -> Vector2\",\n },\n \"Vector3\": {\n \"__init__\": \"(self, x: Sequence[float] | 'Vector3' | float = ..., y: float = ..., z: float = ...) -> None\",\n \"__mul__\": \"(self, scalar_or_matrix3_or_matrix4: float | Matrix3 | Matrix4) -> Vector3\",\n \"smoothRotation\": \"(self, reference: Vector3, rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz') -> Vector3\",\n },\n \"Vector4\": {\n \"__init__\": \"(self, x: Sequence[float] | 'Vector4' | float = ..., y: float = ..., z: float = ..., w: float = ...) -> None\",\n \"__mul__\": \"(self, scalar_or_matrix4: float | Matrix4) -> Vector4\",\n },\n \"Vertex\": {\n \"attribValue\": \"(self, attrib: Attrib | str) -> AttribReturnType | AttribDictReturnType\",\n \"dictAttribValue\": \"(self, name_or_attrib: str | Attrib) -> AttribDictReturnType\",\n \"dictListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Sequence[AttribDictReturnType]\",\n \"floatAttribValue\": \"(self, name_or_attrib: str | Attrib) -> float\",\n \"floatListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[float, ...]\",\n \"intAttribValue\": \"(self, name_or_attrib: str | Attrib) -> int\",\n \"intListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[int, ...]\",\n \"setAttribValue\": \"(self, name_or_attrib: str | Attrib, attrib_value: AttribArgType | AttribDictArgType) -> None\",\n \"stringAttribValue\": \"(self, name_or_attrib: str | Attrib) -> str\",\n \"stringListAttribValue\": \"(self, name_or_attrib: str | Attrib) -> Tuple[str, ...]\",\n },\n \"VertexGroup\": {\n \"add\": \"(self, vertex_or_list_or_vertex_group: Vertex | Sequence[Vertex] | VertexGroup) -> None\",\n \"iterVertices\": \"(self) -> _VertexTupleGenerator\",\n \"option\": \"(self, option_name: str) -> OptionMultiReturnType\",\n \"options\": \"(self) -> dict[str, OptionMultiReturnType]\",\n \"remove\": \"(self, vertex_or_list_or_vertex_group: Vertex | Sequence[Vertex] | VertexGroup) -> None\",\n \"setOption\": \"(self, name: str, value: OptionMultiArgType, type_hint: EnumValue = fieldType.NoSuchField) -> None\",\n },\n \"ViewerDragger\": {\n \"drag\": \"(self, event: ViewerEvent) -> dict[str, Any]\",\n },\n \"ViewerHandleContext\": {\n \"draw\": \"(self, handle: Handle) -> None\",\n \"scaleFactor\": \"(self, ref_position: Sequence[float] | Vector3 = ...) -> float\",\n },\n \"ViewerHandleTemplate\": {\n \"__init__\": \"(self, name: str, label: str, categories: Sequence[EnumValue]) -> None\",\n \"bindFactory\": \"(self, callback: Callable[[SceneViewer, str], Handle])\",\n \"bindGadget\": \"(self, drawable_type: EnumValue, gadget_name: str , gadget_label: str | None = None, parms: Sequence[str] | None = None) -> None\",\n \"bindParameter\": \"(self, param_type: EnumValue, name: str , label: str | None = None, default_value: int | float | str | None = None, num_components: int = 1, min_limit: int = 0, max_limit: int = 1, visible: bool = True) -> None\",\n \"bindSetting\": \"(self, param_type: EnumValue, name: str , label: str | None = None, menu_as_button_strip: bool = False, menu_items: Sequence[Tuple[str, str] | Tuple[str, str, str]] | None = None, num_components: int = 1, default_value: int | float | str | None = None, min_limit: int = 0, max_limit: int = 1, align: bool = False) -> None\",\n },\n \"ViewerState\": {\n \"parmTemplates\": \"(self) -> ParmTemplateGroup\",\n },\n \"ViewerStateDragger\": {\n \"__init__\": \"(self, name: str, xform: Matrix4 = ..., inv_xform: Matrix4 = ...) -> None\",\n },\n \"ViewerStateMenu\": {\n \"addActionItem\": \"(self, id,: str label: str, hotkey: str = '') -> None\",\n \"addRadioStripItem\": \"(self, strip_id: str, id: str label: str, hotkey: str = '') -> None\",\n \"addToggleItem\": \"(self, id,: str label: str, default: bool, hotkey: str = '') -> None\",\n },\n \"ViewerStateTemplate\": {\n \"__init__\": \"(self, state_name: str, state_label: str, node_type_category: NodeTypeCategory, contexts: Sequence[NodeTypeCategory] | None = None) -> None\",\n \"bindDrawableSelector\": \"(self, prompt: str, auto_start: bool = True, toolbox: bool = True, drawable_mask=[], hotkey: str = '', name: str = '') -> None\",\n \"bindDynamicsPointSelector\": \"(self, prompt: str, allow_objects: bool = True, allow_modifiers: bool = False, quick_select: bool = True, auto_start: bool = True, toolbox: bool = True, use_existing_selection: bool = True, secure_selection: EnumValue = secureSelectionOption.Obey, allow_multisel: bool = True, only_select_points: bool = True, object_based_point_selection: bool = False, use_last_selected_object: bool = False, hotkey: str = '', name: str = '') -> None\",\n \"bindDynamicsPolygonSelector\": \"(self, prompt: str, quick_select: bool = True, auto_start: bool = True, toolbox: bool = True, use_existing_selection: bool = True, object_based_point_selection: bool = False, secure_selection: EnumValue = secureSelectionOption.Obey, use_last_selected_object: bool = False, hotkey: str = '', name: str = '') -> None\",\n \"bindDynamicsSelector\": \"(self, prompt: str, allow_objects: bool = True, allow_modifiers: bool = False, quick_select: bool = True, auto_start: bool = True, toolbox: bool = True, use_existing_selection: bool = True, secure_selection: EnumValue = secureSelectionOption.Obey, allow_multisel: bool = True, hotkey: str = '', name: str = '') -> None\",\n \"bindFactory\": \"(self, callback: Callable[[str, SceneViewer], Any])\",\n \"bindGadget\": \"(self, drawable_type: EnumValue, gadget_name: str, gadget_label: str | None = None) -> None\",\n \"bindGeometrySelector\": \"(self, prompt: str, allow_drag: bool = False, quick_select: bool = True, auto_start: bool = True, toolbox: bool = True, use_existing_selection: bool = True, consume_selection: bool = True, secure_selection: EnumValue = secureSelectionOption.Obey, initial_selection: str = '', initial_selection_type: EnumValue = geometryType.Primitives, ordered: bool = False, geometry_types: Sequence[EnumValue] = ..., primitive_types: Sequence[EnumValue] = ..., allow_other_sops: bool = False, hotkey: str = '', name: str = '') -> None\",\n \"bindHandle\": \"(self, handle_type: str, name: str, settings: str | None = None) -> None\",\n \"bindHandleStatic\": \"(self, handle_type: str, name: str, bindings: Sequence[str] , settings: str | None = None) -> None\",\n \"bindObjectSelector\": \"(self, prompt: str, quick_select: bool = True, auto_start: bool = True, toolbox: bool = True, use_existing_selection: bool = True, allow_multisel: bool = True, secure_selection: EnumValue = secureSelectionOption.Obey, allowed_types: Sequence[str] = ..., hotkey: str = '', name: str = '') -> None\",\n \"bindParameter\": \"(self, param_type: EnumValue, name: str | None = None, label: str | None = None, menu_as_button_strip: bool = False, menu_items: Sequence[Tuple[str, str] | Tuple[str, str, str]] | None = None, num_components: int = 1, default_value: ParmArgType | None=None, min_limit: int = 0, max_limit: int = 1, align: bool = False, toolbox: bool = True) -> None\",\n \"bindSceneGraphSelector\": \"(self, prompt: str, allow_drag: bool = True, quick_select: bool = True, auto_start: bool = True, toolbox: bool = True, use_existing_selection: bool = True, secure_selection: EnumValue = secureSelectionOption.Obey, consume_selection: bool = False, allow_multisel: bool = True, prior_selection_paths: Sequence[str] | None=..., prim_mask: str | None=..., path_prefix_mask: str | None=..., prim_kind: str | None=..., hotkey: str = '', name: str = '') -> None\",\n \"bindSelector\": \"(self, name, selector_type, prompt: str, primitive_types: Sequence[EnumValue]=..., group_parm_name: str = ..., input_index=0, input_required: bool = True, allow_dragging: bool = True) -> None\",\n },\n \"ViewportVisualizer\": {\n \"setParm\": \"(self, parm_name: str, value: int | float | str) -> None\",\n },\n \"Volume\": {\n \"setAllVoxelsFromString\": \"(self, values: bytes) -> None\",\n \"setVoxelSliceFromString\": \"(self, values: bytes, plane: str, index: int) -> None\",\n },\n \"VopNode\": {\n \"shaderCode\": \"(self, shader_type: EnumValue | None = None) -> str\",\n \"shaderString\": \"(self, render_type: str | None = None, shader_type: EnumValue = shaderType.Surface, as_encapsulated: bool = False) -> str\",\n },\n \"anim\": {\n \"addBookmarksChangedCallback\": \"(callback: Callable) -> None\",\n \"addGeometryChannelsChangedCallback\": \"(collection_name: str, callback: Callable, on_mouse_up: bool = True) -> bool\",\n \"getGeometryChannels\": \"(collection_name: str, geometry: Geometry, channel_names: Sequence[str] | None = None) -> None\",\n \"isGeometryChannelPinned\": \"(collection_name: str, channel_names: str | None = None) -> bool\",\n \"mergeGeometryChannels\": \"(collection_name: str, geometry: Geometry, channel_names: Sequence[str] | None = None) -> None\",\n \"newBookmark\": \"(name: str, start: float, end: float) -> Bookmark\",\n \"removeBookmarksChangedCallback\": \"(callback: Callable) -> None\",\n \"removeGeometryChannelsChangedCallback\": \"(collection_name: str, callback: Callable, on_mouse_up: bool = True) -> bool\",\n \"saveBookmarks\": \"(filename: str, bookmarks: Sequence[Bookmark] | None = None, include_temporary: bool = False) -> bool\",\n \"saveBookmarksToString\": \"(bookmarks: Sequence[Bookmark] | None = None, include_temporary: bool = False, binary: bool = True) -> bytes\",\n \"setGeometryChannelsFromPattern\": \"(collection_name: str, geometry: Geometry, pattern: str) -> None\",\n },\n \"clone\": {\n \"addConnectionChangeCallback\": \"(callback: Callable[[str], None]) -> None\",\n \"addImageChangeCallback\": \"(callback: Callable[[str], None]) -> None\",\n \"connectionChangeCallbacks\": \"() -> Tuple[Callable[[str], None], ...]\",\n \"imageChangeCallbacks\": \"() -> Tuple[Callable[[str], None], ...]\",\n \"removeConnectionChangeCallback\": \"(callback: Callable[[str], None]) -> None\",\n \"removeImageChangeCallback\": \"(callback: Callable[[str], None]) -> None\",\n },\n \"crowds\": {\n \"findAgentDefinitions\": \"(geometry: Geometry, group: str = '', group_type: EnumValue = geometryType.Primitives) -> Tuple[AgentDefinition, ...]\",\n \"replaceAgentDefinitions\": \"(geometry: Geometry, new_definition_map: Mapping[AgentDefinition, AgentDefinition], group: str = '', group_type: EnumValue = geometryType.Primitives) -> None\",\n \"setBlendshapeDeformerParms\": \"(base_shape_geo: Geometry, attribs: str = 'P N', point_id_attrib: str = 'id', prim_id_attrib: str = 'id') -> None\",\n \"applyUsdProcedural\": \"(stage: pxr.Usd.Stage, selection_rule: LopSelectionRule, camera_path: str, resolution: Tuple[int, int], lod_threshold: float, offscreen_quality: float, optimize_identical_poses: bool, bake_all_agents: bool, frame: float, prototype_material: str, instance_material: str, default_material: str) -> None\",\n },\n \"hda\": {\n \"addEventCallback\": \"(event_types: Sequence[EnumValue], callback: Callable) -> None\",\n \"eventCallbacks\": \"() -> Tuple[Tuple[Tuple[EnumValue, ...], Callable], ...]) -> None\",\n \"removeEventCallback\": \"(event_types: Sequence[EnumValue], callback: Callable) -> None\",\n },\n \"hipFile\": {\n \"collisionNodesIfMerged\": \"(file_name: str, node_pattern: str = '*') -> Tuple[OpNode, ...]\",\n \"importFBX\": \"(file_name: str, suppress_save_prompt: bool = False, merge_into_scene: bool = True, import_cameras: bool = True, import_joints_and_skin: bool = True, import_geometry: bool = True, import_lights: bool = True, import_animation: bool = True, import_materials: bool = True, resample_animation: bool = False, resample_interval: float = 1.0, override_framerate: bool = False, framerate: int = -1, hide_joints_attached_to_skin: bool = True, convert_joints_to_zyx_rotation_order: bool = False, material_mode: EnumValue = fbxMaterialMode.FBXShaderNodes, compatibility_mode: EnumValue = fbxCompatibilityMode.Maya, single_precision_vertex_caches: bool = False, triangulate_nurbs: bool = False, triangulate_patches: bool = False, import_global_ambient_light: bool = False, import_blend_deformers_as_blend_sops: bool = False, segment_scale_already_baked_in: bool = True, convert_file_paths_to_relative: bool = True, unlock_geometry: bool = False, unlock_deformations: bool = False, import_nulls_as_subnets: bool = False, import_into_object_subnet: bool = True, convert_into_y_up_coordinate_system: bool = False, create_sibling_bones: bool = True, override_scene_frame_range: bool = False, convert_units: bool = False) -> Tuple[ObjNode, ...]\",\n \"merge\": \"(file_name: str, node_pattern: str = '*', overwrite_on_conflict: bool = False, ignore_load_warnings: bool = False) -> None\",\n },\n \"hmath\": {\n \"buildRotate\": \"(rx: float | Vector3, ry: float = ..., rz: float = ..., order: str = 'xyz') -> Matrix4\",\n \"buildScale\": \"(sx: float | Vector3, sy: float = ..., sz: float = ...) -> Matrix4\",\n \"buildShear\": \"(shearx: float | Vector3, sheary: float = ..., shearz: float = ...) -> Matrix4\",\n \"buildTransform\": \"(values_dict: Mapping[str, Vector3 | Sequence[float]], transform_order: Literal['srt', 'str', 'rst', 'rts', 'tsr', 'trs'] = 'srt', rotate_order: Literal['xyz', 'xzy', 'yxz', 'yzx', 'zxy', 'zyx'] = 'xyz') -> Matrix4\",\n \"buildTranslate\": \"(tx: float | Vector3, ty: float = ..., tz: float = ...) -> Matrix4\",\n \"combineLocalTransform\": \"(local: Matrix4, world: Matrix4, parent_local: Matrix4 | None = None, mode: EnumValue = scaleInheritanceMode.Default) -> Matrix4\",\n \"extractLocalTransform\": \"(local: Matrix4, world: Matrix4, parent_local: Matrix4, mode: EnumValue = scaleInheritanceMode.Default, effective_local: Matrix4 | None = None) -> Matrix4\",\n },\n \"hotkeys\": {\n \"addAssignment\": \"(context: str, hotkey_symbol: str, key: str = ...) -> bool\",\n \"addCommand\": \"(hotkey_symbol: str, label: str, description: str, assignments: Sequence[str]) -> bool\",\n \"assignments\": \"(hotkey_symbol: str) -> Tuple[str, ...]\",\n \"availableKeycodes\": \"(context: str, hotkey_symbol: str, layout_keys: Sequence[str] | None = None, modifiers: int = 0) -> Tuple[int, ...]\",\n \"clearAssignments\": \"(context: str, hotkey_symbol: str = ...) -> bool\",\n \"findConflicts\": \"(context: str, hotkey_symbol: str, key: str | None = None) -> Tuple[str, ...]\",\n \"removeAssignment\": \"(context: str, hotkey_symbol: str, key: str = ...) -> bool\",\n \"revertToDefaults\": \"(context: str, hotkey_symbol: str, one_level_only: bool) -> None\",\n },\n \"ik\": {\n \"solveFBIK\": \"(skeleton: Sequence[_ik_Skeleton], targets: Sequence[_ik_Target], iters: int = 30, tolerance: float = 1e-5, pin_root: bool = False) -> None\",\n \"solvePhysFBIK\": \"(skeleton: Sequence[_ik_Skeleton], targets: Sequence[_ik_Target], com_target: _ik_Target | None = None, iters: int = 30, damping: float = 0.5, tolerance: float = 1e-5) -> None\",\n },\n \"lop\": {\n \"addLockedGeometry\": \"(identifier: str, geo: Geometry, args: Mapping[str, str] | None = None) -> str\",\n \"addPreferenceChangeCallback\": \"(callback: Callable) -> None\",\n \"availableRendererInfo\": \"() -> list[dict[str, Any]]\",\n \"createConnectionParmsForProperty\": \"(source: LopNode | str, primpath: str, propertyname: str, parametername: str | None = None, prepend_control_parm: bool = ...) -> ParmTemplateGroup\",\n \"createParmsForProperty\": \"(source: LopNode | str, primpath: str, propertyname: str, parametername: str | None = None, prepend_control_parm: bool = ..., prefix_xform_parms: bool = ...) -> ParmTemplateGroup\",\n \"removePreferenceChangeCallback\": \"(callback: Callable) -> None\",\n \"setParmTupleFromProperty\": \"(parmtuple: ParmTuple, source: LopNode | str, primpath: str, propertyname: str) -> None\",\n \"translateShader\": \"(node: Node, node_output_name: str, material_prim_path: str, container_prim_path: str, shader_prim_name: str | None = None, frame: float | None = None) -> str\",\n },\n \"playbar\": {\n \"addEventCallback\": \"(callback: Callable[[EnumValue, float], None]) -> None\",\n \"eventCallbacks\": \"() -> Tuple[Callable[[EnumValue, float], None], ...]\",\n \"removeEventCallback\": \"(callback: Callable[[EnumValue, float], None]) -> None\",\n \"setChannelList\": \"(arg: ChannelList) -> None\",\n },\n \"properties\": {\n \"classes\": \"(tags: Sequence[str] | None = None) -> Tuple[str, ...]\",\n },\n \"shelves\": {\n \"newTool\": \"(file_path: str | None = None, name: str | None = None, label: str | None = None, script: str | None = None, language: EnumValue = scriptLanguage.Python, icon: str | None = None, help: str | None = None, help_url: str | None = None, network_categories: Sequence[NodeTypeCategory] = ..., viewer_categories: Sequence[NodeTypeCategory] = ..., cop_viewer_categories: Sequence[NodeTypeCategory] = ..., network_op_type: str | None = None, viewer_op_type: str | None = None, locations: Sequence[str] = ..., hda_definition: HDADefinition | None = None) -> Tool\",\n },\n \"text\": {\n \"collapseCommonVars\": \"(path: str, vars: Sequence[str] = ...) -> str\",\n },\n \"ui\": {\n \"addEventLoopCallback\": \"(callback: Callable[[], None]) -> None\",\n \"addResourceEventCallback\": \"(callback: Callable[[EnumValue, Any, str], None]) -> None\",\n \"addSelectionCallback\": \"(callback: Callable[[Sequence[NetworkMovableItem]], None]) -> None\",\n \"addTriggerUpdateCallback\": \"(callback: Callable) -> None\",\n \"displayConfirmation\": \"(text: str, severity: EnumValue = ..., help: str | None = None, title: str | None = None, details: str | None = None, details_label: str | None = None, details_expanded: bool = False, suppress: EnumValue = ...) -> bool\",\n \"displayCustomConfirmation\": \"(text: str, buttons: Sequence[str] = ..., severity: EnumValue = ..., default_choice: int = 0, close_choice: int = -1, help: str | None = None, title: str | None = None, details: str | None = None, details_label: str | None = None, details_expanded: bool = False, suppress: EnumValue = ...) -> int\",\n \"displayFileDependencyDialog\": \"(rop_node: RopNode | None = None, uploaded_files: Sequence[str] = ..., forced_unselected_patterns: Sequence[str] = ..., project_dir_variable: str = 'HIP', is_standalone: bool = true) -> Tuple[bool, Tuple[Tuple[Parm, str], ...]]\",\n \"displayMessage\": \"(text: str, buttons: Sequence[str] = ..., severity: EnumValue = ..., default_choice: int = 0, close_choice: int = -1, help: str | None = None, title: str | None = None, details: str | None = None, details_label: str | None = None, details_expanded: bool = False, suppress: EnumValue = ...) -> int\",\n \"eventLoopCallbacks\": \"() -> Tuple[Callable[[], None], ...]\",\n \"fireResourceCustomEvent\": \"(resource_type: EnumValue, user_data: Mapping[str, bool | AttribBasicType], queue: bool = True) -> None\",\n \"getDragSourceData\": \"(label: str, index: int = 0) -> Any\",\n \"hasDragSourceData\": \"(label: str, index: int) -> bool\",\n \"loadPackageArchive\": \"(file_path: str, extract_path: str | None = None) -> Tuple[str, ...]\",\n \"openColorEditor\": \"(color_changed_callback: Callable[[Color, float], None], include_alpha: bool = False, initial_color: Color | None = None, initial_alpha: float = 1.0) -> None\",\n \"openFileEditor\": \"(title: str, file_path: str, action_callback: Callable[[Mapping[str, int | float | bool | str]], None] | None = None, params: Mapping[str, int | float | bool | str] | None = None) -> None\",\n \"openValueLadder\": \"(initial_value: float, value_changed_callback: Callable[[float], None], type: EnumValue = valueLadderType.Generic, data_type: EnumValue = valueLadderDataType.Float) -> None\",\n \"openViewerHandleCodeGenDialog\": \"(category: NodeTypeCategory, action_callback: Callable[[Mapping[str, str | bool]], None]) -> None\",\n \"openViewerStateCodeGenDialog\": \"(category: NodeTypeCategory, action_callback: Callable[[Mapping[str, int | float | bool | str]], None], operator_name: str | None = None) -> None\",\n \"packageInfo\": \"(file_paths: Sequence[str]) -> str\",\n \"postEventCallback\": \"(callback: Callable[[], None]) -> None\",\n \"printResourceMessage\": \"(resource_type: EnumValue, message: str, message_type: EnumValue = ...) -> None\",\n \"readInput\": \"(text: str, buttons: Sequence[str] = ..., severity_type: EnumValue = ..., default_choice: int = 0, close_choice: int = -1, help: str | None = None, title: str | None = None, initial_contents: str | None = None) -> Tuple[int, str]\",\n \"readMultiInput\": \"(text: str, input_labels: Sequence[str], password_input_indices: Sequence[int] = ..., buttons: Sequence[str] = ..., severity_type: EnumValue = ..., default_choice: int = 0, close_choice: int = -1, help: str | None = None, title: str | None = None, initial_contents: Sequence[str] = ...) -> Tuple[int, Tuple[str, ...]]\",\n \"reloadViewerStates\": \"(state_names: Sequence[str] | None = None) -> None\",\n \"removeEventLoopCallback\": \"(callback: Callable[[], None]) -> None\",\n \"removePostedEventCallback\": \"(callback: Callable[[], None]) -> None\",\n \"removeResourceEventCallback\": \"(callback: Callable[[EnumValue, Any, str], None]) -> None\",\n \"removeSelectionCallback\": \"(callback: Callable[[Sequence[NetworkMovableItem]], None]) -> None\",\n \"removeTriggerUpdateCallback\": \"(callback: Callable) -> None\",\n \"selectFromList\": \"(choices: Sequence[str], default_choices: Sequence[int] = ..., exclusive: bool = False, message: str | None = None, title: str | None = None, column_header: str = 'Choices', num_visible_rows: int = 10, clear_on_cancel: bool = False, width: int = 0, height: int = 0, sort: bool = False, condense_paths: bool = False) -> Tuple[int, ...]\",\n \"selectFromTree\": \"(choices: Sequence[str], picked: Sequence[int] = ..., exclusive: bool = False, message: str | None = None, title: str | None = None, clear_on_cancel: bool = False, width: int = 0, height: int = 0) -> Tuple[str, ...]\",\n \"selectMultipleNodes\": \"(relative_to_node: Node | None = None, initial_node: Node | None = None, node_type_filter: EnumValue | None = None, title: str | None = None, width: int = 0, height: int = 0, custom_node_filter_callback: Callable[[Node], bool] | None = None) -> Tuple[str, ...]\",\n \"selectColor\": \"(initial_color: Color | None = NOne, options: dict[str, Any] | None = None) -> Optional[Color]\",\n \"selectParm\": \"(category: NodeTypeCategory = ..., bound_parms_only: bool = False, relative_to_node: OpNode | None = None, message: str | None = None, title: str | None = None, initial_parms: Sequence[Parm] = ..., multiple_select: bool = True, width: int = 0, height: int = 0) -> Tuple[str, ...]\",\n \"selectParmTuple\": \"(category: NodeTypeCategory = ..., bound_parms_only: bool = False, relative_to_node: OpNode | None = None, message: str | None = None, title: str | None = None, initial_parm_tuples: Sequence[ParmTuple] = ..., multiple_select: bool = True, width: int = 0, height: int = 0) -> Tuple[str, ...]\",\n \"selectionCallbacks\": \"() -> Tuple[Callable[[Sequence[NetworkMovableItem]], None], ...]\",\n \"setStatusMessage\": \"(message: str, severity: EnumValue = ...) -> None\",\n \"viewerHandleInfo\": \"(handle_names: Sequence[str] = ...) -> str\",\n \"viewerStateInfo\": \"(state_names: Sequence[str] = ...) -> str\",\n \"waitUntil\": \"(callback: Callable[[], bool]) -> None\",\n },\n \"viewportVisualizers\": {\n \"addEventCallback\": \"(self, event_types: EnumValue, callback: Callable, category: EnumValue = ..., node: Node | None = None) -> None\",\n \"createVisualizer\": \"(type: EnumValue, category: EnumValue = viewportVisualizerCategory.Common, node: Node | None = None) -> ViewportVisualizer\",\n \"eventCallbacks\": \"(category: EnumValue=..., node: Node | None=None) -> Sequence[Tuple[Sequence[EnumValue], Callable]]\",\n \"removeAllEventCallbacks\": \"(self, category: EnumValue = ..., node: Node | None = None) -> None\",\n \"removeEventCallback\": \"(self, event_types: Sequence[EnumValue], callback: Callable, category: EnumValue = ..., node: Node | None = None) -> None\",\n \"visualizers\": \"(category: EnumValue = ..., node: Node | None = None) -> Tuple[ViewportVisualizer, ...]\",\n },\n}\n" }, { "path": "houdini/moon.yml", "content": "dependsOn:\n - 'common'\ntags: ['stubs']\ntype: 'library'\n" }, { "path": "houdini/pyproject.toml", "content": "[project]\nname = \"types-houdini\"\nversion = \"21.0.512.3\"\n\nreadme = \"README.md\"\nauthors = [{name=\"Chad Dombrova\"}, {name=\"Ben Andersen\"}]\ndescription = \"Unofficial python stubs for SideFX Houdini\"\nlicense = \"MIT\"\n\nclassifiers = [\n \"Development Status :: 4 - Beta\",\n \"Programming Language :: Python :: 2\",\n \"Programming Language :: Python :: 3\",\n \"License :: OSI Approved :: MIT License\",\n \"Operating System :: OS Independent\",\n \"Intended Audience :: Developers\",\n \"Typing :: Stubs Only\",\n]\nrepository = \"https://github.com/LumaPictures/cg-stubs\"\nhomepage = \"https://github.com/LumaPictures/cg-stubs\"\n\nkeywords = [\"3d\", \"graphics\", \"games\", \"VFX\", \"CG\", \"animation\"]\n\n[dependency-groups]\ndev = [\n \"stubgenlib\",\n \"mypy\",\n]\n\n[tool.uv.sources]\nstubgenlib = { path = \"../common\" }\n# We need to pull mypy from source to avoid using compiled symbols, which prevents\n# subclassing certain symbols, such as ASTStubGenerator. If a compiled\n# ASTStubGenerator, the monkeypatch in stubgen_houdini.py will not apply and there\n# will be no warning provided.\n# NOTE: The version here must be maintained separately from the version stipulated in\n# stubgenlib, since the tag here is not compared against the version requirements.\nmypy = { git = \"https://github.com/python/mypy\", tag=\"v1.16.1\" }\n\n[build-system]\nrequires = [\"hatchling\"]\nbuild-backend = \"hatchling.build\"\n\n[tool.hatch.build.targets.wheel]\npackages = [\"stubs/hou-stubs\"]\n\n[tool.hatch.build]\n# uv+hatch does not write anything to the installed .pth file if the contents\n# of the package do no include .py files. Adding this ensures the .pth file\n# is written correctly\ndev-mode-dirs = [\"stubs\"]\n\n\n[tool.mypy]\nfollow_imports = \"skip\"\ncheck_untyped_defs = true\nfiles = [\n \"stubgen_houdini.py\",\n]\n" }, { "path": "houdini/stubgen_houdini.py", "content": "from __future__ import absolute_import, annotations, division, print_function\n\nimport ast\nimport re\nimport sys\nimport textwrap\nfrom functools import lru_cache\n\nimport mypy.stubdoc\nimport mypy.stubgen\nimport mypy.stubgenc\nfrom mypy.stubgenc import FunctionContext, FunctionSig, SignatureGenerator\n\nfrom hou_cleanup_config import (\n ADDITIONAL_ENUM_NAMES,\n EXPLICIT_DEFINITIONS,\n EXPLICIT_RETURN_TYPES,\n MISSING_CLASSES,\n MISSING_DEFINITIONS,\n NON_OPTIONAL_RETURN_FUNCTIONS,\n NON_OPTIONAL_RETURN_TYPES,\n TYPE_ALIASES,\n)\nfrom stubgenlib.cpptypeconvert import CppTypeConverter\nfrom stubgenlib.siggen import (\n AdvancedSigMatcher,\n AdvancedSignatureGenerator,\n DefaultSigGenerator,\n SignatureFixer,\n)\n\ntupleTypeRegex = re.compile(\"^_([a-zA-Z0-9]+)Tuple$\")\ntupleGenTypeRegex = re.compile(\"^_([a-zA-Z0-9]+)TupleGenerator$\")\n\n\nclass IsResult:\n \"\"\"Indicates whether an annotating type is an argument or a return.\n\n This is used to modify how permissive arguments may be, since we generally want arguments\n to be abstract and returns to be concrete.\n \"\"\"\n\n is_set: bool = False\n\n\ndef is_std(node: ast.AST, attr: str) -> bool:\n if (\n isinstance(node, ast.Attribute)\n and isinstance(node.value, ast.Name)\n and node.value.id == \"std\"\n and node.attr == attr\n ):\n return True\n return False\n\n\nclass AnnotationFixer(ast.NodeTransformer):\n \"\"\"\n This class is used for advance transformations to type annotations.\n\n For example those that require unwrapping a generic, or altering lists.\n \"\"\"\n\n def transform(self, type_str: str) -> str:\n \"\"\"Entry point to transform a type string\"\"\"\n node = ast.parse(type_str)\n # print(ast.dump(node, indent=4))\n new_node = self.visit(node)\n return ast.unparse(new_node)\n\n def visit_Tuple(self, node: ast.Tuple) -> ast.AST:\n elts = []\n for child in node.elts:\n if isinstance(child, ast.Subscript) and (\n is_std(child.value, \"allocator\") or is_std(child.value, \"less\")\n ):\n continue\n else:\n elts.append(child)\n if len(elts) != node.elts:\n if len(elts) == 1:\n return self.visit(elts[0])\n else:\n node = ast.Tuple(elts, ast.Load())\n return self.generic_visit(node)\n\n def visit_Subscript(self, node: ast.Subscript) -> ast.AST:\n if isinstance(node.value, ast.Name) and node.value.id in (\n \"ElemPtr\",\n \"UT_SharedPtr\",\n ):\n # convert: ElemPtr[Foo] --> Foo\n return node.slice\n\n new_node = self.generic_visit(node)\n if isinstance(new_node, ast.Subscript) and is_std(new_node.value, \"vector\"):\n if IsResult.is_set:\n # NOTE: we use Tuple instead of tuple because Parm.tuple() method interferes\n # with the tuple type from parsing properly.\n return ast.Subscript(\n value=ast.Name(id=\"Tuple\", ctx=ast.Load()),\n slice=ast.Tuple(\n elts=[new_node.slice, ast.Constant(value=Ellipsis)],\n ctx=ast.Load(),\n ),\n ctx=ast.Load(),\n )\n else:\n return ast.Subscript(\n value=ast.Name(id=\"Sequence\", ctx=ast.Load()),\n slice=new_node.slice,\n ctx=ast.Load(),\n )\n return new_node\n\n\nclass HoudiniCppTypeConverter(CppTypeConverter):\n TUPLE_TYPES = {\n \"_StringTuple\": \"str\",\n \"_StringTupleTuple\": \"Sequence[str]\",\n \"_IntTuple\": \"int\",\n \"_IntTupleTuple\": \"Sequence[int]\",\n \"_Int64Tuple\": \"int\",\n \"_BoolTuple\": \"bool\",\n \"_FloatTuple\": \"float\",\n \"_FloatTupleTuple\": \"Sequence[float]\",\n \"_DoubleTuple\": \"float\",\n \"_DoubleTupleTuple\": \"Sequence[float]\",\n \"_PointTupleTuple\": \"Sequence[Point]\",\n \"_IKTargetTuple\": \"_ik_Target\",\n \"_EnumTuple\": \"EnumValue\",\n }\n\n TYPE_MAP = [\n (r\"\\bHOM_PtrOrNull\\b\", \"Optional\"),\n (r\"\\bHOM_OptionalDouble\\b\", \"Optional[float]\"),\n (r\"\\bHOM_OptionalInt\\b\", \"Optional[int]\"),\n (r\"\\bHOM_BinaryString\\b\", \"bytes\"),\n # HOM classes that have underscores\n (r\"\\bHOM_logging_LogEntry\\b\", \"_logging_LogEntry\"),\n (r\"\\bHOM_logging_MemorySink\\b\", \"_logging_MemorySink\"),\n (r\"\\bHOM_ik_Joint\\b\", \"_ik_Joint\"),\n (r\"\\bHOM_ik_Skeleton\\b\", \"_ik_Skeleton\"),\n (r\"\\bHOM_ik_Target\\b\", \"_ik_Target\"),\n (r\"\\bHOM_clone_Connection\\b\", \"_clone_Connection\"),\n (r\"\\bHOM_logging_FileSink\\b\", '\"_logging_FileSink\"'),\n # other\n (r\"\\bHOM_IterableList\\b\", \"Iterator\"),\n (r\"\\bHOM_NodeBundle\\b\", \"Bundle\"),\n (r\"\\bInterpreterObject\\b\", \"Any\"),\n (r\"\\bhboost::any\\b\", \"Any\"),\n (r\"\\bPyObject\\b\", \"Any\"),\n (r\"\\bPY_OpaqueObject\\b\", \"Any\"),\n (r\"\\bUT_Tuple\\b\", \"Tuple\"),\n (r\"\\bswig::SwigPyIterator\\b\", \"Self\"),\n (r\"\\bUT_InfoTree\\b\", \"NodeInfoTree\"),\n # NOTE: Overriding std::pair to return Tuple instead of tuple\n (r\"\\bstd::pair\\b\", \"Tuple\"),\n ] + CppTypeConverter.TYPE_MAP\n\n # Don't replace vector with list. Instead, we'll replace std.vector with\n # Tuple in AnnotationFixer\n RESULT_TYPE_MAP = []\n\n def to_python_id(self, cpp_type):\n py_type = cpp_type.replace(\"HOM_\", \"\")\n sub_type = self.TUPLE_TYPES.get(py_type)\n if sub_type is not None:\n py_type = f\"Sequence[{sub_type}]\"\n else:\n match = tupleTypeRegex.match(py_type)\n if match:\n sub_type = match.groups()[0]\n py_type = f\"Sequence[{sub_type}]\"\n return py_type\n\n @lru_cache\n def cpp_arg_to_py_type(\n self, cpp_type: str, is_result: bool, allow_optional_result: bool = True\n ) -> str:\n \"\"\"Reimplemented to provide an option to prevent pointer results from being Optional.\"\"\"\n typestr = cpp_type\n is_ptr = \"*\" in typestr\n\n typestr = self._replace_typedefs(typestr)\n\n parts = typestr.split()\n\n # remove extraneous bits\n parts = [\n re.sub(self.STRIP, \"\", x).replace(\"*\", \"\").replace(\"&\", \"\").strip()\n for x in parts\n ]\n parts = [x for x in parts if not self.should_strip_part(x)]\n typestr = \" \".join(parts)\n\n renames = dict(self.RENAMES)\n new_typestr = renames.get(typestr.replace(\" \", \"\"))\n if new_typestr is not None:\n return new_typestr\n\n for pattern, replace in self.TYPE_MAP + (\n self.RESULT_TYPE_MAP if is_ptr or is_result else self.ARG_TYPE_MAP\n ):\n typestr = re.sub(pattern, replace, typestr)\n\n # swap container syntax\n typestr = typestr.replace(\"<\", \"[\")\n typestr = typestr.replace(\">\", \"]\")\n\n # convert to python identifers\n parts = [x for x in re.split(self.IDENTIFIER, typestr) if x]\n parts = [(self.to_python_id(x) or x) for x in parts]\n\n typestr = \"\".join(parts)\n typestr = typestr.replace(\"::\", \".\")\n typestr = typestr.replace(\" \", \"\")\n typestr = typestr.replace(\",\", \", \")\n\n if is_ptr:\n typestr = self.process_ptr(typestr, is_result, allow_optional_result)\n return typestr\n\n def process_ptr(\n self, converted_type: str, is_result: bool, allow_optional_result: bool = True\n ) -> str:\n if is_result and allow_optional_result:\n converted_type_start = converted_type.split(\"[\", 1)[0]\n if converted_type_start in NON_OPTIONAL_RETURN_TYPES:\n # Houdini functions that return iterators or tuples are not \"or None\".\n # WARNING: This is often the result of having a std.vector of pointer types,\n # but since `is_ptr = \"*\" in typestr` this is triggered for the outer type.\n # Luckily, we do not ever have Optional pointers to the inner type, but\n # ideally the is_ptr code would only be True if the container is also a pointer.\n return converted_type\n return f\"Optional[{converted_type}]\"\n else:\n return converted_type\n\n\nclass HoudiniTypeFixer(SignatureFixer):\n converter = HoudiniCppTypeConverter()\n transfomer = AnnotationFixer()\n\n def maybe_add_optional(self, type_name: str, default_value: str | None) -> str:\n if default_value == \"None\" and not (\n type_name.startswith(\"Optional[\")\n or type_name.startswith(\"typing.Optional[\")\n ):\n return f\"Optional[{type_name}]\"\n else:\n return type_name\n\n def cleanup_type(\n self,\n type_name: str,\n ctx: FunctionContext,\n is_result: bool,\n default_value: str | None = None,\n ) -> str:\n if type_name.startswith(\"'\") and type_name.endswith(\"'\"):\n type_name = type_name[1:-1]\n\n class_name = ctx.class_info.name if ctx.class_info else None\n if is_result:\n explicit_return_type = EXPLICIT_RETURN_TYPES.get(class_name, {}).get(\n ctx.name\n )\n if explicit_return_type:\n return explicit_return_type\n\n allow_optional_result = ctx.name not in NON_OPTIONAL_RETURN_FUNCTIONS.get(\n class_name, {}\n )\n\n new_type = self.converter.cpp_arg_to_py_type(\n type_name, is_result, allow_optional_result\n )\n\n # We need to indicate to the transformer whether we expect an argument (abstract) or\n # return (concrete) type for sequences, so set IsResult.is_set appropriately.\n # Since the transformer has a lot of indirect calls, setting this global scope override\n # allows us to change this behavior without redefining the whole transformer class.\n IsResult.is_set = is_result\n new_type = self.transfomer.transform(new_type)\n IsResult.is_set = False\n\n new_type = self.maybe_add_optional(new_type, default_value)\n\n return new_type\n\n\ndef get_signature_overrides() -> dict[str, str]:\n overrides = {}\n\n for cls, functions in EXPLICIT_DEFINITIONS.items():\n for function_name, function_spec in functions.items():\n if cls == \"__hou__\":\n # Modules at the root hou level\n key = f\"hou.{function_name}\"\n elif cls is not None:\n # Specific class overrides\n key = f\"*.{cls}.{function_name}\"\n else:\n # Overrides that should apply to all classes\n key = f\"*.{function_name}\"\n overrides[key] = function_spec\n\n return overrides\n\n\nclass HoudiniSignatureGenerator(AdvancedSignatureGenerator):\n sig_matcher = AdvancedSigMatcher(signature_overrides=get_signature_overrides())\n\n\nclass ASTStubGenerator(mypy.stubgen.ASTStubGenerator):\n def visit_class_def(self, o) -> None:\n # filter _*Tuple classes, they are not used (See to_python_id).\n if (\n o.name in (\"SwigPyIterator\", \"_AgentDefnMap\")\n or tupleTypeRegex.match(o.name)\n or tupleGenTypeRegex.match(o.name)\n ):\n return\n\n return super().visit_class_def(o)\n\n def get_sig_generators(self) -> list[SignatureGenerator]:\n return [\n HoudiniSignatureGenerator(\n fallback_sig_gen=HoudiniTypeFixer(\n DefaultSigGenerator(), default_sig_handling=\"ignore\"\n )\n )\n ]\n\n def get_signatures(\n self,\n default_signature: FunctionSig,\n sig_generators: list[SignatureGenerator],\n func_ctx: FunctionContext,\n ) -> list[FunctionSig]:\n if (\n func_ctx.class_info\n and func_ctx.class_info.name[0].islower()\n and not func_ctx.name.startswith(\"__\")\n ):\n self._decorators.append(\"@staticmethod\")\n if default_signature.args[0].name == \"self\":\n default_signature.args.pop(0)\n return super().get_signatures(default_signature, sig_generators, func_ctx)\n\n def get_imports(self) -> str:\n import hou # type: ignore[import]\n\n # FIXME: Where do we want to pull Qt from?\n # Houdini ships with PySide2 or PySide6 depending on the version.\n # We could also use `Qt`, but that doesn't ship with Houdini.\n # Is this the best way to get the PySide version?\n try:\n import PySide6 # type: ignore[import]\n except ImportError:\n pyside = \"PySide2\"\n else:\n pyside = \"PySide6\"\n\n # The import block goes at the top, so this is where we can add module level notes.\n imports = f\"# Houdini stubs generated from Houdini {hou.applicationVersionString()}\\n\\n\"\n\n imports += super().get_imports() + \"\\n\"\n imports += \"import datetime\\n\"\n imports += \"import typing\\n\"\n imports += \"from pathlib import Path\\n\"\n imports += \"from types import TracebackType\\n\"\n imports += (\n \"from typing import Any, Callable, Dict, Iterator, Iterable, Mapping, \"\n \"Literal, Optional, Sequence, Self, Union, Tuple, TypeAlias\\n\\n\"\n )\n imports += \"import pxr.Sdf\\n\"\n imports += \"import pxr.Usd\\n\"\n imports += f\"from {pyside} import QtCore, QtGui, QtWidgets\\n\\n\"\n\n for type_alias_name, type_alias in TYPE_ALIASES.items():\n imports += f\"{type_alias_name}: TypeAlias = {type_alias}\\n\"\n\n imports += \"\\n\"\n\n return imports\n\n @staticmethod\n def get_enums_from_docstring(docstring: str | None) -> set[str]:\n \"\"\"Determine the enumeration values from the docstring, by looking at the names\n indented underneath the 'VALUES' section.\"\"\"\n\n if not docstring or \"VALUES\" not in docstring:\n return set()\n\n # If 'VALUES' is in the docstring, we will parse it for enumeration values names.\n # header_indent is the indentation level we find \"VALUES\", and names_indent is where\n # we find the individual enum names.\n header_indent = -1\n names_indent = -1\n reading_values = False\n enum_names = set()\n for line in textwrap.dedent(docstring).split(\"\\n\"):\n indent_match = re.match(r\"(?P[ \\t]*)[\\w_]\", line)\n if not indent_match:\n continue\n indent = len(indent_match.group(\"indentsize\"))\n if indent == header_indent:\n # We have unindented after reading the VALUES block.\n reading_values = False\n break\n if line.strip() == \"VALUES\":\n # Once we encounter VALUES, record the indentation of\n # where we see it, so we know when we have exited.\n header_indent = indent\n reading_values = True\n continue\n\n if reading_values and names_indent == -1:\n # We have entered into the VALUES block.\n names_indent = indent\n\n if indent == names_indent:\n # We check that the indent matches where we expect to\n # find enum values to avoid reading in the description\n # of an enum value, which will be further indented.\n\n # Some names are fully qualified (e.g. hou.glShadingType.WireBoundingBox)\n # and others will just be the end, and we only want the member name.\n enum_name = line.rsplit(\".\", 1)[-1].strip()\n enum_names.add(enum_name)\n\n return enum_names\n\n def dedent(self) -> None:\n \"\"\"When we exit the class, add any missing methods or enums we have flagged above.\n\n We override tlhis method to inject missing methods as we exit the class, because\n it is the only method on the generator called while the class context still exists.\n \"\"\"\n if self._current_class:\n class_name = self._current_class.name\n missing_definitions = MISSING_DEFINITIONS.get(class_name)\n if missing_definitions:\n self.add(\n textwrap.indent(\n \"\\n# Missing methods added by stubgen\\n\", self._indent\n )\n )\n for missing_definition in missing_definitions:\n self.add(\n textwrap.indent(f\"{missing_definition}: ...\\n\", self._indent)\n )\n\n enum_names = self.get_enums_from_docstring(self._current_class.docstring)\n enum_names.update(ADDITIONAL_ENUM_NAMES.get(class_name, {}))\n if enum_names:\n # self.add(textwrap.indent(\"\\n# Missing enums added by stubgen\\n\", self._indent))\n for enum_name in sorted(enum_names):\n self.add(\n textwrap.indent(f\"{enum_name}: EnumValue = ...\\n\", self._indent)\n )\n\n missing_nested_classes = MISSING_CLASSES.get(class_name)\n if missing_nested_classes:\n self.add(\n textwrap.indent(\n \"\\n# Missing classes added by stubgen\\n\", self._indent\n )\n )\n for (\n missing_class,\n missing_definitions,\n ) in missing_nested_classes.items():\n self.add(\n textwrap.indent(f\"\\nclass {missing_class}:\\n\", self._indent)\n )\n method_indent = self._indent + \" \" * 4\n self.add(\n textwrap.indent(\n f'\"\"\"Class added by stubgen\"\"\"\\n', method_indent\n )\n )\n for missing_definition in missing_definitions:\n tail = \": ...\" if \"->\" in missing_definition else \"\"\n self.add(\n textwrap.indent(\n f\"{missing_definition}{tail}\\n\", method_indent\n )\n )\n super().dedent()\n\n def output(self) -> str:\n \"\"\"Add module level missing imports to the end of the stub file.\"\"\"\n\n root_missing_definitions = MISSING_DEFINITIONS.get(None)\n if root_missing_definitions:\n self.add(\n textwrap.indent(\n \"\\n# Missing functions added by stubgen\\n\", self._indent\n )\n )\n for missing_definition in root_missing_definitions:\n self.add(textwrap.indent(f\"{missing_definition}: ...\\n\", self._indent))\n\n root_missing_classes = MISSING_CLASSES.get(None)\n if root_missing_classes:\n self.add(\n textwrap.indent(\"\\n# Missing classes added by stubgen\\n\", self._indent)\n )\n for missing_class, missing_definitions in root_missing_classes.items():\n self.add(textwrap.indent(f\"\\nclass {missing_class}:\\n\", self._indent))\n method_indent = self._indent + \" \" * 4\n self.add(\n textwrap.indent(f'\"\"\"Class added by stubgen\"\"\"\\n', method_indent)\n )\n for missing_definition in missing_definitions:\n tail = \": ...\" if \"->\" in missing_definition else \"\"\n self.add(\n textwrap.indent(f\"{missing_definition}{tail}\\n\", method_indent)\n )\n\n return super().output()\n\n\nmypy.stubgen.ASTStubGenerator = ASTStubGenerator # type: ignore[attr-defined,misc]\n# mypy.stubgenc.InspectionStubGenerator = InspectionStubGenerator # type: ignore[misc]\n\n\ndef enableHouModule():\n \"\"\"Set up the environment so that \"import hou\" works.\"\"\"\n import os\n import sys\n\n # Importing hou will load Houdini's libraries and initialize Houdini.\n # This will cause Houdini to load any HDK extensions written in C++.\n # These extensions need to link against Houdini's libraries,\n # so the symbols from Houdini's libraries must be visible to other\n # libraries that Houdini loads. To make the symbols visible, we add the\n # RTLD_GLOBAL dlopen flag.\n if hasattr(sys, \"setdlopenflags\"):\n old_dlopen_flags = sys.getdlopenflags()\n sys.setdlopenflags(old_dlopen_flags | os.RTLD_GLOBAL)\n\n # For Windows only.\n # Add %HFS%/bin to the DLL search path so that Python can locate\n # the hou module's Houdini library dependencies. Note that\n # os.add_dll_directory() does not exist in older Python versions.\n # Python 3.7 users are expected to add %HFS%/bin to the PATH environment\n # variable instead prior to launching Python.\n if sys.platform == \"win32\" and hasattr(os, \"add_dll_directory\"):\n os.add_dll_directory(\"{}/bin\".format(os.environ[\"HFS\"]))\n\n try:\n pass\n finally:\n # Reset dlopen flags back to their original value.\n if hasattr(sys, \"setdlopenflags\"):\n sys.setdlopenflags(old_dlopen_flags)\n\n\nenableHouModule()\n\n\ndef main(outdir: str):\n mypy.stubgen.main(\n [\"-m=hou\", \"--verbose\", \"--parse-only\", \"--include-docstrings\", \"-o=stubs\"]\n )\n\n # print(AnnotationFixer().transform('Tuple[str, ...]'))\n # print(AnnotationFixer().transform('std.vector[str]'))\n\n\nif __name__ == \"__main__\":\n main(sys.argv[0])\n" }, { "path": "houdini/stubgen_houdini.sh.bak", "content": "#!/bin/bash\n\nset -e\n\nHOU_LIBS=$REZ_HOUDINI_ROOT/python3.11libs\nexport UV_PYTHON=/opt/local_packages/houdini/20.5.487/platform-linux/bin/hython\nexport DYLD_INSERT_LIBRARIES=/Applications/Houdini/Houdini20.5.332/Frameworks/Houdini.framework/Versions/Current/Houdini\nexport PYTHONPATH=$HOU_LIBS\n\necho \"launching\"\n\nuv run ./stubgen_houdini.py || true\n" }, { "path": "houdini/stubs/hou-stubs/__init__.pyi", "content": "# Houdini stubs generated from Houdini 21.0.512\n\nfrom houcppportion import * # type: ignore[import-not-found]\nfrom _typeshed import Incomplete\n\nimport datetime\nimport typing\nfrom pathlib import Path\nfrom types import TracebackType\nfrom typing import Any, Callable, Dict, Iterator, Iterable, Mapping, Literal, Optional, Sequence, Self, Union, Tuple, TypeAlias\n\nimport pxr.Sdf # type: ignore[import-not-found]\nimport pxr.Usd # type: ignore[import-not-found]\nfrom PySide6 import QtCore, QtGui, QtWidgets # type: ignore[import-not-found]\n\nAttribBasicType: TypeAlias = int | float | str\nAttribArgType: TypeAlias = int | float | str | Sequence[int] | Sequence[float] | Sequence[str]\nAttribDictArgType: TypeAlias = dict[str, int] | dict[str, float] | dict[str, str] | dict[str, Sequence[int]] | dict[str, Sequence[float]] | dict[str, Sequence[str]]\nAttribReturnType: TypeAlias = int | float | str | Tuple[int, ...] | Tuple[float, ...] | Tuple[str, ...]\nAttribDictReturnType: TypeAlias = dict[str, int] | dict[str, float] | dict[str, str] | dict[str, Tuple[int, ...]] | dict[str, Tuple[float, ...]] | dict[str, Tuple[str, ...]]\nParmArgType: TypeAlias = bool | int | float | str | dict[str, str] | 'Ramp' | 'Geometry' | 'Parm'\nParmReturnType: TypeAlias = bool | int | float | str | dict[str, str] | 'Ramp' | 'Geometry' | 'OpNode'\nParmTupleArgType: TypeAlias = Sequence[bool] | Sequence[int] | Sequence[float] | Sequence[str] | Sequence[dict[str, str]] | Sequence['Ramp'] | Sequence['Geometry'] | Sequence['Parm']\nParmTupleReturnType: TypeAlias = Tuple[bool, ...] | Tuple[int, ...] | Tuple[float, ...] | Tuple[str, ...] | Tuple[dict[str, str], ...] | Tuple['Ramp', ...] | Tuple['Geometry', ...] | Tuple['OpNode', ...]\nOptionType: TypeAlias = bool | int | float | str | Vector2 | Vector3 | Vector4 | Quaternion | Matrix3 | Matrix4\nOptionSequenceType: TypeAlias = Sequence[bool] | Sequence[int] | Sequence[float] | Sequence[str] | Sequence[Vector2] | Sequence[Vector3] | Sequence[Vector4] | Sequence[Quaternion] | Sequence[Matrix3] | Sequence[Matrix4]\nOptionMultiArgType: TypeAlias = bool | int | float | str | Vector2 | Vector3 | Vector4 | Quaternion | Matrix3 | Matrix4 | Sequence[int] | Sequence[float]\nOptionMultiReturnType: TypeAlias = bool | int | float | str | Vector2 | Vector3 | Vector4 | Quaternion | Matrix3 | Matrix4 | Tuple[int, ...] | Tuple[float, ...]\n\n\nclass _SwigNonDynamicMeta(type):\n \"\"\"Meta class to enforce nondynamic attributes (no new attributes) for a class\"\"\"\n __setattr__: Incomplete\n\nclass _NodeConnectionTupleOfTuplesGenerator:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __getitem__(self, key: int) -> Any: ...\n def __len__(self) -> int: ...\n\nclass EnumValue:\n \"\"\"\n\n hou.EnumValue\n\n This class is the base class for an enumeration value. It cannot be\n instanced and is not meant to be used directly by the user.\n\n All the built-in HOM enumeration values are derived from this class such\n as hou.paneTabType.*, hou.severityType.*, and hou.connectivityType.*.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def name(self) -> str:\n \"\"\"\n\n name(self) -> string\n\n Returns the name of the enumeration value.\n\n\n \"\"\"\n def __lt__(self, other: object) -> bool: ...\n\nclass numericData:\n \"\"\"\n\n hou.numericData\n\n Enumeration of numeric value types.\n\n VALUES\n\n\n Int8\n UInt8\n Int16\n Int32\n Int64\n Float16\n Float32\n Float64\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Float16: EnumValue = ...\n Float32: EnumValue = ...\n Float64: EnumValue = ...\n Int16: EnumValue = ...\n Int32: EnumValue = ...\n Int64: EnumValue = ...\n Int8: EnumValue = ...\n UInt8: EnumValue = ...\n\ncvar: Incomplete\n\nclass attribData:\n \"\"\"\n\n hou.attribData\n\n Enumeration of attribute data types.\n\n VALUES\n\n\n Int\n Float\n String\n Dict\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Dict: EnumValue = ...\n Float: EnumValue = ...\n Int: EnumValue = ...\n String: EnumValue = ...\n\nclass attribType:\n \"\"\"\n\n hou.attribType\n\n Enumeration of geometry attribute types.\n\n Note that global attributes are also known as detail attributes.\n\n The type of data (e.g. int, float, string) is called the attribute data\n type, can correspond to hou.attribData.\n\n See hou.Geometry.addAttrib and hou.Attrib for more information.\n\n VALUES\n\n\n Point\n Prim\n Vertex\n Global\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Global: EnumValue = ...\n Point: EnumValue = ...\n Prim: EnumValue = ...\n Vertex: EnumValue = ...\n\nclass attribScope:\n \"\"\"\n\n hou.attribScope\n\n Enumeration of geometry attribute scope.\n\n The scope of attribute data. All visible attributes have a public scope.\n Private attributes are hidden from the node info window and the geometry\n spreadsheet. Private attributes are often not transferred when geometry\n is copied or merged.\n\n VALUES\n\n\n Public\n Private\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Private: EnumValue = ...\n Public: EnumValue = ...\n\nclass groupScope:\n \"\"\"\n\n hou.groupScope\n\n Enumeration of geometry group scope.\n\n The scope of group data. All visible groups have a public scope. Private\n groups are hidden from the node info window and the geometry\n spreadsheet. Private groups are not transferred when geometry is copied\n or merged.\n\n VALUES\n\n\n Public\n Private\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Private: EnumValue = ...\n Public: EnumValue = ...\n\nclass primType:\n \"\"\"\n\n hou.primType\n\n Enumeration of primitive types.\n\n VALUES\n\n\n Agent\n AlembicRef\n BezierCurve\n BezierSurface\n Circle\n ChannelPrim\n Custom\n Catch-all for all HDK-defined primitives types.\n\n Hexahedron\n Eight points that deform a cubic volume.\n\n Mesh\n Metaball\n NURBSCurve\n NURBSSurface\n PackedFragment\n PackedGeometry\n PackedPrim\n ParticleSystem\n Obsolete type that represented particles, unconnected points are\n currently used for particles.\n\n PastedSurface\n Obsolete type to support NURBS that lie in the domain of other\n NURBS.\n\n Polygon\n PolySoup\n Sphere\n Tetrahedron\n Four points that define a pyramidal volume.\n\n TriangleBezier\n TriangleFan\n Defines a triangle between the first point and each consecutive\n pair of points.\n\n TriangleStrip\n Defines a triangle between each consecutive triple of points.\n\n Tube\n Unknown\n VDB\n Volume\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Agent: EnumValue = ...\n AlembicRef: EnumValue = ...\n BezierCurve: EnumValue = ...\n BezierSurface: EnumValue = ...\n ChannelPrim: EnumValue = ...\n Circle: EnumValue = ...\n Custom: EnumValue = ...\n Hexahedron: EnumValue = ...\n Mesh: EnumValue = ...\n Metaball: EnumValue = ...\n NURBSCurve: EnumValue = ...\n NURBSSurface: EnumValue = ...\n PackedFragment: EnumValue = ...\n PackedGeometry: EnumValue = ...\n PackedPrim: EnumValue = ...\n ParticleSystem: EnumValue = ...\n PastedSurface: EnumValue = ...\n PolySoup: EnumValue = ...\n Polygon: EnumValue = ...\n Sphere: EnumValue = ...\n Tetrahedron: EnumValue = ...\n TriangleBezier: EnumValue = ...\n TriangleFan: EnumValue = ...\n TriangleStrip: EnumValue = ...\n Tube: EnumValue = ...\n Unknown: EnumValue = ...\n VDB: EnumValue = ...\n Volume: EnumValue = ...\n\nclass parmData:\n \"\"\"\n\n hou.parmData\n\n Enumeration of parameter data types.\n\n VALUES\n\n\n Int\n Float\n String\n Ramp\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Float: EnumValue = ...\n Int: EnumValue = ...\n Ramp: EnumValue = ...\n String: EnumValue = ...\n\nclass parmTemplateType:\n \"\"\"\n\n hou.parmTemplateType\n\n Enumeration of parameter template types.\n\n VALUES\n\n\n Int\n Float\n String\n Toggle\n Menu\n Button\n FolderSet\n Folder\n Separator\n Label\n Ramp\n Data\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Button: EnumValue = ...\n Data: EnumValue = ...\n Float: EnumValue = ...\n Folder: EnumValue = ...\n FolderSet: EnumValue = ...\n Int: EnumValue = ...\n Label: EnumValue = ...\n Menu: EnumValue = ...\n Ramp: EnumValue = ...\n Separator: EnumValue = ...\n String: EnumValue = ...\n Toggle: EnumValue = ...\n\nclass parmLook:\n \"\"\"\n\n hou.parmLook\n\n Enumeration of available looks for a parameter\n\n These looks are used by hou.ParmTemplate objects and control the user\n interface of the parameter in parameter editors.\n\n VALUES\n\n\n Regular\n The default parameter look.\n\n Logarithmic\n The parameter displays a slider that changes the value on a\n logarithmic scale.\n\n Angle\n The parameter has an arc control to enter an angle.\n\n If you use this look, set your parameter's naming scheme to\n hou.parmNamingScheme.Base1.\n\n Vector\n The parameter has a handle beside the label to edit the vector\n direction.\n\n If you use this look, set your parameter's naming scheme to\n hou.parmNamingScheme.XYZW.\n\n ColorSquare\n The parameter has a square button beside the label to display\n the current color. You can click on the square to edit the\n color.\n\n If you use this look, set your parameter's naming scheme to\n hou.parmNamingScheme.RGBA.\n\n HueCircle\n The parameter has a hue circle with a pie-shaped region, like\n the keying nodes in COPs have.\n\n CRGBAPlaneChooser\n The parameter has an RGBA mask, with buttons to toggle the red,\n green, blue, and alpha planes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Angle: EnumValue = ...\n CRGBAPlaneChooser: EnumValue = ...\n ColorSquare: EnumValue = ...\n HueCircle: EnumValue = ...\n Logarithmic: EnumValue = ...\n Regular: EnumValue = ...\n Vector: EnumValue = ...\n\nclass parmNamingScheme:\n '''\n\n hou.parmNamingScheme\n\n Enumeration of available naming schemes for a parameter.\n\n These naming schemes are stored inside hou.ParmTemplate objects and\n determine the names of hou.Parm objects inside hou.ParmTuple objects.\n\n The number of components in the parm template determines the number of\n parms inside the parm tuple. If this number is 1, the parm name is the\n same as the parm tuple name. If the naming scheme is Base1, the number\n of components may be more than 4. Otherwise, the component may have from\n 2 components up to the maximum number allowed by the naming scheme.\n\n The following restrictions exist on naming schemes:\n\n * You cannot use the following naming schemes when editing the\n parameter interface on a node or a digital asset: MinMax, MaxMin,\n StartEnd, BeginEnd, XYWH. However, some built-in node types use\n parameters with these naming schemes, so asking these node types for\n their parm templates may return ones using these naming schemes.\n\n * String and toggle parameters only support the Base1 naming scheme.\n\n * Parameters with the hou.parmLook.Vector look must use the XYZW\n naming scheme.\n\n * Parameters with the hou.parmLook.Angle look must use the Base1\n naming scheme.\n\n * Parameters with the hou.parmLook.ColorSquare look must use an RGBA\n naming scheme.\n\n The example names below are for a parm template named \\\\\"foo\\\\\":\n\n VALUES\n\n\n Base1\n \\\\\"foo1\\\\\", \\\\\"foo2\\\\\", \\\\\"foo3\\\\\", ...\n\n XYZW\n \\\\\"foox\\\\\", \\\\\"fooy\\\\\", \\\\\"fooz\\\\\", \\\\\"foow\\\\\"\n\n XYWH\n \\\\\"foox\\\\\", \\\\\"fooy\\\\\", \\\\\"foow\\\\\", \\\\\"fooh\\\\\"\n\n UVW\n \\\\\"foou\\\\\", \\\\\"foov\\\\\", \\\\\"foow\\\\\"\n\n RGBA\n \\\\\"foor\\\\\", \\\\\"foog\\\\\", \\\\\"foob\\\\\", \\\\\"fooa\\\\\"\n\n MinMax\n \\\\\"foomin\\\\\", \\\\\"foomax\\\\\"\n\n MaxMin\n \\\\\"foomax\\\\\", \\\\\"foomin\\\\\"\n\n StartEnd\n \\\\\"foostart\\\\\", \\\\\"fooend\\\\\"\n\n BeginEnd\n \\\\\"foobegin\\\\\", \\\\\"fooend\\\\\"\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Base1: EnumValue = ...\n BeginEnd: EnumValue = ...\n MaxMin: EnumValue = ...\n MinMax: EnumValue = ...\n RGBA: EnumValue = ...\n StartEnd: EnumValue = ...\n UVW: EnumValue = ...\n XYWH: EnumValue = ...\n XYZW: EnumValue = ...\n\nclass parmCondType:\n \"\"\"\n\n hou.parmCondType\n\n Enumeration of available parameter conditional types.\n\n VALUES\n\n\n DisableWhen\n HideWhen\n NoCookWhen\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n DisableWhen: EnumValue = ...\n HideWhen: EnumValue = ...\n NoCookWhen: EnumValue = ...\n\nclass parmExtrapolate:\n \"\"\"\n\n hou.parmExtrapolate\n\n Enumeration of Extrapolation methods when evaluating value outside the\n keyframe range.\n\n VALUES\n\n\n Default\n Hold\n Cycle\n Extend\n Slope\n CycleOffset\n Oscillate\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Cycle: EnumValue = ...\n CycleOffset: EnumValue = ...\n Default: EnumValue = ...\n Extend: EnumValue = ...\n Hold: EnumValue = ...\n Oscillate: EnumValue = ...\n Slope: EnumValue = ...\n\nclass parmBakeChop:\n \"\"\"\n\n hou.parmBakeChop\n\n Enumeration of Bake Chop modes.\n\n See hou.Parm.keyframesRefit.\n\n VALUES\n\n\n Off\n KeepExportFlag\n DisableExportFlag\n CreateDeleteChop\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CreateDeleteChop: EnumValue = ...\n DisableExportFlag: EnumValue = ...\n KeepExportFlag: EnumValue = ...\n Off: EnumValue = ...\n\nclass segmentType:\n \"\"\"\n\n hou.segmentType\n\n Enumeration of values for segment types used by channel primitives.\n\n VALUES\n\n\n Bezier\n Constant\n Linear\n Cubic\n Ease\n EaseIn\n EaseOut\n Quintic\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Bezier: EnumValue = ...\n Constant: EnumValue = ...\n Cubic: EnumValue = ...\n Ease: EnumValue = ...\n EaseIn: EnumValue = ...\n EaseOut: EnumValue = ...\n Linear: EnumValue = ...\n Quintic: EnumValue = ...\n\nclass animBarToolSize:\n \"\"\"\n\n hou.animBarToolSize\n\n Enumeration of values for the size options for Animation Toolbar tools.\n\n VALUES\n\n\n Compact\n Standard\n Wide\n ExtraWide\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Compact: EnumValue = ...\n ExtraWide: EnumValue = ...\n Standard: EnumValue = ...\n Wide: EnumValue = ...\n\nclass slopeMode:\n \"\"\"\n\n hou.slopeMode\n\n Enumeration of values for default Slope Mode when inserting new keys\n into a channel.\n\n VALUES\n\n\n Manual\n Automatic\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Automatic: EnumValue = ...\n Manual: EnumValue = ...\n\nclass stringParmType:\n \"\"\"\n\n hou.stringParmType\n\n Enumeration of string parameter types.\n\n A hou.StringParmTemplate is set to one of these types to specify whether\n a string parameter will hold an arbitrary string, a reference to a file,\n a reference to a node, or a reference to multiple nodes.\n\n VALUES\n\n\n Regular\n FileReference\n NodeReference\n NodeReferenceList\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n FileReference: EnumValue = ...\n NodeReference: EnumValue = ...\n NodeReferenceList: EnumValue = ...\n Regular: EnumValue = ...\n\nclass labelParmType:\n \"\"\"\n\n hou.labelParmType\n\n Enumeration of label parameter types.\n\n A hou.LabelParmTemplate is set to one of these types to specify whether\n a label parameter will be a plain label, a heading, or a multi-line\n message block.\n\n VALUES\n\n\n Heading\n Label\n Message\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Heading: EnumValue = ...\n Label: EnumValue = ...\n Message: EnumValue = ...\n\nclass dataParmType:\n \"\"\"\n\n hou.dataParmType\n\n Enumeration of data parameter types.\n\n A hou.DataParmTemplate is set to one of these types to specify whether a\n data parameter will hold geometry data or a key-value dictionary\n structure.\n\n VALUES\n\n\n Geometry\n KeyValueDictionary\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Geometry: EnumValue = ...\n KeyValueDictionary: EnumValue = ...\n\nclass exprLanguage:\n \"\"\"\n\n hou.exprLanguage\n\n Enumeration of available expression languages.\n\n VALUES\n\n\n Python\n Hscript\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Hscript: EnumValue = ...\n Python: EnumValue = ...\n\nclass scriptLanguage:\n \"\"\"\n\n hou.scriptLanguage\n\n Enumeration of available script languages.\n\n VALUES\n\n\n Python\n Hscript\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Hscript: EnumValue = ...\n Python: EnumValue = ...\n\nclass keyHalf:\n \"\"\"\n\n hou.keyHalf\n\n Enumeration of the halves of a key, used when setting keyframe data in a\n Channel Primitive.\n\n See hou.ChannelPrim.setKeyValue.\n\n VALUES\n\n\n In\n Used to set only the in (left) side of a key.\n\n Out\n Used to set only the out (right) side of a key.\n\n InOut\n Used to set both sides of a key.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n In: EnumValue = ...\n InOut: EnumValue = ...\n Out: EnumValue = ...\n\nclass fileType:\n \"\"\"\n\n hou.fileType\n\n Enumeration of file types.\n\n VALUES\n\n\n Any\n Image\n Geometry\n Ramp\n Capture\n Clip\n Lut\n Cmd\n Midi\n I3d\n Chan\n Sim\n SimData\n Hip\n Otl\n Dae\n Gallery\n Directory\n Icon\n Ds\n Alembic\n Psd\n LightRig\n Gltf\n Movie\n Fbx\n Usd\n Sqlite\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Alembic: EnumValue = ...\n Any: EnumValue = ...\n Capture: EnumValue = ...\n Chan: EnumValue = ...\n Clip: EnumValue = ...\n Cmd: EnumValue = ...\n Dae: EnumValue = ...\n Directory: EnumValue = ...\n Ds: EnumValue = ...\n Fbx: EnumValue = ...\n Gallery: EnumValue = ...\n Geometry: EnumValue = ...\n Gltf: EnumValue = ...\n Hip: EnumValue = ...\n I3d: EnumValue = ...\n Icon: EnumValue = ...\n Image: EnumValue = ...\n LightRig: EnumValue = ...\n Lut: EnumValue = ...\n Midi: EnumValue = ...\n Movie: EnumValue = ...\n Otl: EnumValue = ...\n Psd: EnumValue = ...\n Ramp: EnumValue = ...\n Sim: EnumValue = ...\n SimData: EnumValue = ...\n Sqlite: EnumValue = ...\n Usd: EnumValue = ...\n\nclass fileChooserMode:\n \"\"\"\n\n hou.fileChooserMode\n\n Enumeration of possible read/write modes for the file chooser.\n\n See hou.ui.selectFile.\n\n VALUES\n\n\n Read\n Write\n ReadAndWrite\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Read: EnumValue = ...\n ReadAndWrite: EnumValue = ...\n Write: EnumValue = ...\n\nclass folderType:\n \"\"\"\n\n hou.folderType\n\n Enumeration of folder types for FolderParmTemplates.\n\n See also hou.FolderParmTemplate.\n\n VALUES\n\n\n Collapsible\n A folder that expands and collapses to show and hide its\n contents respectively.\n\n Simple\n A simple folder for organizing parameters in the form of a group\n box.\n\n Tabs\n A normal folder represented by a tab.\n\n RadioButtons\n A folder with a radio button. The open folder is the selected\n radio button in the set of buttons.\n\n MultiparmBlock\n A block of multiparms. The user can add or remove instances of\n this parameter block.\n\n ScrollingMultiparmBlock\n A multiparm block inside a smaller region with scroll bars.\n\n TabbedMultiparmBlock\n A multiparm block where each instance of the parameters in the\n block appears in its own tab.\n\n ImportBlock\n A block containing parameters imported from another node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Collapsible: EnumValue = ...\n ImportBlock: EnumValue = ...\n MultiparmBlock: EnumValue = ...\n RadioButtons: EnumValue = ...\n ScrollingMultiparmBlock: EnumValue = ...\n Simple: EnumValue = ...\n TabbedMultiparmBlock: EnumValue = ...\n Tabs: EnumValue = ...\n\nclass menuType:\n \"\"\"\n\n hou.menuType\n\n Enumeration of parameter menu types.\n\n See also hou.MenuParmTemplate and hou.StringParmTemplate.\n\n VALUES\n\n\n Normal\n A standard menu that displays the currently selected menu item.\n\n Mini\n A condensed menu that only displays a dropdown arrow. Houdini\n lets you choose a menu entry when you click on this arrow.\n\n ControlNextParameter\n A standard menu that displays the currently selected menu item.\n This menu always joins horizontally to the next parameter and is\n displayed without a label. However unlike simply turning off the\n label and joining to the next parameter, the layout of the next\n parameter is such that a series of parameters preceded by menus\n of this type will align in a much more appealing way.\n\n StringReplace\n A menu that also displays an input field. Selecting an entry\n from this menu will replace the contents of the field with the\n menu item. This type of menu only has meaning for string\n parameters.\n\n StringToggle\n A menu that also displays an input field. Selecting an entry\n from this menu will add the menu item to the field if it was not\n already there, and will remove it from the field it if was. This\n type of menu only has meaning for string parameters.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ControlNextParameter: EnumValue = ...\n Mini: EnumValue = ...\n Normal: EnumValue = ...\n StringReplace: EnumValue = ...\n StringToggle: EnumValue = ...\n\nclass paneTabType:\n \"\"\"\n\n hou.paneTabType\n\n Enumeration of pane tab types.\n\n VALUES\n\n\n AssetBrowser\n ApexEditor\n BundleList\n ChannelEditor\n ChannelList\n ChannelViewer\n CompositorViewer\n ContextViewer\n DataTree\n DetailsView\n EngineSessionSync\n HandleList\n HelpBrowser\n IPRViewer\n LightLinker\n MaterialPalette\n NetworkEditor\n OutputViewer\n Parm\n ParmSpreadsheet\n PerformanceMonitor\n PythonPanel\n PythonShell\n RenderGallery\n SceneViewer\n ShaderViewer\n TakeList\n Textport\n TreeView\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ApexEditor: EnumValue = ...\n AssetBrowser: EnumValue = ...\n BundleList: EnumValue = ...\n ChannelEditor: EnumValue = ...\n ChannelList: EnumValue = ...\n ChannelViewer: EnumValue = ...\n CompositorViewer: EnumValue = ...\n ContextViewer: EnumValue = ...\n DataTree: EnumValue = ...\n DetailsView: EnumValue = ...\n EngineSessionSync: EnumValue = ...\n HandleList: EnumValue = ...\n HelpBrowser: EnumValue = ...\n IPRViewer: EnumValue = ...\n LightLinker: EnumValue = ...\n MaterialPalette: EnumValue = ...\n NetworkEditor: EnumValue = ...\n OutputViewer: EnumValue = ...\n Parm: EnumValue = ...\n ParmSpreadsheet: EnumValue = ...\n PerformanceMonitor: EnumValue = ...\n PythonPanel: EnumValue = ...\n PythonShell: EnumValue = ...\n RenderGallery: EnumValue = ...\n SceneViewer: EnumValue = ...\n ShaderViewer: EnumValue = ...\n TakeList: EnumValue = ...\n Textport: EnumValue = ...\n TreeView: EnumValue = ...\n\nclass stateViewerType:\n \"\"\"\n\n hou.stateViewerType\n\n Enumeration of state viewer types.\n\n VALUES\n\n\n Scene\n Compositor\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Compositor: EnumValue = ...\n Scene: EnumValue = ...\n\nclass paneLinkType:\n \"\"\"\n\n hou.paneLinkType\n\n Enumeration of possible pane link values.\n\n VALUES\n\n\n Pinned\n Group1\n Group2\n Group3\n Group4\n Group5\n Group6\n Group7\n Group8\n FollowSelection\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n FollowSelection: EnumValue = ...\n Group1: EnumValue = ...\n Group2: EnumValue = ...\n Group3: EnumValue = ...\n Group4: EnumValue = ...\n Group5: EnumValue = ...\n Group6: EnumValue = ...\n Group7: EnumValue = ...\n Group8: EnumValue = ...\n Pinned: EnumValue = ...\n\nclass networkItemType:\n \"\"\"\n\n hou.networkItemType\n\n \n\n \n\n VALUES\n\n\n Connection\n NetworkBox\n NetworkDot\n Node\n StickyNote\n SubnetIndirectInput\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Connection: EnumValue = ...\n NetworkBox: EnumValue = ...\n NetworkDot: EnumValue = ...\n Node: EnumValue = ...\n StickyNote: EnumValue = ...\n SubnetIndirectInput: EnumValue = ...\n\nclass colorItemType:\n \"\"\"\n\n hou.colorItemType\n\n \n\n \n\n VALUES\n\n\n NetworkBox\n StickyNote\n StickyNoteText\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NetworkBox: EnumValue = ...\n StickyNote: EnumValue = ...\n StickyNoteText: EnumValue = ...\n\nclass geometryViewportType:\n \"\"\"\n\n hou.geometryViewportType\n\n Enumeration of scene viewer viewport types.\n\n VALUES\n\n\n Perspective\n Top\n Bottom\n Front\n Back\n Right\n Left\n UV\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Back: EnumValue = ...\n Bottom: EnumValue = ...\n Front: EnumValue = ...\n Left: EnumValue = ...\n Perspective: EnumValue = ...\n Right: EnumValue = ...\n Top: EnumValue = ...\n UV: EnumValue = ...\n\nclass glShadingType:\n \"\"\"\n\n hou.glShadingType\n\n Enum for viewport shading modes\n\n VALUES\n\n\n hou.glShadingType.WireBoundingBox\n Objects displayed as wireframe bounding boxes.\n\n hou.glShadingType.ShadedBoundingBox\n Objects displayed as solid bounding boxes.\n\n hou.glShadingType.Wire\n Geometry displayed as regular wireframe.\n\n hou.glShadingType.WireGhost\n Geometry displayed as wireframe with occluded wires dimmed.\n\n hou.glShadingType.HiddenLineGhost\n Geometry displayed as wireframe with constant filled polygons.\n\n hou.glShadingType.HiddenLineInvisible\n Geometry displayed as wireframe hidden occluded wires.\n\n hou.glShadingType.MatCap\n Geometry displayed with a Material Capture texture (MatCap)\n which replaces the usual lighting and shading.\n\n hou.glShadingType.MatCapWire\n Geometry displayed with a Material Capture texture (MatCap)\n which replaces the usual lighting and shading, with outlined\n polygons.\n\n hou.glShadingType.Flat\n Geometry displayed as lit, but with flat shaded polygons.\n\n hou.glShadingType.FlatWire\n Geometry displayed as lit, but with flat shaded, outlined\n polygons.\n\n hou.glShadingType.Smooth\n Geometry displayed as shaded and lit.\n\n hou.glShadingType.SmoothWire\n Geometry displayed as shaded and lit with outlined polygons.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Flat: EnumValue = ...\n FlatWire: EnumValue = ...\n HiddenLineGhost: EnumValue = ...\n HiddenLineInvisible: EnumValue = ...\n MatCap: EnumValue = ...\n MatCapWire: EnumValue = ...\n ShadedBoundingBox: EnumValue = ...\n Smooth: EnumValue = ...\n SmoothWire: EnumValue = ...\n Wire: EnumValue = ...\n WireBoundingBox: EnumValue = ...\n WireGhost: EnumValue = ...\n\nclass viewportStereoMode:\n \"\"\"\n\n hou.viewportStereoMode\n\n Stereoscopic viewport display modes\n\n The stereoscopic viewport display modes available when viewing through a\n stereo camera rig.\n\n VALUES\n\n\n hou.viewportStereoMode.Anaglyph\n Anaglyph display of left/right as red/cyan.\n\n hou.viewportStereoMode.HorizontalInterlace\n Interlace left and right on alternating scanlines. Only useful\n for 3D monitors which support this.\n\n hou.viewportStereoMode.HorizontalInterlaceReverse\n Interlace left and right on alternating scanlines, swapping\n which scanlines are used for left and right.\n\n hou.viewportStereoMode.QuadBufferGL\n Use OpenGL quad buffer stereo, generally only available on\n professional cards.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Anaglyph: EnumValue = ...\n HorizontalInterlace: EnumValue = ...\n HorizontalInterlaceReverse: EnumValue = ...\n QuadBufferGL: EnumValue = ...\n\nclass viewportHomeClipMode:\n \"\"\"\n\n hou.viewportHomeClipMode\n\n Automatic viewport clip plane adjustment during homing\n\n Homing the viewport can adjust the viewport's near and far clip planes\n to adapt to what is being homed onto, so that geometry is fully visible\n in the viewport.\n\n VALUES\n\n\n hou.viewportHomeClipMode.Neither\n No clip planes are adjusted.\n\n hou.viewportHomeClipMode.NearOnly\n Only the near clip plane is adjusted. Far is left as is.\n\n hou.viewportHomeClipMode.FarOnly\n Only the far clip plane is adjusted. Near is left as is.\n\n hou.viewportHomeClipMode.NearAndFar\n Both clip planes are adjusted.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n FarOnly: EnumValue = ...\n NearAndFar: EnumValue = ...\n NearOnly: EnumValue = ...\n Neither: EnumValue = ...\n\nclass geometryViewportLayout:\n '''\n\n hou.geometryViewportLayout\n\n Enumeration of viewport layouts.\n\n > # Get a reference to the 3D viewer pane tab\n > desktop = hou.ui.curDesktop()\n > viewer = desktop.paneTabOfType(hou.paneTabType.SceneViewer)\n > \n > # Get the current layout\n > current_layout = viewer.viewportLayout()\n > # Change the layout to \\\\\"quad view\\\\\"\n > viewer.setViewportLayout(hou.geometryViewportLayout.)\n\n See the viewport methods on the SceneViewer object.\n\n VALUES\n\n\n DoubleSide\n\n DoubleStack\n\n Quad\n\n QuadBottomSplit\n\n QuadLeftSplit\n\n Single\n\n TripleBottomSplit\n\n TripleLeftSplit\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n DoubleSide: EnumValue = ...\n DoubleStack: EnumValue = ...\n Quad: EnumValue = ...\n QuadBottomSplit: EnumValue = ...\n QuadLeftSplit: EnumValue = ...\n Single: EnumValue = ...\n TripleBottomSplit: EnumValue = ...\n TripleLeftSplit: EnumValue = ...\n\nclass geometryViewportBackgroundImageFitMode:\n \"\"\"\n\n hou.geometryViewportBackgroundImageFitMode\n\n Enumeration of image fit modes.\n\n VALUES\n\n\n Horizontal\n Vertical\n Fill\n Scale\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Fill: EnumValue = ...\n Horizontal: EnumValue = ...\n Scale: EnumValue = ...\n Vertical: EnumValue = ...\n\nclass snappingMode:\n \"\"\"\n\n hou.snappingMode\n\n Enumeration of snapping modes.\n\n See hou.SceneViewer.snappingMode.\n\n VALUES\n\n\n Off\n Grid\n Prim\n Point\n Multi\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Grid: EnumValue = ...\n Multi: EnumValue = ...\n Off: EnumValue = ...\n Point: EnumValue = ...\n Prim: EnumValue = ...\n\nclass snapSelectionMode:\n \"\"\"\n\n hou.snapSelectionMode\n\n Filter for primitive snapping in the LOPs viewer\n\n Restricts the primitives that can be snapped to by their selection\n status. This only affects the LOP viewer.\n\n VALUES\n\n\n hou.snapSelectionMode.SnapToAll\n Snapping is not restricted by selection; all primitives can be\n snapped.\n\n hou.snapSelectionMode.SnapToSelected\n Restrict snapping to only selected primitives. This can be\n useful to picking a pivot point on a primitive.\n\n hou.snapSelectionMode.SnapToNonSelected\n Restrict snapping to only non-selected primtives. This is\n normally used when transforming a selection, to avoid self-\n snapping.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n SnapToAll: EnumValue = ...\n SnapToNonSelected: EnumValue = ...\n SnapToSelected: EnumValue = ...\n\nclass selectionMode:\n \"\"\"\n\n hou.selectionMode\n\n Enumeration of selection modes.\n\n See hou.SceneViewer.selectionMode.\n\n VALUES\n\n\n Object\n Geometry\n Dynamics\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Dynamics: EnumValue = ...\n Geometry: EnumValue = ...\n Object: EnumValue = ...\n\nclass pickStyle:\n \"\"\"\n\n hou.pickStyle\n\n Enumeration of pick styles.\n\n VALUES\n\n\n Box\n Lasso\n Brush\n Laser\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Box: EnumValue = ...\n Brush: EnumValue = ...\n Laser: EnumValue = ...\n Lasso: EnumValue = ...\n\nclass pickModifier:\n \"\"\"\n\n hou.pickModifier\n\n Enumeration of methods for modifying selections with new components.\n\n VALUES\n\n\n Add\n Toggle\n Remove\n Replace\n Intersect\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Add: EnumValue = ...\n Intersect: EnumValue = ...\n Remove: EnumValue = ...\n Replace: EnumValue = ...\n Toggle: EnumValue = ...\n\nclass pickFacing:\n \"\"\"\n\n hou.pickFacing\n\n Enumeration for describing the facing direction of pickable components.\n\n VALUES\n\n\n Front\n Back\n FrontAndBack\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Back: EnumValue = ...\n Front: EnumValue = ...\n FrontAndBack: EnumValue = ...\n\nclass displaySetType:\n \"\"\"\n\n hou.displaySetType\n\n Enum of viewport geometry contexts.\n\n There are several contexts for controlling shading and marker display\n which allow geometries from different operators to be distinguished from\n one another.\n\n VALUES\n\n\n hou.displaySetType.SceneObject\n Objects which are displayed but not selected, when the scene is\n viewing objects. In LOPs, this affects unselected primitives.\n\n hou.displaySetType.SelectedObject\n Objects which are displayed and selected, when the scene is\n viewing objects. In LOPs, this affects selected primitives.\n\n hou.displaySetType.GhostObject\n Objects which are not the currently edited object when Ghost\n other Objects display mode is active. Not used in LOPs.\n\n hou.displaySetType.DisplayModel\n The currently displayed surface operater when editing an object.\n Not used in LOPs.\n\n hou.displaySetType.CurrentModel\n The currently selected surface operater when editing an object.\n Not used in LOPs.\n\n hou.displaySetType.TemplateModel\n Surface operaters that have their template flag set when editing\n an object. Not used in LOPs.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CurrentModel: EnumValue = ...\n DisplayModel: EnumValue = ...\n GhostObject: EnumValue = ...\n SceneObject: EnumValue = ...\n SelectedObject: EnumValue = ...\n TemplateModel: EnumValue = ...\n\nclass topCookState:\n \"\"\"\n\n hou.topCookState\n\n Enumeration of TOP Node cook states.\n\n VALUES\n\n\n Uncooked\n The node is uncooked. This occurs when it has no work items\n because it has never cooked before, or if it was dirtied.\n\n Cooking\n The node has work items that are currently cooking.\n\n Cooked\n All work items in the node are cooked.\n\n Failed\n One or more work items in the node has failed to cook.\n\n Warning\n One or more work items in the node have been canceled or issued\n a warning during the cook\n\n Waiting\n The node has no cooking work items, but may still generate new\n work from an input node.\n\n Incomplete\n The node has cooked work items, but one or more work items are\n in an uncooked state.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Cooked: EnumValue = ...\n Cooking: EnumValue = ...\n Failed: EnumValue = ...\n Incomplete: EnumValue = ...\n Uncooked: EnumValue = ...\n Waiting: EnumValue = ...\n Warning: EnumValue = ...\n\nclass markerVisibility:\n \"\"\"\n\n hou.markerVisibility\n\n Enum of visibility options for marker visualizers.\n\n VALUES\n\n\n hou.markerVisibility.Always\n Display the markers without restriction.\n\n hou.markerVisibility.Selected\n Only display the marker if its component is selected.\n\n hou.markerVisibility.AroundPointer\n Display markers around the mouse pointer in 3D space.\n\n hou.markerVisibility.UnderPointer\n Display markers under the mouse pointer in screen space.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Always: EnumValue = ...\n AroundPointer: EnumValue = ...\n Selected: EnumValue = ...\n UnderPointer: EnumValue = ...\n\nclass viewportGuide:\n \"\"\"\n\n hou.viewportGuide\n\n Viewport guides\n\n List of viewport guides that can be queried, enabled or disabled.\n\n VALUES\n\n\n hou.viewportGuide.CameraMask\n The mask which dims out areas outside the camera aspect ratio.\n\n hou.viewportGuide.CurrentGeometry\n Geometry from the current modelling operator (SOP)\n\n hou.viewportGuide.DisplayNodes\n Geometry from the currently displayed modelling operator (SOP)\n\n hou.viewportGuide.FieldGuide\n hou.viewportGuide.FillSelections\n Polygon selections are highlighted with a solid color rather\n than just an outline when in Wire-Over shading modes.\n\n hou.viewportGuide.FloatingGnomon\n Show the orientation axes in the lower left corner of the\n viewport.\n\n hou.viewportGuide.FollowSelection\n Show point or vertex markers when point or selection is active.\n\n hou.viewportGuide.GroupList\n Show the group list in the top right corner of the viewport.\n\n hou.viewportGuide.IKCriticalZone\n Show the critical zone for IK bones.\n\n hou.viewportGuide.NodeGuides\n Show any node guides that are available.\n\n hou.viewportGuide.NodeHandles\n Show any handles that are available.\n\n hou.viewportGuide.ObjectNames\n Show object names for visible objects.\n\n hou.viewportGuide.ObjectPaths\n Show full objects paths for visible objects. Object names must\n be displayed.\n\n hou.viewportGuide.ObjectSelection\n Show object selections.\n\n hou.viewportGuide.OriginGnomon\n Show the axes at the world origin.\n\n hou.viewportGuide.ParticleGnomon\n Show axes per particle.\n\n hou.viewportGuide.SafeArea\n Show the safe area overlay for broadcast.\n\n hou.viewportGuide.SelectableTemplates\n Show geometry from modelling operators with their selectable\n template flags set.\n\n hou.viewportGuide.ShowDrawTime\n Show the time to update and render the viewport.\n\n hou.viewportGuide.TemplateGeometry\n Show geometry from modelling operators with their template flags\n set.\n\n hou.viewportGuide.ViewPivot\n Show the camera pivot where tumbling will rotate about.\n\n hou.viewportGuide.XYPlane\n Show a grid along the XY plane.\n\n hou.viewportGuide.XZPlane\n Show a grid along the XZ plane.\n\n hou.viewportGuide.YZPlane\n Show a grid along the YZ plane.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CameraMask: EnumValue = ...\n CurrentGeometry: EnumValue = ...\n DisplayNodes: EnumValue = ...\n FieldGuide: EnumValue = ...\n FillSelections: EnumValue = ...\n FloatingGnomon: EnumValue = ...\n FollowSelection: EnumValue = ...\n GroupList: EnumValue = ...\n IKCriticalZone: EnumValue = ...\n NodeGuides: EnumValue = ...\n NodeHandles: EnumValue = ...\n ObjectNames: EnumValue = ...\n ObjectPaths: EnumValue = ...\n ObjectSelection: EnumValue = ...\n OriginGnomon: EnumValue = ...\n ParticleGnomon: EnumValue = ...\n SafeArea: EnumValue = ...\n SelectableTemplates: EnumValue = ...\n ShowDrawTime: EnumValue = ...\n TemplateGeometry: EnumValue = ...\n ViewPivot: EnumValue = ...\n XYPlane: EnumValue = ...\n XZPlane: EnumValue = ...\n YZPlane: EnumValue = ...\n\nclass viewportGeometryInfo:\n \"\"\"\n\n hou.viewportGeometryInfo\n\n Geometry information display state\n\n The state of the geometry information displayed in the lower right\n corner of the viewport. This information takes additional time to\n generate.\n\n VALUES\n\n\n hou.viewportGeometryInfo.Off\n Do not show geometry information.\n\n hou.viewportGeometryInfo.SelectedOnly\n Only show information when a selection is present.\n\n hou.viewportGeometryInfo.AlwaysOn\n Always show information on the displayed geometry.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AlwaysOn: EnumValue = ...\n Off: EnumValue = ...\n SelectedOnly: EnumValue = ...\n\nclass viewportDefaultMaterial:\n \"\"\"\n\n hou.viewportDefaultMaterial\n\n The default material shader for the 3D viewer\n\n This enum is used by GeometryViewportSettings.setDefaultMaterialType()\n to select the GLSL shader used when no materials are assigned to\n geometry.\n\n\n NOTE\n Custom GLSL shaders aren't supported for Vulkan. Instead, use\n MaterialX.\n\n VALUES\n\n\n hou.viewportDefaultMaterial.Simple\n An untextured material with variable roughness and color\n settings for diffuse, specular, emission, and ambient values.\n\n hou.viewportDefaultMaterial.MatCap\n A material that uses a MatCap texture (Material Capture) to\n define the lighting and shading of the surface rather than the\n lights in the scene.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n MatCap: EnumValue = ...\n Simple: EnumValue = ...\n\nclass viewportHandleHighlight:\n \"\"\"\n\n hou.viewportHandleHighlight\n\n Handle highlight size\n\n Highlight size when moving the mouse over a handle.\n\n VALUES\n\n\n hou.viewportHandleHighlight.Off\n Don't display any highlights.\n\n hou.viewportHandleHighlight.Small\n Show a half-width highlight.\n\n hou.viewportHandleHighlight.Normal\n Show a full highlight.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Normal: EnumValue = ...\n Off: EnumValue = ...\n Small: EnumValue = ...\n\nclass viewportClosureSelection:\n \"\"\"\n\n hou.viewportClosureSelection\n\n Viewport highlight of primitives with selected components\n\n When components of a primitive are selected (points, vertices, edges),\n the primitive can be highlighted as well to indicate which primitives\n will be affected by the current selection.\n\n VALUES\n\n\n hou.viewportClosureSelection.Hide\n Primitives are not highlighted.\n\n hou.viewportClosureSelection.HullPrimitives\n Only primitives whose points and edges reside on separate hull\n geometry will be highlighted when those are selected (NURBS\n surfaces, Bezier surfaces).\n\n hou.viewportClosureSelection.Show\n Highlight all primitives whose points, edges, or vertices belong\n to the current selection.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Hide: EnumValue = ...\n HullPrimitives: EnumValue = ...\n Show: EnumValue = ...\n\nclass viewportGuideFont:\n \"\"\"\n\n hou.viewportGuideFont\n\n Viewport font sizes for visualizer text\n\n Font sizes for displaying text-based visualizers.\n\n VALUES\n\n\n hou.viewportGuideFont.Tiny\n Tiny font.\n\n hou.viewportGuideFont.Small\n Small font.\n\n hou.viewportGuideFont.Medium\n The just right font.\n\n hou.viewportGuideFont.Large\n Largest font.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Large: EnumValue = ...\n Medium: EnumValue = ...\n Small: EnumValue = ...\n Tiny: EnumValue = ...\n\nclass viewportVolumeQuality:\n \"\"\"\n\n hou.viewportVolumeQuality\n\n Display options for viewport volume rendering quality\n\n Volume display in the viewport can be an expensive drawing operation.\n The volume quality can be adjusted to provide better viewport\n performance or better volume quality.\n\n VALUES\n\n\n VeryLow\n Quick volume preview.\n\n Low\n Minor quality loss for performance.\n\n Normal\n Balanced quality/performance setting.\n\n High\n Jittered, high quality volume with more passes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n High: EnumValue = ...\n Low: EnumValue = ...\n Normal: EnumValue = ...\n VeryLow: EnumValue = ...\n\nclass viewportVolumeBSplines:\n \"\"\"\n\n hou.viewportVolumeBSplines\n\n Display options for viewport volume sampling quality\n\n When displaying fog volumes, the viewport can sample the underlying\n textures using either fast trilinear interpolation or slower (but\n smoother) b-spline interpolation. This enumeration contains the various\n sampling modes supported by the viewport.\n\n\n NOTE\n The equivalent setting in the viewport display options can be found\n in the Geometry tab and is labelled Volume Filtering.\n\n VALUES\n\n\n Off\n The viewport will never use higher-order volume interpolation.\n This is the fastest to draw, but low resolution volumes may\n appear blocky in the viewport.\n\n NonInteractive\n The viewport will use the higher-order interpolation when not\n interacting with the viewport. This mode falls back to linear\n interpolation while interacting with the viewport to speed up\n draws.\n\n On\n The viewport will always use higher-order volume interpolation.\n This is the slowest, highest quality option.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NonInteractive: EnumValue = ...\n Off: EnumValue = ...\n On: EnumValue = ...\n\nclass viewportBGImageView:\n \"\"\"\n\n hou.viewportBGImageView\n\n Background image view target for the viewport display options\n\n Selects a view target when choosing which background image to edit in\n GeometryViewportSettings.\n\n VALUES\n\n\n hou.viewportBGImageView.Perspective\n The 3D view not attached to a camera (No cam).\n\n hou.viewportBGImageView.Camera\n The 3D view looking through a camera.\n\n hou.viewportBGImageView.Top\n The orthographic top view.\n\n hou.viewportBGImageView.Front\n The orthographic front view.\n\n hou.viewportBGImageView.Right\n The orthographic right view.\n\n hou.viewportBGImageView.Bottom\n The orthographic bottom view.\n\n hou.viewportBGImageView.Back\n The orthographic back view.\n\n hou.viewportBGImageView.Left\n The orthographic left view.\n\n hou.viewportBGImageView.UV\n The UV texture viewport.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Back: EnumValue = ...\n Bottom: EnumValue = ...\n Camera: EnumValue = ...\n Front: EnumValue = ...\n Left: EnumValue = ...\n Perspective: EnumValue = ...\n Right: EnumValue = ...\n Top: EnumValue = ...\n UV: EnumValue = ...\n\nclass viewportColorScheme:\n \"\"\"\n\n hou.viewportColorScheme\n\n Viewport Color Schemes\n\n List of available color schemes for the viewport.\n\n VALUES\n\n\n hou.viewportColorScheme.Dark\n Solid black backaground.\n\n hou.viewportColorScheme.Grey\n Solid grey background.\n\n hou.viewportColorScheme.Light\n Light blue gradient background.\n\n hou.viewportColorScheme.DarkGrey\n Light blue gradient background.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Dark: EnumValue = ...\n DarkGrey: EnumValue = ...\n Grey: EnumValue = ...\n Light: EnumValue = ...\n\nclass viewportParticleDisplay:\n \"\"\"\n\n hou.viewportParticleDisplay\n\n Viewport display option for particle display visualization.\n\n Specifies the visualization for particles and points in the viewport.\n\n VALUES\n\n\n Points\n Fixed size points in screen space.\n\n Lines\n Points with streaks indicating velocity.\n\n Pixels\n Single pixel particle (fixed size)\n\n Discs\n Circular disc, variable world size.\n\n Spheres\n Spheres which have material assignments and lighting, variable\n world size.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Discs: EnumValue = ...\n Lines: EnumValue = ...\n Pixels: EnumValue = ...\n Points: EnumValue = ...\n Spheres: EnumValue = ...\n\nclass viewportStandInGeometry:\n \"\"\"\n\n hou.viewportStandInGeometry\n\n Replacement geometry for instances culled in the viewport.\n\n When using point instancing, instances can be culled because of the\n Point Instancing Percent, or the Instancing Limit display options.\n Culled instances can be replaced by a marker or bounding box, or\n completely hidden.\n\n VALUES\n\n\n DisplayOff\n Don't show anything for culled instances.\n\n LocationMarker\n Show a point marker at the local space origin of the instance.\n\n BoundingBox\n Show the bounding box of the culled instance.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n BoundingBox: EnumValue = ...\n DisplayOff: EnumValue = ...\n LocationMarker: EnumValue = ...\n\nclass viewportLighting:\n \"\"\"\n\n hou.viewportLighting\n\n Lighting modes for the viewport\n\n The viewport renderer supports several global lighting modes, from no\n lighting whatsoever to full lighting with shadows.\n\n VALUES\n\n\n hou.viewportLighting.Off\n No lighting, constant shaded.\n\n hou.viewportLighting.Headlight\n Basic lighting from a single directional light defined in the\n display options.\n\n hou.viewportLighting.Normal\n Good quality lighting from up to 10 basic lights (area lights\n modeled as point lights, limited environment lights).\n\n hou.viewportLighting.HighQuality\n High quality lighting from an unlimited number of lights\n including area, geometry, environment and ambient occlusion.\n\n hou.viewportLighting.HighQualityWithShadows\n High quality lighting with shadows.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Headlight: EnumValue = ...\n HighQuality: EnumValue = ...\n HighQualityWithShadows: EnumValue = ...\n Normal: EnumValue = ...\n Off: EnumValue = ...\n\nclass viewportWorkLight:\n \"\"\"\n\n hou.viewportWorkLight\n\n Work light type for the viewer\n\n Choices for work lights in the viewer, which override the user-defined\n lights for specific lighting conditions.\n\n VALUES\n\n\n hou.viewportWorkLight.Headlight\n The over-the-shoulder single distant light.\n\n hou.viewportWorkLight.Domelight\n Environment light with optional file map.\n\n hou.viewportWorkLight.PhysicalSky\n Sun and sky map lighting based on sun position and atmospheric\n parameters.\n\n hou.viewportWorkLight.ThreePoint\n Three distant lights arranged in a common three-point lighting\n setup.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Domelight: EnumValue = ...\n Headlight: EnumValue = ...\n PhysicalSky: EnumValue = ...\n ThreePoint: EnumValue = ...\n\nclass viewportTransparency:\n \"\"\"\n\n hou.viewportTransparency\n\n Transparency rendering quality for the viewport\n\n Quality levels for rendering objects with transparency in the viewport.\n\n VALUES\n\n\n hou.viewportTransparency.Cutout\n Fast test to render the transparent pixel as opaque (>0) or to\n discard it (0). This can be used for texture cards such as\n leaves. This doesn't require an additional pass for\n transparency.\n\n hou.viewportTransparency.Low\n Render transparent pixels in a separate pass. Only the front-\n most transparent pixel is rendered.\n\n hou.viewportTransparency.Medium\n Render transparent pixels in an Order-Independent buffer of 8\n samples, which is then sorted and composited together to do\n multi-layer transparency for up to 8 layers of overlapping\n transparency.\n\n hou.viewportTransparency.High\n Render transparent pixels in an Order-Independent buffer of 16\n samples, which is then sorted and composited together to do\n multi-layer transparency for up to 16 layers of overlapping\n transparency.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Cutout: EnumValue = ...\n High: EnumValue = ...\n Low: EnumValue = ...\n Medium: EnumValue = ...\n\nclass viewportShadowQuality:\n \"\"\"\n\n hou.viewportShadowQuality\n\n The quality of shadows produced in the viewport\n\n The viewport renderer can do various amounts of shadowmap sampling to\n produce a higher quality result.\n\n VALUES\n\n\n hou.viewportShadowQuality.Point\n Area lights are treated as point lights when generating and\n sampling shadow maps. This is the fastest option.\n\n hou.viewportShadowQuality.PointAA\n Do some antialiasing of shadow edges. Treat area lights as point\n lights when generating and sampling shadow maps.\n\n hou.viewportShadowQuality.Area\n Area lights generate multiple shadow maps which are sampled to\n generate an approximation of a blurred shadow from an area\n source.\n\n hou.viewportShadowQuality.AreaAA\n Area lights generate multiple maps and antialias the shadow\n lookups.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Area: EnumValue = ...\n AreaAA: EnumValue = ...\n Point: EnumValue = ...\n PointAA: EnumValue = ...\n\nclass viewportDOFBokeh:\n \"\"\"\n\n hou.viewportDOFBokeh\n\n Viewport Depth of Field Bokeh Shape\n\n Defines the shape of the depth of field bokeh in the viewport.\n\n VALUES\n\n\n hou.viewportDOFBokeh.NoBokeh\n No extra bokeh effect.\n\n hou.viewportDOFBokeh.Circular\n Circular or oval bokeh.\n\n hou.viewportDOFBokeh.Texture\n Shape defined by a texture (image file or COP).\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Circular: EnumValue = ...\n NoBokeh: EnumValue = ...\n Texture: EnumValue = ...\n\nclass viewportFogHeightMode:\n \"\"\"\n\n hou.viewportFogHeightMode\n\n Viewport fog layer modes\n\n Defines the types of fog layering available for viewport fog.\n\n VALUES\n\n\n hou.viewportFogHeightMode.Off\n No layering; fog is the same density regardless of height.\n\n hou.viewportFogHeightMode.Above\n Fog exists only above a given height.\n\n hou.viewportFogHeightMode.Below\n Fog exists only below a given height.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Above: EnumValue = ...\n Below: EnumValue = ...\n Off: EnumValue = ...\n\nclass viewportFogQuality:\n \"\"\"\n\n hou.viewportFogQuality\n\n Viewport volume fog quality\n\n Defines the quality settings for volumetric fog in the viewport.\n\n VALUES\n\n\n hou.viewportFogQuality.Low\n Uses a small volume for fog lighting. Fast but low quality.\n\n hou.viewportFogQuality.Medium\n Uses a bigger volume for fog lighting. Balanced between quality\n and speed.\n\n hou.viewportFogQuality.High\n Uses a large volume for fog lighting. Slow but good quality.\n\n hou.viewportFogQuality.VeryHigh\n Uses a large volume for fog lighting. Slowest but best quality.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n High: EnumValue = ...\n Low: EnumValue = ...\n Medium: EnumValue = ...\n VeryHigh: EnumValue = ...\n\nclass viewportMaterialUpdate:\n \"\"\"\n\n hou.viewportMaterialUpdate\n\n Enum for the update frequency of viewport material assignments\n\n When material assignments are re-evaluated for a displayed object.\n\n VALUES\n\n\n hou.viewportMaterialUpdate.Always\n Update assignments whenever needeed.\n\n hou.viewportMaterialUpdate.Manual\n Only update assignments when Update Materials is pressed.\n\n hou.viewportMaterialUpdate.OffForPlayback\n Update assignments whenever needed, but not during playback.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Always: EnumValue = ...\n Manual: EnumValue = ...\n OffForPlayback: EnumValue = ...\n\nclass viewportAgentBoneDeform:\n \"\"\"\n\n hou.viewportAgentBoneDeform\n\n Enum for deforming agent quality\n\n Defines the quality vs. performance tradeoff for deforming agent\n geometry.\n\n VALUES\n\n\n hou.viewportAgentBoneDeform.Always\n Only use 1 bone to deform on all agent instances (the one with\n the most influence).\n\n hou.viewportAgentBoneDeform.Disabled\n Use up to 4 bones to deform the highest LOD agent instances, and\n 1 bone on all the reduced LOD instances.\n\n hou.viewportAgentBoneDeform.ReducedLOD\n Use up to 4 bones to deform on all agent instances.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Always: EnumValue = ...\n Disabled: EnumValue = ...\n ReducedLOD: EnumValue = ...\n\nclass viewportAgentWireframe:\n \"\"\"\n\n hou.viewportAgentWireframe\n\n Enum for agent wireframe mode display\n\n The look of agents in wireframe mode.\n\n VALUES\n\n\n hou.viewportAgentWireframe.Bone\n Agents are rendered as bone-based skeletons.\n\n hou.viewportAgentWireframe.Line\n Agents are rendered as line-based skeletons.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Bone: EnumValue = ...\n Line: EnumValue = ...\n\nclass viewportPackedBoxMode:\n \"\"\"\n\n hou.viewportPackedBoxMode\n\n Enum for the culled packed geometry display mode.\n\n Defines how culled packed primitives are displayed in the viewport.\n\n VALUES\n\n\n hou.viewportPackedBoxMode.NoDisplay\n Culled packed primitives are not displayed at all.\n\n hou.viewportPackedBoxMode.Wireframe\n A wireframe bounding box replaces the packed primitive.\n\n hou.viewportPackedBoxMode.Shaded\n A shaded bounding box replaces the packed primitive.\n\n hou.viewportPackedBoxMode.CurrentShadingMode\n A bounding box replaces the packed primitive, drawn wireframe in\n wireframe shading modes and shaded otherwise.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CurrentShadingMode: EnumValue = ...\n NoDisplay: EnumValue = ...\n Shaded: EnumValue = ...\n Wireframe: EnumValue = ...\n\nclass viewportGridRuler:\n \"\"\"\n\n hou.viewportGridRuler\n\n Enum for grid numbering on viewport grids.\n\n Specifies where the grid numbering occurs on viewport grids.\n\n VALUES\n\n\n hou.viewportGridRuler.Hide\n No grid numbers are displayed.\n\n hou.viewportGridRuler.MainAxis\n Numbers appear along the max axes at grid line intersections.\n\n hou.viewportGridRuler.GridPoints\n Numbers appear at grid line intersections.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n GridPoints: EnumValue = ...\n Hide: EnumValue = ...\n MainAxis: EnumValue = ...\n\nclass viewportTextureDepth:\n \"\"\"\n\n hou.viewportTextureDepth\n\n Enum for the viewport texture bit depth limit\n\n Specifies the maximum bit depth that can be used for textures in the\n viewport.\n\n VALUES\n\n\n hou.viewportTextureDepth.Compressed8\n Compressed, 8b SDR texture format. Smallest memory use.\n\n hou.viewportTextureDepth.Fixed8\n 8b SDR texture format. Good balance between memory and quality.\n\n hou.viewportTextureDepth.FullHDR\n 16b HDR texture format. Excellent dynamic range, but more memory\n use and slower texturing performance.\n\n hou.viewportTextureDepth.HDR16\n 32b HDR texture format. Extreme dynamic range, but very high\n memory use and slow texturing performance. Use with care.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Compressed8: EnumValue = ...\n Fixed8: EnumValue = ...\n FullHDR: EnumValue = ...\n HDR16: EnumValue = ...\n\nclass boundaryDisplay:\n \"\"\"\n\n hou.boundaryDisplay\n\n Enum for viewport boundary overlay.\n\n Boundaries are used to show the edges of polygon mesh islands, for\n either position or UV coordinates.\n\n VALUES\n\n\n hou.boundaryDisplay.Off\n The boundary is disabled.\n\n hou.boundaryDisplay.View3D\n The boundary is shown in 3D viewports only.\n\n hou.boundaryDisplay.ViewUV\n The boundary is shown in UV viewports only.\n\n hou.boundaryDisplay.On\n The boundary is shown in all viewports.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Off: EnumValue = ...\n On: EnumValue = ...\n View3D: EnumValue = ...\n ViewUV: EnumValue = ...\n\nclass flipbookObjectType:\n \"\"\"\n\n hou.flipbookObjectType\n\n Enum values for setting the flipbook's visible object types.\n\n Used by FlipbookSettings.visibleTypes() to set the visible object types\n when doing a flipbook.\n\n VALUES\n\n\n hou.flipbookObjectType.Visible\n All object types that are currently visible will be rendered.\n\n hou.flipbookObjectType.GeoOnly\n Only geometry objects will be rendered, which excludes bone,\n muscle, null, camera, light, and blend objects.\n\n hou.flipbookObjectType.GeoExcluded\n All object types other than Geometry that are currently visible\n will be rendered.\n\n hou.flipbookObjectType.AllObjects\n All object types will be rendered, even if their type is not\n currently visible.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AllObjects: EnumValue = ...\n GeoExcluded: EnumValue = ...\n GeoOnly: EnumValue = ...\n Visible: EnumValue = ...\n\nclass groupListType:\n \"\"\"\n\n hou.groupListType\n\n Enumeration of group list types.\n\n VALUES\n\n\n Points\n Vertices\n Edges\n Breakpoints\n Primitives\n MatchPickType\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Breakpoints: EnumValue = ...\n Edges: EnumValue = ...\n MatchPickType: EnumValue = ...\n Points: EnumValue = ...\n Primitives: EnumValue = ...\n Vertices: EnumValue = ...\n\nclass geometryType:\n \"\"\"\n\n hou.geometryType\n\n Enumeration of geometry component types.\n\n VALUES\n\n\n Points\n Vertices\n Edges\n Breakpoints\n Primitives\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Breakpoints: EnumValue = ...\n Edges: EnumValue = ...\n Points: EnumValue = ...\n Primitives: EnumValue = ...\n Vertices: EnumValue = ...\n\nclass connectivityType:\n \"\"\"\n\n hou.connectivityType\n\n Enumeration of connectivity types.\n\n VALUES\n\n\n NoConnectivity\n Texture\n Position\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NoConnectivity: EnumValue = ...\n Position: EnumValue = ...\n Texture: EnumValue = ...\n\nclass severityType:\n \"\"\"\n\n hou.severityType\n\n Enumeration of dialog message severities.\n\n VALUES\n\n\n Message\n ImportantMessage\n Warning\n Error\n Fatal\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Error: EnumValue = ...\n Fatal: EnumValue = ...\n ImportantMessage: EnumValue = ...\n Message: EnumValue = ...\n Warning: EnumValue = ...\n\nclass confirmType:\n \"\"\"\n\n hou.confirmType\n\n Enumeration of confirmation dialog suppression options.\n\n VALUES\n\n\n NoConfirmType\n OverwriteFile\n UnlockNode\n DeleteSpareParameters\n DeleteWithoutReferences\n NestedChannelGroups\n SiblingChannelGroups\n DeleteShelfElement\n DeleteGalleryEntry\n InactiveSnapMode\n BackgroundSave\n LockMultiNode\n SaveEmbeddedDefinitions\n OCIOChangeReminder\n OCIOPackageExists\n OverwriteRecipe\n TopCookSave\n TopDeleteResults\n TopDeleteTempDir\n TopHotKeyCancelCook\n TopViewResults\n TopTerminateRemoteSession\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n BackgroundSave: EnumValue = ...\n DeleteGalleryEntry: EnumValue = ...\n DeleteShelfElement: EnumValue = ...\n DeleteSpareParameters: EnumValue = ...\n DeleteWithoutReferences: EnumValue = ...\n InactiveSnapMode: EnumValue = ...\n LockMultiNode: EnumValue = ...\n NestedChannelGroups: EnumValue = ...\n NoConfirmType: EnumValue = ...\n OCIOChangeReminder: EnumValue = ...\n OCIOPackageExists: EnumValue = ...\n OverwriteFile: EnumValue = ...\n OverwriteRecipe: EnumValue = ...\n SaveEmbeddedDefinitions: EnumValue = ...\n SiblingChannelGroups: EnumValue = ...\n TopCookSave: EnumValue = ...\n TopDeleteResults: EnumValue = ...\n TopDeleteTempDir: EnumValue = ...\n TopHotKeyCancelCook: EnumValue = ...\n TopTerminateRemoteSession: EnumValue = ...\n TopViewResults: EnumValue = ...\n UnlockNode: EnumValue = ...\n\nclass positionType:\n \"\"\"\n\n hou.positionType\n\n Enumeration of spaces.\n\n VALUES\n\n\n WorldSpace\n ViewportXY\n ViewportUV\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ViewportUV: EnumValue = ...\n ViewportXY: EnumValue = ...\n WorldSpace: EnumValue = ...\n\nclass componentLoopType:\n \"\"\"\n\n hou.componentLoopType\n\n Enumeration of component loop types.\n\n VALUES\n\n\n Partial\n A partial loop connects the components provided in a path with\n each input component acting as a way-point on the path. The loop\n will always start with the first provided component and end with\n the last.\n\n Extended\n An extended loop is always created from just two components (or\n possibly one edge component). It finds a path between these two\n components, then extends that path at both ends. It extends each\n direction until it either hits a boundary in the geometry, or\n finds its way back to the existing path. Often the resulting\n path will neither start with the start component or end with the\n end component.\n\n Closed\n A closed loop is always created from just two components (or\n possibly one edge component). It always tries to find a path the\n goes from the starting component, passes through the end\n component, and then continues on looking for a path back to the\n starting component. The paths returned will generally both start\n and end with the starting component.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Closed: EnumValue = ...\n Extended: EnumValue = ...\n Partial: EnumValue = ...\n\nclass flipbookAntialias:\n \"\"\"\n\n hou.flipbookAntialias\n\n Enum values for flipbook antialiasing settings.\n\n See hou.FlipbookSettings.antialias.\n\n VALUES\n\n\n UseViewportSetting\n Use the current viewport's antialiasing setting.\n\n Off\n No antialiasing.\n\n Fast\n Fast 2-sample antialiasing.\n\n Good\n 4-sample antialiasing.\n\n HighQuality\n High-quality 8-sample antialiasing.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Fast: EnumValue = ...\n Good: EnumValue = ...\n HighQuality: EnumValue = ...\n Off: EnumValue = ...\n UseViewportSetting: EnumValue = ...\n\nclass flipbookMotionBlurBias:\n \"\"\"\n\n hou.flipbookMotionBlurBias\n\n Enum values used to specify the motion blur subframe range.\n\n See hou.FlipbookSettings.motionBlurFrameRange.\n\n VALUES\n\n\n Centered\n Subframe range is centered around the currently rendering frame.\n\n Forward\n Subframe range begins at the currently rendering frame.\n\n Previous\n Subframe range ends at the currently rendering frame.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Centered: EnumValue = ...\n Forward: EnumValue = ...\n Previous: EnumValue = ...\n\nclass parameterInterfaceTabType:\n \"\"\"\n\n hou.parameterInterfaceTabType\n\n Enum values for selecting a specific parameter source tab in the\n parameter interface dialog.\n\n See hou.ui.openParameterInterfaceDialog.\n\n VALUES\n\n\n ParameterTypes\n The tab that provides a flat list of all available parameter\n types.\n\n RenderProperties\n The Render Properties tab, containing options parameters for\n controlling object rendering.\n\n NodeProperties\n The Node Properties tab, which contains definitions for spare\n parameters commonly used on specific node types.\n\n NodeParameters\n The Node Parameters tab, which displays a tree view of the\n current hip file, and all parameters on all existing nodes.\n\n UsdProperties\n The USD Properties tab which lists the current USD stage, all\n concrete USD schemas, and custom properties for every supported\n USD property data type.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NodeParameters: EnumValue = ...\n NodeProperties: EnumValue = ...\n ParameterTypes: EnumValue = ...\n RenderProperties: EnumValue = ...\n UsdProperties: EnumValue = ...\n\nclass shaderType:\n \"\"\"\n\n hou.shaderType\n\n Enumeration of SHOP shader types.\n\n Each SHOP type defines a particular type of shader. For example, it\n might be a surface shader or a displacement shader. This enumeration\n contains all the possible shader types.\n\n Use hou.ShopNodeType.shaderType to determine what type of shader a\n particular SHOP type is.\n\n VALUES\n\n\n Invalid\n Surface\n SurfaceShadow\n Displacement\n Geometry\n Interior\n Light\n LightShadow\n Atmosphere\n Lens\n Output\n Background\n Photon\n Image3D\n BSDF\n CVEX\n Mutable\n Properties\n Material\n VopMaterial\n ShaderClass\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Atmosphere: EnumValue = ...\n BSDF: EnumValue = ...\n Background: EnumValue = ...\n CVEX: EnumValue = ...\n Displacement: EnumValue = ...\n Geometry: EnumValue = ...\n Image3D: EnumValue = ...\n Interior: EnumValue = ...\n Invalid: EnumValue = ...\n Lens: EnumValue = ...\n Light: EnumValue = ...\n LightShadow: EnumValue = ...\n Material: EnumValue = ...\n Mutable: EnumValue = ...\n Output: EnumValue = ...\n Photon: EnumValue = ...\n Properties: EnumValue = ...\n ShaderClass: EnumValue = ...\n Surface: EnumValue = ...\n SurfaceShadow: EnumValue = ...\n VopMaterial: EnumValue = ...\n\nclass rampBasis:\n \"\"\"\n\n hou.rampBasis\n\n Enumeration of ramp interpolation types.\n\n These interpolation types specify how Houdini interpolates between\n keyframed values in a hou.Ramp. See hou.Ramp.basis and hou.Ramp.__init__\n for more information about how to get and set ramp interpolation types.\n\n VALUES\n\n\n Linear\n Does a linear (straight line) interpolation between keys.\n\n Constant\n Holds the value constant until the next key.\n\n CatmullRom\n Interpolates smoothly between the keys. See Catmull-Rom_spline.\n\n MonotoneCubic\n Another smooth interpolation that ensures that there is no\n overshoot. For example, if a key's value is smaller than the\n values in the adjacent keys, this type ensures that the\n interpolated value is never less than the key's value.\n\n Bezier\n Cubic Bezier curve that interpolates every third control point\n and uses the other points to shape the curve. See Bezier curve.\n\n BSpline\n Cubic curve where the control points influence the shape of the\n curve locally (that is, they influence only a section of the\n curve). See B-Spline.\n\n Hermite\n Cubic Hermite curve that interpolates the odd control points,\n while even control points control the tangent at the previous\n interpolation point. See Hermite spline.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n BSpline: EnumValue = ...\n Bezier: EnumValue = ...\n CatmullRom: EnumValue = ...\n Constant: EnumValue = ...\n Hermite: EnumValue = ...\n Linear: EnumValue = ...\n MonotoneCubic: EnumValue = ...\n\nclass rampParmType:\n \"\"\"\n\n hou.rampParmType\n\n Enumeration of ramp types.\n\n VALUES\n\n\n Color\n Float\n\n :\n\n * hou.RampParmTemplate\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Color: EnumValue = ...\n Float: EnumValue = ...\n\nclass colorType:\n \"\"\"\n\n hou.colorType\n\n Enumeration of color spaces.\n\n VALUES\n\n\n RGB\n The red green blue color model.\n\n HSV\n The hue saturation value color model.\n\n HSL\n The hue saturation lightness color model.\n\n LAB\n The CIE L* a* b* color space model.\n\n XYZ\n The CIE XYZ color space model.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n HSL: EnumValue = ...\n HSV: EnumValue = ...\n LAB: EnumValue = ...\n RGB: EnumValue = ...\n XYZ: EnumValue = ...\n\nclass nodeTypeSource:\n \"\"\"\n\n hou.nodeTypeSource\n\n Enumeration of node type sources.\n\n VALUES\n\n\n Internal\n CompiledCode\n VexCode\n RslCode\n Subnet\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CompiledCode: EnumValue = ...\n Internal: EnumValue = ...\n RslCode: EnumValue = ...\n Subnet: EnumValue = ...\n VexCode: EnumValue = ...\n\nclass fieldType:\n \"\"\"\n\n hou.fieldType\n\n Enumeration of field types.\n\n VALUES\n\n\n NoSuchField\n Integer\n Boolean\n Float\n String\n Dict\n Vector2\n Vector3\n Vector4\n Quaternion\n Matrix3\n Matrix4\n UV\n UVW\n IntArray\n FloatArray\n DictArray\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Boolean: EnumValue = ...\n Dict: EnumValue = ...\n DictArray: EnumValue = ...\n Float: EnumValue = ...\n FloatArray: EnumValue = ...\n IntArray: EnumValue = ...\n Integer: EnumValue = ...\n Matrix3: EnumValue = ...\n Matrix4: EnumValue = ...\n NoSuchField: EnumValue = ...\n Quaternion: EnumValue = ...\n String: EnumValue = ...\n UV: EnumValue = ...\n UVW: EnumValue = ...\n Vector2: EnumValue = ...\n Vector3: EnumValue = ...\n Vector4: EnumValue = ...\n\nclass renderMethod:\n \"\"\"\n\n hou.renderMethod\n\n Enumeration of dependency rendering methods.\n\n VALUES\n\n\n RopByRop\n FrameByFrame\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n FrameByFrame: EnumValue = ...\n RopByRop: EnumValue = ...\n\nclass updateMode:\n \"\"\"\n\n hou.updateMode\n\n Enumeration of interface update modes.\n\n See hou.updateModeSetting.\n\n VALUES\n\n\n AutoUpdate\n OnMouseUp\n Manual\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AutoUpdate: EnumValue = ...\n Manual: EnumValue = ...\n OnMouseUp: EnumValue = ...\n\nclass licenseCategoryType:\n \"\"\"\n\n hou.licenseCategoryType\n\n Enumeration of license category values.\n\n VALUES\n\n\n Commercial\n Indie\n Education\n ApprenticeHD\n Apprentice\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Apprentice: EnumValue = ...\n ApprenticeHD: EnumValue = ...\n Commercial: EnumValue = ...\n Education: EnumValue = ...\n Indie: EnumValue = ...\n\nclass hdaLicenseType:\n \"\"\"\n\n hou.hdaLicenseType\n\n Enumeration of digital asset license permission levels.\n\n VALUES\n\n\n Execute\n Read\n Full\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Execute: EnumValue = ...\n Full: EnumValue = ...\n Read: EnumValue = ...\n\nclass orientUpAxis:\n \"\"\"\n\n hou.orientUpAxis\n\n Enumeration of global orientation mode.\n\n See hou.ui.orientationUpAxis for more information.\n\n VALUES\n\n\n Y\n Z\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Y: EnumValue = ...\n Z: EnumValue = ...\n\nclass handleOrientToNormalAxis:\n \"\"\"\n\n hou.handleOrientToNormalAxis\n\n Enumeration of handle axes that can be aligned to a geometry normal.\n\n See hou.ui.handleOrientToNormalAxis for more information.\n\n VALUES\n\n\n Y\n Z\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Y: EnumValue = ...\n Z: EnumValue = ...\n\nclass nodeEventType:\n \"\"\"\n\n hou.nodeEventType\n\n Enumeration of types of events that can happen to nodes.\n\n Node event callbacks let you run code when events occur on an individual\n node instance. See hou.OpNode.addEventCallback.\n\n For all event types, the callback is called with a node keyword argument\n (containing a hou.OpNode reference to the node) and an event_type\n argument (containing one of the values below, indicating the type of\n event that occurred).\n\n Some event types pass additional keyword arguments to the callback\n function, as noted below.\n\n VALUES\n\n\n BeingDeleted\n Runs before a node is deleted. You cannot cancel the deletion.\n\n NameChanged\n Runs after a node was renamed. You can get the new name using\n hou.Node.name.\n\n FlagChanged\n Runs after one of the node's flags was turned on or off.\n\n AppearanceChanged\n Runs after the an event occurs that changes what the node looks\n like in the network editor. This includes but is not limited to:\n\n * Color or shape changed\n\n * Error triggered or cleared\n\n * Selected or deselected\n\n * Asset locked or unlocked\n\n Extra keyword argument: change_type (hou.appearanceChangeType)\n\n PositionChanged\n Runs after the node is moved in the network editor. You can get\n the node's new position using hou.Node.position.\n\n InputRewired\n Runs after one of the node's inputs are connected or\n disconnected.\n\n Extra keyword argument: input_index (int) -- the input number\n (starting at 0) that changed.\n\n InputDataChanged\n The data changed on an input node that this node depends on.\n Changes to an input node that is not used (due to a Switch node,\n for example) will not trigger this callback. Houdini also does\n not trigger this event when a node changes if that node's data\n or parameters are referenced through expressions. Only nodes\n connected to this node as an input will trigger this callback.\n\n ParmTupleChanged\n Runs after a parameter value changes. You can get the new value\n using hou.ParmTuple.eval.\n\n Extra keyword argument: parm_tuple (hou.ParmTuple).\n\n\n NOTE\n If many/all parameters on the node change at the same time,\n instead of calling the handler for each one, Houdini will\n call the handler once with a parm_tuple argument of None.\n Your callback code should handle this possibility.\n\n ParmTupleAnimated\n Runs after a parameter value changes from an undo/redo change or\n a major animation editor change. It isn't called during\n playback. You can get the new value using hou.ParmTuple.eval.\n\n Extra keyword argument: parm_tuple (hou.ParmTuple).\n\n\n NOTE\n If many/all parameters on the node change at the same time,\n instead of calling the handler for each one, Houdini will\n call the handler once with a parm_tuple argument of None.\n Your callback code should handle this possibility.\n\n ParmTupleChannelChanged\n Runs after a parameter value changes from a minor animation\n editor change. It isn't called during playback. You can get the\n new value using hou.ParmTuple.eval.\n\n Extra keyword argument: parm_tuple (hou.ParmTuple).\n\n\n NOTE\n If many/all parameters on the node change at the same time,\n instead of calling the handler for each one, Houdini will\n call the handler once with a parm_tuple argument of None.\n Your callback code should handle this possibility.\n\n ParmTupleLockChanged\n Runs after a parameter lock state has changed. You can get the\n new lock value using hou.Parm.isLocked.\n\n Extra keyword argument: parm_tuple (hou.ParmTuple).\n\n ParmTupleEnabledChanged\n Runs after a parameter enabled state has changed. You can get\n the new enabled state value using hou.Parm.isDisabled.\n\n ParmTupleVisibleChanged\n Runs after a parameter visible state has changed. You can get\n the new visibility value using hou.Parm.isHidden.\n\n ChildCreated\n For a subnet node (for example, a Geometry object), runs after a\n new node is created inside.\n\n Extra keyword argument: child_node (hou.OpNode)\n\n ChildDeleted\n For a subnet node (for example, a Geometry object), runs before\n a node is deleted inside. You cannot cancel the deletion.\n\n Extra keyword argument: child_node (hou.OpNode)\n\n ChildReordered\n For a subnet node (for example, a Geometry object), runs after\n the user-defined ordering changes for the nodes inside.\n\n ChildSwitched\n For a subnet node (for example, a Geometry object), runs after\n the current node, display flag, or render flag changes inside\n (meaning the 3D view will change).\n\n Extra keyword argument: child_node (hou.OpNode) -- the newly\n selected child node.\n\n ChildSelectionChanged\n For a subnet node (for example, a Geometry object), runs after\n the selection changes inside. The selection can consist of\n nodes, network boxes, sticky notes, indirect subnet inputs, or\n network dots. You can get the new selection with\n hou.Node.selectedItems.\n\n NetworkBoxCreated\n Runs after a new network box is created inside this node.\n\n NetworkBoxChanged\n Runs after an item is added to or removed from a network box\n inside this node. In some cases is may be possible to receive a\n NetworkBoxChanged callback for a new network box before\n receiving the NetworkBoxCreated callback.\n\n NetworkBoxDeleted\n Runs right before a network box is deleted from inside this\n node.\n\n StickyNoteCreated\n Runs after a new network box is created inside this node.\n\n StickyNoteChanged\n Runs after a new sticky note's text is changed inside this node.\n In some cases is may be possible to receive a StickyNoteChanged\n callback for a new network box before receiving the\n StickyNoteCreated callback.\n\n StickyNoteDeleted\n Runs right before a sticky note is deleted from inside this\n node.\n\n IndirectInputCreated\n Runs after a new indirect input is created inside this node.\n This will generally be a Network Dot, but may in some cases be a\n Subnet Indirect Input.\n\n IndirectInputRewired\n Runs after the input connection to an indirect input is changed.\n Since Subnet Indirect Inputs don't have input connections, this\n will only occur on a Network Dot.\n\n IndirectInputDeleted\n Runs before an indirect input is deleted from inside this node.\n This will generally be a Network Dot, but may in some cases be a\n Subnet Indirect Input.\n\n SpareParmTemplatesChanged\n Runs after a spare parameter is modified on, added to, or\n removed from the node.\n\n\n NOTE\n If the node has spare parameters, this event triggers when\n any parameter is modified, not just a spare parameter.\n\n SelectionChanged\n Runs after the selection associated with a node changes. This\n only applies to the geometry selected on a SOP node, or the\n scene graph primitives selected in a LOP Network.\n\n CustomDataChanged\n Runs after some custom data on a node is changed. The custom\n data available, and the methods for accessing it, will depend on\n the hou.NodeType of the node that is changing. One example of\n custom node data is the viewport scene overrides that can be\n applied to a LOP Network.\n\n WorkItemSelectionChanged\n For a TOP network, runs after the selected work item has a\n changed.\n\n Extra keyword argument: work_item_id - the ID of the selected\n work item\n\n Extra keyword argument: selected_node - the selected TOP node,\n if a selection exists\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AppearanceChanged: EnumValue = ...\n BeingDeleted: EnumValue = ...\n ChildCreated: EnumValue = ...\n ChildDeleted: EnumValue = ...\n ChildReordered: EnumValue = ...\n ChildSelectionChanged: EnumValue = ...\n ChildSwitched: EnumValue = ...\n CustomDataChanged: EnumValue = ...\n FlagChanged: EnumValue = ...\n IndirectInputCreated: EnumValue = ...\n IndirectInputDeleted: EnumValue = ...\n IndirectInputRewired: EnumValue = ...\n InputDataChanged: EnumValue = ...\n InputRewired: EnumValue = ...\n NameChanged: EnumValue = ...\n NetworkBoxChanged: EnumValue = ...\n NetworkBoxCreated: EnumValue = ...\n NetworkBoxDeleted: EnumValue = ...\n ParmTupleAnimated: EnumValue = ...\n ParmTupleChanged: EnumValue = ...\n ParmTupleChannelChanged: EnumValue = ...\n ParmTupleEnabledChanged: EnumValue = ...\n ParmTupleLockChanged: EnumValue = ...\n ParmTupleVisibleChanged: EnumValue = ...\n PositionChanged: EnumValue = ...\n SelectionChanged: EnumValue = ...\n SpareParmTemplatesChanged: EnumValue = ...\n StickyNoteChanged: EnumValue = ...\n StickyNoteCreated: EnumValue = ...\n StickyNoteDeleted: EnumValue = ...\n WorkItemSelectionChanged: EnumValue = ...\n\nclass hdaEventType:\n \"\"\"\n\n hou.hdaEventType\n\n Enumeration of types of events that can happen for digital asset\n libraries.\n\n See hou.hda.addEventCallback.\n\n\n NOTE\n The AssetCreated and AssetDeleted events do not fire when a library\n file is installed or uninstalled.\n\n VALUES\n\n\n AssetCreated\n A new asset was created (using the Create Digital Asset context\n menu item in the network editor or through HOM).\n\n The callback function is called with this event type and the\n following additional argument:\n\n\n asset_definition\n An hou.HDADefinition object representing the newly created\n asset.\n\n AssetDeleted\n An asset was deleted (using the Asset Manager UI or through\n HOM). Note that the asset no longer exists when this event type\n occurs.\n\n The callback function is called with this event type and the\n following additional arguments:\n\n\n asset_name\n A string containing the name of the deleted asset.\n\n library_path\n A string containing the file path of the asset library\n (.hda) file that contained the asset.\n\n node_type_category\n A hou.NodeTypeCategory representing the type category (for\n example, Object, SOP, DOP) of the deleted asset.\n\n AssetSaved\n An asset was saved.\n\n The callback function is called with this event type and the\n following additional argument:\n\n\n asset_definition\n An hou.HDADefinition object representing the saved asset.\n\n BeforeAssetCreated\n A new asset is about to be created (using the Create Digital\n Asset context menu item in the network editor or through HOM).\n\n The callback function is called with this event type and the\n following additional argument:\n\n\n asset_name\n A string containing the name of the asset to be created.\n\n library_path\n A string containing the file path of the asset library\n (.hda) file that will contain the asset.\n\n node_type_category\n A hou.NodeTypeCategory representing the type category (for\n example, Object, SOP, DOP) of the asset to be created.\n\n BeforeAssetDeleted\n An asset is about to be deleted (using the Asset Manager UI or\n through HOM). Note that the asset still exists when this event\n occurs.\n\n The callback function is called with this event type and the\n following additional arguments:\n\n\n asset_definition\n An hou.HDADefinition object representing the asset to be\n deleted.\n\n BeforeAssetSaved\n An asset is about to be saved.\n\n The callback function is called with this event type and the\n following additional argument:\n\n\n asset_definition\n An hou.HDADefinition object representing the asset to be\n saved.\n\n LibraryInstalled\n A digital asset library has been installed into the current\n Houdini session.\n\n The callback function is called with this event type and the\n following additional argument:\n\n\n library_path\n The file path to the installed asset library (.hda) file.\n\n LibraryUninstalled\n A digital asset library has been uninstalled from the current\n Houdini session.\n\n The callback function is called with this event type and the\n following additional argument:\n\n\n library_path\n The file path to the uninstalled asset library (.hda) file.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AssetCreated: EnumValue = ...\n AssetDeleted: EnumValue = ...\n AssetSaved: EnumValue = ...\n BeforeAssetCreated: EnumValue = ...\n BeforeAssetDeleted: EnumValue = ...\n BeforeAssetSaved: EnumValue = ...\n LibraryInstalled: EnumValue = ...\n LibraryUninstalled: EnumValue = ...\n\nclass hipFileEventType:\n \"\"\"\n\n hou.hipFileEventType\n\n Enumeration of the hip file event types that can be handled by callback\n functions.\n\n See hou.hipFile.addEventCallback.\n\n VALUES\n\n\n BeforeClear\n This event is triggered immediately before the current .hip file\n is cleared. For example, when selecting File -> New in the main\n menu bar.\n\n AfterClear\n This event is triggered immediately after the current .hip file\n is cleared. For example, when selecting File -> New in the main\n menu bar.\n\n BeforeLoad\n This event is triggered immediately before a .hip file is loaded\n into Houdini.\n\n AfterLoad\n This event is triggered immediately after a .hip file is loaded\n into Houdini.\n\n BeforeMerge\n This event is triggered immediately before a .hip file is merged\n into the current Houdini session.\n\n AfterMerge\n This event is triggered immediately after a .hip file is merged\n into the current Houdini session.\n\n BeforeSave\n This event is triggered immediately before the current .hip file\n is saved.\n\n AfterSave\n This event is triggered immediately after the current .hip file\n is saved.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AfterClear: EnumValue = ...\n AfterLoad: EnumValue = ...\n AfterMerge: EnumValue = ...\n AfterSave: EnumValue = ...\n BeforeClear: EnumValue = ...\n BeforeLoad: EnumValue = ...\n BeforeMerge: EnumValue = ...\n BeforeSave: EnumValue = ...\n\nclass appearanceChangeType:\n \"\"\"\n\n hou.appearanceChangeType\n\n Enumeration of types of appearance change events that can happen to\n nodes.\n\n See hou.OpNode.addEventCallback.\n\n VALUES\n\n\n Any\n ErrorState\n Pick\n Color\n DeleteScript\n Comment\n LockFlag\n CompressFlag\n OTLMatchState\n ActiveInput\n Connections\n ExpressionLanguage\n NetworkBox\n PostIt\n Dot\n Preview\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ActiveInput: EnumValue = ...\n Any: EnumValue = ...\n Color: EnumValue = ...\n Comment: EnumValue = ...\n CompressFlag: EnumValue = ...\n Connections: EnumValue = ...\n DeleteScript: EnumValue = ...\n Dot: EnumValue = ...\n ErrorState: EnumValue = ...\n ExpressionLanguage: EnumValue = ...\n LockFlag: EnumValue = ...\n NetworkBox: EnumValue = ...\n OTLMatchState: EnumValue = ...\n Pick: EnumValue = ...\n PostIt: EnumValue = ...\n Preview: EnumValue = ...\n\nclass ropRenderEventType:\n \"\"\"\n\n hou.ropRenderEventType\n\n Enumeration of types of events that can happen when a ROP node is\n rendering.\n\n ROP render event callbacks let you run code when a render events occur\n on an individual ROP node instance. See\n hou.RopNode.addRenderEventCallback.\n\n The event callback is called with the hou.RopNode that produced the\n event as the first argument, an enum value from this enum as the second\n argument, and the time value that event occured as the last argument.\n\n VALUES\n\n\n PreRender\n Runs exactly once, before the ROP node begins rendering.\n\n PreFrame\n Runs before each frame is rendered.\n\n PostFrame\n Runs after each frame finishes rendering.\n\n PostWrite\n Runs after output files for a frame have been written to disk.\n This is primarly used with nodes like the , which write output\n files in the background.\n\n PostRender\n Runs exactly once, after the ROP has finished rendering.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n PostFrame: EnumValue = ...\n PostRender: EnumValue = ...\n PostWrite: EnumValue = ...\n PreFrame: EnumValue = ...\n PreRender: EnumValue = ...\n\nclass imageDepth:\n \"\"\"\n\n hou.imageDepth\n\n Enumeration of image depths (data formats) for representing the pixels\n in an image plane.\n\n See hou.Cop2Node.depth.\n\n VALUES\n\n\n Int8\n Int16\n Int32\n Float16\n Float32\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Float16: EnumValue = ...\n Float32: EnumValue = ...\n Int16: EnumValue = ...\n Int32: EnumValue = ...\n Int8: EnumValue = ...\n\nclass imageLayerTypeInfo:\n \"\"\"\n\n hou.imageLayerTypeInfo\n\n Enumeration of ImageLayer TypeInfos\n\n These represent various semantic intepretations of the underlying layer\n data. A 3-tuple may represent things other than RGB.\n\n VALUES\n\n\n hou.imageLayerTypeInfo.Color\n The data is to be interpeted as RGB.\n\n hou.imageLayerTypeInfo.Height\n The data is to be interpeted as a height map. These are usually\n Mono.\n\n hou.imageLayerTypeInfo.ID\n The data is to be interpeted as an ID map. These are usually ID.\n\n hou.imageLayerTypeInfo.Mask\n The data is to be interpeted as 0-1 mask. These are usually\n Mono.\n\n hou.imageLayerTypeInfo.Normal\n The data is to be interpeted as signed normal. These are usually\n RGB. The data is usually -1 to 1 and normalized.\n\n hou.imageLayerTypeInfo.OffsetNormal\n The data is to be interpreted as an offset normal. These are\n usually RGB. The data is usually 0 to 1 and normalized around\n 0.5.\n\n hou.imageLayerTypeInfo.Position\n The data is to be interpreted as an XYZ location. For 3-tuples\n this is a location in space, for 2-tuples it usually implies it\n is in Image space. These are usually UV or RGB.\n\n hou.imageLayerTypeInfo.Raw\n The data is not to be interpreted, no specific type hint is\n present.\n\n hou.imageLayerTypeInfo.SDF\n The data stores the signed distance to a curve. These are\n usually Mono.\n\n hou.imageLayerTypeInfo.Texture\n The data is to be interpreted as an UV location. For 2-tuples it\n usually implies it is in Texture space. These are usually UV.\n\n hou.imageLayerTypeInfo.Vector\n The data is to be interpreted as a direction whose length is the\n magnitude or stretngth. These are usually UV or RGB.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Color: EnumValue = ...\n Height: EnumValue = ...\n ID: EnumValue = ...\n Mask: EnumValue = ...\n Normal: EnumValue = ...\n OffsetNormal: EnumValue = ...\n Position: EnumValue = ...\n Raw: EnumValue = ...\n SDF: EnumValue = ...\n Texture: EnumValue = ...\n Vector: EnumValue = ...\n\nclass imageLayerBorder:\n \"\"\"\n\n hou.imageLayerBorder\n\n Enumeration of ImageLayer Borders\n\n These control how a layer treates attempts to read outside of its\n defined buffer.\n\n VALUES\n\n\n hou.imageLayerBorder.Clamp\n The location is clamped to the nearest valid location in the\n buffer and that value used.\n\n hou.imageLayerBorder.Constant\n A constant value, usually 0, is used if out of bound values are\n read. Note this will cause interpolation to black near the\n borders.\n\n hou.imageLayerBorder.Mirror\n Attempts to read outside are reflected across the border to find\n a valid internal location.\n\n hou.imageLayerBorder.Wrap\n Attempts to read outside will wrap around to the far side.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Clamp: EnumValue = ...\n Constant: EnumValue = ...\n Mirror: EnumValue = ...\n Wrap: EnumValue = ...\n\nclass imageLayerStorageType:\n \"\"\"\n\n hou.imageLayerStorageType\n\n Enumeration of ImageLayer StorageTypes\n\n These store how the pixel values are stored in memory.\n\n VALUES\n\n\n hou.imageLayerStorageType.Float16\n Values are stored in 16-bit floats.\n\n hou.imageLayerStorageType.Float32\n Values are stored in 32-bit floats.\n\n hou.imageLayerStorageType.Int16\n Values are stored in 16-bit integers.\n\n hou.imageLayerStorageType.Int32\n Values are stored in 32-bit integers.\n\n hou.imageLayerStorageType.Int8\n Values are stored in 8-bit integers.\n\n hou.imageLayerStorageType.Fixed8\n Stores fractional values between 0 and 1 using 8 bits of fixed\n precision.\n\n hou.imageLayerStorageType.Fixed16\n Stores fractional values between 0 and 1 using 16 bits of fixed\n precision.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Fixed16: EnumValue = ...\n Fixed8: EnumValue = ...\n Float16: EnumValue = ...\n Float32: EnumValue = ...\n Int16: EnumValue = ...\n Int32: EnumValue = ...\n Int8: EnumValue = ...\n\nclass imageLayerProjection:\n \"\"\"\n\n hou.imageLayerProjection\n\n Enumeration of ImageLayer Projections>\n\n These define the type of projection the camera defined by a layer uses.\n\n VALUES\n\n\n hou.imageLayerProjection.Orthographic\n The projection is an orthographic collapse along the local Z\n direction.\n\n hou.imageLayerProjection.Perspective\n The projection is a perspective transform focusing to the camera\n position.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Orthographic: EnumValue = ...\n Perspective: EnumValue = ...\n\nclass vdbType:\n \"\"\"\n\n hou.vdbType\n\n Enumeration of VDB types\n\n See hou.VDB and hou.NanoVDB.\n\n VALUES\n\n\n Bool\n Double\n Float\n Int32\n Int64\n Invalid\n PointData\n PointIndex\n Vec3d\n Vec3f\n Vec3i\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Bool: EnumValue = ...\n Double: EnumValue = ...\n Float: EnumValue = ...\n Int32: EnumValue = ...\n Int64: EnumValue = ...\n Invalid: EnumValue = ...\n PointData: EnumValue = ...\n PointIndex: EnumValue = ...\n Vec3d: EnumValue = ...\n Vec3f: EnumValue = ...\n Vec3i: EnumValue = ...\n\nclass volumeStorageType:\n \"\"\"\n\n hou.volumeStorageType\n\n Enumeration of Volume StorageTypes\n\n These store how the voxel values are stored in memory.\n\n VALUES\n\n\n hou.volumeStorageType.Float\n Values are stored as floats.\n\n hou.volumeStorageType.Int\n Values are stored as integers.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Float: EnumValue = ...\n Int: EnumValue = ...\n\nclass volumeVisualization:\n \"\"\"\n\n hou.volumeVisualization\n\n Enumeration of Volume Visualization\n\n These store how the volume should be displayed in the viewport.\n\n VALUES\n\n\n hou.volumeVisualization.Smoke\n The volume is displayed as fog or smoke.\n\n hou.volumeVisualization.Rainbow\n The volume is displayed as fog, but the colour is based on\n relative location in the volume. This is deprecated.\n\n hou.volumeVisualization.Iso\n The zero-crossing of the volume is displayed as an iso-surface.\n This is used for SDF visualization.\n\n hou.volumeVisualization.Invisible\n The volume is not to be drawn in the viewport.\n\n hou.volumeVisualization.HeightField\n The volume is drawn as a heightfield. Note it should be a 2d\n volume with 1 resolution in Z.\n\n hou.volumeVisualization.Image\n The volume is drawn as an image. Note it should be a 2d volume\n with 1 resolution in Z.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n HeightField: EnumValue = ...\n Image: EnumValue = ...\n Invisible: EnumValue = ...\n Iso: EnumValue = ...\n Rainbow: EnumValue = ...\n Smoke: EnumValue = ...\n\nclass playMode:\n \"\"\"\n\n hou.playMode\n\n Enumeration of play modes for the main playbar in Houdini.\n\n VALUES\n\n\n Loop\n Play through the frame range and when reaching the end of the\n range loop back to the beginning and continue the playback.\n\n Once\n Play through the frame range and when reaching the end of the\n range stop the playback.\n\n Zigzag\n Play through the frame range and when reaching the end of the\n range reverse the playback. When the reverse playback reaches\n the beginning of the range, then continue playback in the\n forward direction, etc.\n\n Forever\n Play through the frame range and when reaching the end of the\n range keep playing.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Forever: EnumValue = ...\n Loop: EnumValue = ...\n Once: EnumValue = ...\n Zigzag: EnumValue = ...\n\nclass playbarEvent:\n \"\"\"\n\n hou.playbarEvent\n\n Enumeration of the playbar events that can be handled by callback\n functions.\n\n See hou.playbar.addEventCallback.\n\n VALUES\n\n\n Started\n This event is triggered when the playbar has started playback\n either in the forward or reverse direction.\n\n Stopped\n This event is triggered when running playback has stopped.\n\n FrameChanged\n This event is triggered when the playbar has changed to another\n frame and after the scene has been cooked for the new frame.\n\n GlobalFrameRangeChanged\n This event is triggered when the global frame range changes.\n\n PlaybackFrameRangeChanged\n This event is triggered when the playback range changes.\n\n ChannelListChanged\n This event is triggered when channels are added or removed from\n the Channel List.\n\n ScrubStarted\n This event is triggered when a new scrub is started such as when\n pressing the mouse down on the playbar.\n\n ScrubStopped\n This event is triggered when a scrub is finished such as when\n releasing the mouse after dragging on the playbar.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ChannelListChanged: EnumValue = ...\n FrameChanged: EnumValue = ...\n GlobalFrameRangeChanged: EnumValue = ...\n PlaybackFrameRangeChanged: EnumValue = ...\n ScrubStarted: EnumValue = ...\n ScrubStopped: EnumValue = ...\n Started: EnumValue = ...\n Stopped: EnumValue = ...\n\nclass channelListChangedReason:\n \"\"\"\n\n hou.channelListChangedReason\n\n Enumeration of the reasons the hou.playbarEvent.ChannelListChanged event\n can be triggered.\n\n See the onPlaybackChangeEvent viewer state method.\n\n VALUES\n\n\n Replaced\n Triggered when the channel list has been fully replaced.\n\n Filtered\n Triggered when the channel list has been filtered.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Filtered: EnumValue = ...\n Replaced: EnumValue = ...\n\nclass bookmarkEvent:\n \"\"\"\n\n hou.bookmarkEvent\n\n Enumeration of the bookmark events that can be handled by callback\n functions.\n\n See hou.playbar.addBookmarksChangedCallback.\n\n VALUES\n\n\n Created\n This event is triggered when a new bookmark has been created.\n\n Modified\n This event is triggered when a bookmark has been modified.\n\n Deleted\n This event is triggered when a bookmark has been deleted.\n\n Reset\n This event is triggered when the list of bookmarks has been\n reset or cleared, such as when loading a new set of bookmarks\n from a file.\n\n InteractionStarted\n This event is triggered when a new user interaction begins on a\n bookmark, such as dragging it.\n\n InteractionFinished\n This event is triggered when releasing the bookmark after\n interacting with it.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Created: EnumValue = ...\n Deleted: EnumValue = ...\n InteractionFinished: EnumValue = ...\n InteractionStarted: EnumValue = ...\n Modified: EnumValue = ...\n Reset: EnumValue = ...\n\nclass perfMonTimeFormat:\n \"\"\"\n\n hou.perfMonTimeFormat\n\n Enumeration of the different formats used when viewing times in the\n Performance Monitor panetab.\n\n VALUES\n\n\n Absolute\n Percent\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Absolute: EnumValue = ...\n Percent: EnumValue = ...\n\nclass perfMonTimeUnit:\n \"\"\"\n\n hou.perfMonTimeUnit\n\n Enumeration of the different units used when viewing times in the\n Performance Monitor panetab.\n\n VALUES\n\n\n Seconds\n Display times in seconds.\n\n Milliseconds\n Display times in milliseconds.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Milliseconds: EnumValue = ...\n Seconds: EnumValue = ...\n\nclass perfMonObjectView:\n \"\"\"\n\n hou.perfMonObjectView\n\n Enumeration of the different structures that are used to view objects in\n the Performance Monitor panetab.\n\n VALUES\n\n\n List\n Tree\n EventLog\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n EventLog: EnumValue = ...\n List: EnumValue = ...\n Tree: EnumValue = ...\n\nclass compressionType:\n \"\"\"\n\n hou.compressionType\n\n Enumeration of compression types.\n\n VALUES\n\n\n Gzip\n Compress using Gzip.\n\n Blosc\n Compress using Blosc.\n\n NoCompression\n Do not compress.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Blosc: EnumValue = ...\n Gzip: EnumValue = ...\n NoCompression: EnumValue = ...\n\nclass nodeTypeFilter:\n \"\"\"\n\n hou.nodeTypeFilter\n\n Enumeration of available node type filters.\n\n These filters are used by node bundles to limit the nodes in the bundle\n based on type.\n\n VALUES\n\n\n NoFilter\n Any node\n\n Sop\n Any SOP\n\n Dop\n Any DOP\n\n Chop\n Any CHOP\n\n Chopnet\n Any CHOP Network\n\n Cop2\n Any COP2\n\n Copnet\n Any COP2 Network\n\n Vop\n Any VOP\n\n Vopnet\n Any VOP Network\n\n Rop\n Any ROP\n\n Lop\n Any LOP\n\n Top\n Any TOP\n\n Shop\n Any SHOP\n\n Obj\n Any Object\n\n ObjBone\n Object: Bone Only\n\n ObjCamera\n Object: Camera Only\n\n ObjFog\n Object: Fog Only\n\n ObjGeometry\n Object: Geometry Only\n\n ObjGeometryOrFog\n Object: Geometry and Fog Only\n\n ObjLight\n Object: Light Only\n\n ObjMuscle\n Object: Muscle Only\n\n ObjSubnet\n Object: Muscle Only\n\n ShopAtmosphere\n Shop: Atmosphere Only\n\n ShopCVEX\n Shop: CVEX Only\n\n ShopDisplacement\n Shop: Displacement Only\n\n ShopImage3D\n Shop: Image3D Only\n\n ShopInterior\n Shop: Interior Only\n\n ShopLight\n Shop: Light Only\n\n ShopLightShadow\n Shop: Light Shadow Only\n\n ShopMaterial\n Shop: Material Only\n\n ShopPhoton\n Shop: Photon Only\n\n ShopProperties\n Shop: Properties Only\n\n ShopSurface\n Shop: Surface Only\n\n TopScheduler\n Top: Schedulers Only\n\n TopPartitioner\n Top: Partitioners Only\n\n TopProcessor\n Top: Processors Only\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Chop: EnumValue = ...\n Chopnet: EnumValue = ...\n Cop2: EnumValue = ...\n Copnet: EnumValue = ...\n Dop: EnumValue = ...\n Lop: EnumValue = ...\n NoFilter: EnumValue = ...\n Obj: EnumValue = ...\n ObjBone: EnumValue = ...\n ObjCamera: EnumValue = ...\n ObjFog: EnumValue = ...\n ObjGeometry: EnumValue = ...\n ObjGeometryOrFog: EnumValue = ...\n ObjLight: EnumValue = ...\n ObjMuscle: EnumValue = ...\n ObjSubnet: EnumValue = ...\n Rop: EnumValue = ...\n Shop: EnumValue = ...\n ShopAtmosphere: EnumValue = ...\n ShopCVEX: EnumValue = ...\n ShopDisplacement: EnumValue = ...\n ShopImage3D: EnumValue = ...\n ShopInterior: EnumValue = ...\n ShopLight: EnumValue = ...\n ShopLightShadow: EnumValue = ...\n ShopMaterial: EnumValue = ...\n ShopPhoton: EnumValue = ...\n ShopProperties: EnumValue = ...\n ShopSurface: EnumValue = ...\n Sop: EnumValue = ...\n Top: EnumValue = ...\n TopPartitioner: EnumValue = ...\n TopProcessor: EnumValue = ...\n TopScheduler: EnumValue = ...\n Vop: EnumValue = ...\n Vopnet: EnumValue = ...\n\nclass vdbData:\n \"\"\"\n\n hou.vdbData\n\n Enumeration of voxel data types.\n\n See hou.VDB.\n\n VALUES\n\n\n Boolean\n Float\n Int\n Vector3\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Boolean: EnumValue = ...\n Float: EnumValue = ...\n Int: EnumValue = ...\n Vector3: EnumValue = ...\n\nclass lopViewportOverridesLayer:\n \"\"\"\n\n hou.lopViewportOverridesLayer\n\n Specifies a choice between the various pxr.Sdf.Layer objects available\n in a hou.LopViewportOverrides object.\n\n VALUES\n\n\n Base\n Selectable\n SoloLights\n SoloGeometry\n Purpose\n Expansion\n Custom\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Base: EnumValue = ...\n Custom: EnumValue = ...\n Expansion: EnumValue = ...\n Purpose: EnumValue = ...\n Selectable: EnumValue = ...\n SoloGeometry: EnumValue = ...\n SoloLights: EnumValue = ...\n\nclass channelEditorMode:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n\nclass vopParmGenType:\n \"\"\"\n\n hou.vopParmGenType\n\n Enumeration of the different node configurations that can be created for\n the inputs of a VOP node.\n\n See hou.VopNode.insertParmGenerator and\n hou.VopNode.insertParmGeneratorsForAllInputs.\n\n VALUES\n\n\n Constant\n Create a Constant VOP and connect it to the VOP node's input.\n\n Parameter\n Create a Parameter VOP and connect it to the VOP node's input.\n The input parameter is automatically promoted to the VOP\n network's parameter interface.\n\n SubnetInput\n Create a Parameter VOP and connect it to the VOP node's input.\n Additionally set the Parameter VOP's Scope parameter to Subnet.\n The input parameter is automatically promoted to the owning\n Subnet VOP's parameter interface.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Constant: EnumValue = ...\n Parameter: EnumValue = ...\n SubnetInput: EnumValue = ...\n\nclass stateGenerateMode:\n \"\"\"\n\n hou.stateGenerateMode\n\n Enumeration of possible node generation modes by states.\n\n See hou.SceneViewer.setCurrentState for more information.\n\n VALUES\n\n\n Insert\n Branch\n Enter\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Branch: EnumValue = ...\n Enter: EnumValue = ...\n Insert: EnumValue = ...\n\nclass scenePrimMask:\n \"\"\"\n\n hou.scenePrimMask\n\n Scene Graph Selection Mask\n\n Defines the primitive types that can be selected by\n SceneViewer.selectSceneGraph() if the caller wishes to override the\n current scene viewer selection mask.\n\n VALUES\n\n\n hou.scenePrimMask.All\n All primitive types can be selected.\n\n hou.scenePrimMask.Camera\n Only camera primitive types can be selected.\n\n hou.scenePrimMask.Geometry\n Only geometry primitive types can be selected.\n\n hou.scenePrimMask.Light\n Only light primitive types can be selected.\n\n hou.scenePrimMask.LightAndCamera\n Only light and camera primitive types can be selected.\n\n hou.scenePrimMask.ViewerSetting\n Use the viewer setting for the primitive selection mask\n (default).\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n All: EnumValue = ...\n Camera: EnumValue = ...\n Geometry: EnumValue = ...\n Light: EnumValue = ...\n LightAndCamera: EnumValue = ...\n ViewerSetting: EnumValue = ...\n\nclass viewportVisualizerCategory:\n \"\"\"\n\n hou.viewportVisualizerCategory\n\n Enumeration of the different categories of viewport visualizers.\n\n VALUES\n\n\n Common\n Viewport visualizers in the common category are available across\n all scene files.\n\n Scene\n Viewport visualizers in the scene category are saved to the\n scene file and are only available in the specific scene file in\n which they are created or saved.\n\n Node\n Node visualizers are installed on individual nodes in Houdini\n and have a limited scope.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Common: EnumValue = ...\n Node: EnumValue = ...\n Scene: EnumValue = ...\n\nclass viewportVisualizerScope:\n \"\"\"\n\n hou.viewportVisualizerScope\n\n Enumeration of the different scopes of viewport visualizers.\n\n VALUES\n\n\n NodeOnly\n The visualizer affects only the geometry produced by the node on\n which it is installed. This value only applies to visualizers in\n the hou.viewportVisualizerCategory.Node category.\n\n SameNetworkTypeDescendents\n The visualizer affects only the geometries produced by the node\n and its descendent nodes of the same network type. This value\n only applies to visualizers in the\n hou.viewportVisualizerCategory.Node category.\n\n AllDescendents\n The visualizer affects the geometries produced by the node and\n its descendent nodes regardless of the network type. This value\n only applies to visualizers in the\n hou.viewportVisualizerCategory.Node category.\n\n Global\n The visualizer affects any geometry that is displayed in the\n viewport. This value only applies to visualizers in the\n hou.viewportVisualizerCategory.Common and\n hou.viewportVisualizerCategory.Scene categories.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AllDescendents: EnumValue = ...\n Global: EnumValue = ...\n NodeOnly: EnumValue = ...\n SameNetworkTypeDescendents: EnumValue = ...\n\nclass viewportVisualizerEventType:\n \"\"\"\n\n hou.viewportVisualizerEventType\n\n Enumeration of types of events that can happen to viewport visualizers.\n\n Viewport visualizer callbacks let you run code when events occur on\n visualizers in individual categories. See\n hou.viewportVisualizers.addEventCallback.\n\n For all event types, the callback is called with an event_type keyword\n argument (containing one of the values below, indicating the type of\n event that occurred).\n\n Some event types pass additional keyword arguments to the callback\n function, as noted below.\n\n VALUES\n\n\n VisualizerCreated\n Runs after a new visualizer is created.\n\n Extra keyword argument: visualizer (hou.ViewportVisualizer)\n\n VisualizerDeleted\n Runs after a visualizer has been removed from a category, but\n before it has been deleted. You cannot cancel the deletion.\n\n Extra keyword argument: visualizer (hou.ViewportVisualizer)\n\n VisualizerMountChanged\n Runs after a visualizer setting related to its mount, like the\n name or the scope, has changed.\n\n Extra keyword argument: visualizer (hou.ViewportVisualizer)\n\n VisualizerParmsChanged\n Runs after a visualizer's parameters have changed.\n\n Extra keyword argument: visualizer (hou.ViewportVisualizer)\n\n VisualizerFlagsChanged\n Runs after a visualizer's flags have changed.\n\n Extra keyword argument: visualizer (hou.ViewportVisualizer)\n\n VisualizerActiveChanged\n Runs after a visualizer's active state has changed.\n\n Extra keyword argument: visualizer (hou.ViewportVisualizer)\n\n CategoryActiveChanged\n Runs after a visualizer category's active state has changed.\n\n Extra keyword argument: category\n (hou.ViewportVisualizerCategory) Extra keyword argument:\n category_node (hou.OpNode)\n\n CategoryDeleted\n Runs after a visualizer category has been destroyed.\n\n Extra keyword argument: category\n (hou.ViewportVisualizerCategory) Extra keyword argument:\n category_node (hou.OpNode)\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CategoryActiveChanged: EnumValue = ...\n CategoryDeleted: EnumValue = ...\n VisualizerActiveChanged: EnumValue = ...\n VisualizerCreated: EnumValue = ...\n VisualizerDeleted: EnumValue = ...\n VisualizerFlagsChanged: EnumValue = ...\n VisualizerMountChanged: EnumValue = ...\n VisualizerParmsChanged: EnumValue = ...\n\nclass nodeFlag:\n \"\"\"\n\n hou.nodeFlag\n\n Enumeration of the different node flags.\n\n VALUES\n\n\n Audio\n Bypass\n ColorDefault\n Compress\n Current\n Debug\n Display\n DisplayComment\n DisplayDescriptiveName\n Export\n Expose\n Footprint\n Highlight\n InOutDetailLow\n InOutDetailMedium\n InOutDetailHigh\n Material\n Lock\n SoftLock\n Origin\n OutputForDisplay\n Pick\n Render\n Selectable\n Template\n Unload\n Visible\n XRay\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Audio: EnumValue = ...\n Bypass: EnumValue = ...\n ColorDefault: EnumValue = ...\n Compress: EnumValue = ...\n Current: EnumValue = ...\n Debug: EnumValue = ...\n Display: EnumValue = ...\n DisplayComment: EnumValue = ...\n DisplayDescriptiveName: EnumValue = ...\n Export: EnumValue = ...\n Expose: EnumValue = ...\n Footprint: EnumValue = ...\n Highlight: EnumValue = ...\n InOutDetailHigh: EnumValue = ...\n InOutDetailLow: EnumValue = ...\n InOutDetailMedium: EnumValue = ...\n Lock: EnumValue = ...\n Material: EnumValue = ...\n Origin: EnumValue = ...\n OutputForDisplay: EnumValue = ...\n Pick: EnumValue = ...\n Render: EnumValue = ...\n Selectable: EnumValue = ...\n SoftLock: EnumValue = ...\n Template: EnumValue = ...\n Unload: EnumValue = ...\n Visible: EnumValue = ...\n XRay: EnumValue = ...\n\nclass nodeFootprint:\n \"\"\"\n\n hou.nodeFootprint\n\n Enumeration of the specialized node footprints supported by the network\n editor.\n\n These values can be used to initialize a hou.NetworkFootprint object to\n be passed to a hou.NetworkEditor object specifying which nodes should be\n drawn with footprint circles around them.\n\n VALUES\n\n\n InsertionPoint\n Draw a footprint around the LOP node that is currently set as\n the insertion point on the containing LOP Network.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n InsertionPoint: EnumValue = ...\n\nclass fbxCompatibilityMode:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n FBXStandard: EnumValue = ...\n Maya: EnumValue = ...\n\nclass fbxMaterialMode:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n FBXShaderNodes: EnumValue = ...\n PrincipledShaders: EnumValue = ...\n VopNetworks: EnumValue = ...\n\nclass saveMode:\n \"\"\"\n\n hou.saveMode\n\n Enumeration of hip file save modes.\n\n VALUES\n\n\n Text\n Save in an ASCII format that is friendly to version control and\n can be viewed and edited as plain text. This format is\n compatible with Houdini 16 and above only and is only available\n with a full commercial license.\n\n Binary\n Traditional binary hip file format. This is both smaller and\n more performant than the text format.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Binary: EnumValue = ...\n Text: EnumValue = ...\n\nclass radialItemType:\n \"\"\"\n\n hou.radialItemType\n\n Enumeration of types for radial menu items in Houdini.\n\n VALUES\n\n\n Script\n Specifies a script radial menu item.\n\n Submenu\n Specifies a submenu radial menu item.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Script: EnumValue = ...\n Submenu: EnumValue = ...\n\nclass radialItemLocation:\n \"\"\"\n\n hou.radialItemLocation\n\n Enumeration of locations for radial menu items in Houdini.\n\n VALUES\n\n\n Top\n Specifies top location of a radial menu item.\n\n TopLeft\n Specifies top left location of a radial menu item.\n\n Left\n Specifies left location of a radial menu item.\n\n BottomLeft\n Specifies bottom left location of a radial menu item.\n\n Bottom\n Specifies bottom location of a radial menu item.\n\n BottomRight\n Specifies bottom right location of a radial menu item.\n\n Right\n Specifies right location of a radial menu item.\n\n TopRight\n Specifies top right location of a radial menu item.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Bottom: EnumValue = ...\n BottomLeft: EnumValue = ...\n BottomRight: EnumValue = ...\n Left: EnumValue = ...\n Right: EnumValue = ...\n Top: EnumValue = ...\n TopLeft: EnumValue = ...\n TopRight: EnumValue = ...\n\nclass valueLadderType:\n \"\"\"\n\n hou.valueLadderType\n\n Enumeration of the different value ladder types.\n\n See hou.ui.openValueLadder.\n\n VALUES\n\n\n Generic\n The ladder is being used to manipulate a generic numeric value.\n The step sizes for this ladder type range from 0.0001 to 100.0.\n\n Angle\n The ladder is being used to manipulate a value representing an\n angle. The step sizes for this ladder type range from 1.0 to\n 45.0.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Angle: EnumValue = ...\n Generic: EnumValue = ...\n\nclass valueLadderDataType:\n \"\"\"\n\n hou.valueLadderDataType\n\n Enumeration of the different data types that may be manipulated by a\n value ladder.\n\n See hou.ui.openValueLadder.\n\n VALUES\n\n\n Float\n The ladder is being used to manipulate a single floating point\n value.\n\n Int\n The ladder is being used to manipulate a single integer value.\n\n FloatArray\n The ladder is being used to manipulate an array of floating\n point values.\n\n IntArray\n The ladder is being used to manipulate an array of integer\n values.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Float: EnumValue = ...\n FloatArray: EnumValue = ...\n Int: EnumValue = ...\n IntArray: EnumValue = ...\n\nclass promptMessageType:\n \"\"\"\n\n hou.promptMessageType\n\n Viewport Prompt Message Type\n\n Defines the type of messages that can be used with\n hou.SceneViewer.setPromptMessage.\n\n VALUES\n\n\n hou.promptMessageType.Error\n Specifies an error message displayed in bold red.\n\n hou.promptMessageType.Message\n Specifies a regular message displayed in black.\n\n hou.promptMessageType.Prompt\n Specifies a prompt message displayed in bold blue.\n\n hou.promptMessageType.Warning\n Specifies a warning message displayed in bold yellow.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Error: EnumValue = ...\n Message: EnumValue = ...\n Prompt: EnumValue = ...\n Warning: EnumValue = ...\n\nclass drawableDisplayMode:\n \"\"\"\n\n hou.drawableDisplayMode\n\n Enumerator for the drawable display mode.\n\n VALUES\n\n\n hou.drawableDisplayMode.CurrentViewportMode\n Specifies the display mode currently active in the viewport.\n\n hou.drawableDisplayMode.WireframeMode\n Specifies the display mode as wireframe.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CurrentViewportMode: EnumValue = ...\n WireframeMode: EnumValue = ...\n\nclass scaleInheritanceMode:\n \"\"\"\n\n hou.scaleInheritanceMode\n\n Enumeration of scale inheritance modes for transforms.\n\n VALUES\n\n\n Default\n Simple inheritance: world = local * parent_world\n\n OffsetOnly\n Child doesn't scale with the parent local scales, but local\n translation is scaled: world = local_scale_rotates *\n parent_local_scales.inverted() * local_translates * parent_world\n\n OffsetAndScale\n Local translation is scaled as before but parent local scaling\n is also reapplied by the child in local space: world =\n parent_local_scales * local_scale_rotates *\n parent_local_scales.inverted() * local_translates * parent_world\n\n ScaleOnly\n Local translation is not scaled, but parent local scaling is\n reapplied by the child in local space: world =\n parent_local_scales * local * parent_local_scales.inverted() *\n parent_world\n\n Ignore\n Child completely ignores any parent local scaling: world = local\n * parent_local_scales.inverted() * parent_world\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Default: EnumValue = ...\n Ignore: EnumValue = ...\n OffsetAndScale: EnumValue = ...\n OffsetOnly: EnumValue = ...\n ScaleOnly: EnumValue = ...\n\nclass uiEventValueType:\n \"\"\"\n\n hou.uiEventValueType\n\n Enumerator for UI event value types.\n\n Represents the type of value stored in a hou.UIEvent object.\n\n VALUES\n\n\n hou.uiEventValueType.Float\n float value type.\n\n hou.uiEventValueType.FloatArray\n Array of float values.\n\n hou.uiEventValueType.IntArray\n Array of int values.\n\n hou.uiEventValueType.Integer\n int value type.\n\n hou.uiEventValueType.NoType\n invalid value type.\n\n hou.uiEventValueType.String\n string value type.\n\n hou.uiEventValueType.StringArray\n Array of string values.\n\n RELATED\n\n hou.UIEvent.valueType\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Float: EnumValue = ...\n FloatArray: EnumValue = ...\n IntArray: EnumValue = ...\n Integer: EnumValue = ...\n NoType: EnumValue = ...\n String: EnumValue = ...\n StringArray: EnumValue = ...\n\nclass uiEventReason:\n \"\"\"\n\n hou.uiEventReason\n\n Values representing reasons Houdini generated a particular UI event.\n\n Calling hou.UIEvent.reason returns one of the following values.\n\n VALUES\n\n\n Picked\n Quick mouse click without dragging.\n\n Start\n Left mouse button pressed (mouse down)\n\n Active\n Mouse dragged with the left mouse button down.\n\n Changed\n Left mouse button released (mouse up).\n\n Located\n Mouse pointer hovered over something in the interface. In a\n viewer state, this is the reason associated with mouse moves.\n\n ItemsChanged\n Event generated as a change of values in hou.UIEvent\n\n New\n Event generated when a UI element was assigned a different\n value.\n\n RangeChanged\n Event generated when a slider or scrollbar has changed.\n\n NoReason\n Event was likely explicitly generated.\n\n RELATED\n\n hou.UIEvent.reason\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Active: EnumValue = ...\n Changed: EnumValue = ...\n ItemsChanged: EnumValue = ...\n Located: EnumValue = ...\n New: EnumValue = ...\n NoReason: EnumValue = ...\n Picked: EnumValue = ...\n RangeChanged: EnumValue = ...\n Start: EnumValue = ...\n\nclass drawablePrimitive:\n \"\"\"\n\n hou.drawablePrimitive\n\n Enumerator for the drawable primitive types.\n\n VALUES\n\n\n hou.drawablePrimitive.Circle\n hou.drawablePrimitive.Sphere\n hou.drawablePrimitive.Tube\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Circle: EnumValue = ...\n Sphere: EnumValue = ...\n Tube: EnumValue = ...\n\nclass resourceEventMessage:\n \"\"\"\n\n hou.resourceEventMessage\n\n Enumeration of the resource events that can be handled by callback\n functions.\n\n See hou.ui.addResourceEventCallback.\n\n VALUES\n\n\n OnActivate\n Event triggered after a viewer handle has been activated.\n\n OnCustomEvent\n Event triggered when hou.ui.fireResourceCustomEvent is called.\n\n OnDeactivate\n Event triggered after a viewer handle has been deactivated.\n\n OnExit\n Event triggered after a viewer state ends.\n\n OnEnter\n Event triggered after a viewer state begins.\n\n OnExit\n Event triggered after a viewer state ends.\n\n OnGenerate\n Event triggered after a nodeless viewer state begins.\n\n OnInterrupt\n Event triggered after a viewer state has been interrupted.\n\n OnLoad\n Event triggered after a package has been successsfully loaded.\n\n OnPreEnter\n Event triggered before a viewer state begins.\n\n OnPrintMessage\n Event triggered when hou.ui.printViewerStateMessage is called.\n\n OnReload\n Event triggered after a viewer state or package has been\n successsfully reloaded.\n\n OnResume\n Event triggered after a viewer state has resumed after an\n interruption.\n\n OnRegister\n Event triggered after a viewer state has been successfully\n registered.\n\n OnUnload\n Event triggered after a package has been successsfully unloaded.\n\n OnUnregister\n Event triggered after a viewer state has been successfully un-\n registered.\n\n OnRuntimeError\n Event triggered when a runtime error occurs during a viewer\n state operation.\n\n NoEventType\n An invalid viewer state event type.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NoEventType: EnumValue = ...\n OnActivate: EnumValue = ...\n OnCustomEvent: EnumValue = ...\n OnDeactivate: EnumValue = ...\n OnEnter: EnumValue = ...\n OnExit: EnumValue = ...\n OnGenerate: EnumValue = ...\n OnInterrupt: EnumValue = ...\n OnLoad: EnumValue = ...\n OnPreEnter: EnumValue = ...\n OnPrintMessage: EnumValue = ...\n OnRegister: EnumValue = ...\n OnReload: EnumValue = ...\n OnResume: EnumValue = ...\n OnRuntimeError: EnumValue = ...\n OnUnload: EnumValue = ...\n OnUnregister: EnumValue = ...\n\nclass snappingPriority:\n \"\"\"\n\n hou.snappingPriority\n\n Enumeration of snapping priority.\n\n See hou.SceneViewer.snappingPriority.\n\n VALUES\n\n\n GeoEdge\n Edge between two GeoPoints\n\n GeoPoint\n Point on a geometry\n\n Midpoint\n Midpoint of a GeoEdge\n\n GeoPrim\n Primitive on a geometry\n\n Breakpoint\n Control point on a NURBS curve or surface\n\n GridPoint\n Point on the construction plane, reference plane, or on the grid\n in the ortho/uv viewports\n\n GridEdge\n Edge of the construction plane, reference plane, or of the grid\n in the ortho/uv viewports\n\n PrimGuidePoint\n Point on the guide geometry for a primitive sphere/tube/etc.\n\n PrimGuideEdge\n Edge on the guide geometry for a primitive sphere/tube/etc.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Breakpoint: EnumValue = ...\n GeoEdge: EnumValue = ...\n GeoPoint: EnumValue = ...\n GeoPrim: EnumValue = ...\n GridEdge: EnumValue = ...\n GridPoint: EnumValue = ...\n Midpoint: EnumValue = ...\n PrimGuideEdge: EnumValue = ...\n PrimGuidePoint: EnumValue = ...\n\nclass triggerSelectorAction:\n \"\"\"\n\n hou.triggerSelectorAction\n\n Enumerator representing the type of action a state selector can perform\n if triggered with hou.SceneViewer.triggerStateSelector.\n\n VALUES\n\n\n Start\n Activate a selector.\n\n Stop\n Deactivate a selector.\n\n Toggle\n Start or stop a selector depending of the current selector\n state. If currently stopped, the selector is started otherwise\n it is stopped.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Start: EnumValue = ...\n Stop: EnumValue = ...\n Toggle: EnumValue = ...\n\nclass drawableGeometryType:\n \"\"\"\n\n hou.drawableGeometryType\n\n Enumeration of Geometry Drawable types.\n\n See hou.AdvancedDrawable See hou.GeometryDrawable\n\n VALUES\n\n\n Face\n Face drawable type. This drawable allows you to highlight the\n polygons of the attached geometry.\n\n Line\n Line drawable type. This drawable allows you to highlight the\n polygon edges of the attached geometry.\n\n Point\n Point drawable type. This drawable allows you to highlight the\n polygon vertices of the attached geometry.\n\n Vector\n Vector drawable type. This drawable works with point geometries\n and allows you to draw vectors at each point. Note that a point\n attribute N is required for the Vector drawable type.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Face: EnumValue = ...\n Line: EnumValue = ...\n Point: EnumValue = ...\n Vector: EnumValue = ...\n\nclass drawableTextOrigin:\n \"\"\"\n\n hou.drawableTextOrigin\n\n Enumeration used with hou.TextDrawable to specify the reference point of\n the text within its bounding box.\n\n VALUES\n\n\n BottomLeft\n Set the text reference point at the bottom left position of the\n bounding box.\n\n BottomCenter\n Set the text reference point at the bottom center position of\n the bounding box.\n\n BottomRight\n Set the text reference point at the bottom right position of the\n bounding box.\n\n LeftCenter\n Set the text reference point at the left center position of the\n bounding box.\n\n RightCenter\n Set the text reference point at the right center position of the\n bounding box.\n\n UpperLeft\n Set the text reference point at the upper left position of the\n bounding box.\n\n UpperCenter\n Set the text reference point at the upper center position of the\n bounding box.\n\n UpperRight\n Set the text reference point at the upper right position of the\n bounding box.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n BottomCenter: EnumValue = ...\n BottomLeft: EnumValue = ...\n BottomRight: EnumValue = ...\n LeftCenter: EnumValue = ...\n RightCenter: EnumValue = ...\n UpperCenter: EnumValue = ...\n UpperLeft: EnumValue = ...\n UpperRight: EnumValue = ...\n\nclass drawableGeometryFaceStyle:\n \"\"\"\n\n hou.drawableGeometryFaceStyle\n\n Enumeration used with hou.GeometryDrawable to specify the style of faces\n to draw.\n\n VALUES\n\n\n Plain\n Regular face\n\n Checker\n Draws faces in a checker patterm.\n\n Circle\n Draws faces in a circle patterm.\n\n Columns\n Draws faces in columns.\n\n Rows\n Draws faces in rows.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Checker: EnumValue = ...\n Circle: EnumValue = ...\n Columns: EnumValue = ...\n Plain: EnumValue = ...\n Rows: EnumValue = ...\n\nclass drawableGeometryLineStyle:\n \"\"\"\n\n hou.drawableGeometryLineStyle\n\n Enumeration used with hou.GeometryDrawable to specify the style of lines\n to draw.\n\n VALUES\n\n\n Plain\n Regular line.\n\n Dash1\n Draw half of the line.\n\n Dash2\n Draw one third of the line.\n\n Dash3\n Draw one quarter of the line.\n\n Dot1\n Draw a continuous line of dots.\n\n Dot2\n Draw every second dot.\n\n Dot3\n Draw every fourth dot.\n\n Dot4\n Draw every eighth dot.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Dash1: EnumValue = ...\n Dash2: EnumValue = ...\n Dash3: EnumValue = ...\n Dot1: EnumValue = ...\n Dot2: EnumValue = ...\n Dot3: EnumValue = ...\n Dot4: EnumValue = ...\n Plain: EnumValue = ...\n\nclass drawableGeometryPointStyle:\n \"\"\"\n\n hou.drawableGeometryPointStyle\n\n Enumeration used with hou.GeometryDrawable to specify the style of\n points to draw.\n\n VALUES\n\n\n LinearCircle\n Linear circle\n\n LinearSquare\n Linear square\n\n LinearDiamond\n Linear Diamond\n\n RingsCircle\n Circular rings\n\n RingsSquare\n Square rings\n\n RingsDiamond\n Rings Diamond\n\n SmoothCircle\n Smooth circle\n\n SmoothSquare\n Smooth square\n\n SmoothDiamond\n Smooth Diamond\n\n ArrowUp\n Arrow pointing up.\n\n Cross\n Cross\n\n Cube\n 3D cube\n\n Diamond\n Diamond shape\n\n Diamond2\n Diamond shape with dash lines.\n\n Diamond3\n Diamond-cross shape with dash lines.\n\n Flare\n Flare shape.\n\n Frame\n Simple frame.\n\n Frame2\n Frame with dash lines.\n\n Frame3\n Frame with dotted line.\n\n Locate\n Locate-arrow shape.\n\n Locate2\n Simple locate shape.\n\n Plus\n Plus sign.\n\n Ring\n Simple ring.\n\n Ring2\n Simple ring with dashed line.\n\n Ring3\n Two color ring.\n\n Ring4\n Ring with triple lines.\n\n Ring5\n Dotted ring.\n\n Target1\n Target shape 1.\n\n Target2\n Target shape 2.\n\n Target3\n Target shape 3.\n\n Target4\n Target shape 4.\n\n TriangleDown\n Triangle pointing down.\n\n TriangleUp\n Triangle pointing up.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ArrowUp: EnumValue = ...\n Cross: EnumValue = ...\n Cube: EnumValue = ...\n Diamond: EnumValue = ...\n Diamond2: EnumValue = ...\n Diamond3: EnumValue = ...\n Flare: EnumValue = ...\n Frame: EnumValue = ...\n Frame2: EnumValue = ...\n Frame3: EnumValue = ...\n LinearCircle: EnumValue = ...\n LinearDiamond: EnumValue = ...\n LinearSquare: EnumValue = ...\n Locate: EnumValue = ...\n Locate2: EnumValue = ...\n Plus: EnumValue = ...\n Ring: EnumValue = ...\n Ring2: EnumValue = ...\n Ring3: EnumValue = ...\n Ring4: EnumValue = ...\n Ring5: EnumValue = ...\n RingsCircle: EnumValue = ...\n RingsDiamond: EnumValue = ...\n RingsSquare: EnumValue = ...\n SmoothCircle: EnumValue = ...\n SmoothDiamond: EnumValue = ...\n SmoothSquare: EnumValue = ...\n Target1: EnumValue = ...\n Target2: EnumValue = ...\n Target3: EnumValue = ...\n Target4: EnumValue = ...\n TriangleDown: EnumValue = ...\n TriangleUp: EnumValue = ...\n\nclass drawableRampClamp:\n \"\"\"\n\n hou.drawableRampClamp\n\n Enumeration used with hou.GeometryDrawable to specify how to wrap the\n texture generated when using a ramp color (similar to OpenGL texture\n settings).\n\n VALUES\n\n\n Border\n Border texture clamping.\n\n Edge\n Edge texture clamping.\n\n Mirror\n Mirror repeat texture clamping.\n\n Repeat\n Repeat texture clamping.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Border: EnumValue = ...\n Edge: EnumValue = ...\n Mirror: EnumValue = ...\n Repeat: EnumValue = ...\n\nclass drawableHighlightMode:\n \"\"\"\n\n hou.drawableHighlightMode\n\n Enumeration used with hou.AdvancedDrawable to specify the highlight mode\n of a drawable matte.\n\n VALUES\n\n\n Glow\n Display the drawable with a glow by using the color2 parameter.\n\n Matte\n Display the drawable matte only by using the color1 parameter.\n\n GlowMinusMatte\n Display a glow around the drawable without drawing the matte,\n typically used to draw a silhouette.\n\n MatteOverGlow\n Display the matte over the glow.\n\n Transparent\n Make the drawable completely transparent. Useful to hide parts\n of other drawables.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Glow: EnumValue = ...\n GlowMinusMatte: EnumValue = ...\n Matte: EnumValue = ...\n MatteOverGlow: EnumValue = ...\n Transparent: EnumValue = ...\n\nclass secureSelectionOption:\n \"\"\"\n\n hou.secureSelectionOption\n\n Enumeration of the secure selection options used by viewer state\n selectors.\n\n Used by:\n\n * hou.ViewerStateTemplate.bindGeometrySelector\n\n * hou.ViewerStateTemplate.bindObjectSelector\n\n * hou.ViewerStateTemplate.bindSceneGraphSelector\n\n * hou.ViewerStateTemplate.bindDynamicsSelector\n\n * hou.ViewerStateTemplate.bindDynamicsPointSelector\n\n * hou.ViewerStateTemplate.bindDynamicsPolygonSelector\n\n VALUES\n\n\n Ignore\n Selector ignores the viewer's secure selection setting.\n\n Obey\n Selector obeys the viewer's secure selection setting.\n\n On\n Selector sets the viewer's secure selection to On when it\n starts.\n\n Off\n Selector sets the viewer's secure selection to Off when it\n starts.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Ignore: EnumValue = ...\n Obey: EnumValue = ...\n Off: EnumValue = ...\n On: EnumValue = ...\n\nclass resourceType:\n \"\"\"\n\n hou.resourceType\n\n Enumeration of resources such as viewer states and viewer handles.\n\n See hou.ui.addResourceEventCallback\n\n VALUES\n\n\n ViewerState\n Viewer State resource.\n\n ViewerHandle\n Viewer Handle resource.\n\n Package\n Package resource.\n\n NoType\n Not a valid type.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NoType: EnumValue = ...\n Package: EnumValue = ...\n ViewerHandle: EnumValue = ...\n ViewerState: EnumValue = ...\n\nclass geometryViewportEvent:\n \"\"\"\n\n hou.geometryViewportEvent\n\n Enumeration of the geometry viewport events that can be handled by\n callback functions.\n\n See hou.GeometryViewport.addEventCallback.\n\n VALUES\n\n\n CameraSwitched\n This event is triggered when the viewport camera has been\n switched to a different one.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n CameraSwitched: EnumValue = ...\n\nclass sceneViewerEvent:\n \"\"\"\n\n hou.sceneViewerEvent\n\n Enumeration of the UI events a scene viewer can listen to via a\n callback.\n\n See hou.SceneViewer.addEventCallback.\n\n VALUES\n\n\n BeginResize\n Sent when the user has started resizing a viewer window when\n dragging the viewer frame.\n\n EndResize\n This event is sent when the user has ended resizing a viewer\n window when dragging the viewer frame.\n\n Resizing\n This event is sent whenever a viewer window is being resized\n interactively.\n\n SizeChanged\n This event is sent whenever a viewer window size has changed.\n\n LayoutChanged\n Sent when the viewport layout has been changed.\n\n ColorSchemeChanged\n Sent when the viewer color scheme has changed. The color scheme\n can be changed in the Display options.\n\n SelectedViewportChanged\n Sent when a viewport has been selected. Viewports can be\n selected by holding [Space] and pressing the [N] key.\n\n ViewerActivated\n Sent when a viewer panel tab is selected.\n\n ViewerDeactivated\n Sent when a viewer panel tab is deselected.\n\n ViewerTerminated\n Sent when a viewer is terminated as a result of a pane, pane tab\n or floating panel being closed.\n\n StateInterrupted\n Sent when a viewer state is interrupted. Moving the mouse\n outside a viewer will trigger this event.\n\n StateResumed\n Sent when a viewer state is resumed. Moving the mouse inside a\n viewer will trigger this event.\n\n StateEntered\n Sent when a viewer state has entered.\n\n StateExited\n Sent when a viewer state has exited.\n\n PrefChanged\n Sent when a preference has been changed.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n BeginResize: EnumValue = ...\n ColorSchemeChanged: EnumValue = ...\n EndResize: EnumValue = ...\n LayoutChanged: EnumValue = ...\n PrefChanged: EnumValue = ...\n Resizing: EnumValue = ...\n SelectedViewportChanged: EnumValue = ...\n SizeChanged: EnumValue = ...\n StateEntered: EnumValue = ...\n StateExited: EnumValue = ...\n StateInterrupted: EnumValue = ...\n StateResumed: EnumValue = ...\n ViewerActivated: EnumValue = ...\n ViewerDeactivated: EnumValue = ...\n ViewerTerminated: EnumValue = ...\n\nclass hudInfoState:\n \"\"\"\n\n hou.hudInfoState\n\n Enumeration of states for controling the hou.hudPanel.ToolInfo panel.\n\n See hou.SceneViewer.hudInfo.\n\n VALUES\n\n\n Maximize\n Use this state to maximize the panel display.\n\n Minimize\n Use this state to minimize the panel display.\n\n Toggle\n Switch between the Minimize and Maximize state.\n\n NoState\n Not a valid state.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Maximize: EnumValue = ...\n Minimize: EnumValue = ...\n NoState: EnumValue = ...\n Toggle: EnumValue = ...\n\nclass hudPanel:\n \"\"\"\n\n hou.hudPanel\n\n Enumeration to identify the HUD panel types.\n\n See hou.SceneViewer.hudInfo.\n\n VALUES\n\n\n ToolInfo\n Panel for displaying settings and usage hints for the running\n state. The HUD is located at the viewport top-left.\n\n User\n Displays user-defined information. The User HUD is located at\n the viewport bottom-left.\n\n NoPanel\n Not a valid panel.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n NoPanel: EnumValue = ...\n ToolInfo: EnumValue = ...\n User: EnumValue = ...\n\nclass drawable2DType:\n \"\"\"\n\n hou.drawable2DType\n\n Enumerator for 2D drawable types.\n\n See hou.Drawable2D\n\n VALUES\n\n\n hou.drawable2DType.Arc\n Arc drawable type.\n\n hou.drawable2DType.Circle\n Circle drawable type.\n\n hou.drawable2DType.Marker\n Marker drawable type.\n\n hou.drawable2DType.Icon\n Icon drawable type.\n\n hou.drawable2DType.Line\n Line drawable type.\n\n hou.drawable2DType.Shape\n Drawable type for drawing an open or closed shape.\n\n hou.drawable2DType.Rect\n Rectangle drawable type.\n\n hou.drawable2DType.Text\n Drawable type for displaying text.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Arc: EnumValue = ...\n Circle: EnumValue = ...\n Icon: EnumValue = ...\n Line: EnumValue = ...\n Marker: EnumValue = ...\n Rect: EnumValue = ...\n Shape: EnumValue = ...\n Text: EnumValue = ...\n\nclass drawable2DCapStyle:\n \"\"\"\n\n hou.drawable2DCapStyle\n\n Enumerator for 2D drawable cap styles.\n\n See hou.Drawable2D\n\n VALUES\n\n\n hou.drawable2DCapStyle.Arrow\n Filled arrow shape type.\n\n hou.drawable2DCapStyle.BackwardArrow\n Filled arrow shape type drawn backward.\n\n hou.drawable2DCapStyle.Bar\n Vertical bar shape type.\n\n hou.drawable2DCapStyle.Butt\n No shape attached to the drawable.\n\n hou.drawable2DCapStyle.Diamond\n Filled diamond shape type.\n\n hou.drawable2DCapStyle.Dot\n Filled circle shape type.\n\n hou.drawable2DCapStyle.HollowArrow\n Unfilled arrow shape type.\n\n hou.drawable2DCapStyle.HollowBackwardArrow\n Unfilled arrow shape type drawn backward.\n\n hou.drawable2DCapStyle.HollowDiamond\n Unfilled diamond shape type.\n\n hou.drawable2DCapStyle.HollowDot\n Unfilled circle shape type.\n\n hou.drawable2DCapStyle.HollowSquare\n Unfilled square shape type.\n\n hou.drawable2DCapStyle.Square\n Filled square shape type.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Arrow: EnumValue = ...\n BackwardArrow: EnumValue = ...\n Bar: EnumValue = ...\n Butt: EnumValue = ...\n Diamond: EnumValue = ...\n Dot: EnumValue = ...\n HollowArrow: EnumValue = ...\n HollowBackwardArrow: EnumValue = ...\n HollowDiamond: EnumValue = ...\n HollowDot: EnumValue = ...\n HollowSquare: EnumValue = ...\n Square: EnumValue = ...\n\nclass drawable2DLineStyle:\n \"\"\"\n\n hou.drawable2DLineStyle\n\n Enumerator for 2D drawable line styles.\n\n See hou.Drawable2D\n\n VALUES\n\n\n hou.drawable2DLineStyle.Dashed\n Draw lines with a dashed line style.\n\n hou.drawable2DLineStyle.Solid\n Draw lines with a solid line style.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Dashed: EnumValue = ...\n Solid: EnumValue = ...\n\nclass drawable2DMarkerSize:\n \"\"\"\n\n hou.drawable2DMarkerSize\n\n Enumerator for 2D drawable marker size.\n\n See hou.Drawable2D\n\n VALUES\n\n\n hou.drawable2DMarkerSize.Large\n Large marker drawable size.\n\n hou.drawable2DMarkerSize.Medium\n Medium marker drawable size.\n\n hou.drawable2DMarkerSize.Tiny\n Tiny marker drawable size.\n\n hou.drawable2DMarkerSize.Small\n Small marker drawable size.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Large: EnumValue = ...\n Medium: EnumValue = ...\n Small: EnumValue = ...\n Tiny: EnumValue = ...\n\nclass drawable2DMarkerStyle:\n \"\"\"\n\n hou.drawable2DMarkerStyle\n\n Enumerator for 2D drawable marker style.\n\n See hou.Drawable2D\n\n VALUES\n\n\n hou.drawable2DMarkerStyle.Cross\n Cross shape type.\n\n hou.drawable2DMarkerStyle.Diamond\n Filled diamond shape type.\n\n hou.drawable2DMarkerStyle.Dot\n Filled circle shape type.\n\n hou.drawable2DMarkerStyle.HollowDiamond\n Unfilled diamond shape type.\n\n hou.drawable2DMarkerStyle.HollowDot\n Unfilled circle shape type.\n\n hou.drawable2DMarkerStyle.HollowSquare\n Unfilled square shape type.\n\n hou.drawable2DMarkerStyle.Square\n Filled square shape type.\n\n hou.drawable2DMarkerStyle.SquareCross\n A hollow square marker with a cross shape inside.\n\n hou.drawable2DMarkerStyle.XShape\n X shape type.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Cross: EnumValue = ...\n Diamond: EnumValue = ...\n Dot: EnumValue = ...\n HollowDiamond: EnumValue = ...\n HollowDot: EnumValue = ...\n HollowSquare: EnumValue = ...\n Square: EnumValue = ...\n SquareCross: EnumValue = ...\n XShape: EnumValue = ...\n\nclass scrollPosition:\n \"\"\"\n\n hou.scrollPosition\n\n Enumeration of scrolling position modes.\n\n See hou.NetworkEditor.parmScrollTo. See hou.ParameterEditor.scrollTo.\n\n VALUES\n\n\n Auto\n Adjust the scroll only when the parameter bounding box is\n outside the current scroll window. Uses top alignment if the\n bounding box was above the scroll window or bottom alignment\n otherwise.\n\n Top\n Adjust the scroll aligning the top of the parameter bounding box\n to the top of the scroll window.\n\n Center\n Adjust the scroll aligning the center of the parameter bounding\n box to the center of the scroll window.\n\n Bottom\n Adjust the scroll aligning the bottom of the parameter bounding\n box to the bottom of the scroll window.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Auto: EnumValue = ...\n Bottom: EnumValue = ...\n Center: EnumValue = ...\n Top: EnumValue = ...\n\nclass parmFilterMode:\n \"\"\"\n\n hou.parmFilterMode\n\n Enumeration of Parameter filter modes.\n\n See Searching and filtering parameters See\n hou.NetworkEditor.parmFilterMode. See\n hou.NetworkEditor.setParmFilterMode. See hou.ParameterEditor.filterMode.\n See hou.ParameterEditor.setFilterMode.\n\n VALUES\n\n\n AllParms\n AllParmsAndHeadings\n TimeDependentParms\n ScopedParms\n AutoScopedParms\n GraphSelectedParms\n NonDefaultParms\n ParmsWithExpressions\n ParmsWithOverrides\n InvisibleParms\n VisibleAndInvisibleParms\n SearchNoControlMenus\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n AllParms: EnumValue = ...\n AllParmsAndHeadings: EnumValue = ...\n AutoScopedParms: EnumValue = ...\n GraphSelectedParms: EnumValue = ...\n InvisibleParms: EnumValue = ...\n NonDefaultParms: EnumValue = ...\n ParmsWithExpressions: EnumValue = ...\n ParmsWithOverrides: EnumValue = ...\n ScopedParms: EnumValue = ...\n SearchNoControlMenus: EnumValue = ...\n TimeDependentParms: EnumValue = ...\n VisibleAndInvisibleParms: EnumValue = ...\n\nclass parmFilterCriteria:\n \"\"\"\n\n hou.parmFilterCriteria\n\n Enumeration of Parameter filter criteria.\n\n See Searching and filtering parameters See\n hou.NetworkEditor.parmFilterCriteria. See\n hou.NetworkEditor.setParmFilterCriteria. See\n hou.ParameterEditor.filterCriteria. See\n hou.ParameterEditor.setFilterCriteria.\n\n VALUES\n\n\n NameOrLabel\n Name\n Label\n RawValue\n EvaluatedValue\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n EvaluatedValue: EnumValue = ...\n Label: EnumValue = ...\n Name: EnumValue = ...\n NameOrLabel: EnumValue = ...\n RawValue: EnumValue = ...\n\nclass _ik_targetType:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n All: EnumValue = ...\n Orientation: EnumValue = ...\n Position: EnumValue = ...\n\nclass agentShapeDeformerType:\n \"\"\"\n\n hou.agentShapeDeformerType\n\n Enumeration of agent shape deformer types.\n\n Specifies the built-in shape deformer types, which can be used when\n creating a hou.AgentShapeDeformer.\n\n VALUES\n\n\n LinearSkinning\n DualQuatSkinning\n DualQuatBlendSkinning\n BlendShape\n BlendShapeAndLinearSkinning\n BlendShapeAndDualQuatSkinning\n BlendShapeAndDualQuatBlendSkinning\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n BlendShape: EnumValue = ...\n BlendShapeAndDualQuatBlendSkinning: EnumValue = ...\n BlendShapeAndDualQuatSkinning: EnumValue = ...\n BlendShapeAndLinearSkinning: EnumValue = ...\n DualQuatBlendSkinning: EnumValue = ...\n DualQuatSkinning: EnumValue = ...\n LinearSkinning: EnumValue = ...\n\nclass optionalBool:\n \"\"\"\n\n hou.optionalBool\n\n Enumeration of a generic tri-state value.\n\n This enumeration is essentially a boolean value, but with the added\n possibility of expressing an explicit lack of opinion. As an example, a\n function may want to know the value of a toggle parameter. True or False\n values would turn the toggle on or off. A NoOpinion value would indicate\n that the parameter value should be left unchanged, because the caller\n has no opinion on what the value of the parameter should be.\n\n\n Yes\n Equivalent to a boolean True value.\n\n No\n Equivalent to a boolean False value.\n\n NoOpinion\n Indicates a lack of opinion.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n No: EnumValue = ...\n NoOpinion: EnumValue = ...\n Yes: EnumValue = ...\n\nclass videoDriver:\n \"\"\"\n\n hou.videoDriver\n\n Enumeration of drivers that provide video functionality.\n\n Video functionality in Houdini is provided by different drivers. Some\n drivers are available on all platforms, while others are specific to a\n certain platform. This enumeration allows you to specify which driver\n should be used when interacting with the video subsystem.\n\n\n FFmpeg\n Use the FFmpeg driver.\n\n VFW\n Use the Video For Windows driver.\n\n RELATED\n\n * hou.videoEncoders\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n\nclass trackExtend:\n \"\"\"\n\n hou.trackExtend\n\n Enumeration of Track Extend modes.\n\n VALUES\n\n\n Hold\n Slope\n Cycle\n Mirror\n Default\n CycleStep\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n Cycle: EnumValue = ...\n CycleStep: EnumValue = ...\n Default: EnumValue = ...\n Hold: EnumValue = ...\n Mirror: EnumValue = ...\n Slope: EnumValue = ...\n\nclass clipMode:\n \"\"\"\n\n hou.clipMode\n\n Enumeration of Clip modes.\n\n VALUES\n\n\n CurrentFrame\n ConstantRange\n Range\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n ConstantRange: EnumValue = ...\n CurrentFrame: EnumValue = ...\n Range: EnumValue = ...\n\nclass SystemExit(Exception):\n \"\"\"\n\n hou.SystemExit\n\n TIP\n Raising this exception yourself will have no effect. Call hou.exit\n to tell Houdini to quit.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, exit_code: int) -> None:\n \"\"\"\n\n hou.SystemExit\n\n TIP\n Raising this exception yourself will have no effect. Call hou.exit\n to tell Houdini to quit.\n\n\n \"\"\"\n def code(self) -> int:\n \"\"\"\n\n code(self) -> int\n\n The exit code Houdini will return to the OS when it exits.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass Error(Exception):\n \"\"\"\n\n hou.Error\n\n Base class for all exceptions in the hou module.\n\n You can check if an exception instance is a Houdini-specific exception\n using isinstance(ex, hou.Error).\n\n You can catch all Houdini-specific exceptions in an except statement\n using except hou.Error:.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.Error\n\n Base class for all exceptions in the hou module.\n\n You can check if an exception instance is a Houdini-specific exception\n using isinstance(ex, hou.Error).\n\n You can catch all Houdini-specific exceptions in an except statement\n using except hou.Error:.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n def instanceMessage(self) -> str:\n \"\"\"\n\n instanceMessage(self) -> str\n\n Return a message specific to the exception instance.\n\n\n \"\"\"\n\nclass NotAvailable(Error):\n \"\"\"\n\n hou.NotAvailable\n\n Raised when you try to call an API function/method that is not\n available.\n\n A certain HOM function, class, or method may not be available due to\n Houdini running with a limited license.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.NotAvailable\n\n Raised when you try to call an API function/method that is not\n available.\n\n A certain HOM function, class, or method may not be available due to\n Houdini running with a limited license.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass ObjectWasDeleted(Error):\n '''\n\n hou.ObjectWasDeleted\n\n Raised when you try to access a reference to an object that has since\n been deleted.\n\n OVERVIEW\n\n For example, you might take a reference to a node:\n\n > >>> node = hou.node(\\\\\"/obj/geo1/sphere1\\\\\")\n\n If that node is later deleted, and then you try to use your\n reference to the deleted node, Houdini will raise this error:\n\n > >>> path = node.path()\n > hou.ObjectWasDeleted: ...\n\n TIPS AND TRICKS\n\n * There is no way to check if a reference is still valid, other than\n to try an operation and catch this error.\n\n * If you want to keep a long-ish term reference to a node, you might\n find it more convenient to instead keep a reference to the node\\'s\n unique integer ID for the node in this session (hou.Node.sessionId).\n Then, when you want to use the node again, call hou.nodeBySessionId\n with the ID. It will return a reference to the node, or None if the\n node has since been deleted.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args) -> None:\n '''\n\n hou.ObjectWasDeleted\n\n Raised when you try to access a reference to an object that has since\n been deleted.\n\n OVERVIEW\n\n For example, you might take a reference to a node:\n\n > >>> node = hou.node(\\\\\"/obj/geo1/sphere1\\\\\")\n\n If that node is later deleted, and then you try to use your\n reference to the deleted node, Houdini will raise this error:\n\n > >>> path = node.path()\n > hou.ObjectWasDeleted: ...\n\n TIPS AND TRICKS\n\n * There is no way to check if a reference is still valid, other than\n to try an operation and catch this error.\n\n * If you want to keep a long-ish term reference to a node, you might\n find it more convenient to instead keep a reference to the node\\'s\n unique integer ID for the node in this session (hou.Node.sessionId).\n Then, when you want to use the node again, call hou.nodeBySessionId\n with the ID. It will return a reference to the node, or None if the\n node has since been deleted.\n\n\n '''\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass InvalidInput(Error):\n \"\"\"\n\n hou.InvalidInput\n\n Raised if you try to set a node's input to something invalid.\n\n The hou.Node API has various methods for wiring and un-wiring inputs and\n outputs in the network. If you try to wire an object into a node input\n that is not a node or is not allowed to be wired to that input, Houdini\n will raise this exception.\n\n Note that Houdini does allow certain wiring operations you might expect\n to fail (such as looping a node's output back into its own input) but\n then immediately flags them as errors in the network editor.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.InvalidInput\n\n Raised if you try to set a node's input to something invalid.\n\n The hou.Node API has various methods for wiring and un-wiring inputs and\n outputs in the network. If you try to wire an object into a node input\n that is not a node or is not allowed to be wired to that input, Houdini\n will raise this exception.\n\n Note that Houdini does allow certain wiring operations you might expect\n to fail (such as looping a node's output back into its own input) but\n then immediately flags them as errors in the network editor.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass InvalidOutput(Error):\n \"\"\"\n\n hou.InvalidOutput\n\n Raised if you try to set a node's output to something invalid.\n\n The hou.Node API has various methods for wiring and un-wiring inputs and\n outputs in the network. If you try to wire an object into a node output\n that is not a node or is not allowed to be wired to that output, Houdini\n will raise this exception.\n\n Note that Houdini does allow certain wiring operations you might expect\n to fail (such as looping a node's output back into its own output) but\n then immediately flags them as errors in the network editor.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.InvalidOutput\n\n Raised if you try to set a node's output to something invalid.\n\n The hou.Node API has various methods for wiring and un-wiring inputs and\n outputs in the network. If you try to wire an object into a node output\n that is not a node or is not allowed to be wired to that output, Houdini\n will raise this exception.\n\n Note that Houdini does allow certain wiring operations you might expect\n to fail (such as looping a node's output back into its own output) but\n then immediately flags them as errors in the network editor.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass InvalidSize(Error):\n \"\"\"\n\n hou.InvalidSize\n\n Raised when you pass a sequence of the wrong length to a function.\n\n There are occasionally methods in the HOM API where you must pass a\n sequence of values of an exact length... such as one value for each\n point in a geometry. If the sequence you pass to the method is the wrong\n size, Houdini raises this exception.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.InvalidSize\n\n Raised when you pass a sequence of the wrong length to a function.\n\n There are occasionally methods in the HOM API where you must pass a\n sequence of values of an exact length... such as one value for each\n point in a geometry. If the sequence you pass to the method is the wrong\n size, Houdini raises this exception.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass OperationFailed(Error):\n \"\"\"\n\n hou.OperationFailed\n\n Generic catch-all exception for various errors in Houdini that don't\n have their own dedicated exception classes.\n\n There are many ways for things to go wrong in Houdini. In general, types\n of errors only have a dedicated exception class if we anticipate a\n script author might need to detect that particular type of error in an\n exception handler, and take appropriate action.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, message: str|None = ...) -> None:\n \"\"\"\n\n hou.OperationFailed\n\n Generic catch-all exception for various errors in Houdini that don't\n have their own dedicated exception classes.\n\n There are many ways for things to go wrong in Houdini. In general, types\n of errors only have a dedicated exception class if we anticipate a\n script author might need to detect that particular type of error in an\n exception handler, and take appropriate action.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass InvalidNodeType(Error):\n \"\"\"\n\n hou.InvalidNodeType\n\n Raised if you try to call a method on a Node that doesn't support it.\n\n Even though subclassing generally makes it so methods only appear on\n objects that support them, there are node types that have optional\n features, or node types that might work differently from normal nodes\n (such as subnetworks and managers).\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.InvalidNodeType\n\n Raised if you try to call a method on a Node that doesn't support it.\n\n Even though subclassing generally makes it so methods only appear on\n objects that support them, there are node types that have optional\n features, or node types that might work differently from normal nodes\n (such as subnetworks and managers).\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass InitScriptFailed(Error):\n \"\"\"\n\n hou.InitScriptFailed\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.InitScriptFailed\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass MatchDefinitionError(Error):\n \"\"\"\n\n hou.MatchDefinitionError\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.MatchDefinitionError\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass PermissionError(Error):\n \"\"\"\n\n hou.PermissionError\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.PermissionError\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n def instanceMessage(self) -> str:\n \"\"\"\n\n instanceMessage(self) -> str\n\n Return a message specific to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass GeometryPermissionError(Error):\n \"\"\"\n\n hou.GeometryPermissionError\n\n Raised if you try to modify SOP geometry from outside of a Python SOP.\n\n OVERVIEW\n\n * Outside of the cook process, you can create your own hou.Geometry\n object and use methods and node verbs to manipulate the geometry.\n\n * When you get a Geometry object reference to the output of a geometry\n node (SOP), that reference is read-only (it represents the cached\n output of the node an so can't be changed). You can read/inspect the\n geometry. To modify the geometry, you must make a writable copy\n first.\n\n * If try to modify a Geometry object from SOPs outside of a Python\n SOP, Houdini will raise this error.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.GeometryPermissionError\n\n Raised if you try to modify SOP geometry from outside of a Python SOP.\n\n OVERVIEW\n\n * Outside of the cook process, you can create your own hou.Geometry\n object and use methods and node verbs to manipulate the geometry.\n\n * When you get a Geometry object reference to the output of a geometry\n node (SOP), that reference is read-only (it represents the cached\n output of the node an so can't be changed). You can read/inspect the\n geometry. To modify the geometry, you must make a writable copy\n first.\n\n * If try to modify a Geometry object from SOPs outside of a Python\n SOP, Houdini will raise this error.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass KeyframeValueNotSet(Error):\n \"\"\"\n\n hou.KeyframeValueNotSet\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.KeyframeValueNotSet\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass OperationInterrupted(Error):\n \"\"\"\n\n hou.OperationInterrupted\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.OperationInterrupted\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass LoadWarning(Error):\n \"\"\"\n\n hou.LoadWarning\n\n Exception class for when loading a hip file in Houdini generates\n warnings.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.LoadWarning\n\n Exception class for when loading a hip file in Houdini generates\n warnings.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NodeError(Error):\n '''\n\n hou.NodeError\n\n Raise this exception in a Python node to signal that the node is in\n error.\n\n OVERVIEW\n\n This is different from other exceptions that are typically raised by\n the system when something goes wrong, such as invalid inputs to a\n method call. This is an exception you, the author of a Python SOP,\n or Python Object, or Python LOP, etc., raise in the node\\'s\n implementation script to set messages/warnings/errors on the node.\n\n Errors, warnings, and messages are part of a node\\'s user interface.\n They show up in the network editor, parameter editor, and info\n window.\n\n * Errors signal to the node\\'s user that the node has encountered an\n error. For example, invalid inputs or parameter values.\n\n * Warnings signal that the node was able to cook, but there was a\n problem the user might want to check. For example, a missing\n texture.\n\n See Writing Python SOPs for more information.\n\n\n TIP\n To mark the node with a warning instead of an error, raise\n hou.NodeWarning instead.\n\n EXAMPLE\n\n If you\\'re writing a Python SOP, you might depend on information in\n an external file, specified by a parameter on the node:\n\n > thisnode = hou.pwd()\n > filepath = thisnode.parm(\\\\\"file\\\\\").evalAsString()\n > content = hou.readFile(filepath)\n > # ...\n\n If the file doesn\\'t exist, you should raise this exception to signal\n to Houdini that the node could not cook, and specify an error\n message to help the user correct the problem:\n\n > import os.path\n > \n > thisnode = hou.pwd()\n > filepath = thisnode.parm(\\\\\"file\\\\\").evalAsString()\n > \n > if not os.path.exists(filepath):\n > raise hou.NodeError(\\\\\"File {} does not exist\\\\\".format(filepath))\n > \n > content = hou.readFile()\n > # ...\n\n RELATED\n\n * hou.NodeWarning\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args) -> None:\n '''\n\n hou.NodeError\n\n Raise this exception in a Python node to signal that the node is in\n error.\n\n OVERVIEW\n\n This is different from other exceptions that are typically raised by\n the system when something goes wrong, such as invalid inputs to a\n method call. This is an exception you, the author of a Python SOP,\n or Python Object, or Python LOP, etc., raise in the node\\'s\n implementation script to set messages/warnings/errors on the node.\n\n Errors, warnings, and messages are part of a node\\'s user interface.\n They show up in the network editor, parameter editor, and info\n window.\n\n * Errors signal to the node\\'s user that the node has encountered an\n error. For example, invalid inputs or parameter values.\n\n * Warnings signal that the node was able to cook, but there was a\n problem the user might want to check. For example, a missing\n texture.\n\n See Writing Python SOPs for more information.\n\n\n TIP\n To mark the node with a warning instead of an error, raise\n hou.NodeWarning instead.\n\n EXAMPLE\n\n If you\\'re writing a Python SOP, you might depend on information in\n an external file, specified by a parameter on the node:\n\n > thisnode = hou.pwd()\n > filepath = thisnode.parm(\\\\\"file\\\\\").evalAsString()\n > content = hou.readFile(filepath)\n > # ...\n\n If the file doesn\\'t exist, you should raise this exception to signal\n to Houdini that the node could not cook, and specify an error\n message to help the user correct the problem:\n\n > import os.path\n > \n > thisnode = hou.pwd()\n > filepath = thisnode.parm(\\\\\"file\\\\\").evalAsString()\n > \n > if not os.path.exists(filepath):\n > raise hou.NodeError(\\\\\"File {} does not exist\\\\\".format(filepath))\n > \n > content = hou.readFile()\n > # ...\n\n RELATED\n\n * hou.NodeWarning\n\n\n '''\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NodeWarning(Error):\n '''\n\n hou.NodeWarning\n\n Raise this exception in a Python node to signal that the node has a\n warning.\n\n OVERVIEW\n\n This is different from other exceptions that are typically raised by\n the system when something goes wrong, such as invalid inputs to a\n method call. This is an exception you, the author of a Python SOP,\n or Python Object, or Python LOP, etc., raise in the node\\'s\n implementation script to set messages/warnings/errors on the node.\n\n Errors, warnings, and messages are part of a node\\'s user interface.\n They show up in the network editor, parameter editor, and info\n window.\n\n * Errors signal to the node\\'s user that the node has encountered an\n error. For example, invalid inputs or parameter values.\n\n * Warnings signal that the node was able to cook, but there was a\n problem the user might want to check. For example, a missing\n texture.\n\n See Writing Python SOPs for more information.\n\n\n TIP\n To mark the node with an error instead of a warning, raise\n hou.NodeError instead.\n\n\n NOTE\n Raise a warning exception at the end of the script, so the node\n script otherwise completes cooking.\n\n EXAMPLE\n\n If you\\'re writing a Python SOP, you might use the content of an\n external file (referenced in a parameter on the node), even though\n the node can work without the file:\n\n > import os.path\n > \n > thisnode = hou.pwd()\n > filepath = thisnode.parm(\\\\\"file\\\\\").evalAsString()\n > content = hou.readFile()\n > if content:\n > # Use the file contents\n > # ...\n > \n > # Continue script operation\n > # ...\n > \n > # At the end of the script, raise any warning that might have\n > # come up during the script\n > if not content:\n > raise NodeWarning(\\\\\"The texture file is missing or empty\\\\\")\n\n RELATED\n\n * hou.NodeWarning\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args) -> None:\n '''\n\n hou.NodeWarning\n\n Raise this exception in a Python node to signal that the node has a\n warning.\n\n OVERVIEW\n\n This is different from other exceptions that are typically raised by\n the system when something goes wrong, such as invalid inputs to a\n method call. This is an exception you, the author of a Python SOP,\n or Python Object, or Python LOP, etc., raise in the node\\'s\n implementation script to set messages/warnings/errors on the node.\n\n Errors, warnings, and messages are part of a node\\'s user interface.\n They show up in the network editor, parameter editor, and info\n window.\n\n * Errors signal to the node\\'s user that the node has encountered an\n error. For example, invalid inputs or parameter values.\n\n * Warnings signal that the node was able to cook, but there was a\n problem the user might want to check. For example, a missing\n texture.\n\n See Writing Python SOPs for more information.\n\n\n TIP\n To mark the node with an error instead of a warning, raise\n hou.NodeError instead.\n\n\n NOTE\n Raise a warning exception at the end of the script, so the node\n script otherwise completes cooking.\n\n EXAMPLE\n\n If you\\'re writing a Python SOP, you might use the content of an\n external file (referenced in a parameter on the node), even though\n the node can work without the file:\n\n > import os.path\n > \n > thisnode = hou.pwd()\n > filepath = thisnode.parm(\\\\\"file\\\\\").evalAsString()\n > content = hou.readFile()\n > if content:\n > # Use the file contents\n > # ...\n > \n > # Continue script operation\n > # ...\n > \n > # At the end of the script, raise any warning that might have\n > # come up during the script\n > if not content:\n > raise NodeWarning(\\\\\"The texture file is missing or empty\\\\\")\n\n RELATED\n\n * hou.NodeWarning\n\n\n '''\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NameConflict(Error):\n \"\"\"\n\n hou.NameConflict\n\n Exception raised when a name conflict is detected during an operation.\n\n Often, Houdini can resolve name conflicts automatically (for example, if\n you try to create a node named sphere1 and a node with that name already\n exists, by default most API calls will create a node named sphere2\n instead). In cases where a naming conflict prevents an API call from\n working, and it can't be automatically resolved (or automatic resolution\n is an option you have disabled in an argument), Houdini will raise this\n exception.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.NameConflict\n\n Exception raised when a name conflict is detected during an operation.\n\n Often, Houdini can resolve name conflicts automatically (for example, if\n you try to create a node named sphere1 and a node with that name already\n exists, by default most API calls will create a node named sphere2\n instead). In cases where a naming conflict prevents an API call from\n working, and it can't be automatically resolved (or automatic resolution\n is an option you have disabled in an argument), Houdini will raise this\n exception.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass TypeConflict(Error):\n \"\"\"\n\n hou.TypeConflict\n\n Raised if a type conflict occurs during an operation. For instance, type\n conflicts may occur during the registration of a python state or python\n handle.\n\n See Python States for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.TypeConflict\n\n Raised if a type conflict occurs during an operation. For instance, type\n conflicts may occur during the registration of a python state or python\n handle.\n\n See Python States for more information.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass StateNotRegistered(Error):\n \"\"\"\n\n hou.StateNotRegistered\n\n Raised if you try to unregister a Python state that was never\n registered.\n\n See Python States for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.StateNotRegistered\n\n Raised if you try to unregister a Python state that was never\n registered.\n\n See Python States for more information.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass HandleNotRegistered(Error):\n \"\"\"\n\n hou.HandleNotRegistered\n\n Raised if you try to use a custom handle that is not registered with the\n system.\n\n See Python handles for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.HandleNotRegistered\n\n Raised if you try to use a custom handle that is not registered with the\n system.\n\n See Python handles for more information.\n\n\n \"\"\"\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass LicenseError(Error):\n '''\n\n hou.LicenseError\n\n Raised when a licensing error occurs. For instance when trying to access\n a feature or component without the appropriate license.\n\n OVERVIEW\n\n For example, MPM tools are only available to be created with a\n Houdini FX license. Attempting to create a node of that type using\n Houdini Core will raise this error:\n\n > >>> node = hou.node(\\\\\"/obj/geo1\\\\\")\n > >>> newnode = node.createNode(\\\\\"mpmcollider\\\\\")\n > Traceback (most recent call last):\n > ...\n > hou.LicenseError: Not available in current session.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args) -> None:\n '''\n\n hou.LicenseError\n\n Raised when a licensing error occurs. For instance when trying to access\n a feature or component without the appropriate license.\n\n OVERVIEW\n\n For example, MPM tools are only available to be created with a\n Houdini FX license. Attempting to create a node of that type using\n Houdini Core will raise this error:\n\n > >>> node = hou.node(\\\\\"/obj/geo1\\\\\")\n > >>> newnode = node.createNode(\\\\\"mpmcollider\\\\\")\n > Traceback (most recent call last):\n > ...\n > hou.LicenseError: Not available in current session.\n\n\n '''\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass InvalidGeometry(OperationFailed):\n '''\n\n hou.InvalidGeometry\n\n Exception raised when you try to access a reference to SOP Geometry that\n has since failed to cook.\n\n OVERVIEW\n\n For example, you might take a reference to a geometry node\\'s output:\n\n > >>> mygeo = hou.node(\\\\\"/obj/geo1/sphere1\\\\\").geometry()\n\n If after you take the reference something changes which causes the\n node to recook, and the recook fails, the geometry referred to by\n mygeo is now invalid. Trying to access it will raise this exception.\n\n > >>> points = mygeo.points()\n > hou.InvalidGeometry: ...\n\n TIPS AND NOTES\n\n * If you call .geometry() on a node that\\'s currently in error, you\n will get None instead of an invalid hou.Geometry object.\n\n * You can check if a Geometry object is valid before you use it with\n hou.Geometry.isValid.\n\n > if mygeo.isValid():\n > points = mygeo.points()\n * A Geometry reference turning invalid might happen if you grab\n geometry in code outside the cooking mechanism. If your code runs as\n part of the cook (for example, in a Python SOP), a valid Geometry\n reference should stay valid for the duration of your script.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args) -> None:\n '''\n\n hou.InvalidGeometry\n\n Exception raised when you try to access a reference to SOP Geometry that\n has since failed to cook.\n\n OVERVIEW\n\n For example, you might take a reference to a geometry node\\'s output:\n\n > >>> mygeo = hou.node(\\\\\"/obj/geo1/sphere1\\\\\").geometry()\n\n If after you take the reference something changes which causes the\n node to recook, and the recook fails, the geometry referred to by\n mygeo is now invalid. Trying to access it will raise this exception.\n\n > >>> points = mygeo.points()\n > hou.InvalidGeometry: ...\n\n TIPS AND NOTES\n\n * If you call .geometry() on a node that\\'s currently in error, you\n will get None instead of an invalid hou.Geometry object.\n\n * You can check if a Geometry object is valid before you use it with\n hou.Geometry.isValid.\n\n > if mygeo.isValid():\n > points = mygeo.points()\n * A Geometry reference turning invalid might happen if you grab\n geometry in code outside the cooking mechanism. If your code runs as\n part of the cook (for example, in a Python SOP), a valid Geometry\n reference should stay valid for the duration of your script.\n\n\n '''\n def exceptionTypeName(self) -> str:\n '''\n\n exceptionTypeName(self) -> str\n\n Return the name of the exception type. Instances of different\n subclasses of hou.Error will return different names. Instances of\n the base class will return \\\\\"Error\\\\\".\n\n You can also use str(e.__class__) to get the name of the subclass.\n\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return a description of the class of exception. The description is\n not related to the exception instance.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NetworkItem:\n \"\"\"\n\n hou.NetworkItem\n\n The base class for all visible elements within a network.\n\n This class has no methods, and only exists as a base class for\n hou.NetworkMovableItem and hou.NodeConnection, both of which are visible\n in the network editor, but which have no real meaningful base class. By\n providing a common base class, items of these two types can be passed in\n or returned from hou.NetworkEditor functions.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args) -> None:\n \"\"\"\n\n hou.NetworkItem\n\n The base class for all visible elements within a network.\n\n This class has no methods, and only exists as a base class for\n hou.NetworkMovableItem and hou.NodeConnection, both of which are visible\n in the network editor, but which have no real meaningful base class. By\n providing a common base class, items of these two types can be passed in\n or returned from hou.NetworkEditor functions.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def networkItemType(self) -> EnumValue:\n \"\"\"\n\n networkItemType(self) -> hou.networkItemType\n\n Return an enum value indicating what type of network item is\n represented by this object. This value is equivalent to using the\n isinstance built in Python function with the matching class (for\n example hou.networkItemType.Connection is equivalent to\n hou.NodeConnection).\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def __lt__(self, other: object) -> bool: ...\n def __le__(self, other: object) -> bool: ...\n def __gt__(self, other: object) -> bool: ...\n def __ge__(self, other: object) -> bool: ...\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n\nclass NetworkMovableItem(NetworkItem):\n \"\"\"\n\n hou.NetworkMovableItem\n\n The base class for all visible elements within a network, such as Nodes,\n Network Boxes, and Sticky Notes.\n\n Each movable item has a position, color, and other attributes that allow\n for common interactions in the network editor. All movable items will\n have a parent network (except the node represented by hou.node('/')),\n and may be contained by a hou.NetworkBox. Not all movable items have a\n name, but all have a numeric session id, which is a unique number within\n a given Houdini session for a given subclass of NetworkMovableItem.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return this node's name. See also hou.NetworkMovableItem.path.\n\n\n \"\"\"\n def setName(self, name: str, unique_name: bool = False) -> None:\n \"\"\"\n\n setName(self, name, unique_name=False)\n\n Set the name of this node. Raises hou.OperationFailed if the new\n name contains characters other than letters, numbers, periods,\n dashes, or underscores. Raises hou.OperationFailed if the node could\n not be renamed (for example, another node already exists with the\n name, the node is the root node or top-level manager (e.g. /obj), or\n the node is inside a locked asset). If the unique_name parameter is\n set to True, the supplied name may be changed to ensure that it\n doesn't match the name of any existing node.\n\n\n \"\"\"\n def digitsInName(self) -> int:\n \"\"\"\n\n digitsInName(self) -> int\n\n Return the value of the last set of digits inside the node's name,\n or 0 if there are no digits.\n\n For example, the result is 102 for a node named geo102, and 34 for a\n node named light12to34.\n\n\n \"\"\"\n def path(self) -> str:\n \"\"\"\n\n path(self) -> str\n\n Return the full path (i.e. starting with /) of this node in the\n network.\n\n\n \"\"\"\n def relativePathTo(self, base_item: NetworkMovableItem) -> str:\n '''\n\n relativePathTo(self, base_node) -> str\n\n Return a relative path to another node object from this node.\n\n > >>> box1 = hou.node(\\\\\"/obj/box_object1/box1\\\\\")\n > >>> sphere1 = hou.node(\\\\\"/obj/sphere_object1/sphere1\\\\\")\n > >>> box1.relativePathTo(sphere1)\n > \\'../../sphere_object1/sphere1\\'\n > >>> hou.node(\\\\\"/obj\\\\\").relativePathTo(box1)\n > \\'box_object1/box1\\'\n > >>> box1.relativePathTo(box1)\n > \\'.\\'\n\n '''\n def isSelected(self) -> bool:\n \"\"\"\n\n isSelected(self) -> bool\n\n Return whether this item is selected.\n\n See also hou.selectedNodes.\n\n\n \"\"\"\n def setSelected(self, on: bool, clear_all_selected: bool = False, show_asset_if_selected: bool = False) -> None:\n \"\"\"\n\n setSelected(self, on, clear_all_selected=False,\n show_asset_if_selected=False)\n\n Select or deselect this item, optionally deselecting all other\n selected items in this network. If show_asset_if_selected is True,\n and this item is a Node, then the panes will show the top-level\n asset of the selected item instead.\n\n\n \"\"\"\n def color(self) -> Color:\n \"\"\"\n\n color(self) -> hou.Color\n\n Return the color of this item's tile in the network editor.\n\n\n \"\"\"\n def setColor(self, color: Color) -> None:\n \"\"\"\n\n setColor(self, color)\n\n Sets the color of this item's tile in the network editor to the\n given hou.Color.\n\n\n \"\"\"\n def size(self) -> Vector2:\n \"\"\"\n\n size(self) -> hou.Vector2\n\n Return the size of this item's tile in the network editor graph as a\n Vector2.\n\n\n \"\"\"\n def position(self) -> Vector2:\n \"\"\"\n\n position(self) -> hou.Vector2\n\n Return the position of this item's tile in the network editor graph\n as a Vector2. See also move() and setPosition().\n\n\n \"\"\"\n def setPosition(self, position: Sequence[float]|Vector2) -> None:\n \"\"\"\n\n setPosition(self, vector2)\n\n Sets the position of this item's tile in the network editor graph.\n Raises hou.InvalidInput if the item cannot have the given position.\n\n\n \"\"\"\n def move(self, amount: Sequence[float]|Vector2) -> None:\n \"\"\"\n\n move(self, vector2)\n\n Moves this item's tile in the network editor graph by the increments\n in the given hou.Vector2.\n\n To position a item absolutely, use setPosition().\n\n To get the item's current graph position, use position().\n\n Raises hou.InvalidInput if the item cannot move to the position\n specified.\n\n\n \"\"\"\n def parent(self) -> Optional[Node]:\n '''\n\n parent(self) -> hou.Node\n\n Return the node that contains this item.\n\n Note that this method returns None if the item is the root node\n (i.e. /).\n\n > >>> hou.node(\\\\\"/obj/box_object1\\\\\").parent()\n > \n > >>> print hou.node(\\\\\"/\\\\\").parent()\n > None\n\n '''\n def parentNetworkBox(self) -> Optional[NetworkBox]:\n \"\"\"\n\n parentNetworkBox(self) -> hou.NetworkBox or None\n\n Returns the parent network box which contains this item, or None if\n it is not inside a network box.\n\n\n \"\"\"\n def sessionId(self) -> int:\n \"\"\"\n\n sessionId(self)\n\n Returns an integer value that uniquely identifies this item in a\n given Houdini session. This id is only guaranteed to be unique in a\n single Houdini process. It is useful as a quick and easy way to save\n a restore a reference to an item. It is also only unique for a\n specific item subclass. So there may be a Node with the same session\n id as a NetworkBox.\n\n See hou.nodeBySessionId to turn a session id back into a node, or\n hou.networkBoxBySessionId to turn a session id back into a network\n box, or more generally, hou.itemBySessionId to turn a session id\n combined with an enum value indicating the item subclass into an\n item of that type.\n\n\n \"\"\"\n\nclass NetworkBox(NetworkMovableItem):\n \"\"\"\n\n hou.NetworkBox\n\n Represents a network box.\n\n To create a network box, use the hou.Node.createNetworkBox method on the\n node inside which you want to create the box. To get an existing network\n box, use the hou.Node.findNetworkBox method on the node containing the\n network box. To get a list of all network boxes in a network, use the\n hou.Node.networkBoxes method on the containing node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def comment(self) -> str:\n \"\"\"\n\n comment(self) -> str\n\n Returns the comment for this network box.\n\n\n \"\"\"\n def setComment(self, comment: str) -> None:\n \"\"\"\n\n setComment(self, comment)\n\n Set the comment string for this network box. This comment is visible\n in the network editor and can be used to describe the purpose of the\n box.\n\n\n \"\"\"\n def autoFit(self) -> bool:\n \"\"\"\n\n autoFit(self) -> bool\n\n Returns the value of the auto fit flag on this network box.\n\n\n \"\"\"\n def setAutoFit(self, auto_fit: bool) -> None:\n \"\"\"\n\n setAutoFit(self, auto_fit)\n\n Set the value of the auto fit flag on this network box. The default\n value is False which means the network box does not resize itself\n when nodes that belong to the network box are moved outside the\n bounds of the box. Setting this values to True enables this\n automatic resizing. The Network View will draw the network box\n around its contents in either case, even though the value returned\n by the size() method may return a smaller value that does not\n encompass all of the contained items.\n\n\n \"\"\"\n def setBounds(self, bounds: BoundingRect) -> None:\n \"\"\"\n\n setBounds(self, bounds)\n\n Sets the size and position of this sticky note to the given\n hou.BoundingRect bounds argument. Equivalent to calling setSize then\n setPosition.\n\n\n \"\"\"\n def setSize(self, size: Sequence[float]) -> None:\n \"\"\"\n\n setSize(self, size)\n\n Sets the size of this network box to the given hou.Vector2 size\n parameter. Use resize() to set the box's size relative to its\n current size.\n\n\n \"\"\"\n def resize(self, amount: Sequence[float]) -> None:\n \"\"\"\n\n resize(self, vector2)\n\n Resizes a network box by the increments in the given hou.Vector2.\n Use setSize() to set the box's absolute size.\n\n\n \"\"\"\n def fitAroundContents(self) -> None:\n \"\"\"\n\n fitAroundContents(self)\n\n Resizes the network box to fit its contents.\n\n\n \"\"\"\n def minimizedSize(self) -> Vector2:\n \"\"\"\n\n minimizedSize(self) -> hou.Vector2\n\n Return the size of this item's tile in the network editor graph if\n it is minimized. Returned as a Vector2.\n\n\n \"\"\"\n def restoredSize(self) -> Vector2:\n \"\"\"\n\n restoredSize(self) -> hou.Vector2\n\n Return the size of this item's tile in the network editor graph if\n it is not minimized. Returned as a Vector2.\n\n\n \"\"\"\n def isMinimized(self) -> bool:\n \"\"\"\n\n isMinimized(self) -> bool\n\n Returns whether the network box is minimized.\n\n\n \"\"\"\n def setMinimized(self, on: bool) -> None:\n \"\"\"\n\n setMinimized(self, on)\n\n Minimizes or restores the network box.\n\n\n \"\"\"\n def alpha(self) -> float:\n \"\"\"\n\n alpha(self) -> float\n\n Return the alpha value used for drawing this network box. A negative\n value indicates the network box should be drawn using the alpha\n value from the UI configuration.\n\n\n \"\"\"\n def setAlpha(self, alpha: float) -> None:\n \"\"\"\n\n setAlpha(self, alpha)\n\n Set the alpha of the network box. A negative value indicates the\n network box should be drawn using the alpha value from the UI\n configuration.\n\n\n \"\"\"\n def nodes(self, recurse: bool = True) -> Tuple[Node, ...]:\n \"\"\"\n\n nodes(self, recurse=True) -> tuple of hou.Node\n\n Returns the nodes inside the network box.\n\n\n recurse\n If True, recurses down into nested network boxes.\n\n\n \"\"\"\n def addNode(self, node: Node) -> None:\n \"\"\"\n\n addNode(self, node)\n\n Adds a hou.Node to the network box. This method is deprecated. Use\n hou.NetworkBox.addItem instead.\n\n\n \"\"\"\n def removeNode(self, node: Node) -> None:\n \"\"\"\n\n removeNode(self, node)\n\n Removes the given node from the network box. This method if\n deprecated. Use hou.NetworkBox.removeItem instead.\n\n\n \"\"\"\n def removeAllNodes(self) -> None:\n \"\"\"\n\n removeAllNodes(self)\n\n Removes all nodes from the network box. This method if deprecated.\n Use hou.NetworkBox.removaAllItems or hou.NetworkBox.removeItems\n instead.\n\n\n \"\"\"\n def networkBoxes(self, recurse: bool = True) -> Tuple[NetworkBox, ...]:\n \"\"\"\n\n networkBoxes(self, recurse=True) -> tuple of hou.NetworkBox\n\n Returns the network boxes inside the network box.\n\n\n recurse\n If True, recurses down into nested network boxes.\n\n\n \"\"\"\n def addNetworkBox(self, networkbox: NetworkBox) -> None:\n \"\"\"\n\n addNetworkBox(self, netbox)\n\n Adds a hou.NetworkDot to the network box. This method is deprecated.\n Use hou.NetworkBox.addItem instead.\n\n\n \"\"\"\n def removeNetworkBox(self, networkbox: NetworkBox) -> None:\n \"\"\"\n\n removeNetworkBox(self, netbox)\n\n Removes the given network box from the network box. This method if\n deprecated. Use hou.NetworkBox.removeItem instead.\n\n\n \"\"\"\n def stickyNotes(self, recurse: bool = True) -> Tuple[StickyNote, ...]:\n \"\"\"\n\n stickyNotes(self, recurse=True) -> tuple of hou.StickyNote\n\n Returns the sticky notes inside the network box.\n\n\n recurse\n If True, recurses down into nested network boxes.\n\n\n \"\"\"\n def addStickyNote(self, stickynote: StickyNote) -> None:\n \"\"\"\n\n addStickyNote(self, stickynote)\n\n Adds a hou.StickyNote to the network box. This method is deprecated.\n Use hou.NetworkBox.addItem instead.\n\n\n \"\"\"\n def removeStickyNote(self, stickynote: StickyNote) -> None:\n \"\"\"\n\n removeStickyNote(self, stickynote)\n\n Removes the given sticky note from the network box. This method if\n deprecated. Use hou.NetworkBox.removeItem instead.\n\n\n \"\"\"\n def subnetIndirectInputs(self, recurse: bool = True) -> Tuple[SubnetIndirectInput, ...]:\n \"\"\"\n\n subnetIndirectInputs(self, recurse=True) -> tuple of\n hou.SubnetIndirectInput\n\n Returns the subnet indirect inputs inside the network box.\n\n\n recurse\n If True, recurses down into nested network boxes.\n\n\n \"\"\"\n def addSubnetIndirectInput(self, indirect: SubnetIndirectInput) -> None:\n \"\"\"\n\n addSubnetIndirectInput(self, indirect)\n\n Adds a hou.SubnetIndirectInput to the network box. This method is\n deprecated. Use hou.NetworkBox.addItem instead.\n\n\n \"\"\"\n def removeSubnetIndirectInput(self, indirect: SubnetIndirectInput) -> None:\n \"\"\"\n\n removeSubnetIndirectInput(self, indirect)\n\n Removes the given indirect input from the network box. This method\n if deprecated. Use hou.NetworkBox.removeItem instead.\n\n\n \"\"\"\n def items(self, recurse: bool = True) -> Tuple[NetworkMovableItem, ...]:\n \"\"\"\n\n items(self, recurse=True) -> tuple of hou.NetworkMovableItem\n\n Returns the items of any type inside the network box.\n\n\n recurse\n If True, recurses down into nested network boxes.\n\n\n \"\"\"\n def addItem(self, item: NetworkMovableItem) -> None:\n \"\"\"\n\n addItem(self, item)\n\n Adds a hou.NetworkMovableItem of any kind to the network box.\n\n\n \"\"\"\n def removeItem(self, item: NetworkMovableItem) -> None:\n \"\"\"\n\n removeItem(self, item)\n\n Removes the given item from the network box.\n\n\n \"\"\"\n def removeAllItems(self) -> None:\n \"\"\"\n\n removeAllItems(self)\n\n Removes all items from the network box.\n\n\n \"\"\"\n def destroy(self, destroy_contents: bool = False) -> None:\n \"\"\"\n\n destroy(self, destroy_contents=False)\n\n Remove and delete the network box, optionally deleting the nodes it\n contains.\n\n\n \"\"\"\n def asCode(self, brief: bool = False, recurse: bool = False, save_box_contents: bool = False, save_channels_only: bool = False, save_creation_commands: bool = True, save_keys_in_frames: bool = False, save_parm_values_only: bool = False, save_spare_parms: bool = False, save_netbox_membership: bool = True, function_name: Optional[str] = None) -> str:\n \"\"\"\n\n asCode(self, brief=False, recurse=False, save_box_contents=False,\n save_channels_only=False, save_creation_commands=False,\n save_keys_in_frames=False, save_parm_values_only=False,\n save_spare_parms=False, save_box_membership=True, function_name=None) ->\n string\n\n Prints the Python code necessary to recreate a network box.\n\n See hou.Node.asCode for information on the keyword arguments.\n\n\n \"\"\"\n\nclass OpNetworkBox(NetworkBox):\n \"\"\"\n\n hou.OpNetworkBox\n\n Represents a network box in an OP network.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n\nclass StickyNote(NetworkMovableItem):\n \"\"\"\n\n hou.StickyNote\n\n Represents a sticky note.\n\n To create a sticky note, use the hou.Node.createStickyNote method on the\n node inside which you want to create the note. To get an existing sticky\n note, use the hou.Node.findStickyNote method on the node containing the\n sticky note. To get a list of all notes in a network, use the\n hou.Node.stickyNotes method on the containing node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def text(self) -> str:\n \"\"\"\n\n text(self) -> str\n\n Return the text displayed in the sticky note.\n\n\n \"\"\"\n def setText(self, new_text: str) -> None:\n \"\"\"\n\n setText(self, str)\n\n Sets the text of the sticky note.\n\n\n \"\"\"\n def textSize(self) -> float:\n \"\"\"\n\n textSize(self) -> float\n\n Return the size of the text displayed in the sticky note, expressed\n as the height of the font in network units.\n\n\n \"\"\"\n def setTextSize(self, size: float) -> None:\n \"\"\"\n\n setTextSize(self, size)\n\n Sets the size of the text of the sticky note. The size value\n specifies the height (in network units) of the font.\n\n\n \"\"\"\n def textColor(self) -> Color:\n \"\"\"\n\n textColor(self) -> hou.Color\n\n Return the color of the text displayed in the sticky note.\n\n\n \"\"\"\n def setTextColor(self, color: Color) -> None:\n \"\"\"\n\n setTextColor(self, color)\n\n Sets the color of the text of the sticky note. The color parameter\n should be a hou.Color object.\n\n\n \"\"\"\n def drawBackground(self) -> bool:\n \"\"\"\n\n drawBackground(self) -> bool\n\n Returns whether the sticky note will draw a colored background and\n title bar.\n\n\n \"\"\"\n def setDrawBackground(self, on: bool) -> None:\n \"\"\"\n\n setDrawBackground(self, on)\n\n Turns on or off the drawing of the colored background for the text\n and the title bar in the network editor. Turning this on makes the\n sticky note easier to see. Turning it off allows the text to be less\n obtrusive.\n\n\n \"\"\"\n def setBounds(self, bounds: BoundingRect) -> None: ...\n def setSize(self, size: Sequence[float]|Vector2) -> None:\n \"\"\"\n\n setSize(self, size)\n\n Sets the size of this sticky note to the given hou.Vector2 size\n parameter. Use resize() to set the note's size relative to its\n current size.\n\n\n \"\"\"\n def resize(self, amount: Sequence[float]) -> None:\n \"\"\"\n\n resize(self, vector2)\n\n Resizes a sticky note by the increments in the given hou.Vector2.\n Use setSize() to set the note's absolute size.\n\n\n \"\"\"\n def minimizedSize(self) -> Vector2:\n \"\"\"\n\n minimizedSize(self) -> hou.Vector2\n\n Return the size of this item's tile in the network editor graph if\n it is minimized. Returned as a Vector2.\n\n\n \"\"\"\n def restoredSize(self) -> Vector2:\n \"\"\"\n\n restoredSize(self) -> hou.Vector2\n\n Return the size of this item's tile in the network editor graph if\n it is not minimized. Returned as a Vector2.\n\n\n \"\"\"\n def isMinimized(self) -> bool:\n \"\"\"\n\n isMinimized(self) -> bool\n\n Returns whether the sticky note is minimized.\n\n\n \"\"\"\n def setMinimized(self, on: bool) -> None:\n \"\"\"\n\n setMinimized(self, on)\n\n Minimizes or restores the sticky note.\n\n\n \"\"\"\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Remove and delete the sticky note.\n\n\n \"\"\"\n\nclass ApexStickyNote(StickyNote):\n \"\"\"\n\n hou.ApexStickyNote\n\n Represents a sticky note in an APEX network.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n\nclass OpStickyNote(StickyNote):\n \"\"\"\n\n hou.OpStickyNote\n\n Represents a sticky note in an OP network.\n\n\n asCode(self, brief=False, recurse=False, save_box_contents=False,\n save_channels_only=False, save_creation_commands=False,\n save_keys_in_frames=False, save_parm_values_only=False,\n save_spare_parms=False, save_box_membership=True, function_name=None) ->\n str\n Prints the Python code necessary to recreate a sticky note.\n\n See hou.Node.asCode for information on the keyword arguments.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def asCode(self, brief: bool = False, recurse: bool = False, save_box_contents: bool = False, save_channels_only: bool = False, save_creation_commands: bool = True, save_keys_in_frames: bool = False, save_parm_values_only: bool = False, save_spare_parms: bool = False, save_box_membership: bool = True, function_name: Optional[str] = None) -> str: ...\n\nclass Node(NetworkMovableItem):\n \"\"\"\n\n hou.Node\n\n The base class for all abstract nodes in Houdini (OP, APEX, etc.)\n\n As of Houdini 20, this class no longer exclusively refers to Houdini OP\n nodes, but is instead an abstraction that allows the network editor to\n operate on a variety of node-like classes. The old hou.Node class is now\n hou.OpNode.\n\n The methods provided on this class are intended to be common to all\n node-like classes. Many of the methods that used to be defined on this\n class are now defined on hou.OpNode. Also note that the methods defined\n on this class will have different but analogous behaviors on other node-\n like classes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def isNetwork(self) -> bool:\n \"\"\"\n\n isNetwork(self) -> bool\n\n Return True if this node is a network, in other words a node that\n may contain child nodes. Otherwise return False which indicates that\n several other methods such as hou.Node.createNode will raise\n hou.OperationFailed if they are called.\n\n\n \"\"\"\n def isEditable(self) -> bool: ...\n def type(self) -> NodeType:\n \"\"\"\n\n type(self) -> hou.NodeType\n\n Return the hou.NodeType object for this node.\n\n For example, all camera node instances share the same node type.\n\n\n \"\"\"\n def childTypeCategory(self) -> NodeTypeCategory:\n \"\"\"\n\n childTypeCategory(self) -> hou.NodeTypeCategory\n\n Return the hou.NodeTypeCategory corresponding to the children of\n this node. For example, if this node is a geometry object, the\n children are SOPs. If it is an object subnet, the children are\n objects.\n\n\n \"\"\"\n def isFlagReadable(self, flag: EnumValue) -> bool:\n \"\"\"\n\n isFlagReadable(self, flag) -> bool\n\n Return True if the specified flag is readable and False otherwise.\n\n flag must be a hou.nodeFlag value.\n\n\n \"\"\"\n def isFlagWritable(self, flag: EnumValue) -> bool:\n \"\"\"\n\n isFlagWritable(self, flag) -> bool\n\n Return True if the specified flag is writable and False otherwise.\n\n flag must be a hou.nodeFlag value.\n\n\n \"\"\"\n def isGenericFlagSet(self, flag: EnumValue) -> bool:\n \"\"\"\n\n isGenericFlagSet(self, flag) -> bool\n\n Returns the value of the specific flag.\n\n flag must be a hou.nodeFlag value.\n\n\n \"\"\"\n def setGenericFlag(self, flag: EnumValue, value: bool) -> None:\n \"\"\"\n\n setGenericFlag(self, flag, value)\n\n Sets the value of the specified flag based on the bool value\n argument.\n\n flag must be a hou.nodeFlag value.\n\n\n \"\"\"\n def isDisplayDescriptiveNameFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayDescriptiveNameFlagSet(self) -> bool\n\n Return a boolean to indicate of the node should display its\n descriptive name in the network editor.\n\n\n \"\"\"\n def setDisplayDescriptiveNameFlag(self, on: bool) -> None: ...\n def errors(self) -> Tuple[str, ...]:\n \"\"\"\n\n errors(self) -> tuple of str\n\n Return the text of any errors from the last cook of this node, or an\n empty tuple if there were no errors.\n\n\n \"\"\"\n def warnings(self) -> Tuple[str, ...]:\n \"\"\"\n\n warnings(self) -> tuple of str\n\n Return the text of any warnings from the last cook of this node, or\n an empty tuple if there were no warnings.\n\n\n \"\"\"\n def messages(self) -> Tuple[str, ...]:\n \"\"\"\n\n messages(self) -> tuple of str\n\n Return the text of any messages from the last cook of this node, or\n an empty tuple if there were no messages.\n\n\n \"\"\"\n def node(self, node_path: str) -> Optional[Node]:\n '''\n\n node(self, node_path) -> hou.Node or None\n\n Return the node at the given path, or None if no such node exists.\n If you pass in a relative path (i.e. the path does not start with\n /), searches are performed relative to this node.\n\n For example, to get the parent node of a node in the variable n, use\n n.node(\\\\\"..\\\\\"). To get a child node named geo5, use n.node(\\\\\"geo5\\\\\"). To\n get a sibling node named light3, use n.node(\\\\\"../light3\\\\\").\n\n Note that the return value may be an instance of a subclass of Node.\n For example, if the node being found is an object node, the return\n value will be a hou.ObjNode instance.\n\n If the path is an absolute path (i.e. it starts with /), this method\n is a shortcut for hou.node(node_path). Otherwise, it is a shortcut\n for hou.node(self.path() + \\\\\"/\\\\\" + node_path). See also hou.node_.\n\n\n '''\n def nodes(self, node_paths: Sequence[str]) -> Tuple[Node, ...]:\n \"\"\"\n\n nodes(self, node_path_tuple) -> tuple of hou.Node or None\n\n This is like node() but takes multiple paths and returns multiple\n Node objects. This is the equivalent of:\n\n > nodes = [self.node(path) for path in paths]\n\n \"\"\"\n def item(self, item_path: str) -> Optional[NetworkMovableItem]:\n '''\n\n item(self, item_path) -> hou.NetworkMovableItem or None\n\n Return the network item at the given path, or None if no such item\n exists. If you pass in a relative path (i.e. the path does not start\n with /), searches are performed relative to this node.\n\n If the path is an absolute path (i.e. it starts with /), this method\n is a shortcut for hou.item(node_path). Otherwise, it is a shortcut\n for hou.item(self.path() + \\\\\"/\\\\\" + item_path). See also hou.item.\n\n Note that the return value may be an instance of a subclass of\n NetworkMovableItem. For example, if the item being found is an\n object node, the return value will be a hou.ObjNode instance. If the\n item is a network box, the return value will be a hou.NetworkBox\n instance.\n\n\n '''\n def items(self, item_paths: Sequence[str]) -> Tuple[NetworkMovableItem, ...]:\n \"\"\"\n\n items(self, item_path_tuple) -> tuple of hou.NetworkMovableItem or None\n\n This is like item() but takes multiple paths and returns multiple\n NetworkMovableItem objects. This is the equivalent of:\n\n > items = [self.item(path) for path in paths]\n\n \"\"\"\n def glob(self, pattern: str, ignore_case: bool = False) -> Tuple[Node, ...]:\n '''\n\n glob(self, pattern, ignore_case=False) -> tuple of hou.Node\n\n Return a tuple of children nodes name matches the pattern.\n\n The pattern may contain multiple pieces, separated by spaces. An\n asterisk (*) in a pattern piece will match any character. By\n default, Houdini will add the nodes from each pattern piece to those\n already matched. However, if the pattern piece begins with a caret\n (^), Houdini will remove the matches for that piece from the result.\n\n By default the pattern match is case-sensitive. Set ignore_case to\n True for case-insensitive pattern matching. Note that case\n insensitivity only applies when matching node names. It does not\n apply when matching group, network box or bundle names.\n\n This method returns an empty tuple if you pass in an empty pattern.\n\n > >>> obj = hou.node(\\\\\"/obj\\\\\")\n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"geo1\\\\\")\n > \n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"geo2\\\\\")\n > \n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"grid\\\\\")\n > \n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"garbage\\\\\")\n > \n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"box\\\\\")\n > \n > \n > >>> def names(nodes):\n > ... return [node.name() for node in nodes]\n > \n > >>> names(obj.glob(\\\\\"g*\\\\\"))\n > [\\'geo1\\', \\'geo2\\', \\'grid\\', \\'garbage\\']\n > >>> names(obj.glob(\\\\\"ge* ga*\\\\\"))\n > [\\'geo1\\', \\'geo2\\', \\'garbage\\']\n > >>> names(obj.glob(\\\\\"g* ^ga*\\\\\"))\n > [\\'geo1\\', \\'geo2\\', \\'grid\\']\n\n See also hou.Node.recursiveGlob.\n\n\n '''\n def recursiveGlob(self, pattern: str, filter: EnumValue = ..., include_subnets: bool = ...) -> Tuple[Node,...]:\n \"\"\"\n\n recursiveGlob(self, pattern, filter=hou.nodeTypeFilter.NoFilter,\n include_subnets=True) -> tuple of hou.Node\n\n Like hou.Node.glob, return a tuple of children nodes whose name\n matches the pattern. However, any matching child will have all its\n children added, recursively. As well, the result may be filtered by\n node type.\n\n Houdini first matches children nodes against the pattern, then\n recursively adds the subchildren of matching children, and then\n applies the filter.\n\n\n pattern\n Child node names will be matched against this string pattern.\n See hou.Node.glob and hou.NodeBundle for information about the\n pattern syntax. Note that if a child node matches the pattern\n and include_subnets is True, all of its subchildren will be\n added to the result (subject to filtering), regardless of the\n pattern.\n\n filter\n A hou.nodeTypeFilter enumeration value to limit matched nodes to\n a particular type (e.g. object nodes, geometry object nodes,\n surface shader SHOPs, etc.).\n\n include_subnets\n Specifies whether the children of a matching node will also be\n returned, regardless of the pattern.\n\n The pattern and filter behavior is very similar to that used by node\n bundles in Houdini. See hou.NodeBundle for more information.\n\n Raises hou.OperationFailed if the pattern is invalid.\n\n\n \"\"\"\n def createNode(self, node_type_name: str, node_name: Optional[str] = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False, force_valid_node_name: bool = False) -> Node:\n '''\n\n createNode(self, node_type_name, node_name=None, run_init_scripts=True,\n load_contents=True, exact_type_name=False, force_valid_node_name=False)\n -> hou.Node\n\n Create a new node of type node_type_name as a child of this node.\n\n\n node_name\n The name of the new node. If not specified, Houdini appends a\n number to the node type name, incrementing that number until a\n unique node name is found. If you specify a name and a node\n already exists with that name, Houdini will append a number to\n create a unique name.\n\n run_init_scripts\n If True, the initialization script associated with the node type\n will be run on the new node.\n\n load_contents\n If True, any subnet contents will be loaded for custom subnet\n operators.\n\n exact_type_name\n If True, the node\\'s type name will be exactly as specified in\n the node_type_name. Otherwise, a preferred operator type that\n matches the given node_type_name may be used. For example, the\n given hda may match a newer version hda::2.0, or if there are\n two available operators namespaceA::hda and namespaceB::hda, and\n the namespaceB has precedence, then the created node will be of\n type namespaceB::hda.\n\n force_valid_node_name\n If True, then create a new node with a valid name even if\n node_name is invalid. For example, if node_name is =foo bar=,\n then the new node name becomes =foo_bar=. If\n force_valid_node_name is False and node_name is invalid, then\n raise a hou.OperationFailed exception.\n\n Raises hou.OperationFailed if the given node name is invalid and\n force_valid_node_name is False. Raises hou.OperationFailed if this\n node cannot contain children. Raises hou.PermissionError if this\n node is inside a locked asset.\n\n > >>> obj = hou.node(\\\\\"/obj\\\\\")\n > \n > # Let Houdini choose a name based on the node type name.\n > >>> obj.createNode(\\\\\"geo\\\\\")\n > \n > \n > # Let Houdini choose a unique name.\n > >>> obj.createNode(\\\\\"geo\\\\\")\n > \n > \n > # Give the node a specific name.\n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"foo\\\\\")\n > \n > \n > # Let Houdini create a unique name from our suggested name. Also, don\\'t\n > # run the geometry object init scripts so the contents are empty.\n > >>> obj.createNode(\\\\\"geo\\\\\", \\\\\"geo1\\\\\", run_init_scripts=False)\n > \n > >>> obj.node(\\\\\"geo1\\\\\").children()\n > (,)\n > >>> obj.node(\\\\\"geo3\\\\\").children()\n > ()\n\n '''\n def inputIndex(self, input_name: str) -> int:\n \"\"\"\n\n inputIndex(self, input_name)\n\n Obtains an index of a node input that has the given name.\n\n For the node categories that use input names, it returns the index\n of the input with the given name. For VOP nodes, the name may also\n be a node parameter name that has a corresponding input.\n\n\n \"\"\"\n def outputIndex(self, output_name: str) -> int:\n \"\"\"\n\n outputIndex(self, output_name)\n\n Obtains an index of a node output that has the given name.\n\n For the node categories that use input names, it returns the index\n of the output with the given name.\n\n\n \"\"\"\n def setInput(self, input_index: int, item_to_become_input: NetworkMovableItem|None, output_index: int = ...) -> None:\n \"\"\"\n\n setInput(self, input_index, item_to_become_input, output_index=0)\n\n If item_to_become_input is not None, connect the output connector of\n another node to an input connector of this node. Otherwise,\n disconnect anything connected to the input connector.\n\n\n input_index\n The index of this node's input connector.\n\n item_to_become_input\n If None this method disconnects everything from the input\n connector. If a hou.Node or a hou.SubnetIndirectInput, this\n method connects its output to this node's input connector.\n\n output_index\n The index of the other node's output connector.\n\n Raises hou.InvalidInput if output_index is invalid. Raises\n hou.OperationFailed if item_to_become_input is not in the same\n network as this node. Raises hou.PermissionError if the node is\n inside a locked asset.\n\n\n \"\"\"\n def setNamedInput(self, input_name: str, item_to_become_input: NetworkMovableItem, output_name_or_index: str|int) -> None:\n \"\"\"\n\n setNamedInput(self, input_name, item_to_become_input,\n output_name_or_index)\n\n Connects an input on this node, specified by input_name, to an\n output on the item_to_become_input, specified by either an output\n name or an an output index.\n\n\n \"\"\"\n def setFirstInput(self, item_to_become_input: NetworkMovableItem|None, output_index: int = ...) -> None:\n \"\"\"\n\n setFirstInput(self, item_to_become_input, output_index=0)\n\n A shortcut for self.setInput(0, item_to_become_input). See\n hou.Node.setInput for more information.\n\n\n \"\"\"\n def setNextInput(self, item_to_become_input: NetworkMovableItem, output_index: int = 0, unordered_only: bool = False) -> None:\n '''\n\n setNextInput(self, item_to_become_input, output_index=0,\n unordered_only=False)\n\n Connect the output connector from another node into the first\n unconnected input connector or a multi-input connector of this node.\n If a node has some ordered inputs followed by a multi-input\n connector, the unordered_only parameter can be used to force the\n input to connect to the unordered multi-input connection instead of\n any of the ordered input which may not be connected.\n\n This method is roughly equivalent to:\n\n > for input_index, connectors in enumerate(self.inputConnectors()):\n > if len(connectors) == 0:\n > self.setInput(input_index, item_to_become_input, output_index)\n > raise hou.InvalidInput(\\\\\"All inputs are connected\\\\\")\n\n Raises hou.InvalidInput if all inputs are connected. See\n hou.Node.setInput for more information.\n\n\n '''\n def insertInput(self, input_index: int, item_to_become_input: NetworkMovableItem, output_index: int = 0) -> None:\n \"\"\"\n\n insertInput(self, input_index, item_to_become_input, output_index=0)\n\n Insert an input wire. In other words, for each input connector after\n input_index, shift the contents of that input connector to the next\n one, and then call hou.Node.setInput. See hou.Node.setInput for the\n meanings of the parameters.\n\n\n \"\"\"\n def numOrderedInputs(self) -> int:\n \"\"\"\n\n numOrderedInputs(self) -> int\n\n Some nodes can have a small number of dedicated inputs with specific\n meanings, followed by an arbitrary number of additional inputs,\n where gaps are not permitted between the inputs (these are referred\n to as unordered inputs). This is common in DOP nodes such as the\n Multiple Solver DOP. This function returns the number of dedicated\n (or ordered) inputs that occur before the unordered inputs begin.\n This function will only return non-zero values if the\n hou.NodeType.hasUnorderedInputs function for this node's\n hou.Node.type object returns True.\n\n\n \"\"\"\n def inputs(self) -> Tuple[Self|None,...]:\n \"\"\"\n\n inputs(self) -> tuple of hou.Node\n\n Return a tuple of the nodes connected to this node's inputs. If an\n input is connected to a hou.SubnetIndirectInput, the node connected\n to the corresponding input on the parent subnet is returned. In\n other words the presence of the indirect input is hidden. This means\n the resulting nodes may not all be siblings of the calling node.\n\n If a particular input is not connected (or is connected to an\n indirect input and the corresponding subnet parent input is not\n connected), a None value is placed in the tuple at that location.\n\n\n \"\"\"\n def inputsFollowingOutputs(self) -> Tuple[Node, ...]:\n \"\"\"\n\n inputsFollowingOutputs(self) -> tuple of hou.Node\n\n Return a tuple of the nodes connected to this node's inputs.\n\n If an input is connected to a hou.SubnetIndirectInput, the node\n connected to the corresponding input on the parent subnet is\n returned. In other words the presence of the indirect input is\n hidden. This means the resulting nodes may not all be siblings of\n the calling node.\n\n In addition, if the input is connected to a non-primary output in\n SOPs, the returned node will be the node inside of the SOP network\n rather than the subnet itself. This can be used for code that\n doesn't understand multiple outputs as it will attempt to resolve\n the node whose first output matches the input of this node.\n\n If the input is not connected (or is connected to an indirect input\n and the corresponding subnet parent input is not connected), a None\n value is returned.\n\n If a particular input is not connected (or is connected to an\n indirect input and the corresponding subnet parent input is not\n connected), a None value is placed in the tuple at that location.\n\n\n \"\"\"\n def input(self, input_index: int) -> Self|None:\n \"\"\"\n\n input(self, inputidx) -> hou.Node\n\n Return the node connected to specified input of this node. If an\n input is connected to a hou.SubnetIndirectInput, the node connected\n to the corresponding input on the parent subnet is returned. In\n other words the presence of the indirect input is hidden. This means\n the resulting nodes may not all be siblings of the calling node.\n\n If the input is not connected (or is connected to an indirect input\n and the corresponding subnet parent input is not connected), a None\n value is returned.\n\n\n \"\"\"\n def inputFollowingOutputs(self, input_index: int) -> Self|None:\n \"\"\"\n\n inputFollowingOutputs(self, inputidx) -> hou.Node\n\n Return the node connected to specified input of this node. If an\n input is connected to a hou.SubnetIndirectInput, the node connected\n to the corresponding input on the parent subnet is returned. In\n other words the presence of the indirect input is hidden. This means\n the resulting nodes may not all be siblings of the calling node.\n\n In addition, if the input is connected to a non-primary output in\n SOPs, the returned node will be the node inside of the SOP network\n rather than the subnet itself. This can be used for code that\n doesn't understand multiple outputs as it will attempt to resolve\n the node whose first output matches the input of this node.\n\n If the input is not connected (or is connected to an indirect input\n and the corresponding subnet parent input is not connected), a None\n value is returned.\n\n\n \"\"\"\n def inputConnections(self) -> Tuple[NodeConnection, ...]:\n '''\n\n inputConnections(self) -> tuple of hou.NodeConnection\n\n Returns a tuple of hou.NodeConnection objects for the connections\n coming into the top of this node. The tuple will have a length equal\n to the number of connections coming into the node. Returns an empty\n tuple if nothing is connected to this node.\n\n To get a list of the connected nodes themselves, use\n hou.Node.inputs. To get a list of all possible connection sites\n (whether or not anything is connected to them), use\n hou.Node.inputConnectors.\n\n > >>> cookie = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\").createNode(\\\\\"cookie\\\\\")\n > >>> cookie.setInput(1, cookie.parent().createNode(\\\\\"box\\\\\"))\n > >>> cookie.inputConnections()\n > (,)\n > >>> cookie.inputConnectors()\n > ((), (,))\n\n See also hou.Node.inputConnectors.\n\n\n '''\n def inputConnectors(self) -> Iterator[Tuple[NodeConnection, ...]]:\n \"\"\"\n\n inputConnectors(self) -> tuple of tuple of hou.NodeConnection\n\n Return a tuple of tuples of hou.NodeConnection objects. The length\n of the result tuple is equal to the maximum number of inputs that\n can be connected to this node. Each subtuple contains exactly one\n node connection if something is wired into the connector; otherwise\n it is the empty tuple.\n\n See also hou.NodeConnection and hou.Node.inputConnections.\n\n\n \"\"\"\n def inputAncestors(self, include_ref_inputs: bool = True, follow_subnets: bool = False, only_used_inputs: bool = False) -> Tuple[Node, ...]:\n \"\"\"\n\n inputAncestors(self, include_ref_inputs=True, follow_subnets=False,\n only_used_inputs=False) -> tuple of hou.Node\n\n Return a tuple of all input ancestors of this node. If\n include_ref_inputs is False, then reference inputs are not\n traversed. If follow_subnets is True, then instead of treating\n subnetwork nodes as a single node, we also traverse its children\n starting with its display node. If only_used_inputs is True, we only\n traverse nodes that were involved in the last cook.\n\n See also the inputs() method.\n\n\n \"\"\"\n def inputNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n inputNames(self) -> tuple of str\n\n Returns a tuple of all input names for this node. Names for input\n connectors that are hidden are also included.\n\n\n \"\"\"\n def inputLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n inputLabels(self) -> tuple of str\n\n Returns a tuple of all input labels for this node. Labels for input\n connectors that are hidden are also included.\n\n\n \"\"\"\n def editableInputStrings(self, input_index: int) -> dict[str, str]: ...\n def editableInputString(self, input_index: int, key: str) -> str: ...\n def setEditableInputString(self, input_index: int, key: str, value: str) -> None: ...\n def outputNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n outputNames(self) -> tuple of str\n\n Returns a tuple of all output names for this node.\n\n\n \"\"\"\n def outputLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n outputLabels(self) -> tuple of str\n\n Returns a tuple of all output labels for this node.\n\n\n \"\"\"\n def outputs(self) -> Tuple[Self,...]:\n \"\"\"\n\n outputs(self) -> tuple of hou.Node\n\n Return a tuple of the nodes connected to this node's outputs.\n\n This method is a shortcut for [connection.outputNode() for\n connection in self.outputConnections()].\n\n\n \"\"\"\n def outputConnections(self) -> Tuple[NodeConnection, ...]:\n '''\n\n outputConnections(self) -> tuple of hou.NodeConnection\n\n Return a tuple of NodeConnection objects for the connections going\n out of the bottom of this node. If nothing is wired into the output\n of this node, return an empty tuple.\n\n To get a list of the connected nodes themselves, use\n hou.Node.outputs.\n\n Note that this method is a shortcut for: reduce(lambda a, b: a+b,\n self.outputConnectors(), ()). Since most nodes have only one output\n connector, though, this method is usually equivalent to\n self.outputConnectors()[0].\n\n > >>> box = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\").createNode(\\\\\"box\\\\\")\n > >>> box.parent().createNode(\\\\\"xform\\\\\").setFirstInput(box)\n > >>> box.parent().createNode(\\\\\"subdivide\\\\\").setFirstInput(box)\n > >>> box.outputConnections()\n > (, )\n\n See also hou.node.outputConnectors.\n\n\n '''\n def outputConnectors(self) -> Iterator[Tuple[NodeConnection, ...]]:\n '''\n\n outputConnectors(self) -> tuple of tuple of hou.NodeConnection\n\n Return a tuple of tuples of hou.NodeConnection objects. The length\n of the result tuple is equal to the number of output connectors on\n this node. Each subtuple contains all the connections going out of\n that connector, and is empty if nothing is wired to that connector.\n\n > >>> split = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"dopnet\\\\\").createNode(\\\\\"split\\\\\")\n > >>> split.parent().createNode(\\\\\"rbdsolver\\\\\").setFirstInput(split)\n > >>> split.parent().createNode(\\\\\"gravity\\\\\").setFirstInput(split, 1)\n > >>> split.parent().createNode(\\\\\"merge\\\\\").setFirstInput(split, 1)\n > >>> split.outputConnectors()\n > ((,), (, ), (), ())\n\n See also hou.NodeConnection and hou.Node.outputConnections.\n\n\n '''\n def children(self) -> Tuple[Node, ...]:\n \"\"\"\n\n children(self) -> tuple of hou.Node\n\n Return a list of nodes that are children of this node. Using the\n file system analogy, a node's children are like the contents of a\n folder/directory.\n\n To find the number of children nodes, use len(node.children()).\n\n The order of the children in the result is the same as the user\n defined ordering in Houdini. To see this order, switch the network\n view pane into list mode, and ensure that the list order is set to\n user defined. To reorder nodes, drag and drop them in the list.\n\n > def pc(node):\n > '''Print the names of the children of a particular node. This function\n > can be handy when working interactively in the Python shell.'''\n > for child in node.children():\n > print child.name()\n > \n > def ls():\n > '''Print the names of the nodes under the current node.'''\n > pc(hou.pwd())\n\n The following expression evaluates to a list of children of a\n particular node type:\n\n > [c for c in node.children() if c.type() == node_type]\n\n \"\"\"\n def allSubChildren(self, top_down: bool = True, recurse_in_locked_nodes: bool = True, sync_delayed_definition: bool = False) -> Tuple[Node, ...]:\n '''\n\n allSubChildren(self, top_down=True, recurse_in_locked_nodes=True,\n sync_delayed_definition=False) -> tuple of hou.Node\n\n Recursively return all sub children of this node. For example,\n hou.node(\\\\\"/\\\\\").allSubChildren() will return all the nodes in the hip\n file.\n\n\n top_down\n If True, this function will do a top-down traversal, placing a\n node in the returned tuple before its children. If False, it\n will do a bottom-up traversal, placing children before their\n parents.\n\n recurse_in_locked_nodes\n If True, the function will recurse inside locked child nodes\n (child nodes for which the isEditable() method returns False)\n and include children of the locked child nodes in the returned\n tuple.\n\n If False, the function will not recurse inside locked children\n nodes, and children of the locked child nodes will not be\n included in the returned tuple. (The locked child nodes,\n however, will be included.)\n\n For example if is True and\n hou.node(\\\\\"/obj/geo1\\\\\") contains a Platonic Solids node (a locked\n node), then the tuple returned by\n hou.node(\\\\\"/obj\\\\\").allSubChildren() will include the Platonic\n Solids node and its child nodes. If is\n False, the returned tuple will contain the Platonic Solids node,\n but not its child nodes.\n\n sync_delayed_definition\n The contents of nodes may some times not be loaded until the\n node is evaluated. To avoid expanding all nodes unnecessarily,\n by default these are left un-expanded so the contents will not\n be returned. Setting to True will\n recursively sync all children, fully instantiating the entire\n network, and returning all the synced nodes.\n\n Note that a tuple is returned, not a generator. This means that it\n is safe to delete or create nodes while looping through the return\n value.\n\n The following function deletes all children of a particular type\n that appear anywhere inside a given node:\n\n > def removeSubChildrenOfType(node, node_type):\n > \\'\\'\\'Recursively delete all children of a particular type.\\'\\'\\'\n > for child in node.allSubChildren():\n > if child.type() == node_type:\n > child.destroy()\n\n This code, for example, removes all the visibility SOPs anywhere\n under /obj:\n\n > >>> removeSubChildrenOfType(hou.node(\\\\\"/obj\\\\\"), hou.sopNodeTypeCategory().nodeTypes()[\\'visibility\\'])\n\n '''\n def selectedChildren(self, include_hidden: bool = False, include_hidden_support_nodes: bool = False) -> Tuple[Node, ...]:\n '''\n\n selectedChildren(self, include_hidden=False,\n include_hidden_support_nodes=False) -> tuple of hou.Node\n\n Return a tuple containing the children of this node that are\n selected. Note that the last selected node has special meaning, and\n can also be retrieved with hou.Node.isCurrent.\n\n\n include_hidden\n If False, hidden nodes are not included in the result, even if\n they are selected.\n\n include_hidden_support_nodes\n If True, include in the returned tuple any hidden nodes that\n exist solely to support nodes that are actually selected. This\n specifically refers to VOP Parameter nodes, but may include\n other support nodes as well.\n\n The following example will print the names of all selected objects\n in /obj:\n\n > for n in hou.node(\\\\\"/obj\\\\\").selectedChildren():\n > print n.name()\n\n To find the total number of selected children nodes, use\n len(node.selectedChildren()).\n\n\n '''\n def allItems(self) -> Tuple[NetworkMovableItem, ...]:\n \"\"\"\n\n allItems(self) -> tuple of hou.NetworkMovableItem\n\n Return a tuple containing all the children of this node. Unlike\n children, this method will also return hou.NetworkBox,\n hou.SubnetIndirectInput, hou.StickyNote, and hou.NetworkDot objects.\n\n\n \"\"\"\n def allSubItems(self, top_down: bool = True, recurse_in_locked_nodes: bool = True, sync_delayed_definition: bool = False) -> Tuple[NetworkMovableItem, ...]:\n '''\n\n allSubItems(self, top_down=True, recurse_in_locked_nodes=True,\n sync_delayed_definition=False) -> tuple of hou.NetworkMovableItem\n\n Recursively return all sub items (nodes, network boxes, sticky\n notes, etc.) in this node. For example, hou.node(\\\\\"/\\\\\").allSubItems()\n will return all the node network items in the hip file.\n\n Refer to hou.Node.allSubChildren for more information on the method\n parameters.\n\n\n '''\n def selectedItems(self, include_hidden: bool = False, include_hidden_support_nodes: bool = False) -> Tuple[NetworkMovableItem, ...]:\n '''\n\n selectedItems(self, include_hidden=False,\n include_hidden_support_nodes=False) -> tuple of hou.NetworkMovableItem\n\n Return a tuple containing the children of this node that are\n selected. Unlike selectedChildren, this method will also return any\n selected hou.NetworkBox, hou.SubnetIndirectInput, hou.StickyNote,\n and hou.NetworkDot objects.\n\n\n include_hidden\n If False, hidden nodes are not included in the result, even if\n they are selected. Other network item types cannot be hidden,\n and so are unaffected by the value of this parameter.\n\n include_hidden_support_nodes\n If True, include in the returned tuple any hidden nodes that\n exist solely to support nodes that are actually selected. This\n specifically refers to VOP Parameter nodes, but may include\n other support nodes as well.\n\n The following example will print the positions of all selected items\n in /obj:\n\n > for n in hou.node(\\\\\"/obj\\\\\").selectedItems():\n > print n.position()\n\n '''\n def numItems(self, item_type: Optional[EnumValue] = None, selected_only: bool = False, include_hidden: bool = False) -> int: ...\n def deleteItems(self, items: Iterable[NetworkMovableItem], disable_safety_checks: bool = ...) -> None:\n \"\"\"\n\n deleteItems(self, items, disable_safety_checks=False)\n\n Destroys all the items in the provided tuple of\n hou.NetworkMovableItem objects. This is significantly more efficient\n than looping over the items and calling destroy() on each one. It\n also safely handles cases where one object may not be allowed to be\n deleted unless another object is also deleted.\n\n Raises hou.OperationFailed if one or more of the provided items is\n not a child of this node. Raises hou.PermissionError if this node is\n or is inside a locked digital asset.\n\n When disable_safety_checks is True, this disables safety checks that\n might otherwise crash Houdini when this method is called while nodes\n are cooking.\n\n\n \"\"\"\n def copyItemsToClipboard(self, items: Iterable[NetworkMovableItem]) -> None:\n \"\"\"\n\n copyItemsToClipboard(self, items)\n\n Given a sequence of child items (nodes, network boxes, sticky notes,\n etc), save them to the clipboard so they can be pasted into this or\n another network.\n\n\n items\n A sequence of hou.NetworkMovableItems that are children of this\n node.\n\n Raises hou.OperationFailed if any of the nodes or network boxes are\n node children of this node. Raises hou.PermissionError if you do not\n have permission to read the contents of this node.\n\n\n \"\"\"\n def pasteItemsFromClipboard(self, position: Optional[Vector2] = None) -> None:\n \"\"\"\n\n pasteItemsFromClipboard(self, position = None)\n\n Load the contents of a file saved with hou.Node.copyItemsToClipboard\n into the contents of this node. If the position parameter is given\n as a tuple of two float values (or equivalent, like a hou.Vector2),\n the pasted items are moved such that they are centered around the\n provided position.\n\n Raises hou.OperationFailed if this node is not a network, or if\n there are errors loading the items from the clipboard. Raises\n hou.PermissionError if this node is a locked instance of a digital\n asset.\n\n\n \"\"\"\n def copyItems(self, items: Sequence[NetworkMovableItem], channel_reference_originals: bool = False, relative_references: bool = True, connect_outputs_to_multi_inputs: bool = False) -> Tuple[NetworkMovableItem, ...]:\n \"\"\"\n\n copyItems(self, items, channel_reference_originals = False,\n relative_references = True, connect_outputs_to_multi_inputs = True) ->\n tuple of hou.NetworkMovableItem\n\n Create copies of all specified items in this network. The items do\n not need to be children of this network, but all items must be\n contained in the same parent network.\n\n If channel_reference_originals is True, the parameters of all new\n nodes are set to channel reference the original nodes. If a copied\n node is a sub-network, only the top level node establishes channel\n references to the original. Child nodes inside the sub-network will\n be simple copies of the original child nodes. The\n relative_references parameter controls whether the channel\n references use relative or absolute paths to the source nodes.\n\n If connect_outputs_to_multi_inputs is True, and any items being\n copied have outputs connected to a multi-input node (like a Merge),\n then the new item copies will also be connected to the multi-input\n node. Normally copied nodes do not have any outputs to nodes outside\n the copied set.\n\n Returns a tuple of all the new network items.\n\n Raises hou.OperationFailed if this node cannot contain children.\n Raises hou.PermissionError if this node is inside a locked asset.\n\n\n \"\"\"\n def creator(self) -> Node:\n \"\"\"\n\n creator(self) -> Node\n\n Returns the first parent of different type from this node. For\n simple networks this will be the same as parent(), but if the parent\n is the same node type, eg, both are SOPs, the process is repeated\n until a different type is found. This is useful for finding the\n container node, for example, the Object that a SOP is in, without\n having to worry about nested SOP networks. Note that SOPs do not\n always have Objects as parents, however!\n\n\n \"\"\"\n def network(self) -> Optional[Node]: ...\n def moveToGoodPosition(self, relative_to_inputs: bool = True, move_inputs: bool = True, move_outputs: bool = True, move_unconnected: bool = True) -> Vector2:\n \"\"\"\n\n moveToGoodPosition(self, relative_to_inputs=True, move_inputs=True,\n move_outputs=True, move_unconnected=True) -> hou.Vector2\n\n Moves a node to a well-spaced position near its inputs or outputs\n and returns the new position of the node.\n\n\n \"\"\"\n def layoutChildren(self, items: Sequence[NetworkMovableItem] = ..., horizontal_spacing: float = ..., vertical_spacing: float = ...) -> None:\n \"\"\"\n\n layoutChildren(self, items=(), horizontal_spacing=-1.0,\n vertical_spacing=-1.0)\n\n Automatically position all or some children of this node in the\n network editor.\n\n\n items\n A sequence of child hou.NetworkMovableItem objects to position.\n This may include nodes, dots, and/or subnet inputs. If this\n sequence is empty, this method will reposition all child items\n of this node.\n\n horizontal_spacing\n A fraction of the width and height of a tile that affects the\n space between nodes with common inputs. If this parameter is -1,\n Houdini uses the default spacing.\n\n vertical_spacing\n A fraction of the width and height of a tile that affects the\n space between a node and its output nodes. If this parameter is\n -1, Houdini uses the default spacing.\n\n\n \"\"\"\n def isCurrent(self) -> bool:\n \"\"\"\n\n isCurrent(self) -> bool\n\n Return a boolean to indicate of the node is the last selected node\n in its network.\n\n Each network (i.e. node containing children) stores its own list of\n selected nodes, and the last selected node has special meaning. For\n example, it is the node displayed in unpinned parameter panes.\n\n See also hou.selectedNodes to get a tuple of all the selected nodes\n in all networks in Houdini. The last node in this list also has\n special meaning in Houdini, and corresponds to the global current\n node.\n\n\n \"\"\"\n def setCurrent(self, on: bool, clear_all_selected: bool = False) -> None:\n \"\"\"\n\n setCurrent(self, on, clear_all_selected=False)\n\n Set or unset this node as the last selected one.\n\n Each network (i.e. node containing children) stores its own list of\n selected nodes, and the last selected node has special meaning. For\n example, it is the node displayed in unpinned parameter panes.\n\n If on is True, this node will become the last selected node. If it\n is False and this node was the last selected one, it will be\n unselected and the second-last selected node will become the last\n selected node.\n\n If clear_all_selected is true, Houdini will unselect every node in\n this network before performing the operation.\n\n See also hou.Node.setSelected and hou.selectedNodes.\n\n\n \"\"\"\n def isHidden(self) -> bool:\n \"\"\"\n\n isHidden(self)\n\n Return whether the node is hidden in the network editor. Note that\n Houdini also uses the term exposed to refer to nodes that are not\n hidden.\n\n If a visible node is connected to a hidden node, the network editor\n will display dashed lines for the wire going from the visible node\n to the hidden node.\n\n See also hou.Node.hide.\n\n\n \"\"\"\n def hide(self, on: bool) -> None:\n \"\"\"\n\n hide(self, on)\n\n Hide or show a node in the network editor. See hou.Node.isHidden for\n more information about hidden nodes.\n\n\n \"\"\"\n def comment(self) -> str:\n \"\"\"\n\n comment(self) -> str\n\n Return the node's comment string.\n\n\n \"\"\"\n def setComment(self, comment: str) -> None:\n \"\"\"\n\n setComment(self, comment)\n\n Sets the comment associated with this node. See also\n appendComment().\n\n\n \"\"\"\n def appendComment(self, comment: str) -> None:\n \"\"\"\n\n appendComment(self, comment)\n\n Appends the given text to the comment associated with this node.\n\n\n \"\"\"\n def destroy(self, disable_safety_checks: bool = False) -> None:\n \"\"\"\n\n destroy(self, disable_safety_checks=False)\n\n Delete this node.\n\n If you call methods on a Node instance after it has been destroyed,\n Houdini will raise hou.ObjectWasDeleted.\n\n Raises hou.OperationFailed if you try to delete a node inside a\n locked asset.\n\n When disable_safety_checks is True, this disables safety checks that\n might otherwise crash Houdini when this method is called while nodes\n are cooking.\n\n\n \"\"\"\n def networkBoxes(self) -> Tuple[NetworkBox, ...]:\n \"\"\"\n\n iterNetworkBoxes(self) -> generator of hou.NetworkBox\n\n Return a generator that iterates through all the network boxes\n inside this node.\n\n\n \"\"\"\n def iterNetworkBoxes(self) -> Iterator[NetworkBox]: ...\n def createNetworkBox(self, name: Optional[str] = None) -> NetworkBox:\n \"\"\"\n\n createNetworkBox(self, name=None) -> hou.NetworkBox\n\n Creates a network box inside this network. Raises\n hou.OperationFailed if this node is not a network.\n\n If you don't specify a name, Houdini gives the box a default name.\n\n Network box names are not displayed in the network editor pane.\n Instead, a comment can be specified with the\n hou.NetworkBox.setComment method, and this comment will appear in\n the title bar of the network box.\n\n\n \"\"\"\n def copyNetworkBox(self, network_box_to_copy: NetworkBox, new_name: Optional[str] = None, channel_reference_original: bool = False) -> NetworkBox:\n \"\"\"\n\n copyNetworkBox(self, network_box_to_copy, new_name=None,\n channel_reference_original=False) -> hou.NetworkBox\n\n Copies a network box and returns the copy.\n\n If new_name is given, the network box will be copied to a new\n network box named new_name (a different name will be generated if\n there is already a network box with that name).\n\n If channel_reference_original is True, all operators created by the\n copy will have their animatable parameters set to reference the\n original operators.\n\n Raises hou.OperationFailed if this node is not a network or if the\n node child type does not match the network box's node type.\n\n\n \"\"\"\n def findNetworkBox(self, name: str) -> Optional[NetworkBox]:\n \"\"\"\n\n findNetworkBox(self, name) -> hou.NetworkBox\n\n Return a network box with the given name inside this node, or None\n if no network box with the given name exists.\n\n\n \"\"\"\n def findNetworkBoxes(self, pattern: str) -> Tuple[NetworkBox, ...]:\n \"\"\"\n\n findNetworkBoxes(self, pattern) -> tuple of hou.NetworkBox\n\n Return a list of network boxes inside this node whose names match a\n pattern.\n\n\n \"\"\"\n def networkDots(self) -> Tuple[NetworkDot, ...]:\n \"\"\"\n\n networkDots(self) -> tuple of hou.NetworkDot\n\n Returns a tuple of all dots in this network.\n\n\n \"\"\"\n def createNetworkDot(self) -> NetworkDot:\n \"\"\"\n\n createNetworkDot(self) -> hou.NetworkDot\n\n Creates a network dot inside this network. Raises\n hou.OperationFailed if this node is not a network.\n\n\n \"\"\"\n def canCreateDigitalAsset(self) -> bool:\n \"\"\"\n\n canCreateDigitalAsset(self) -> bool\n\n Return True if a digital asset can be created from this node (for\n example, whether hou.OpNode.createDigitalAsset can succeed).\n\n\n \"\"\"\n def collapseIntoSubnet(self, child_items: Sequence[NetworkMovableItem], subnet_name: Optional[str] = None, subnet_type: Optional[str] = None) -> Node:\n \"\"\"\n\n collapseIntoSubnet(self, child_nodes, subnet_name=None,\n subnet_type=None) -> hou.Node\n\n Given a sequence of children nodes of this node, collapse them into\n a subnetwork. In other words, create a subnet inside this node's\n network and move the specified children of this network inside that\n subnet.\n\n\n child_nodes\n The children nodes of this node that will go in the new subnet.\n\n subnet_name\n The name for the new subnet node, or None if you want Houdini to\n automatically choose a name.\n\n subnet_type\n The type for the new subnet node, or None if you want Houdini to\n automatically choose a primary subnetwork type, which is\n recommended.\n\n Raises hou.OperationFailed if a node inside child_nodes is not a\n child of this network, or if child_nodes is an empty sequence.\n\n This example function takes a single node and replaces it with a\n subnet, moving the node into the subnet..\n\n > def collapseSingleNodeIntoSubnet(node, subnet_name=None):\n > node.parent().collapseIntoSubnet((node,), subnet_name=None)\n\n \"\"\"\n def extractAndDelete(self) -> Tuple[NetworkMovableItem, ...]:\n \"\"\"\n\n extractAndDelete(self) -> tuple of hou.NetworkMovableItem\n\n Move the children of this subnet node to become siblings of this\n node, and then delete this node. The method is the opposite of\n collapseIntoSubnet(). Returns a tuple containing all extracted\n items.\n\n Raises hou.InvalidNodeType if this node is not a subnetwork.\n\n\n \"\"\"\n def indirectInputs(self) -> Tuple[SubnetIndirectInput, ...]:\n \"\"\"\n\n indirectInputs(self) -> tuple of hou.SubnetIndirectInput\n\n Return the hou.SubnetIndirectInput objects of a subnet.\n\n Raises hou.InvalidNodeType if this node is not a subnetwork.\n\n\n \"\"\"\n def subnetOutputs(self) -> Tuple[Node, ...]:\n \"\"\"\n\n subnetOutputs(self) -> tuple of hou.Node\n\n Return the child output nodes of a subnetwork.\n\n Certain networks, such as SOPs, have special Output nodes to\n override the canonical Display or Render nodes and allow multiple\n outputs. If any output nodes are present, this returns a list of\n those nodes. If no output nodes are present, either the display or\n render node is returned depending on if the target of cooking is the\n display or an output driver. If the node has no children, an empty\n list is returned.\n\n\n \"\"\"\n def isSubNetwork(self) -> bool:\n \"\"\"\n\n isSubNetwork(self) -> bool\n\n Return True if the node is a sub-network and False otherwise.\n\n\n \"\"\"\n def setUserData(self, name: str, value: str) -> None:\n '''\n\n setUserData(self, name, value)\n\n Add/set a named string on this node instance.\n\n\n name\n A unique name (key) for the user-defined data. By using\n different names, you can attach multiple pieces of user-defined\n data to a node.\n\n value\n The string to store.\n\n This name/value pair is stored with the hip file and is included in\n the output from opscript and hou.Node.asCode.\n\n The following example illustrates how to set, access, and delete\n user-defined data:\n\n > >>> n = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\")\n > >>> n.setUserData(\\\\\"my data\\\\\", \\\\\"my data value\\\\\")\n > >>> n.userData(\\\\\"my data\\\\\")\n > \\'my data value\\'\n > >>> n.userDataDict()\n > {\\'my data\\': \\'my data value\\'}\n > >>> n.destroyUserData(\\\\\"my data\\\\\")\n > >>> n.userDataDict()\n > {}\n > >>> print n.userData(\\\\\"my data\\\\\")\n > None\n\n See per-node user-defined data for more information and examples.\n\n\n TIP\n If you prefix a user data key with nodeinfo_, the key (without\n the prefix) and the value will be shown as a custom field in the\n node info popup window.\n\n\n '''\n def destroyUserData(self, name: str, must_exist: bool = True) -> None:\n \"\"\"\n\n destroyUserData(self, name, must_exist=True)\n\n Remove the user-defined data with this name.\n\n See hou.Node.setUserData for more information.\n\n Raises hou.OperationFailed if no user data with this name exists and\n must_exist is True.\n\n\n \"\"\"\n def clearUserDataDict(self) -> None:\n \"\"\"\n\n clearUserDataDict(self)\n\n Remove all user-defined data.\n\n See hou.Node.setUserData for more information.\n\n\n \"\"\"\n def userDataDict(self) -> dict[str, str]:\n \"\"\"\n\n userDataDict(self) -> dict of str to str\n\n Return a dictionary containing all the user-defined name/string\n pairs for this node.\n\n See hou.Node.setUserData for more information.\n\n\n \"\"\"\n def userData(self, name: str) -> str|None:\n \"\"\"\n\n userData(self, name) -> str or None\n\n Return the user-defined data with this name, or None if no data with\n this name exists.\n\n See hou.Node.setUserData for more information.\n\n This method can be implemented as follows:\n\n > def userData(self, name):\n > return self.userDataDict().get(name)\n\n \"\"\"\n def createStickyNote(self, name: Optional[str] = None) -> StickyNote:\n \"\"\"\n\n createStickyNote(self, name=None) -> hou.StickyNote\n\n Creates a sticky note inside this network. Raises\n hou.OperationFailed if this node is not a network.\n\n If you don't specify a name, Houdini gives the note a default name.\n\n\n \"\"\"\n def stickyNotes(self) -> Tuple[StickyNote, ...]:\n \"\"\"\n\n iterStickyNotes(self) -> generator of hou.StickyNote\n\n Return a generator that iterates through all the sticky notes inside\n this node.\n\n\n \"\"\"\n def iterStickyNotes(self) -> Iterator[StickyNote]: ...\n def copyStickyNote(self, sticky_note_to_copy: StickyNote, new_name: Optional[str] = None) -> StickyNote:\n \"\"\"\n\n copyStickyNote(self, network_box_to_copy, new_name=None) ->\n hou.StickyNote\n\n Copies a sticky note and returns the copy.\n\n If new_name is given, the sticky note will be copied to a new sticky\n note named new_name (a different name will be generated if there is\n already a sticky note with that name).\n\n Raises hou.OperationFailed if this node is not a network or if the\n node child type does not match the sticky note's node type.\n\n\n \"\"\"\n def findStickyNote(self, name: str) -> Optional[StickyNote]:\n \"\"\"\n\n findStickyNote(self, name) -> hou.StickyNote\n\n Return a sticky note with the given name inside this node, or None\n if no sticky note with the given name exists.\n\n\n \"\"\"\n def findStickyNotes(self, pattern: str) -> Tuple[StickyNote, ...]:\n \"\"\"\n\n findStickyNotes(self, pattern) -> tuple of hou.StickyNote\n\n Return a list of sticky notes inside this node whose names match a\n pattern.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def createOutputNode(self, node_type_name: str, node_name: str | None = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False) -> Self: ...\n def createInputNode(self, input_index: int, node_type_name: str, node_name: str | None = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False) -> Self: ...\n def creationTime(self) -> datetime.datetime: ...\n def modificationTime(self) -> datetime.datetime: ...\n def outputsWithIndices(self, ignore_network_dots: bool = False, use_names: bool = False) -> list[tuple[NetworkMovableItem, int | str, int | str]]: ...\n\nclass ApexNode(Node):\n \"\"\"\n\n hou.ApexNode\n\n Represents an APEX node.\n\n This class represents an APEX node that lives in an APEX graph owned by\n the Houdini session. Each node has a unique session ID that can be used\n to obtain it from hou.apexNodeBySessionId().\n\n RELATED\n\n * hou.apexNodeBySessionId\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def inputName(self, input_index: int) -> str:\n \"\"\"\n\n inputName(self, input_index) -> str\n\n Returns the node input port name.\n\n\n \"\"\"\n def setInputName(self, input_index: int, name: str) -> None:\n \"\"\"\n\n setInputName(self, input_index, name)\n\n Sets the node input port name.\n\n\n \"\"\"\n def canRenameInput(self, input_index: int) -> bool:\n \"\"\"\n\n canRenameInput(self, input_index) -> bool\n\n Only variadic and dynamic ports can be renamed on APEX nodes. Use\n this to determine if an input can be renamed.\n\n\n \"\"\"\n def outputName(self, output_index: int) -> str:\n \"\"\"\n\n outputName(self, output_index) -> str\n\n Returns the node output port name.\n\n\n \"\"\"\n def setOutputName(self, output_index: int, name: str) -> None:\n \"\"\"\n\n setOutputName(self, output_index, name)\n\n Sets the node output port name.\n\n\n \"\"\"\n def canRenameOutput(self, output_index: int) -> bool:\n \"\"\"\n\n canRenameOutput(self, output_index) -> bool\n\n Only variadic and dynamic ports can be renamed on APEX nodes. Use\n this to determine if an output can be renamed.\n\n\n \"\"\"\n def convertSubgraphToSubnet(self) -> None:\n \"\"\"\n\n convertSubgraphToSubnet(self)\n\n Converts a node representing a subgraph asset into a subnet,\n maintaining all connections and parameters.\n\n\n \"\"\"\n def inputDataTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n inputDataTypes(self) -> tuple of str\n\n Returns a tuple of all input data types for this node.\n\n\n \"\"\"\n def outputDataTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n outputDataTypes(self) -> tuple of str\n\n Returns a tuple of all output data types for this node.\n\n\n \"\"\"\n def tags(self) -> Tuple[str, ...]:\n \"\"\"\n\n tags(self) -> tuple of str\n\n Returns a list of string tags for this node.\n\n\n \"\"\"\n def setTags(self, tags: Sequence[str]) -> None:\n \"\"\"\n\n setTags(self, tags)\n\n Sets the given list of string tags for this node.\n\n\n \"\"\"\n def isSubgraphAsset(self) -> bool:\n \"\"\"\n\n isSubgraphAsset(self) -> bool\n\n Returns true if this node represents a subgraph asset. This is\n similar in concept to a locked HDA subnet. These nodes have children\n that can be queried but are not editable.\n\n\n \"\"\"\n\nclass OpNode(Node):\n \"\"\"\n\n hou.OpNode\n\n The base class for all nodes in Houdini (objects, SOPs, COPs, etc.) An\n instance of this class corresponds to exactly one instance of a node in\n Houdini.\n\n Each node has a unique path that defines its location in the tree of\n nodes. The node path hierarchy is similar to the hierarchy of folders\n and files in a file system. Some nodes, called networks, may contain\n other nodes inside them, much like a file folder would, while other\n nodes may not. For example, an object node instance and a SOP subnetwork\n node instance may contain SOP nodes, but a box SOP instance may not.\n\n\n TIP\n Be careful not to confuse nodes with node types. A node is an\n instance of a node type. For example suppose /obj/geo1/box1 is a box\n SOP. It has its own unique name (box1) and its own copies of\n parameter values. It is an instance of the box SOP node type. This\n node type defines what parameters are common to all box SOP node\n instances, as well as the algorithm that each BOX SOP performs. The\n class that represents a node type is hou.NodeType.\n\n You cannot create instances of hou.Node using hou.Node.__init__.\n Instead, you look up Node objects corresponding to existing Houdini\n nodes with hou.node(). To create a new Houdini node instance inside\n another node, use hou.Node.createNode. To delete a Houdini node, use\n hou.Node.destroy.\n\n Note that a Node object internally stores a reference to the\n corresponding Houdini node, and that their lifetimes are different. If a\n Python node object is deleted because its reference count in Python goes\n to zero, the Houdini node will be unaffected. On the other hand, if you\n have a Node object in a Python variable and the Houdini node is deleted,\n the Python variable will still exist, and Python will not crash.\n Instead, if you later call a method on that Python Node object, Houdini\n will raise a hou.ObjectWasDeleted exception.\n\n Be careful not to confuse this class with the function hou.node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def creatorState(self) -> str:\n \"\"\"\n\n creatorState(self) -> str\n\n This returns the name of the viewport tool that was used to be\n created. This name is not set by default and is usually the empty\n string.\n\n\n \"\"\"\n def setCreatorState(self, state: str) -> None:\n \"\"\"\n\n setCreatorState(self, state)\n\n This sets the name of the tool that created this node. If you call\n this with a name that differs from the node type name, you should\n also call setBuiltExplicitly(False).\n\n\n \"\"\"\n def isBuiltExplicitly(self) -> bool: ...\n def setBuiltExplicitly(self, built_explicitly: bool) -> None: ...\n def expressionLanguage(self) -> EnumValue:\n \"\"\"\n\n expressionLanguage(self) -> hou.exprLanguage enum value\n\n Return the node's default expression language.\n\n When you enter an expression in a parameter that does not already\n contain an expression, the node's expression language is used to\n determine how that expression should be evaluated. You can change a\n node's expression language in the parameter dialog in the GUI.\n\n Changing the node's expression language will not change the language\n in parameters already containing expressions (i.e. parameters with\n keyframes).\n\n Note that if a parameter already contains an expression and you\n change that expression in the GUI, the expression language will not\n change, regardless of the value of the node's expression language.\n To change the language of an existing expression in a parameter from\n Python, use hou.Parm.setExpression, as in\n parm.setExpression(parm.expression(), language).\n\n\n \"\"\"\n def setExpressionLanguage(self, language: EnumValue) -> None:\n \"\"\"\n\n setExpressionLanguage(self, language)\n\n Set the node's default expression language. See expressionLanguage()\n for more information.\n\n\n \"\"\"\n def parm(self, parm_path: str) -> Optional[Parm]:\n \"\"\"\n\n parm(self, parm_path) -> hou.Parm or None\n\n Return the parameter at the given path, or None if the parameter\n doesn't exist.\n\n\n \"\"\"\n def parmTuple(self, parm_path: str) -> Optional[ParmTuple]:\n \"\"\"\n\n parmTuple(self, parm_path) -> hou.ParmTuple or None\n\n Return the parm tuple at the given path, or None if it doesn't\n exist.\n\n This method is similar to parm(), except it returns a hou.ParmTuple\n instead of a hou.Parm.\n\n\n \"\"\"\n def globParms(self, pattern: str, ignore_case: bool = False, search_label: bool = False, single_pattern: bool = False) -> Tuple[Parm, ...]:\n \"\"\"\n\n globParms(self, pattern, ignore_case=False, search_label=False,\n single_pattern=False) -> tuple of hou.Parm\n\n Return a tuple of parameters matching the pattern.\n\n The pattern may contain multiple pieces, separated by spaces. An\n asterisk (*) in a pattern piece will match any character. By\n default, Houdini will add the parameters from each pattern piece to\n those already matched. However, if the pattern piece begins with a\n caret (^), Houdini will remove the matches for that piece from the\n result.\n\n By default the pattern match is case-sensitive. Set ignore_case to\n True for case-insensitive pattern matching. Note that case\n insensitivity only applies when matching node and parameter names.\n It does not apply when matching group, network box or bundle names.\n\n By default, only parameters with names matching the pattern are\n returned. Set search_label to True to also return parameters with\n labels matching the pattern.\n\n If single_pattern is True, the pattern will be treated as one\n pattern even if there are spaces in the pattern.\n\n This method returns an empty tuple if you pass in an empty pattern.\n\n\n \"\"\"\n def parms(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n parms(self) -> tuple of hou.Parm\n\n Return a list of the parameters on this node.\n\n\n \"\"\"\n def parmsReferencingThis(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n parmsReferencingThis(self) -> tuple of hou.Parm\n\n Return a list of the parameters that reference this node.\n\n\n \"\"\"\n def parmTuples(self) -> Tuple[ParmTuple, ...]:\n \"\"\"\n\n parmTuples(self) -> tuple of hou.ParmTuple\n\n Return a list of all parameter tuples on this node.\n\n This method is similar to parms(), except it returns a list of\n hou.ParmTuple instead of hou.Parm.\n\n\n \"\"\"\n def spareParms(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n spareParms(self) -> tuple of hou.Parm\n\n Return a list of the spare (user-defined) parameters on this node.\n\n\n \"\"\"\n def removeSpareParms(self) -> None:\n \"\"\"\n\n removeSpareParms(self)\n\n Removes all spare parameters from this node.\n\n\n \"\"\"\n def syncNodeVersionIfNeeded(self, from_version: str) -> None:\n \"\"\"\n\n syncNodeVersionIfNeeded(self, from_version)\n\n Synchronize the node from the specified version to the current\n version of its HDA definition. See also hou.HDADefinition.version.\n\n\n \"\"\"\n def setParmTemplateGroup(self, parm_template_group: ParmTemplateGroup, rename_conflicting_parms: bool = False) -> None: ...\n def parmTuplesInFolder(self, folder_names: Sequence[str]) -> Tuple[ParmTuple, ...]:\n \"\"\"\n\n parmTuplesInFolder(self, folder_names) -> tuple of hou.ParmTuple\n\n Return a list of the parameter tuples in a folder on this node. This\n method is similar to parmsInFolder(), except it returns a list of\n hou.ParmTuple instead of hou.Parm. See parmsInFolder() above for\n information about the arguments.\n\n See also hou.Parm.containingFolders and\n hou.Parm.containingFolderSetParmTuples\n\n\n \"\"\"\n def parmsInFolder(self, folder_names: Sequence[str]) -> Tuple[Parm, ...]:\n '''\n\n parmsInFolder(self, folder_names) -> tuple of hou.Parm\n\n Return a list of parameters in a folder on this node. Returns all\n parameters in the folder and its subfolders (if any).\n\n\n folder_names\n A sequence of folder name strings. For example, to get a list of\n the parameters in the Shading folder of the Render folder, use\n (\\\\\"Render\\\\\", \\\\\"Shading\\\\\"). Note that by folder name, we mean the\n label used in the parameter dialog, not the internal parameter\n name.\n\n If this sequence is empty, the method returns all parameters on\n the node, the same as if you called parms().\n\n Raises hou.OperationFailed if the folder specified by folder_names\n does not exist.\n\n For example, suppose a node had a Render folder that contained a\n Shading subfolder. Then this line of code would return the\n parameters in the Render folder:\n\n > # Note the trailing comma after \\\\\"Render\\\\\" to tell Python that \\\\\"Render\\\\\" is\n > # contained in a tuple/sequence as opposed to just a single string with\n > # parentheses around it.\n > >>> node.parmsInFolder((\\\\\"Render\\\\\", ))\n\n And this line of code would return the parameters in the Shading\n subfolder.\n\n > >>> node.parmsInFolder((\\\\\"Render\\\\\", \\\\\"Shading\\\\\"))\n\n See also hou.Parm.containingFolders and\n hou.Parm.containingFolderSetParmTuples\n\n Note that this method does not work for multi-parameters, which\n behave similar to folder parameters. To get a list of parameters in\n a multi-parameter, call hou.Parm.multiParmInstances.\n\n\n '''\n def parmTemplateGroup(self) -> ParmTemplateGroup: ...\n def localVariables(self) -> Tuple[str, ...]:\n \"\"\"\n\n localVariables(self)\n\n Return a list of local variables that can be referenced in parameter\n expressions on this node using the $ prefix.\n\n\n \"\"\"\n def localAttributes(self) -> Tuple[str, ...]:\n \"\"\"\n\n localAttributes(self)\n\n Return a list of local variables that can be referenced in parameter\n expressions on this node using the @ prefix. This includes local\n variables defined in this node as attributes and any context options\n that were available to this node the last time it was cooked.\n\n\n \"\"\"\n def reorderChild(self, src: int, dest: int) -> None:\n \"\"\"\n\n reorderChild(src, dest)\n\n If this node is a network, re-order the user-defined order of its\n children by taking the child at index src and moving it to index\n dest, shifting over the children in between. After the reorder, the\n moving child will be directly before the child formerly at index\n dest. To move a child to the very end of the list, set dest to be\n equal to the number of children.\n\n Raises hou.OperationFailed if this node is not a network. Raises\n hou.PermissionError if this node is or is inside a locked digital\n asset.\n\n\n \"\"\"\n def references(self, include_children: bool = True) -> Tuple[Node, ...]:\n \"\"\"\n\n references(self, include_children = True) -> tuple of hou.Node\n\n Return a tuple of nodes that are referenced by this node, either\n through parameter expressions, referring to the node by name, or\n using expressions which rely on the data generated by another node.\n These reflect all the other ways (besides connecting to an input) in\n which one node may affect another.\n\n Note that the result can differ depending last cook of the nodes.\n It's recommended that you first call cook() on the node first.\n\n\n \"\"\"\n def dependents(self, include_children: bool = True) -> Tuple[Node, ...]:\n \"\"\"\n\n dependents(self, include_children = True) -> tuple of hou.Node\n\n Return a tuple of nodes that are reference this node, either through\n parameter expressions, referring to the node by name, or using\n expressions which rely on the data generated by this node. These\n reflect all the other ways (besides connecting to an input) in which\n one node may affect another.\n\n Note that the result can differ depending last cook of the nodes.\n\n\n \"\"\"\n def fileReferences(self, recurse: bool = ..., project_dir_variable: str = ..., include_all_refs: bool = ...) -> Sequence[Tuple[Parm, str]]:\n '''\n\n fileReferences(self, recurse = True, project_dir_variable = \\\\\"HIP\\\\\",\n include_all_refs = True) -> tuple of hou.Parm and str tuples\n\n Returns a sequence of tuples representing references to external\n files (such as textures, geometry files, and asset libraries) from\n this node. Applies to all sub children of this node if recurse is\n set to true.\n\n\n recurse\n Recursively apply to the entire operator hierarchy.\n\n project_dir_variable\n You can specify the name of an environment variable. If an asset\n path starts with the variable, it will be replaced with a\n variable reference in the path string returned by this function.\n\n include_all_refs\n If this is True, then the function will return all the file\n references. If this is False, then the function will return only\n the selected file references.\n\n See also hou.fileReferences\n\n\n '''\n def isTimeDependent(self, for_last_cook: bool = False) -> bool:\n \"\"\"\n\n isTimeDependent(self, for_last_cook=False) -> bool\n\n Return whether the node is time dependent. A time dependent node is\n re-evaluated every time the frame changes.\n\n By default, this will cook out-of-date nodes first to get the latest\n time dependency status. Pass in for_last_cook=True to get the time\n dependency status of the last node cook to avoid this.\n\n\n \"\"\"\n def allowEditingOfContents(self, propagate: bool = False) -> None:\n \"\"\"\n\n allowEditingOfContents(self, propagate=False)\n\n Unlocks a digital asset so its contents can be edited.\n\n To use this function, you must have permission to modify the HDA.\n\n\n \"\"\"\n def matchCurrentDefinition(self) -> None:\n \"\"\"\n\n matchCurrentDefinition(self)\n\n If this node is an unlocked digital asset, change its contents to\n match what is stored in the definition and lock it. The parameter\n values are unchanged.\n\n If this node is locked or is not a digital asset, this method has no\n effect.\n\n See also hou.Node.matchesCurrentDefinition and hou.Node.isLocked.\n\n\n \"\"\"\n def matchesCurrentDefinition(self) -> bool:\n \"\"\"\n\n matchesCurrentDefinition(self) -> bool\n\n Return whether the contents of the node are locked to its type\n definition.\n\n\n \"\"\"\n def syncDelayedDefinition(self) -> None:\n \"\"\"\n\n syncDelayedDefinition(self)\n\n If this node is a digital assets whose contents are currently in a\n delay-sync condition, the contents will be synced. If it is already\n synced or not a syncable asset, no effect occurs.\n\n\n \"\"\"\n def isDelayedDefinition(self) -> bool:\n \"\"\"\n\n isDelayedDefinition(self) -> bool\n\n If this node is a digital assets whose contents are currently in a\n delay-sync condition, returns true. Otherwise returns false, which\n will include nodes that are not syncable.\n\n\n \"\"\"\n def parmAliases(self, recurse: bool = False) -> dict[Parm, str]:\n \"\"\"\n\n parmAliases(self, recurse=False) -> dict of hou.Parm to str\n\n Return a dictionary of parameter aliases on the node's parameters.\n The keys in the dictionary are the parameters that have aliases and\n the values are the alias names.\n\n\n recurse\n Return the parameter aliases for this node and its children.\n\n\n \"\"\"\n def clearParmAliases(self) -> None:\n \"\"\"\n\n clearParmAliases(self)\n\n Removes all alias names from parameters on the node.\n\n\n \"\"\"\n def createCompiledDigitalAsset(self, name: Optional[str] = None, hda_file_name: Optional[str] = None, description: Optional[str] = None) -> None:\n \"\"\"\n\n createCompiledDigitalAsset(self, name=None, hda_file_name=None,\n description=None)\n\n Create a compiled digital asset from this node. You would typically\n call this method on VOP network nodes, such as Material Shader\n Builder SHOP, Surface Shader Builder SHOP, or VEX Surface SHOP Type\n VOPNET. The digital asset does not have contents section, which\n means it does not have VOP network inside, but instead relies on the\n saved VEX code sections to provide the shader code.\n\n After the creation of a compiled HDA, if its VEX code section is\n ever changed manually, the corresponding vex object code section can\n be recompiled using hou.HDADefinition.compileCodeSection.\n\n\n name\n The name of the node type that the new digital asset will\n define.\n\n hda_file_name\n The name of the hda file where Houdini will save the digital\n asset. If None Houdini will use\n $HOME/houdiniX.Y/hda/OPcustom.hda.\n\n description\n The name that will appear in the tab menu. If None, Houdini will\n use the name for the description.\n\n\n \"\"\"\n def isInsideLockedHDA(self) -> bool:\n \"\"\"\n\n isInsideLockedHDA(self) -> bool\n\n Return whether this node is inside a locked digital asset. If this\n node is not inside a locked HDA, the node may deviate from the HDA\n definition.\n\n\n \"\"\"\n def isEditableInsideLockedHDA(self) -> bool:\n \"\"\"\n\n isEditableInsideLockedHDA(self) -> bool\n\n Return False if the node is contained inside a locked HDA node and,\n is not marked as editable within that locked HDA, and True\n otherwise. In particular this function will return True for a node\n that is not inside a locked HDA (or not inside an HDA at all).\n\n\n \"\"\"\n def isLockedHDA(self) -> bool:\n \"\"\"\n\n isLockedHDA(self) -> bool\n\n If this node is an instance of a digital asset, return whether or\n not it is locked. Otherwise, return False.\n\n To differentiate between unlocked digital assets and nodes that are\n not instances of digital assets, check if the node's type has a\n definition:\n\n > def isUnlockedAsset(node):\n > return not node.isLockedHDA() and node.type().definition() is not None\n\n See hou.HDADefinition.updateFromNode for an example of how to save\n and lock all unlocked digital asset instances.\n\n\n \"\"\"\n def isCompiled(self) -> bool: ...\n def isMaterialManager(self) -> bool: ...\n def outputLabel(self, output_index: int) -> str:\n \"\"\"\n\n outputLabel(output_index) -> str\n\n Returns label of the specified output on this node. This function\n may return a generic label if the index refers to a non-existent\n output.\n\n\n \"\"\"\n def outputForViewFlag(self) -> int:\n \"\"\"\n\n outputForViewFlag(self) -> int\n\n Return an integer to indicate which output of the node should be\n used for display purposes.\n\n\n WARNING\n This method can return a negative number if a surface node asset\n uses an Output node with its index set to -1. Some nodes use\n this trick to show preview geometry in the viewer, so to be\n fully robust your code should deal with values less than 0\n (unfortunately it's not clear which output to actually use in\n the case).\n\n\n \"\"\"\n def setOutputForViewFlag(self, output: int) -> None:\n \"\"\"\n\n setOutputForViewFlag(self, output)\n\n Sets which output should be used for display purposes on this node.\n\n\n \"\"\"\n def hdaModule(self) -> HDAModule:\n \"\"\"\n\n hm(self) -> hou.HDAModule\n\n This method is a shortcut for self.hdaModule().\n\n See also hou.phm.\n\n\n \"\"\"\n def hdaViewerStateModule(self) -> Optional[HDAViewerStateModule]:\n \"\"\"\n\n hdaViewerStateModule(self) -> hou.HDAViewerStateModule\n\n This method creates an instance of hou.HDAViewerStateModule\n associated to the underlying Node.\n\n See also hou.NodeType.hdaViewerStateModule.\n\n\n \"\"\"\n def hdaViewerHandleModule(self) -> Optional[HDAViewerHandleModule]:\n \"\"\"\n\n hdaViewerHandleModule(self) -> hou.HDAViewerHandleModule\n\n This method creates an instance of hou.HDAViewerHandleModule\n associated to the underlying Node.\n\n See also hou.NodeType.hdaViewerHandleModule.\n\n\n \"\"\"\n def hm(self) -> HDAModule: ...\n def createDigitalAsset(self, name: Optional[str] = None, hda_file_name: Optional[str] = None, description: Optional[str] = None, min_num_inputs: int = 0, max_num_inputs: int = 0, compress_contents: bool = False, comment: Optional[str] = None, version: Optional[str] = None, save_as_embedded: bool = False, ignore_external_references: bool = False, compile_asset: bool = False, change_node_type: bool = True, create_backup: bool = True, install_path: Optional[str] = None) -> OpNode:\n \"\"\"\n\n createDigitalAsset(self, name=None, hda_file_name=None,\n description=None, min_num_inputs=0, max_num_inputs=0,\n compress_contents=False, comment=None, version=None,\n save_as_embedded=False, ignore_external_references=False,\n change_node_type=True, create_backup=True, install_path=None) -> Node\n\n Create a digital asset from this node. You would typically call this\n method on subnet nodes.\n\n\n name\n The name of the node type that the new digital asset will\n define.\n\n hda_file_name\n The name of the hda file where Houdini will save the digital\n asset. If None Houdini will use\n $HOME/houdiniX.Y/hda/OPcustom.hda.\n\n description\n The name that will appear in the tab menu. If None, Houdini will\n use the name for the description.\n\n min_num_inputs\n The minimum number of inputs that need to be wired into\n instances of the digital asset. See\n hou.HDADefinition.minNumInputs for more information.\n\n max_num_inputs\n The number of input connectors available on instances of the\n digital asset for input connections. See\n hou.HDADefinition.minNumInputs for more information.\n\n compress_contents\n Whether or not the contents of this digital asset are compressed\n inside the hda file. See hou.HDAOptions.compressContents for\n more information.\n\n comment\n A user-defined comment string. See hou.HDADefinition.comment for\n more information.\n\n version\n A user-defined version string. See hou.HDADefinition.version for\n more information.\n\n save_as_embedded\n Whether or not the digital asset's definition will be saved with\n the hip file instead of an hda file. When this parameter is\n True, Houdini ignores the hda_file_name parameter. Setting this\n parameter to True is equivalent to setting this parameter to\n False and setting the hda_file_name parameter to Embedded.\n\n ignore_external_references\n If True, Houdini will not generate warnings if the contents of\n this digital asset reference nodes outside the asset.\n\n change_node_type\n Normally, Houdini will change the node creating the digital\n asset into the new digital asset type. Setting this flag to\n false will cause the node to remain unchanged.\n\n create_backup\n Create a backup before modifying an existing hda file.\n\n install_path\n Where to install the new hda. When not specified, it will\n install to either Current HIP File or Scanned Asset Library\n Directories.\n\n\n \"\"\"\n def changeNodeType(self, new_node_type: str, keep_name: bool = True, keep_parms: bool = True, keep_network_contents: bool = True, force_change_on_node_type_match: bool = False) -> ChopNode:\n \"\"\"\n\n changeNodeType(self, new_node_type, keep_name=True, keep_parms=True,\n keep_network_contents=True, force_change_on_node_type_match=False) ->\n hou.Node\n\n Changes the node to a new type (within the same context).\n new_node_type is the internal string name of the type you want to\n change to.\n\n Keep_name, keep_parms, and keep_network_contents indicate that the\n node should keep the same name, parameter values, and contents,\n respectively, after its type has changed.\n force_change_on_node_type_match indicates whether to perform the\n change even when is already of the specified type.\n\n\n \"\"\"\n def selectNextVisibleWorkItem(self) -> None:\n \"\"\"\n\n selectNextVisibleWorkItem(self)\n\n If a work item is selected, selects the next visible work item\n\n\n \"\"\"\n def selectPreviousVisibleWorkItem(self) -> None:\n \"\"\"\n\n selectPreviousVisibleWorkItem(self)\n\n If a work item is selected, selects the previous work item\n\n\n \"\"\"\n def deselectWorkItem(self) -> None:\n \"\"\"\n\n deselectWorkItem(self)\n\n Deselects the active work item if this node is inside or contains\n the TOP network with the currently selected work item.\n\n\n \"\"\"\n def setCurrentTOPPage(self, page: int) -> None:\n \"\"\"\n\n setCurrentTOPPage(page_index)\n\n If a TOP node can't display all work items, sets which work item\n subset (page) will be displayed\n\n\n \"\"\"\n def canGenerateCookCode(self, check_parent: bool = False, check_auto_shader: bool = True) -> bool:\n \"\"\"\n\n canGenerateCookCode(self, check_parent=False, check_auto_shader=True) ->\n bool\n\n Return True if the node can generate compiled cook code and False\n otherwise.\n\n If check_parent is true, the parents in the ancestor hierarchy are\n tested if any of them can generate code.\n\n If the node cannot generate cook code explicitly, it might still be\n able to provide such code implicitly, if it can be wrapped in auto-\n shader. E.g., a building-block VOPs such as Anti-Aliased Noise don't\n generate a complete cook code; they provide code fragment that\n contributes to the full cook function. But sometimes they can be\n automatically wrapped in such a function, which which will act as\n cook code. If check_auto_shader is true, the node will be tested if\n it provides implicit cook code.\n\n\n \"\"\"\n def cookCodeGeneratorNode(self, check_parent: bool = ...) -> Node:\n \"\"\"\n\n cookCodeGeneratorNode(self, check_parent=False) -> hou.Node\n\n Return the node itself or a network node that contains this node and\n can generate compiled cook code. For example, the generator node for\n a VOP node could be the SHOP node or SOP node that contains it for\n example.\n\n Return None if this node cannot generate code and is not contained\n in a code generating node either either.\n\n\n \"\"\"\n def cookCodeLanguage(self) -> str:\n \"\"\"\n\n cookCodeLanguage(self) -> str\n\n Return the language of the generated cook code (i.e. VEX, RSL).\n\n Raises hou.OperationFailed if this node cannot generate compiled\n code.\n\n\n \"\"\"\n def supportsMultiCookCodeContexts(self) -> bool:\n \"\"\"\n\n supportsMultiCookCodeContexts(self) -> bool\n\n Return True if this node can generate compiled cook code for\n multiple contexts (i.e. surface context, displacement context, etc.)\n and False otherwise.\n\n Raises hou.OperationFailed if this node cannot generate compiled\n code.\n\n\n \"\"\"\n def saveCookCodeToFile(self, file_name: str, skip_header: bool = False, context_name: Optional[str] = None) -> None:\n '''\n\n saveCookCodeToFile(self, file_name, skip_header=False,\n context_name=None)\n\n Saves VEX/RSL source code to a disk file (on nodes that support\n this).\n\n\n file_name\n The file path in which to save the generated code.\n\n skip_header\n If True, the method does not write a header comment at the\n beginning of the file containing the file name and node path\n from which the code was generated and a time stamp.\n\n context_name\n A string containing name of the shader context for the code.\n This option applies to nodes such as the Material Shader Builder\n which can generate code for multiple context types.\n\n For example, a Material network might contain both surface and\n displacement shaders, so you must specify which type of shader\n code to generate:\n\n > node(\\\\\"/shop/vopmaterial1\\\\\").saveCookCodeToFile(\\\\\"myfile.vfl\\\\\", context_name=\\\\\"surface\\\\\")\n\n On single-context nodes this argument is ignored.\n\n For VEX materials, possible values are surface, displacement,\n light, shadow, fog, image3d, photon, or cvex.\n\n For RSL materials, possible values are surface, displacement,\n light, volume, or imager.\n\n\n '''\n def saveCodeToFile(self, file_name: str, skip_header: bool = False, context_name: Optional[str] = None) -> None: ...\n def saveCompiledCookCodeToFile(self, file_name: str, context_name: Optional[str] = None) -> None:\n \"\"\"\n\n saveCompiledCookCodeToFile(self, file_name, context_name=None)\n\n Saves compiled VEX code to a disk file (for nodes that support\n this). See hou.Node.saveCookCodeToFile for a description of the\n arguments.\n\n\n \"\"\"\n def saveToCompiledVexFile(self, file_name: str, context_name: Optional[str] = None) -> None: ...\n def cook(self, force: bool = ..., frame_range: Sequence[float] = ...) -> None:\n \"\"\"\n\n cook(self, force=False, frame_range=())\n\n Asks or forces the node to re-cook.\n\n\n frame_range\n The frames at which to cook the object. This should be a tuple\n of 2 or 3 ints giving the start frame, end frame, and optionally\n a frame increment, in that order. If you supply a two-tuple\n (start, end), the increment is 1.\n\n\n \"\"\"\n def needsToCook(self, time: float = ...) -> bool:\n \"\"\"\n\n needsToCook(self, time=hou.time()) -> bool\n\n Asks if the node needs to re-cook.\n\n\n \"\"\"\n def invalidateOutput(self) -> None:\n \"\"\"\n\n invalidateOutput(self)\n\n Invalidate this node's output data, dirtying the node and its\n dependents. If this node or any of its dependents are displayed in a\n UI pane (eg. a viewport), this will cause the panes the refresh and\n cook these nodes again.\n\n\n NOTE\n This method currently only invalidates the first output for\n nodes that have multiple outputs.\n\n\n \"\"\"\n def cookCount(self) -> int:\n \"\"\"\n\n cookCount(self) -> int\n\n Returns the number of times this node has cooked in the current\n session.\n\n\n \"\"\"\n def cookPathNodes(self) -> Tuple[Node, ...]:\n \"\"\"\n\n cookPathNodes(self) -> tuple of hou.Node\n\n Return a list of the nodes, including nodes in subnets, that were\n used in the last cook for the network this node belongs to.\n\n\n \"\"\"\n def infoTree(self, verbose: bool = False, debug: bool = False, output_index: int = 0, force_cook: bool = False) -> NodeInfoTree:\n \"\"\"\n\n infoTree(self, verbose=False, debug=False, output_index=0,\n force_cook=False) -> hou.NodeInfoTree\n\n Returns a tree structure containing information about the node and\n its most recently cooked data. The contents of the tree vary widely\n depending on the node type, and the nature of its cooked data. This\n tree of data is used to generate the node information window\n contents.\n\n\n verbose\n Setting verbose to True will cause some additional information\n to be generated. In particular data that is expensive to\n calculate, or which will generate a large amount of information\n tends to be generated only if this option is turned on.\n\n debug\n Setting debug to True will, in a few cases, cause additional\n information to be displayed which generally will be most useful\n when debugging the internal operation of Houdini. For example,\n geometry attributes will display their data ids, which can be\n helpful when tracking down errors in SOPs written with the HDK.\n\n output_index\n Specifies which of the node's outputs to return information for.\n\n force_cook\n If True, ensures that output has been cooked before building the\n info tree. Note that if the node already has errors, this will\n attempt to recook the node.\n\n\n \"\"\"\n def infoData(self) -> dict[str, Any]:\n \"\"\"\n\n infoData(self) -> dict of str to any python object\n\n Returns a dictionary of any node-type-specific information about the\n node's current status. This will consist of its last cooked status,\n so the node may need to be pre-cooked to update the data.\n\n While infoTree provides formatted data suitable for display,\n infoData returns raw data and is not meant to be directly displayed.\n It also consists only of data specific to the node that can't be\n queried through other HOM methods.\n\n\n \"\"\"\n def updateParmStates(self) -> None:\n \"\"\"\n\n updateParmStates(self)\n\n Update the UI states, such as hidden and disabled, for each\n parameter in the node.\n\n UI states can be expressed as conditionals (i.e. Disable When) which\n require evaluation. Typically in graphical Houdini the Parameter\n Pane performs the evaluation when the node is selected in order to\n determine how the node parameters should look in the pane. However\n in non-graphical Houdini or if the Parameter Pane has not yet loaded\n the node, then the evaluation does not occur and the UI states\n remain at their defaults causing methods such as hou.Parm.isDisabled\n and hou.Parm.isHidden to return incorrect values. In these cases, it\n is recommended that hou.Node.updateParmStates is called.\n\n\n \"\"\"\n def runInitScripts(self) -> None:\n \"\"\"\n\n runInitScripts(self)\n\n Runs the initialization script associated with this node's type.\n\n\n \"\"\"\n def deleteScript(self) -> str:\n \"\"\"\n\n deleteScript(self) -> str\n\n Return the script that will run when this node is deleted.\n\n\n \"\"\"\n def setDeleteScript(self, script_text: str, language: EnumValue = ...) -> None:\n \"\"\"\n\n setDeleteScript(self, script_text, language=hou.scriptLanguage.Python)\n\n Sets the script that will run when this node is deleted.\n\n\n \"\"\"\n def addNodeGroup(self, name: Optional[str] = None) -> NodeGroup:\n \"\"\"\n\n addNodeGroup(self, name=None) -> hou.NodeGroup\n\n Add a node group to the node and return the new group.\n\n If a group of the given name already exists then this function\n simply returns the existing group without adding a new one. If the\n name of the group is None or an empty string, then a unique default\n name is automatically chosen.\n\n This function can only be called on nodes that are networks. If it\n is called on a node that is not a network, then it raises\n hou.OperationFailed.\n\n To remove a node group, use hou.NodeGroup.destroy.\n\n\n \"\"\"\n def nodeGroups(self) -> Tuple[NodeGroup, ...]:\n \"\"\"\n\n nodeGroups(self) -> tuple of hou.NodeGroup\n\n Return the list of node groups in this node.\n\n\n \"\"\"\n def nodeGroup(self, name: str) -> Optional[NodeGroup]:\n \"\"\"\n\n nodeGroup(self, name) -> hou.NodeGroup\n\n Return a node group contained by the node with the given name, or\n None if the group does not exist.\n\n\n \"\"\"\n def motionEffectsNetworkPath(self) -> str:\n \"\"\"\n\n motionEffectsNetworkPath(self) -> str\n\n Return a node path representing the location for storing clips. This\n location may or may not exist. To find or create such a network, use\n hou.Node.findOrCreateMotionEffectsNetwork.\n\n\n \"\"\"\n def findOrCreateMotionEffectsNetwork(self, create: bool = True) -> OpNode:\n \"\"\"\n\n findOrCreateMotionEffectsNetwork(self, create=True) ->\n hou.chopNetNodeTypeCategory\n\n Return a CHOP network node suitable for storing Motion Effects. By\n default, if the node doesn't exist, it will be created.\n\n See also hou.Parm.storeAsClip and hou.Node.motionEffectsNetworkPath.\n\n\n \"\"\"\n def createOrMoveVisualizer(self, output_index: int) -> None:\n \"\"\"\n\n createOrMoveVisualizer(self, output_index)\n\n Creates a node for visualizing the data from a particular output of\n this node. If a visualizer node already exists in the current\n network, it is moved and connected to the specified output_index.\n This method is only implemented for SOP and VOP nodes. Other node\n types do nothing when this method is called.\n\n\n \"\"\"\n def saveItemsToFile(self, items: Sequence[NetworkMovableItem], file_name: str, save_hda_fallbacks: bool = False) -> None:\n \"\"\"\n\n saveItemsToFile(self, items, file_name, save_hda_fallbacks = False)\n\n Given a sequence of child items (nodes, network boxes, sticky notes,\n etc), save a file containing those items. You can load this file\n using hou.Node.loadItemsFromFile.\n\n\n items\n A sequence of hou.NetworkMovableItems that are children of this\n node.\n\n file_name\n The name of the file to write the contents to. You can use any\n extension for this file name.\n\n save_hda_fallbacks\n Set to True to save simplified definitions for HDAs into the\n file along with the child nodes. Doing this allows the generated\n file to be safely loaded into any houdini session, even if the\n assets used in the file are not already loaded into the houdini\n session. Depending on the use of the generated file, this\n information is often not required and makes the files\n unnecessarily large.\n\n Raises hou.OperationFailed if any of the nodes or network boxes are\n node children of this node, or if the file could not be written to.\n Raises hou.PermissionError if you do not have permission to read the\n contents of this node.\n\n\n \"\"\"\n def loadItemsFromFile(self, file_name: str, ignore_load_warnings: bool = False) -> None:\n \"\"\"\n\n loadItemsFromFile(self, file_name, ignore_load_warnings=False)\n\n Load the contents of a file (saved with hou.Node.saveItemsToFile)\n into the contents of this node.\n\n Raises hou.OperationFailed if the file does not exist or it is not\n the correct type of file. Raises hou.PermissionError if this node is\n a locked instance of a digital asset. Raises hou.LoadWarning if the\n load succeeds but with warnings and ignore_load_warnings is False.\n\n\n \"\"\"\n def removeAllEventCallbacks(self) -> None:\n \"\"\"\n\n removeAllEventCallbacks(self)\n\n Remove all event callbacks for all event types from this node.\n\n See hou.Node.addEventCallback for more information.\n\n\n WARNING\n removeAllEventCallbacks should be used carefully, especially\n with viewer states as it may cause functionality to silently\n stop working when entering a state.\n\n\n \"\"\"\n def stampValue(self, parm_name: str, default_value: float|str) -> str:\n '''\n\n stampValue(self, parm_name, default_value)\n\n Return a copy stamping floating point or string value. This node\n must be a downstream stamping operator, such as a Copy SOP, Cache\n SOP, LSystem SOP, or Copy CHOP.\n\n\n parm_name\n The name of the stamping variable.\n\n default_value\n The value that this function returns if Houdini is not currently\n performing stamping, or if parm_name is not a valid variable\n name. This value may be a float or a string.\n\n You might put the following expression in a Python parameter:\n\n > node(\\\\\"../copy1\\\\\").stampValue(\\\\\"sides\\\\\", 5)\n\n '''\n def asCode(self, brief: bool = False, recurse: bool = False, save_channels_only: bool = False, save_creation_commands: bool = True, save_keys_in_frames: bool = False, save_outgoing_wires: bool = False, save_parm_values_only: bool = False, save_spare_parms: bool = True, save_box_membership: bool = True, function_name: Optional[str] = None) -> str:\n \"\"\"\n\n asCode(self, brief=False, recurse=False, save_channels_only=False,\n save_creation_commands=True, save_keys_in_frames=False,\n save_outgoing_wires=False, save_parm_values_only=False,\n save_spare_parms=True, save_box_membership=True, function_name=None) ->\n str\n\n Prints the Python code necessary to recreate a node.\n\n\n brief\n Do not set values if they are the parameter's default. Applies\n to the contents of the node if either recurse or\n save_box_contents is True.\n\n recurse\n Recursively apply to the entire operator hierarchy.\n\n save_box_contents\n Script the contents of the node.\n\n save_channels_only\n Only output channels. Applies to the contents of the node if\n either recurse or save_box_contents is True.\n\n save_creation_commands\n Generate a creation script for the node. If set to False, the\n generated script assumes that the network box already exists.\n When set to True, the script will begin by creating the network\n box.\n\n save_keys_in_frames\n Output channel and key times in samples (frames) instead of\n seconds. Applies to the contents of the node if either recurse\n or save_box_contents is True.\n\n save_parm_values_only\n Evaluate parameters, saving their values instead of the\n expressions. Applies to the contents of the node if either\n recurse or save_box_contents is True.\n\n save_spare_parms\n Save spare parameters as well. When save_creation_commands is\n True, commands for creating spare parameters will also be\n output. Applies to the contents of the node if either recurse or\n save_box_contents is True.\n\n save_box_membership\n Output code to add the root item to its parent network box, if\n any.\n\n function_name\n If a function_name is specified, the output will be wrapped in a\n Python function.\n\n\n \"\"\"\n def dataBlockKeys(self, blocktype: Optional[str] = None) -> Tuple[str, ...]:\n \"\"\"\n\n dataBlockKeys(self, blocktype) -> tuple of str\n\n Return the names of all data blocks stored on this node that are of\n the data type specified by the blocktype parameter.\n\n Data blocks are similar to user data in that they can contain any\n extra data that may be useful to attach to a specific node. They\n differ from user data in that data blocks are designed to more\n efficiently handle large blocks of data. Data blocks can also\n contain binary data, and have a data type associated with each\n block.\n\n\n \"\"\"\n def dataBlockType(self, key: str) -> str:\n \"\"\"\n\n dataBlockType(self, key) -> str\n\n Return the data type of the block specified by the key parameter.\n\n Raises hou.ValueError if the provided key is not associated with any\n data block on this node.\n\n\n \"\"\"\n def dataBlock(self, key: str) -> bytes:\n \"\"\"\n\n dataBlock(self, key) -> str for Python 2, bytes for Python 3\n\n Returns the data block as a binary string stored under the given\n key. This method will only work if the specified data block is has a\n type that can be represented by a python object. Otherwise None is\n returned.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n Raises hou.ValueError if the provided key is not associated with any\n data block on this node.\n\n\n NOTE\n A binary data block can also be accessed within Houdini using\n the filesystem protocol opdatablock:. This works similarly to\n the opdef: and oplib: protocols used by HDAs. For example, a\n network editor background image could be set to load from the\n data block key image.pic by setting its filepath to\n opdatablock:/obj/geo1/image.pic.\n\n\n \"\"\"\n def setDataBlock(self, key: str, data: bytes, block_type: Optional[str] = None) -> None:\n \"\"\"\n\n setDataBlock(self, key, block, block_type=None)\n\n Stores the provided data block on the node under the provided key\n name, marking it with the provided data type.\n\n Passing an empty string as the block value will remove any data\n block with the specified key. Data blocks can also be removed with\n the removeDataBlock() method.\n\n The blocktype string argument requires a C++/HDK plugin to interpret\n data blocks and turn them into C++ objects. If you're using Python\n to get and set data blocks, leave the blocktype empty.\n\n\n NOTE\n It is also possible to store the data block from within Houdini\n by writing to a file using the opdatablock: file system\n protocol. For example, setting the Output File parameter of a to\n opdatablock:/obj/geo1/image.pic would store the image file to\n the geo1 node with the key image.pic.\n\n\n \"\"\"\n def removeDataBlock(self, key: str) -> None:\n \"\"\"\n\n removeDataBlock(self, key)\n\n Removes any existing data block on the node with the specified key.\n If there is no data block with this key, this method does nothing.\n\n\n \"\"\"\n def destroyCachedUserData(self, name: str, must_exist: bool = True) -> None:\n \"\"\"\n\n destroyCachedUserData(self, name, must_exist=True)\n\n Remove the user-defined cached data with this name.\n\n See hou.Node.setCachedUserData for more information.\n\n Raises hou.OperationFailed if no user data with this name exists and\n must_exist is True.\n\n\n \"\"\"\n def clearCachedUserDataDict(self) -> None:\n \"\"\"\n\n clearCachedUserDataDict(self)\n\n Remove all user-defined cached data.\n\n See hou.Node.setCachedUserData for more information.\n\n\n \"\"\"\n def cachedUserDataDict(self) -> dict[str, Any]:\n \"\"\"\n\n cachedUserDataDict(self) -> dict of str to any python object`\n\n Return a dictionary containing all the user-defined name/string\n pairs for this node.\n\n See hou.Node.setCachedUserData for more information.\n\n\n \"\"\"\n def setCachedUserData(self, name: str, value: Any) -> None:\n '''\n\n setCachedUserData(self, name, value)\n\n Add/set a named value on this node instance. Unlike setUserData,\n values set using this method are not saved with the hip file.\n\n name: A unique name (key) for the user-defined data. By using\n different names, you can attach multiple pieces of user-defined data\n to a node. value: The value to store. Unlike setUserData, this value\n may be any Python object.\n\n This name/value pair is not stored with the hip file. It is useful\n for nodes implemented in Python that want to save temporary values\n between cooks, to avoid recomputing them on subsequent cooks.\n\n The following example illustrates how to set, access, and delete\n cached user-defined data:\n\n > >>> n = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\")\n > >>> n.setCachedUserData(\\\\\"my data\\\\\", [1, 2, {\\\\\"a\\\\\": \\\\\"b\\\\\", \\\\\"c\\\\\": \\\\\"d\\\\\"}])\n > >>> n.cachedUserData(\\\\\"my data\\\\\")\n > [1, 2, {\\'a\\': \\'b\\', \\'c\\': \\'d\\'}]\n > >>> n.cachedUserDataDict()\n > {\\'my data\\': [1, 2, {\\'a\\': \\'b\\', \\'c\\': \\'d\\'}]}\n > >>> n.destroyCachedUserData(\\\\\"my data\\\\\")\n > >>> n.cachedUserDataDict()\n > {}\n > >>> print n.cachedUserData(\\\\\"my data\\\\\")\n > None\n\n See per-node user-defined data for more information and examples.\n\n\n '''\n def cachedUserData(self, name: str) -> Any:\n '''\n\n cachedUserData(self, name) -> any python obect or None\n\n Return the user-defined cached data with this name, or None if no\n data with this name exists.\n\n See hou.Node.setCachedUserData for more information.\n\n This method can be implemented as follows:\n\n > def cachedUserData(self, name):\n > return self.cachedUserDataDict().get(name)\n\n Note that None is a valid value for a key, so the most reliable way\n to check if a key is valid is to check if it is in the result of\n cachedUserDataDict:\n\n > >>> n = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\")\n > >>> n.cachedUserDataDict()\n > {}\n > >>> print n.cachedUserData(\\\\\"foo\\\\\")\n > None\n > >>> \\\\\"foo\\\\\" in n.cachedUserDataDict()\n > False\n > >>> n.setCachedUserData(\\\\\"foo\\\\\", None)\n > >>> n.cachedUserDataDict()\n > {\\'foo\\': None}\n > >>> print n.cachedUserData(\\\\\"foo\\\\\")\n > None\n > >>> \\\\\"foo\\\\\" in n.cachedUserDataDict()\n > True\n\n '''\n def simulation(self) -> DopSimulation: ...\n def findNodesThatProcessedObject(self, dop_object: DopObject) -> Tuple[Node, ...]: ...\n def addError(self, message: str, severity: EnumValue = ...) -> None:\n \"\"\"\n\n addError(self, message, severity=Hom:hou.severityType.Error)\n\n Add an error badge to the node\n\n\n message\n A string containing the error message to show on the node.\n\n severity\n A hou.severityType object that specifies the severity level\n\n\n NOTE\n This should only be called on the currently cooking node within\n a cook.\n\n\n \"\"\"\n def addWarning(self, message: Optional[str] = None) -> None:\n \"\"\"\n\n addWarning(self, message)\n\n Add a warning badge to the node\n\n\n message\n A string containing the warning message to show on the node.\n\n\n NOTE\n This should only be called on the currently cooking node within\n a cook.\n\n\n \"\"\"\n def addMessage(self, message: Optional[str] = None) -> None:\n \"\"\"\n\n addMessage(self, message)\n\n Add an info message badge to the node\n\n\n message\n A string containing the info message to show on the node.\n\n\n NOTE\n This should only be called on the currently cooking node within\n a cook.\n\n\n \"\"\"\n def lastCookTime(self) -> float:\n \"\"\"\n\n lastCookTime(self) -> float\n\n Returns the duration of the node's last cook in milliseconds.\n\n\n \"\"\"\n def lastCookContextOptions(self, only_used_options: bool = ...) -> dict[str, str|float]:\n \"\"\"\n\n lastCookContextOptions(self, only_used_options=False) -> dict of str to\n str or float\n\n Returns a dictionary of context options that were set during the\n most recent cook of this node. Setting only_used_options to True\n restricts the returned context option values to those that were\n actually used while cooking the node (or its inputs).\n\n\n \"\"\"\n def evalParm(self, parm_path: str) -> ParmArgType:\n \"\"\"\n\n evalParm(self, parm_path) -> int, float, or str\n\n Evaluates the specified parameter and returns the result.\n\n\n \"\"\"\n def evalParmTuple(self, parm_path: str) -> ParmTupleReturnType:\n \"\"\"\n\n evalParmTuple(self, parm_path) -> tuple of int, float, or str\n\n Evaluates the specified parameter tuple and returns the result.\n\n\n \"\"\"\n def addEventCallback(self, event_types: Sequence[EnumValue], callback: Callable) -> None:\n '''\n\n addEventCallback(self, event_types, callback)\n\n Registers a Python callback that Houdini will call whenever a\n particular action, or event, occurs on this particular node\n instance.\n\n Callbacks only persist for the current session. For example, they\n are not saved to the .hip file. If you want persistent callbacks in\n every session, you can add them in code in 456.py (runs when the\n user opens a .hip file). See where to add Python scripting for more\n information.\n\n\n event_types\n A sequence of hou.nodeEventType enumeration values describing\n the event types that will cause Houdini to call the callback\n function.\n\n callback\n A callable Python object, such as a function or bound method.\n Houdini will call this function whenever one of the event types\n in event_types occurs.\n\n Houdini calls the function with an event_type keyword argument\n containing the hou.nodeEventType value corresponding to the\n event that triggered the callback.\n\n Houdini will pass additional keyword arguments depending on the\n event type. For example, in a callback for the ParmTupleChanged\n event, Houdini will pass a parm_tuple keyword argument\n containing a hou.ParmTuple reference to the parameter that\n changed. See hou.nodeEventType for the extra arguments (if any)\n passed for each event type.\n\n You can add **kwargs to the argument list to accept all keyword\n arguments, to allow the same callback to be used for different\n events, or to be safe from future changes:\n\n > def event_callback(event_type, **kwargs):\n > ...\n\n NOTE\n If you try to add the exact same callback function more than\n once, Houdini will still only call the function only once in\n response to an event. However, it may be useful to add the same\n function if you want to register it with different event_types.\n\n Raises hou.OperationFailed if the event_types list argument is\n empty.\n\n The following example shows to set up a function that\\'s called\n whenever a certain node\\'s name changes:\n\n > \n > def name_changed(node, event_type, **kwargs):\n > print(\\\\\"The geometry object is now named\\\\\", node.name())\n > \n > hou.node(\\\\\"/obj/geo1\\\\\").addEventCallback((hou.nodeEventType.NameChanged, ), name_changed)\n\n See also hou.Node.removeEventCallback and\n hou.Node.removeAllEventCallbacks.\n\n\n '''\n def addParmCallback(self, callback: Callable[[OpNode, ParmTuple], None], names: Sequence[str]) -> None:\n \"\"\"\n\n addParmCallback(self, callback, parm_names)\n\n Registers a Python callback that Houdini will call whenever a\n parameter in parm_names changes on this particular node instance.\n This is can be faster than filtering the parameter names in a\n callback installed with hou.Node.addEventCallback if you only care\n about some parameters or if the node has many parameters.\n\n\n callback\n A callable Python object, such as a function or bound method.\n Houdini will call this function whenever one of the event types\n in event_types occurs.\n\n parm_names\n All list of parameter names.\n\n See hou.Node.addEventCallback for more information.\n\n\n \"\"\"\n def removeEventCallback(self, event_types: Sequence[EnumValue], callback: Callable) -> None:\n \"\"\"\n\n removeEventCallback(self, event_types, callback)\n\n Given a callback that was previously added on this node and a\n sequence of hou.nodeEventType enumerated values, remove those event\n types from the set of event types for the callback. If the remaining\n set of event types is empty, the callback will be removed entirely\n from this node.\n\n Raises hou.OperationFailed if the callback had not been previously\n added.\n\n See hou.Node.addEventCallback for more information.\n\n\n \"\"\"\n def eventCallbacks(self) -> Tuple[Tuple[Tuple[EnumValue,...], Callable],...]: ...\n\n # Missing methods added by stubgen\n def appendParmTemplatesFromData(self, data: dict[str, Any], rename_conflicts: bool = True) -> dict[str, ParmTuple]: ...\n def appendParmTemplatesToFolderFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]: ...\n def asData(self, nodes_only: bool = False, children: bool = False, editables: bool = False, inputs: bool = False, position: bool = False, flags: bool = False, parms: Union[bool, Sequence[ParmTuple], Sequence[str]]=True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]: ...\n def children(self) -> Tuple[OpNode, ...]: ...\n def childrenAsData(self, nodes_only: bool = False, children: bool = True, editables: bool = True, inputs: bool = True, position: bool = True, flags: bool = True, parms: bool = True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]: ...\n def createDecorationItemsFromData(self, items: Sequence[NetworkMovableItem], frame_nodes: Sequence[NetworkMovableItem] | None=None, selected_nodes: Sequence[NetworkMovableItem] | None=None, current_node: NetworkMovableItem | None=None, flags: bool = True, nodes_only: bool = False, target_children: bool = False, children: bool = True, target_editables: bool = False, editables: bool = True, target_parms: Union[bool, Sequence[ParmTuple], Sequence[str]]=True, parms: bool = True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]: ...\n def createNode(self, node_type_name: str, node_name: str | None = None, run_init_scripts: bool = True, load_contents: bool = True, exact_type_name: bool = False, force_valid_node_name: bool = False) -> OpNode: ...\n def editablesAsData(self, nodes_only: bool = False, children: bool = True, editables: bool = True, inputs: bool = True, position: bool = True, flags: bool = True, parms: bool = True, default_parmvalues: bool = False, evaluate_parmvalues: bool = False, parms_as_brief: bool = True, parmtemplates: str=..., metadata: bool = False, verbose: bool = False) -> dict[str, Any]: ...\n def inputConnections(self) -> Tuple[OpNodeConnection, ...]: ...\n def inputsAsData(self, ignore_network_dots: bool = False, ignore_subnet_indirect_inputs: bool = False, use_names: bool = False) -> Sequence[dict[str, Any]]: ...\n def insertParmTemplatesAfterFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]: ...\n def insertParmTemplatesBeforeFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]: ...\n def node(self, node_path: str) -> OpNode | None: ...\n def outputConnections(self) -> Tuple[OpNodeConnection, ...]: ...\n def outputsAsData(self, ignore_network_dots: bool = False, ignore_subnet_indirect_inputs: bool = False, use_names: bool = False) -> Sequence[dict[str, Any]]: ...\n def parmTemplateChildrenAsData(self, name: str= '', parmtemplate_order: bool = False) -> dict[str, Any]: ...\n def parmTemplatesAsData(self, name: str= '', children: bool = True, parmtemplate_order: bool = False) -> dict[str, Any]: ...\n def parmsAsData(self, values: bool = True, parms: bool = True, default_values: bool = False, evaluate_values: bool = False, locked: bool = True, brief: bool = True, multiparm_instances: bool = True, metadata: bool = False, verbose: bool = False) -> dict[str, Any]: ...\n def prependParmTemplatesToFolderFromData(self, data: dict[str, Any], parm_name: str, rename_conflicts: bool = True) -> dict[str, ParmTuple]: ...\n def replaceParmTemplatesFromData(self, data: dict[str, Any]) -> dict[str, ParmTuple]: ...\n def setChildrenFromData(self, clear_content: bool = True, force_item_creation: bool = True, offset_position: Vector2=..., external_connections: bool = True, parms: bool = True, parmtemplates: bool = True, children: bool = True, editables: bool = True, skip_notes: bool = False) -> None: ...\n def setEditablesFromData(self, clear_content: bool = True, force_item_creation: bool = True, offset_position: Vector2=..., external_connections: bool = True, parms: bool = True, parmtemplates: bool = True, children: bool = True, editables: bool = True, skip_notes: bool = False) -> None: ...\n def setFromData(self, data: dict[str, Any], clear_content: bool = False, force_item_creation: bool = True, parms: bool = True, parmtemplates: bool = True, children: bool = True, editables: bool = True, skip_notes: bool = False) -> None: ...\n def setInputsFromData(self, data: dict[str, Any]) -> None: ...\n def setOutputsFromData(self, data: dict[str, Any]) -> None: ...\n def setParmExpressions(self, parm_dict: Mapping[str, str | Sequence[str]], language: EnumValue | None = None, replace_expressions: bool = True) -> None: ...\n def setParms(self, parm_dict: Mapping[str, ParmArgType | ParmTupleArgType]) -> None: ...\n def setParmsFromData(self, data: dict[str, Any]) -> None: ...\n def type(self) -> OpNodeType: ...\n\nclass OpVerb:\n \"\"\"\n\n hou.OpVerb\n\n Represents the code of a node.\n\n See using a verb for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def loadParmsFromNode(self, opnode: OpNode) -> None:\n \"\"\"\n\n loadParmsFromNodeAtTime(self, sopnode, time)\n\n Initializes all the parameters of this verb from the parameters of a\n specific hou.OpNode at a given time. Useful for cloning an existing\n node instance's behavior.\n\n\n \"\"\"\n def loadParmsFromNodeAtTime(self, opnode: OpNode, time: float) -> None: ...\n def parms(self) -> dict[str, OptionType]:\n \"\"\"\n\n parms(self) -> dictionary\n\n Returns a dictionary of parameter name / value pairs currently set\n on this verb. This will be the complete list understood, including\n defaults. Multiparms are represented as a sub list of dictionaries.\n\n This uses ParmTuple names, not channel names.\n\n\n \"\"\"\n def setParms(self, p: Mapping[str, OptionMultiArgType|Sequence[Mapping[str, OptionMultiArgType]]]) -> None:\n \"\"\"\n\n setParms(self, parmdictionary)\n\n Updates a subset of parmeters on this verb with those specified in\n the dictionary. Exceptions are raised if attempts are made to set\n non-existent parameters or with incorrect types.\n\n This uses ParmTuple names, not channel names. So for a transform you\n would use xform.setParms({'t':(2,0,0)}) rather than tx.\n\n\n \"\"\"\n def minNumInputs(self) -> int:\n \"\"\"\n\n minNumInputs(self) -> integer\n\n Returns the minimum number of geometry inputs required for this verb\n to compute successfully.\n\n\n \"\"\"\n\nclass NodeGroup:\n \"\"\"\n\n hou.NodeGroup\n\n Represents a node group.\n\n In Houdini, a node group contains a set of nodes from the same network.\n Each group is named, and you can edit a group's contents from the\n network view pane by selecting Tools > Show Groups from its right-mouse\n menu.\n\n A node bundle, on the other hand, may contain nodes from multiple\n networks, and corresponds to a hou.NodeBundle object. You can edit a\n node bundle from the bundle list pane.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of this group.\n\n\n \"\"\"\n def nodes(self) -> Tuple[Node, ...]:\n \"\"\"\n\n nodes(self) -> tuple of hou.OpNode\n\n Return a tuple containing the nodes in this group.\n\n\n \"\"\"\n def parent(self) -> Node:\n \"\"\"\n\n parent(self) -> hou.OpNode\n\n Returns the network node containing this group.\n\n\n \"\"\"\n def addNode(self, node: Node) -> None:\n \"\"\"\n\n addNode(self, node)\n\n Add a hou.OpNode to this group.\n\n If the node is already in the group, this method does nothing. If\n the node is not in the correct network for this group, raises\n hou.OperationFailed.\n\n\n \"\"\"\n def removeNode(self, node: Node) -> None:\n \"\"\"\n\n removeNode(self, node)\n\n Remove a hou.OpNode from this group.\n\n Raises hou.OperationFailed if the node is not in the group.\n\n\n \"\"\"\n def clear(self) -> None:\n \"\"\"\n\n clear(self)\n\n Remove all nodes from this group.\n\n\n \"\"\"\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Delete this group. Does not delete the nodes that were contained in\n it.\n\n\n \"\"\"\n def asCode(self, save_creation_commands: bool = True, save_node_memberships: bool = True, function_name: Optional[str] = None) -> str:\n \"\"\"\n\n asCode(self, save_creation_commands=False, function_name=None) -> str\n\n Returns the Python code necessary to recreate this group.\n\n\n save_creation_commands\n Generate a creation script for the node group. If set to False\n (the default), the generated script assumes that the node group\n already exists. When set to True, the script will begin by\n creating the node group.\n\n function_name\n If a function_name is specified, the output will be wrapped in a\n Python function.\n\n\n \"\"\"\n\nclass ObjNode(OpNode):\n \"\"\"\n\n hou.ObjNode\n\n An instance of an object node in the Houdini scene.\n\n Each object has a transformation (or transform) encapsulating its\n position (or translation), rotation, and scale. For a subnet object, the\n subnet's transform is applied to the objects inside the subnet. An\n object can have additional transforms from parent objects on top of the\n transform defined by its parameters, as well as a normally hidden\n pretransform that defines the object's rest or zero position (normally\n all zeros). An object's final position/rotation/scale in world space is\n defined by (object's transform) * (pretransform) * (parent transform).\n\n\n TIP\n You can set an object's position/rotation/scale to certain world\n space values regardless of parent/pre-transform values with the\n hou.ObjNode.setWorldTransform method.\n\n\n NOTE\n Houdini does not support shear parameters on objects. If you try to\n set an object's parameters to a transform containing shear, Houdini\n will automatically remove the shear.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def origin(self) -> Vector3:\n \"\"\"\n\n origin(self) -> hou.Vector3\n\n Return the object's origin position, in world space.\n\n obj.origin() is equivalent to obj.Vector3(0, 0, 0) *\n obj.worldTransform().\n\n > # To compute the world space vector from obj1's origin to obj2's origin, you\n > # can write:\n > obj2.origin() - obj1.origin()\n > \n > # To compute the distance, in world space, between the origins of two\n > # objects, simply take the length of this vector:\n > (obj2.origin() - obj1.origin()).length()\n > \n > # If there are no rotations or scales, the vtorigin() hscript expression\n > # function will return the same result as obj2.origin() - obj1.origin().\n > # If there are rotations or scales, though, it won't. A Python equivalent\n > # of vtorigin() is defined by:\n > def vtorigin(obj1, obj2):\n > return (obj2.worldTransform() * obj1.worldTransform().inverted()).extractTranslates()\n\n See also the hou.ObjNode.worldTransform and\n hou.ObjNode.getTransformToNode methods.\n\n\n \"\"\"\n def localTransform(self) -> Matrix4:\n \"\"\"\n\n localTransform(self) -> hou.Matrix4\n\n Return the matrix that transforms this object's geometry into space\n of its input.\n\n The local transform matrix contains the cumulative transforms of:\n\n * The node's pre-transform\n\n * The transform defined by the node's transform parameters\n\n * The transform adjustment by the node's lookat and path parameters\n\n The local transform matrix, independent of the node's pre-transform,\n can be obtained as follows:\n\n > def localTransformIgnorePreTransform(self):\n > return (self.localTransform() * self.preTransform().inverted())\n\n See also hou.ObjNode.localTransformAtTime and\n hou.ObjNode.worldTransform.\n\n\n \"\"\"\n def localTransformAtTime(self, time: float) -> Matrix4:\n \"\"\"\n\n localTransformAtTime(self, time) -> hou.Matrix4\n\n Return, for the specified time, the matrix that transforms this\n object's geometry into the space of its input.\n\n If the object's local transform is animated, this method provides a\n way to get the transformation at a specific time.\n\n See hou.ObjNode.localTransform for more information.\n\n\n \"\"\"\n def worldTransform(self) -> Matrix4:\n \"\"\"\n\n worldTransform(self) -> hou.Matrix4\n\n Return the matrix that transforms this object's geometry into world\n space.\n\n The world transform matrix contains the cumulative transforms of:\n\n * The node's pre-transform\n\n * The transform defined by the node's parameters\n\n * The transforms of parent nodes or containing networks\n\n This method can approximately be implemented as follows:\n\n > def worldTransform(self):\n > return (self.localTransform() * self.parentAndSubnetTransform())\n\n See also hou.ObjNode.setWorldTransform and\n hou.ObjNode.worldTransformAtTime.\n\n\n \"\"\"\n def worldTransformAtTime(self, time: float) -> Matrix4:\n \"\"\"\n\n worldTransformAtTime(self, time) -> hou.Matrix4\n\n Return, for the specified time, the matrix that transforms this\n object's geometry into world space.\n\n If the object's world transform is animated, this method provides a\n way to get the transformation at a specific time.\n\n See hou.ObjNode.worldTransform for more information.\n\n\n \"\"\"\n def setWorldTransform(self, matrix: Matrix4, fail_on_locked_parms: bool = False) -> None:\n \"\"\"\n\n setWorldTransform(self, matrix, fail_on_locked_parms=False)\n\n Adjust this object's parameters to achieve the desired world\n transformation.\n\n This method will adjust the translate, rotate, and scale values of\n this object to achieve the desired final world transform. It\n accounts for the transforms of containing networks, parent\n transforms, and pre-transforms.\n\n If fail_on_locked_parms is True, and any of the translate, rotate,\n or scale parameters of the object are locked, this method raises\n hou.OperationFailed. If it is False and any of those parameters are\n locked, this method will change their values but leave them locked.\n\n Suppose:\n\n * W is the desired new world transform,\n\n * W' is the existing world transform,\n\n * L is the desired transform defined by the node's parameters,\n\n * L' is the existing parm transform,\n\n * P is the object's pre-transform,\n\n * O is the parent transform combined with the containing subnet's,\n transform\n\n Then, since W = L * P * O we have P = W * O^ * R^. So, this method\n could be implemented as follows:\n\n > def setWorldTransform(self):\n > self.setParmTransform(\n > matrix * self.parentAndSubnetTransform().inverted() * self.preTransform().inverted(),\n > fail_on_locked_parms)\n\n Alternately, we can derive L from W' and L' as follows:\n\n * W' = L' * P * O\n\n * so P * O = L^' * W'\n\n * and (P * O)^ = W^' * L' and\n\n * W = L * P * O\n\n * so L = W * (P * O)^\n\n * giving L = W * W'^ * L'\n\n Thus, this method could also be implemented using the current world\n and parm transforms as follows:\n\n > def setWorldTransform(self):\n > self.setParmTransform(\n > matrix * self.worldTransform().inverted() * self.parmTransform(),\n > fail_on_locked_parms)\n\n Note that, because parm transforms cannot contain shears, it is\n possible that the resulting world transform will not match the\n desired transform. If r is a function that removes shears from a\n transform then the new world transform will actually be L * P * O =\n r(W * O^ * P^) * P * O.\n\n See also hou.ObjNode.worldTransform and\n hou.ObjNode.setParmTransform.\n\n\n \"\"\"\n def setCookTransform(self, matrix: Matrix4) -> None:\n \"\"\"\n\n setCookTransform(self, matrix)\n\n Set the parameter transform for the Python object that's cooking.\n Call this method from objects implemented in Python to set the\n result of the cook.\n\n Note that an object implemented in Python controls the parameter\n transform (i.e. the result of hou.ObjNode.parmTransform). The world\n transform (i.e. the result of hou.ObjNode.worldTransform) is still\n affected by parent node's transforms, pre-transforms, etc.\n\n This method raises hou.OperationFailed if you call it on an object\n that is not implemented in Python or if you call it from outside\n that object's Python cook code.\n\n See the Transforms from Disk example.\n\n\n \"\"\"\n def parmTransform(self) -> Matrix4:\n '''\n\n parmTransform(self) -> hou.Matrix4\n\n Return the transform defined by the parameters on this node.\n\n This method can approximately be implemented as follows:\n\n > def parmTransform(self):\n > pivot_transform = hou.hmath.buildTransform({\n > \\\\\"translate\\\\\":self.evalParmTuple(\\\\\"p\\\\\"),\n > \\\\\"rotate\\\\\":self.evalParmTuple(\\\\\"pr\\\\\")},\n > transform_order=\\\\\"srt\\\\\",\n > rotate_order=\\\\\"xyz\\\\\")\n > return (\n > pivot_transform.inverted() *\n > hou.hmath.buildTransform({\n > \\\\\"translate\\\\\": self.evalParmTuple(\\\\\"t\\\\\"),\n > \\\\\"rotate\\\\\": self.evalParmTuple(\\\\\"r\\\\\"),\n > \\\\\"scale\\\\\": [self.evalParm(\\\\\"scale\\\\\") * s\n > for s in self.evalParmTuple(\\\\\"s\\\\\")],\n > \\\\\"shear\\\\\": (0.0, 0.0, 0.0)},\n > transform_order=self.parm(\\\\\"xOrd\\\\\").evalAsString(),\n > rotate_order=self.parm(\\\\\"rOrd\\\\\").evalAsString()) *\n > pivot_transform)\n\n See the class documentation for the relation between this transform\n and the world space transform. See also hou.ObjNode.worldTransform.\n\n NOTE: For Python Objects, the python code sets the parm transform as\n well and won\\'t necessarily have any visible parameters. To get the\n local transform of an object (ie. the transform without any\n parenting), use hou.ObjNode.localTransform.\n\n\n '''\n def setParmTransform(self, matrix: Matrix4, fail_on_locked_parms: bool = False) -> None:\n \"\"\"\n\n setParmTransform(self, matrix, fail_on_locked_parms=False)\n\n Sets the transform controlled by this object's parameters.\n\n This method will adjust the translate, rotate, and scale values of\n this object to achieve the desired parameter, or local, transform.\n It will account for the existing pivot position, transformation\n order, and rotation order, and will leave them unchanged. It will\n also account for the existing orientation to set rotate values that\n produce a minimal rotation.\n\n Note that object nodes do not currently have shears parameters, so\n any shears in the matrix will be discarded.\n\n If fail_on_locked_parms is True, and any of the translate, rotate,\n or scale parameters of the object are locked, this method will raise\n hou.OperationFailed. If it is False and any of those parameters are\n locked, this method will change their values but leave them locked.\n\n See also hou.ObjNode.parmTransform and\n hou.ObjNode.setWorldTransform.\n\n This method can be approximately implemented as follows, ignoring\n locked parameters:\n\n > def setParmTransform(self, matrix):\n > parm_values = matrix.explode(\n > transform_order=self.parm('xOrd').evalAsString(),\n > rotate_order=self.parm('rOrd').evalAsString(),\n > pivot=hou.Vector3(self.evalParmTuple('p')))\n > \n > for parm_name, key in ('t', 'translate'), ('r', 'rotate'), ('s', 'scale'):\n > self.parmTuple(parm_name).set(parm_values[key])\n\n See also hou.Matrix4.explode.\n\n\n \"\"\"\n def parmPivotTransform(self) -> Matrix4:\n '''\n\n parmPivotTransform(self) -> hou.Matrix4\n\n Return the pivot transform defined by the parameters on this node.\n\n This method can approximately be implemented as follows:\n\n > def parmPivotTransform(self):\n > pivot_transform = hou.hmath.buildTranslate(self.evalParmTuple(\\\\\"p\\\\\"))\n > return (\n > hou.hmath.buildTransform({\n > \\\\\"translate\\\\\": self.evalParmTuple(\\\\\"p\\\\\"),\n > \\\\\"rotate\\\\\": self.evalParmTuple(\\\\\"pr\\\\\")},\n > transform_order=\\\\\"srt\\\\\",\n > rotate_order=\\\\\"xyz\\\\\")\n\n See also hou.ObjNode.parmTransform.\n\n\n '''\n def setParmPivotTransform(self, matrix: Matrix4, fail_on_locked_parms: bool = False) -> None:\n \"\"\"\n\n setParmPivotTransform(self, matrix, fail_on_locked_parms=False)\n\n Sets the pivot transform controlled by this object's parameters.\n\n This method will adjust the pivot translate and pivot rotate values\n of this object to achieve the desired transform. It will not\n compensate for any changes this causes to the world transform of\n this object.\n\n If fail_on_locked_parms is True, and any of the pivot translate or\n pivot rotate rotate parameters of the object are locked, this method\n will raise hou.OperationFailed. If it is False and any of those\n parameters are locked, this method will change their values but\n leave them locked.\n\n See also hou.ObjNode.parmPivotTransform and\n hou.ObjNode.setParmTransform.\n\n This method can be approximately implemented as follows, ignoring\n locked parameters:\n\n > def setParmPivotTransform(self, matrix):\n > parm_values = matrix.explode(\n > transform_order=self.parm('xOrd').evalAsString(),\n > rotate_order=self.parm('rOrd').evalAsString(),\n > pivot=hou.Vector3())\n > \n > for parm_name, key in ('p', 'translate'), ('pr', 'rotate'):\n > self.parmTuple(parm_name).set(parm_values[key])\n\n See also hou.Matrix4.explode.\n\n\n \"\"\"\n def preTransform(self) -> Matrix4:\n \"\"\"\n\n preTransform(self) -> hou.Matrix4\n\n Return this object's pretransform.\n\n The pre-transform allows you to apply a transform after the\n parameter transform but before input and containing object\n transforms. See the class documentation for more details.\n\n Unlike the parameter transform, the pretransform is not stored using\n any parameters on the node. Instead, Houdini stores the pretransform\n as a matrix. Because it is directly as a matrix, the pretransform\n may contain shears.\n\n\n \"\"\"\n def setPreTransform(self, matrix: Matrix4) -> None:\n \"\"\"\n\n setPreTransform(self, matrix)\n\n Set this object's pretransform. See hou.ObjNode.preTransform for\n more information.\n\n\n \"\"\"\n def movePreTransformIntoParmTransform(self) -> None:\n \"\"\"\n\n movePreTransformIntoParmTransform(self)\n\n Set this object's pre-transform to the identity and adjust the parm\n transform so that the world transform does not change.\n\n This method is implemented approximately as follows:\n\n > def movePreTransformIntoParmTransform(self):\n > self.setParmTransform(self.parmTransform() * self.preTransform())\n > self.setPreTransform(hou.hmath.identityTransform())\n\n See also hou.ObjNode.movePreTransformIntoParmTransform.\n\n\n \"\"\"\n def moveParmTransformIntoPreTransform(self) -> None:\n \"\"\"\n\n moveParmTransformIntoPreTransform(self)\n\n Set this object's parm transform to the identity and adjust the pre-\n transform so that the world transform does not change.\n\n This method is implemented approximately as follows:\n\n > def moveParmTransformIntoPreTransform(self):\n > self.setPreTransform(self.parmTransform() * self.preTransform())\n > self.setParmTransform(hou.hmath.identityTransform())\n\n See also hou.ObjNode.moveParmRotateIntoPreTransform,\n hou.ObjNode.moveParmScaleIntoPreTransform, and\n hou.ObjNode.moveParmTranslateIntoPreTransform. Also see\n hou.ObjNode.movePreTransformIntoParmTransform.\n\n\n \"\"\"\n def moveParmTranslateIntoPreTransform(self) -> None:\n \"\"\"\n\n moveParmTranslateIntoPreTransform(self)\n\n Set this object's translate values to zero and adjust the pre-\n transform so that the world transform does not change.\n\n See hou.ObjNode.moveParmRotateIntoPreTransform for more information.\n\n\n \"\"\"\n def moveParmRotateIntoPreTransform(self) -> None:\n '''\n\n moveParmRotateIntoPreTransform(self)\n\n Set this object\\'s rotate values to zero and adjust the pre-transform\n so that the object\\'s world transform does not change.\n\n Suppose:\n\n * W is the world transform,\n\n * L is the parameter transform without any rotate component,\n\n * L\\' is the existing parm transform,\n\n * P is the desired new pre-transform,\n\n * P\\' is the current pre-transform,\n\n * O is the parent transform combined with the containing subnet\\'s,\n transform\n\n Then,\n\n * W = L * P * O and W = L\\' * P\\' * O\n\n * L * P = L\\' * P\\'\n\n * P = L^ * L\\' * P\\' So, this method is implemented approximately as\n follows:\n\n > def moveParmRotateIntoPreTransform(self):\n > old_parm_transform = self.parmTransform()\n > self.parmTuple(\\\\\"r\\\\\").set((0.0, 0.0, 0.0))\n > self.setPreTransform(\n > self.parmTransform() * old_parm_transform * self.preTransform())\n See also hou.ObjNode.preTransform and the class documentation.\n\n\n '''\n def moveParmScaleIntoPreTransform(self) -> None:\n \"\"\"\n\n moveParmScaleIntoPreTransform(self)\n\n Set this object's scale values to one and adjust the pre-transform\n so that the world transform does not change.\n\n See hou.ObjNode.moveParmRotateIntoPreTransform for more information.\n\n\n \"\"\"\n def parentAndSubnetTransform(self) -> Matrix4:\n \"\"\"\n\n parentAndSubnetTransform(self) -> hou.Matrix4\n\n Return the input node's world space transform (if there is an input\n connected), combined with the world space transform of the\n containing subnet object (if there is one). See the class\n documentation for more information.\n\n This method can approximately be implemented as follows:\n\n > def parentAndSubnetTransform(self):\n > if len(self.inputConnectors()[0]) != 0:\n > return self.inputs()[0].worldTransform()\n > \n > containing_subnet = self.parent()\n > if containing_subnet.type().category() == hou.objNodeTypeCategory():\n > return containing_subnet.worldTransform()\n > \n > return hou.hmath.identityMatrix()\n\n \"\"\"\n def getTransformToNode(self, obj_node: ObjNode) -> Matrix4:\n \"\"\"\n\n getTransformToNode(self, obj_node) -> hou.Matrix4\n\n Return a matrix that transforms this node to line up with the other\n node.\n\n The following invariant is true: node1.worldTransform() *\n node1.getTransformToNode(node2) == node2.worldTransform().\n\n This method can be implemented as follows:\n\n > def getTransformToNode(self, obj_node):\n > self.worldTransform().inverted() * obj_node.worldTransform()\n\n To align node1 (an ObjNode object) with node2 (another ObjNode\n object), you don't need to use getTransformToNode(). You can simply\n write: node1.setWorldTransform(node2.worldTransform()).\n\n See also hou.ObjNode.origin(), hou.ObjNode.worldTransform(), and\n hou.ObjNode.setWorldTransform().\n\n\n \"\"\"\n def getTransformFromPointToPoint(self, pos3: Vector3, other_node: ObjNode, other_pos3: Vector3) -> Matrix4:\n \"\"\"\n\n getTransformFromPointToPoint(self, pos3, other_node, other_pos3) ->\n hou.Matrix4\n\n Return the transform matrix that rotates the point pos3 (in this\n object node's transform space) to the point other_pos3 (in another\n object node's transform space).\n\n > obj1.getTransformFromPointToPoint(pos1, obj2, pos2)\n\n ...is equivalent to...\n\n > (obj1.worldTransform().inverted() *\n > hou.hmath.buildTranslate(-pos1) *\n > hou.hmath.buildTranslate(pos2) *\n > obj2.worldTransform())\n\n See also the hou.ObjNode.getTransformToNode and\n hou.ObjNode.worldTransform methods, and the functions in the\n hou.hmath module.\n\n\n \"\"\"\n def buildLookatRotation(self, to_node: ObjNode, up_vector: Optional[Vector3] = None) -> Matrix4:\n '''\n\n buildLookatRotation(self, to_node, up_vector=None) -> hou.Matrix4\n\n Return a matrix that will rotate this object to look at the\n specified object.\n\n The returned hou.Matrix4 object transforms this object from its\n current position in world space so that its negative z axis points\n at the origin of the to_node object.\n\n up_vector can either be a hou.Vector3 object or None. If it is None,\n this method uses an up vector of hou.Vector3(0, 1, 0).\n\n You can extract the rotation values from the return value with\n hou.Matrix4.extractRotates. You can set an object\\'s transform with\n hou.ObjNode.setWorldTransform.\n\n > # Set the cam1 object\\'s transform so it points at geo1.\n > cam1 = hou.node(\\\\\"/obj/cam1\\\\\")\n > lookat_obj = hou.node(\\\\\"/obj/geo1\\\\\")\n > cam1.setWorldTransform(cam1.buildLookatRotation(lookat_obj))\n\n See also hou.ObjNode.setWorldTransform.\n\n\n '''\n def isObjectDisplayed(self) -> bool:\n \"\"\"\n\n isObjectDisplayed(self) -> bool\n\n Return whether or not this object is displayed. This method takes\n into account both the display flag and the display parameter. If the\n display parameter is enabled, because the tdisplay parameter is set,\n this parameter overrides the flag.\n\n See also hou.ObjNode.isDisplayFlagSet, which returns the current\n state of the flag.\n\n\n \"\"\"\n def isObjectDisplayedAtFrame(self, frame: float) -> bool:\n \"\"\"\n\n isObjectDisplayedAtFrame(self, frame) -> bool\n\n Return whether or not this object is displayed at the given frame.\n This method takes into account both the display flag and the display\n parameter. If the display parameter is enabled, because the tdisplay\n parameter is set, this parameter overrides the flag.\n\n See also hou.ObjNode.isDisplayFlagSet, which returns the current\n state of the flag.\n\n\n \"\"\"\n def isDisplayFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayFlagSet(self) -> bool\n\n Return whether or not this object's display flag is turned on. Note\n that the display flag and the display parameter both determine\n whether the object is actually displayed.\n\n Use hou.ObjNode.isObjectDisplayed to determine if the object is\n actually displayed.\n\n\n \"\"\"\n def setDisplayFlag(self, on: bool) -> None:\n \"\"\"\n\n setDisplayFlag(self, on)\n\n Turn the object's display flag on or off. See also\n hou.ObjNode.isDisplayFlagSet.\n\n\n \"\"\"\n def isSelectableInViewport(self) -> bool:\n \"\"\"\n\n isSelectableInViewport(self) -> bool\n\n Return whether or not the selectable flag is set. When it is not\n set, it is not possible to select this object or any of its geometry\n interactively in the viewport.\n\n\n \"\"\"\n def setSelectableInViewport(self, on: bool) -> None:\n \"\"\"\n\n setSelectableInViewport(self, on)\n\n Set the object's selectable flag. See\n hou.ObjNode.isSelectableInViewport for more information.\n\n\n \"\"\"\n def isShowingOrigin(self) -> bool:\n \"\"\"\n\n isShowingOrigin(self) -> bool\n\n Return whether or not this object displays its local origin gnomon\n in the viewport.\n\n Note that you can change this setting by right-clicking on the node.\n\n\n \"\"\"\n def showOrigin(self, on: bool) -> None:\n \"\"\"\n\n showOrigin(self, on)\n\n Show or hide this object's local origin gnomon in the viewport. See\n also hou.ObjNode.isShowingOrigin.\n\n\n \"\"\"\n def isUsingXray(self) -> bool:\n \"\"\"\n\n isUsingXray(self) -> bool\n\n Return whether or not this object displays its geometry in xray\n mode. Houdini displays xrayed geometry in wireframe and makes it\n visible even when it is hidden behind another surface.\n\n Note that you can change this setting by right-clicking on the node.\n\n\n \"\"\"\n def useXray(self, on: bool) -> None:\n \"\"\"\n\n useXray(self, on)\n\n Turn this object's xray mode on or off. See also\n hou.ObjNode.isUsingXray.\n\n\n \"\"\"\n def displayNode(self) -> Optional[Node]:\n \"\"\"\n\n displayNode(self) -> hou.OpNode or None\n\n If this object contains SOPs or DOPs, return the one that has its\n display flag on. Otherwise, return None.\n\n\n \"\"\"\n def renderNode(self) -> Optional[Node]:\n \"\"\"\n\n renderNode(self) -> hou.OpNode or None\n\n If this object contains SOPs or DOPs, return the one that has its\n render flag on. Otherwise, return None.\n\n\n \"\"\"\n def combine(self, nodes: Sequence[Node]) -> None:\n \"\"\"\n\n combine(self, nodes)\n\n Combine the geometry from the given list of hou.ObjNode's into this\n object. After this operation, the old objects will be deleted.\n\n Raises hou.ObjectWasDeleted if any of the nodes no longer exist in\n Houdini. Raises TypeError if any of the nodes are not of type\n hou.ObjNode. These exceptions are raised prior to performing the\n combine operation to avoid partial results.\n\n\n \"\"\"\n def material(self, operation: Literal['override','select','remove','rmdefault','sync','revert','addlist'], parameter: Sequence[str]|None = ...) -> None:\n '''\n\n material(self, operation, parameter)\n\n Manages object-local overrides of material parameters. This is\n basically the scripting equivalent of the Material Override menu in\n the parameter editor for objects. It allows you to create parameters\n on an object that override the equivalent values on the object\\'s\n material.\n\n The operation argument should be one of the following strings:\n\n\n \\\\\"override\\\\\"\n Create parameters on the object to override all material\n parameters.\n\n \\\\\"select\\\\\"\n Select and create object parameters to override material\n parameters.\n\n \\\\\"remove\\\\\"\n Removes all object parameter overrides.\n\n \\\\\"rmdefault\\\\\"\n Removes any unchanged object parameters (that is, that are\n currently set to their default value).\n\n \\\\\"sync\\\\\"\n Synchronize the object parameter overrides with the parameter\n definitions on the material.\n\n \\\\\"revert\\\\\"\n Revert any parameter overrides on the object to their values on\n the material.\n\n \\\\\"addlist\\\\\"\n (Followed by a second argument containing a list of parameter\n names strings.) Creates object parameters to override the named\n parameters on the material.\n\n > \n > myobject = hou.node(\\\\\"/obj/obj1\\\\\")\n > \n > # Add all material overrides\n > myobject.material(\\\\\"override\\\\\")\n > \n > # Remove all material overrides\n > myobject.material(\\\\\"remove\\\\\")\n > \n > # Add specific overrides for \\\\\"baseColor\\\\\" and \\\\\"roughness\\\\\" parameters\n > myobject.material(\\\\\"addlist\\\\\", [\\\\\"baseColor\\\\\", \\\\\"roughness\\\\\"])\n\n '''\n\nclass Prim:\n \"\"\"\n\n hou.Prim\n\n Each Prim resides inside a Geometry object and stores some sort of 3D\n geometric primitive, like a polygon, a NURBS curve, or a volume. Each\n primitive usually contains a set of Vertex objects, each of which\n references a Point object.\n\n This class has a number of subclasses for the different primitive types,\n such as hou.Polygon and hou.Volume.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self) -> hou.Geometry\n\n Return the hou.Geometry object containing this primitive.\n\n\n \"\"\"\n def number(self) -> int:\n \"\"\"\n\n number(self) -> int\n\n Return the number of this primitive. Primitives are numbered\n sequentially starting from 0, and the primitives returned by\n hou.Geometry.prims are in order by their number.\n\n\n \"\"\"\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.primType enum value\n\n Return a hou.primType value containing the type of this primitive\n (e.g. polygon, NURBS curve, metaball, etc).\n\n\n \"\"\"\n def attribType(self) -> EnumValue:\n \"\"\"\n\n attribType(self) -> hou.attribType enum value\n\n Return the enumerated value hou.attribType.Prim. Points, primitives,\n vertices, and geometry support the same set of methods for querying\n their attributes, and this method is one of them.\n\n See also:\n\n * hou.Point.attribType\n\n * hou.Vertex.attribType\n\n * hou.Geometry.attribType\n\n * hou.attribType\n\n\n \"\"\"\n def vertices(self) -> Iterator[Vertex]:\n \"\"\"\n\n vertices(self) -> generator of hou.Vertex\n\n Return a sequence of the vertices contained in this primitive.\n\n If the primitive is a face (e.g. a polygon or NURBS curve), the\n result corresponds to the order of the vertices in that face. If it\n is a surface (e.g. a NURBS mesh), however, the primitive has a 2D\n array of vertices, and this method returns all vertices in the 2D\n array, ordered by the rows.\n\n See hou.Surface.vertex for more information about the relationship\n between the 2D vertex array and the sequential vertex index, and for\n more ways to access the vertices in a surface.\n\n\n \"\"\"\n def numVertices(self) -> int:\n \"\"\"\n\n numVertices(self) -> int\n\n A shortcut for len(self.vertices()). You probably don't need to call\n this method.\n\n\n \"\"\"\n def edges(self) -> Tuple[Edge, ...]: ...\n def numEdges(self) -> int: ...\n def floatAttribValue(self, attrib: Attrib|str) -> float:\n \"\"\"\n\n floatAttribValue(self, attrib) -> float\n\n Return the primitive attribute value for a particular floating point\n attribute. The attribute may be specified by name or by hou.Attrib\n object.\n\n Raises hou.OperationFailed if no attribute exists with this name or\n the attribute is not float of size 1.\n\n In most cases, you'll just use hou.Prim.attribValue to access\n attribute values. Houdini uses this method internally to implement\n attribValue.\n\n\n \"\"\"\n def floatListAttribValue(self, name_or_attrib: str|Attrib) -> Tuple[float,...]:\n \"\"\"\n\n floatListAttribValue(self, name_or_attrib) -> tuple of float\n\n Return the primitive attribute value for a particular floating point\n attribute. The attribute may be specified by name or by hou.Attrib\n object. The return value is a tuple of floats.\n\n It is valid to call this method when the attribute's size is 1. In\n this case, a tuple with one element is returned.\n\n See also hou.Prim.attribValue.\n\n\n \"\"\"\n def intAttribValue(self, attrib: Attrib|str) -> int:\n \"\"\"\n\n intAttribValue(self, name_or_attrib) -> int\n\n Return the primitive attribute value for a particular integer\n attribute of size 1. The attribute may be specified by name or by\n hou.Attrib object. See hou.Point.floatAttribValue for more\n information.\n\n\n \"\"\"\n def intListAttribValue(self, name_or_attrib: Attrib|str) -> Tuple[int,...]:\n \"\"\"\n\n intListAttribValue(self, name_or_attrib) -> tuple of int\n\n Return the primitive attribute value for a particular integer\n attribute. The attribute may be specified by name or by hou.Attrib\n object. The return value is a tuple of ints. See\n hou.Prim.floatListAttribValue for more information.\n\n\n \"\"\"\n def stringAttribValue(self, attrib: Attrib|str) -> str:\n \"\"\"\n\n stringAttribValue(self, name_or_attrib) -> str\n\n Return the primitive attribute value for a particular string\n attribute. The attribute may be specified by name or by hou.Attrib\n object. See hou.Prim.floatAttribValue for more information.\n\n\n \"\"\"\n def stringListAttribValue(self, name_or_attrib: Attrib|str) -> Tuple[str,...]:\n \"\"\"\n\n stringListAttribValue(self, name_or_attrib) -> tuple of str\n\n Return the primitive attribute value for a particular string\n attribute. The attribute may be specified by name or by hou.Attrib\n object. The return value is a tuple of strings.\n\n It is valid to call this method when the attribute's size is 1. In\n this case, a tuple with one element is returned.\n\n See also hou.Prim.attribValue.\n\n\n \"\"\"\n def dictAttribValue(self, attrib: Attrib|str) -> AttribDictReturnType:\n \"\"\"\n\n dictAttribValue(self, name_or_attrib) -> dict\n\n Return the primitive attribute value for a particular dictionary\n attribute. The attribute may be specified by name or by hou.Attrib\n object. See hou.Prim.floatAttribValue for more information.\n\n\n \"\"\"\n def dictListAttribValue(self, name_or_attrib: Attrib|str) -> Sequence[AttribDictReturnType]:\n \"\"\"\n\n dictListAttribValue(self, name_or_attrib) -> tuple of str\n\n Return the primitive attribute value for a particular dictionary\n attribute. The attribute may be specified by name or by hou.Attrib\n object. The return value is a tuple of dictionaries.\n\n It is valid to call this method when the attribute's size is 1. In\n this case, a tuple with one element is returned. See\n hou.Prim.floatAttribValue for more information.\n\n\n \"\"\"\n def setAttribValue(self, name_or_attrib: Attrib|str, attrib_value: AttribArgType|AttribDictArgType) -> None:\n '''\n\n setAttribValue(self, name_or_attrib, attrib_value)\n\n Store an attribute value in this primitive. The attribute may be\n specified by name or by hou.Attrib object, and must be an existing\n primitive attribute in the geometry. You would typically call this\n method from the code of a Python-defined SOP.\n\n Raises hou.OperationFailed if no attribute exists with this name or\n if the attribute\\'s data type does not match the value passed in. If\n the attribute\\'s size is more than 1, the attribute value must be a\n sequence of integers/floats, and the size of the sequence must match\n the attribute\\'s size.\n\n If the attribute is an array, the seqeunce must be a flat array, not\n an array of tuples. If the attribute is float, ensure the python\n objects are float, and not integer (1.0, not 1).\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > # Create a float primitive attribute of size 3 named \\\\\"Cd\\\\\", and assign\n > # each primitive a unique color. This code will work from inside a Python\n > # SOP, but not from the Python shell.\n > geo = hou.pwd().geometry()\n > color_attrib = geo.addAttrib(hou.attribType.Prim, \\\\\"Cd\\\\\", (1.0, 1.0, 1.0))\n > num_prims = len(geo.prims())\n > color = hou.Color()\n > for prim in geo.prims():\n > fraction = float(prim.number()) / num_prims\n > # Give each primitive a different hue, but full saturation and value.\n > # Store the RGB value in the attribute.\n > color.setHSV((fraction * 255, 1, 1))\n > prim.setAttribValue(color_attrib, color.rgb())\n\n '''\n def intrinsicNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n intrinsicNames(self) -> tuple of str\n\n Returns a tuple of strings representing the intrinsic values\n available for this primitive. Different primitive types will have\n different intrinsic values available. You can then get or set the\n value using hou.Prim.intrinsicValue and/or\n hou.Prim.setIntrinsicValue.\n\n\n \"\"\"\n def intrinsicValue(self, intrinsic_name: str) -> AttribReturnType:\n \"\"\"\n\n intrinsicValue(self, intrinsic_name) -> int, float, str, or tuple\n\n Gets the value of an intrinsic, often computed, value of the\n primitive, such as bounds, measuredarea, vertexcount, and so on.\n\n Most intrinsic values are computed, such as measuredarea, however a\n few are writeable with hou.Prim.setIntrinsicValue. For example,\n sphere primitives have a transform matrix as part of their\n definition.\n\n You can also view these values in the user interface using the\n geometry spreadsheet.\n\n Raises hou.OperationFailed if the given intrinsic name does not\n exist. You can get a list of the available intrinsic value names\n with hou.Prim.intrinsicNames. Different primitive types will have\n different intrinsic values available.\n\n Bounding box intrinsic values like bounds or packedbounds are\n returned in (xmin, xmax, ymin, ymax, zmin, zmax) order.\n\n\n \"\"\"\n def intrinsicSize(self, intrinsic_name: str) -> int:\n \"\"\"\n\n intrinsicSize(self, intrinsic_name) -> int\n\n Returns the intrinsic value's tuple size.\n\n\n \"\"\"\n def intrinsicReadOnly(self, intrinsic_name: str) -> bool:\n \"\"\"\n\n intrinsicReadOnly(self, intrinsic_name) -> bool\n\n Returns whether the intrinsic is read-only or can be modified with\n hou.Prim.setIntrinsicValue.\n\n\n \"\"\"\n def setIntrinsicValue(self, intrinsic_name: str, value: AttribArgType) -> None:\n \"\"\"\n\n setIntrinsicValue(self, intrinsic_name, value)\n\n Some intrinsic values can be modified. For example, you change the\n internal size and rotation (transform) of a sphere primitive by\n passing a 9 float tuple representing the transform to\n hou.Prim.setIntrinsicValue. Raises hou.OperationFailed if the\n intrinsic is not writeable or does not accept the passed value, or\n if the given intrinsic name does not exist.\n\n\n \"\"\"\n def attribValue(self, attrib: Attrib|str) -> AttribReturnType|AttribDictReturnType:\n \"\"\"\n\n attribValue(self, name_or_attrib) -> int, float, str, tuple or dict\n\n Return the value stored in this primitive for a particular\n attribute. The attribute may be specified by name or by hou.Attrib\n object.\n\n Looking an attribute value using a hou.Attrib object is slightly\n faster than looking it up by name. When looking up attribute values\n inside a loop, look up the hou.Attrib object outside the loop, and\n pass it into this method.\n\n When looking up the attribute values of all primitives, it is faster\n to call hou.Geometry.primFloatAttribValues or\n hou.Geometry.primFloatAttribValuesAsString than to call this method\n for each primitive in the geometry.\n\n Raises hou.OperationFailed if no attribute exists with this name.\n\n\n \"\"\"\n def positionAtInterior(self, u: float, v: float, w: float = 0.0) -> Vector3:\n \"\"\"\n\n positionAtInterior(self, u, v, w=0.0) -> hou.Vector3\n\n Given normalized (i.e. from 0 to 1) u, v, w values, return the\n interior position of the primitive at that parametric location.\n\n Use hou.Face.positionAt for querying positions along the perimeter.\n\n\n \"\"\"\n def attribValueAtInterior(self, attrib: Attrib|str, u: float, v: float, w: float = ...) -> AttribReturnType:\n \"\"\"\n\n attribValueAtInterior(self, attrib_or_name, u, v, w=0.0) -> int, float,\n str or tuple\n\n Return an attribute value at the normalized u, v, w parametric\n position in the interior of the primitive.\n\n Raises hou.OperationFailed if the attribute is not a point or vertex\n attribute. If you want a primitive attribute value, it doesn't vary\n across the surface, so use hou.Prim.attribValue.\n\n If the attribute name is N the primitive's intrinsic normal is\n evaluated, not the value from any point or primitive attributes.\n\n Use hou.Face.attribValueAt for querying attributes along the\n perimeter.\n\n\n \"\"\"\n def boundingBox(self) -> BoundingBox:\n \"\"\"\n\n boundingBox(self) -> hou.BoundingBox\n\n Return an axis-aligned 3D bounding box that is sized and positioned\n to be large enough to hold this primitive.\n\n\n \"\"\"\n def nearestToPosition(self, position: Sequence[float]) -> Tuple[float, float, float]:\n \"\"\"\n\n nearestToPosition(self, pos3)\n\n Given a sequence of three floats containing a position, find the\n location on this primitive that is closest to that position. Returns\n a tuple containing the u value on this primitive, the v value on\n this primitive, and the distance to this primitive.\n\n NOTE: The returned UVs are in real coordinates, use the\n primuvConvert to switch to unit coordinates to match VEX's xyzdist.\n\n\n \"\"\"\n def groups(self) -> Tuple[PrimGroup, ...]:\n \"\"\"\n\n groups(self) -> tuple of hou.PrimGroup\n\n Return a tuple of the primitive groups that contain this primitive.\n\n\n \"\"\"\n def primuvConvert(self, uv: Sequence[float]|Vector2, mode: int, tol: float|None = ...) -> Vector2:\n \"\"\"\n\n primuConvert(self, u, mode, tol)\n\n Given a 1D u coordinate, compute the location in a different\n coordinate system. The tol argument is optional. See the\n primuvconvert VEX function for the different valid modes.\n\n\n \"\"\"\n def primuConvert(self, u: float, mode: int, tol: float|None = ...) -> float: ...\n\n # Missing methods added by stubgen\n def voxelRangeAsBool(self, range: BoundingBox) -> Tuple[bool, ...]: ...\n def voxelRangeAsInt(self, range: BoundingBox) -> Tuple[int, ...]: ...\n def voxelRangeAsFloat(self, range: BoundingBox) -> Tuple[float, ...]: ...\n def voxelRangeAsVector3(self, range: BoundingBox) -> Sequence[Vector3]: ...\n\nclass Face(Prim):\n \"\"\"\n\n hou.Face\n\n A Face is a kind of geometry primitive (Prim object) that contains a\n sequence of vertices (Vertex objects). How these vertices are used\n depends on the type of face; polygons, for example, use the vertices to\n define the edges of the polygon, while NURBS curves use them as control\n points.\n\n A hou.Surface, on the other hand, stores a two dimension grid of\n vertices, and might be a NURBS surface, Bezier surface, or quadrilateral\n mesh.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isClosed(self) -> bool:\n \"\"\"\n\n isClosed(self) -> bool\n\n Return whether the first and last vertex are connected.\n\n An open face forms a multi-segment line or curve, since the first\n and last vertices are not connected. A closed face forms a very thin\n surface.\n\n\n \"\"\"\n def closed(self) -> bool:\n \"\"\"\n\n closed(self) -> bool\n\n This method is deprecated in favor of hou.isClosed.\n\n\n \"\"\"\n def setIsClosed(self, on: bool) -> None:\n \"\"\"\n\n setIsClosed(self, on)\n\n Set whether the face is open or closed. See hou.Face.isClosed for\n more information. You would typically call this method from the code\n of a Python-defined SOP.\n\n Note that this method will raise hou.OperationFailed on a Bezier\n curve. See hou.Geometry.createBezierCurve for more information.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def normal(self) -> Vector3:\n \"\"\"\n\n normal(self) -> hou.Vector3\n\n Return the vector that's perpendicular to the face.\n\n\n \"\"\"\n def positionAt(self, u: float) -> Vector3:\n \"\"\"\n\n positionAt(self, u) -> hou.Vector3\n\n Given a normalized (i.e. from 0 to 1) u value, return the position\n of the curve at that parametric location.\n\n\n \"\"\"\n def attribValueAt(self, attrib_or_name: Attrib|str, u: float, du: float = ...) -> int|float|str|Tuple[int,...]|Tuple[float,...]:\n \"\"\"\n\n attribValueAt(self, attrib_or_name, u, du=0) -> int, float, str or tuple\n\n Return an attribute value at a normalized u parametric position on\n the curve. If du is 0, returns the interpolated attribute value;\n otherwise, returns the derivative of the attribute value.\n\n Raises hou.OperationFailed if the attribute is not a point or vertex\n attribute. If you want a primitive attribute value, it doesn't vary\n across the surface, so use hou.Prim.attribValue.\n\n\n \"\"\"\n def vertex(self, index: int) -> Vertex:\n \"\"\"\n\n vertex(self, index)\n\n A shortcut for self.vertices()[index]. You probably don't need to\n call this method.\n\n This method supports negative indices to index from the end, just\n like self.vertices()[index] would. Also, like Python's indexing\n operator, it will raise IndexError when the index is out of range.\n\n\n \"\"\"\n def addVertex(self, point: Point) -> Vertex:\n \"\"\"\n\n addVertex(self, point) -> hou.Vertex\n\n Create a new vertex inside this face, adding it to the end of the\n vertex list. You would typically call this method from the code of a\n Python-defined SOP.\n\n point is a hou.Point object that the new vertex will refer to. See\n hou.Vertex for information on the relationship between points and\n vertices.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > # These arrays define point positions and a set of polygons composed\n > # of those points. Note that the point positions could also be floating\n > # point values.\n > point_positions = ((0,0,0), (1,0,0), (1,1,0), (0,1,0))\n > poly_point_indices = ((0,1,2), (2,3,0))\n > \n > geo = hou.pwd().geometry()\n > \n > # Create all the points.\n > points = []\n > for position in point_positions:\n > points.append(geo.createPoint())\n > points[-1].setPosition(position)\n > \n > # Now create the polygons, adding vertices that refer to the points.\n > for point_indices in poly_point_indices:\n > poly = geo.createPolygon()\n > for point_index in point_indices:\n > poly.addVertex(points[point_index])\n\n See also:\n\n * hou.Geometry.createPoint\n\n * hou.Geometry.createPolygon\n\n\n \"\"\"\n def arcLength(self, u_start: float, u_stop: float, divs: int = 10) -> float:\n \"\"\"\n\n arcLength(self, u_start, u_stop, divs=10) ->float\n\n Given normalized (i.e. from 0 to 1) u_start and u_stop values,\n return the length of the arc of curve. divs represents the number of\n divisions per spans. Increasing it increases the precision of the\n computation.\n\n\n \"\"\"\n\nclass PackedPrim(Prim):\n '''\n\n hou.PackedPrim\n\n A packed primitive.\n\n See packed primitives for more information.\n\n To set contents of the packed primitive, use the\n hou.Prim.setIntrinsicValue method:\n\n > prim = myGeometry.createPacked(\\\\\"PackedDisk\\\\\")\n > prim.setIntrinsicValue(\\\\\"unexpandedfilename\\\\\", \\\\\"defgeo.bgeo\\\\\")\n\n To get the list of available intrinsic attributes you can set:\n\n * View a packed primitive of the type you want in the geometry\n spreadsheet and turn on display of intrinsic attributes.\n\n or\n\n * In a Houdini tools command line, type ginfo -IP to see a list of all\n intrinsic attributes on all packed primitive types.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def transform(self) -> Matrix3:\n \"\"\"\n\n transform(self) -> hou.Matrix3\n\n Returns the local 3x3 transform associated with this primitive. The\n transform doesn't include the local point transform or any\n transforms inside the primitive (for example, transforms inside an\n Alembic file).\n\n\n \"\"\"\n def fullTransform(self) -> Matrix4:\n \"\"\"\n\n fullTransform(self) -> hou.Matrix4\n\n Returns the full 4x4 transform for this primitive's geometry. This\n includes translations due to points and any transforms inside the\n primitive (for example, transforms inside an Alembic file).\n\n\n \"\"\"\n def setTransform(self, transform: Matrix4) -> None:\n \"\"\"\n\n setTransform(self, m4)\n\n Sets this primitive's local transform. This sets the local 3x3\n transform and the translation of the point. This does not affect any\n transforms inside the primitive (for example, transforms inside an\n Alembic file).\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n m4\n A hou.Matrix4 object containing the full transform.\n\n\n \"\"\"\n def vertex(self, index: int) -> Vertex:\n \"\"\"\n\n vertex(self, index)\n\n A shortcut for self.vertices()[index]. You probably don't need to\n call this method.\n\n This method supports negative indices to index from the end, just\n like self.vertices()[index] would. Also, like Python's indexing\n operator, it will raise IndexError when the index is out of range.\n\n\n \"\"\"\n\nclass BaseKeyframe:\n \"\"\"\n\n hou.BaseKeyframe\n\n Abstract base class for all keyframe class.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def evaluatedType(self) -> EnumValue:\n \"\"\"\n\n evaluatedType(self) -> hou.parmData enum value\n\n Returns the type that the keyframe evaluates to.\n\n\n \"\"\"\n def setExpression(self, expression: str, language: Optional[EnumValue] = None) -> None:\n \"\"\"\n\n setExpression(self, expression, language=None)\n\n Sets the keyframe's expression and language.\n\n This function raises TypeError if language is not a value from\n hou.exprLanguage.\n\n See expression(), expressionLanguage(), isExpressionSet(),\n isExpressionLanguageSet().\n\n\n \"\"\"\n def expression(self) -> str:\n \"\"\"\n\n expression(self) -> str\n\n Returns the keyframe's expression. For example, in cases where the\n keyframe has had two values set the interpolating function is\n returned e.g. bezier(), spline() etc.\n\n This function raises hou.KeyframeValueNotSet if an expression has\n not been set.\n\n See setExpression() and isExpressionSet().\n\n\n \"\"\"\n def isExpressionSet(self) -> bool:\n \"\"\"\n\n isExpressionSet(self) -> bool\n\n Returns whether the keyframe's expression is set.\n\n See setExpression() and expression().\n\n\n \"\"\"\n def expressionLanguage(self) -> EnumValue:\n \"\"\"\n\n expressionLanguage(self) -> hou.exprLanguage enum value\n\n Returns the keyframe's expression's language.\n\n This function raises hou.KeyframeValueNotSet if an expression\n language has not ben set.\n\n See setExpression(), and isExpressionLanguageSet().\n\n\n \"\"\"\n def isExpressionLanguageSet(self) -> bool:\n \"\"\"\n\n isExpressionLanguageSet(self) -> bool\n\n Returns whether the keyframe expression's language is set.\n\n See setExpression() and expressionLanguage().\n\n\n \"\"\"\n def setTime(self, time: float) -> None:\n \"\"\"\n\n setTime(self, time)\n\n Sets the keyframe's time in seconds. Using the number of frames per\n second (hou.fps), setting the time also sets the frame number. For\n example, with an fps of 24, then setting the time to 2 seconds will\n set the frame number to 49.\n\n See time().\n\n\n \"\"\"\n def isTimeSet(self) -> bool:\n \"\"\"\n\n isTimeSet(self) -> bool\n\n Returns whether the keyframe's time is set.\n\n See setTime() and time().\n\n\n \"\"\"\n def time(self) -> float:\n \"\"\"\n\n time(self) -> double\n\n Returns the keyframe's time in seconds.\n\n This function raises hou.KeyframeValueNotSet if the time or frame\n has not been set.\n\n See setTime() and setFrame().\n\n\n \"\"\"\n def setFrame(self, frame: float) -> None:\n \"\"\"\n\n setFrame(self, frame)\n\n Sets the keyframe's frame number. Using the number of frames per\n second (hou.fps), setting the frame number also sets the time. For\n example, with an fps of 24, then setting the frame number to 49 will\n set the time to 2 seconds.\n\n See frame().\n\n\n \"\"\"\n def frame(self) -> float:\n \"\"\"\n\n frame(self) -> double\n\n Returns the keyframe's frame number.\n\n This function raises hou.KeyframeValueNotSet if the frame or time\n has not been set.\n\n See setFrame() and setTime().\n\n\n \"\"\"\n def asCode(self, brief: bool = False, save_keys_in_frames: bool = False, function_name: Optional[str] = None) -> str:\n '''\n\n asCode(self, brief=False, save_keys_in_frames=False, function_name=None)\n -> str\n\n Returns a script of Python statements that can be executed to create\n the keyframe. To run the script, use either Python\\'s exec or\n execfile functions.\n\n\n brief\n When is True, the output script omits commands for\n setting unused values, slopes and accelerations. This parameter\n only applies to non-string keyframes. The value of must\n be either True or False.\n\n save_keys_in_frames\n When is True, asCode outputs commands for\n setting channel and key times in samples (frames) instead of\n seconds. The value of must be either True\n or False.\n\n function_name\n If is specified, then the output script is\n wrapped in a Python function definition with the given name.\n must be a non-zero length string consisting of\n only alphanumeric and underscore characters. Any invalid\n characters are internally converted to underscores.\n\n The function returns a reference to the newly created keyframe\n object.\n\n Here is an example of saving the output to a file and then loading\n it back into Houdini:\n\n > # Get a reference to the target keyframe.\n > tx_parm = hou.parm(\\\\\"/obj/geo1/tx\\\\\")\n > key = tx_parm.keyframes()[0]\n > \n > # Execute asCode and write the output script to file.\n > script = key.asCode()\n > f = open(\\\\\"create_key.py\\\\\", \\\\\"w\\\\\")\n > f.write(script)\n > f.close()\n > \n > # Execute the script. The new keyframe will be stored \n > # in the \\'hou_keyframe\\' variable.\n > execfile(\\\\\"create_key.py\\\\\")\n > \n > # Commit the keyframe back into the node parameter.\n > tx_parm.setKeyframe(hou_keyframe)\n\n Here is an example of saving the output into a function and then\n calling it in Houdini:\n\n > # Get a reference to the target keyframe.\n > tx_parm = hou.node(\\\\\"/obj/geo1\\\\\").Parm(\\\\\"tx\\\\\")\n > key = tx_parm.keyframes()[0]\n > \n > # Execute asCode and write the function definition to file.\n > func = key.asCode(function_name=\\\\\"createKeyframe\\\\\")\n > f = open(\\\\\"keylib.py\\\\\", \\\\\"w\\\\\")\n > f.write(func)\n > f.close()\n > \n > # Call the function definition.\n > import keylib\n > hou_keyframe = keylib.createKeyframe()\n > \n > # Commit the keyframe back into the node parameter.\n > tx_parm.setKeyframe(hou_keyframe)\n\n '''\n\nclass ChannelGraphSelection:\n \"\"\"\n\n hou.ChannelGraphSelection\n\n A copy of an Animation Editor Graph Selection.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, path: str|None = ..., flags: Sequence[int] = ...) -> None:\n \"\"\"\n\n hou.ChannelGraphSelection\n\n A copy of an Animation Editor Graph Selection.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def parm(self) -> Parm:\n \"\"\"\n\n path(self) -> str\n\n Return the parameter path associated with the channel graph\n selection.\n\n\n \"\"\"\n def path(self) -> str: ...\n def keyframes(self) -> Tuple[BaseKeyframe, ...]:\n \"\"\"\n\n keyframes(self) -> tuple of hou.BaseKeyframe\n\n Return the keyframes on the parameter. The selection arrays match\n the order of the keyframes.\n\n\n \"\"\"\n def flags(self) -> Tuple[int, ...]:\n \"\"\"\n\n setFlags(self) -> tuple of int\n\n Set the raw selection flags for all keyframes of the parameter.\n\n\n \"\"\"\n def setFlags(self, flags: Sequence[int]) -> None: ...\n def values(self) -> Tuple[int, ...]:\n \"\"\"\n\n values(self) -> tuple of int\n\n Return the value selection flags for all keyframes of the parameter.\n\n\n \"\"\"\n def timeMarks(self) -> Tuple[int, ...]:\n \"\"\"\n\n timeMarks(self) -> tuple of int\n\n Return the time mark selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def slopes(self) -> Tuple[int, ...]:\n \"\"\"\n\n slopes(self) -> tuple of int\n\n Return the slope selection flags for all keyframes of the parameter.\n\n\n \"\"\"\n def accelerations(self) -> Tuple[int, ...]:\n \"\"\"\n\n accelerations(self) -> tuple of int\n\n Return the acceleration selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def segments(self) -> Tuple[int, ...]:\n \"\"\"\n\n segments(self) -> tuple of int\n\n Return the segment selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def inValues(self) -> Tuple[int, ...]:\n \"\"\"\n\n inValues(self) -> tuple of int\n\n Return the incoming value selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def inSlopes(self) -> Tuple[int, ...]:\n \"\"\"\n\n inSlopes(self) -> tuple of int\n\n Return the incoming slope selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def inAccelerations(self) -> Tuple[int, ...]:\n \"\"\"\n\n inAccelerations(self) -> tuple of int\n\n Return the incoming acceleration selection flags for all keyframes\n of the parameter.\n\n\n \"\"\"\n def outValues(self) -> Tuple[int, ...]:\n \"\"\"\n\n outValues(self) -> tuple of int\n\n Return the outgoing value selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def outSlopes(self) -> Tuple[int, ...]:\n \"\"\"\n\n outSlopes(self) -> tuple of int\n\n Return the outgoing slope selection flags for all keyframes of the\n parameter.\n\n\n \"\"\"\n def outAccelerations(self) -> Tuple[int, ...]:\n \"\"\"\n\n outAccelerations(self) -> tuple of int\n\n Return the outgoing acceleration selection flags for all keyframes\n of the parameter.\n\n\n \"\"\"\n def selectValues(self, sel: Sequence[int], _in: bool = True, out: bool = True) -> None:\n \"\"\"\n\n selectValues(self,selections,sel_incoming,sel_outgoing)\n\n Select incoming or outgoing keyframe value handles.\n\n\n \"\"\"\n def selectTimeMarks(self, sel: Sequence[int]) -> None:\n \"\"\"\n\n selectTimeMarks(self,selections)\n\n Select time mark handles.\n\n\n \"\"\"\n def selectSlopes(self, sel: Sequence[int], _in: bool = True, out: bool = True) -> None:\n \"\"\"\n\n selectSlopes(self,selections,sel_incoming,sel_outgoing)\n\n Select incoming or outgoing keyframe slope handles.\n\n\n \"\"\"\n def selectAccelerations(self, sel: Sequence[int], _in: bool = True, out: bool = True) -> None:\n \"\"\"\n\n selectAccelerations(self,selections,sel_incoming,sel_outgoing)\n\n Select incoming or outgoing keyframe acceleration handles.\n\n\n \"\"\"\n def selectSegments(self, sel: Sequence[int]) -> None:\n \"\"\"\n\n selectSegments(self,selections)\n\n Select segment handles.\n\n\n \"\"\"\n def deselectValues(self, sel: Sequence[int], _in: bool = True, out: bool = True) -> None:\n \"\"\"\n\n deselectValues(self,selections,sel_incoming,sel_outgoing)\n\n Select incoming or outgoing keyframe value handles.\n\n\n \"\"\"\n def deselectTimeMarks(self, sel: Sequence[int]) -> None:\n \"\"\"\n\n deselectTimeMarks(self,selections)\n\n Select time mark handles.\n\n\n \"\"\"\n def deselectSlopes(self, sel: Sequence[int], _in: bool = True, out: bool = True) -> None:\n \"\"\"\n\n deselectSlopes(self,selections,sel_incoming,sel_outgoing)\n\n Select incoming or outgoing keyframe slope handles.\n\n\n \"\"\"\n def deselectAccelerations(self, sel: Sequence[int], _in: bool = True, out: bool = True) -> None:\n \"\"\"\n\n deselectAccelerations(self,selections,sel_incoming,sel_outgoing)\n\n Select incoming or outgoing keyframe acceleration handles.\n\n\n \"\"\"\n def deselectSegments(self, sel: Sequence[int]) -> None:\n \"\"\"\n\n deselectSegments(self,selections)\n\n Select segment handles.\n\n\n \"\"\"\n\nclass NodeType:\n '''\n\n hou.NodeType\n\n Information common to all instances of a type of node, such as the\n parameters.\n\n For example, the Geometry object and Subdivide SOP are node types.\n /obj/geo1 and /obj/geo2, on the other hand, are Node instances of the\n Geometry object node type.\n\n You can get a NodeType object from a Node object with hou.Node.type. For\n example, if /obj/geo1 is a geometry object, hou.node(\\\\\"/obj/geo1\\\\\").type()\n will return the NodeType corresponding to all geometry objects.\n\n All the node types in Houdini are organized into categories, and a node\n type is uniquely identified by its category and node type name. For\n example, objects, SOPs, POPs, etc. are node type categories. You can\n also access a NodeType object from a category with\n hou.NodeTypeCategory.nodeTypes. Similarly, you can call hou.nodeType_\n with the category and node type name.\n\n See also hou.Node and hou.NodeTypeCategory.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def category(self) -> NodeTypeCategory:\n \"\"\"\n\n category(self) -> hou.NodeTypeCategory\n\n Return the node type category for this node type. For example, for\n the geometry object, the result is the object returned by\n hou.objNodeTypeCategory.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of this node type. For example, for the geometry\n object type, the name is geo. The name and the node type category\n together uniquely identify a node type.\n\n\n \"\"\"\n def nameComponents(self) -> Tuple[str, ...]:\n \"\"\"\n\n nameComponents(self) -> tuple of str\n\n Returns a tuple of node type name components that constitute the\n full node type name. The components in the tuple appear in the\n following order: scope network type, node type namespace, node type\n core name, and version.\n\n > # parse the full name into components\n > >>> node_type = hou.nodeType(hou.dopNodeTypeCategory(), 'pyrosolver::2.0')\n > >>> node_type.nameComponents()\n > ('', '', 'pyrosolver', '2.0')\n\n \"\"\"\n def description(self) -> str:\n '''\n\n description(self) -> str\n\n Return the description of this node type that appears in the tab\n menu. For example, for the geometry object, the description is\n \\\\\"Geometry\\\\\". This description is also called the operator label in\n Houdini.\n\n\n '''\n def nameWithCategory(self) -> str:\n '''\n\n nameWithCategory(self) -> str\n\n Return the name of the node type, prefixed with the name of the node\n type category. For example, for the geometry object, this function\n returns \\\\\"Object/geo\\\\\". The category name and type name together\n uniquely identify a node type.\n\n > >>> hou.nodeType(hou.objNodeTypeCategory(), \\\\\"geo\\\\\").nameWithCategory()\n > \\'Object/geo\\'\n\n '''\n def namespaceOrder(self) -> Tuple[str, ...]:\n \"\"\"\n\n namespaceOrder(self) -> tuple of str\n\n Returns a node type name list sorted in the descending namespace\n precedence order. The node types in the list have the same base type\n as this node type. They have different namespace and/or version.\n\n Houdini uses this list when resolving an unqualified type name in\n hou.Node.createNode() when the Edit > Preferences > Shelf Tools and\n Tab Menu > TAB Menu Operator Namespace Filtering preference is set\n to Show single Operator from the Preferred Namespace; it will use\n the first entry in that list that matches the name specified in the\n function.\n\n > # parse the full name into components\n > >>> node_type = hou.nodeType(hou.dopNodeTypeCategory(), 'pyrosolver')\n > >>> node_type.namespaceOrder()\n > ('pyrosolver::2.0', 'pyrosolver')\n\n NOTE\n The hou.Node.createNode() behavior may differ if the\n HOUDINI_OPNAMESPACE_HIERARCHY environment variable is set.\n\n\n \"\"\"\n def versionNamespaceOrder(self) -> Tuple[str, ...]:\n \"\"\"\n\n versionNamespaceOrder(self) -> tuple of str\n\n Returns a node type name list sorted in the descending version\n precedence order. The node types in the list have the same namespace\n and base type as this node type, but have different versions.\n\n Houdini uses this list when resolving an unqualified type name in\n hou.Node.createNode() when the Edit > Preferences > Shelf Tools and\n Tab Menu > TAB Menu Operator Namespace Filtering preference is set\n to Show Only Operators with Preferred Versions; it will use the\n first entry in that list that matches the name specified in the\n function.\n\n\n NOTE\n The hou.Node.createNode() behavior may differ if the\n HOUDINI_OPNAMESPACE_HIERARCHY environment variable is set.\n\n\n \"\"\"\n def icon(self) -> str:\n \"\"\"\n\n icon(self) -> str\n\n Return the name or path of the icon for this node type. Note that\n node types that ship with Houdini use a name instead of a full path,\n and Houdini uses its search path to locate the icon with that name.\n\n\n \"\"\"\n def resolvedIcon(self) -> str:\n \"\"\"\n\n resolvedIcon(self) -> str\n\n Same as icon() except that this is intended for use with UI elements\n which may not know how to resolve certain syntaxes particular to\n specific hou.NodeType subclasses.\n\n\n \"\"\"\n def minNumInputs(self) -> int:\n \"\"\"\n\n minNumInputs(self) -> int\n\n Return the minimum number of inputs that nodes of this type can\n have. If these inputs are not connected, the node will generate an\n error.\n\n\n \"\"\"\n def maxNumInputs(self) -> int:\n \"\"\"\n\n maxNumInputs(self) -> int\n\n Return the maximum number of inputs that nodes of this type can\n have. Return 9999 if this node type can accept an unlimited number\n of inputs (e.g. the merge SOP).\n\n\n \"\"\"\n def maxNumOutputs(self) -> int:\n \"\"\"\n\n maxNumOutputs(self) -> int\n\n Return the maximum number of outputs that nodes of this type can\n have. Most node types have only one output, but some, like the split\n dop, can have multiple.\n\n\n \"\"\"\n def isGenerator(self) -> bool:\n \"\"\"\n\n isGenerator(self) -> bool\n\n Return if this node type has been flagged as a generator. For\n example, a grid SOP generates new geometry, while a subdivide SOP\n does not, and instead processes the geometry passed into it. See\n also hou.NodeType.minNumInputs.\n\n\n \"\"\"\n def isManager(self, include_management_types: bool = True) -> bool:\n \"\"\"\n\n isManager(self, include_management_types=True) -> bool\n\n Return whether this NodeType is a manager. The manager node\n instances are /obj, /out, /part, /ch, /shop, /img, and /vex.\n\n If include_management_types is set to True then this method will\n additionally return True if this node type is a management node type\n such as a SHOP network, or VOP network, etc.\n\n\n \"\"\"\n def hasUnorderedInputs(self) -> bool:\n \"\"\"\n\n hasUnorderedInputs(self) -> bool\n\n Return whether it is impossible for this node type to have gaps in\n its connected inputs. For example, the cookie SOP has two inputs,\n and it's possible for only the second input to be connected, so this\n method would return False. However, the merge SOP cannot have any\n gaps in its inputs, so this method would return True.\n\n See also hou.Node.inputs, hou.Node.inputConnections, and\n hou.Node.inputConnectors.\n\n\n \"\"\"\n def hasEditableInputData(self) -> bool:\n \"\"\"\n\n hasEditableInputData(self) -> bool\n\n Return True if nodes of this node type allow the user to associate\n data with each input to the node. The purpose of this data may vary\n from one node type to another. This data can be accessed with\n methods such as hou.Node.editableInputName and\n hou.Node.setEditableInputName.\n\n\n \"\"\"\n def parmTemplates(self) -> Tuple[ParmTemplate, ...]:\n \"\"\"\n\n parmTemplates(self) -> tuple of hou.ParmTemplate\n\n Return a tuple of parm templates for the parameters on this node\n type. Note that spare parameters on individual node instances are\n not included in this tuple, since they are independent from the node\n type.\n\n\n \"\"\"\n def parmTemplateGroup(self) -> ParmTemplateGroup:\n \"\"\"\n\n parmTemplateGroup(self) -> hou.ParmTemplateGroup\n\n Return the group of parm templates corresponding to this node type's\n parameter interface.\n\n See hou.ParmTemplateGroup for more information on parm template\n groups. To change the parameter interface for a node type defined by\n a digital asset, see hou.HDADefinition.setParmTemplateGroup.\n\n\n \"\"\"\n def hasPermanentUserDefaults(self) -> bool:\n \"\"\"\n\n hasPermanentUserDefaults(self) -> bool\n\n Returns whether a user has set permanent defaults for this node\n type.\n\n See also hou.Parm.hasTemporaryDefaults\n\n\n \"\"\"\n def isReadable(self) -> bool:\n \"\"\"\n\n isReadable(self) -> bool\n\n Return True if this node type is readable and False otherwise. A\n readable node type is one that you can create node instances from.\n\n\n \"\"\"\n def isWritable(self) -> bool:\n \"\"\"\n\n areContentsViewable(self) -> bool\n\n Return True if the node network contained in the node type is\n viewable and False otherwise.\n\n\n \"\"\"\n def areContentsViewable(self) -> bool: ...\n def containedNodeTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n containedNodeTypes(self) -> tuple of str\n\n Return a tuple of all NodeType names of the contents of an HDA.\n\n\n \"\"\"\n def childTypeCategory(self) -> Optional[NodeTypeCategory]: ...\n def helpUrl(self) -> str:\n \"\"\"\n\n helpUrl(self) -> str\n\n Return the URL where the node type stores the documentation, e.g., a\n file name or an HDA section path. May return an empty string if node\n type does not know where the documentation is.\n\n\n \"\"\"\n def defaultHelpUrl(self) -> str:\n \"\"\"\n\n defaultHelpUrl(self) -> str\n\n Return a generic URL that the help system will try to resolve to the\n actual location that stores the node type documentation. The generic\n URL is in the form operator:table/optypename and may include\n additional information such as a namespace or a version.\n\n\n \"\"\"\n def embeddedHelp(self) -> str:\n \"\"\"\n\n embeddedHelp(self) -> str\n\n Return the help text embedded in this node type. Return an empty\n string if no embedded help exists.\n\n The embedded help is searched for in two different places in the\n following order:\n\n * If an HDK node, the text given by its OP_Operator::getHDKHelp()\n override\n\n * If an HDA node, the corresponding result of\n hou.HDADefinition.embeddedHelp()\n\n\n \"\"\"\n def defaultShape(self) -> str:\n \"\"\"\n\n defaultShape(self) -> str\n\n Return the name of the shape used to display a node of this type in\n the network view if no shape is explicitly assigned to the node.\n\n\n \"\"\"\n def setDefaultShape(self, shape: str) -> None:\n \"\"\"\n\n setDefaultShape(self, shape)\n\n Set the name of the shape used to display a node of this type in the\n network view if no shape is explicitly assigned to the node. Pass\n None as the shape parameter to remove the type-specific default.\n\n\n \"\"\"\n def defaultColor(self) -> Color:\n \"\"\"\n\n defaultColor(self) -> hou.Color\n\n Return the color used to display a node of this type in the network\n view if the node's hou.nodeFlag.ColorDefault flag is set.\n\n\n \"\"\"\n def setDefaultColor(self, color: Color) -> None:\n \"\"\"\n\n setDefaultColor(self, color)\n\n Set the color used to display a node of this type in the network\n view if the node's hou.nodeFlag.ColorDefault flag is set. Pass None\n as the color parameter to remove the type-specific default.\n\n\n \"\"\"\n\nclass ApexNodeType(NodeType):\n \"\"\"\n\n hou.ApexNodeType\n\n Information common to all instances of a type of APEX node.\n\n This class specializes the generic hou.NodeType class for APEX node\n types.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def hidden(self) -> bool:\n \"\"\"\n\n hidden(self) -> bool\n\n Return whether or not this node type appears in the tab menu.\n\n\n \"\"\"\n def deprecated(self) -> bool:\n \"\"\"\n\n deprecated(self) -> bool\n\n Return whether or not this node type has been marked deprecated.\n\n\n \"\"\"\n def definition(self) -> Optional[HDADefinition]:\n \"\"\"\n\n definition(self) -> hou.HDADefinition\n\n This method is only provided for duck typing with hou.OpNodeType. It\n always returns None.\n\n\n \"\"\"\n\nclass OpNodeType(NodeType):\n \"\"\"\n\n hou.OpNodeType\n\n Information common to all instances of a type of OP node.\n\n This class specializes the generic hou.NodeType class for Houdini OP\n node types. This subclass adds information about digital assets,\n instances, and registration information that is specific to Houdini's OP\n node types.\n\n A digital asset can define a node type. In this case the nodes contained\n inside the asset's definition implement the node type's algorithm, and\n you can customize the parameters in the node type using the Type\n Properties dialog,\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def sectionData(self, name: str) -> str:\n \"\"\"\n\n sectionData(self, section_name) -> str\n\n Return the data stored in the specified section of the HDA\n definition corresponding to this node type. If the HDA definition\n doesn't contain the specified section or this node type doesn't\n correspond to a digital asset, return an empty string.\n\n\n \"\"\"\n def binarySectionData(self, name: str) -> bytes:\n \"\"\"\n\n binarySectionData(self, section_name) -> bytes\n\n Only available in Python 3.\n\n Return a bytes object containing the data stored in the specified\n section of the HDA definition corresponding to this node type. Ideal\n for sections containing binary data. If the HDA definition doesn't\n contain the specified section or this node type doesn't correspond\n to a digital asset, return an empty bytes object.\n\n\n \"\"\"\n def hasSectionData(self, name: str) -> bool:\n \"\"\"\n\n hasSectionData(self, section_name) -> bool\n\n Return True if this node type corresponds to a digital asset whose\n definition contains the section. Otherwise, return False.\n\n\n \"\"\"\n def source(self) -> EnumValue:\n '''\n\n source(self) -> hou.nodeTypeSource enum value\n\n Return a hou.nodeTypeSource enumerated value to indicate if this\n node type is implemented in VEX, RSL, or the HDK (in C++), or if it\n is a built-in node type that ships with Houdini.\n\n > >>> obj_cat = hou.objNodeTypeCategory()\n > >>> sop_cat = hou.sopNodeTypeCategory()\n > >>> hou.nodeType(obj_cat, \\\\\"biped_auto_rig\\\\\").source()\n > nodeTypeSource.Subnet\n > >>> hou.nodeType(sop_cat, \\\\\"mountain\\\\\").source()\n > nodeTypeSource.VexCode\n\n '''\n def sourcePath(self) -> str:\n '''\n\n sourcePath(self) -> str\n\n Return the path to the source for this node type, or \\\\\"Internal\\\\\" if\n it is a built-in node type. If the node was created using the HDK,\n return the path to the shared object/dll for the node type.\n\n > >>> obj_cat = hou.objNodeTypeCategory()\n > >>> hou.nodeType(obj_cat, \\\\\"biped_auto_rig\\\\\").sourcePath()\n > \\'oplib:/Object/biped_auto_rig?Object/biped_auto_rig\\'\n > >>> hou.nodeType(obj_cat, \\\\\"geo\\\\\").sourcePath()\n > \\'Internal\\'\n\n '''\n def sourceNetwork(self) -> Optional[Node]:\n \"\"\"\n\n sourceNetwork(self) -> hou.Node or None\n\n If this node type is a digital asset, return the Node instance whose\n contents define the digital asset. Otherwise, return None.\n\n\n \"\"\"\n def definition(self) -> Optional[HDADefinition]:\n \"\"\"\n\n definition(self) -> hou.HDADefinition\n\n If this node type corresponds to a digital asset, return the\n hou.HDADefinition. Otherwise, return None.\n\n\n \"\"\"\n def allInstalledDefinitions(self) -> Tuple[HDADefinition, ...]:\n \"\"\"\n\n allInstalledDefinitions(self) -> tuple of hou.HDADefinition\n\n Search all installed operator type libraries and return a tuple of\n available hou.HDADefinition objects providing definitions for this\n node type.\n\n Houdini allows multiple otl files to be loaded at the same time that\n each contain definitions for the same node type. The definition in\n use is called the current definition. See also\n hou.HDADefinition.isCurrent.\n\n\n \"\"\"\n def uninstallFromPath(self, path: str) -> None: ...\n def hdaModule(self) -> Optional[HDAModule]:\n \"\"\"\n\n hdaModule(self) -> hou.HDAModule\n\n Return the HDAModule object for this node type. If the type is not\n for a digital asset, the module is empty. Otherwise, the module\n contains the functions, constants, classes, etc. in the user-defined\n PythonModule section of the digital asset.\n\n You can use hou.Node.hdaModule as a shortcut to access the HDAModule\n from a node instance.\n\n See hou.HDAModule for more information.\n\n\n \"\"\"\n def hdaViewerStateModule(self) -> Optional[HDAViewerStateModule]:\n \"\"\"\n\n hdaViewerStateModule(self) -> hou.HDAViewerStateModule\n\n This method creates an instance of hou.HDAViewerStateModule for this\n node type. Returns an empty object if the type is not for a digital\n asset.\n\n See also hou.Node.hdaViewerStateModule.\n\n\n \"\"\"\n def hdaViewerHandleModule(self) -> Optional[HDAViewerHandleModule]:\n \"\"\"\n\n hdaViewerHandleModule(self) -> hou.HDAViewerHandleModule\n\n This method creates an instance of hou.HDAViewerHandleModule for\n this node type. Returns an empty object if the type is not for a\n digital asset.\n\n See also hou.Node.hdaViewerHandleModule.\n\n\n \"\"\"\n def aliases(self) -> Tuple[str, ...]:\n \"\"\"\n\n aliases(self) -> tuple of str\n\n Return all current aliases for this node type. See\n hou.NodeType.addAlias for an example.\n\n\n \"\"\"\n def addAlias(self, alias: str) -> None:\n '''\n\n addAlias(self, alias)\n\n Add an alias for this node type. You can use this alias when\n creating new nodes.\n\n > >>> geo_type = hou.nodeType(hou.objNodeTypeCategory(), \\\\\"geo\\\\\")\n > >>> geo_type.addAlias(\\\\\"transformable\\\\\")\n > >>> geo_type.aliases()\n > (\\'transformable\\',)\n > >>> hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"transformable\\\\\")\n > \n\n '''\n def removeAlias(self, alias: str) -> None:\n \"\"\"\n\n removeAlias(self, alias)\n\n Remove an alias for this node type.\n\n\n \"\"\"\n def hidden(self) -> bool:\n \"\"\"\n\n hidden(self) -> bool\n\n Return whether or not this node type appears in the tab menu. See\n also hou.NodeType.setHidden.\n\n\n \"\"\"\n def setHidden(self, hidden: bool) -> None:\n \"\"\"\n\n setHidden(self, hidden)\n\n Set whether or not this node type appears in the tab menu. See also\n hou.NodeType.hidden.\n\n\n \"\"\"\n def deprecated(self) -> bool:\n \"\"\"\n\n deprecated(self) -> bool\n\n Return whether or not this node type has been marked deprecated. See\n also hou.NodeType.deprecationInfo.\n\n\n \"\"\"\n def deprecationInfo(self) -> dict[str, str|Self]:\n \"\"\"\n\n deprecationInfo(self) -> dict of str to str or hou.NodeType\n\n If the node type has been marked deprecated, this call will return\n the deprecation information as a dictionary.\n\n The currently supported keys are:\n\n\n 'version'\n The version of Houdini where this operator got deprecated. The\n form is either major.minor, or major.minor.build (e.g. 14.0 or\n 14.5.122). This item is always present.\n\n 'new_type'\n The new node type this node was replaced with. This can be used\n to create a system of automatic node replacement.\n\n 'reason'\n This lists the reason given for the deprecation, in case there\n is no new node to replace with.\n\n\n \"\"\"\n def instances(self) -> Tuple[OpNode, ...]:\n \"\"\"\n\n instances(self) -> tuple of hou.Node\n\n Return a tuple of all the nodes of this type in the current scene.\n\n\n \"\"\"\n def defaultState(self) -> str:\n \"\"\"\n\n defaultState(self) -> str\n\n Return a string with the name of the default viewer state for\n controlling nodes of this type. Returns an empty string if the node\n type doesn't have an associated viewer state registered.\n\n\n \"\"\"\n def boundHandles(self) -> dict[str, str]:\n \"\"\"\n\n boundHandles(self) -> dict of str to str\n\n Return a dictionary of unique handle binding descriptions to the\n type of bound handle. Along with the handleBindings method, this\n provides the same information as the ombindinfo hscript function.\n\n\n \"\"\"\n def handleBindings(self, bound_handle: str) -> dict[str, str]:\n \"\"\"\n\n handleBindings(self, bound_handle) -> dict of str to str\n\n Given a bound handle description (returned as a key in the dict\n returned by boundHandles), return a dictionary of handle parameters\n to the node parameter bound to that handle parameter. Along with the\n boundHandles method, this provides the same information as the\n ombindinfo hscript function.\n\n\n \"\"\"\n def generatorFlag(self) -> bool: ...\n def managerFlag(self) -> bool: ...\n def unorderedInputsFlag(self) -> bool: ...\n\n # Missing methods added by stubgen\n def category(self) -> OpNodeTypeCategory: ...\n\nclass NodeTypeCategory:\n \"\"\"\n\n hou.NodeTypeCategory\n\n Represents a category of node types, such as surface nodes (SOPs) or\n dynamics nodes (DOPs).\n\n Use hou.nodeTypeCategories to get a dict of node type category names to\n NodeTypeCategory objects. You can use hou.objNodeTypeCategory,\n hou.sopNodeTypeCategory, etc. to directly access a particular node type\n category.\n\n See also hou.NodeType and hou.Node.\n\n > # Get the names of all the node type categories.\n > >>> hou.nodeTypeCategories().keys()\n > ['Shop', 'Cop2', 'CopNet', 'ChopNet', 'Object', 'Driver',\n > 'Chop', 'Sop', 'Manager', 'Vop', 'Director', 'Dop', 'VopNet']\n\n RELATED\n\n * hou.nodeTypeCategories\n\n * hou.objNodeTypeCategory\n\n * hou.sopNodeTypeCategory\n\n * hou.dopNodeTypeCategory\n\n * hou.copNodeTypeCategory\n\n * hou.cop2NodeTypeCategory\n\n * hou.shopNodeTypeCategory_\n\n * hou.vopNodeTypeCategory\n\n * hou.ropNodeTypeCategory\n\n * hou.chopNodeTypeCategory\n\n * hou.cop2NetNodeTypeCategory\n\n * hou.vopNetNodeTypeCategory\n\n * hou.chopNetNodeTypeCategory\n\n * hou.managerNodeTypeCategory\n\n * hou.rootNodeTypeCategory\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of this node type category.\n\n\n \"\"\"\n def typeName(self) -> str: ...\n def label(self) -> str:\n \"\"\"\n\n label(self) -> str\n\n Returns the descriptive of this node type category that appears in\n network editor panes.\n\n\n \"\"\"\n def nodeTypes(self) -> dict[str, NodeType]:\n \"\"\"\n\n nodeTypes(self) -> dict of str to hou.NodeType\n\n Return a dict mapping node type names to node types in this\n category.\n\n For example, if this node type category is SOPs, the keys in the\n dictionary would be box, sphere, polyextrude, subdivide, etc.\n\n Note that the node types in this category may not all be instances\n of the same class. For example, most node types in the SOP node type\n category are instances of hou.SopNodeType, but some, like SHOP\n networks, CHOP networks, etc. are not.\n\n > # Access the box SOP's node type.\n > hou.sopNodeTypeCategory().nodeTypes()['box']\n > def findNodeTypes(node_type_category, pattern):\n > '''Return a list of node types in a particular node type category\n > whose names match a pattern.'''\n > import fnmatch\n > \n > return [node_type\n > for node_type_name, node_type in node_type_category.nodeTypes().items()\n > if fnmatch.fnmatch(node_type_name, pattern)]\n\n See also hou.nodeType_.\n\n\n \"\"\"\n def nodeType(self, type_name: str) -> Optional[NodeType]:\n \"\"\"\n\n nodeType(self, type_name) -> hou.NodeType or None\n\n Returns a single node type that matched the provided type name.\n Returns None if the type name doesn't match a node type in this\n category.\n\n\n \"\"\"\n def hasSubNetworkType(self) -> bool:\n \"\"\"\n\n hasSubNetworkType(self) -> bool\n\n Return True if the category has a primary sub-network node type and\n False otherwise. For example, this method returns True for the Sop\n node type category that has the subnet node type as its primary sub-\n network node type. The method returns False for the VopNet node type\n category that does not have a primary sub-network node type but has\n multiple sub-network node types such as displace, surface and fog.\n\n\n \"\"\"\n def subNetworkType(self) -> Optional[NodeType]:\n \"\"\"\n\n subNetworkType(self) -> hou.NodeType or None\n\n Return the category's primary sub-network node type or None if the\n category has no primary sub-network node type.\n\n\n \"\"\"\n def defaultShape(self) -> str: ...\n def clearDefaultShapes(self) -> None: ...\n def setDefaultShape(self, shape: str) -> None: ...\n def defaultColor(self) -> Color: ...\n def clearDefaultColors(self) -> None: ...\n def setDefaultColor(self, color: Color) -> None: ...\n def defaultWireStyle(self) -> str: ...\n def setDefaultWireStyle(self, wirestyle: str) -> None: ...\n\nclass ApexNodeTypeCategory(NodeTypeCategory):\n \"\"\"\n\n hou.ApexNodeTypeCategory\n\n Represents the node type category for APEX node types.\n\n This class specializes the generic hou.NodeTypeCategory class for APEX\n node types. There is only one APEX node type category, which is\n accessible by calling hou.apexNodeTypeCategory. Note that this node type\n category does not appear in the list returned by hou.nodeTypeCategories,\n as that method only returns OP node type categories.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n\nclass OpNodeTypeCategory(NodeTypeCategory):\n \"\"\"\n\n hou.OpNodeTypeCategory\n\n Represents a category of OP node types, such as surface nodes (SOPs) or\n dynamics nodes (DOPs).\n\n Use hou.nodeTypeCategories to get a dict of node type category names to\n NodeTypeCategory objects. You can use hou.objNodeTypeCategory,\n hou.sopNodeTypeCategory, etc. to directly access a particular node type\n category.\n\n See also hou.OpNodeType and hou.OpNode.\n\n RELATED\n\n * hou.nodeTypeCategories\n\n * hou.objNodeTypeCategory\n\n * hou.sopNodeTypeCategory\n\n * hou.dopNodeTypeCategory\n\n * hou.copNodeTypeCategory\n\n * hou.cop2NodeTypeCategory\n\n * hou.shopNodeTypeCategory_\n\n * hou.vopNodeTypeCategory\n\n * hou.ropNodeTypeCategory\n\n * hou.chopNodeTypeCategory\n\n * hou.cop2NetNodeTypeCategory\n\n * hou.vopNetNodeTypeCategory\n\n * hou.chopNetNodeTypeCategory\n\n * hou.managerNodeTypeCategory\n\n * hou.rootNodeTypeCategory\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def createDigitalAsset(self, name: Optional[str] = None, hda_file_name: Optional[str] = None, description: Optional[str] = None) -> NodeType:\n \"\"\"\n\n createDigitalAsset(self, name=None, hda_file_name=None,\n description=None) -> NodeType\n\n Create a digital asset in this category. Use\n hou.Node.createDigitalAsset instead as the representative node will\n setup the metadata properly.\n\n\n name\n The name of the node type that the new digital asset will\n define. If None, nothing is done.\n\n hda_file_name\n The name of the hda file where Houdini will save the digital\n asset. If None Houdini will use\n $HOME/houdiniX.Y/hda/OPcustom.hda.\n\n description\n The name that will appear in the tab menu. If None, Houdini will\n use the name for the description.\n\n\n \"\"\"\n def nodeVerbs(self) -> dict[str, OpVerb]:\n \"\"\"\n\n nodeVerbs(self) -> dict of str to hou.SopVerb\n\n Return a dict mapping verb names to node verbs in this category.\n\n Most verbs are named after their corresponding node type.\n Alternatively, given a hou.SopNode, one can use hou.SopNode.verb to\n extract the verb.\n\n\n \"\"\"\n def nodeVerb(self, verb_name: str) -> Optional[OpVerb]:\n \"\"\"\n\n nodeVerb(self, name) -> hou.SopVerb or None\n\n Return a specific verb from the provided verb name. Returns None if\n no matching verb is found.\n\n\n \"\"\"\n def viewerStates(self, viewer_type: EnumValue) -> Tuple[ViewerState, ...]:\n \"\"\"\n\n viewerStates(self, viewer_type) -> tuple of hou.ViewerState\n\n\n \"\"\"\n def loadDSO(self, dso_path: str) -> None:\n \"\"\"\n\n loadDSO(self, dso_path)\n\n Loads the HDK custom operator identified by the given file path for\n this node type category. It will use the HOUDINI_DSO_PATH\n environment variable to find it if necessary.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def nodeTypes(self) -> dict[str, OpNodeType]: ... # type: ignore[override]\n def nodeType(self, type_name: str) -> Optional[OpNodeType]: ...\n\nclass ParmTemplate:\n '''\n\n hou.ParmTemplate\n\n Describes a parameter tuple (its name, type, etc.). This is base class\n for all parameter templates.\n\n ParmTemplates are most often used when describing a parameter in a\n digital asset definition\\'s parameter interface or when describing an\n individual node\\'s parameter layout (including its spare parameters). A\n ParmTemplate describes a parameter and the type of data it holds, but it\n does not store the current value of a parameter; only hou.Parm objects\n inside hou.ParmTuple objects actually store parameter values. You can\n think of a hou.ParmTuple as an instance of a ParmTemplate. For example,\n the \\\\\"t\\\\\" parm tuple on geometry objects can be described by a\n hou.FloatParmTemplate -- it has a label of \\\\\"Transform\\\\\", a data type of\n hou.parmData.Float, 3 components, a naming scheme of\n hou.parmNamingScheme.XYZW, etc. Each geometry object node has a\n hou.ParmTuple named \\\\\"t\\\\\" that uses this ParmTemplate.\n\n Note that ParmTemplate objects are just data containers, and they have\n no live relationship with objects in Houdini. For example, a hou.OpNode\n object corresponds directly to a node in Houdini, and if the node is\n renamed in Houdini hou.Node.name will return the new name.\n ParmTemplates, on the other hand, do not have a live relationship.\n Creating a ParmTemplate based on a spare parameter or asset definition\n parameter will simply copy the information into the ParmTemplate object,\n and modifying the object will not affect the spare parameter/asset\n parameter.\n\n Note also that ParmTemplate objects are always instances of a subclass\n of this class, so you cannot construct an instance of this class\n directly.\n\n To manipulate the parameters of a digital asset, you can retrieve the\n asset\\'s current set of ParmTemplates into a hou.ParmTemplateGroup using\n hou.HDADefinition.parmTemplateGroup. You can then modify the group,\n adding parameters to it and replacing parameters in it, and save the\n group back to the asset definition with\n hou.HDADefinition.setParmTemplateGroup. Similarly, you can change a\n node\\'s parameter layout with hou.OpNode.parmTemplateGroup and\n hou.OpNode.setParmTemplateGroup.\n\n You can also ask a hou.ParmTuple for its ParmTemplate in order to find\n out information about the parameter, such as allowed ranges of values,\n the label displayed to the user in the parameter pane, the parameter\\'s\n popup help, etc.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def clone(self) -> ParmTemplate:\n \"\"\"\n\n clone(self) -> hou.ParmTemplate\n\n Return a copy of this parm template.\n\n This method can be called on an instance of a ParmTemplate subclass\n and an instance of the subclass is properly returned.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> string\n\n Return the internal name of the parm template. This is the name that\n hou.ParmTuple objects created from this parm template will have.\n\n Tha names of hou.ParmTemplate objects inside a multiparm block will\n have a # at the end of their name which will be replaced by the\n multiparm instance number when an the hou.ParmTuple object is\n instantiated.\n\n Note that the names of hou.Parm objects inside ParmTuples based off\n this ParmTemplate are determined by this name, the number of\n components in this parm template, and the naming scheme. See the\n namingScheme method for more information.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Change the internal name of this parm template. Remember that\n ParmTemplates just store data, so the name change will not have any\n effect unless this parm template is later used to modify a parameter\n layout in Houdini.\n\n Parameters inside a multiparm block must have a # at the end of\n their name which will be replaced by the multiparm's instance\n number.\n\n\n \"\"\"\n def label(self) -> str:\n \"\"\"\n\n label(self) -> string\n\n Return the name of the parameter tuple that is displayed in the\n parameter pane.\n\n\n \"\"\"\n def setLabel(self, label: str) -> None:\n \"\"\"\n\n setLabel(self, label)\n\n Change the name of the label that is displayed in the parameter\n pane.\n\n\n \"\"\"\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.parmTemplateType enum value\n\n Return the enumerated value identifying the type of this parameter.\n\n Remember that ParmTemplate objects are always instances of a\n subclass of this class. The following table shows the mapping\n between hou.parmTemplateType enumeration values and ParmTemplate\n subclasses:\n\n\n Enumerated Value\n ParmTemplate Subclass\n\n hou.parmTemplateType.Int\n hou.IntParmTemplate\n\n hou.parmTemplateType.Float\n hou.FloatParmTemplate\n\n hou.parmTemplateType.String\n hou.StringParmTemplate\n\n hou.parmTemplateType.Toggle\n hou.ToggleParmTemplate\n\n hou.parmTemplateType.Menu\n hou.MenuParmTemplate\n\n hou.parmTemplateType.Button\n hou.ButtonParmTemplate\n\n hou.parmTemplateType.FolderSet\n hou.FolderSetParmTemplate\n\n hou.parmTemplateType.Folder\n hou.FolderParmTemplate\n\n hou.parmTemplateType.Separator\n hou.SeparatorParmTemplate\n\n hou.parmTemplateType.Label\n hou.LabelParmTemplate\n\n hou.parmTemplateType.Ramp\n hou.RampParmTemplate\n\n\n \"\"\"\n def dataType(self) -> EnumValue:\n \"\"\"\n\n dataType(self) -> hou.parmData enum value\n\n Return the data type stored in hou.Parm instances inside\n hou.ParmTuple instances corresponding to this ParmTemplate.\n\n For example, suppose this parm tuple is a hou.FloatParmTemplate with\n 3 components. The corresponding hou.ParmTuple will have 3 hou.Parm\n objects inside it, and each will store a floating point value. In\n this example, this method would return hou.parmData.Float.\n\n\n \"\"\"\n def look(self) -> EnumValue:\n \"\"\"\n\n look(self) -> hou.parmLook enum value\n\n Return the look of this parameter in the parameter pane. For\n example, a tuple of 3 floats can be displayed as a 3D vector or as\n an RGB color.\n\n See hou.parmLook for more information.\n\n\n \"\"\"\n def setLook(self, look: EnumValue) -> None:\n \"\"\"\n\n setLook(self, look)\n\n Set the look of this parameter to a hou.parmLook enum value.\n\n See the look method for more information.\n\n\n \"\"\"\n def namingScheme(self) -> EnumValue:\n '''\n\n namingScheme(self) -> hou.parmNamingScheme enum value\n\n Return the naming scheme used to name parameters inside the parm\n tuple for this ParmTemplate.\n\n For example, if the naming scheme is hou.parmNamingScheme.XYZW and\n the parm template is named \\\\\"foo\\\\\" and has 3 components, the\n parameters will be named \\\\\"foox\\\\\", \\\\\"fooy\\\\\", and \\\\\"fooz\\\\\". On the other\n hand, if the naming scheme was hou.parmNamingScheme.Base1, the\n parameters would be named \\\\\"foo1\\\\\", \\\\\"foo2\\\\\", and \\\\\"foo3\\\\\".\n\n Note that when the parm template only has 1 component, the parm name\n is the same as the parm tuple name.\n\n See hou.parmNamingScheme for more information.\n\n\n '''\n def setNamingScheme(self, naming_scheme: EnumValue) -> None:\n \"\"\"\n\n setNamingScheme(self, naming_scheme)\n\n Set the naming scheme used to name parameters inside the parm tuple\n for this ParmTemplate to a hou.parmNamingScheme enum value.\n\n See the namingScheme method for more information.\n\n\n \"\"\"\n def numComponents(self) -> int:\n \"\"\"\n\n numComponents(self) -> int\n\n Return the number of values stored inside hou.ParmTuple instances of\n this ParmTemplate.\n\n For example, if this parm template has 3 components, there will be 3\n parameter fields displayed in the parameter pane and there will be 3\n hou.Parm objects inside a hou.ParmTuple based off this parm\n template.\n\n\n \"\"\"\n def setNumComponents(self, num_components: int) -> None:\n \"\"\"\n\n setNumComponents(self, num_components) -> int\n\n Set the number of values stored inside hou.ParmTuple instances of\n this ParmTemplate.\n\n Note that some ParmTemplate subclasses only support one component,\n so calling this method with a value other than 1 may raise a\n hou.OperationFailed exception. Also, changing the number of\n components may automatically change the size of the tuple of default\n values for some ParmTemplate subclasses.\n\n\n \"\"\"\n def disableWhen(self) -> str:\n \"\"\"\n\n disableWhen(self) -> str\n\n This method is deprecated in favor of the conditionals method.\n\n\n \"\"\"\n def setDisableWhen(self, disable_when: str) -> None:\n \"\"\"\n\n setDisableWhen(self, disable_when)\n\n This method is deprecated in favor of the setConditional method.\n\n\n \"\"\"\n def conditionals(self) -> dict[EnumValue, str]:\n \"\"\"\n\n conditionals(self) -> dict of hou.parmCondType enum value to str\n\n Returns the set of conditionals currently affecting this parameter.\n\n See the Conditionals section of the Operator Type Properties window\n help for more information on this string.\n\n\n \"\"\"\n def setConditional(self, cond_type: EnumValue, conditional: str) -> None:\n \"\"\"\n\n setConditional(self, type, conditional)\n\n Set a conditional string of the given hou.parmCondType type for this\n parameter. This string consists of rules on how this parameter's\n display behaves when other parameters change.\n\n See the Conditionals section of the Operator Type Properties window\n help for more information on this string.\n\n\n \"\"\"\n def isHidden(self) -> bool:\n \"\"\"\n\n isHidden(self) -> bool\n\n Return whether this parameter is hidden in the parameter pane.\n\n\n \"\"\"\n def hide(self, on: bool) -> None:\n \"\"\"\n\n hide(self, on)\n\n Marks this parameter as visible or invisible in the parameter pane.\n\n Note that hidden parameters still exist, and can be evaluated,\n channel-referenced, etc. They simply will not be displayed in the\n parameter pane.\n\n\n \"\"\"\n def isLabelHidden(self) -> bool:\n \"\"\"\n\n isLabelHidden(self) -> bool\n\n Return whether the label for this parameter is hidden in the\n parameter pane.\n\n\n \"\"\"\n def hideLabel(self, on: bool) -> None:\n \"\"\"\n\n hideLabel(self, on)\n\n Hide or show the label for this parameter in the parameter pane.\n\n\n \"\"\"\n def joinsWithNext(self) -> bool:\n \"\"\"\n\n joinsWithNext(self) -> bool\n\n Return whether this parameter is displayed on the same line as the\n next parameter in the parameter pane.\n\n\n \"\"\"\n def setJoinWithNext(self, on: bool) -> None:\n \"\"\"\n\n setJoinWithNext(self, on)\n\n Sets whether this parameter is displayed on the same line as the\n next parameter in the parameter pane.\n\n\n \"\"\"\n def joinWithNext(self) -> bool:\n \"\"\"\n\n joinWithNext(self) -> bool\n\n This method is deprecated in favor of the joinsWithNext method.\n\n\n \"\"\"\n def help(self) -> str:\n \"\"\"\n\n help(self) -> str\n\n Return the help that Houdini displays when you hover over the\n parameter label in the parameter pane.\n\n\n \"\"\"\n def setHelp(self, help: str) -> None:\n \"\"\"\n\n setHelp(self, help)\n\n Set the help that Houdini displays when you hover over the parameter\n label in the parameter pane.\n\n\n \"\"\"\n def scriptCallback(self) -> str:\n \"\"\"\n\n scriptCallback(self) -> str\n\n Return the contents of the script that Houdini runs when this\n parameter changes. This script is most commonly used in\n hou.ButtonParmTemplate objects to respond to the button being\n pressed.\n\n Note that Houdini uses the tags dictionary to store the script\n callback information.\n\n\n \"\"\"\n def setScriptCallback(self, script_callback: str) -> None:\n \"\"\"\n\n setScriptCallback(self, script_callback)\n\n Set the callback script to the given string. This script runs in\n response to a parameter change.\n\n See the scriptCallback method for more information.\n\n\n \"\"\"\n def scriptCallbackLanguage(self) -> EnumValue:\n \"\"\"\n\n scriptCallbackLanguage(self) -> hou.scriptLanguage enum value\n\n Return the language of the script that Houdini runs when this\n parameter changes.\n\n Note that Houdini uses the tags dictionary to store the script\n callback information.\n\n See also the scriptCallback method.\n\n\n \"\"\"\n def setScriptCallbackLanguage(self, script_callback_language: EnumValue) -> None:\n \"\"\"\n\n setScriptCallbackLanguage(self, script_callback_language)\n\n Set the script callback language to a hou.scriptLanguage enum value.\n\n See the scriptCallbackLanguage method for more information.\n\n\n \"\"\"\n def tags(self) -> dict[str, str]:\n \"\"\"\n\n tags(self) -> dict of string to string\n\n Return a dictionary of extra data stored in the parm template.\n\n Houdini uses this dictionary to attach arbitrary data to parm\n templates. The keys in this dictionary vary depending on the\n ParmTemplate type and its use.\n\n\n \"\"\"\n def setTags(self, tags: Mapping[str, str]) -> None:\n \"\"\"\n\n setTags(self, tags)\n\n Set the dictionary of extra data stored in this parm template.\n\n See the tags method for more information.\n\n\n \"\"\"\n def asCode(self, function_name: Optional[str] = None, variable_name: Optional[str] = None) -> str:\n '''\n\n asCode(self, function_name=None, variable_name=None) -> str\n\n Return a string containing Python statements that can be executed to\n recreate the parameter template. To run the string, use Python\\'s\n compile, or execfile functions or the exec statement.\n\n\n function_name\n If is specified, then the code returned creates\n a Python function with the given name. must be a\n non-zero length string consisting of only alphanumeric and\n underscore characters. Any invalid characters are internally\n converted to underscores.\n\n The function returns a reference to the newly created parameter\n template object.\n\n variable_name\n The name of a Python variable that the result code will assign\n to. If None, Houdini uses the variable name \\\\\"hou_parm_template\\\\\".\n\n Here is an example of saving the output to a file and then loading\n it back into Houdini:\n\n > # Get a reference to the target parameter template.\n > node = hou.node(\\\\\"/obj/geo1\\\\\")\n > parm_template = node.parm(\\\\\"tx\\\\\").parmTemplate()\n > \n > # Execute asCode and write the output script to a file.\n > code = parm_template.asCode()\n > source_file = open(\\\\\"create_parm_template.py\\\\\", \\\\\"w\\\\\")\n > source_file.write(code)\n > source_file.close()\n > \n > # Execute the script. The new parameter template will be stored \n > # in the \\'hou_parm_template\\' variable.\n > execfile(\\\\\"create_parm_template.py\\\\\")\n > \n > # Add a spare parameter to the node using the saved parameter\n > # template.\n > node.addSpareParmTuple(hou_parm_template)\n\n Here is an example of saving the output into a function in a file\n and then calling it from Houdini:\n\n > # Get a reference to the target parameter template.\n > node = hou.node(\\\\\"/obj/geo1\\\\\")\n > parm_template = node.parm(\\\\\"tx\\\\\").parmTemplate()\n > \n > # Execute asCode and write the function definition to a file.\n > code = parm_template.asCode(function_name=\\\\\"createParmTemplate\\\\\")\n > source_file = open(\\\\\"parmtemplatelib.py\\\\\", \\\\\"w\\\\\")\n > source_file.write(code)\n > source_file.close()\n > \n > # Call the function definition.\n > import parmtemplatelib\n > hou_parm_template = parmtemplatelib.createParmTemplate()\n > \n > # Add a spare parameter to the node using the saved parameter\n > # template.\n > node.addSpareParmTuple(hou_parm_template)\n\n '''\n\nclass ParmTemplateGroup:\n \"\"\"\n\n hou.ParmTemplateGroup\n\n A group of parameter templates used to represent the parameter layout of\n a node or the parameters in a digital asset definition.\n\n This class stores a group of hou.ParmTemplate objects. You can create an\n empty group, create a group from a sequence of parm templates, or create\n a group from the parameter definitions of a digital asset or from a\n particular node's current parameter layout. Similarly, you can set an\n asset's parameters or a node's parameter interface to the contents of a\n parameter group.\n\n You can get an asset's parm templates with\n hou.HDADefinition.parmTemplateGroup and set them with\n hou.HDADefinition.setParmTemplateGroup. Similarly, you can get an\n individual node's parameter definition with hou.OpNode.parmTemplateGroup\n and set it with hou.OpNode.setParmTemplateGroup. When setting a node's\n parameter interface, any parms that are not in the node's type's set of\n parms will be added as spare parameters. Similarly, if parameters in the\n node's type are not present in the group, they will be automatically\n added at the end and made invisible. Also, if they exist but the types,\n labels, looks, naming schemes, etc are different, Houdini will discard\n all changes you attempt to make to these reserved parameters except for\n visibility settings.\n\n It is important to understand the difference between folder parm\n templates and folder set parm templates when using ParmTemplateGroups.\n Folder sets correspond directly to hou.ParmTuple objects -- there is one\n parm tuple (that contains one parm) for each set of folders, and\n changing the value of that parm changes which folder is displayed.\n Individual Folders, on the other hand, do not directly correspond to\n hou.ParmTuple objects, but they are used in Houdini's \n dialog and they make it easy to add individual folders and control which\n parameters are inside a folder. Unlike a hou.FolderSetParmTemplate, a\n hou.FolderParmTemplate stores the set of parm templates inside that\n folder. When a node or definition's parameters are set to the contents\n of a parm template group, the folder sets are determined and the parm\n tuple name for the set is the name of the first folder in that set. The\n names of the other folders in the set are not used.\n\n ParmTemplateGroups use folder parm templates instead of folder set parm\n templates. Attempting to add a FolderSetParmTemplate to a group will\n raise hou.OperationFailed. Asking a parm tuple for its parm template, on\n the other hand, may return a folder set but will never return a folder.\n Previously, folder parameter templates and parm template groups did not\n exist, so the only way to add folders were with special methods like\n hou.HDADefinition.addParmFolder and hou.OpNode.addSpareParmFolder. Now\n that that they exist, you may create folders by passing folder parm\n templates to hou.HDADefinition.addParmTuple and\n hou.OpNode.addSpareParmTuple. However, using parm template groups is\n preferred over calling these methods.\n\n Note that folder parm templates are also used to represent multiparm\n blocks, much like the dialog does. The folder parm\n template's hou.folderType determines whether it is a folder or a\n multiparm block. Unlike folder parm templates, which do not correspond\n directly to parameter instances, a multiparm parm template does\n correspond to an integer parameter that controls the number of instances\n of the multiparm.\n\n\n NOTE\n ParmTemplateGroups store their own copy of the parm templates.\n Asking for the parm templates in a group will return a copy of the\n parm templates; modifying those copies will not change the contents\n of the group. For example, to change a parameter in a group you\n cannot simply call find and modify the hou.ParmTemplate it returned.\n Instead, you must call replace after making modifications to the\n parameter.\n\n Parm template copies returned by the ParmTemplateGroup can be used\n as arguments to methods that accept parm templates as layout\n placeholders (i.e. insertBefore, insertAfter, appendToFolder, etc.).\n However, changes made to the ParmTemplateGroup will invalidate any\n previously returned parm template copies as layout placeholders. In\n that case, you need to obtain new parm template copies from the\n group.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, parm_templates: Sequence[ParmTemplate] = ...) -> None:\n '''\n\n __init__(self, parm_templates=())\n\n Create a new group from an optional sequence of parm templates. If\n none are passed in, the new group will be empty.\n\n Because groups and folder parm templates can both be constructed\n using a sequence of contained parm templates, it is possible to\n construct a parm template group with parameters inside folders using\n a single expression. The following example creates a group with two\n folders and with parameters inside each of those folders:\n\n > >>> group = hou.ParmTemplateGroup((\n > ... hou.FolderParmTemplate(\\\\\"folder\\\\\", \\\\\"Physical\\\\\", (\n > ... hou.FloatParmTemplate(\\\\\"mass\\\\\", \\\\\"Mass\\\\\", 1),\n > ... hou.FloatParmTemplate(\\\\\"density\\\\\", \\\\\"Density\\\\\", 1),\n > ... )),\n > ... hou.FolderParmTemplate(\\\\\"folder\\\\\", \\\\\"Divisions\\\\\", (\n > ... hou.FloatParmTemplate(\\\\\"divisions\\\\\", \\\\\"Divisions\\\\\", 3),\n > ... hou.ToggleParmTemplate(\\\\\"laser\\\\\", \\\\\"Laser Scan\\\\\", default_value=True),\n > ... )),\n > ... ))\n > >>> group.entries()\n > (,\n > )\n > >>> group.entries()[0].parmTemplates()[0]\n > \n > >>> group.entriesWithoutFolders()\n > (,\n > ,\n > ,\n > )\n\n Raises hou.OperationFailed if any of the parm templates in the\n sequence are hou.FolderSetParmTemplate objects.\n\n\n '''\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def find(self, name: str) -> Optional[ParmTemplate]:\n '''\n\n find(self, name) -> hou.ParmTemplate or None\n\n Search in this group for a parm template whose name matches the\n specified one. Return a copy of the parm template or None if no\n match was found.\n\n Note that this function returns a copy of the parm template stored\n in this group. Modifying the copy will not affect the parameters in\n this group. The following example shows how to use the find and\n replace methods to modify the \\\\\"pos\\\\\" parm template in the group:\n\n > >>> parm_template = group.find(\\\\\"pos\\\\\")\n > >>> parm_template.setLabel(\\\\\"Position\\\\\")\n > >>> group.replace(\\\\\"pos\\\\\", parm_template)\n\n If you created the group from existing parameters, folder parm\n templates in the same folder set will share the same name, so\n searching for a folder using this method may return the first folder\n in the folder set. To instead search for a folder by its folder\n label, use findFolder.\n\n Note that, in general, the group does not prevent you from adding\n two parameters with the same name. In this case, searching for a\n parameter with this name will return the first one. Note, though,\n that when when setting this group to a node or asset definition\\'s\n parms, either the duplicate parameters will be renamed on an\n exception will be raised. See the rename_conflicting_parms parameter\n to hou.HDADefinition.setParmTemplateGroup for more information.\n\n\n '''\n def findIndices(self, name_or_parm_template: ParmTemplate|str) -> Tuple[int,...]:\n \"\"\"\n\n findIndices(self, name_or_parm_template) -> tuple of int\n\n Search in this group for a parm template and return a tuple of\n integers corresponding to the indices of the parm in the group.\n Return an empty tuple if no match was found.\n\n\n name_or_parm_template\n Either the name of the parm template or another hou.ParmTemplate\n object to compare against when searching for a match.\n\n If the parm template was found and it is not inside any folders, the\n result tuple will contain a single integer with the index of the\n parm template. Otherwise, the first entry will be the index of a\n folder inside the group, the next will be an index of a folder\n inside that folder, and so on until the last index is an index of a\n parm template inside a folder.\n\n See also findIndicesForFolder.\n\n\n \"\"\"\n def findFolder(self, label_or_labels: str|Sequence[str]) -> ParmTemplate|None:\n \"\"\"\n\n findFolder(self, label_or_labels) -> hou.FolderParmTemplate or None\n\n Search in this group for a folder parm template with the given\n label. Return a copy of the hou.FolderParmTemplate or None if the\n folder wasn't found.\n\n\n label_or_labels\n Either a string containing the folder's label or a tuple of\n strings containing the labels of containing folders as well as\n the folder's label.\n\n Note that a folder parm template's label is what appears in the\n interface in the parameter dialog. The folder parm template's name\n is used to determine the name of the parm tuple for the folder set,\n if the folder is the first in the folder set. See the documentation\n for this class for more information.\n\n\n \"\"\"\n def findIndicesForFolder(self, name_or_parm_template: ParmTemplate|str) -> Tuple[int,...]:\n \"\"\"\n\n findIndicesForFolder(self, label_or_labels) -> tuple of int\n\n Search in this group for a folder parm template with the given\n label. Return an empty tuple if no match was found.\n\n See findFolder for a description of the parameter and findIndices\n for a description of the return value.\n\n Note that this method does not accept a parm template. However, if\n you have a folder parm template and want to find its indices, simply\n call findIndices on the folder parm template.\n\n\n \"\"\"\n def entryAtIndices(self, indices: Sequence[int]) -> ParmTemplate:\n '''\n\n entryAtIndices(self, indices) -> hou.ParmTemplate\n\n Given a sequence of integer indices return a copy of the\n hou.ParmTemplate object at that location. The indices are of the\n format returned by findIndices.\n\n Like the hou.ParmTemplate.find and hou.ParmTemplate.entries methods,\n this method returns a copy of the parm template stored inside this\n group. Modifying the copied parm template will not affect the\n contents of this group. Use replace to change a parm template.\n\n Raises hou.OperationFailed if the indices are invalid, including\n when the indices sequence is empty.\n\n This method could be implemented as follows:\n\n > def entryAtIndices(self, indices):\n > if len(indices) == 0:\n > raise hou.OperationFailed(\\\\\"Invalid indices\\\\\")\n > parm_template = self.entries()[indices[0]]\n > \n > # If there are multiple indices then we should have just looked up\n > # a folder parm template.\n > for index in indices[1:]:\n > parm_template = parm_template.parmTemplates()[index]\n > return parm_template\n\n '''\n def containingFolderIndices(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int]) -> Tuple[int,...]:\n \"\"\"\n\n containingFolderIndices(self, name_or_parm_template_or_indices) -> tuple\n of int\n\n Return the indices of the folder in this group containing a given\n parm template. Return an empty tuple if no match was found.\n\n See replace for a description of the parameter and findIndices for a\n description of the return value.\n\n Raises hou.OperationFailed if the parameter is not inside the group\n or is not inside a folder.\n\n\n \"\"\"\n def containingFolder(self, name_or_parm_template: str|ParmTemplate) -> FolderParmTemplate:\n \"\"\"\n\n containingFolder(self, name_or_parm_template) -> hou.FolderParmTemplate\n\n Return a copy of the hou.FolderParmTemplate in this group containing\n a parm template.\n\n\n name_or_parm_template\n Either the name of the parm template or another hou.ParmTemplate\n object to compare against when searching for a match.\n\n Raises hou.OperationFailed if the parameter is not inside the group\n or is not inside a folder.\n\n\n \"\"\"\n def entries(self) -> Tuple[ParmTemplate, ...]:\n \"\"\"\n\n entries(self) -> tuple of hou.ParmTemplate\n\n Return a tuple containing copies of the parm templates inside this\n group.\n\n Note that folders are returned as hou.FolderParmTemplate objects,\n and each folder parm template contains the parm templates inside it.\n Use hou.FolderParmTemplate.parmTemplates to access the elements in a\n folder.\n\n The following example creates a function named allParmTemplates that\n returns a single sequence of parm templates, including folders, for\n all parm templates in the group:\n\n > def allParmTemplates(group_or_folder):\n > for parm_template in group_or_folder.parmTemplates():\n > yield parm_template\n > \n > # Note that we don't want to return parm templates inside multiparm\n > # blocks, so we verify that the folder parm template is actually\n > # for a folder.\n > if (parm_template.type() == hou.parmTemplateType.Folder and\n > parm_template.isActualFolder()):\n > for sub_parm_template in allParmTemplates(parm_template):\n > yield sub_parm_template\n\n See also the parmTemplates method.\n\n\n \"\"\"\n def parmTemplates(self) -> Tuple[ParmTemplate, ...]:\n \"\"\"\n\n parmTemplates(self) -> tuple of hou.ParmTemplate\n\n This method is simply an alias for the entries method.\n\n It makes it easier to search down through a parm template group for\n items nested in folders, since the hou.FolderParmTemplate class also\n has a method named parmTemplates. The following example shows how to\n look up the labels for a folder parameter given its indices:\n\n > def folderLabels(parm_template_group, indices):\n > container = parm_template_group\n > result = []\n > for index in indices:\n > container = container.parmTemplates()[index]\n > result.append(container.label())\n > return result\n\n \"\"\"\n def entriesWithoutFolders(self) -> Tuple[ParmTemplate, ...]:\n \"\"\"\n\n entriesWithoutFolders(self) -> tuple of hou.ParmTemplate\n\n Return a tuple containing all the non-folder parm templates inside\n this group. The output is the flattened set of parm templates in the\n group, and includes the non-folder parms inside folders.\n\n Like entries, this method returns a copy of the parm templates\n inside this group.\n\n Note that this function does not return parm templates for entries\n inside multiparm blocks.\n\n Also see the entries method for the example function\n allParmTemplates.\n\n\n \"\"\"\n def replace(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int], parm_template: ParmTemplate) -> None:\n \"\"\"\n\n replace(self, name_or_parm_template_or_indices, parm_template)\n\n Replace a parm template inside this group with another parm\n template.\n\n\n name_or_parm_template_or_indices\n Either the name of the parm template being replaced, a copy of\n the parm template, or a tuple of integer indices that identify\n the parm template and any containing folders.\n\n This method changes the contents of this group. Note that it stores\n a copy of the parm template in the group, so future changes to the\n parm template passed in will not affect the group.\n\n See the find method for a simple example of how to use this method.\n\n Note that parm templates for reserved parameters (for example, the\n transform parameters in object-level digital assets) can be replaced\n in the parm template group, but all aspects of reserved parameters\n except for their visibility and join settings will be restored to\n their defaults when you save this group to a node or asset\n definition.\n\n Raises hou.OperationFailed if the parm template doesn't exist.\n\n\n \"\"\"\n def insertBefore(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int], parm_template: ParmTemplate) -> None:\n \"\"\"\n\n insertBefore(self, name_or_parm_template_or_indices, parm_template)\n\n Insert a parm template inside this group before an existing one. The\n new parm template will be in the same folder as the existing one.\n\n See replace for a description of the name/parm template/indices\n parameter.\n\n Use appendToFolder to add an entry to a empty folder. Use append to\n add an entry to an empty parm template group.\n\n\n \"\"\"\n def insertAfter(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int], parm_template: ParmTemplate) -> None:\n \"\"\"\n\n insertAfter(self, name_or_parm_template_or_indices, parm_template)\n\n Insert a parm template inside this group after an existing one. The\n new parm template will be in the same folder as the existing one.\n\n See replace for a description of the name/ parm template/indices\n parameter.\n\n Use appendToFolder to add an entry to a empty folder. Use append to\n add an entry to an empty parm template group.\n\n\n \"\"\"\n def append(self, parm_template: ParmTemplate) -> None:\n \"\"\"\n\n append(self, parm_template)\n\n Add a parm template after all existing parm templates, outside of\n any folder.\n\n See also appendToFolder.\n\n\n \"\"\"\n def appendToFolder(self, label_or_labels_or_parm_template_or_indices: str|Sequence[str]|ParmTemplate|Sequence[int], parm_template: ParmTemplate) -> None:\n '''\n\n appendToFolder(self, label_or_labels_or_parm_template_or_indices,\n parm_template)\n\n Add a parm template to the bottom of an existing folder.\n\n Note that you cannot add to a folder by simply looking up the folder\n parm template and calling hou.FolderParmTemplate.addParmTemplate on\n it, because asking for a folder will return a deep copy. The parm\n templates inside the copied folder will be separate from those\n inside this group, and modifying the folder will not affect the\n group. Consider the following example:\n\n > >>> folder = group.findFolder(\\\\\"Transform\\\\\")\n > # \\\\\"folder\\\\\" now has its own copy of the parms inside it.\n > >>> folder.addParmTemplate(new_parm_template)\n > # \\\\\"folder\\\\\"\\'s parm templates are updated, but the group\\'s parm templates are\n > # unchanged.\n > \n > >>> group.appendToFolder(folder, new_parm_template)\n > # The group is modified. \\\\\"folder\\\\\"\\'s contents are unchanged.\n\n '''\n def addParmTemplate(self, parm_template: ParmTemplate) -> None:\n \"\"\"\n\n addParmTemplate(self, parm_template)\n\n This method is simply an alias for the append method.\n\n It makes it easier to treat parm template groups and\n hou.FolderParmTemplate objects uniformly, since\n hou.FolderParmTemplate has an addParmTemplate method.\n\n\n \"\"\"\n def remove(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int]) -> None:\n \"\"\"\n\n remove(self, name_or_parm_template_or_indices)\n\n Remove a parm template from the group. Note that if you remove a\n folder, all of the parm templates in the folder are also removed.\n\n See replace for a description of the name/parm template/indices\n parameter.\n\n Raises hou.OperationFailed if the parm template could not be found.\n\n\n \"\"\"\n def hide(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int], on: bool) -> None:\n \"\"\"\n\n hide(self, name_or_parm_template_or_indices, on)\n\n Hide a parameter by making it invisible. The parameter still exists\n in the group, but parameter dialogs will not display it.\n\n See replace for a description of the name/parm template/indices\n parameter.\n\n This method could be implemented as follows:\n\n > def hide(self, name_or_parm_template_or_indices, on):\n > parm_template = self.find(name_or_parm_template_or_indices)\n > parm_template.hide(on)\n > self.replace(name_or_parm_template_or_indices, parm_template)\n\n See also hideFolder and hou.ParmTemplate.hide.\n\n\n \"\"\"\n def hideFolder(self, label_or_labels: str|Sequence[str], on: bool) -> None:\n '''\n\n hideFolder(self, label_or_labels, on)\n\n Hide a folder and all the parameters in it.\n\n You may pass in either a string containing a single folder name or a\n sequence of strings to identify a nested folder. For example, the\n sequence (\\\\\"Render\\\\\", \\\\\"Dicing\\\\\") identifies the Dicing folder inside\n the Render folder. The folder is hidden if on is True and unhidden\n if it is False.\n\n The following example hides the Transform parameter in a geometry\n object:\n\n > >>> group = geo_node.parmTemplateGroup()\n > >>> group.hideFolder(\\\\\"Transform\\\\\", True)\n > >>> geo_node.setParmTemplateGroup(group)\n\n The following example hides the Dicing folder inside the Render\n folder on a geometry object:\n\n > >>> group = geo_node.parmTemplateGroup()\n > >>> group.hideFolder((\\\\\"Render\\\\\", \\\\\"Dicing\\\\\"), True)\n > >>> geo_node.setParmTemplateGroup(group)\n\n This method could be implemented as follows:\n\n > def hideFolder(self, label_or_labels, on):\n > self.hide(self.findFolder(label_or_labels), on)\n\n See also hide.\n\n\n '''\n def isHidden(self, name_or_parm_template_or_indices: str|ParmTemplate|Sequence[int]) -> bool:\n \"\"\"\n\n isHidden(self, name_or_parm_template_or_indices) -> bool\n\n Return whether the given parameter is itself hidden or lies inside a\n hidden folder.\n\n See replace for a description of the name/parm template/indices\n parameter.\n\n Note that if the parameter is inside a hidden folder but the\n parameter is not marked as hidden, calling hou.ParmTemplate.isHidden\n on the parm template will return False, while this method will\n return True.\n\n\n \"\"\"\n def isFolderHidden(self, label_or_labels: str|Sequence[str]) -> bool:\n '''\n\n isFolderHidden(self, label_or_labels) -> bool\n\n Return whether a folder or one of its containing folders is hidden.\n\n Note that if a folder is inside a hidden folder but this folder is\n not marked as hidden, calling hou.ParmTemplate.isHidden on the\n folder parm template will return False, while this method will\n return True.\n\n You may pass in either a string containing a single folder name or a\n sequence of strings to identify a nested folder. For example, the\n sequence (\\\\\"Render\\\\\", \\\\\"Dicing\\\\\") identifies the Dicing folder inside\n the Render folder. The folder is hidden if on is True and unhidden\n if it is False.\n\n\n '''\n def clear(self) -> None:\n \"\"\"\n\n clear(self)\n\n Remove all parm templates from this group.\n\n\n \"\"\"\n def asDialogScript(self, rename_conflicting_parms: bool = ..., full_info: bool = ..., script_name: str|None = ..., script_label: str|None = ..., script_tags: Mapping[str, str] = ...) -> str:\n \"\"\"\n\n asDialogScript(rename_conflicting_parms=False, full_info=False,\n script_name=None, script_label=None, script_tags={}) -> str\n\n Return a string containing the dialog script file contents\n corresponding to this parm template group.\n\n Houdini saves parameter definitions in this format when saving\n digital asset definitions (in the DialogScript section of the\n digital asset) and when saving parameter layouts of nodes.\n\n The default behavior for reserved parameters is to output baseparm\n tokens for reserved parameters so that it is resistant to changes in\n their definition. To change this, use full_info=True.\n\n The script_name, script_label and script_tags parameters specify\n additional data that is saved to the dialog script header as the\n name, label, and parmtag options respectively. The script_tags\n dictionary should map strings to strings. Each entry is saved to the\n dialog script as a separate parmtag. The interpretation of these\n additional header elements depends on where this dialog script is\n being used. When used to provide the parameter definitions for an\n HDA, these elements are ignored. But when using the dialog script as\n a source of render properties, these additional elements will be\n used to filter and categorize the properties in the Edit Parameter\n Interface window.\n\n\n \"\"\"\n def setToDialogScript(self, dialog_script: str) -> None:\n \"\"\"\n\n setToDialogScript(dialog_script)\n\n Set the contents of this group to match the parameters defined by\n the given dialog script string.\n\n Raises hou.OperationFailed if there is an error in the dialog script\n contents.\n\n\n \"\"\"\n def asCode(self, function_name: Optional[str] = None, variable_name: Optional[str] = None) -> str:\n \"\"\"\n\n asCode(self, function_name=None, variable_name=None) -> str\n\n Return Python code that will recreate this group.\n\n\n function_name\n If not None, the returned code will create a Python function.\n\n variable_name\n The name of the variable that will be assigned the newly-created\n parm template group.\n\n\n \"\"\"\n def sourceNode(self) -> Optional[Node]:\n \"\"\"\n\n sourceNode(self) -> hou.OpNode or None\n\n Return the node that the parameter template group was generated\n from. If the group was not generated from a node, then return None.\n\n Raises hou.ObjectWasDeleted if the source node has been destroyed.\n\n\n \"\"\"\n def sourceNodeType(self) -> Optional[NodeType]:\n \"\"\"\n\n sourceNodeType(self) -> hou.NodeType or None\n\n Return the node type that the parameter template group was generated\n from. If the group was not generated from a node type, then return\n None.\n\n Raises hou.ObjectWasDeleted if the source node type has been\n destroyed.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the internal name recorded to this object, either through a\n call to setName, or loaded from a dialog script using the\n setToDialogScript method.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Set the internal name for this parameter group. This information is\n written to the output of asDialogScript if the script_name parameter\n is left at the default value of None.\n\n\n \"\"\"\n def label(self) -> str:\n \"\"\"\n\n label(self) -> str\n\n Return the label recorded to this object, either through a call to\n setLabel, or loaded from a dialog script using the setToDialogScript\n method.\n\n\n \"\"\"\n def setLabel(self, label: str) -> None:\n \"\"\"\n\n setLabel(self, label)\n\n Set the label for this parameter group. This information is written\n to the output of asDialogScript if the script_label parameter is\n left at the default value of None.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass Pane:\n \"\"\"\n\n hou.Pane\n\n A rectangular area of the desktop that contains one or more pane tabs.\n\n Desktops (and floating panels) are composed of one or more panes.\n Initially a desktop contains one pane, and more panes are added to it by\n splitting existing panes in two, either horizontally or vertically.\n\n See hou.Desktop for more information about panes and pane tabs. See\n hou.FloatingPanel for more information about floating panels.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def desktop(self) -> Optional[Desktop]:\n \"\"\"\n\n desktop(self) -> hou.Desktop or None\n\n Return the desktop in which this pane exists, or None if it is in a\n floating panel that's not attached to the desktop.\n\n\n \"\"\"\n def id(self) -> int: ...\n def isMaximized(self) -> bool:\n \"\"\"\n\n isMaximized(self) -> bool\n\n Return True if this pane is maximized.\n\n\n \"\"\"\n def floatingPanel(self) -> Optional[FloatingPanel]: ...\n def setIsMaximized(self, on: bool) -> None:\n \"\"\"\n\n setIsMaximized(self, on)\n\n Set the maximized state of this pane.\n\n\n \"\"\"\n def tabs(self) -> Tuple[PaneTab, ...]:\n \"\"\"\n\n tabs(self) -> tuple of hou.PaneTab\n\n Return the pane tabs in this pane.\n\n\n \"\"\"\n def createTab(self, type: EnumValue, python_panel_interface: Optional[str] = None) -> PaneTab:\n \"\"\"\n\n createTab(self, type, python_panel_interface=None) -> hou.PaneTab\n\n Create a new pane tab with the desired type and return it. The new\n pane tab will be current (i.e. it will be the pane tab that's open).\n\n\n type\n A hou.paneTabType enumerated variable.\n\n python_panel_interface\n The name of the Python Panel interface to be displayed in the\n new pane tab. Specifying the interface name additionally hides\n the Python Panel toolbar. If python_panel_interface is None or\n points to an interface that does not exist then the default\n Python Panel pane tab is displayed along with the toolbar.\n\n This argument is ignored if pane_tab_type is not set to\n hou.paneTabType.PythonPanel.\n\n\n \"\"\"\n def currentTab(self) -> PaneTab:\n \"\"\"\n\n currentTab(self) -> hou.PaneTab\n\n Return the currently focused pane tab.\n\n See also hou.PaneTab.setIsCurrentTab.\n\n\n \"\"\"\n def tabOfType(self, type: EnumValue, index: int = 0) -> Optional[PaneTab]:\n \"\"\"\n\n tabOfType(self, type, index=0) -> hou.PaneTab or None\n\n Find and return a pane tab with the desired type, or None if no such\n tab exists in the pane.\n\n If there are multiple tabs in the pane with the desired type, then\n the first found tab is returned. Use index to return the other tabs.\n For example, use index=0 to return the first found tab, use index=1\n to return the second found tab, etc.\n\n See also hou.ui.paneTabOfType.\n\n\n \"\"\"\n def splitHorizontally(self) -> Pane:\n \"\"\"\n\n splitHorizontally(self) -> hou.Pane\n\n Split the pane, adding a new pane to the right, and return the new\n pane. The new pane will have a single tab whose type is the same as\n the type of this pane's current tab.\n\n See also hou.Pane.splitVertically.\n\n\n \"\"\"\n def splitVertically(self) -> Pane:\n \"\"\"\n\n splitVertically(self) -> hou.Pane\n\n Split the pane, adding a new pane to the bottom, and return the new\n pane. The new pane will have a single tab whose type is the same as\n the type of this pane's current tab.\n\n See also hou.Pane.splitHorizontally.\n\n\n \"\"\"\n def getSplitParent(self) -> Optional[Pane]:\n \"\"\"\n\n getSplitParent(self) -> hou.Pane or None\n\n Return the parent split pane if the Pane is nested under a split.\n\n\n \"\"\"\n def getSplitChild(self, child: int) -> Optional[Pane]:\n \"\"\"\n\n getSplitChild(self,index) -> hou.Pane or None\n\n Return the split child Pane at index if the Pane is a split.\n\n\n \"\"\"\n def splitSwap(self) -> None:\n \"\"\"\n\n splitSwap(self)\n\n Swap the left and right panes of an horizontal split Pane. Swap the\n top and bottom panes of a vertical split Pane.\n\n\n \"\"\"\n def splitRotate(self) -> None:\n \"\"\"\n\n splitRotate(self)\n\n Turn an horizontal split Pane into a vertical split Pane.\n\n\n \"\"\"\n def isSplitMaximized(self) -> bool:\n \"\"\"\n\n isSplitMaximized(self) -> bool\n\n Return True if the Pane is maximized on the split. A split can't be\n minimized and maximized at the same time. In its default state, a\n split is not minimized and not maximized.\n\n\n \"\"\"\n def isSplitMinimized(self) -> bool:\n \"\"\"\n\n isSplitMinimized(self) -> bool\n\n Return True if the Pane is minimized on the split. A split can't be\n minimized and maximized at the same time. In its default state, a\n split is not minimized and not maximized.\n\n\n \"\"\"\n def setIsSplitMaximized(self, on: bool) -> None:\n \"\"\"\n\n setIsSplitMaximized(self, on) -> bool\n\n Set the maximized state of a split.\n\n\n \"\"\"\n def isSplit(self) -> bool:\n \"\"\"\n\n isSplit(self) -> bool\n\n Return True if the pane is a split.\n\n\n \"\"\"\n def setSplitFraction(self, value: float) -> None:\n \"\"\"\n\n setSplitFraction(self,fraction)\n\n Set the split fraction of the parent split.\n\n\n \"\"\"\n def getSplitFraction(self) -> float:\n \"\"\"\n\n getSplitFraction(self,fraction) -> double\n\n Return the split fraction of the parent split.\n\n\n \"\"\"\n def setSplitDirection(self, dir: int) -> None:\n \"\"\"\n\n setSplitDirection(self,dir)\n\n Set the split direction of the parent split.\n\n\n \"\"\"\n def getSplitDirection(self) -> int:\n \"\"\"\n\n getSplitDirection(self,dir) -> double\n\n Return the split direction of the parent split.\n\n\n \"\"\"\n def setShowPaneTabs(self, value: bool) -> None:\n \"\"\"\n\n setShowPaneTabs(self,on)\n\n Show or Hide the pane tabs bar.\n\n This method is deprecated in favor of showPaneTabs.\n\n\n \"\"\"\n def showPaneTabs(self, value: bool) -> None:\n \"\"\"\n\n showPaneTabs(self,on)\n\n Show or Hide the pane tabs bar.\n\n\n \"\"\"\n def isShowingPaneTabs(self) -> bool:\n \"\"\"\n\n isShowingPaneTabs(self) -> bool\n\n Return True if the Pane is showing pane tabs.\n\n\n \"\"\"\n def showPaneTabsStow(self, value: bool) -> None:\n \"\"\"\n\n showPaneTabsStow(self,on)\n\n Show or Hide the pane tabs stow bar button when pane tabs are\n hidden.\n\n\n \"\"\"\n def isShowingPaneTabsStow(self) -> bool:\n \"\"\"\n\n isShowingPaneTabsStow(self) -> bool\n\n Return True if the Pane is showing the pane tabs stow bar when pane\n tabs are hidden.\n\n\n \"\"\"\n\nclass PaneTab:\n \"\"\"\n\n hou.PaneTab\n\n One of the tabs inside a desktop pane.\n\n Each pane type is of a particular type (e.g. scene viewer, network view,\n parameters, etc.). A pane may contain multiple tabs and displays the\n contents of one tab at a time.\n\n See hou.Desktop for more information about panes and pane tabs.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def pane(self) -> Optional[Pane]:\n \"\"\"\n\n pane(self) -> hou.Pane or None\n\n Return the pane in the desktop that contains this pane tab. Note\n that pane tabs in regular floating panels are always in a pane,\n since regular floating panels contain one or more panes.\n\n However, some floating panels have their content stripped down to\n only contain one particular pane tab type, and do not display the\n user interface to add more pane tabs, split the pane, etc. This\n method returns None for these stripped down floating panels.\n\n\n \"\"\"\n def floatingPanel(self) -> Optional[FloatingPanel]:\n \"\"\"\n\n floatingPanel(self) -> hou.FloatingPanel or None\n\n Return the floating panel that contains this pane tab or None if the\n pane tab is not in a floating panel.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of this tab.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Set the name of this pane tab. A pane tab name may contain spaces.\n\n Note that this name is the internal name of the tab, and is\n different from the label displayed in the interface.\n\n\n \"\"\"\n def isCurrentTab(self) -> bool:\n \"\"\"\n\n isCurrentTab(self) -> bool\n\n Return whether this tab is the selected tab in the containing pane.\n\n\n \"\"\"\n def setIsCurrentTab(self) -> None:\n \"\"\"\n\n setIsCurrentTab(self)\n\n Set this tab as the selected tab in the containing pane.\n\n\n \"\"\"\n def isFloating(self) -> bool:\n \"\"\"\n\n isFloating(self) -> bool\n\n Return whether this pane tab is in a floating panel.\n\n This method can be approximately implemented as follows:\n\n > def isFloating(self):\n > return self.pane() is None or self.pane().floatingPanel() is not None\n\n \"\"\"\n def clone(self) -> PaneTab:\n \"\"\"\n\n clone(self) -> hou.PaneTab\n\n Create a floating copy of the pane tab and return the cloned pane\n tab. The new pane tab is in a new floating panel.\n\n\n \"\"\"\n def close(self) -> None:\n \"\"\"\n\n close(self)\n\n Close the pane tab.\n\n\n \"\"\"\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.paneTabType enum value\n\n Return the type of this tab (i.e. whether it is a scene viewer,\n parameter editor, network editor, etc.).\n\n\n \"\"\"\n def setType(self, type: EnumValue) -> PaneTab:\n \"\"\"\n\n setType(self, type) -> hou.PaneTab\n\n Create a new pane tab of the given type, replace this tab with it,\n and return the new pane tab. Use the returned pane tab afterward;\n references to this tab become invalid.\n\n\n \"\"\"\n def linkGroup(self) -> EnumValue:\n \"\"\"\n\n linkGroup(self) -> hou.paneLinkType enum value\n\n Return the link group that this pane tab belongs to.\n\n See also hou.PaneTab.isPin.\n\n\n \"\"\"\n def setLinkGroup(self, group: EnumValue) -> None:\n \"\"\"\n\n setLinkGroup(self, group)\n\n Set the link group membership of this pane tab.\n\n\n \"\"\"\n def isPin(self) -> bool:\n \"\"\"\n\n isPin(self) -> bool\n\n Return whether this pane tab is pinned. This method is equivalent to\n (self.linkGroup() == hou.paneLinkType.Pinned)\n\n See also hou.PaneTab.linkGroup.\n\n\n \"\"\"\n def setPin(self, pin: bool) -> None:\n \"\"\"\n\n setPin(self, pin)\n\n If pin is True, set the link group membership to\n hou.paneLinkType.Pinned. Otherwise, set it to\n hou.paneLinkType.FollowSelection. This method can be implemented\n using hou.PaneTab.setLinkGroup as follows:\n\n > def setPin(self, pin):\n > if pin:\n > self.setLinkGroup(hou.paneLinkType.Pinned)\n > else:\n > self.setLinkGroup(hou.paneLinkType.FollowSelection)\n\n See also hou.PaneTab.setLinkGroup.\n\n\n \"\"\"\n def tools(self) -> Tuple[Tool, ...]:\n \"\"\"\n\n tools(self) -> tuple of hou.Tool\n\n Return a tuple of hou.Tool objects that are valid in the current\n pane tab.\n\n\n \"\"\"\n def size(self) -> Tuple[int, ...]:\n \"\"\"\n\n contentSize() -> tuple of int\n\n Return a 2-tuple containing the pane tab's content area width and\n height.\n\n The width and height do not include the network navigation control\n area (if any), pane tab borders or tab area.\n\n\n \"\"\"\n def contentSize(self) -> Tuple[int, ...]: ...\n def hasNetworkControls(self) -> bool:\n \"\"\"\n\n hasNetworkControls(self) -> bool\n\n Return True if this pane tab type supports network controls.\n\n\n \"\"\"\n def isShowingNetworkControls(self) -> bool:\n \"\"\"\n\n isShowingNetworkControls(self) -> bool\n\n Return whether this pane tab is showing its network control bar.\n Return False if the pane tab doesn't have network controls. See also\n hou.PaneTab.hasNetworkControls.\n\n\n \"\"\"\n def setShowNetworkControls(self, value: bool) -> None:\n \"\"\"\n\n setShowNetworkControls(self, pin)\n\n Show or Hide the network control bar. Has no effect if the pane tab\n doesn't have network controls. See also\n hou.PaneTab.hasNetworkControls.\n\n This method is deprecated in favor of showNetworkControls.\n\n\n \"\"\"\n def showNetworkControls(self, value: bool) -> None:\n \"\"\"\n\n showNetworkControls(self, pin)\n\n Show or Hide the network control bar. Has no effect if the pane tab\n doesn't have network controls. See also\n hou.PaneTab.hasNetworkControls.\n\n\n \"\"\"\n def displayRadialMenu(self, menu: str|RadialScriptItem) -> None:\n \"\"\"\n\n displayRadialMenu(self, menu)\n\n Launch the specified radial menu in the pane tab.\n\n\n menu\n The name of the registered radial menu. Alternatively, a\n temporary radial submenu (or script menu) can be passed. See\n also hou.ui.createRadialItem.\n\n\n \"\"\"\n\nclass PathBasedPaneTab(PaneTab):\n \"\"\"\n\n hou.PathBasedPaneTab\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def pwd(self) -> Node:\n \"\"\"\n\n pwd(self) -> Node\n\n\n \"\"\"\n def setPwd(self, node: Node) -> None:\n \"\"\"\n\n setPwd(self, node)\n\n\n \"\"\"\n def cd(self, path: str) -> None:\n \"\"\"\n\n cd(self, path)\n\n\n \"\"\"\n def currentNode(self) -> Node:\n \"\"\"\n\n currentNode(self) -> Node\n\n\n \"\"\"\n def setCurrentNode(self, node: Node, pick_node: bool = True) -> None:\n \"\"\"\n\n setCurrentNode(self, node, pick_node = True)\n\n\n \"\"\"\n\nclass DopData:\n \"\"\"\n\n hou.DopData\n\n A piece of data stored inside a DOP network's simulation.\n\n Each DOP network builds a tree of data, and then Houdini examines and\n updates this tree when it runs the simulation. DOP data elements can be\n DOP objects, geometry, volumes, forces, solvers, etc. The data is\n arranged in a tree structure, where child nodes are called subdata and\n are said to be attached to their parent nodes. Under the root of the\n tree are usually the DOP objects and data describing their\n relationships.\n\n Note that the same piece of data can appear in the tree in multiple\n locations, with different names. DopData objects thus do not store their\n name, and the name of a piece of data in the tree is instead stored with\n its parent data(s).\n\n By default, DopData objects store the path within the tree to the data.\n As a consequence, if the time changes and the solvers within the\n simulation change the contents of the tree of data, the Python DopData\n object will update to refer to the simulation's new state. If the data\n path no longer refers to valid data, Houdini raises hou.ObjectWasDeleted\n when you try to access the DopData object from Python.\n\n If you do not want the DopData to update with changes to the simulation,\n you can call hou.DopData.freeze. freeze returns another DopData object\n that refers the simulation's state at the current time, and will not\n change when the simulation time changes.\n\n Each piece of data can contain records, and each record stores a list of\n name and value pairs called fields. Each record has a name, but it's\n possible for multiple records with the same name to exist in the same\n piece of data. In this case, the record also has an index, and you can\n think of the records as rows of a spreadsheet.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def freeze(self) -> DopData:\n \"\"\"\n\n freeze(self) -> hou.DopData\n\n Return a frozen version of this DopData. Frozen versions of the data\n will not update when the simulation updates. Instead, they will\n refer to the state of the simulation at the time they were frozen.\n\n It is ok to call this method on a DopData object that is already\n frozen.\n\n\n \"\"\"\n def isFrozen(self) -> bool:\n \"\"\"\n\n isFrozen(self) -> bool\n\n Return whether or not this data is frozen.\n\n See hou.DopData.freeze for more information.\n\n\n \"\"\"\n def path(self) -> str:\n \"\"\"\n\n path(self) -> str\n\n Return the path to this object within the tree of DOP data. This\n path includes the DOP object or relationship as the first part of\n the path.\n\n Note that the same piece of DOP data can exist in multiple places of\n the tree. The path returned is the path stored inside this Python\n DopData object, since the Python object uses the path to look up the\n underlying data each time you call a method on it.\n\n Note that the path is only available for unfrozen objects. If you\n call this method on a frozen DopData object it raises\n hou.OperationFailed.\n\n\n \"\"\"\n def selectionPath(self) -> str:\n \"\"\"\n\n selectionPath(self) -> str\n\n For DopData objects returned from a hou.SceneViewer.selectDynamics\n function call, this will return the a string that contains both the\n path to the DOP Network that created the data, and the path within\n the DOP data tree which uniquely identifies this DopData. This\n string is specifically intended to be passed in the\n prior_selection_paths argument of the hou.SceneViewer selection\n methods.\n\n\n \"\"\"\n def __hash__(self) -> int: ...\n def dopNetNode(self) -> OpNode:\n \"\"\"\n\n dopNetNode(self) -> hou.OpNode\n\n Return the DOP network node containing this DOP data.\n\n\n \"\"\"\n def simulation(self) -> DopSimulation:\n \"\"\"\n\n simulation(self) -> hou.DopSimulation\n\n Return the DOP simulation containing this DOP data. This method is a\n shortcut for self.dopNetNode().simulation().\n\n\n \"\"\"\n def creator(self) -> OpNode:\n \"\"\"\n\n creator(self) -> hou.DopNode\n\n Return the DOP node that created this DOP data inside the DOP\n network.\n\n\n \"\"\"\n def id(self) -> str:\n '''\n\n id(self) -> str\n\n Return the globally unique identifier (GUID) for this DOP data. This\n method is a shortcut for self.record(\\\\\"Basic\\\\\").field(\\\\\"uniqueid\\\\\").\n\n If you want an object\\'s index, hou.DopObject.objid.\n\n > >>> obj = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().objects()[0]\n > >>> obj.id()\n > \\'0xD011E41C-0x000034AE-0x494C12E4-0x000018B9\\'\n > >>> obj.objid()\n > 0\n\n '''\n def dataType(self) -> str:\n '''\n\n dataType(self) -> str\n\n Return a string describing the type of data this object contains.\n\n > >>> obj = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().objects()[0]\n > >>> obj.dataType()\n > \\'SIM_Object\\'\n\n See also hou.DopData.dataTypeObject.\n\n\n '''\n def recordTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n recordTypes(self) -> tuple of str\n\n Return a tuple of strings containing the record types stored inside\n this DOP data. Each DOP data contains records named Basic and\n Options, and some types of DOP data contain additional records.\n\n\n \"\"\"\n def record(self, record_type: str, record_index: int = 0) -> Optional[DopRecord]:\n \"\"\"\n\n record(self, record_type, record_index=0) -> hou.DopRecord\n\n Given a record type name return that record, or None if no record\n exists with that name. If this DOP data contains multiple records\n with this record type name you can think of each record as a row in\n a spreadsheet, and record_index determines which one is returned.\n Use len(self.records(record_type)) to determine how many records of\n this type are in this DOP data.\n\n Use hou.DopData.recordTypes to get a tuple of record types in a DOP\n data. See also hou.DopData.records for an example, and see\n hou.DopData.options for a way to easily access the Options record.\n\n\n \"\"\"\n def records(self, record_type: str) -> Iterator[DopRecord]:\n '''\n\n records(self, record_type) -> tuple of hou.DopRecord\n\n Return a tuple of all the records of this record type. See also\n hou.DopData.record.\n\n This example lists the input affectors for a rigid body box that\n collides with a ground plane:\n\n > >>> obj = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().objects()[-1]\n > >>> obj.records(\\\\\"RelInAffectors\\\\\")\n > (, )\n > >>> [record.field(\\\\\"relname\\\\\") for record in obj.records(\\\\\"RelInAffectors\\\\\")]\n > [\\'merge1\\', \\'staticsolver1_staticsolver1\\']\n > >>> obj.record(\\\\\"RelInAffectors\\\\\", 1).field(\\\\\"relname\\\\\")\n > \\'staticsolver1_staticsolver1\\'\n\n '''\n def options(self) -> DopRecord:\n '''\n\n options(self) -> hou.DopRecord\n\n Return the Options record. This method is a shortcut for\n self.record(\\\\\"Options\\\\\").\n\n\n '''\n def subData(self) -> dict[str, DopData]:\n '''\n\n subData(self) -> dict of str to hou.DopData\n\n Return a dictionary mapping names to DOP data instances for the\n subdata attached to this data.\n\n > # The following code assumes you have created a box from the shelf and used\n > # Rigid Bodies > RBD Object on the shelf to make it a rigid body.\n > >>> obj = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().objects()[0]\n > >>> obj\n > \n > >>> obj.recordTypes()\n > (\\'Basic\\', \\'Options\\', \\'RelInGroup\\', \\'RelInAffectors\\')\n > >>> record = obj.record(\\\\\"Options\\\\\")\n > >>> record.fieldNames()\n > (\\'name\\', \\'groups\\', \\'affectors\\', \\'affectorids\\', \\'objid\\')\n > >>> record.field(\\\\\"name\\\\\")\n > \\'box_object1\\'\n > \n > >>> obj.subData().keys()\n > [\\'PhysicalParms\\', \\'ODE_Body\\', \\'Solver\\', \\'Geometry\\', \\'SolverParms\\', \\'ODE_Geometry\\', \\'Forces\\', \\'Position\\', \\'Colliders\\']\n > >>> obj.findSubData(\\\\\"Forces/Gravity_gravity1\\\\\")\n > \n > >>> obj.findSubData(\\\\\"Forces/Gravity_gravity1\\\\\").options().field(\\\\\"force\\\\\")\n > \n\n '''\n def findSubData(self, data_spec: str) -> Optional[DopData]:\n '''\n\n findSubData(self, data_spec) -> hou.DopData or None\n\n Return the DOP data with the given name that is attached to this DOP\n data, or None if no such data exists. Note that the name may also be\n a slash-separated path to nested subdata.\n\n See hou.DopData.subData for an example.\n\n This method can be approximately implemented as follows:\n\n > def findSubData(self, data_spec):\n > data = self\n > for name in data_spec.split(\\\\\"/\\\\\"):\n > if name not in data.subData():\n > return None\n > data = data.subData()[name]\n > return data\n\n '''\n def findAllSubData(self, data_spec: str, recurse: bool = False) -> dict[str, DopData]:\n '''\n\n findAllSubData(self, data_spec, recurse=False) -> dict of str to\n hou.DopData\n\n Given a pattern, return a dictionary mapping subdata paths to DOP\n data instances for all the subdatas whose name matches the pattern.\n If recurse is True, all grandchildren subdata will be added to the\n result.\n\n > # The following code assumes you have created a box from the shelf and used\n > # Rigid Bodies > RBD Object on the shelf to make it a rigid body.\n > >>> obj = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().objects()[0]\n > >>> obj.findAllSubData(\\\\\"S*\\\\\").keys()\n > [\\'SolverParms\\', \\'Solver\\']\n > >>> obj.findAllSubData(\\\\\"S*\\\\\", recurse=True).keys()\n > [\\'SolverParms\\', \\'Solver/Random\\', \\'SolverParms/ActiveValue\\', \\'Solver\\']\n > >>> obj.findAllSubData(\\\\\"S*/*\\\\\", recurse=True).keys()\n > [\\'SolverParms/ActiveValue\\', \\'Solver/Random\\']\n\n '''\n def createSubData(self, data_name: str, data_type: str = ..., avoid_name_collisions: bool = ...) -> DopData:\n '''\n\n createSubData(self, data_name, data_type=\\\\\"SIM_EmptyData\\\\\",\n avoid_name_collisions=False) -> hou.DopData\n\n Create subdata under this data with the specified name and type. You\n would call this method from a script solver DOP.\n\n\n data_name\n The name of the new data. Note that this name may contain\n slashes to create subdata on existing data.\n\n data_type\n Either the name of the data type to create or a hou.DopDataType\n instance. If you simply want something containing an empty\n options record, use SIM_EmptyData.\n\n avoid_name_collisions\n If True and data with the specified name exists, Houdini will\n create a unique name that does not conflict with any existing\n data.\n\n Raises hou.OperationFailed if data with this name already exists. If\n you want to replace existing data it is up to you to first call\n hou.DopData.removeData.\n\n Raises hou.PermissionError if called from outside a script solver\n DOP.\n\n Use hou.DopData.attachSubData to create a reference to existing\n data. See hou.DopData.copyContentsFrom for an example of how to\n create a copy of existing data.\n\n\n '''\n def attachSubData(self, hom_new_subdata: DopData, new_data_name: str, avoid_name_collisions: bool = False) -> None:\n \"\"\"\n\n attachSubData(self, data, new_data_name, avoid_name_collisions=False)\n\n Make existing data become subdata of this data. Houdini does not\n create a duplicate of the data. Instead, the data's parent(s) and\n this data will both refer to the same instance of subdata. You would\n call this method from a script solver DOP.\n\n\n data\n The DopData that will become subdata of this data.\n\n new_data_name\n The name of the new subdata.\n\n avoid_name_collisions\n If True and data with the specified name exists, Houdini will\n create a unique name that does not conflict with any existing\n data.\n\n Raises hou.OperationFailed if data with this name already exists. If\n you want to replace existing data it is up to you to first call\n hou.DopData.removeData.\n\n Raises hou.PermissionError if called from outside a script solver\n DOP.\n\n See hou.DopData.copyContentsFrom for an example of how to create a\n copy of existing data.\n\n\n \"\"\"\n def removeSubData(self, data_spec: str) -> None:\n \"\"\"\n\n removeSubData(self, data_spec)\n\n Remove subdata with the given name. Raises hou.PermissionError if\n called from outside a script solver DOP.\n\n Raises hou.OperationFailed if data with that name already exists.\n\n\n \"\"\"\n def copyContentsFrom(self, hom_data: DopData) -> None:\n \"\"\"\n\n copyContentsFrom(self, data)\n\n Copy the contents of the given DopData into this one, adapting the\n data if it is of a different type. You would call this method from a\n script solver DOP.\n\n Raises hou.PermissionError if called from outside a script solver\n DOP.\n\n Use this method along with hou.DopData.createSubData to copy\n existing subdata:\n\n > def copySubData(new_parent_data, data_to_copy, new_data_name, avoid_name_collisions=False):\n > '''Create a copy of data and attach it to other data.'''\n > new_data = new_parent_data.createSubData(new_data_name, data_to_copy.dataType(), avoid_name_collisions)\n > new_data.copyContentsFrom(data_to_copy)\n > return new_data\n\n \"\"\"\n def fieldGeometry(self, data_name: str) -> Optional[Geometry]: ...\n def geometry(self, data_name: Optional[str] = None) -> Optional[Geometry]: ...\n def editableGeometry(self, data_name: Optional[str] = None) -> Optional[EditableDopGeometryGuard]: ...\n\nclass ShelfElement:\n \"\"\"\n\n hou.ShelfElement\n\n Superclass of shelf tools, shelf tabs, and shelf sets.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def filePath(self) -> str:\n \"\"\"\n\n filePath(self) -> str\n\n Returns the file that contains the definition of this object.\n\n\n \"\"\"\n def setFilePath(self, file_path: str|None) -> None:\n \"\"\"\n\n setFilePath(self, file_path)\n\n Sets the path string for where this object's definition is stored.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the internal name of this object.\n\n Multiple objects may have the same name (for example, two different\n assets might both provide a hammer tool), but only one will be\n active at a time in a Houdini session.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n '''\n\n setName(self, name)\n\n Sets this object\\'s internal name. This is how you refer to the\n object in scripts.\n\n The name has similar rules to naming Houdini nodes: it must not\n start with a number, and can only contain letters, numbers, an\n underscores.\n\n For example, if a Tool objects name is foo, you can get a reference\n to it using:\n\n > footool = shelves.tool(\\\\\"foo\\\\\")\n\n '''\n def label(self) -> str:\n \"\"\"\n\n label(self) -> str\n\n Returns the object's human-readable label.\n\n\n \"\"\"\n def setLabel(self, label: str) -> None:\n \"\"\"\n\n setLabel(self, label)\n\n Sets the object's human-readable label. This is what's displayed in\n the UI.\n\n\n \"\"\"\n def fileLocation(self) -> str:\n \"\"\"\n\n fileLocation(self) -> str\n\n Returns the file location description in a human readable format.\n For example, it is a file path for disk files, and information about\n an HDA if the element is stored in an HDA tool section.\n\n\n \"\"\"\n def isReadOnly(self) -> bool:\n \"\"\"\n\n isReadOnly(self) -> bool\n\n Returns True if the element is read-only (can't be edited).\n\n\n \"\"\"\n def setReadOnly(self, on: bool) -> None:\n '''\n\n setReadOnly(self, on)\n\n > # Get a reference to a tool\n > t = hou.shelves.tool(\\\\\"geometry_sphere\\\\\")\n > # Prevent the tool from being modified\n > t.setReadOnly(True)\n > # Allow the tool to be modified\n > t.setReadOnly(False)\n\n '''\n\nclass _logging_Sink:\n \"\"\"\n\n hou.logging.Sink\n\n Represents a logging destination.\n\n This is an abstract base class for all logging sink classes. It provides\n the common methods for connecting and disconnecting sources to the sink.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def connectedSources(self) -> Tuple[str, ...]:\n \"\"\"\n\n connectedSources() -> tuple of str\n\n Returns the names of sources connected to this sink.\n\n\n \"\"\"\n def connect(self, source_name: str) -> None:\n \"\"\"\n\n connect(source_name)\n\n Connect a source to this sink object. The source_name should be one\n of the values return by a call to hou.logging.sources.\n\n\n \"\"\"\n def disconnect(self, source_name: str) -> None:\n \"\"\"\n\n disconnect(source_name)\n\n Disconnect a source from this sink object. The source_name should be\n one of the values returned by the connectedSources method.\n\n\n \"\"\"\n def setFilterCallback(self, callback: Callable[[_logging_LogEntry], None]) -> None:\n \"\"\"\n\n setFilterCallback(callback)\n\n Associates a callable object with this log sink which is called\n every time a log entry is generated by a source connected to this\n sink. The callback should take one argument, which is a\n hou.logging.LogEntry object. If this callback returns False, the log\n entry will not be stored or otherwise processed by this sink object.\n\n\n \"\"\"\n\nclass Agent(PackedPrim):\n \"\"\"\n\n hou.Agent\n\n An agent primitive.\n\n See Crowd Agents for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def definition(self) -> AgentDefinition:\n \"\"\"\n\n definition(self) -> hou.AgentDefinition\n\n Returns the shared agent definition.\n\n\n \"\"\"\n def setDefinition(self, definition: AgentDefinition) -> None:\n \"\"\"\n\n setDefinition(definition)\n\n Changes the agent's definition. If the new definition's rig has a\n different number of transforms, the agent's current transforms will\n be reset. The agent's current clips will be reset if the new\n definition does not contain clips with the same names.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n definition\n A hou.AgentDefinition.\n\n\n \"\"\"\n def currentLayer(self) -> AgentLayer:\n \"\"\"\n\n currentLayer(self) -> hou.AgentLayer\n\n This method is deprecated in favor of hou.Agent.currentLayers.\n\n Returns the current display layer of the agent. If there are\n multiple current display layers, only the first layer will be\n returned.\n\n\n \"\"\"\n def setCurrentLayer(self, layer: AgentLayer) -> None:\n \"\"\"\n\n setCurrentLayer(layer)\n\n This method is deprecated in favor of hou.Agent.setCurrentLayers.\n\n Sets the agent's current display layer.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n layer\n A hou.AgentLayer.\n\n\n \"\"\"\n def collisionLayer(self) -> AgentLayer:\n \"\"\"\n\n collisionLayer(self) -> hou.AgentLayer\n\n This method is deprecated in favor of hou.Agent.collisionLayers.\n\n Returns the current collision layer of the agent. If there are\n multiple current collision layers, only the first layer will be\n returned.\n\n\n \"\"\"\n def setCollisionLayer(self, layer: AgentLayer) -> None:\n \"\"\"\n\n setCollisionLayer(layer)\n\n This method is deprecated in favor of hou.Agent.setCollisionLayers.\n\n Sets the agent's current collision layer.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n layer\n A hou.AgentLayer.\n\n\n \"\"\"\n def currentLayers(self) -> Tuple[AgentLayer, ...]:\n \"\"\"\n\n currentLayers(self) -> tuple of hou.AgentLayer\n\n Returns the agent's current display layers.\n\n\n \"\"\"\n def setCurrentLayers(self, layers: Sequence[AgentLayer]) -> None:\n \"\"\"\n\n setCurrentLayers(layers)\n\n Sets the agent's current display layers.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n layers\n A hou.AgentLayer sequence.\n\n\n \"\"\"\n def collisionLayers(self) -> Tuple[AgentLayer, ...]:\n \"\"\"\n\n collisionLayers(self) -> tuple of hou.AgentLayer\n\n Returns the agent's current collision layers.\n\n\n \"\"\"\n def setCollisionLayers(self, layers: Sequence[AgentLayer]) -> None:\n \"\"\"\n\n setCollisionLayers(layers)\n\n Sets the agent's current collision layers.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n layers\n A hou.AgentLayer sequence.\n\n\n \"\"\"\n def clips(self) -> Tuple[AgentClip, ...]:\n \"\"\"\n\n clips(self) -> tuple of hou.AgentClip\n\n Returns the agent's current animation clips.\n\n\n \"\"\"\n def setClips(self, clips: Sequence[AgentClip]) -> None:\n \"\"\"\n\n setClips(clips)\n\n Sets the agent's current animation clips.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n clips\n A hou.AgentClip sequence.\n\n\n \"\"\"\n def clipTimes(self) -> Tuple[float, ...]:\n \"\"\"\n\n clipWeights(self) -> tuple of float\n\n Returns the blend weights for the agent's animation clips.\n\n\n \"\"\"\n def setClipTimes(self, times: Sequence[float]) -> None:\n \"\"\"\n\n setClipTimes(times)\n\n Sets the current times for the agent's animation clips.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n times\n A float sequence.\n\n\n \"\"\"\n def clipWeights(self) -> Tuple[float, ...]: ...\n def setClipWeights(self, weights: Sequence[float]) -> None:\n \"\"\"\n\n setClipWeights(weights)\n\n Sets the blend weights for the agent's animation clips.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n weights\n A float sequence.\n\n\n \"\"\"\n def localTransform(self, i: int) -> Matrix4:\n \"\"\"\n\n localTransform(self, transform) -> hou.Matrix4\n\n Returns the current local space transform of an agent primitive's\n bone.\n\n\n transform\n Index of a transform in the agent's rig.\n\n\n \"\"\"\n def setLocalTransform(self, xform: Matrix4, i: int) -> None:\n \"\"\"\n\n setLocalTransform(xform, index)\n\n Sets the current local space transform of an agent primitive's bone.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n xform\n A hou.Matrix4.\n\n index\n Index of a transform in the agent's rig.\n\n\n \"\"\"\n def worldTransform(self, i: int) -> Matrix4:\n \"\"\"\n\n worldTransform(self, transform) -> hou.Matrix4\n\n Returns the current world space transform of an agent primitive's\n bone.\n\n\n transform\n Index of a transform in the agent's rig.\n\n\n \"\"\"\n def setWorldTransform(self, xform: Matrix4, i: int) -> None:\n \"\"\"\n\n setWorldTransform(xform, index)\n\n Sets the current world space transform of an agent primitive's bone.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n xform\n A hou.Matrix4.\n\n index\n Index of a transform in the agent's rig.\n\n\n \"\"\"\n def channelValue(self, i: int) -> float:\n \"\"\"\n\n channelValue(self, channel_index) -> float\n\n Returns the current value of an agent primitive's channel.\n\n\n channel_index\n Index of a channel in the agent's rig.\n\n\n \"\"\"\n def setChannelValue(self, value: float, i: int) -> None:\n \"\"\"\n\n setChannelValue(self, value, channel_index)\n\n Set the current value of an agent primitive's channel.\n\n\n value\n A float value for the channel.\n\n channel_index\n Index of a channel in the agent's rig.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def clipCatalog(self) -> AgentClip: ...\n def layers(self) -> AgentLayer: ...\n def rig(self) -> AgentRig: ...\n def shapeLibrary(self) -> AgentShapeLibrary: ...\n\nclass AgentClip:\n \"\"\"\n\n hou.AgentClip\n\n An agent's animation clip.\n\n See Crowd Animation Clips for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, stage: pxr.Usd.Stage, prim_path: str, rig: AgentRig) -> None:\n \"\"\"\n\n __init__(name, stage, prim_path, rig)\n\n Creates a new agent clip from a USD primitive. Raises\n hou.OperationFailed if the clip could not be loaded.\n\n\n name\n A name for the new clip, such as walk.\n\n stage\n The USD stage to load the clip from. For example, this could be\n the output stage from a LOP node.\n\n prim_path\n A path to a Skeleton or SkelRoot primitive in the stage to load\n the clip from.\n\n rig\n The hou.AgentRig that the clip will be associated with. The rig\n is used, for example, when converting transforms from local\n space to world space.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def freeze(self) -> AgentClip:\n \"\"\"\n\n freeze(self) -> hou.AgentClip\n\n Creates a modifiable copy of the clip. The copy will not be marked\n as an external reference.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of the clip.\n\n\n \"\"\"\n def fileName(self, expanded: bool = False) -> str:\n \"\"\"\n\n fileName(self, expanded = False) -> str\n\n If the clip is an external reference, returns the path to the file\n on disk.\n\n\n expanded\n Specifies whether to expand any variables in the path, such as\n $HIP.\n\n\n \"\"\"\n def isLoaded(self) -> bool:\n \"\"\"\n\n isLoaded(self) -> bool\n\n If the clip is an external reference, returns whether the clip's\n data has been loaded from disk.\n\n\n \"\"\"\n def loadFromFile(self) -> None:\n \"\"\"\n\n loadFromFile(self)\n\n Explicitly loads the clip's data from disk if it is an external\n reference that is delay loaded. Raises hou.OperationFailed if the\n file does not exist or otherwise cannot be loaded.\n\n Calling any methods that require access to the clip's data will also\n cause the clip to be loaded, but this method can be used to report\n errors immediately.\n\n\n \"\"\"\n def length(self) -> float:\n \"\"\"\n\n length(self) -> float\n\n Returns the length (in seconds) of the clip.\n\n\n \"\"\"\n def startTime(self) -> float:\n \"\"\"\n\n startTime(self) -> float\n\n Returns the start time of the clip (in seconds).\n\n\n \"\"\"\n def sampleCount(self) -> int:\n \"\"\"\n\n sampleCount(self) -> int\n\n Returns the number of samples in the clip.\n\n\n \"\"\"\n def sampleRate(self) -> float:\n \"\"\"\n\n sampleRate(self) -> float\n\n Returns the sample rate of the clip.\n\n\n \"\"\"\n def addChannel(self, name: str, samples: Sequence[float]) -> None:\n \"\"\"\n\n addChannel(self, name, samples)\n\n Creates an additional channel in the clip. If a channel already\n exists with the same name, the previous samples will be overwritten.\n\n Raises hou.GeometryPermissionError if the clip is not modifiable.\n\n\n name\n The name of the channel.\n\n `samples\n A float sequence containing the channel's data. Raises\n hou.InvalidSize if the length does not match\n hou.AgentClip.sampleCount.\n\n\n \"\"\"\n def sampleLocal(self, time: float, transform: int) -> Matrix4:\n \"\"\"\n\n sampleLocal(self, time, transform) -> hou.Matrix4\n\n\n time\n The time (in seconds) to evaluate the clip at.\n\n transform\n Index of a transform in the agent's rig.\n\n Evaluates the clip at the given time and returns the local\n transform.\n\n\n \"\"\"\n def sampleWorld(self, time: float, transform: int) -> Matrix4:\n \"\"\"\n\n sampleWorld(self, time, transform) -> hou.Matrix4\n\n\n time\n The time (in seconds) to evaluate the clip at.\n\n transform\n Index of a transform in the agent's rig.\n\n Evaluates the clip at the given time and returns the world\n transform.\n\n\n \"\"\"\n def localTransforms(self, sample: int) -> Tuple[Matrix4, ...]:\n \"\"\"\n\n localTransforms(self, sample) -> tuple of hou.Matrix4\n\n Returns the local space transforms for the specified sample. The\n number of entries matches hou.AgentRig.transformCount.\n\n\n sample\n Index of a sample in the clip.\n\n\n \"\"\"\n def worldTransforms(self, sample: int) -> Tuple[Matrix4, ...]:\n \"\"\"\n\n worldTransforms(self, sample) -> tuple of hou.Matrix4\n\n Returns the world space transforms for the specified sample. The\n number of entries matches hou.AgentRig.transformCount.\n\n\n sample\n Index of a sample in the clip.\n\n\n \"\"\"\n def allLocalTransformValues(self) -> Tuple[float, ...]:\n \"\"\"\n\n allLocalTransformValues(self) -> tuple of float\n\n Returns a flat tuple of floats containing the local transforms for\n all samples. This data layout can be convenient for manipulating the\n transforms with other Python libraries. The number of entries is 16\n * rig.transformCount() * clip.sampleCount().\n\n\n \"\"\"\n def setAllLocalTransformValues(self, values: Sequence[float]) -> None:\n \"\"\"\n\n setAllLocalTransformValues(self, values)\n\n Edits the local transforms for all samples in the clip from a flat\n sequence of floats.\n\n Raises hou.GeometryPermissionError if the clip is not modifiable.\n\n\n values\n A flat tuple of floats containing the local transforms for each\n sample. The length and data layout is expected to match\n hou.AgentClip.allLocalTransformValues. Raises hou.InvalidSize if\n the length is invalid.\n\n\n \"\"\"\n def setLocalTransforms(self, sample: int, xforms: typing.Iterable[Matrix4]) -> None:\n \"\"\"\n\n setLocalTransforms(self, sample, xforms)\n\n Edits the local transforms for a sample in the clip.\n\n Raises hou.GeometryPermissionError if the clip is not modifiable.\n\n\n sample\n Index of a sample in the clip.\n\n xforms\n A sequence of hou.Matrix4, with a local space transform for each\n joint in the rig. Raises hou.InvalidSize if the length does not\n match hou.AgentRig.transformCount.\n\n\n \"\"\"\n def sample(self, time: float, channel: str) -> float:\n \"\"\"\n\n sample(self, time, channel_name) -> float\n\n\n time\n The time (in seconds) to evaluate the clip at.\n\n channel_name\n Name of a channel in the clip. See hou.AgentClip.channelNames.\n\n Evaluates the clip at the given time and returns the value of the\n specified channel. For sampling the clip's transforms, use\n hou.AgentClip.sampleLocal or hou.AgentClip.sampleWorld.\n\n\n \"\"\"\n def channelNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n channelNames(self) -> tuple of str\n\n Returns the names of the additional (non-transform) channels in the\n clip. These channels can be sampled with hou.AgentClip.sample.\n\n\n \"\"\"\n def data(self, binary: bool, worldspace: bool = False) -> bytes:\n \"\"\"\n\n data(self, binary, worldspace = False) -> str for Python 2, bytes for\n Python 3\n\n Returns the clip data in ASCII or binary.\n\n The returned clip data is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n binary\n Specifies whether the clip data should be saved in ASCII (.clip)\n or binary (.bclip) format.\n\n worldspace\n Specifies whether the transform channels should be saved in\n local or world space.\n\n\n \"\"\"\n def extractLocomotion(self, cog_transform: int, cog_lookat_transform: int = -1, convert_inplace: bool = True, project_on_dominant_axis: bool = False) -> None:\n \"\"\"\n\n extractLocomotion(self, cog_transform, cog_lookat_transform=-1,\n convert_inplace=True, project_on_dominant_axis=False)\n\n Converts the animation to in-place and records the locomotion\n transform in the __locomotion__:[srt][xyz] channels.\n\n Raises hou.GeometryPermissionError if the clip is not modifiable.\n\n\n cog_transform\n Index of a transform in the agent's rig that controls the\n locomotion of the character (i.e. has the translation that moves\n it forward in space).\n\n cog_lookat_transform\n Optional index of a transform in the agent's rig, which is used\n to extract an overall rotation using the vector from the\n cog_transform to this transform.\n\n convert_inplace\n Specifies whether to convert the animation to an in-place clip\n in addition to recording the locomotion transform.\n\n project_on_dominant_axis\n Projects the locomotion translation along the dominant axis of\n motion in the XZ plane. If the clip will be used as an in-place\n clip in the crowd solver, this can help to maintain hip swaying\n in the motion.\n\n\n \"\"\"\n\nclass AgentDefinition:\n \"\"\"\n\n hou.AgentDefinition\n\n The shared data for an agent primitive.\n\n An agent definition includes a rig, shape library, layers, and clips,\n and can be shared between agent primitives. See Agent Primitives for\n more information.\n\n Since an agent definition is shared between copies of an agent primitive\n (such as agents in an upstream SOP's geometry), the definition returned\n by hou.Agent.definition is read-only. The hou.AgentDefinition.freeze\n method can be used to create a modifiable copy of an agent definition.\n\n RELATED\n\n * hou.crowds.findAgentDefinitions\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, rig: AgentRig, shapelib: AgentShapeLibrary) -> None:\n \"\"\"\n\n __init__(rig, shapelib)\n\n Creates a new (and modifiable) agent definition.\n\n\n rig\n The hou.AgentRig that the definition should reference.\n\n shapelib\n The hou.AgentShapeLibrary that the definition should reference.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def freeze(self, new_shapelib: Optional[AgentShapeLibrary] = None, new_rig: Optional[AgentRig] = None) -> AgentDefinition:\n \"\"\"\n\n freeze(self, new_shapelib = None, new_rig = None) -> hou.AgentDefinition\n\n Creates a modifiable copy of the agent definition. Use\n hou.Agent.setDefinition to change one or more agents to use the new\n agent definition.\n\n\n new_shapelib\n If specified, the copied agent definition and its layers will\n reference the new shape library.\n\n new_rig\n If specified, the copied agent definition (and its clips,\n layers, and transform groups) will reference the new rig.\n\n\n \"\"\"\n def rig(self) -> AgentRig:\n \"\"\"\n\n rig(self) -> hou.AgentRig\n\n Returns the agent definition's rig.\n\n\n \"\"\"\n def shapeLibrary(self) -> AgentShapeLibrary:\n \"\"\"\n\n shapeLibrary(self) -> hou.AgentShapeLibrary\n\n Returns the agent definition's shape library.\n\n\n \"\"\"\n def layers(self) -> Iterator[AgentLayer]:\n \"\"\"\n\n layers(self) -> tuple of hou.AgentLayer\n\n Returns a list of the layers in the agent definition.\n\n\n \"\"\"\n def findLayer(self, name: str) -> Optional[AgentLayer]:\n \"\"\"\n\n findLayer(self, name) -> hou.AgentLayer\n\n Finds the layer with the specified name, or None if no such layer\n exists.\n\n\n \"\"\"\n def clips(self) -> Iterator[AgentClip]:\n \"\"\"\n\n clips(self) -> tuple of hou.AgentClip\n\n Returns a list of the clips in the agent definition.\n\n\n \"\"\"\n def findClip(self, name: str) -> Optional[AgentClip]:\n \"\"\"\n\n findClip(self, name) -> hou.AgentClip\n\n Finds the clip with the specified name, or None if no such clip\n exists.\n\n\n \"\"\"\n def transformGroups(self) -> Iterator[AgentTransformGroup]:\n \"\"\"\n\n transformGroups(self) -> tuple of hou.AgentTransformGroup\n\n Returns a list of the transform groups in the agent definition.\n\n\n \"\"\"\n def findTransformGroup(self, name: str) -> Optional[AgentTransformGroup]:\n \"\"\"\n\n findTransformGroup(self, name) -> hou.AgentTransformGroup\n\n Finds the transform group with the specified name, or None if no\n such group exists.\n\n\n \"\"\"\n def addClip(self, clip: AgentClip) -> None:\n \"\"\"\n\n addClip(self, clip)\n\n Adds a clip to the agent definition.\n\n Raises hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n Raises hou.OperationFailed if the clip is associated with a\n different rig.\n\n\n clip\n A hou.AgentClip.\n\n\n \"\"\"\n def removeClip(self, name: str) -> None:\n \"\"\"\n\n removeClip(self, name)\n\n Removes a clip from the agent definition.\n\n Raises hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n\n name\n The name of the clip to remove.\n\n\n \"\"\"\n def addLayer(self, layer: AgentLayer) -> None:\n \"\"\"\n\n addLayer(self, layer)\n\n Adds a layer to the agent definition.\n\n Raises hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n Raises hou.OperationFailed if the layer is associated with a\n different rig or shape library.\n\n\n layer\n A hou.AgentLayer.\n\n\n \"\"\"\n def removeLayer(self, name: str) -> None:\n \"\"\"\n\n removeLayer(self, name)\n\n Removes a layer from the agent definition.\n\n Raises hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n\n name\n The name of the layer to remove.\n\n\n \"\"\"\n def addTransformGroup(self, group: AgentTransformGroup) -> None:\n \"\"\"\n\n addTransformGroup(self, group)\n\n Adds a transform group to the agent definition.\n\n Raises hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n Raises hou.OperationFailed if the group is associated with a\n different rig.\n\n\n group\n A hou.AgentTransformGroup.\n\n\n \"\"\"\n def removeTransformGroup(self, name: str) -> None:\n \"\"\"\n\n removeTransformGroup(self, name)\n\n Removes a transform group from the agent definition.\n\n Raises hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n\n name\n The name of the transform group to remove.\n\n\n \"\"\"\n def metadata(self) -> AgentMetadata:\n \"\"\"\n\n setMetadata(self, metadata)\n\n Replaces the agent definition's metadata. Raises\n hou.GeometryPermissionError if the agent definition is not\n modifiable.\n\n\n metadata\n A hou.AgentMetadata.\n\n\n \"\"\"\n def setMetadata(self, metadata: AgentMetadata) -> None: ...\n\nclass AgentLayer:\n \"\"\"\n\n hou.AgentLayer\n\n An agent's layer.\n\n See Agent Layers for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, rig: AgentRig, shapelib: AgentShapeLibrary, shape_bindings: Sequence[AgentShapeBinding], source_layer: AgentLayer|None = ...) -> None:\n \"\"\"\n\n __init__(name, rig, shapelib, shape_bindings, source_layer = None)\n\n Creates a new agent layer with the specified shape bindings.\n\n\n name\n The name of the new layer.\n\n rig\n The hou.AgentRig that the layer will be associated with.\n\n shapelib\n The hou.AgentShapeLibrary that the layer will be associated\n with.\n\n shape_bindings\n A list of shape bindings to add to the layer.\n\n source_layer\n Specifies an optional hou.AgentLayer to copy shape bindings\n from.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def asJSON(self) -> str:\n \"\"\"\n\n asJSON(self) -> str\n\n Returns a string containing the JSON that represents the layer.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of the layer.\n\n\n \"\"\"\n def fileName(self, expanded: bool = False) -> str:\n \"\"\"\n\n fileName(self, expanded = False) -> str\n\n If the layer is an external reference, returns the path to the file\n on disk.\n\n\n expanded\n Specifies whether to expand any variables in the path, such as\n $HIP.\n\n\n \"\"\"\n def bindings(self, transform: int|None = ...) -> Tuple[AgentShapeBinding,...]:\n \"\"\"\n\n bindings(self, transform = None) -> tuple of hou.AgentShapeBinding\n\n Returns the list of shape bindings in the layer.\n\n\n transform\n Index of a transform in the agent's rig. If specified, only the\n shape bindings attached to the specified transform will be\n returned.\n\n\n \"\"\"\n def staticBindings(self) -> Tuple[AgentShapeBinding, ...]:\n \"\"\"\n\n staticBindings(self) -> tuple of hou.AgentShapeBinding\n\n Returns the shape bindings in the layer which reference static\n shapes.\n\n\n \"\"\"\n def deformingBindings(self) -> Tuple[AgentShapeBinding, ...]:\n \"\"\"\n\n deformingBindings(self) -> tuple of hou.AgentShapeBinding\n\n Returns the shape bindings in the layer which reference deforming\n shapes.\n\n\n \"\"\"\n\nclass AgentMetadata:\n \"\"\"\n\n hou.AgentMetadata\n\n Stores metadata in an agent definition.\n\n The metadata contains a dictionary mapping strings to values, and can be\n used to store additional custom data in the agent definition.\n\n RELATED\n\n * hou.AgentDefinition\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, data: Mapping[str, Any]) -> None:\n \"\"\"\n\n __init__(data)\n\n Creates new metadata from the provided dictionary.\n\n\n data\n A dict mapping strings to values.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def freeze(self) -> AgentMetadata:\n \"\"\"\n\n freeze(self) -> hou.AgentMetadata\n\n Creates a modifiable copy of the metadata. The copy will not be\n marked as an external reference.\n\n\n \"\"\"\n def isReadOnly(self) -> bool:\n \"\"\"\n\n isReadOnly(self) -> bool\n\n Return a bool indicating whether the metadata is read-only.\n\n\n \"\"\"\n def asJSON(self) -> str:\n \"\"\"\n\n asJSON(self) -> str\n\n Returns a string containing the JSON representation of the metadata.\n\n\n \"\"\"\n def fileName(self, expanded: bool = False) -> str:\n \"\"\"\n\n fileName(self, expanded = False) -> str\n\n If the metadata is an external reference, returns the path to the\n file on disk.\n\n\n expanded\n Specifies whether to expand any variables in the path, such as\n $HIP.\n\n\n \"\"\"\n def data(self) -> dict[str, Any]:\n \"\"\"\n\n data(self) -> dict of str to value\n\n Returns the metadata dictionary.\n\n\n \"\"\"\n def setData(self, data: Mapping[str, Any]) -> None:\n \"\"\"\n\n setData(self, data)\n\n Replaces the metadata dictionary. Raises hou.GeometryPermissionError\n if the metadata is not modifiable.\n\n\n data\n A dict mapping strings to values.\n\n\n \"\"\"\n\nclass AgentRig:\n \"\"\"\n\n hou.AgentRig\n\n The rig of an agent primitive.\n\n See Crowd Agents for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, transform_names: Sequence[str], hierarchy: Sequence[int]) -> None:\n '''\n\n __init__(name, transform_names, hierarchy)\n\n Creates a new agent rig from the given transform hierarchy.\n\n\n name\n The name of the new rig.\n\n transform_names\n A sequence of transform names.\n\n hierarchy\n A sequence of int sequences that specifies, for each transform\n in transform_names, the indices of its children in\n transform_names. See hou.AgentRig.transformHierarchy.\n\n The following example shows how to create a simple rig where\n transforms b and c are children of transform a.\n\n > transforms = [\\\\\"a\\\\\", \\\\\"b\\\\\", \\\\\"c\\\\\"]\n > hierarchy = [ [1, 2], [], [] ]\n > rig = hou.AgentRig(\\\\\"my_rig\\\\\", transforms, hierarchy)\n\n '''\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def freeze(self) -> AgentRig:\n \"\"\"\n\n freeze(self) -> hou.AgentRig\n\n Creates a modifiable copy of the rig. The copy will not be marked as\n an external reference.\n\n\n \"\"\"\n def asJSON(self) -> str:\n \"\"\"\n\n asJSON(self) -> str\n\n Returns a string containing the JSON that represents the rig.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name or filename of the rig.\n\n\n \"\"\"\n def fileName(self, expanded: bool = False) -> str:\n \"\"\"\n\n fileName(self, expanded = False) -> str\n\n If the rig is an external reference, returns the path to the file on\n disk.\n\n\n expanded\n Specifies whether to expand any variables in the path, such as\n $HIP.\n\n\n \"\"\"\n def transformCount(self) -> int:\n \"\"\"\n\n transformCount(self) -> int\n\n Returns the number of transforms in the rig.\n\n\n \"\"\"\n def transformName(self, i: int) -> str:\n \"\"\"\n\n transformName(self, transform) -> str\n\n Returns the name of the specified transform.\n\n\n transform\n Index of a transform in the rig.\n\n\n \"\"\"\n def findTransform(self, transform_name: str) -> int:\n \"\"\"\n\n findTransform(self, transform_name) -> int\n\n Returns the index of the transform with the given name, or -1 if the\n transform name is invalid.\n\n\n transform_name\n Name of a transform in the rig.\n\n\n \"\"\"\n def parentIndex(self, transform: int) -> int:\n \"\"\"\n\n parentIndex(self, transform) -> int\n\n Returns the parent of the specified transform, or -1 if the\n transform is a root of the transform hierarchy.\n\n\n transform\n Index of a transform in the rig.\n\n\n \"\"\"\n def childIndices(self, transform: int) -> Tuple[int, ...]:\n \"\"\"\n\n childIndices(self, transform) -> tuple of int\n\n Returns the children of the specified transform.\n\n\n transform\n Index of a transform in the rig.\n\n\n \"\"\"\n def setRestLocalTransforms(self, xforms: typing.Iterable[Matrix4]) -> None:\n \"\"\"\n\n setRestLocalTransforms(self, xforms)\n\n Sets the local space rest transforms for the rig.\n\n Raises hou.GeometryPermissionError if the rig is not modifiable.\n\n\n xforms\n A sequence of hou.Matrix4, with a local space transform for each\n joint in the rig. Raises hou.InvalidSize if the length does not\n match hou.AgentRig.transformCount.\n\n\n \"\"\"\n def restLocalTransform(self, i: int) -> Matrix4:\n \"\"\"\n\n restLocalTransform(self, transform) -> hou.Matrix4\n\n Returns the local space rest transform for the specified index in\n the hierarchy.\n\n\n transform\n Index of a transform in the rig.\n\n\n \"\"\"\n def restWorldTransform(self, i: int) -> Matrix4:\n \"\"\"\n\n restWorldTransform(self, transform) -> hou.Matrix4\n\n Returns the world space rest transform for the specified index in\n the hierarchy.\n\n\n transform\n Index of a transform in the rig.\n\n\n \"\"\"\n def channelCount(self) -> int:\n \"\"\"\n\n channelCount(self) -> int\n\n Returns the number of channels in the rig.\n\n\n \"\"\"\n def channelName(self, i: int) -> str:\n \"\"\"\n\n channelName(self, channel_index) -> str\n\n Returns the name of the specified channel.\n\n\n channel_index\n Index of a channel in the rig.\n\n\n \"\"\"\n def channelDefaultValue(self, i: int) -> float:\n \"\"\"\n\n channelDefaultValue(self, channel_index) -> float\n\n Returns the default value of the specified channel.\n\n\n channel_index\n Index of a channel in the rig.\n\n\n \"\"\"\n def channelTransform(self, i: int) -> int:\n \"\"\"\n\n channelTransform(self, channel_index) -> int\n\n Returns the transform index that the specified channel is associated\n with, or -1.\n\n\n channel_index\n Index of a channel in the rig.\n\n\n \"\"\"\n def findChannel(self, channel_name: str) -> int:\n \"\"\"\n\n findChannel(self, channel_name) -> int\n\n Returns the index of the channel with the given name, or -1 if the\n channel name is invalid.\n\n\n channel_name\n Name of a channel in the rig.\n\n\n \"\"\"\n def addChannel(self, name: str, default_value: float = 0.0, transform: int = -1) -> None:\n \"\"\"\n\n addChannel(self, name, default_value=0.0, transform=-1)\n\n Adds a new channel to the rig. If a channel already exists with the\n same name, properties such as the default value will be overwritten.\n\n Raises hou.GeometryPermissionError if the rig is not modifiable.\n\n\n name\n The name of the channel.\n\n `default_value\n A float containing the channel's default value.\n\n `transform\n Optional index of a transform that the channel is associated\n with.\n\n\n \"\"\"\n\nclass AgentShape:\n \"\"\"\n\n hou.AgentShape\n\n An agent's shape.\n\n See Crowd Agents for more information.\n\n RELATED\n\n * hou.AgentShapeBinding\n\n * hou.AgentShapeLibrary\n\n * hou.crowds.addBlendshapeInputs\n\n * hou.crowds.addInBetweenShapes\n\n * hou.crowds.setBlendshapeDeformerParms\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the shape's name, which is unique within a shape library.\n\n\n \"\"\"\n def uniqueId(self) -> int:\n \"\"\"\n\n uniqueId(self) -> int\n\n Returns the shape's globally unique id.\n\n\n \"\"\"\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self) -> hou.Geometry\n\n Returns the shape's geometry.\n\n\n \"\"\"\n def freeze(self) -> AgentShape:\n \"\"\"\n\n freeze(self) -> hou.AgentShape\n\n Creates a new modifiable copy of the shape. Raises\n hou.GeometryPermissionError if the shape library is not modifiable.\n\n\n \"\"\"\n def setGeometry(self, geometry: Geometry) -> None:\n \"\"\"\n\n setGeometry(self, geometry)\n\n Replaces the shape's geometry. Raises hou.GeometryPermissionError if\n the shape is not modifiable.\n\n\n geometry\n A hou.Geometry containing the shape's new geometry.\n\n\n \"\"\"\n\nclass AgentShapeBinding:\n \"\"\"\n\n hou.AgentShapeBinding\n\n A shape binding in an agent's layer.\n\n A shape binding attaches a shape from the agent's shape library to a\n transform in the agent's rig. See Agent Layers for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, shape: AgentShape, deformer: AgentShapeDeformer, bounds_scale: float = ...) -> None:\n \"\"\"\n\n __init__(shape, deformer, bounds_scale = 1.0)\n\n Creates a new shape binding, where the shape is not attached to a\n transform in the agent's rig. This can be useful for deforming\n shapes, which are deformed based on their capture attributes and the\n agent's current pose.\n\n\n shape\n A shape in the agent's shape library.\n\n deformer\n Specifies the hou.AgentShapeDeformer that should be used to\n deform the shape. A value of None will produce a static shape\n binding.\n\n bounds_scale\n Scale factor for the shape's bounding box. This can be a single\n float (for a uniform scale) or a hou.Vector3.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def shapeName(self) -> str:\n \"\"\"\n\n shapeName(self) -> str\n\n Returns the name of the shape. This is equivalent to shape().name().\n\n\n \"\"\"\n def shapeId(self) -> int:\n \"\"\"\n\n shapeId(self) -> int\n\n Returns the unique id of the shape. This is equivalent to\n shape().uniqueId().\n\n\n \"\"\"\n def transformId(self) -> int:\n \"\"\"\n\n transformId(self) -> int\n\n Returns the index of the transform in the agent's rig that the shape\n is attached to.\n\n\n \"\"\"\n def isDeforming(self) -> bool:\n \"\"\"\n\n isDeforming(self) -> bool\n\n Returns whether the shape is static or deforming.\n\n\n \"\"\"\n def boundsScale(self) -> Vector3:\n \"\"\"\n\n boundsScale(self) -> hou.Vector3\n\n Returns the scale factor for the shape's bounding box.\n\n\n \"\"\"\n def shape(self) -> AgentShape:\n \"\"\"\n\n shape(self) -> hou.AgentShape\n\n Returns the referenced shape.\n\n\n \"\"\"\n def deformer(self) -> AgentShapeDeformer:\n \"\"\"\n\n deformer(self) -> hou.AgentShapeDeformer\n\n Returns the deformer used for the shape, or None if the shape\n binding is static.\n\n\n \"\"\"\n\nclass AgentShapeDeformer:\n \"\"\"\n\n hou.AgentShapeDeformer\n\n A deformer for agent shapes.\n\n Agent shape deformers are used to provide different deformation methods\n for shapes, such as linear skinning or dual quaternion skinning. Each\n shape binding can specify the deformer that should be used. The\n hou.crowds.shapeDeformers method provides a list of the available\n deformers.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str|EnumValue) -> None:\n \"\"\"\n\n __init__(name)\n\n Creates a new deformer instance from the specified unique name.\n Raises hou.OperationFailed if there is not a registered deformer\n with this name.\n\n When using the built-in shape deformers, it is preferable to use the\n constructor that accepts a hou.agentShapeDeformerType. However, this\n constructor can be used with custom shape deformers that were\n registered via the HDK.\n\n hou.crowds.shapeDeformers provides a list of the registered\n deformers.\n\n\n name\n The unique name of the deformer (e.g. linearskinning).\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the unique name for the deformer.\n\n\n \"\"\"\n\nclass AgentShapeLibrary:\n \"\"\"\n\n hou.AgentShapeLibrary\n\n The shape library of an agent primitive.\n\n See Crowd Agents for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, filename: str, keep_external_ref: bool = ...) -> None:\n \"\"\"\n\n __init__(filename, keep_external_ref = True)\n\n Creates a new agent shape library by loading it from the specified\n geometry file.\n\n Raises hou.OperationFailed if the file does not exist or otherwise\n cannot be loaded.\n\n\n filename\n A path to a geometry file.\n\n keep_external_ref\n A bool indicating whether the external reference should be\n maintained when the agent is saved to a geometry file. If the\n reference is maintained, then the shape library file needs to be\n available when the saved geometry is used (only the path to the\n shape library is saved in the geometry file). Otherwise, a copy\n of the shape library will be inlined when saving out the\n geometry so that the original shape library file is no longer\n needed.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def freeze(self, keep_external_ref: bool = False) -> AgentShapeLibrary:\n \"\"\"\n\n freeze(self, keep_external_ref = False) -> hou.AgentShapeLibrary\n\n Creates a modifiable copy of the shape library.\n\n\n keep_external_ref\n If the original shape library referenced a file on disk,\n specifies whether the new shape library should be marked as\n including the original library. In this situation, saving out\n the new shape library will only write out shapes that were not\n included from the original library, along with the path to the\n included shape library. Otherwise, saving out the new shape\n library will produce a standalone library containing all of the\n shapes.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name or filename of the shape library.\n\n\n \"\"\"\n def fileName(self, expanded: bool = False) -> str:\n \"\"\"\n\n fileName(self, expanded = False) -> str\n\n If the shape library is an external reference, returns the path to\n the file on disk.\n\n\n expanded\n Specifies whether to expand any variables in the path, such as\n $HIP.\n\n\n \"\"\"\n def findShape(self, name: str) -> Optional[AgentShape]:\n \"\"\"\n\n findShape(self, shape_name) -> hou.AgentShape\n\n Finds the shape with the specified name, or None if no such shape\n exists.\n\n\n \"\"\"\n def shapes(self) -> Tuple[AgentShape, ...]:\n \"\"\"\n\n shapes(self) -> tuple of hou.AgentShape\n\n Returns a list of all shapes in the shape library.\n\n\n \"\"\"\n def data(self) -> Geometry:\n \"\"\"\n\n data(self) -> hou.Geometry\n\n Returns the geometry representation of the shape library, which can\n be saved to disk.\n\n\n \"\"\"\n def addShape(self, name: str, geometry: Geometry) -> AgentShape:\n \"\"\"\n\n addShape(self, name, geometry) -> hou.AgentShape\n\n Adds a new shape to the shape library.\n\n Raises hou.GeometryPermissionError if the shape library is not\n modifiable.\n\n\n name\n The name for the new shape.\n\n geometry\n A hou.Geometry containing the shape's geometry.\n\n\n \"\"\"\n\nclass AgentTransformGroup:\n \"\"\"\n\n hou.AgentTransformGroup\n\n A group of transforms and channels in an agent's rig.\n\n See Crowd Agents for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, transforms: Sequence[int], rig: AgentRig, weights: Sequence[float], channels: Sequence[int]) -> None:\n \"\"\"\n\n __init__(name, transforms, rig, weights, channels)\n\n Creates a new transform group containing the specified transforms\n and channels.\n\n\n name\n The name of the new transform group.\n\n transforms\n An int sequence containing the index of each transform in the\n group.\n\n rig\n The hou.AgentRig that the group will be associated with.\n\n weights\n A float sequence specifying the weight (between 0 and 1) of each\n transform in the group.\n\n channels\n An int sequence containing the index of each channel in the\n group.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def asJSON(self) -> str:\n \"\"\"\n\n asJSON(self) -> str\n\n Returns a string containing the JSON representation of the group.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of the transform group.\n\n\n \"\"\"\n def fileName(self, expanded: bool = False) -> str:\n \"\"\"\n\n fileName(self, expanded = False) -> str\n\n If the transform group is an external reference, returns the path to\n the file on disk.\n\n\n expanded\n Specifies whether to expand any variables in the path, such as\n $HIP.\n\n\n \"\"\"\n def transformIndices(self) -> Tuple[int, ...]:\n \"\"\"\n\n transformIndices(self) -> tuple of int\n\n Returns a list containing the index of each transform in the group.\n\n\n \"\"\"\n def weights(self) -> Tuple[float, ...]:\n \"\"\"\n\n weights(self) -> tuple of float\n\n Returns a list containing the weight of each transform in the group.\n\n\n \"\"\"\n def channelIndices(self) -> Tuple[int, ...]:\n \"\"\"\n\n channelIndices(self) -> tuple of int\n\n Returns a list containing the index of each channel in the group.\n\n\n \"\"\"\n\nclass anim:\n \"\"\"\n\n hou.anim\n\n Module which contains functions for working with animation utilities.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def bookmarks() -> Tuple[Bookmark, ...]:\n \"\"\"\n\n bookmarks() -> tuple of hou.Bookmarks\n\n Returns a tuple of current hou.Bookmarks, sorted by start time.\n\n\n \"\"\"\n @staticmethod\n def saveBookmarks(filename: str, bookmarks: Sequence[Bookmark]|None = ..., include_temporary: bool = ...) -> bool:\n \"\"\"\n\n saveBookmarks(filename, bookmarks=None, include_temporary=False) -> bool\n\n Saves a provided list of hou.Bookmark objects to the given json\n file. If the second argument is left empty, the list of current\n bookmarks will be saved instead. Returns True on success, or False\n otherwise.\n\n\n filename\n Name of the file to export the bookmarks to. It should have\n either a .json or .otio extension.\n\n bookmarks\n If provided, only the given bookmarks will be saved instead of\n saving all bookmarks.\n\n include_temporary\n Whether or not bookmarks marked as temporary should be included\n in the saved file. False by default. See\n hou.Bookmark.setTemporary.\n\n\n \"\"\"\n @staticmethod\n def loadBookmarks(filename: str, remove_existing: bool = True) -> bool:\n \"\"\"\n\n loadBookmarks(filename, remove_existing=True) -> bool\n\n Loads the list of bookmarks from the given file, returning True on\n success or False otherwise. Note that any existing hou.Bookmark\n objects will be invalid.\n\n\n filename\n Name of the file to load the bookmarks from. It should have\n either a .json or .otio extension.\n\n remove_existing\n Whether or not to remove existing bookmarks before loading the\n new ones.\n\n\n \"\"\"\n @staticmethod\n def saveBookmarksToString(bookmarks: Sequence[Bookmark]|None = ..., include_temporary: bool = ..., binary: bool = ...) -> bytes:\n \"\"\"\n\n saveBookmarksToString(bookmarks=None, include_temporary=False,\n binary=True) -> bytes\n\n Returns the data for the bookmarks as ASCII or binary, depending on\n the binary argument.\n\n\n bookmarks\n If provided, only the given bookmarks will be saved instead of\n saving all bookmarks.\n\n include_temporary\n Whether or not bookmarks marked as temporary should be included\n in the saved file. False by default. See\n hou.Bookmark.setTemporary.\n\n binary\n Whether to return the data string in ASCII or binary.\n\n\n \"\"\"\n @staticmethod\n def loadBookmarksFromString(data: bytes, remove_existing: bool = True) -> bool:\n \"\"\"\n\n loadBookmarksFromString(data, remove_existing=True)\n\n Loads the given bookmarks from the provided string.\n\n\n data\n ASCII or binary string returned by saveBookmarksToString.\n\n remove_existing\n Whether or not to remove existing bookmarks before loading the\n new ones.\n\n\n \"\"\"\n @staticmethod\n def clearBookmarks() -> None:\n \"\"\"\n\n clearBookmarks()\n\n Clears out all bookmarks. Note that any existing hou.Bookmark\n objects will be invalid.\n\n\n \"\"\"\n @staticmethod\n def newBookmark(name: str, start: float, end: float) -> Bookmark:\n \"\"\"\n\n newBookmark(name, start_frame, end_frame) -> hou.Bookmark\n\n Creates and returns a new hou.Bookmark object using the provided\n options. You must use this function to create new bookmarks; you\n cannot instantiate the Bookmark class directly.\n\n\n \"\"\"\n @staticmethod\n def bookmark(bookmark_id: int) -> Optional[Bookmark]:\n \"\"\"\n\n bookmark(session_id) -> hou.Bookmark\n\n Returns the hou.Bookmark with the matching session id, or returns\n None if there is no such bookmark.\n\n\n \"\"\"\n @staticmethod\n def getBookmark(bookmark_id: int) -> Optional[Bookmark]:\n \"\"\"\n\n getBookmark(session_id) -> hou.Bookmark\n\n This method is deprecated in favor of hou.anim.bookmark.\n\n Returns the hou.Bookmark with the matching session id, or returns\n None if there is no such bookmark.\n\n\n \"\"\"\n @staticmethod\n def removeBookmarks(bm: Sequence[Bookmark]) -> None:\n \"\"\"\n\n removeBookmarks(bookmarks)\n\n Deletes the given bookmarks and removes them from the list of active\n bookmarks. The bookmarks parameter should be a list of hou.Bookmark\n objects.\n\n\n \"\"\"\n @staticmethod\n def mergeGeometryChannels(collection_name: str, geometry: Geometry, channel_names: Sequence[str]|None = ...) -> None:\n \"\"\"\n\n mergeGeometryChannels(collection_name, geometry, channel_names=None)\n\n Writes geometry channels which were previously added to the channel\n list back into the provided geometry as channel primitives.\n\n\n collection_name\n Name of the collection from which to fetch the geometry\n channels.\n\n geometry\n Writeable geometry which the channel primitives will be written\n to.\n\n channel_names\n List of names of channels in the given collection to fetch. If\n not specified, all channels in the collection will be fetched.\n\n See also:\n\n * hou.ChannelList.addGeometryChannels\n\n * hou.ChannelList.addNodeGeometryChannels\n\n * hou.playbar.setChannelList\n\n\n \"\"\"\n @staticmethod\n def getGeometryChannels(collection_name: str, geometry: Geometry, channel_names: Sequence[str]|None = ...) -> None:\n \"\"\"\n\n getGeometryChannels(collection_name, geometry, channel_names=None)\n\n This method is deprecated in favor of\n hou.anim.mergeGeometryChannels.\n\n Writes geometry channels which were previously added to the channel\n list back into the provided geometry as channel primitives.\n\n\n collection_name\n Name of the collection from which to fetch the geometry\n channels.\n\n geometry\n Writeable geometry which the channel primitives will be written\n to.\n\n channel_names\n List of names of channels in the given collection to fetch. If\n not specified, all channels in the collection will be fetched.\n\n See also:\n\n * hou.ChannelList.addGeometryChannels\n\n * hou.ChannelList.addNodeGeometryChannels\n\n * hou.playbar.setChannelList\n\n\n \"\"\"\n @staticmethod\n def setGeometryChannels(collection_name: str, geometry: Geometry, channel_names: Sequence[str]) -> None:\n \"\"\"\n\n setGeometryChannels(collection_name, geometry, channel_names)\n\n Updates an existing scoped geometry channels collection with\n channels from the specified geometry. If channels with conflicting\n names already exist in the geometry, they will be overwritten.\n\n\n collection_name\n Name of the collection which the given channels will be added\n to.\n\n geometry\n Geometry from which to fetch the new channel primitives from.\n\n channel_names\n List of names of channels to add to the collection. If empty,\n all channels in the geometry will be added.\n\n\n \"\"\"\n @staticmethod\n def setGeometryChannelsFromPattern(collection_name: str, geometry: Geometry, pattern: str) -> None:\n \"\"\"\n\n setGeometryChannelsFromPattern(collection_name, geometry, pattern)\n\n Updates an existing scoped geometry channels collection with\n channels from the specified geometry. If channels with conflicting\n names already exist in the geometry, they will be overwritten.\n\n\n collection_name\n Name of the collection which the given channels will be added\n to.\n\n geometry\n Geometry from which to fetch the new channel primitives from.\n\n pattern\n Pattern string, of channel primitives to add to the collection.\n\n\n \"\"\"\n @staticmethod\n def setGeometryChannelPending(collection_name: str, channel_name: str, value: Optional[float]) -> None:\n \"\"\"\n\n setGeometryChannelPending(collection_name, channel_name, value)\n\n Sets the value of the scoped geometry channel at the current frame\n and marks it as pending.\n\n\n collection_name\n Name of the collection which the channel belongs to.\n\n channel_name\n Name of the channel to modify.\n\n value\n Pending value to set at the current frame. If None, any pending\n keys for the channel will be cleared.\n\n\n \"\"\"\n @staticmethod\n def isGeometryChannelPending(collection_name: str, channel_name: str) -> bool:\n \"\"\"\n\n isGeometryChannelPending(collection_name, channel_name)\n\n Returns whether or not a channel has a pending value.\n\n\n collection_name\n Name of the collection which the channel belongs to.\n\n channel_name\n Name of the channel.\n\n\n \"\"\"\n @staticmethod\n def isGeometryChannelPinned(collection_name: str, channel_names: str|None = ...) -> bool:\n \"\"\"\n\n isGeometryChannelPinned(collection_name, channel_name=None) -> bool\n\n Returns whether or not a geometry channel is pinned. If the second\n argument is left empty, returns whether or not all channels in the\n collection are pinned.\n\n\n collection_name\n Name of the collection which the channel belongs to.\n\n channel_name\n Name of the channel.\n\n\n \"\"\"\n @staticmethod\n def pinnedGeometryChannels(collection_name: str) -> Tuple[str, ...]:\n \"\"\"\n\n pinnedGeometryChannels(collection_name)\n\n Returns a list of all pinned geometry channels in the provided\n collection.\n\n\n collection_name\n Name of the collection.\n\n\n \"\"\"\n @staticmethod\n def getPinnedGeometryChannels(collection_name: str) -> Tuple[str, ...]:\n \"\"\"\n\n getPinnedGeometryChannels(collection_name)\n\n This method is deprecated in favor of\n hou.anim.pinnedGeometryChannels.\n\n Returns a list of all pinned geometry channels in the provided\n collection.\n\n\n collection_name\n Name of the collection.\n\n\n \"\"\"\n @staticmethod\n def lockGeometryChannelCollection(collection_name: str, lock: bool) -> None:\n \"\"\"\n\n lockGeometryChannelCollection(collection_name, lock)\n\n Locks or unlocks a geometry channel collection, by preventing\n editing of its channels.\n\n\n collection_name\n Name of the collection to modify\n\n lock\n Whether to lock or unlock the collection.\n\n\n \"\"\"\n @staticmethod\n def addBookmarksChangedCallback(callback: Callable) -> None:\n \"\"\"\n\n addBookmarksChangedCallback(callback)\n\n Registers a callback function to be executed whenever the current\n bookmarks are modified.\n\n\n \"\"\"\n @staticmethod\n def removeBookmarksChangedCallback(callback: Callable) -> None:\n \"\"\"\n\n removeBookmarksChangedCallback(callback)\n\n Removes an existing callback.\n\n\n \"\"\"\n @staticmethod\n def addGeometryChannelsChangedCallback(collection_name: str, callback: Callable, on_mouse_up: bool = ...) -> bool:\n \"\"\"\n\n addGeometryChannelsChangedCallback(collection_name, callback,\n on_mouse_up=True)\n\n Registers a callback function to be executed whenever geometry\n channels in the given collection are modified. The collection must\n have already been added to the channel list with\n hou.playbar.setChannelList.\n\n\n collection_name\n Name of the collection from which to listen for changes.\n\n callback\n Callback function, accepting two parameters, a tuple of the\n names of geometry channels that have been changed, and the\n collection name.\n\n on_mouse_up\n When modifying geometry channels in the Channel Editor, whether\n this callback should be triggered only on mouse up, or\n continuously as channels are modified. Defaults to True, for\n only on mouse up.\n\n See also:\n\n * hou.ChannelList.addGeometryChannels\n\n * hou.ChannelList.addNodeGeometryChannels\n\n * hou.playbar.setChannelList\n\n\n \"\"\"\n @staticmethod\n def removeGeometryChannelsChangedCallback(collection_name: str, callback: Callable, on_mouse_up: bool = ...) -> bool:\n \"\"\"\n\n removeGeometryChannelsChangedCallback(collection_name, callback,\n on_mouse_up=True)\n\n Removes an existing callback from the given geometry channels\n collection.\n\n\n collection_name\n Name of the collection from which to remove a callback.\n\n callback\n Callback function to remove.\n\n on_mouse_up\n Whether the callback to remove was registered for mouse up\n events or not. Must match the same value passed in when\n originally registering the callback with\n addGeometryChannelsChangedCallback.\n\n\n \"\"\"\n @staticmethod\n def slopeMode() -> EnumValue:\n \"\"\"\n\n slopeMode(self) -> hou.slopeMode\n\n Returns the current slope mode for inserting new keys, auto or\n manual.\n\n\n \"\"\"\n @staticmethod\n def setSlopeMode(mode: EnumValue) -> None:\n \"\"\"\n\n setSlopeMode(self, mode)\n\n Set the default slope mode to one of the following:\n\n * hou.slopeMode.Manual: Newly inserted keys will be set to manual\n slope mode.\n\n * hou.slopeMode.Automatic: Newly inserted keys will be set to\n automatic slope mode.\n\n\n \"\"\"\n\nclass AnimBar:\n \"\"\"\n\n hou.AnimBar\n\n The animation toolbar lives above the playbar or at the bottom of the\n animation editor, and consists of simple slider tools for easily\n manipulating animation curves.\n\n You cannot instantiate this object directly. Call hou.playbar.animBar or\n hou.ChannelEditorPane.animBar instead.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def tools(self, shown_only: bool = True) -> Tuple[str, ...]:\n \"\"\"\n\n tools(self, shown_only: bool=True) -> tuple\n\n Returns a tuple of strings consisting of the ids of the tools\n currently present on the animation toolbar. If shown_only is set to\n False, will instead return the ids of all tools, including those\n that have been removed from the toolbar.\n\n\n \"\"\"\n def hiddenTools(self) -> Tuple[str, ...]:\n \"\"\"\n\n hiddenTools(self) -> tuple\n\n Returns a tuple of strings consisting of the ids of the tools that\n have been removed from the animation toolbar.\n\n\n \"\"\"\n def setTools(self, tool_ids: Sequence[str]) -> None:\n \"\"\"\n\n setTools(self, tool_ids: tuple)\n\n Sets the active tools on the animation toolbar, replacing the\n previously active tools.\n\n tool_ids is a tuple of strings consisting of the ids of the tools to\n be set.\n\n\n \"\"\"\n def removeTool(self, id: str) -> None:\n \"\"\"\n\n removeTool(self, id: str)\n\n Removes a tool with the given id from the animation toolbar.\n\n\n \"\"\"\n def addTool(self, id: str, index: int = -1) -> None:\n \"\"\"\n\n addTool(self, id: str, index: int=-1)\n\n Adds the tool with the given id to the animation toolbar, if it is\n not already present.\n\n id is the id of the tool to add.\n\n index is an optional argument specifying the position at which to\n add the tool. If not provided, the tool is added at the end of the\n toolbar.\n\n\n \"\"\"\n def reset(self) -> None:\n \"\"\"\n\n reset(self)\n\n Resets the animation toolbar, adding back all removed tools and\n placing them back in their original order.\n\n\n \"\"\"\n def showLabels(self, show: bool) -> None:\n \"\"\"\n\n showLabels(self, show: bool)\n\n Shows or hides the labels that are displayed below each tool.\n\n\n \"\"\"\n def labelsShown(self) -> bool:\n \"\"\"\n\n labelsShown(self) -> bool\n\n Returns whether or not full labels are currently displayed for each\n tool.\n\n\n \"\"\"\n def setToolSize(self, tool_size: EnumValue) -> None:\n \"\"\"\n\n setToolSize(self, size)\n\n Sets the size of the tools on the animation toolbar.\n\n size is a hou.animBarToolSize\n\n\n \"\"\"\n def toolSize(self) -> EnumValue:\n \"\"\"\n\n toolSize(self) -> hou.animBarToolSize\n\n Returns the current size of the tools on the animation toolbar.\n\n\n \"\"\"\n\nclass anonstats:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def recordOccurrence(key: str) -> None: ...\n @staticmethod\n def recordString(key: str, value: str) -> None: ...\n @staticmethod\n def hasString(key: str) -> bool: ...\n @staticmethod\n def getString(key: str) -> str: ...\n @staticmethod\n def incrementCount(key: str, count: int = 1) -> None: ...\n @staticmethod\n def logEvent(key: str, message: str) -> None: ...\n @staticmethod\n def addSum(key: str, stat_value: float, count: int = 1) -> None: ...\n\nclass AssetBrowser(PathBasedPaneTab):\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def reload(self) -> None: ...\n def installRequiredDefinitionsForNodeTypeName(self, node_type_name: str) -> None: ...\n def storeUpdateSessionKey(self, session_key: str) -> None: ...\n def updateAssetDownloadFraction(self, node_type_name: str, downloaded_bytes: int, total_bytes: int) -> None: ...\n def storeSyncSessionKey(self, session_key: str) -> None: ...\n\nclass AssetGalleryDataSource:\n \"\"\"\n\n hou.AssetGalleryDataSource\n\n Provides an interface to any data source that can be used in association\n with an asset or snapshot gallery UI.\n\n Houdini's various asset catalog panels (the snapshot gallery attached to\n the LOP Scene Viewer, the Working Set in the Layout LOP's brush panel,\n and the Asset Catalog pane) are all populated by pulling data from this\n class. This object is created by providing a source identifier, and an\n optional additional string argument. The source identifier is used to\n find or create a shared underlying data source implementation object\n (which may be a C++ or python object). These implementation objects are\n responsible for responding to the methods called on this object.\n\n Houdini ships with three data source implementations. One uses an SQL\n database with read and write capabilities. This data source\n implementation type is used when the source identifier is a file path\n with a .db, .sqlite, or .sqlite3 extension. Another supports any file on\n disk with a USD file extension. This data source is read only, and\n accepts an additional argument specifying the primitive pattern\n indicating which primitives in the USD file should be presented as\n assets. Finally, if the source identifier beings with an op: prefix\n followed by a path to a LOP node, the stage for that LOP node is used as\n a read only data source, and again the additional argument specifies a\n primitive pattern to indicate which primitives on the source stage\n represent assets.\n\n To create a new data source implementation in C++, you must create a\n subclass of UT_GalleryDataSourceImpl (see UT_GalleryDataSource.h), and\n register it by calling\n UT_GalleryDataSource::registerDataSourceImplementation. To create a new\n data source implementation in python, create a subclass of the\n DataSource object defined in the husd.datasource module, and place it in\n the $HFS/houdini/husdplugins/datasources directory. See the usdfile.py\n module for an example.\n\n The methods on this class almost always simply forward the call to the\n underlying data source implementation object. So the decription of each\n method here also serves to document the action an that should be\n undertaken in each correspondingly named method on an implementation\n class.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, source_identifier: str, args: Optional[str] = None) -> None:\n \"\"\"\n\n __init__(self, source_identifier, args=None) -> AssetGalleryDataSource\n\n Constructs or finds a matching existing data source implementation\n object based on the source_identifier and optional implementation-\n specific args parameter.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def isValid(self) -> bool:\n \"\"\"\n\n isValid(self) -> bool\n\n Return True if this data source has a valid implementation,\n otherwise return False. Returning False usually indicates that the\n source identifier does not represent an existing file or LOP node,\n or that the file type is not supported by any data source\n implementation classes.\n\n\n \"\"\"\n def isReadOnly(self) -> bool:\n \"\"\"\n\n isReadOnly(self) -> bool\n\n Return True if this data source only supports read operations,\n otherwise return False. A data source implementation that returns\n False for this method will never have any of its set methods called,\n and any attempts to call these methods on this object will\n immediately return False.\n\n\n \"\"\"\n def sourceIdentifier(self) -> str:\n \"\"\"\n\n sourceIdentifier(self) -> str\n\n Return the source identifier string used to create this data source\n object.\n\n\n \"\"\"\n def sourceArgs(self) -> str:\n \"\"\"\n\n sourceArgs(self) -> str\n\n Return the args string used to create this data source object.\n\n\n \"\"\"\n def infoHtml(self) -> str:\n \"\"\"\n\n infoHtml(self) -> str\n\n Return a string in HTML format that will be displayed at the top of\n the asset catalog window. Provides custom information about the data\n source. Can return an empty string to indicate that the HTML info\n window at the top of the gallery should be hidden.\n\n\n \"\"\"\n def startTransaction(self) -> None:\n \"\"\"\n\n startTransaction(self)\n\n For writable data sources, this method can be used to group multiple\n calls to edit the data source. Once this method is called, requests\n to edit the data source do not actually need to edit the underlying\n data source until the endTransaction method is called.\n\n\n \"\"\"\n def endTransaction(self, commit: bool = True) -> None:\n \"\"\"\n\n endTransaction(self, commit=True)\n\n This method is always called after a call to startTransaction, and\n indicates that the group of data source edits has been completed.\n When this method returns, all edits since the call to\n startTransaction should be committed to the data source. If the\n commit parameter is False, all edits since the call to\n startTransaction should be discarded, and none of them should be\n recorded to the data source.\n\n\n \"\"\"\n def itemIds(self) -> Tuple[str, ...]:\n \"\"\"\n\n itemIds(self) -> tuple of str\n\n Return a unique identifier for each asset available in the data\n source. The ids returned by this method will be used to identify\n individual assets in every other method that gets or sets\n information associated with a specific asset.\n\n\n \"\"\"\n def updatedItemIds(self) -> Tuple[str, ...]: ...\n def childItemIds(self, parent: str) -> Tuple[str, ...]:\n \"\"\"\n\n childItemIds(self, item_id) -> tuple of str\n\n Return a list of unique identifier for all assets that have this\n item set as its parent. Passing an empty string as the item_id will\n return a list of items that have the 'root' as their parent.\n\n\n \"\"\"\n def sourceTypeName(self, item_id: Optional[str] = None) -> str:\n \"\"\"\n\n sourceTypeName(self, item_id=None) -> str\n\n Return the data source type of the asset identified by the id. The\n source type controls how the asset is instantiated in a Houdini LOP\n Network. Generally all the assets from a data source will return the\n same sourceTypeName, which is why the item_id parameter here is\n optional. Only data sources that aggregate data from multiple other\n sources would return per-asset values from this method.\n\n\n \"\"\"\n def typeName(self, item_id: str) -> str:\n \"\"\"\n\n typeName(self, item_id) -> str\n\n Return the type of asset identied by the id. This will either be\n snapshot (for a snapshot in a snapshot gallery) or asset (for an\n asset in an asset catalog).\n\n\n \"\"\"\n def label(self, item_id: str) -> str:\n \"\"\"\n\n label(self, item_id) -> str\n\n Return the user-facing string that identifies and describes the\n item. This value need not be unique, and is normally displayed under\n the item's thumbnail image.\n\n\n \"\"\"\n def thumbnail(self, item_id: str) -> bytes:\n \"\"\"\n\n thumbnail(self, item_id) -> bytes\n\n Return the raw data for a thumbnail image that represents the item.\n\n\n \"\"\"\n def creationDate(self, item_id: str) -> int:\n \"\"\"\n\n creationDate(self, item_id) -> int\n\n Return a long integer representing the unix timestamp at which the\n item was created.\n\n\n \"\"\"\n def modificationDate(self, item_id: str) -> int:\n \"\"\"\n\n modificationDate(self, item_id) -> int\n\n Return a long integer representing the unix timestamp at which the\n item was last modified.\n\n\n \"\"\"\n def isStarred(self, item_id: str) -> bool:\n \"\"\"\n\n isStarred(self, item_id) -> bool\n\n Return True if this item has been marked as a favorite by the user.\n\n\n \"\"\"\n def colorTag(self, item_id: str) -> str:\n \"\"\"\n\n colorTag(self, item_id) -> str\n\n Return a string indicating a special color tag value that has been\n assigned by the user. These color strings are displayed as colored\n bars in the gallery browser UI. Supported values are blue, green,\n purple, yellow, teal, and red.\n\n\n \"\"\"\n def tags(self, item_id: str) -> Tuple[str, ...]:\n \"\"\"\n\n tags(self, item_id) -> tuple of str\n\n Return a tuple of user defined tag strings that have been assigned\n to this item.\n\n\n \"\"\"\n def filePath(self, item_id: str) -> str:\n \"\"\"\n\n filePath(self, item_id) -> str\n\n Return a string that can be used to access the raw data assocaited\n with this item. In the case of a snapshot, this will be path to the\n snapshot image file on disk. In the case of an asset, this will be\n the path to a USD file on disk or a string representing a path to\n the LOP node which defines this asset.\n\n\n \"\"\"\n def ownsFile(self, item_id: str) -> bool:\n \"\"\"\n\n ownsFile(self, item_id) -> bool\n\n Return True if the filePath for this item is a file on disk that\n should be deleted if the item is deleted. This is generally True for\n a snapshot image, but False for a USD asset file (though in a custom\n data source implementation, it may also be True for a USD asset).\n\n\n \"\"\"\n def blindData(self, item_id: str) -> bytes:\n \"\"\"\n\n blindData(self, item_id) -> bytes\n\n Return a block of data source implementation specific binary data\n associated with the item. For a snapshot item, this will be the\n binary representation of the contents of the LOP Network when the\n snapshot was taken. For a USD asset, this may be a string\n representing information needed to pull a specific primitive out of\n a USD file (such as the root primitive path and variant selections).\n This blind data on an asset can be used by the data source specific\n code for instantiating an asset in a LOP network.\n\n\n \"\"\"\n def status(self, item_id: str) -> str:\n \"\"\"\n\n status(self, item_id) -> str\n\n Return a string describing the current status of this item. This\n field is used for render gallery background renders to track when\n the render is running (render_active), has completed\n (render_complete), or there was an error while rendering (error).\n\n\n \"\"\"\n def parentId(self, item_id: str) -> str:\n \"\"\"\n\n parentId(self, item_id) -> str\n\n Return the unique identifier for this item's parent item. If this\n item has no parent then an empty string is returned. This also\n indicates that the item is at thr 'root' of the tree.\n\n\n \"\"\"\n def prepareItemForUse(self, item_id: str) -> str:\n \"\"\"\n\n prepareItemForUse(self, item_id) -> str\n\n Make sure that the item is ready to be used. For data sources that\n point to remote databases, this method may involve downloading the\n item's data. Return an empty string if the item is ready for use,\n otherwise return an error string describing why the item could not\n be prepared.\n\n\n \"\"\"\n def setLabel(self, item_id: str, label: str) -> bool:\n \"\"\"\n\n setLabel(self, item_id, label) -> bool\n\n Set the value of the label for this item. Return True if this call\n resulted in a change to this value.\n\n\n \"\"\"\n def setThumbnail(self, item_id: str, thumbnail: bytes) -> bool:\n \"\"\"\n\n setThumbnail(self, item_id, thumbnail) -> bool\n\n Set the value of the thumbnail for this item. Return True if this\n call resulted in a change to this value.\n\n\n \"\"\"\n def setModificationDate(self, item_id: str, timestamp: int) -> bool:\n \"\"\"\n\n setModificationDate(self, item_id, timestamp) -> bool\n\n Set the value of the modificationDate for this item. Return True if\n this call resulted in a change to this value.\n\n\n \"\"\"\n def setIsStarred(self, item_id: str, isstarred: bool) -> bool:\n \"\"\"\n\n setIsStarred(self, item_id, isstarred) -> bool\n\n Set the value of the isStarred flag for this item. Return True if\n this call resulted in a change to this value.\n\n\n \"\"\"\n def setColorTag(self, item_id: str, color_tag: str) -> bool:\n \"\"\"\n\n setColorTag(self, item_id, color_tag) -> bool\n\n Set the value of the colorTag for this item. Return True if this\n call resulted in a change to this value.\n\n\n \"\"\"\n def setMetadata(self, item_id: str, metadata: dict[str, Any]) -> bool:\n \"\"\"\n\n setMetadata(self, item_id, metadata) -> bool\n\n Set the value of the metadata dictionary for this item. Return True\n if this call resulted in a change to this value.\n\n\n \"\"\"\n def setFilePath(self, item_id: str, file_path: str) -> bool:\n \"\"\"\n\n setFilePath(self, item_id, file_path) -> bool\n\n Set the value of the filePath for this item. Return True if this\n call resulted in a change to this value.\n\n\n \"\"\"\n def setOwnsFile(self, item_id: str, owns_file: bool) -> bool:\n \"\"\"\n\n setOwnsFile(self, item_id, owns_file) -> bool\n\n Set the value of the ownsFile flag for this item. Return True if\n this call resulted in a change to this value.\n\n\n \"\"\"\n def setBlindData(self, item_id: str, data: bytes) -> bool:\n \"\"\"\n\n setBlindData(self, item_id, data) -> bool\n\n Set the value of the blindData for this item. Return True if this\n call resulted in a change to this value.\n\n\n \"\"\"\n def setParentId(self, item_id: str, parent_item_id: str) -> bool:\n \"\"\"\n\n setParentId(self, item_id, parent_item_id) -> bool\n\n Set the value of the parent of this item to be parent_item_id.\n Setting to an empty string indicates this item has no parent and is\n therefore at the root of the tree.\n\n\n \"\"\"\n def createTag(self, tag: str) -> bool:\n \"\"\"\n\n createTag(self, tag) -> bool\n\n Create a tag in the data source, but do not assign it to any items.\n Return True if the tag did not already exist and was created.\n\n\n \"\"\"\n def deleteTag(self, tag: str, delete_if_assigned: bool) -> bool:\n \"\"\"\n\n deleteTag(self, tag, delete_if_assigned) -> bool\n\n Delete a tag from the data source. Return True if the tag existed\n and was removed. If delete_if_assigned is False, and the tag is\n assigned to any item, this function will do nothing and return\n False. If delete_if_assigned is True and the tag is assigned to any\n items, the tag is first unassigned from those items, then the tag is\n deleted.\n\n\n \"\"\"\n def addTag(self, item_id: str, tag: str) -> bool:\n \"\"\"\n\n addTag(self, item_id, tag) -> bool\n\n Adds a tag to a specific item. Creates the tag if it does not\n already exist. Return True if the tag was added to the item. Return\n False if the tag was already assigned to the item.\n\n\n \"\"\"\n def removeTag(self, item_id: str, tag: str) -> bool:\n \"\"\"\n\n removeTag(self, item_id, tag) -> bool\n\n Removes a tag from a specific item. Return True if the tag was\n removed from the item. Return False if the tag was not assigned to\n the item.\n\n\n \"\"\"\n def generateItemFilePath(self, item_id: str, file_ext: str) -> str:\n \"\"\"\n\n generateItemFilePath(self, item_id, file_ext) -> str\n\n Return a unique file path with an extension provided in file_ext.\n This helpful is useful for creating external files such as snapshot\n images on disk, as it automatically puts the image in the same\n location as the database file.\n\n\n \"\"\"\n def addItem(self, label: str, file_path: str|None = ..., thumbnail: bytes = ..., type_name: str = ..., blind_data: bytes = ..., creation_date: int = ...) -> str:\n \"\"\"\n\n addItem(self, label, file_path=None, thumbnail=b'', type_name='asset',\n blind_data=b'', creation_date=0) -> str\n\n Adds a new item to the data source. Sets the label, filePath,\n thumbnail, typeName, blindData, and creationDate values for the\n item. Return the item_id of the newly created item, or an empty\n string if the item could not be added.\n\n\n \"\"\"\n def markItemsForDeletion(self, item_ids: Sequence[str]) -> bool:\n \"\"\"\n\n markItemsForDeletion(self, item_ids) -> bool\n\n Marks one or more items to be deleted. Ideally this deletion does\n not happen until the data source is destroyed, indicating that the\n user has switched data sources or shut down Houdini. By only marking\n the item for future deletion instead of deleting the items, it is\n possible to undo the deletion using the unmarkItemsForDeletion\n method. But while an item is marked for deletion, it should not be\n returned by the itemIds method, or return any values when queried by\n other methods. Return True if the items were successfully marked for\n deletion. If a data source cannot support undoing the deletion of an\n item, this method should delete the item and return True.\n\n\n \"\"\"\n def unmarkItemsForDeletion(self, item_ids: Sequence[str]) -> bool:\n \"\"\"\n\n unmarkItemsForDeletion(self, item_ids) -> bool\n\n Remove the indicator in the data source that the supplied items\n should be deleted. This is used to undo the requested deletion of an\n item. Return True if the specified items were successfully\n undeleted. If a data source doesn't support undoing the deletion of\n an item, return False.\n\n\n \"\"\"\n def saveAs(self, source_identifier: str) -> bool:\n \"\"\"\n\n saveAs(self, source_identifier) -> bool\n\n Create a copy of the data source, if supported. This will also\n create copies of the item files, if the ownsFile flag is True.\n\n\n \"\"\"\n def metadata(self, item_id: str) -> Any:\n \"\"\"\n\n metadata(self, item_id) -> dict of str to str or float\n\n Return a dictionary of metadata that has been associated with this\n item. This metadata may be user created, or automatically (such as\n by a renderer used to create an image in the snapshot gallery).\n\n\n \"\"\"\n\nclass Attrib:\n \"\"\"\n\n hou.Attrib\n\n This class stores information about a Geometry attribute.\n\n An attribute describes extra data you can attach to different elements\n of geometry. The attribute values are the individual instances of that\n data, and for each attribute there is exactly one attribute value per\n geometry element. For example, if you look at the points in Houdini's\n geometry spreadsheet, the point numbers are listed down the side, the\n point attributes are listed across the top, and the point attribute\n values are contained in the table.\n\n The attribute specifies which elements store the attribute values:\n points, primitives, or vertices. An attribute can also be global (also\n known as a detail attribute), in which case there is one instance of the\n attribute value in the geometry.\n\n The attribute also specifies the data type of the attribute values.\n\n To look up existing attributes, use hou.Geometry.findPointAttrib,\n hou.Geometry.findPrimAttrib, hou.Geometry.findVertexAttrib, and\n hou.Geometry.findGlobalAttrib. To add a new attribute, use\n hou.Geometry.addAttrib.\n\n\n NOTE\n Point positions are stored in a point attribute named P and point\n weights are stored in Pw. See hou.Point.position and\n hou.Point.weight for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Remove this attribute from the geometry. You would typically call\n this method from the code of a Python-defined SOP.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Raises hou.OperationFailed if you try to destroy the P or Pw point\n attributes.\n\n\n \"\"\"\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self) -> hou.Geometry\n\n Return the Geometry object containing this attribute.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the attribute's name. Each attribute in the geometry has a\n unique name.\n\n\n \"\"\"\n def dataType(self) -> EnumValue:\n \"\"\"\n\n dataType(self) -> hou.attribData enum value\n\n Return the attribute's data type (int, float or string).\n\n The size of the attribute also determines the format of the\n attribute values. For example, if the data type is int and the size\n is 3, the attribute value will be a tuple of 3 ints. If the size was\n 1, the attribute value would simply be an int.\n\n Note that a string attribute's size must be 1.\n\n\n \"\"\"\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.attribType enum value\n\n Return the type of attribute (point, primitive, vertex, or global).\n\n\n \"\"\"\n def isArrayType(self) -> bool:\n \"\"\"\n\n isArrayType(self) -> bool\n\n Return True if the attribute is a type that contains array data\n (i.e. Float Array, Integer Array, String Array) and False otherwise.\n\n\n \"\"\"\n def numericDataType(self) -> EnumValue:\n \"\"\"\n\n numericDataType(self) -> hou.numericData enum value\n\n Return the numeric (int, float) attribute's precision.\n\n\n \"\"\"\n def qualifier(self) -> str:\n \"\"\"\n\n qualifier(self) -> str\n\n Return the attribute's type qualifier. The qualifier is a\n description of the data contained in the attribute. An empty string\n is returned if the attribute has no numeric representation or if the\n attribute is the pseudo Pw point attribute.\n\n\n \"\"\"\n def size(self) -> int:\n \"\"\"\n\n size(self) -> int\n\n Return the number of data components in the attribute value. See\n hou.Attrib.dataType for more information.\n\n\n \"\"\"\n def setSize(self, size: int) -> None:\n \"\"\"\n\n setSize(self)\n\n Sets the number of data components in the attribute value. See\n hou.Attrib.dataType for more information.\n\n\n \"\"\"\n def isTransformedAsVector(self) -> bool: ...\n def isTransformedAsNormal(self) -> bool:\n \"\"\"\n\n isTransformedAsNormal(self) -> bool\n\n Return whether attribute values in the geometry are automatically\n transformed as a normal when Houdini transforms (e.g. rotates) the\n geometry.\n\n For more information, see the hou.Geometry.addAttrib, in the\n transform_as_normal parameter documentation.\n\n\n \"\"\"\n def boostAnyDefaultValue(self) -> Any: ...\n def stringCount(self) -> int:\n \"\"\"\n\n stringCount(self) -> int\n\n Returns the number of entries in the attribute's string table. If\n the attribute is not a string, 0 is returned.\n\n\n \"\"\"\n def strings(self) -> Tuple[str, ...]:\n '''\n\n strings(self) -> tuple of str\n\n Return the string table for this attribute. If the attribute is not\n a string, returns an empty tuple.\n\n A string attribute does not store each string value inside the\n attribute element (i.e. point, primitive, etc.). Instead, the unique\n string attribute values are stored in a table inside the attribute,\n and each attribute value stores an index to that string.\n\n For example, suppose this attribute stores strings on points. If all\n points have the attribute value \\\\\"foo\\\\\" then the string table will be\n just (\\\\\"foo\\\\\",) and each point will store the index 0. When you set\n some points\\' values to \\\\\"bar\\\\\", Houdini adds sets the string table to\n (\\\\\"foo\\\\\", \\\\\"bar\\\\\") and sets stores the index 1 in those points. When you\n set one of those points back to \\\\\"foo\\\\\", Houdini leaves the string\n table unchanged and stores the index 0 in that point.\n\n When using string attribute values, this implementation is hidden\n from you, and you get and set those attributes as strings. This\n method is provided only in case you need access to the string table.\n\n\n '''\n def replaceString(self, before: str, after: str) -> bool: ...\n def dictCount(self) -> int:\n \"\"\"\n\n dictCount(self) -> int\n\n Returns the number of entries in the attribute's dictionary table.\n If the attribute is not a dictionary, 0 is returned.\n\n\n \"\"\"\n def dicts(self) -> Tuple[dict[str, Any], ...]:\n '''\n\n dicts(self) -> tuple of dict\n\n Return the dictionary table for this attribute. If the attribute is\n not a dictionary, returns an empty tuple.\n\n A dictionary attribute does not store each dictionary value inside\n the attribute element (i.e. point, primitive, etc.). Instead, the\n unique dictionary attribute values are stored in a table inside the\n attribute, and each attribute value stores an index to that\n dictionary.\n\n For example, suppose this attribute stores dictionaries on points.\n If all points have the attribute value { \\\\\"foo\\\\\" : 1 } then the\n dictionary table will be just ({ \\\\\"foo\\\\\" : 1 },) and each point will\n store the index 0. When you set some points\\' values to { \\\\\"bar\\\\\" : 2},\n Houdini adds sets the dictionary table to ({\\\\\"foo\\\\\":1}, {\\\\\"bar\\\\\":2}) and\n sets stores the index 1 in those points. When you set one of those\n points back to {\\\\\"foo\\\\\":1}, Houdini leaves the dictionary table\n unchanged and stores the index 0 in that point.\n\n When using dictionary attribute values, this implementation is\n hidden from you, and you get and set those attributes as\n dictionaries. This method is provided only in case you need access\n to the dictionary table.\n\n\n '''\n def indexPairPropertyTables(self) -> Tuple[IndexPairPropertyTable, ...]:\n \"\"\"\n\n indexPairPropertyTables(self) -> tuple of hou.IndexPairPropertyTable\n\n Return the property tables for this attribute. If the attribute is\n not an index pair, returns an empty tuple.\n\n\n \"\"\"\n def optionType(self, option_name: str) -> EnumValue:\n \"\"\"\n\n optionType(self, name) -> hou.fieldType enum value\n\n Return a hou.fieldType enumerated value that describes the type of\n data stored in an option. Returns hou.fieldType.NoSuchField if no\n field exists with that name.\n\n\n \"\"\"\n def setOption(self, name: str, value: OptionMultiArgType, type_hint: EnumValue = ...) -> None:\n \"\"\"\n\n setOption(self, name, value, type_hint = hou.fieldType::NoSuchField)\n\n Set an entry in the dictionary of options. See hou.Attrib.options\n for more information.\n\n\n name\n The name of the option to set.\n\n value\n An integer, float, string, hou.Vector2, hou.Vector3,\n hou.Vector4, hou.Quaternion, hou.Matrix3, hou.matrix4, or\n sequence of numbers.\n\n type_hint\n Used to determine the exact hou.fieldType desired when the\n specified value type is not enough to unambiguously determine\n it.\n\n\n \"\"\"\n def removeOption(self, name: str) -> None:\n \"\"\"\n\n removeOption(self, name)\n\n Remove an entry in the dictionary of options. See hou.Attrib.options\n for more information.\n\n Raises hou.OperationFailed if there is no entry in the dictionary\n with this name.\n\n\n \"\"\"\n def dataId(self) -> AttribDataId:\n \"\"\"\n\n dataId(self)\n\n Returns the data id that represents the contents of this attribute.\n\n\n \"\"\"\n def incrementDataId(self) -> None:\n \"\"\"\n\n incrementDataId(self)\n\n Increment the data id to indicate that the contents of this\n attribute has changed.\n\n\n \"\"\"\n def defaultValue(self) -> AttribReturnType:\n \"\"\"\n\n defaultValue(self) -> int or float or str or tuple\n\n Return the attribute's default value. Returns a single\n int/float/string for attributes of size 1 and a tuple of values for\n attributes with more than one component.\n\n This method is useful when duplicating an attribute. See\n hou.Geometry.addAttrib for an example.\n\n\n \"\"\"\n def options(self) -> dict[str, OptionMultiReturnType]:\n \"\"\"\n\n option(self, name) -> bool, int, float, str, hou.Vector2, hou.Vector3,\n hou.Vector4, hou.Quaternion, hou.Matrix3, hou.Matrix4, tuple of int, or\n tuple of float\n\n Return the value of an individual option, on None if no such option\n exists.\n\n See also hou.Attrib.options, hou.Attrib.setOption and\n hou.Attrib.removeOption.\n\n\n \"\"\"\n def option(self, option_name: str) -> OptionMultiReturnType: ...\n\nclass AttribDataId:\n \"\"\"\n\n hou.AttribDataId\n\n Used for detecting when contents of geometry have changed\n\n Every geometry attribute contains a data id that is incremented whenever\n it is modified (by at least 1). To perform optimizations that depend on\n whether an attribute has changed, these data ids can be cached and then\n compared again to see if they match at some future point in time. If\n they do not match, then one should assume that the contents of the\n attribute is no longer the same as before.\n\n If two attributes have matching data id values, then you can assume that\n their contents are the same. To preserve data id values across geometry\n copies, set the clone_data_ids parameter on such methods to True.\n\n This is typically used in a SOP to optimize operations in conjunction\n with setting hou.SopNode.setManagesAttribDataIds to True.\n\n\n Note\n The values of data ids are only valid within the same session. They\n cannot be compared across sessions or different running Houdini\n processes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Constructs an invalid data id. This can be used as a placeholder in\n a list of data id's for attributes that don't exist.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def isValid(self) -> bool:\n \"\"\"\n\n isValid(self) -> bool\n\n Return True if this is a valid data id.\n\n\n \"\"\"\n def vexAttribDataId(self) -> Tuple[int, ...]:\n \"\"\"\n\n vexAttribDataId(self) -> tuple of int\n\n Return the same list of integers that the attribdataid() VEX\n function returns for this data id. This is provided for\n interoperability with VEX.\n\n\n \"\"\"\n\nclass audio:\n \"\"\"\n\n hou.audio\n\n Functions related to playing audio using Houdini's playbar.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def turnOffAudio() -> None:\n \"\"\"\n\n turnOffAudio()\n\n Turn off the audio playback.\n\n\n \"\"\"\n @staticmethod\n def useTimeLineMode() -> None:\n \"\"\"\n\n useTimeLineMode()\n\n Put the Audio Panel into a scrub mode.\n\n When the Audio Panel is in the scrub (a.k.a. timeline) mode, Houdini\n will play the audio during the animation or when scrubbing the thumb\n in the playbar.\n\n\n \"\"\"\n @staticmethod\n def useTimeSliceMode() -> None:\n \"\"\"\n\n useTimeSliceMode()\n\n Put the Audio Panel into realtime (a.k.a. timeslice) mode.\n\n\n \"\"\"\n @staticmethod\n def useTestMode() -> None:\n \"\"\"\n\n useTestMode()\n\n Put the Audio Panel into a mode that tests the audio playback.\n\n When the Audio Panel is in the test mode, it will play the entire\n audio soundtrack. The test can be stopped and resumed with stop()\n and play() functions.\n\n The sound will not play when scrubbing the thumb in the playbar or\n when playing the animation in the playbar. The audio must be in\n either scrub or realtime mode for playing the sound during animation\n or scrubbing.\n\n\n \"\"\"\n @staticmethod\n def setMono(on: bool) -> None:\n \"\"\"\n\n setMono(on)\n\n Set whether the audio will play in mono or stereo mode.\n\n\n \"\"\"\n @staticmethod\n def setVolumeTied(on: bool) -> None:\n \"\"\"\n\n setVolumeTied(self, on)\n\n Set whether changing the volume of one channel affects the volume of\n the other channel. If so, both channels will have the same volume\n set.\n\n\n \"\"\"\n @staticmethod\n def setMeter(on: bool) -> None:\n \"\"\"\n\n setMeter(on)\n\n Ses whether the meter will show the volume levels during the audio\n playback.\n\n\n \"\"\"\n @staticmethod\n def setLeftVolume(volume: float) -> None:\n \"\"\"\n\n setLeftVolume(value)\n\n Set the volume for the left audio channel.\n\n\n \"\"\"\n @staticmethod\n def setRightVolume(volume: float) -> None:\n \"\"\"\n\n setRightVolume(value)\n\n Set the volume for the right channel.\n\n\n \"\"\"\n @staticmethod\n def useChops() -> None:\n \"\"\"\n\n useChops()\n\n Set the Audio Panel to use a CHOP node for the audio.\n\n\n \"\"\"\n @staticmethod\n def useAudioFile() -> None:\n \"\"\"\n\n useAudioFile()\n\n Set the Audio Panel to use a disk file for the audio.\n\n\n \"\"\"\n @staticmethod\n def setChopPath(node_path: str) -> None:\n \"\"\"\n\n setChopPath(path)\n\n Set the Audio Panel to play the sound inside a CHOP node. Houdini\n plays this sound during testing, animation or scrubbing. See also\n hou.audio.useChops.\n\n\n path\n A string containing the path to the CHOP node.\n\n\n \"\"\"\n @staticmethod\n def setAudioFileName(file_name: str) -> None:\n \"\"\"\n\n setAudioFileName(path)\n\n Set the Audio Panel to play the sound inside an audio file. Houdini\n plays this sound during testing, animation or scrubbing. See also\n hou.audio.useAudioFile.\n\n\n \"\"\"\n @staticmethod\n def setAudioOffset(time_offset: float) -> None:\n \"\"\"\n\n setAudioOffset(offset)\n\n Set the time offset of the sound to sync the audio. This offset,\n specified in seconds, will coincide with the audio frame. See also\n hou.audio.setAudioFrame.\n\n\n \"\"\"\n @staticmethod\n def setAudioFrame(frame: float) -> None:\n \"\"\"\n\n setAudioFrame(frame)\n\n Set the frame to sync the audio. The audio offset (in seconds) will\n coincide with this frame. See also hou.audio.setAudioOffset.\n\n\n \"\"\"\n @staticmethod\n def setScrubRepeat(on: bool) -> None:\n \"\"\"\n\n setScrubRepeat(on)\n\n Set whether the sound chunk is repeated during scrubbing. See also\n hou.audio.useTimeSliceMode.\n\n\n \"\"\"\n @staticmethod\n def setScrubSustain(sustain: float) -> None:\n \"\"\"\n\n setScrubSustain(value)\n\n Set the length of time the that the sound chunk is repeatedly played\n when scrubbing comes to a standstill on a particular single frame.\n In practice, when the value is zero, no sound will be played when\n scrubbing keeps hovering over one frame. But, when the value is non-\n zero, a small sound chunk will keep playing repeatedly with a\n specified frequency. See also hou.audio.useTimeSliceMode.\n\n\n \"\"\"\n @staticmethod\n def setScrubRate(scrub_rate: float) -> None:\n \"\"\"\n\n setScrubRate(value)\n\n This method is deprecated in favor of hou.audio.setScrubLength.\n\n When the sustain period is non-zero, the small chunk of the sound\n will be repeated with this frequency when the scrubbing comes to a\n standstill at a single frame. See also hou.audio.useTimeSliceMode.\n\n\n \"\"\"\n @staticmethod\n def setScrubLength(scrub_length: float) -> None:\n \"\"\"\n\n setScrubLength(value)\n\n When the sustain period is non-zero, the audio from this many frames\n will be repeated when the scrubbing comes to a standstill at a\n single frame. See also hou.audio.useTimeSliceMode.\n\n\n \"\"\"\n @staticmethod\n def reverse() -> None:\n \"\"\"\n\n reverse()\n\n When the Audio Panel is in the test mode, start playing the sound in\n reverse.\n\n\n \"\"\"\n @staticmethod\n def stop() -> None:\n \"\"\"\n\n stop()\n\n When the Audio Panel is in the test mode, stop the test playback if\n any audio is currently playing.\n\n\n \"\"\"\n @staticmethod\n def play() -> None:\n \"\"\"\n\n play()\n\n When the Audio Panel is in the test mode, start playing the Audio\n Panel's specified audio file or CHOP. See also\n hou.audio.setAudioFileName and hou.audio.setChopPath.\n\n\n \"\"\"\n @staticmethod\n def setLooping(on: bool) -> None:\n \"\"\"\n\n setLooping(on)\n\n When the Audio Panel is in the test mode, set whether the test\n should start playing from the beginning once the end is reached. See\n also hou.audio.setRewind.\n\n\n \"\"\"\n @staticmethod\n def setRewind(on: bool) -> None:\n \"\"\"\n\n setRewind(on)\n\n When the Audio Panel is in the test mode, set whether the sound\n should rewind to the beginning when the test is stopped. If not, on\n subsequent start, the sound will resume from the point at which it\n was previously stopped. See also hou.audio.setLooping.\n\n\n \"\"\"\n\nclass Bookmark:\n \"\"\"\n\n hou.Bookmark\n\n Represents a bookmark.\n\n You cannot instantiate this object directly. Call hou.anim.newBookmark\n instead.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of this bookmark.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Updates the name of the bookmark.\n\n\n \"\"\"\n def startFrame(self) -> int:\n \"\"\"\n\n startFrame(self) -> int\n\n Returns the start frame of this bookmark.\n\n\n \"\"\"\n def setStartFrame(self, start: float) -> None:\n \"\"\"\n\n setStartFrame(self, start_frame)\n\n Updates the start frame of the bookmark.\n\n\n \"\"\"\n def endFrame(self) -> int:\n \"\"\"\n\n endFrame(self) -> int\n\n Returns the end frame of this bookmark.\n\n\n \"\"\"\n def setEndFrame(self, end: float) -> None:\n \"\"\"\n\n setEndFrame(self, end_frame)\n\n Updates the end frame of the bookmark.\n\n\n \"\"\"\n def comment(self) -> str:\n \"\"\"\n\n comment(self) -> str\n\n Returns the comment of this bookmark.\n\n\n \"\"\"\n def setComment(self, comment: str) -> None:\n \"\"\"\n\n setComment(self, comment)\n\n Updates the comment of the bookmark.\n\n\n \"\"\"\n def color(self) -> Color:\n \"\"\"\n\n color(self) -> hou.Color\n\n Returns the color of this bookmark.\n\n\n \"\"\"\n def setColor(self, color: Color) -> None:\n \"\"\"\n\n setColor(self, color)\n\n Updates the color of the bookmark.\n\n The color parameter should be a hou.Color.\n\n\n \"\"\"\n def visible(self) -> bool:\n \"\"\"\n\n visible(self) -> bool\n\n Returns whether or not this bookmark is visible.\n\n\n \"\"\"\n def setVisible(self, visible: bool) -> None:\n \"\"\"\n\n setVisible(self, visible)\n\n Updates the visibility of the bookmark.\n\n\n \"\"\"\n def sessionId(self) -> int:\n \"\"\"\n\n sessionId(self) - int\n\n Returns the ID of the bookmark. Note that this is a per-session ID\n that is not guaranteed to be the same between different sessions.\n\n\n \"\"\"\n def isTemporary(self) -> bool:\n \"\"\"\n\n isTemporary(self) -> bool\n\n Returns whether or not this bookmark is marked as temporary.\n\n\n \"\"\"\n def setTemporary(self, temporary: bool) -> None:\n \"\"\"\n\n setTemporary(self, temporary)\n\n Marks this bookmark as temporary or not. Temporary bookmarks are not\n saved when exporting bookmarks, nor are they saved in the .hip file\n by default.\n\n See hou.anim.saveBookmarks.\n\n\n \"\"\"\n def isEnabled(self) -> bool:\n \"\"\"\n\n isEnabled(self) -> bool\n\n Returns whether or not this bookmark is enabled.\n\n\n \"\"\"\n def enable(self, enabled: bool) -> None:\n \"\"\"\n\n enable(self, enabled)\n\n Enable or disable this bookmark. Disabled bookmarks are greyed out\n on the playbar.\n\n\n \"\"\"\n def setMetadata(self, key: str, value: Any, type_hint: EnumValue = ...) -> None:\n \"\"\"\n\n setMetadata(self, key, value, type_hint = hou.fieldType.NoSuchField)\n\n Adds a metadata property to this bookmark.\n\n\n key\n The name of the metadata property to add.\n\n value\n The value to store as metadata.\n\n type_hint\n Used to determine the exact hou.fieldType desired when the\n specified value is too ambiguous to determine the type.\n\n\n \"\"\"\n def metadata(self, key: str, default_value: Any = ...) -> Any:\n \"\"\"\n\n metadata(self, key, default_value=None) -> Any\n\n Returns the metadata associated with the given key, or default_value\n if no such key exists in the metadata.\n\n\n key\n The name of the metadata property to return.\n\n default_value\n Value to return if no property with the given key exists in the\n metadata.\n\n\n \"\"\"\n\nclass BoundingBox:\n \"\"\"\n\n hou.BoundingBox\n\n An axis-aligned 3D rectangular region.\n\n For example, a bounding box might describe a piece of geometry's minimum\n and maximum values on each of the coordinate axes. See\n hou.Geometry.boundingBox for an example of a function that returns a\n bounding box.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, bbox_or_xmin: float|BoundingBox = ..., ymin: float = ..., zmin: float = ..., xmax: float = ..., ymax: float = ..., zmax: float = ...) -> None:\n \"\"\"\n\n __init__(self, xmin=0.0, ymin=0.0, zmin=0.0, xmax=0.0, ymax=0.0,\n zmax=0.0)\n\n Construct a new bounding box with the specified minimum and maximum\n bounds. Use hou.BoundingBox.setTo to change the position of an\n existing bounding box.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, bbox: BoundingBox, tolerance: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, bbox, tolerance=0.00001) -> bool\n\n Returns whether this bounding box is equal to another, subject to\n numerical tolerances.\n\n\n \"\"\"\n def almostEqual(self, bbox: BoundingBox, tolerance: float = 1e-05) -> bool: ...\n def __hash__(self) -> int: ...\n def __mul__(self, matrix4: Matrix4) -> BoundingBox:\n \"\"\"\n\n __mul__(self, matrix4) -> BoundingBox\n\n Take this bounding box, transform it by the given matrix, compute\n the axis-aligned bounding box around this transformed box, and\n return it.\n\n\n \"\"\"\n def isValid(self) -> bool:\n \"\"\"\n\n isValid(self) -> bool\n\n Returns whether this bounding box is valid.\n\n\n \"\"\"\n def setTo(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setTo(self, bounds_sequence)\n\n Given a sequence of (xmin, ymin, zmin, xmax, ymax, zmax) values, set\n the position of the bounding box.\n\n Raises hou.InvalidSize if the tuple does not contain six elements.\n\n\n \"\"\"\n def minvec(self) -> Vector3:\n \"\"\"\n\n minvec(self) -> hou.Vector3\n\n Return a vector describing the corner of the box with the smallest\n x, y, and z values.\n\n\n \"\"\"\n def maxvec(self) -> Vector3:\n \"\"\"\n\n maxvec(self) -> hou.Vector3\n\n Return a vector describing the corner of the box with the largest x,\n y, and z values.\n\n\n \"\"\"\n def sizevec(self) -> Vector3:\n \"\"\"\n\n sizevec(self) -> hou.Vector3\n\n Return a vector describing the size of the box in each of the x, y,\n and z axes.\n\n This method can be implemented as follows:\n\n > def sizevec(self):\n > return self.maxvec() - self.minvec()\n\n \"\"\"\n def center(self) -> Vector3:\n \"\"\"\n\n center(self) -> hou.Vector3\n\n Return the position of the center of the bounding box.\n\n This method can be implemented as follows:\n\n > def sizevec(self):\n > return (self.minvec() + self.maxvec()) * 0.5\n\n \"\"\"\n def enlargeToContain(self, point_or_bbox: Sequence[float]|Vector3, BoundingBox) -> None:\n \"\"\"\n\n enlargeToContain(self, point_or_bbox)\n\n Enlarge the bounding box to contain the given element. The element\n may be a sequence of 3 floats (such as a hou.Vector3) describing a\n position or another bounding box. If this box does not need to grow\n because it already completely contains the element, it won't be\n modified.\n\n\n \"\"\"\n def contains(self, point: Sequence[float]) -> bool:\n \"\"\"\n\n contains(self, point)\n\n Given a sequence of 3 floats (such as a hou.Vector3) describing a\n position, return whether the position is inside the box.\n\n\n \"\"\"\n\nclass BoundingRect:\n \"\"\"\n\n hou.BoundingRect\n\n An axis-aligned 2D rectangular region.\n\n A bounding rectangle can describe the size and location of a node in a\n network, or the visible area or a network editor pane.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, brect_or_p1_or_xmin: BoundingRect|Vector2|float, p2_or_ymin: Vector2|float, xmax: float = ..., ymax: float = ...) -> None:\n \"\"\"\n\n __init__(self, p1, p2)\n\n Construct a new bounding rectangle with the specified bounds\n expressed as two hou.Vector2s.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, rect: BoundingRect, tolerance: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, rect, tolerance=0.00001) -> bool\n\n Returns whether this bounding rectangle is equal to another, subject\n to numerical tolerances.\n\n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> subrect = hou.BoundingRect(0.001, 0.001, 0.999, 1.001)\n > >>> unitrect.isAlmostEqual(subrect)\n > False\n > >>> unitrect.isAlmostEqual(subrect, 0.01)\n > True\n\n \"\"\"\n def __hash__(self) -> int: ...\n def isValid(self) -> bool:\n \"\"\"\n\n isValid(self) -> bool\n\n Returns whether this bounding rectangle is valid, indicating it has\n been initialized in any way.\n\n > >>> hou.BoundingRect().isValid()\n > False\n > >>> hou.BoundingRect(0, 0, 0, 0).isValid()\n > True\n > >>> hou.BoundingRect(0, 0, 0, 0).isValid()\n > True\n\n \"\"\"\n def setTo(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setTo(self, bounds_sequence)\n\n Given a sequence of (xmin, ymin, xmax, ymax) values, set the\n position of the bounding rectangle.\n\n Raises hou.InvalidSize if the tuple does not contain four elements.\n\n\n \"\"\"\n def translate(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n translate(self, offset)\n\n Moves this rectangle by the amount specified in the two float tuple\n or hou.Vector2 passed as the offset parameter.\n\n > >>> rect = hou.BoundingRect(1, 1, 2, 2)\n > >>> rect.translate(hou.Vector2(1, -1))\n > >>> rect\n > \n\n \"\"\"\n def scale(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n scale(self, scale)\n\n Scales this rectangle by the amount specified in the two float tuple\n or hou.Vector2 passed as the scale parameter. Note that scaling the\n rectangle by a negative value will result in an invlalid rectangle\n where the lower left corner is above or to the right of the upper\n right corner.\n\n > >>> rect = hou.BoundingRect(1, 1, 2, 2)\n > >>> rect.scale(hou.Vector2(2, 3))\n > >>> rect\n > \n > >>> rect.scale((-1, -1))\n > >>> rect\n > \n > >>> rect.isValid()\n > False\n\n \"\"\"\n def expand(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n expand(self, offset)\n\n Moves the edges of the rectangle away from its center by the\n distances specified in the two float tuple or hou.Vector2 passed as\n the offset parameter. The offset is applied to both sides of the\n rectangle so actually changes the width and height of the rectangle\n by twice the passed in values.\n\n Negative values can be passed into the offset to shrink the\n rectangle, but shrinking the rectangle by more than its current size\n will result in an invliad rectangle.\n\n > >>> rect = hou.BoundingRect(1, 1, 2, 2)\n > >>> rect.expand((1, 1))\n > >>> rect\n > \n > >>> rect.expand((0, -2))\n > >>> rect\n > \n > >>> rect.isValid()\n > False\n\n \"\"\"\n def min(self) -> Vector2:\n \"\"\"\n\n min(self) -> hou.Vector2\n\n Return a vector describing the corner of the rectangle with the\n smallest x and y values.\n\n\n \"\"\"\n def max(self) -> Vector2:\n \"\"\"\n\n max(self) -> hou.Vector2\n\n Return a vector describing the corner of the rectangle with the\n largest x and y values.\n\n\n \"\"\"\n def size(self) -> Vector2:\n \"\"\"\n\n size(self) -> hou.Vector2\n\n Return a vector describing the size of the rectangle in each of the\n x and y axes.\n\n This method can be implemented as follows:\n\n > def size(self):\n > return self.max() - self.min()\n\n \"\"\"\n def center(self) -> Vector2:\n \"\"\"\n\n center(self) -> hou.Vector2\n\n Return the position of the center of the bounding rectangle.\n\n This method can be implemented as follows:\n\n > def center(self):\n > return (self.min() + self.max()) * 0.5\n\n \"\"\"\n def getOffsetToAvoid(self, bounds: BoundingRect, direction: Optional[Vector2] = None) -> Vector2:\n \"\"\"\n\n getOffsetToAvoid(self, bounds, direction = None) -> hou.Vector2\n\n Return a vector describing the minimum distance this rectangle must\n be translated to avoid any overlap with the bounds rectangle. If\n direction is provided as a hou.Vector2, it indicates the specific\n direction the returned offset should be. If the rectangles do not\n overlap, the result will be hou.Vector2(0.0, 0.0).\n\n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> subrect = hou.BoundingRect(0.2, 0.4, 0.8, 0.6)\n > >>> unitrect.getOffsetToAvoid(subrect)\n > \n > >>> unitrect.getOffsetToAvoid(subrect, hou.Vector2(1.0, 0.0))\n > \n > >>> unitrect.getOffsetToAvoid(subrect, hou.Vector2(1.0, 1.0))\n > \n\n \"\"\"\n def enlargeToContain(self, point_or_rect: Sequence[float]|Vector2|BoundingRect) -> None:\n \"\"\"\n\n enlargeToContain(self, point_or_rect)\n\n Enlarge the bounding rectangle to contain the given element. The\n element may be a sequence of 2 floats (such as a hou.Vector2)\n describing a position or another bounding rectangle. If this\n rectangle does not need to grow because it already completely\n contains the element, it won't be modified.\n\n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> unitrect.enlargeToContain((2, 0.5))\n > >>> unitrect\n > \n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> unitrect.enlargeToContain(hou.BoundingRect(0.5, 0.5, 2, 1.5))\n > >>> unitrect\n > \n\n \"\"\"\n def intersect(self, rect: BoundingRect) -> None:\n \"\"\"\n\n intersect(self, rect)\n\n Given a hou.BoundingRect object, updates the rectangle in this\n object to be the region where the two rectangles overlap.\n\n > >>> rect = hou.BoundingRect(0, 0, 1, 1)\n > >>> rect.intersect(hou.BoundingRect(0.5, 0.5, 1.5, 1.5))\n > >>> rect\n > \n\n \"\"\"\n def intersects(self, rect: BoundingRect) -> bool:\n \"\"\"\n\n intersects(self, rect) -> bool\n\n Given a hou.BoundingRect object, return whether that rectangle\n partially or fully overlaps the one described by this object.\n\n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> unitrect.intersects(hou.BoundingRect(0.5, 0.5, 1.0, 1.0))\n > True\n > >>> unitrect.intersects(hou.BoundingRect(0.5, 0.5, 1.5, 1.5))\n > True\n > >>> unitrect.intersects(hou.BoundingRect(1.5, 1.5, 2.5, 2.5))\n > False\n\n \"\"\"\n def contains(self, rect: BoundingRect) -> bool:\n \"\"\"\n\n contains(self, rect) -> bool\n\n Given a hou.BoundingRect object, return whether that rectangle is\n inside the one described by this object.\n\n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> unitrect.contains(hou.BoundingRect(0.5, 0.5, 1.0, 1.0))\n > True\n > >>> unitrect.contains(hou.BoundingRect(0.5, 0.5, 1.5, 1.5))\n > False\n\n \"\"\"\n def closestPoint(self, point: Sequence[float]) -> Vector2:\n \"\"\"\n\n closestPoint(self, point) -> hou.Vector2\n\n Given a sequence of 2 floats (such as a hou.Vector2) describing a\n position, return the position inside the rectangle that is closest\n to the provided point.\n\n > >>> unitrect = hou.BoundingRect(0, 0, 1, 1)\n > >>> unitrect.closestPoint((0.5, 0.5))\n > \n > >>> unitrect.closestPoint((100, 0.5))\n > \n > >>> unitrect.closestPoint((-10, -5))\n > \n\n \"\"\"\n\nclass ButtonParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.ButtonParmTemplate\n\n Describes a parameter tuple containing a button.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, disable_when: str|None = ..., is_hidden: bool = ..., is_label_hidden: bool = ..., join_with_next: bool = ..., help: str = ..., script_callback: str|None = ..., script_callback_language: EnumValue = ..., tags: Mapping[str, str] = ...) -> None:\n \"\"\"\n\n __init__(self, name, label, disable_when=None, is_hidden=False,\n is_label_hidden=False, join_with_next=False, help=None,\n script_callback=None,\n script_callback_language=hou.scriptLanguage.Hscript, tags={})\n\n Creates a new ButtonParmTemplate instance.\n\n Construct a new ButtonParmTemplate.\n\n\n name\n See hou.ParmTemplate.name for more information.\n\n label\n See hou.ParmTemplate.label for more information.\n\n disable_when\n See hou.ParmTemplate.disableWhen for more information.\n\n is_hidden\n See hou.ParmTemplate.isHidden for more information.\n\n is_label_hidden\n See hou.ParmTemplate.isLabelHidden for more information.\n\n join_with_next\n See hou.ParmTemplate.joinsWithNext for more information.\n\n help\n See hou.ParmTemplate.help for more information.\n\n script_callback\n See hou.ParmTemplate.scriptCallback for more information.\n\n script_callback_language\n See hou.ParmTemplate.scriptCallbackLanguage for more\n information.\n\n tags\n See hou.ParmTemplate.tags for more information.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass ChannelEditorPane(PaneTab):\n \"\"\"\n\n hou.ChannelEditorPane\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def graph(self) -> Optional[ChannelGraph]:\n \"\"\"\n\n graph(self) -> hou.ChannelGraph\n\n Return the channel graph for this pane.\n\n\n \"\"\"\n def channelListSplitFraction(self) -> float:\n \"\"\"\n\n channelListSplitFraction(self) -> double\n\n Return the width of the embedded channel list as fraction (0-1\n value) of the pane's width.\n\n\n \"\"\"\n def setChannelListSplitFraction(self, split_fraction: float) -> None:\n \"\"\"\n\n setChannelListSplitFraction(self, value)\n\n Set the width of the embedded channel list as fraction (0-1 value)\n of the pane's width.\n\n\n \"\"\"\n def displayFilter(self) -> str:\n \"\"\"\n\n displayFilter(self) -> string\n\n Return the filter pattern for which channels are displayed.\n\n\n \"\"\"\n def setDisplayFilter(self, filter: str) -> None:\n \"\"\"\n\n setDisplayFilter(self, filter)\n\n Set the filter pattern for which channels are displayed. The channel\n name is used to match against the pattern.\n\n\n \"\"\"\n def editorMode(self) -> EnumValue:\n \"\"\"\n\n editorMode(self) -> hou.channelEditorMode enum value\n\n Return the animation editor mode.\n\n\n \"\"\"\n def setEditorMode(self, mode: EnumValue) -> None:\n \"\"\"\n\n setEditorMode(self, mode)\n\n Set the animation editor mode.\n\n\n \"\"\"\n def templateFilter(self) -> str:\n \"\"\"\n\n templateFilter(self) -> string\n\n Return the filter pattern for which channels are templated.\n\n\n \"\"\"\n def setTemplateFilter(self, filter: str) -> None:\n \"\"\"\n\n setTemplateFilter(self, filter)\n\n Set the filter pattern for which channels are templated. The channel\n name is used to match against the pattern.\n\n\n \"\"\"\n def colorsCallback(self) -> str:\n \"\"\"\n\n colorsCallback(self) -> string\n\n Return the active channel colors callback name.\n\n\n \"\"\"\n def setColorsCallback(self, cb: str) -> bool:\n \"\"\"\n\n setColorsCallback(self, callback_name) -> bool\n\n Set the active channel colors callback name. If the callback name is\n invalid, the active callback will be reset to default. Return True\n if the callback was successfully changed. Return False if the\n callback name was invalid.\n\n\n \"\"\"\n def unregisterColorsCallback(self, cb_class: str) -> bool:\n \"\"\"\n\n unregisterColorsCallback(self, callback_name) -> bool\n\n Unregister a callback by name. It also resets the active callback if\n the callback to remove was the active one. Return True if the\n callback was successfully removed. Return False if the callback name\n was invalid.\n\n\n \"\"\"\n def colorsCallbacks(self) -> Tuple[str, ...]:\n \"\"\"\n\n colorsCallbacks(self) -> tuple of string\n\n Return the list of registered channel colors callback.\n\n\n \"\"\"\n def registerColorsCallback(self, cb_class: str, callback: Any) -> bool:\n '''\n\n registerColorsCallback(self, callback_name, callback_object ) -> bool\n\n Registers a callback to generate custom channel colors based on the\n node and parameter names.\n\n\n callback_name\n A name for the custom color scheme. You can use this to remove\n the callback with the unregisterColorsCallback method.\n\n callback_object\n A Python object with a getChannelColor method. For example:\n\n > \n > class MyChannelColors(object):\n > def getChannelColor(self, node_path, channel_name):\n > return 0, 0, 0\n\n The node argument is the path to the node (for example,\n /obj/table). The parm argument is the internal name of the\n channel (for example, tx). The method must return a 3-tuple\n representing normalized (0-1, not 0-255) red, green, and blue\n values. If the method returns (0, 0, 0) Houdini uses the default\n channel color.\n\n You should register the callback in a session-independent startup\n script. When you register the callback, Houdini will call it once\n with empty string arguments to make sure it returns a triple. Your\n getChannelColor() method needs to handle this case.\n\n The following example object uses the custom color tint of a node to\n color its channels:\n\n > \n > import hou\n > \n > class NodeColors:\n > \\'\\'\\'\n > Use hue variants of a node\\'s color for parameter names \n > ending in x, y or z.\n > \\'\\'\\'\n > \n > def getChannelColor(self, node_path, channel_name):\n > # Handle the empty string case\n > if not node_path:\n > return 0, 0, 0\n > \n > # Get a Node object from the path\n > n = hou.node(node_path)\n > # Get the node\\'s color as a hou.Color object\n > color = n.color()\n > # Get the color\\'s HSV values as a triple\n > hue, sat, val = n.color().hsv()\n > \n > # If the color is gray, use the default\n > if not sat:\n > return 0, 0, 0\n > \n > # Hue-shift the node color for X, Y, and Z channels:\n > if channel_name.endswith(\\\\\"x\\\\\"):\n > color.setHSV(hue - 50, sat * 2, val * 1.2)\n > elif channel_name.endswith(\\\\\"y\\\\\"):\n > color.setHSV(hue, sat * 2, val * 1.2)\n > elif channel_name.endswith(\\\\\"z\\\\\"):\n > color.setHSV(hue + 50, sat * 2, val * 1.2)\n > \n > # Return the color as normalized (r, g, b)\n > return color.rgb()\n\n '''\n def channelList(self) -> Optional[ChannelList]: ...\n def setChannelList(self, l: ChannelList) -> None: ...\n def channelListPinned(self) -> bool: ...\n def setChannelListPinned(self, pinned: bool) -> None: ...\n def isAnimBarShown(self) -> bool:\n \"\"\"\n\n isAnimBarShown(self) -> bool\n\n Return whether or not the Animation Toolbar is currently displayed.\n\n\n \"\"\"\n def showAnimBar(self, show: bool) -> None:\n \"\"\"\n\n showAnimBar(self, show: bool)\n\n Shows or hides the Animation Toolbar.\n\n\n \"\"\"\n def animBar(self) -> Optional[AnimBar]:\n \"\"\"\n\n animBar(self): -> hou.AnimBar\n\n Return a hou.AnimBar, which provides control over this Channel\n Editor's Animation Toolbar.\n\n\n \"\"\"\n\nclass ChannelGraph:\n \"\"\"\n\n hou.ChannelGraph\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def selectedKeyframes(self) -> dict[Parm, Tuple[BaseKeyframe,...]]:\n \"\"\"\n\n selectedKeyframes(self) -> dictionary of (, tuple of hou.BaseKeyframe)\n pairs\n\n Returns a dictionary of (hou.Parm, keyframes) which are currently\n selected in the playbar. TIP: Here is an example of how to scale the\n selected key values by 2:\n\n > keyframes = hou.playbar.selectedKeyframes()\n > for parm in keyframes.keys():\n > for key in keyframes[parm]:\n > key.setValue(2 * key.value())\n > parm.setKeyframe(key)\n\n \"\"\"\n def selection(self) -> Tuple[ChannelGraphSelection, ...]:\n \"\"\"\n\n selection(self) -> tuple of hou.ChannelGraphSelection\n\n Return a copy of the current channel graph selection.\n\n\n \"\"\"\n def setSelection(self, s: Sequence[ChannelGraphSelection]) -> None:\n \"\"\"\n\n setSelection(self, chan_graph_selections)\n\n Set the current channel graph selection to the given sequence of\n hou.ChannelGraphSelection objects.\n\n\n \"\"\"\n\nclass ChannelList:\n \"\"\"\n\n hou.ChannelList\n\n A copy of a list of channels from Channel List or Animation Editor.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n hou.ChannelList\n\n A copy of a list of channels from Channel List or Animation Editor.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def clear(self) -> None:\n \"\"\"\n\n clear(self)\n\n Clears the channel list.\n\n\n \"\"\"\n def parms(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n parms(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels in the channel\n list.\n\n\n \"\"\"\n def selected(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n selected(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels selected in the\n channel list.\n\n\n \"\"\"\n def deselected(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n deselected(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels deselected in the\n channel list.\n\n\n \"\"\"\n def pinned(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n pinned(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels pinned in the\n channel list.\n\n\n \"\"\"\n def unpinned(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n unpinned(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels unpinned in the\n channel list.\n\n\n \"\"\"\n def selectedValue(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n selectedValue(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels with their value\n column selected in the channel list.\n\n\n \"\"\"\n def deselectedValue(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n deselectedValue(self) -> tuple of hou.Parm\n\n Returns a tuple of hou.Parm with all the channels with their value\n column deselected in the channel list.\n\n\n \"\"\"\n def addParm(self, parm: Parm, selected: bool = True, pinned: bool = False, valueselected: bool = False) -> None:\n \"\"\"\n\n addParms(self, parms, selected, pinned, valueselected)\n\n Adds a list of parameters to the channel list setting selected,\n pinned and value selected flags.\n\n\n parms\n A tuple of hou.Parm.\n\n selected\n Select the channel, True by default.\n\n pinned\n Pin the channel, False by default.\n\n valueselected\n Select the value column of the channel, False by default.\n\n\n \"\"\"\n def addPath(self, path: str, selected: bool = True, pinned: bool = False, valueselected: bool = False) -> None:\n \"\"\"\n\n addPath(self, path, selected, pinned, valueselected)\n\n Adds a parameter to the channel list setting selected, pinned and\n value selected flags.\n\n\n path\n A full path string to a parameter.\n\n selected\n Select the channel, True by default.\n\n pinned\n Pin the channel, False by default.\n\n valueselected\n Select the value column of the channel, False by default.\n\n\n \"\"\"\n def addParms(self, parms: Sequence[Parm], selected: bool = True, pinned: bool = False, valueselected: bool = False) -> None: ...\n def addPaths(self, paths: Sequence[str], selected: bool = True, pinned: bool = False, valueselected: bool = False) -> None:\n \"\"\"\n\n addPaths(self, paths, selected, pinned, valueselected)\n\n Adds a list of parameters using full paths to the channel list\n setting selected, pinned and value selected flags.\n\n\n path\n A full path string to a parameter.\n\n selected\n Select the channel, True by default.\n\n pinned\n Pin the channel, False by default.\n\n valueselected\n Select the value column of the channel, False by default.\n\n\n \"\"\"\n def remove(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n remove(self, parm)\n\n Remove a parameter or a list of parameters from the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def select(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n select(self, parm)\n\n Select a parameter or a list of parameters in the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def deselect(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n deselect(self, parm)\n\n Deselect a parameter or a list of parameters in the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def pin(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n pin(self, parm)\n\n Pin a parameter or a list of parameters in the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def unpin(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n unpin(self, parm)\n\n Unpin a parameter or a list of parameters in the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def selectValue(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n selectValue(self, parm)\n\n Select the value column of a parameter or a list of parameters in\n the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def deselectValue(self, parm: Parm|Sequence[Parm]) -> None:\n \"\"\"\n\n deselectValue(self, parm)\n\n Deselect the value column of a parameter or a list of parameters in\n the channel list.\n\n\n parm\n A hou.Parm or tuple of hou.Parm.\n\n\n \"\"\"\n def contains(self, parm: Parm) -> bool:\n \"\"\"\n\n contains(self, parm) -> bool\n\n Returns True if the parameter is in the Channel List.\n\n\n parm\n A hou.Parm.\n\n\n \"\"\"\n def isSelected(self, parm: Parm) -> bool:\n \"\"\"\n\n isSelected(self, parm) -> bool\n\n Returns True if the parameter is selected in the Channel List.\n\n\n parm\n A hou.Parm.\n\n\n \"\"\"\n def isPinned(self, parm: Parm) -> bool:\n \"\"\"\n\n isPinned(self, parm) -> bool\n\n Returns True if the parameter is pinned in the Channel List.\n\n\n parm\n A hou.Parm.\n\n\n \"\"\"\n def isValueSelected(self, parm: Parm) -> bool:\n \"\"\"\n\n isValueSelected(self, parm) -> bool\n\n Returns True if the parameter has its value column selected in the\n Channel List.\n\n\n parm\n A hou.Parm.\n\n\n \"\"\"\n def addNodeGeometryChannels(self, node: SopNode, pattern: str|None = ..., selected: bool = ..., pinned: bool = ..., valueselected: bool = ...) -> str:\n \"\"\"\n\n addNodeGeometryChannels(self, node, pattern=None, selected=True,\n pinned=False, valueselected=False) -> str\n\n Adds a collection of geometry channels to the channel list,\n constructed from the channel primitives present in the provided\n node's geometry. Returns the name of the geometry channels\n collection, which will be the same as the node's path.\n\n\n node\n A hou.SopNode.\n\n pattern\n A pattern string, None by default. If provided, only channel\n primitives matching the pattern will be added to the collection.\n\n selected\n Select all channels in the collection, True by default.\n\n pinned\n Pin all channels in the collection, False by default.\n\n valueselected\n Select the value column of all channels in the collection, False\n by default.\n\n\n \"\"\"\n def addGeometryChannels(self, geometry: Geometry, collection_name: str|None = ..., pattern: str|None = ..., selected: bool = ..., pinned: bool = ..., valueselected: bool = ...) -> str:\n '''\n\n addGeometryChannels(self, geometry, collection_name=None, pattern=None,\n selected=True, pinned=False, valueselected=False) -> str\n\n Adds a collection of geometry channels to the channel list,\n constructed from the channel primitives present in the provided\n geometry. Returns the name of the geometry channels collection. If\n no name is provided, a unique name will be created. Note that any\n modifications to the scoped channels are not immediately reflected\n in the channel primitives, but must be manually updated using\n hou.anim.mergeGeometryChannels.\n\n The following shows an example workflow of adding geometry channels\n to the channel list, listening for updates, and setting modified\n channels back in to channel primitives:\n\n > channel_list = hou.ChannelList()\n > collection_name = \\\\\"test_collection\\\\\"\n > # g is any hou.Geometry with channel primitives.\n > channel_list.addGeometryChannels(g, collection_name)\n > hou.playbar.setChannelList(channel_list)\n > \n > # Mutable geometry in which to write modified channel primitives.\n > output_geometry = hou.Geometry()\n > \n > def channels_changed(channel_names, collection_name):\n > print(f\\\\\"Channels in {collection_name} were modified: \\\\\", channel_names)\n > \n > # Write the changed channels back in to channel primitives.\n > hou.anim.mergeGeometryChannels(collection_name, output_geometry, channel_names)\n > \n > # Called whenever geometry channels added to the channel list are modified,\n > # such as when they are edited in the Animation Editor.\n > hou.anim.addGeometryChannelsChangedCallback(collection_name, channels_changed)\n\n geometry\n A hou.Geometry\n\n collection_name\n An optional name for the geometry channels collection. If not\n provided, a unique name will be created. If a collection with\n the same name already exists, it will be overwritten.\n\n pattern\n A pattern string, None by default. If provided, only channel\n primitives matching the pattern will be added to the collection.\n\n selected\n Select all channels in the collection, True by default.\n\n pinned\n Pin all channels in the collection, False by default.\n\n valueselected\n Select the value column of all channels in the collection, False\n by default.\n\n See also:\n\n * hou.ChannelPrim\n\n * hou.anim.setGeometryChannels\n\n * hou.anim.mergeGeometryChannels\n\n * hou.anim.addGeometryChannelsChangedCallback\n\n * hou.anim.removeGeometryChannelsChangedCallback\n\n\n '''\n def geometryChannels(self, collection_name: str) -> Tuple[ChannelPrim, ...]:\n \"\"\"\n\n geometryChannels(self, collection_name) -> tuple of hou.ChannelPrim\n\n Returns a tuple of channel primitives in a given geometry channels\n collection.\n\n\n \"\"\"\n def geometryChannelCollectionNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n geometryChannelCollectionNames(self) -> tuple of str\n\n Returns a tuple of the names of geometry collections added to the\n channel list.\n\n\n \"\"\"\n def removeGeometryChannels(self, collection_name: str) -> None:\n \"\"\"\n\n removeGeometryChannels(self, collection_name=None)\n\n Removes the geometry channels collection with the provided name from\n the channel list.\n\n\n collection_name\n Name of the geometry channels collection to remove.\n\n\n \"\"\"\n def selectGeometryChannel(self, collection_name: str, channel: str|None = ...) -> str:\n \"\"\"\n\n selectGeometryChannel(self, collection_name, channel=None)\n\n Selects a geometry channel. If no channel is provided, selects all\n channels within the collection.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel to select. None by default.\n\n\n \"\"\"\n def deselectGeometryChannel(self, collection_name: str, channel: str|None = ...) -> str:\n \"\"\"\n\n deselectGeometryChannel(self, collection_name, channel=None)\n\n Deselects a geometry channel. If no channel is provided, deselects\n all channels within the collection.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel to deselect. None by default.\n\n\n \"\"\"\n def pinGeometryChannel(self, collection_name: str, channel: str|None = ...) -> str:\n \"\"\"\n\n pinGeometryChannel(self, collection_name, channel=None)\n\n Pins a geometry channel. If no channel is provided, pins all\n channels within the collection.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel to pin. None by default.\n\n\n \"\"\"\n def unpinGeometryChannel(self, collection_name: str, channel: str|None = ...) -> str:\n \"\"\"\n\n unpinGeometryChannel(self, collection_name, channel=None)\n\n Unpins a geometry channel. If no channel is provided, unpins all\n channels within the collection.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel to unpin. None by default.\n\n\n \"\"\"\n def selectGeometryChannelValue(self, collection_name: str, channel: str|None = ...) -> str:\n \"\"\"\n\n selectGeometryChannelValue(self, collection_name, channel=None)\n\n Selects the value column of a geometry channel. If no channel is\n provided, selects the values of all channels within the collection.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel to select. None by default.\n\n\n \"\"\"\n def deselectGeometryChannelValue(self, collection_name: str, channel: str|None = ...) -> str: ...\n def containsGeometryChannel(self, collection_name: str, channel: str|None = ...) -> bool:\n \"\"\"\n\n containsGeometryChannel(self, collection_name, channel=None) -> bool\n\n Returns whether or not a geometry channel is present in the channel\n list. If a channel name is not provided, returns whether or not the\n collection is present.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel. None by default.\n\n\n \"\"\"\n def isGeometryChannelSelected(self, collection_name: str, channel: str) -> bool:\n \"\"\"\n\n isGeometryChannelSelected(self, collection_name, channel) -> bool\n\n Returns whether or not a geometry channel is selected.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel.\n\n\n \"\"\"\n def isGeometryChannelPinned(self, collection_name: str, channel: str) -> bool:\n \"\"\"\n\n isGeometryChannelPinned(self, collection_name, channel) -> bool\n\n Returns whether or not a geometry channel is pinned.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel.\n\n\n \"\"\"\n def isGeometryChannelValueSelected(self, collection_name: str, channel: str) -> bool:\n \"\"\"\n\n isGeometryChannelValueSelected(self, collection_name, channel) -> bool\n\n Returns whether or not the value column of a geometry channel is\n selected.\n\n\n collection_name\n Name of the geometry channels collection.\n\n channel\n Name of the channel.\n\n\n \"\"\"\n def filter(self) -> str:\n \"\"\"\n\n filter(self) -> str\n\n Returns the channel list filter string.\n\n\n \"\"\"\n def keepSelection(self) -> bool:\n \"\"\"\n\n keepSelection(self) -> bool\n\n Returns the channel list Keep Selection flag.\n\n\n \"\"\"\n def enableFilter(self) -> bool:\n \"\"\"\n\n enableFilter(self) -> bool\n\n Returns True if the channel list filtering is active.\n\n\n \"\"\"\n def filterTranslates(self) -> bool:\n \"\"\"\n\n filterTranslates(self) -> bool\n\n Returns True if the channel list translations filtering is active.\n\n\n \"\"\"\n def filterRotates(self) -> bool:\n \"\"\"\n\n filterRotates(self) -> bool\n\n Returns True if the channel list rotations filtering is active.\n\n\n \"\"\"\n def filterScales(self) -> bool:\n \"\"\"\n\n filterScales(self) -> bool\n\n Returns True if the channel list scales filtering is active.\n\n\n \"\"\"\n def setFilter(self, pattern: str) -> None:\n \"\"\"\n\n setFilter(self,pattern)`\n\n Set the channel list filter string.\n\n\n pattern\n A pattern string.\n\n\n \"\"\"\n def setKeepSelection(self, value: bool) -> None:\n \"\"\"\n\n setKeepSelection(self,on)\n\n Set the channel list Keep Selection flag.\n\n\n \"\"\"\n def setEnableFilter(self, value: bool) -> None:\n \"\"\"\n\n setEnableFilter(self,on)\n\n Enable/Disable the channel list filtering.\n\n\n \"\"\"\n def setFilterTranslates(self, value: bool) -> None:\n \"\"\"\n\n setFilterTranslates(self,on)\n\n Enable/Disable channel list translations filtering.\n\n\n \"\"\"\n def setFilterRotates(self, value: bool) -> None:\n \"\"\"\n\n setFilterRotates(self,on)\n\n Enable/Disable channel list rotations filtering.\n\n\n \"\"\"\n def setFilterScales(self, value: bool) -> None:\n \"\"\"\n\n setFilterScales(self,on)\n\n Enable/Disable channel list scales filtering.\n\n\n \"\"\"\n def asCode(self, var_name: str = ...) -> str:\n \"\"\"\n\n asCode(self,var_name) -> str\n\n Returns a python code string that be run to recreate a ChannelList\n with the same content as the current object.\n\n\n var_name\n The variable name used in the generated code for the channel\n list. It defaults to chanlist.\n\n\n \"\"\"\n\nclass ChannelPrim(Prim):\n \"\"\"\n\n hou.ChannelPrim\n\n A ChannelPrim is a geometry primitive (Prim object) which stores channel\n data.\n\n Channel primitives are lightweight, standalone channels optimized for\n quick evaluation. The following example demonstrates how to construct,\n insert keys into, and evaluate a channel primitive:\n\n > # Create a mutable geometry\n > g = hou.Geometry()\n > # Add a new channel primitive to the geometry\n > chan = g.createChannelPrim()\n > \n > keys = [24, 48, 72, 96]\n > values = [0.5, 1.0, 1.5, 2.0]\n > \n > # Insert keys at the specified frames and set their values\n > for i in range(len(keys)):\n > chan.insertKey(keys[i])\n > chan.setKeyValue(keys[i], values[i])\n > \n > # Smooth the slopes of all keys\n > chan.smoothAutoSlopes()\n > \n > # Evaluate the channel at frame 36\n > value = chan.eval(36)\n\n Channel primitives can also be added to the global channel list in order\n to visualize and edit them on the playbar or animation editor. For an\n example of this, see hou.ChannelList.addGeometryChannels.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def vertex(self, index: int) -> Vertex:\n \"\"\"\n\n vertex(self, index)\n\n A shortcut for self.vertices()[index]. You probably don't need to\n call this method.\n\n This method supports negative indices to index from the end, just\n like self.vertices()[index] would. Also, like Python's indexing\n operator, it will raise IndexError when the index is out of range.\n\n\n \"\"\"\n def addVertex(self, point: Point) -> Vertex:\n \"\"\"\n\n addVertex(self, point) -> hou.Vertex\n\n Creates a new vertex inside this channel primitive, adding it to the\n end of the vertex list. You would typically call this method from\n the code of a Python-defined SOP.\n\n point is a hou.Point object that the new vertex will refer to. See\n hou.Vertex for information on the relationship between points and\n vertices.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also:\n\n * hou.Geometry.createPoint\n\n\n \"\"\"\n def start(self) -> float:\n \"\"\"\n\n start(self) -> float\n\n Returns the start frame of this channel primitive.\n\n\n \"\"\"\n def end(self) -> float:\n \"\"\"\n\n end(self) -> float\n\n Returns the end frame of this channel primitive.\n\n\n \"\"\"\n def length(self) -> float:\n \"\"\"\n\n length(self) -> float\n\n Returns the length in frames of this channel primitive.\n\n\n \"\"\"\n def setStart(self, frame: float) -> None:\n \"\"\"\n\n setStart(frame: float)\n\n Sets the start frame of this channel primitive.\n\n\n \"\"\"\n def defaultValue(self) -> float:\n \"\"\"\n\n defaultValue(self) -> float\n\n Returns the default value for this channel primitive, which is used\n when the channel is empty.\n\n\n \"\"\"\n def setDefaultValue(self, value: float) -> None:\n \"\"\"\n\n setDefaultValue(self, value: float)\n\n Sets the default value for this channel primitive.\n\n\n \"\"\"\n def eval(self, frame: float) -> float:\n \"\"\"\n\n eval(self, frame: float) -> float\n\n Evaluates the channel at the given frame, returning the result.\n\n\n \"\"\"\n def hasKeyAtFrame(self, frame: float) -> bool:\n \"\"\"\n\n hasKeyAtFrame(self, frame: float) -> bool\n\n Returns whether or not the channel has a key at the given frame.\n\n\n \"\"\"\n def insertKey(self, frame: float, auto_slope: bool = True) -> None:\n \"\"\"\n\n insertKey(self, frame: float, auto_slope = True)\n\n Inserts a key at the given frame, if there isn't one already. If the\n frame is outside the channel's current range, it will be extended\n accordingly.\n\n auto_slope determines whether slopes for this key are set\n automatically or manually.\n\n\n \"\"\"\n def destroyKey(self, frame: float) -> None:\n \"\"\"\n\n destroyKey(self, frame: float)\n\n Destroys a key at the given frame, if one exists.\n\n\n \"\"\"\n def destroyKeys(self, frame_start: float, frame_end: float) -> None:\n \"\"\"\n\n destroyKeys(self, frame_start: float, frame_end: float)\n\n Destroys all keys in the given time range, inclusive.\n\n\n \"\"\"\n def clear(self) -> None:\n \"\"\"\n\n clear(self)\n\n Clears the channel primitive, removing all keys and segments.\n\n\n \"\"\"\n def keyIndex(self, frame: float) -> int:\n \"\"\"\n\n keyIndex(self, frame: float) -> int\n\n Returns the index of the key at the given frame, or -1 if there is\n no key at that frame.\n\n\n \"\"\"\n def setKeyValue(self, frame: float, value: float, key_half: Optional[EnumValue] = None) -> bool:\n \"\"\"\n\n setKeyValue(self, frame: float, value: float, key_half =\n hou.keyHalf.InOut) -> bool\n\n Sets the value of the key at the given frame, if one exists. Returns\n False if no key exists at the given frame.\n\n key_half is a hou.keyHalf which defines the side of the key to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out will create a discontinuity at this key.\n\n\n \"\"\"\n def setKeySlope(self, frame: float, slope: float, key_half: Optional[EnumValue] = None) -> bool:\n \"\"\"\n\n setKeySlope(self, frame: float, slope: float, key_half =\n hou.keyHalf.InOut) -> bool\n\n Sets the slope of the key at the given frame. Returns False if no\n key exists at the given frame.\n\n key_half is a hou.keyHalf which defines the side of the key to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out will create a discontinuity in the slope at this\n key.\n\n\n \"\"\"\n def setKeyAccel(self, frame: float, accel: float, key_half: Optional[EnumValue] = None) -> bool:\n \"\"\"\n\n setKeyAccel(self, frame: float, accel: float, key_half =\n hou.keyHalf.InOut) -> bool\n\n Sets the acceleration of the key at the given frame, if one exists.\n Returns False if no key exists at the given frame.\n\n key_half is a hou.keyHalf which defines the side of the key to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out will create a discontinuity in the acceleration at\n this key.\n\n\n \"\"\"\n def keyValue(self, frame: float, key_half: Optional[EnumValue] = None) -> float:\n \"\"\"\n\n keyValue(self, frame: float, value: float, key_half = hou.keyHalf.Out)\n -> float\n\n Returns the value of the key at the given frame, if one exists.\n\n key_half is a hou.keyHalf which defines the side of the key to get.\n\n\n \"\"\"\n def keySlope(self, frame: float, key_half: Optional[EnumValue] = None) -> float:\n \"\"\"\n\n keySlope(self, frame: float, value: float, key_half = hou.keyHalf.Out)\n -> float\n\n Returns the slope of the key at the given frame, if one exists.\n\n key_half is a hou.keyHalf which defines the side of the key to get.\n\n\n \"\"\"\n def keyAccel(self, frame: float, key_half: Optional[EnumValue] = None) -> float:\n \"\"\"\n\n keyAccel(self, frame: float, value: float, key_half = hou.keyHalf.Out)\n -> float\n\n Returns the acceleration of the key at the given frame, if one\n exists.\n\n key_half is a hou.keyHalf which defines the side of the key to get.\n\n\n \"\"\"\n def setKeyAutoSlope(self, frame: float, auto_slope: bool, key_half: Optional[EnumValue] = None) -> bool:\n \"\"\"\n\n setKeyAutoSlope(self, frame: float, auto_slope: bool, key_half =\n hou.keyHalf.InOut) -> bool\n\n Sets the auto slope property of the key at the given frame, if one\n exists. Returns False if no key exists at the given frame.\n\n key_half is a hou.keyHalf which defines the side of the key to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out results in only the respective half of the key's\n slope being affected when hou.ChannelPrim.smoothAutoSlopes is\n called, which will create a discontinuity in the slope at this key.\n\n\n \"\"\"\n def segmentType(self, frame: float) -> EnumValue:\n \"\"\"\n\n segmentType(self, frame: float) -> hou.segmentType\n\n Returns the type of the segment at the given frame.\n\n\n \"\"\"\n def setSegmentType(self, frame: float, type: EnumValue) -> None:\n \"\"\"\n\n setSegmentType(self, frame: float, type)\n\n Sets the type of the segment at the given frame, where type is a\n hou.segmentType.\n\n\n \"\"\"\n def keyFrames(self) -> Tuple[float, ...]:\n \"\"\"\n\n keyFrames(self) -> tuple\n\n Returns an ordered list of frames at which keys exist in this\n channel.\n\n\n \"\"\"\n def keyValues(self, key_half: Optional[EnumValue] = None) -> Tuple[float, ...]:\n \"\"\"\n\n keyValues(self, key_half = hou.keyHalf.Out) -> tuple\n\n Returns a list of the values of each key (ordered by frame) in this\n channel.\n\n key_half is a hou.keyHalf which defines the side of the key to get.\n\n\n \"\"\"\n def keySlopes(self, key_half: Optional[EnumValue] = None) -> Tuple[float, ...]:\n \"\"\"\n\n keySlopes(self, key_half = hou.keyHalf.Out) -> tuple\n\n Returns a list of the slopes of each key (ordered by frame) in this\n channel.\n\n key_half is a hou.keyHalf which defines whether to get the out-slope\n or in-slope.\n\n\n \"\"\"\n def keyAccels(self, key_half: Optional[EnumValue] = None) -> Tuple[float, ...]:\n \"\"\"\n\n keyAccels(self, key_half = hou.keyHalf.Out) -> tuple\n\n Returns a list of the accelerations of each key (ordered by frame)\n in this channel.\n\n key_half is a hou.keyHalf which defines whether to get the out-\n acceleration or in-acceleration.\n\n\n \"\"\"\n def setKeyValues(self, values: Sequence[float], key_half: Optional[EnumValue] = None) -> None:\n \"\"\"\n\n setKeyValues(self, values: list[float], key_half = hou.keyHalf.InOut)\n\n Sets the values of each key in the channel.\n\n values is a list of floats which contains the values to set. Its\n length must match the channel's length as given by channel.length().\n\n key_half is a hou.keyHalf which defines the side of the keys to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out will create discontinuities at each key.\n\n\n \"\"\"\n def setKeySlopes(self, slopes: Sequence[float], key_half: Optional[EnumValue] = None) -> None:\n \"\"\"\n\n setKeySlopes(self, slopes: list[float], key_half = hou.keyHalf.InOut)\n\n Sets the slopes of each key in the channel.\n\n slopes is a list of floats which contains the slope values to set.\n Its length must match the channel's length as given by\n channel.length().\n\n key_half is a hou.keyHalf which defines the side of the keys to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out will create discontinuities in the slopes at each\n key.\n\n\n \"\"\"\n def setKeyAccels(self, accels: Sequence[float], key_half: Optional[EnumValue] = None) -> None:\n \"\"\"\n\n setKeyAccels(self, accels: list[float], key_half = hou.keyHalf.InOut)\n\n Sets the accelerations of each key in the channel.\n\n accels is a list of floats which contains the acceleration values to\n set. Its length must match the channel's length as given by\n channel.length().\n\n key_half is a hou.keyHalf which defines the side of the keys to set\n (in, out, or both). Setting this to hou.keyHalf.In or\n hou.keyHalf.Out will create discontinuities in the accelerations at\n each key.\n\n\n \"\"\"\n def moveKeyframes(self, key_indices: Sequence[int], frame_offsets: Sequence[float]) -> None:\n \"\"\"\n\n moveKeyframes(self, key_indices, frame_offsets)\n\n Shifts the keys at the given indices by the offsets, specified in\n frames.\n\n key_indices is a tuple of integers, each specifying an index of a\n key to move.\n\n frame_offsets is a tuple of numbers, specifying the offset to apply\n to each key. It must either be the same length as the key_indices\n tuple, or it must be a tuple of a single element, in which case all\n specified keys will be shifted by the same offset.\n\n\n \"\"\"\n def smoothAutoSlopes(self, force: bool = False) -> None:\n \"\"\"\n\n smoothAutoSlopes(self, force: bool = False)\n\n Smooths the slopes of any keys with the auto slope flag set to true.\n If the force parameter is set to True, smooths the slopes of all\n keys regardless of the auto slope flag.\n\n\n \"\"\"\n def smoothAutoSlopesForKeys(self, start_index: int, end_index: int = -1, force: bool = False) -> None:\n \"\"\"\n\n smoothAutoSlopesForKeys(self, start_index, end_index = -1, force: bool =\n False)\n\n Smooths the slopes of any keys in the given range which have the\n auto slope flag set to true. If the force parameter is set to True,\n smooths the slopes of all keys in the range regardless of the auto\n slope flag.\n\n start_index is the index at which to start smoothing auto slopes\n\n end_index is the index at which to stop smoothing slopes. If\n omitted, only the key at the start_index will be smoothed.\n\n\n \"\"\"\n\nclass ChopNode(OpNode):\n \"\"\"\n\n hou.ChopNode\n\n Class representing a CHOP node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isBypassed(self) -> bool:\n \"\"\"\n\n isBypassed(self) -> bool\n\n Returns whether the node's bypass flag is on.\n\n\n \"\"\"\n def bypass(self, on: bool) -> None:\n \"\"\"\n\n bypass(self, on)\n\n Turn the node's bypass flag on or off, making this node have no\n effect.\n\n\n \"\"\"\n def isLocked(self) -> bool:\n \"\"\"\n\n isLocked(self) -> bool\n\n Returns whether this node's lock flag is on.\n\n\n \"\"\"\n def setLocked(self, on: bool) -> None:\n \"\"\"\n\n setLocked(self, on)\n\n Turn this node's lock flag on or off. Locking a node saves its\n current cooked channel data into the node. If you unlock a locked\n node, it will discard its locked channel data and recook, computing\n its channel data from its inputs and parameters.\n\n\n \"\"\"\n def isDisplayFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayFlagSet(self) -> bool\n\n Returns whether the node's display flag is on.\n\n\n \"\"\"\n def setDisplayFlag(self, on: bool) -> None:\n \"\"\"\n\n setDisplayFlag(self, on)\n\n Turns the node's display flag to on or off.\n\n\n \"\"\"\n def isAudioFlagSet(self) -> bool:\n \"\"\"\n\n isAudioFlagSet(self) -> bool\n\n Returns whether the node's audio flag is on.\n\n\n \"\"\"\n def setAudioFlag(self, on: bool) -> None:\n \"\"\"\n\n setAudioFlag(self, on)\n\n Turns the node's audio flag on or off.\n\n\n \"\"\"\n def isExportFlagSet(self) -> bool:\n \"\"\"\n\n isExportFlagSet(self) -> bool\n\n Returns whether the node's export flag is on.\n\n\n \"\"\"\n def setExportFlag(self, on: bool) -> None:\n \"\"\"\n\n setExportFlag(self, on)\n\n Turns the node's export flag to on or off.\n\n\n \"\"\"\n def isUnloadFlagSet(self) -> bool:\n \"\"\"\n\n isUnloadFlagSet(self) -> bool\n\n Returns whether the node's unload flag is on.\n\n\n \"\"\"\n def setUnloadFlag(self, on: bool) -> None:\n \"\"\"\n\n setUnloadFlag(self, on)\n\n Turns the node's unload flag to on or off.\n\n\n \"\"\"\n def isCurrentFlagSet(self) -> bool:\n \"\"\"\n\n isCurrentFlagSet(self) -> bool\n\n Returns whether the node's current flag is on.\n\n\n \"\"\"\n def setCurrentFlag(self, on: bool) -> None:\n \"\"\"\n\n setCurrentFlag(self, on)\n\n Turns the node's audio flag on or off.\n\n\n \"\"\"\n def tracks(self, output_index: int = 0, cook: bool = True) -> Tuple[Track, ...]:\n \"\"\"\n\n tracks(self) -> tuple of Tracks\n\n Returns a tuple of all the tracks in this node.\n\n\n \"\"\"\n def track(self, track_name: str, output_index: int = 0, cook: bool = True) -> Optional[Track]:\n \"\"\"\n\n track(self, track_name) -> hou.Track or None\n\n Return the track of the given name, or None if it doesn't exist.\n\n\n \"\"\"\n def clip(self, output_index: int = 0) -> Clip:\n \"\"\"\n\n clip(self, output_index=0) -> hou.Clip\n\n Returns the CHOP node's clip.\n\n\n output_index\n If the CHOP has multiple outputs, this specifies which output's\n clip is returned.\n\n\n \"\"\"\n def sampleRate(self) -> float:\n \"\"\"\n\n sampleRate(self) -> double\n\n Returns the sample rate used by this node in number of samples per\n second.\n\n\n \"\"\"\n def sampleRange(self) -> Tuple[float, float]:\n \"\"\"\n\n sampleRange(self) -> (start, end)\n\n Return a 2-tuple containing the start and end values of the sample\n range. The number of samples for each track in this node is start-\n end+1. Note that samples start from 0, not 1.\n\n\n \"\"\"\n def frameToSamples(self, frame: float) -> float:\n \"\"\"\n\n frameToSamples(self, frame) -> double\n\n Converts a value expressed as frames to a value expressed in\n samples.\n\n\n \"\"\"\n def samplesToFrame(self, samples: float) -> float:\n \"\"\"\n\n samplesToFrame(self, samples) -> double\n\n Converts a value expressed as samples to a value expressed in\n frames.\n\n\n \"\"\"\n def timeToSamples(self, time: float) -> float:\n \"\"\"\n\n timeToSamples(self, time) -> double\n\n Converts a value expressed in seconds to a value expressed in\n samples.\n\n\n \"\"\"\n def samplesToTime(self, samples: float) -> float:\n \"\"\"\n\n samplesToTime(self, samples) -> double\n\n Converts a value expressed as samples to a value expressed in\n seconds.\n\n\n \"\"\"\n def clipData(self, binary: Any) -> bytes:\n \"\"\"\n\n clipData(self, binary) -> str for Python 2, bytes for Python 3\n\n Returns the clip data for the CHOP node in ASCII or binary,\n depending on the value of the binary parameter.\n\n The returned clip data is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n \"\"\"\n def setClipData(self, source: bytes, binary: bool, offset: float = 0, rename: Optional[str] = None) -> None:\n \"\"\"\n\n setClipData(self, data, binary)\n\n Sets the clip data for the CHOP node. Should only be called on\n locked nodes.\n\n\n \"\"\"\n def saveClip(self, file_name: str) -> bool:\n \"\"\"\n\n saveClip(self, file_name)\n\n Saves the node's output clip to a file. The filename extension\n determines the file format to use.\n\n\n \"\"\"\n\nclass Clip:\n \"\"\"\n\n hou.Clip\n\n Class representing an animation clip.\n\n RELATED\n\n * hou.ChopNode\n\n * hou.Track\n\n * hou.AgentClip\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__()\n\n Creates an empty clip.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def chopNode(self) -> Optional[ChopNode]:\n \"\"\"\n\n chopNode(self) -> hou.ChopNode\n\n Returns the hou.ChopNode owner of this clip. This returns None if\n the clip is not owned by a CHOP.\n\n\n \"\"\"\n def chopNodeOutputIndex(self) -> int:\n \"\"\"\n\n chopNodeOutputIndex(self) -> int\n\n Returns the index of the CHOP node output that this clip corresponds\n to. This returns -1 if the clip is not owned by a CHOP.\n\n\n \"\"\"\n def tracks(self) -> Tuple[Track, ...]:\n \"\"\"\n\n tracks(self) -> tuple of hou.Track\n\n Returns a tuple of all the tracks in this clip.\n\n\n \"\"\"\n def track(self, track_name: str) -> Optional[Track]:\n \"\"\"\n\n track(self, track_name) -> hou.Track or None\n\n Returns the track of the given name, or None if it doesn't exist.\n\n\n \"\"\"\n def sampleRate(self) -> float:\n \"\"\"\n\n sampleRate(self) -> double\n\n Returns the sample rate used by this clip in number of samples per\n second.\n\n\n \"\"\"\n def sampleRange(self) -> Tuple[float, float]:\n \"\"\"\n\n sampleRange(self) -> (start, end)\n\n Return a 2-tuple containing the start and end values of the sample\n range. The number of samples for each track in this node is start-\n end+1. Note that samples start from 0, not 1.\n\n\n \"\"\"\n def numSamples(self) -> int:\n \"\"\"\n\n numSamples(self) -> int\n\n Return the number of samples in this clip.\n\n\n \"\"\"\n def frameToSamples(self, frame: float) -> float:\n \"\"\"\n\n frameToSamples(self, frame) -> double\n\n Converts a value expressed as frames to a value expressed in\n samples.\n\n\n \"\"\"\n def samplesToFrame(self, samples: float) -> float:\n \"\"\"\n\n samplesToFrame(self, samples) -> double\n\n Converts a value expressed as samples to a value expressed in\n frames.\n\n\n \"\"\"\n def timeToSamples(self, time: float) -> float:\n \"\"\"\n\n timeToSamples(self, time) -> double\n\n Converts a value expressed in seconds to a value expressed in\n samples.\n\n\n \"\"\"\n def samplesToTime(self, samples: float) -> float:\n \"\"\"\n\n samplesToTime(self, samples) -> double\n\n Converts a value expressed as samples to a value expressed in\n seconds.\n\n\n \"\"\"\n def loadFromFile(self, filename: str) -> None:\n \"\"\"\n\n loadFromFile(self, file_name)\n\n Loads the clip from a file, such as a .bclip.\n\n\n \"\"\"\n def saveToFile(self, filename: str) -> None:\n \"\"\"\n\n saveToFile(self, file_name)\n\n Saves the clip to a file. The filename extension determines the file\n format to use.\n\n\n \"\"\"\n def mode(self) -> EnumValue:\n \"\"\"\n\n mode(self) -> hou.clipMode\n\n Returns the CHOP evaluation mode that was used by the CHOP to\n produce the clip.\n\n\n \"\"\"\n\nclass clone:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def runAsClone(start_port: int = 0, end_port: int = -1, debug: bool = False, block: bool = False, print_port: bool = False, connection_timeout_seconds: int = -1) -> None:\n \"\"\"\n\n hou.clone.runAsClone\n\n Causes the current process to operate as a clone process.\n\n USAGE\n runAsClone(start_port=0, end_port=-1, debug=False, block=False,\n print_port=False, connection_timeout_seconds=-1)\n\n This method opens a network port to receive connections from a host\n process. Once connected, the host process sends its hip file contents\n and any changes made in the host process. This process maintains its\n network state to match the host process, and sends back rendered images\n to the host.\n\n Both graphical and non-graphical Houdini processes can act as clones.\n Using a graphical Houdini process as a clone may be useful for\n debugging, but generally clone processes will be non-graphical (hbatch\n or hython). Note that the synchronization if one way, from host to\n clones. Changes made in the clone process are not sent to the host\n process, and may cause issues with the synchronization of future changes\n from the host.\n\n Generally (except for debugging) it is easiest to run a clone process in\n a blocking mode where user input and interaction with the clone process\n is not permitted until the host process disconnects. This is controlled\n with the block parameter.\n\n\n start_port\n The lowest TCP/IP port number that can be opened for the host to\n establish a connection. The default value of 0 indicates that any\n available port can be used. In some renderfarm setups, only certain\n ports will allow a connection to be made from the host to the clone\n process. These restrictions will depend on the configuration of the\n firewall between the host and clone machines.\n\n end_port\n Highest TCP/IP port number that can be opened to receive the host\n connection. The default value of -1 allows any port number higher\n than the start_port.\n\n debug\n Sets the clone process' networking debug mode. Setting this to True\n will cause additional logging of networking events.\n\n block\n Controls whether user interation with this process should be\n blocked. This block lasts as long as a host process is connected to\n this clone (or the connection timeout expires without any host\n connection being established).\n\n print_port\n Set this to True to have this process output its port number to the\n standard output stream. The output will be of the form\n HOUDINI_CLONE_PORT=12345. The printing of this port is often\n necessary for the host process (which often launches the clone\n process) to know what port number it can use to connect to the clone\n process. The only other way to know the clone's port number is by\n setting the start_port and end_port parameters to the same fixed\n value.\n\n connection_timeout_seconds\n Indicates how long this method should wait for a host connection to\n be established before giving up and closing the connection port.\n This setting can help prevent zombie processes on a render farm, but\n be sure to allocate enough time for the host process to establish\n communication with the clone.\n\n\n \"\"\"\n @staticmethod\n def isRunningAsClone() -> bool:\n \"\"\"\n\n hou.clone.isRunningAsClone\n\n Return whether the current process is operating as a clone process.\n\n USAGE\n isRunningAsClone()\n\n Returns True if hou.clone.runAsClone has been called in this process,\n and the clone has not yet been shut down.\n\n\n \"\"\"\n @staticmethod\n def createClone(id: Optional[str] = None) -> _clone_Connection:\n \"\"\"\n\n hou.clone.createClone\n\n Creates a new hou.clone.Connection object.\n\n USAGE\n createClone(cloneid=None)\n\n Creates and returns a new default hou.clone.Connection object with the\n provided unique identifier. Note that this does not start a new clone\n process or establish a connection. It simply creates the connection\n object so that it can be configured and connected later. The\n hou.clone.Connection.duplicate method can also be used to create a new\n connection object.\n\n\n cloneid\n The unique identifier for the new clone connection. If this value is\n None or an empty string, a unique identifier is created\n automatically. If a clone with the provided identifier already\n exists, the provided identifier increments a numeric suffix until\n the identifier does not match any existing connectino object.\n\n\n \"\"\"\n @staticmethod\n def clones() -> Tuple[_clone_Connection, ...]:\n \"\"\"\n\n hou.clone.clones\n\n Return a tuple of all hou.clone.Connection objects.\n\n USAGE\n clones()\n\n Use this method to get access to all hou.clone.Connection objects that\n currently exist. To more efficiently look up a specific connection\n object, use hou.clone.clone instead.\n\n\n \"\"\"\n @staticmethod\n def clone(id: str) -> Optional[_clone_Connection]:\n \"\"\"\n\n hou.clone.clone\n\n Return a specific hou.clone.Connection object.\n\n USAGE\n clone(cloneid)\n\n Every hou.clone.Connection object has a unique identifier associated\n with it (see hou.clone.Connection.sessionId). This method returns the\n connection object that corresponds to the provided unique identifier.\n\n\n cloneid\n The unique identifier of the clone object that should be returned.\n If the provided identifier does not correspond to an existing\n hou.clone.Connection object, this method returns None.\n\n\n \"\"\"\n @staticmethod\n def deleteClone(id: str) -> None:\n \"\"\"\n\n hou.clone.deleteClone\n\n Deletes a hou.clone.Connection.\n\n USAGE\n deleteClone(cloneid)\n\n Disconnects and deletes an existing hou.clone.Connection object. This is\n different from simply disconnecting a clone using\n hou.clone.Connection.disconnect, after which the connection object still\n exists and can be reconnected. After calling this method, the provided\n clone identifier ceases to be valid,\n\n\n cloneid\n The unique identifier of the clone conenction object to delete. If\n the provided clone identifier doesn't correspond to an existing\n clone, this method does nothing.\n\n\n \"\"\"\n @staticmethod\n def deleteDisconnectedClones() -> None:\n \"\"\"\n\n hou.clone.deleteDisconnectedClones\n\n Deletes all disconnected hou.clone.Connection.\n\n USAGE\n deleteDisconnectedClones()\n\n This method is a shortcut for calling hou.clone.clones, checking the\n connection status of each clone, and calling for every clone that is not\n currently connected.\n\n\n \"\"\"\n @staticmethod\n def removeAllConnectionChangeCallbacks() -> None:\n \"\"\"\n\n hou.clone.removeAllConnectionChangeCallbacks\n\n Deregister all connection change callback methods.\n\n USAGE\n removeAllConnectionChangeCallbacks()\n\n This method is a shortcut for calling\n hou.clone.connectionChangeCallbacks and calling\n hou.clone.removeConnectionChangeCallback for each returned callback\n method.\n\n\n \"\"\"\n @staticmethod\n def removeAllImageChangeCallbacks() -> None:\n \"\"\"\n\n hou.clone.removeAllImageChangeCallbacks\n\n Deregister all image change callback methods.\n\n USAGE\n removeAllImageChangeCallbacks()\n\n This method is a shortcut for calling hou.clone.imageChangeCallbacks and\n calling hou.clone.removeImageChangeCallback for each returned callback\n method.\n\n\n \"\"\"\n @staticmethod\n def addConnectionChangeCallback(callback: Callable[[str], None]) -> None:\n \"\"\"\n\n hou.clone.addConnectionChangeCallback\n\n Registers a callback method to be run any time a hou.clone.Connection is\n modified.\n\n USAGE\n addConnectionChangeCallback(callback)\n\n This method allows code to monitor clone connections for creation,\n removal, and changes of configuration or state. To monitor changes to\n incoming rendered images, the hou.clone.addImageChangeCallback method\n must be used.\n\n\n callback\n The function that is invoked when a connection object changes. This\n method should accept a single cloneid parameter, which is the unique\n identifier of the clone object that has changed. Because this\n callback can indicate the destruction of a clone object, be aware\n that calling hou.clone.clone with this cloneid value may return\n None.\n\n\n \"\"\"\n @staticmethod\n def removeConnectionChangeCallback(callback: Callable[[str], None]) -> None:\n \"\"\"\n\n hou.clone.removeConnectionChangeCallback\n\n Deregisters a specific connection change callback method.\n\n USAGE\n removeConnectionChangeCallback(callback)\n\n Removes the provided callback from the list of methods that are run when\n a clone connection's state changes. This is the opposite of the\n hou.clone.addConnectionChangeCallback method.\n\n\n callback\n The callback method that should be deregistered. If this callback is\n not curently registered, this method raises a hou.OperationFailed\n exception.\n\n\n \"\"\"\n @staticmethod\n def connectionChangeCallbacks() -> Tuple[Callable[[str], None],...]:\n \"\"\"\n\n hou.clone.connectionChangeCallbacks\n\n Return a tuple of all registered connection change callbacks.\n\n USAGE\n connectionChangeCallbacks()\n\n Provides access to every callback method registered with the\n hou.clone.addConnectionChangeCallback method.\n\n\n \"\"\"\n @staticmethod\n def addImageChangeCallback(callback: Callable[[str], None]) -> None:\n \"\"\"\n\n hou.clone.addImageChangeCallback\n\n Registers a callback method to be run any time a hou.clone.Connection\n receives a new image.\n\n USAGE\n addImageChangeCallback(callback)\n\n This method allows code to monitor clone connections for changes to the\n any clone's rendered image. To monitor changes to the connection state,\n use hou.clone.addConnectionChangeCallback.\n\n\n callback\n The function that is invoked when a clone's rendered image is\n updated. This method should accept a single cloneid parameter, which\n is the unique identifier of the clone object whose image has\n changed.\n\n\n \"\"\"\n @staticmethod\n def removeImageChangeCallback(callback: Callable[[str], None]) -> None:\n \"\"\"\n\n hou.clone.removeImageChangeCallback\n\n Deregisters a specific image change callback method.\n\n USAGE\n removeImageChangeCallback(callback)\n\n Removes the provided callback from the list of methods that are run when\n a clone connection's rendered image changes. This is the opposite of the\n hou.clone.addImageChangeCallback method.\n\n\n callback\n The callback method that should be deregistered. If this callback is\n not curently registered, this method raises a hou.OperationFailed\n exception.\n\n\n \"\"\"\n @staticmethod\n def imageChangeCallbacks() -> Tuple[Callable[[str], None],...]:\n \"\"\"\n\n hou.clone.imageChangeCallbacks\n\n Return a tuple of all registered image change callbacks.\n\n USAGE\n imageChangeCallbacks()\n\n Provides access to every callback method registered with the\n hou.clone.addImageChangeCallback method.\n\n\n \"\"\"\n\nclass _clone_Connection:\n \"\"\"\n\n hou.clone.Connection\n\n Represents a connection to a clone process.\n\n These objects represent an active or potential connection to a Houdini\n clone process, either on the local machine or a remote machine. A\n connection can be connected and disconnected repeatedly, but the object\n continues to be valid. As with hou.Node objects, objects of thie type\n are references to the underlying connection object owned by the Houdini\n cloning framework. This means that all instances of this class that\n refer to the same underlying clone connection will affect each other.\n The underlying object can even be deleted in which case almost all\n methods on this object will raise exceptions (though the\n hou.clone.Connection.isValid method can be used to test if the\n underlying object still exists without raising an exception).\n\n Clone connections are identified by a unique session id string which\n behaves much like a Houdini node name. At any given time, the session id\n for each clone connection is unique. But session ids can be reused if a\n connection is deleted and a new one created. Clones connections are\n saved to the hip file, and are automatically disconnected when Huodini\n is shut down or a new hip file is opened. When opening a hip file, the\n loaded connection objects are always left in a disconnected state, and\n must be explicitly connected to start the clones processes.\n\n New connections can only be created by calling hou.clone.createClone or\n hou.clone.Connection.duplicate. Existing connection can be accessed\n using hou.clone.clone or hou.clone.clones.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isValid(self) -> bool:\n \"\"\"\n\n isValid() -> bool\n\n Return True if the connection associated with this object is still\n valid. Valid simply means that the underlying connection has not\n been deleted. This method and hou.clone.Connection.sessionId are the\n only methods that will not raise an exception when run after the\n underlying connection has been deleted.\n\n\n \"\"\"\n def sessionId(self) -> str:\n \"\"\"\n\n sessionId() -> str\n\n Return the unique string that can be used to identify this\n connection object, or fetch it from the cloning framework using the\n hou.clone.clone method. This value is set when constructing the\n connection and cannot be changed. This value has limitations like\n those for node names.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name() -> str\n\n Return the user-facing name for this clone.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(name)\n\n Checng the user-facing name for this clone. This is the name shown\n in the Clone control pane, and does not have any restrictions on its\n value (spaces and punctuation are allowed).\n\n\n \"\"\"\n def lopNode(self) -> Node:\n \"\"\"\n\n lopNode() -> hou.LopNode\n\n Return the LOP node that defines the stage which will be rendered by\n this clone.\n\n\n \"\"\"\n def setLopNode(self, lop: Node) -> None:\n \"\"\"\n\n setLopNode(lop)\n\n Set the LOP node that defines the stage which will be rendered by\n this clone. This value must be set for the clone to generate an\n image.\n\n\n \"\"\"\n def cameraPath(self) -> str:\n \"\"\"\n\n cameraPath() -> str\n\n Return the USD primitive path of the camera prim that defines the\n view that will be rendered by this clone.\n\n\n \"\"\"\n def setCameraPath(self, camerapath: str) -> None:\n \"\"\"\n\n setCameraPath(camerapath)\n\n Set the USD primitive path of the camera prim that defines the view\n that will be rendered by this clone. This path should point to a USD\n Camera primitive on the stage defined by the\n hou.clone.Connection.lopNode. This value must be set for the clone\n to generate an image.\n\n\n \"\"\"\n def renderer(self) -> str:\n \"\"\"\n\n renderer() -> str\n\n Return the name of the Render Delegate this clone will use.\n\n\n \"\"\"\n def setRenderer(self, renderer: str) -> None:\n \"\"\"\n\n setRenderer(renderer)\n\n Set the name of the Render Delegate this clone will use. This can be\n the internal name or label of any render delegate installed on the\n computer running this clone.\n\n\n \"\"\"\n def renderSettings(self) -> str:\n \"\"\"\n\n renderSettings() -> str\n\n Return the USD primitive path of the render settings prim that\n controls the rendering configurations for this clone.\n\n\n \"\"\"\n def setRenderSettings(self, rendersettings: str) -> None:\n \"\"\"\n\n setRenderSettings(rendersettings)\n\n Set the USD primitive path of the render settings prim that controls\n the rendering configurations for this clone. This path should point\n to a USD Render Settings primitive on the stage defined by the\n hou.clone.Connection.lopNode.\n\n\n \"\"\"\n def renderPass(self) -> str:\n \"\"\"\n\n renderPass() -> str\n\n Return the USD primitive path of the render pass prim, which\n controls the pass overrides applied to this clone.\n\n\n \"\"\"\n def setRenderPass(self, renderpass: str) -> None:\n \"\"\"\n\n setRenderPass(renderpass)\n\n Set the USD primitive path of the render pass prim, which controls\n the pass overrides applied to this render. This path should point to\n a USD Render Pass primitive on the stage defined by the\n hou.clone.Connection.lopNode.\n\n\n \"\"\"\n def availableAovs(self) -> Tuple[str, ...]:\n \"\"\"\n\n availableAovs(self) -> tuple of str\n\n Return the names of all AOVs generated by the clone render. This\n will return an empty tuple if the clone has not yet returned an\n image.\n\n\n \"\"\"\n def displayAov(self) -> str:\n \"\"\"\n\n displayAov(self) -> str\n\n Return the name of the AOV this clone should return to the host.\n This string may contain wildcards in which case multiple matching\n AOVs may be returned.\n\n\n \"\"\"\n def setDisplayAov(self, displayaov: str) -> None:\n \"\"\"\n\n setDisplayAov(self, aov)\n\n Set the name of the AOV this clone should return to the host. A\n string matching pattern can be specified to return multiple AOVs.\n Passing an empty string or None for the aov parameter instructs the\n clone to return all AOVs.\n\n\n \"\"\"\n def resolutionScale(self) -> float:\n \"\"\"\n\n resolutionScale(self) -> float\n\n Return the override resolution scale factor. This scaling is applied\n to the resolution set on the render settings for this clone. A value\n of 0 indicates that the render settings resolution will be used. A\n non-zero resolution scale value takes precedence over an override\n resolution explicitly set using setResolution.\n\n\n \"\"\"\n def setResolutionScale(self, resolution_scale: float) -> None:\n \"\"\"\n\n setResolutionScale(self, resolution_scale)\n\n Set the resolution scale for the image generated by this clone. This\n scale value is always applied to the resolution set on the render\n settings primitive. The value can be less than one to render a lower\n resolution image, or greater than one to render a higher resolution\n image. A value of 0 disables the resolution scaling.\n\n\n \"\"\"\n def resolution(self) -> Tuple[int, int]:\n \"\"\"\n\n resolution(self) -> (int, int)\n\n Return the override resolution set for the clone's returned image.\n If no override resolution has been set, this method returns (0, 0).\n In this case, the clone will generate an image with a resolution\n determined by the render settings primitive. A non-zero resolution\n scale value takes precedence over an override resolution explicitly\n set using setResolution, but the resolution scale setting does not\n affect the value returned by this method.\n\n\n \"\"\"\n def setResolution(self, width: int, height: int) -> None:\n \"\"\"\n\n setResolution(self, width, height)\n\n Set the resolution of the image generated by this clone. Specifying\n a width and height of 0 instructs the clone to generate an image\n with a resolution determined by the render settings primitive. A\n non-zero resolution scale value set with setResolutionScale takes\n precedence over an override resolution explicitly set using this\n method.\n\n\n \"\"\"\n def renderRegion(self) -> Vector4:\n \"\"\"\n\n renderRegion(self) -> hou.Vector4\n\n Return the render region set for the clone's returned image. If no\n override region has been set, this method returns (0.0, 0.0, 0.0,\n 0.0). In this case, the clone will generate an image using the data\n window specified on the render settings prim or, if no such value\n has been authored, a full frame (i.e., (0.0, 0.0, 1.0, 1.0)).\n\n\n \"\"\"\n def setRenderRegion(self, render_region: Vector4) -> None:\n \"\"\"\n\n setRenderRegion(self, render_region)\n\n Set the render region of the image generated by this clone, where\n render_region is of the form (x0, y0, x1, y1). Specifying a region\n of (0.0, 0.0, 0.0, 0.0) instructs the clone to generate an image\n using the data window specified on the render settings prim or, if\n no such value has been authored, a full frame (i.e., (0.0, 0.0, 1.0,\n 1.0)).\n\n\n \"\"\"\n def frameExpression(self) -> str:\n \"\"\"\n\n frameExpression(self) -> str\n\n Return a string specifying the expression that is run to generate\n the frame to which this clone should be set when cooking. If the\n returned string is empty, the frame number used by the clone will\n match the host's current frame number.\n\n\n \"\"\"\n def setFrameExpression(self, expression: str) -> None:\n \"\"\"\n\n setFrameExpression(self, expression)\n\n Set the expression that is run to generate the frame to which this\n clone should be set when cooking. The expression must always be a\n string, but can be any hscript expression that returns a number. For\n example, $F + 10 instructs the clone to cook ten frames ahead of the\n host's current frame. The expression is run in the host process, and\n the resulting value is sent to the clone.\n\n\n \"\"\"\n def contextOptionExpression(self, opt: str) -> str:\n \"\"\"\n\n contextOptionExpression(self, opt) -> str\n\n Return a string specifying the expression that is run to generate\n the value for the context option opt that this clone will use when\n cooking. If the returned string is empty, the context option value\n used by the clone will match the host's value for this option.\n\n\n \"\"\"\n def setContextOptionExpression(self, opt: str, expression: str) -> None:\n \"\"\"\n\n setContextOptionExpression(self, opt, expression)\n\n Set the expression that is run to generate the value for the context\n option opt that this clone uses when cooking. The expression must\n always be a string, but can be any hscript expression that returns a\n number or string. For example, $SHOT + 1 instructs the clone to cook\n with a value for SHOT that is one more than the host's value for\n this option. The expression is run in the host process, and the\n resulting value is sent to the clone.\n\n\n \"\"\"\n def contextOptionsWithExpressions(self) -> Tuple[str, ...]:\n \"\"\"\n\n contextOptionsWithExpressions(self) -> str\n\n Return a tuple of context option names that have expressions set for\n this clone, and thus where the clone's value for these context\n options may differ from the host process.\n\n\n \"\"\"\n def processUpdates(self) -> bool:\n \"\"\"\n\n processUpdates(self) -> bool\n\n Return a boolean value indicating whether the clone will restart its\n render in response to updates from the host.\n\n\n \"\"\"\n def setProcessUpdates(self, process_updates: bool) -> None:\n \"\"\"\n\n setProcessUpdates(self, process_updates)\n\n Configure the clone process to ignore updates from the host process,\n and continue rendering whatever stage is currently being rendered.\n\n\n \"\"\"\n def launcherConfig(self) -> dict[str, Any]:\n \"\"\"\n\n launcherConfig(self) -> dict\n\n Return a dictionary of configuration options that control the\n launcher plugin when starting up this clone process.\n\n\n \"\"\"\n def setLauncherConfig(self, config: dict[str, Any]) -> None:\n \"\"\"\n\n setLauncherConfig(self, config)\n\n Store the dictionary of launcher configuration options that should\n be used when launching this clone process. The contents and\n interpretation of this dictionary is under the discretion of the\n launcher plugin. It is stored with the clone connection object for\n convenience since launching a clone process is generally a pre-\n requisite to connecting to the clone.\n\n\n \"\"\"\n def connect(self, host: str, port: int) -> bool:\n \"\"\"\n\n connect(self, host, port) -> bool\n\n Connect this host to a running clone process on the specified host\n machine accessible through the provided TCP/IP port number. The\n connection attempt lasts for one second. If the connection is made,\n this method returns True. Returns False if the connection cannot be\n made for any reason. The host and port values are generally provided\n by the launcher plugin, which starts the clone process and reads the\n output from the process to determine the port number (which is\n output by the hou.clone.runAsClone method.\n\n\n \"\"\"\n def disconnect(self) -> None:\n \"\"\"\n\n disconnect(self)\n\n Disconnects from a connected clone process. Does nothing if the\n clone is not currently connected.\n\n\n \"\"\"\n def isConnected(self) -> bool:\n \"\"\"\n\n isConnected(self) -> bool\n\n Return true if this clone connection object represents an active\n connection to a clone process.\n\n\n \"\"\"\n def isWaitingToConnect(self) -> bool:\n \"\"\"\n\n isWaitingToConnect(self) -> bool\n\n Return true if setWaitingToConnect(True) has been called on this\n connection.\n\n\n \"\"\"\n def setWaitingToConnect(self, waiting_to_connect: bool) -> None:\n \"\"\"\n\n setWaitingToConnect(self, waiting_to_connect)\n\n Sets a flag on this connection indicating that it is waiting to\n connect to a clone process. This flag is only used as a visual hint\n and does not affect the operation of the clone framework. This flag\n can be set whether the clone is connected or disconnected. Only\n launcher plugins should set this flag, and only while waiting for a\n clone process to initialize or for a connection to be made to the\n clone process. Calling disconnect will also set this flag to False.\n\n\n \"\"\"\n def host(self) -> str:\n \"\"\"\n\n host(self) -> str\n\n Return the name of the host machine on which the connected clone\n process is running. Returns an empty string if there is no connected\n clone process.\n\n\n \"\"\"\n def port(self) -> int:\n \"\"\"\n\n port(self) -> int\n\n Return the port number used to connect to this object's clone\n process. Returns 0 if there is no connected clone process.\n\n\n \"\"\"\n def imagePath(self) -> str:\n \"\"\"\n\n imagePath(self) -> str\n\n Returns a string that can be used to access the image most recently\n returned by this clone. This string generally does not change when\n new images are sent from the clone, but this is not guaranteed. The\n format of this string will be of the form membuf:XXXXX. This unusual\n path value indicates that the image is not written to disk, but\n instead exists only as a block of memory. But Houdini nodes and HOM\n methods which can load images from disk will also be able to load\n the rendered image using this membuf path.\n\n\n \"\"\"\n def imageVersion(self) -> int:\n \"\"\"\n\n imageVersion(self) -> int\n\n A number that is increased every time a new image is sent to the\n host by this clone. This number can be used to detect when the image\n needs to be reloaded, redrawn, or otherwise re-processed to account\n for the updated image.\n\n\n \"\"\"\n def imageSize(self) -> Tuple[int, ...]:\n \"\"\"\n\n imageSize(self) -> tuple of int\n\n Returns a tuple of two integers that are the width and height of the\n image most recently returned by this clone. Note that the image size\n may change any time a new image is sent to the host if the\n resolution parameters or render settings primitive has changed.\n Becuase this is the true size of the most recently sent image, this\n value may differ from the resolution requested from this clone\n through the setResolution method.\n\n\n \"\"\"\n def percentComplete(self) -> float:\n \"\"\"\n\n percentComplete(self) -> float\n\n Indicates the progress of the render as reported through the render\n statistics.\n\n\n \"\"\"\n def renderGalleryDataSource(self) -> Optional[AssetGalleryDataSource]:\n \"\"\"\n\n renderGalleryDataSource(self) -> hou.AssetGalleryDataSource\n\n If this clone is currently connected and rendering, the resulting\n images are placed into the snapshot gallery for the target LOP\n Network. This method returns a hou.AssetGalleryDataSource that\n provides access to the snapshot gallery database in which the image\n metadata is stored. If this clone is not connected or has not\n generated any image data yet, this method returns None.\n\n\n \"\"\"\n def renderGalleryItemId(self) -> str:\n \"\"\"\n\n renderGalleryItemId(self) -> str\n\n If this clone is currently connected and rendering, the resulting\n images are placed into the snapshot gallery for the target LOP\n Network. This method returns the unique identifier of this image's\n entry in the snapshot gallery database. This identifier can be\n passed to the hou.AssetGalleryDataSource object returned by the\n renderGalleryDataSource method to look up additional information\n about the image. If this clone is not connected or has not generated\n any image data yet, this method returns an empty string.\n\n\n \"\"\"\n def createSnapshot(self) -> str:\n \"\"\"\n\n createSnapshot(self) -> str\n\n If this clone is currently connected and rendering, this method\n creates a snapshot in the LOP Network's snapshot gallery database,\n along with the current state of the LOP Network's nodes, just as\n when hitting the snapshot button to save the current viewport\n contents. The snapshot will contain all AOVs currently being sent\n from the clone process. Returns the snapshot gallery item identifier\n of the newly created snapshot. Returns an empty string if no\n snapshot could be created, or the clone is not connected or doesn't\n have image data avilable.\n\n\n \"\"\"\n def duplicate(self) -> _clone_Connection:\n \"\"\"\n\n duplicate(self) -> hou.clone.Connection\n\n Makes a copy of this clone object. All the settings and\n configuration information is duplicated. The new clone does not\n launch or connect to a new clone process even if this clone\n connection is currently active. This must be done explicitly, after\n creating the duplicate.\n\n\n \"\"\"\n\nclass Color:\n \"\"\"\n\n hou.Color\n\n Represents a color value.\n\n You can get and set the internal values using different color\n representations such as RGB and L*a*b*.\n\n Note that the constructor takes a single tuple of RGB values, not three\n arguments. So, for example, to create red you would say:\n\n > red = hou.Color((1.0, 0, 0))\n\n You can set the color in one color space and get the color in a\n different color space to convert between spaces.\n\n See HSL and HSV, Lab color space, CIE 1931 color space, and Color\n temperature for an introduction to the concepts the methods are based\n on.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, rgb_tuple: Sequence[float]|float = ..., g: float = ..., b: float = ...) -> None:\n \"\"\"\n\n __init__(self, rgb_tuple=(0.0, 0.0, 0.0)) -> Color\n\n Creates a color object, optionally from RGB values.\n\n To construct a color using a different representation, first create\n the object and then use a set method:\n\n > c = hou.Color()\n > c.setHSV(180, 0.5, 1.0)\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def rgb(self) -> Tuple[float, float, float]:\n \"\"\"\n\n rgb(self) -> (float, float, float)\n\n Returns the color as a tuple of (red, green, blue) floating point\n values, where each value is in the range 0.0 to 1.0.\n\n\n \"\"\"\n def hsv(self) -> Tuple[float, float, float]:\n \"\"\"\n\n hsv(self) -> (float, float, float)\n\n Returns the color as a tuple of (hue, saturation, value), where hue\n is 0 - 360, and saturation and value are 0.0 - 1.0.\n\n\n \"\"\"\n def hsl(self) -> Tuple[float, float, float]:\n \"\"\"\n\n hsl(self) -> (float, float, float)\n\n Returns the color as a tuple of (hue, saturation, lightness), where\n hue is 0 - 360, and saturation and lightness are 0.0 - 1.0.\n\n\n \"\"\"\n def xyz(self) -> Tuple[float, float, float]:\n \"\"\"\n\n xyz(self) -> (float, float, float)\n\n Returns the color as a tuple of (x, y, z) tristimulus values, where\n each component is 0.0 to 1.0 (but may go out of bounds from\n conversion).\n\n\n \"\"\"\n def lab(self) -> Tuple[float, float, float]:\n \"\"\"\n\n lab(self) -> (float, float, float)\n\n Returns the color as a tuple of (L, a, b) as defined in the L*a*b*\n model, where L is 0 - 100, and a and b are unbound. (Note that a and\n b are restricted to -128 - 127 in TIFF files).\n\n\n \"\"\"\n def tmi(self) -> Tuple[float, float, float]:\n \"\"\"\n\n tmi(self) -> (float, float, float)\n\n Returns the color as a tuple of (temperature, magenta, intensity),\n where each component is -1.0 to 1.0.\n\n\n \"\"\"\n def setRGB(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setRGB(self, tuple)\n\n Sets the color using a tuple of (red, green, blue) floating point\n values. See the rgb() method.\n\n\n \"\"\"\n def setHSV(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setHSV(self, tuple)\n\n Sets the color as a tuple of (hue, saturation, value). See the hsv()\n method.\n\n\n \"\"\"\n def setHSL(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setHSL(self, tuple)\n\n Sets the color as a tuple of (hue, saturation, lightness). See the\n hsl() method.\n\n\n \"\"\"\n def setXYZ(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setXYZ(self, tuple)\n\n Sets the color as a tuple of (x, y, z) tristimulus values. See the\n xyz() method.\n\n\n \"\"\"\n def setLAB(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setLAB(self, tuple)\n\n Sets the color as a tuple of (L, a, b) as defined in the L*a*b*\n model. See the lab() method.\n\n\n \"\"\"\n def setTMI(self, tuple: Sequence[float]) -> None:\n \"\"\"\n\n setTMI(self, tuple)\n\n Sets the color as a tuple of (temperature, magenta, intensity). See\n the tmi() method.\n\n\n \"\"\"\n @staticmethod\n def ocio_configPath() -> str:\n \"\"\"\n\n ocio_configPath() -> str\n\n Query the full path to the current OpenColorIO 'config.ocio' file.\n\n\n \"\"\"\n @staticmethod\n def ocio_spaces() -> Tuple[str, ...]:\n \"\"\"\n\n ocio_spaces()\n\n Returns a list of the color spaces defined in the Open Color IO\n configuration in Houdini.\n\n\n \"\"\"\n @staticmethod\n def ocio_activeDisplays() -> Tuple[str, ...]:\n \"\"\"\n\n ocio_activeDisplays() -> tuple of str\n\n Return the list of active Displays, specified in the config file or\n the OpenColorIO OCIO_ACTIVE_DISPLAYS environment variable.\n\n\n \"\"\"\n @staticmethod\n def ocio_activeViews() -> Tuple[str, ...]:\n \"\"\"\n\n ocio_activeViews() -> tuple of str\n\n Return the list of active Views, specified in the config file or the\n OpenColorIO OCIO_ACTIVE_VIEWS environment variable.\n\n\n \"\"\"\n @staticmethod\n def ocio_looks() -> Tuple[str, ...]:\n \"\"\"\n\n ocio_looks() -> tuple of str\n\n Return the list of Looks in the current OpenColorIO config.\n\n\n \"\"\"\n @staticmethod\n def ocio_roles() -> Tuple[str, ...]:\n \"\"\"\n\n ocio_roles() -> tuple of str\n\n Return the list of Roles in the current OpenColorIO config.\n\n\n \"\"\"\n @staticmethod\n def ocio_views(display: str) -> Tuple[str, ...]:\n \"\"\"\n\n ocio_views(display) -> tuple of str\n\n Return the list of Views available for 'display'.\n\n\n \"\"\"\n @staticmethod\n def ocio_defaultDisplay() -> str:\n \"\"\"\n\n ocio_defaultDisplay() -> str\n\n Returns the default Display, specified in the config file or the\n OpenColorIO OCIO_ACTIVE_DISPLAYS environment variable (as the first\n Display in the list).\n\n\n \"\"\"\n @staticmethod\n def ocio_defaultView() -> str:\n \"\"\"\n\n ocio_defaultView() -> str\n\n Returns the default View, specified in the config file or the\n OpenColorIO OCIO_ACTIVE_VIEWS environment variable (as the first\n View in the list).\n\n\n \"\"\"\n def ocio_transform(self, src_colorspace: str, dest_colorspace: str, looks: str) -> Color:\n \"\"\"\n\n ocio_transform(src_colorspace, dest_colorspace, looks) -> hou.Color`\n\n Transforms from this color (in src_colorspace) to a different\n colorspace (dest_colorspace) with optional transforms specified in\n looks and returns the transformed color. The color space names and\n the look name must be defined in the current OCIO config file.\n\n\n \"\"\"\n def ocio_viewTransform(self, src_colorspace: str, display: str, view: str) -> Color:\n \"\"\"\n\n ocio_viewTransform(src_colorspace, display_name, view_name) ->\n hou.Color`\n\n Transforms from this color (in src_colorspace) to the view specified\n by 'display_name' and 'view_name', and returns the transformed\n color. The color space names, display name, and view name must be\n defined in the current OCIO config file.\n\n\n \"\"\"\n @staticmethod\n def reloadOCIO() -> None:\n \"\"\"\n\n reloadOCIO()\n\n Reloads the OpenColorIO configuration file. This is generally paired\n with setting the OCIO environment variable to a new config file\n beforehand.\n\n\n \"\"\"\n\nclass CompositorViewer(PathBasedPaneTab):\n \"\"\"\n\n hou.CompositorViewer\n\n Class representing a compositing view pane.\n\n This class provides the essential methods for supporting compositing\n shelf tools, COP states and handles. It doesn't currently offer\n programmatic control over most UI-available functions. For that purpose,\n the functions within the cop2toolutils module are more suitable.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def currentState(self) -> str:\n \"\"\"\n\n currentState(self) -> str\n\n Returns the name of the tool currently in use in the view. This is\n an internal, undocumented designation but usually corresponds to the\n name of a node. You can change to a different tool using\n setCurrentState.\n\n\n \"\"\"\n def enterViewState(self, wait_for_exit: bool = False) -> None:\n \"\"\"\n\n enterViewState(self, wait_for_exit=False)\n\n Switch to the view tool.\n\n\n \"\"\"\n def setCurrentState(self, state: str, wait_for_exit: bool = False) -> None:\n \"\"\"\n\n setCurrentState(self, state, wait_for_exit=False)\n\n Sets the currently active tool in the view. state is a string\n containing an internal, undocumented designation. See\n currentState().\n\n\n \"\"\"\n def usingOCIO(self) -> bool:\n \"\"\"\n\n usingOCIO(self) -> bool\n\n Query if OpenColorIO is being used for color correction in the\n viewer.\n\n\n \"\"\"\n def setUsingOCIO(self, enable: bool) -> None:\n \"\"\"\n\n setUsingOCIO(self, enable)\n\n Enable or disable OpenColorIO for color correction in the viewer.\n\n\n \"\"\"\n def setOCIODisplayView(self, display: Optional[str] = None, view: Optional[str] = None) -> None:\n '''\n\n setOCIODisplayView(self, display=\\\\\"\\\\\", view=\\\\\"\\\\\")\n\n Set the OpenColorIO display name, view name, or both. The display\n and view together define the output colorspace for the viewer, and\n any number of color transforms (Looks) to be performed on the linear\n viewport image.\n\n\n '''\n def getOCIODisplay(self) -> str:\n \"\"\"\n\n getOCIODisplay(self) -> str\n\n Return the current OpenColorIO display used for color correction.\n\n\n \"\"\"\n def getOCIOView(self) -> str:\n \"\"\"\n\n getOCIOView(self) -> str\n\n Return the current OpenColorIO view used for color correction.\n\n\n \"\"\"\n def curViewport(self) -> Optional[Viewport2D]:\n \"\"\"\n\n curViewport(self) -> hou.Viewport2D\n\n Returns this viewer's current viewport. The current viewport is the\n one containing the mouse cursor.\n\n\n \"\"\"\n def showHandle(self, name: str, value: bool) -> None:\n \"\"\"\n\n showHandle(self, name, value)\n\n Shows or hides a display handle linked to the current tool state.\n This API is typically used with Python states and can be called from\n any python state callbacks. Avoid calling showHandle from the python\n state constructor, because this leads to a runtime error.\n\n See also hou.Handle.show.\n\n\n name\n The name of the handle as specified with\n hou.ViewerStateTemplate.bindHandle or the name or a built-in\n Houdini handle.\n\n value\n Bool value, True to show the handle, False to hide it.\n\n\n \"\"\"\n def runStateCommand(self, name: str, args: Optional[Any] = None) -> None:\n '''\n\n runStateCommand(self, name, args=None)\n\n Executes a command implemented by the active python state. A state\n command can be invoked by specifying a name identifier along with\n arguments.\n\n An exception is thrown if the state is not a Python state type or\n the state is not running.\n\n\n name\n The command name identifier.\n\n args\n The command arguments. args can be any Python type, including\n built-in types, containers, sets, or dictionaries. A dictionary\n is commonly used to pass arguments to a command, as it\n simplifies the command\\'s implementation and allows output values\n to be returned by the command. args defaults to None is omitted.\n\n An implementation example of a COP state command.\n\n > import hou\n > import viewerstate.utils as su\n > \n > class State(object):\n > def __init__(self, state_name, viewer):\n > self.state_name = state_name\n > self.scene_viewer = viewer \n > \n > def onCommand( self, kwargs ): \n > name = kwargs[\\'command\\']\n > args = kwargs[\\'command_args\\']\n > \n > if name == \\\\\"myCOPCommand\\\\\"\\':\n > self.log(f\\\\\"{name}({args})\\\\\")\n > \n > def createViewerStateTemplate():\n > \\\\\"\\\\\"\\\\\" Mandatory entry point to create and return the viewer state \n > template to register. \\\\\"\\\\\"\\\\\"\n > \n > state_typename = \\\\\"mycopstate\\\\\"\n > state_label = \\\\\"My COP State\\\\\"\n > state_cat = hou.copNodeTypeCategory()\n > \n > template = hou.ViewerStateTemplate(state_typename, state_label, state_cat)\n > template.bindFactory(State)\n > template.bindIcon(\\\\\"MISC_python\\\\\")\n > \n > return template\n\n Here\\'s how to invoke the command.\n\n > import viewerstate.utils as ut\n > \n > v = ut.findCompositorViewer() \n > v.runStateCommand(\\\\\"myCOPCommand\\\\\", {\\\\\"arg0\\\\\":0, \\\\\"arg1\\\\\":[1,2,3]})\n\n '''\n def bindViewerHandle(self, handle_type: str, name: str, settings: str|None = ..., cache_previous_parms: bool = ..., handle_parms: Sequence[str]|None = ...) -> None:\n \"\"\"\n\n bindViewerHandle(self, handle_type, name, settings=None,\n cache_previous_parms=False, handle_parms=None)\n\n Binds a dynamic viewer handle to the current viewer state similarly\n to hou.ViewerStateTemplate.bindHandle. Unlike bindHandle though,\n this method creates and initializes the handle in a dynamic fashion\n so there is no need to register in advance the handle with the\n viewer state. You can call bindViewerHandle from almost anywhere in\n Houdini (from the viewer state handlers, from a python script,\n etc...), but it can only be called while the viewer state is\n running.\n\n To remove the viewer handles added with bindViewerHandle, use\n hou.SceneViewer.unbindViewerHandle. Houdini will take care of\n removing automatically all viewer handles added with\n bindViewerHandle when the state exits.\n\n This method works only with python states, an exception is raised if\n the state is not a python state.\n\n\n\n handle_type\n A string naming the type of handle. See State handle types\n for a list of handle types to choose from.\n\n name\n A string to use to identify the handle. Each binding's name\n must be unique within this state. Trying to bind the same\n name more than once will raise an exception.\n\n settings\n A string containing specific settings of the handle.\n Multiple settings must be space separated.\n\n cache_previous_parms\n If True, the handle retains a record of previous values.\n This can be useful if you want your code to calculate deltas\n as the user moves the handle, for example to know how fast\n the user is dragging the handle.\n\n handle_parms\n An array of handle parm names to specify the parms to\n enable, only the parms contained in the array will be\n available to the python state callbacks. All handle parms\n are enabled when handle_parms is empty (default).\n\n\n \"\"\"\n def bindViewerHandleStatic(self, handle_type: str, name: str, bindings: Sequence[tuple[str, str]], settings: str|None = ...) -> None:\n '''\n\n bindViewerHandleStatic(self, handle_type, name, bindings, settings=None)\n\n Binds a static viewer handle to the current viewer state similarly\n to hou.ViewerStateTemplate.bindHandleStatic. Unlike bindHandleStatic\n though, this method creates and initializes the handle in a dynamic\n fashion so there is no need to register in advance the handle with\n the viewer state. You can call bindViewerHandleStatic from almost\n anywhere in Houdini (from the viewer state handlers, from a python\n script, etc...), but it can only be called while the viewer state is\n running.\n\n To remove the viewer handles added with bindViewerHandleStatic, use\n hou.SceneViewer.unbindViewerHandle. Houdini will take care of\n removing automatically all viewer handles added with\n bindViewerHandleStatic when the state exits.\n\n This method works only with python states, an exception is raised if\n the state is not a python state.\n\n\n\n handle_type\n A string naming the type of handle.\n\n name\n A unique string to use to identify the handle. Each\n binding\\'s name must be unique within this state. Trying to\n bind the same name more than once will raise an exception.\n\n bindings\n A list of (\\\\\"node_parm_name\\\\\", \\\\\"handle_parm_name\\\\\") tuples.\n This binds the parts of the handle to individual parameters\n on the node.\n\n settings\n A string containing specific settings of a handle. Multiple\n settings must be space separated.\n\n\n '''\n def unbindViewerHandle(self, handle_instance_name: str) -> None:\n \"\"\"\n\n unbindViewerHandle(self, name)\n\n Removes a viewer handle from the current python state.\n unbindViewerHandle can only unbind the viewer handles that were\n dynamically added with hou.SceneViewer.bindViewerHandle or\n hou.SceneViewer.bindViewerHandleStatic. An exception is raised if\n the viewer handle to unbind is a state registered viewer handle.\n\n This method works only with python states, an exception is raised if\n the state is not a python state.\n\n\n name\n The viewer handle name to unbind. This is the name used when\n binding the handle with bindViewerHandle or\n bindViewerHandleStatic.\n\n\n \"\"\"\n\nclass ConstructionPlane:\n \"\"\"\n\n hou.ConstructionPlane\n\n The grid (a.k.a. construction plane) in the scene viewer pane tab.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def sceneViewer(self) -> SceneViewer:\n \"\"\"\n\n sceneViewer(self) -> hou.SceneViewer\n\n Return the scene viewer containing this plane.\n\n\n \"\"\"\n def isVisible(self) -> bool:\n \"\"\"\n\n isVisible(self) -> bool\n\n Return whether the grid is visible in the viewer.\n\n\n \"\"\"\n def setIsVisible(self, on: bool) -> None:\n \"\"\"\n\n setIsVisible(self, on)\n\n Make this grid visible or invisible in the viewer.\n\n\n \"\"\"\n def transform(self) -> Matrix4:\n \"\"\"\n\n transform(self) -> hou.Matrix4\n\n Return the transformation matrix for this plane.\n\n When the transformation matrix is the identity matrix, the plane's\n bottom-left corner is at the origin and it sits in the XY plane. In\n this orientation, increasing the number of cells in x or the size of\n a cell in x grows the plane outward from the origin along the\n x-axis. Similarly, increasing the number of cells or size of a cell\n in y grows the plane along the y-axis.\n\n Note that the transformation matrix does not contain any scale\n information. Use the cellSize and numberOfCells methods to get the\n size of the plane.\n\n The following function will return the position of the center of the\n plane:\n\n > def origin(construction_plane):\n > return hou.Vector3(0, 0, 0) * construction_plane.transform()\n\n The following function will return the normal of the plane:\n\n > def normal(construction_plane):\n > return hou.Vector3(0, 0, 1) * construction_plane.transform().inverted().transposed()\n\n \"\"\"\n def setTransform(self, matrix: Matrix4) -> None:\n \"\"\"\n\n setTransform(self, matrix)\n\n Set the transformation matrix for this plane to a hou.Matrix4.\n\n This matrix is used to translate and rotate the plane. See the\n transform method for more information.\n\n Note that scale information inside the transformation matrix is\n ignored. Use the setCellSize and setNumberOfCells methods to adjust\n the size of the plane.\n\n The following function will change the position of the center of the\n plane:\n\n > def set_origin(construction_plane, new_origin):\n > translation = hou.hmath.buildTranslate(hou.Vector3(new_origin) - origin(construction_plane))\n > construction_plane.setTransform(construction_plane.transform() * translation)\n > \n > def origin(construction_plane):\n > return hou.Vector3(0, 0, 0) * construction_plane.transform()\n\n The following function will change the normal of the plane:\n\n > def set_normal(construction_plane, normal_vector):\n > existing_rotation = hou.Matrix4(construction_plane.transform().extractRotationMatrix3())\n > rotation = existing_rotation * normal(construction_plane).matrixToRotateTo(normal_vector)\n > translation = hou.hmath.buildTranslate(origin(construction_plane))\n > construction_plane.setTransform(rotation * translation)\n > \n > def normal(construction_plane):\n > return hou.Vector3(0, 0, 1) * construction_plane.transform().inverted().transposed()\n > \n > def origin(construction_plane):\n > return hou.Vector3(0, 0, 0) * construction_plane.transform()\n\n \"\"\"\n def cellSize(self) -> Tuple[float, ...]:\n \"\"\"\n\n cellSize(self) -> tuple of float\n\n Return the x and y sizes (width and height) of one cell in the grid\n of cells. The return value is a tuple of two floats.\n\n\n \"\"\"\n def setCellSize(self, size: Sequence[float]) -> None:\n \"\"\"\n\n setCellSize(self, size)\n\n Change the x and y sizes (width and height) of each cell in the grid\n of cells. size is a sequence of two floats.\n\n Changing the size of each cell will change the total size of the\n grid.\n\n\n \"\"\"\n def numberOfCells(self) -> Tuple[int, ...]:\n \"\"\"\n\n numberOfCells(self) -> tuple of int\n\n Return the number of cells in the x and y directions of the grid. In\n other words, return the number of columns and rows.\n\n\n \"\"\"\n def setNumberOfCells(self, number: Sequence[int]) -> None: ...\n def numberOfCellsPerRulerLine(self) -> Tuple[int, ...]:\n \"\"\"\n\n numberOfCellsPerRulerLine(self) -> tuple of int\n\n Return the number of cells in the x and y directions between ruler\n lines. Ruler lines are darker than the normal lines drawn between\n grid cells.\n\n\n \"\"\"\n def setNumberOfCellsPerRulerLine(self, number: Sequence[int]) -> None: ...\n\nclass ContextViewer(PathBasedPaneTab):\n \"\"\"\n\n hou.ContextViewer\n\n A class representing a context viewer pane tab.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def sceneViewer(self) -> Optional[SceneViewer]:\n \"\"\"\n\n sceneViewer(self) -> hou.SceneViewer\n\n Returns a SceneViewer if the ContextViewer is displaying a scene\n viewer. If not, returns None.\n\n\n \"\"\"\n def compositorViewer(self) -> Optional[CompositorViewer]:\n \"\"\"\n\n compositorViewer(self) -> hou.CompositorViewer\n\n Returns a CompositorViewer if the ContextViewer is displaying a\n compositor viewer. If not, returns None.\n\n\n \"\"\"\n def findViewport(self, name: str) -> Optional[GeometryViewport]:\n \"\"\"\n\n findViewport(self, viewport_name) -> hou.GeometryViewport\n\n Returns a GeometryViewport with the given viewport_name if the\n ContextViewer is displaying a scene viewer. If not, returns None.\n\n\n \"\"\"\n\nclass CopCableStructure:\n \"\"\"\n\n hou.CopCableStructure\n\n Captures types and names of wires in a Copernicus cable.\n\n A cable in Copernicus represents an ordered bundle of individual wires.\n This class represents the structure of a cable's contents, identifying\n the name and data type of each individual wire. You can call\n hou.CopNode.inputCableStructure and hou.CopNode.outputCableStructure to\n query the cables that are plugged into input ports or generated by\n output ports of a COP node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def wireCount(self) -> int:\n \"\"\"\n\n wireCount(self) -> int\n\n Returns the number of wires contained in a cable.\n\n\n \"\"\"\n def wireDataType(self, index: int) -> str: ...\n def wireName(self, index: int) -> str:\n \"\"\"\n\n wireName(self, index) -> str\n\n Returns the name of the wire at the specified index.\n\n\n \"\"\"\n def appearanceIndex(self, index: int) -> int:\n \"\"\"\n\n appearanceIndex(self, index) -> int\n\n Multiple wires in a cable can have the same name, in which case they\n are distinguished by their appearance index. For example, if a cable\n has three different wires called color, the first wire's appearance\n index will be 0, the second wire's will be 1, and the third wire's\n will be 2. This method returns the appearance index of the wire at\n the specified index. That is, it returns 0-based index of a specific\n wire within all wires of the cable that have the same name as it.\n\n\n \"\"\"\n\nclass CopNode(OpNode):\n \"\"\"\n\n hou.CopNode\n\n Represents a Copernicus node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def geometry(self, output_index: int = 0) -> Optional[Geometry]:\n \"\"\"\n\n geometry(self, output_index=0) -> hou.Geometry\n\n Return the geometry computed by this COP node. If the COP has not\n already cooked, this method will cook the COP.\n\n The returned Geometry object is frozen. See hou.Geometry.freeze for\n more information on frozen Geometry objects.\n\n You can optionally specify the output_index argument to request the\n geometry attached to another output on the node.\n\n Non-geometry outputs are converted to geometry using the same rules\n as if they were brought into a SOP Network.\n\n\n \"\"\"\n def geometryAtFrame(self, frame: float, output_index: int = 0) -> Optional[Geometry]:\n \"\"\"\n\n geometryAtFrame(self, frame, output_index=0) -> hou.Geometry\n\n Return the geometry computed by this COP node cooked at the\n specified frame. If the COP has not already cooked, this method will\n cook the COP.\n\n The returned Geometry object is frozen. See hou.Geometry.freeze for\n more information on frozen Geometry objects.\n\n You can optionally specify the output_index argument to request the\n geometry attached to another output on the node.\n\n Non-geometry outputs are converted to geometry using the same rules\n as if they were brought into a SOP Network.\n\n\n \"\"\"\n def layer(self, output_index: int = 0) -> Optional[ImageLayer]:\n \"\"\"\n\n layer(self, output_index=0) -> hou.ImageLayer\n\n Return the layer computed by this COP node. If the COP has not\n already cooked, this method will cook the COP.\n\n You can optionally specify the output_index argument to request the\n layer attached to another output on the node.\n\n\n \"\"\"\n def layerAtFrame(self, frame: float, output_index: int = 0) -> Optional[ImageLayer]:\n \"\"\"\n\n layerAtFrame(self, frame, output_index=0) -> hou.ImageLayer\n\n Return the layer computed by this COP node cooked at the specified\n frame. If the COP has not already cooked, this method will cook the\n COP.\n\n You can optionally specify the output_index argument to request the\n layer attached to another output on the node.\n\n\n \"\"\"\n def vdb(self, output_index: int = 0) -> Optional[NanoVDB]:\n \"\"\"\n\n vdb(self, output_index=0) -> hou.NanoVDB\n\n Return the vdb computed by this COP node. If the COP has not already\n cooked, this method will cook the COP.\n\n You can optionally specify the output_index argument to request the\n vdb attached to another output on the node.\n\n\n \"\"\"\n def vdbAtFrame(self, frame: float, output_index: int = 0) -> Optional[NanoVDB]:\n \"\"\"\n\n vdbAtFrame(self, frame, output_index=0) -> hou.NanoVDB\n\n Return the vdb computed by this COP node cooked at the specified\n frame. If the COP has not already cooked, this method will cook the\n COP.\n\n You can optionally specify the output_index argument to request the\n vdb attached to another output on the node.\n\n\n \"\"\"\n def inputCableStructure(self, input_index: int) -> Optional[CopCableStructure]:\n \"\"\"\n\n inputCableStructure(self, idx) -> hou.CopCableStructure\n\n Returns an object capturing names and types of wires in the cable\n plugged into the specified input port.\n\n\n \"\"\"\n def outputCableStructure(self, output_index: int) -> Optional[CopCableStructure]:\n \"\"\"\n\n outputCableStructure(self, idx) -> hou.CopCableStructure\n\n Returns an object capturing names and types of wires generated by\n the specified output port of this node.\n\n\n \"\"\"\n def hasVerb(self) -> bool:\n \"\"\"\n\n hasVerb(self) -> bool\n\n Returns if the node has a verb representation.\n\n\n \"\"\"\n def verb(self) -> Optional[CopVerb]:\n \"\"\"\n\n verb(self) -> hou.CopVerb\n\n Returns the verb associated with a specific node. This allows you to\n run the node's operation on geometry independent of the node itself.\n\n\n \"\"\"\n def isBypassed(self) -> bool:\n \"\"\"\n\n isBypassed(self) -> bool\n\n Returns True if the node's bypass flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def bypass(self, on: bool) -> None:\n \"\"\"\n\n bypass(self, on)\n\n Turns the node's bypass flag on or off. When the bypass flag is on,\n the node will have no effect on the scene. The value of the on\n argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isDisplayFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayFlagSet(self) -> bool\n\n Returns True if the node's display flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setDisplayFlag(self, on: bool) -> None:\n \"\"\"\n\n setDisplayFlag(self, on)\n\n Turns the node's display flag on or off. When the display flag is\n on, the node's image will appear in the image viewport. The value of\n the on argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isTemplateFlagSet(self) -> bool:\n \"\"\"\n\n isTemplateFlagSet(self) -> bool\n\n Returns True if the node's template flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setTemplateFlag(self, on: bool) -> None:\n \"\"\"\n\n setTemplateFlag(self, on)\n\n Turns the node's template flag on or off. The value of the on\n argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isSelectableTemplateFlagSet(self) -> bool:\n \"\"\"\n\n isSelectableTemplateFlagSet(self) -> bool\n\n Return whether this node's selectable template flag is on. A\n selectable template displays like the display COP in the viewport.\n\n\n \"\"\"\n def setSelectableTemplateFlag(self, on: bool) -> None:\n \"\"\"\n\n setSelectableTemplateFlag(self, on)\n\n Turn this node's selectable template flag on or off.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isCompressFlagSet(self) -> bool:\n \"\"\"\n\n isCompressFlagSet(self) -> bool\n\n Returns True if the node's compress flag is turned on. Returns False\n otherwise. The compress flag controls whether or not a preview image\n is shown for this node in the Network View.\n\n\n \"\"\"\n def setCompressFlag(self, on: bool) -> None:\n \"\"\"\n\n setCompressFlag(self, on)\n\n Turns the node's compress flag on or off. If the compress flag is\n True, this node will not show a preview image in the Network View.\n If the compress flag is False, a preview image will be shown in the\n Network View. The value of the on argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isExportFlagSet(self) -> bool:\n \"\"\"\n\n isExportFlagSet(self) -> bool\n\n Returns True if the node's export flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setExportFlag(self, on: bool) -> None:\n \"\"\"\n\n setExportFlag(self, on)\n\n Turns the node's export flag on or off. When the export flag is on,\n the node's image will appear in the 3d viewers rather than the\n display flag's.\n\n The value of the on argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def outputDataTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n outputDataTypes(self) -> tuple of str\n\n Returns a tuple of all output data types for this node. Data types\n for output connectors that are hidden are also included.\n\n\n \"\"\"\n def inputDataTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n inputDataTypes(self) -> tuple of str\n\n Returns a tuple of all input data types for this node. Data types\n for input connectors that are hidden are also included.\n\n\n \"\"\"\n def isInputCompatible(self, idx: int, other: CopNode, other_idx: int, allow_conversions: bool = False) -> bool:\n \"\"\"\n\n isInputCompatible(self, idx, other, other_idx, allow_conversions =\n False) -> bool`\n\n Return True if input idx of this object can be connected to output\n other_idx of node other. Two inputs can be connected if they are of\n the same data type. The allow_conversions provides API compatibility\n with VOPs, but currently COP types that are convertible (such as\n Mono to RGB) are considered valid regardless of this flag.\n\n\n \"\"\"\n def displayNode(self) -> Optional[Node]:\n \"\"\"\n\n displayNode(self) -> Node\n\n If this is a subnet COP, return the COP inside the subnet with its\n display flag on. Otherwise, return None.\n\n\n \"\"\"\n\nclass CopVerb(OpVerb):\n \"\"\"\n\n hou.CopVerb\n\n Represents the code of a copernicus node.\n\n See using a verb for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def execute(self, inputs: dict[str, Any]) -> dict[str, Any]:\n \"\"\"\n\n execute(self, inputs) -> dict\n\n Applies the verb using the provided dictionary of inputs.\n\n The inputs can be keyed by the name of the input, or by the string\n representing the 0-based index of the input. Each input type must\n match the signature of the verb - if necessary the signature\n parameter can be provided to the parms.\n\n Returns a dictionary of the computed layers and geometry for the\n outputs. The output dictionary is keyed both by the output name and\n by the 0-based output index as a string.\n\n\n NOTE\n Node defaults may change between versions.\n\n\n \"\"\"\n\nclass Cop2Node(OpNode):\n \"\"\"\n\n hou.Cop2Node\n\n Represents a compositing node.\n\n\n WARNING\n As of Houdini 20.5, use Copernicus nodes instead of Compositing\n nodes. Though both networks still exist, the Compositing network is\n now designated as COP Network - Old. The Compositing network and its\n nodes will be deprecated and then removed in a future Houdini\n release.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isBypassed(self) -> bool:\n \"\"\"\n\n isBypassed(self) -> bool\n\n Returns True if the node's bypass flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def bypass(self, on: bool) -> None:\n \"\"\"\n\n bypass(self, on)\n\n Turns the node's bypass flag on or off. When the bypass flag is on,\n the node will have no effect on the scene. The value of the on\n argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isDisplayFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayFlagSet(self) -> bool\n\n Returns True if the node's display flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setDisplayFlag(self, on: bool) -> None:\n \"\"\"\n\n setDisplayFlag(self, on)\n\n Turns the node's display flag on or off. When the display flag is\n on, the node's image will appear in the image viewport. The value of\n the on argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isRenderFlagSet(self) -> bool:\n \"\"\"\n\n isRenderFlagSet(self) -> bool\n\n Returns True if the node's render flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setRenderFlag(self, on: bool) -> None:\n \"\"\"\n\n setRenderFlag(self, on)\n\n Turns the node's render flag on or off. The render flag controls\n which node in a compositing network will be rendered to or to disk.\n The value of the on argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isTemplateFlagSet(self) -> bool:\n \"\"\"\n\n isTemplateFlagSet(self) -> bool\n\n Returns True if the node's template flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setTemplateFlag(self, on: bool) -> None:\n \"\"\"\n\n setTemplateFlag(self, on)\n\n Turns the node's template flag on or off. The value of the on\n argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def isCompressFlagSet(self) -> bool:\n \"\"\"\n\n isCompressFlagSet(self) -> bool\n\n Returns True if the node's compress flag is turned on. Returns False\n otherwise. The compress flag controls whether or not a preview image\n is shown for this node in the Network View.\n\n\n \"\"\"\n def setCompressFlag(self, on: bool) -> None:\n \"\"\"\n\n setCompressFlag(self, on)\n\n Turns the node's compress flag on or off. If the compress flag is\n True, this node will not show a preview image in the Network View.\n If the compress flag is False, a preview image will be shown in the\n Network View. The value of the on argument must be True or False.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def planes(self) -> Tuple[str, ...]:\n \"\"\"\n\n planes(self) -> tuple of strings\n\n Returns a tuple of plane names in the node's image sequence.\n\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def components(self, plane: str) -> Tuple[str, ...]:\n \"\"\"\n\n components(self, plane) -> tuple of str\n\n Returns a tuple of component names for the specified plane in the\n node's image sequence. The value of the plane argument must be a\n plane name.\n\n Raises ValueError if plane is None or empty. Raises\n hou.OperationFailed if the node could not be cooked or opened for\n processing. Raises hou.OperationFailed if the given plane does not\n exist.\n\n\n \"\"\"\n def depth(self, plane: str) -> EnumValue:\n '''\n\n depth(self, plane) -> hou.imageDepth enum value\n\n Return the data format used to represent one component of one pixel\n in the given image plane.\n\n For example, if the depth of the \\\\\"C\\\\\" (color) plane is\n hou.imageDepth.Int8, each of the red, green, and blue components is\n stored as an (unsigned) 8-bit integer, occupying one byte. If, for\n example, it is instead hou.imageDepth.Float32, each of the red,\n green, and blue components is a 32-bit float and occupies 4 bytes\n (12 bytes total for all 3 components combined).\n\n\n '''\n def maskInputIndex(self) -> int:\n \"\"\"\n\n maskInputIndex(self) -> int\n\n Return the input index of the mask input for this node. Return -1 if\n this node type does not provide a mask input.\n\n\n \"\"\"\n def getPixelByUV(self, plane: str, u: float, v: float, component: Optional[str] = None, interpolate: bool = True) -> Tuple[float, ...]:\n \"\"\"\n\n getPixelByUV(self, plane, u, v, component=None, interpolate=True) ->\n tuple of float\n\n Returns plane values for a single pixel in the node's image. The\n plane is defined by the plane argument which must be set to the\n plane's name. The pixel is defined by (u, v) coordinates where u and\n v are values between 0.0 and 1.0. If the optional component argument\n is specified, then the value for that particular component is\n returned. Otherwise, all of the plane's component values are\n returned. The value of component should be the component's name\n (i.e. r, g, b, etc.).\n\n If the (u, v) coordinates do not fall exactly on a pixel, then the\n return values are calculated by linear blending of the values for\n the surrounding pixels. This can be disabled by setting the\n interpolate argument to False, in which case the values of the pixel\n located immediately to the bottom-left of (u, v) are returned.\n\n Note that the returned values are for the node's image at the\n current frame.\n\n Raises ValueError if either u or v is outside of the 0.0-1.0 range.\n Raises ValueError if plane is None or empty. Raises\n hou.OperationFailed if the node could not be cooked or opened for\n processing. Raises hou.OperationFailed if the given plane does not\n exist. Raises hou.OperationFailed if the given component does not\n exist in the plane.\n\n\n \"\"\"\n def getPixelHSVByUV(self, u: float, v: float, interpolate: bool = True) -> Tuple[float, ...]:\n \"\"\"\n\n getPixelHSVByUV(self, u, v, interpolate=True) -> tuple of float\n\n Returns a 3-tuple containing the hue, saturation and value for a\n single pixel in the node's image. The pixel is defined by (u, v)\n coordinates where u and v are values between 0.0 and 1.0.\n\n If the (u, v) coordinates do not fall exactly on a pixel, then the\n return values are calculated by linear blending of the values for\n the surrounding pixels. This can be disabled by setting the\n interpolate argument to False, in which case the values of the pixel\n located immediately to the bottom-left of (u, v) are returned.\n\n Note that the returned hue, saturation and value are for the node's\n image at the current frame.\n\n Raises ValueError if either u or v is outside of the 0.0-1.0 range.\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def getPixelLuminanceByUV(self, u: float, v: float, interpolate: bool = True) -> float:\n \"\"\"\n\n getPixelLuminanceByUV(self, u, v, interpolate=True) -> float\n\n Returns the luminance value for a single pixel in the node's image.\n The pixel is defined by (u, v) coordinates where u and v are values\n between 0.0 and 1.0.\n\n If the (u, v) coordinates do not fall exactly on a pixel, then the\n luminance is calculated by linear blending of the luminance values\n for the surrounding pixels. This can be disabled by setting the\n interpolate argument to False, in which case the luminance of the\n pixel located immediately to the bottom-left of (u, v) is returned.\n\n Note that the returned luminance value is for the node's image at\n the current frame.\n\n Raises ValueError if either u or v is outside of the 0.0-1.0 range.\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def allPixels(self, plane: str = ..., component: str|None = ..., interleaved: bool = ..., time: float = ...) -> Tuple[float,...]:\n '''\n\n allPixels(self, plane=\\\\\"C\\\\\", component=None, interleaved=True, time=-1.0)\n -> tuple of float\n\n Return a tuple of floats containing all pixel values for a\n particular image plane. The pixels in the bottom scanline of the\n image are first in the result, followed by the second-last scanline,\n etc. Floating point values in the color plane (C), for example, are\n typically in the range 0.0 to 1.0.\n\n\n plane\n The name of the image plane to return. All images have C (color)\n and A (alpha) planes. Deep raster images may contain other\n planes, such as Pz (depth), N (normal), etc.\n\n component\n A particular subcomponent of the plane. For example, for the C\n plane you could specify one of the r, g, or b subcomponents.\n Specify None to indicate all components.\n\n interleaved\n Whether the different components of the plane are interleaved in\n the result. For example, if the plane is C, the interleaved\n result would be organized as rgbrgbrgb... while the\n uninterleaved result would be rrr...ggg...bbb.... This parameter\n has no effect when a particular component is specified.\n\n time\n The time at which to cook the COP node. If this value is\n negative, Houdini uses the current time.\n\n Note that this argument does not apply if allPixels is called\n from a Python COP that is cooking. In that case allPixels\n evaluates at the current cooking time.\n\n This method does not accept a depth parameter like allPixelsAsString\n does. The values are converted to floating point data, regardless of\n the actual depth of the image plane.\n\n Raises hou.OperationFailed if the time argument is set to a value\n greater than or equal to 0.0 and allPixels is called from a cooking\n Python COP.\n\n\n '''\n def allPixelsAsString(self, plane: str = ..., component: str|None = ..., interleaved: bool = ..., time: float = ...) -> bytes:\n '''\n\n allPixelsAsString(self, plane=\\\\\"C\\\\\", component=None, interleaved=True,\n time=-1.0, depth=None) -> str for Python 2, bytes for Python 3\n\n Return a binary string representation of the floats containing all\n the values of all voxels. This method is faster than\n hou.Cop2Node.allPixels, and you can use the array module to convert\n the string into a Python sequence. Note that this method returns\n binary float data, so there are 4 bytes per R, G, and B component,\n not 1 byte.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n If depth is hou.imageDepth.Float32, this method provides a faster\n implementation of the following:\n\n > import array\n > def allPixelsAsString(self):\n > return array.array(\\\\\"f\\\\\", self.allPixels()).tostring()\n\n If depth is None and this method is called from the code\n implementing a Python COP to get an input plane, the depth will be\n the same as the plane\\'s native depth. If depth is None and this\n method is called from outside a Python COP, the depth will be\n hou.imageDepth.Float32. Otherwise, if depth is a hou.imageDepth\n enumerated value the result will be converted to the specified\n depth.\n\n See hou.Cop2Node.allPixels for more information. See also\n hou.Volume.setVoxelSliceFromString.\n\n Raises hou.OperationFailed if the time argument is set to a value\n greater than or equal to 0.0 and allPixelsAsString is called from a\n cooking Python COP.\n\n\n '''\n def setPixelsOfCookingPlane(self, values: Sequence[float], component: Optional[str] = None, interleaved: bool = True, flip_vertically: bool = False) -> None:\n \"\"\"\n\n setPixelsOfCookingPlane(self, values, component=None, interleaved=True,\n flip_vertically=False)\n\n Set the pixels of the plane being cooked by the currently-running\n Python COP.\n\n\n values\n A sequence of floats, organized with the contents of the bottom\n scanline first.\n\n If component is None, the length of the sequence of floats must\n be the number of pixels in the image times the number of\n components. Otherwise, it must be the number of pixels in the\n image.\n\n component\n Either the name of one component in the plane being cooked, or\n None. If a component name is given, values will contain only the\n values for that component. Otherwise, it will contain the values\n for all components of all pixels in the plane.\n\n interleaved\n If component is None and interleaved is True, values is contains\n the first component of the first pixel, followed by the second\n component of the first pixel, until the last component of the\n first pixel, then the first component of the second pixel, etc.\n If it is False, values contains all the values of the first\n component for all pixels, followed by all the values of the\n second component, etc.\n\n For example, if the plane is C and interleaved is True, the\n values will be organized as rgbrgbrgb.... If it is not\n interleaved, it will be organized as rrr...ggg...bbb....\n\n If component is not None, this parameter is ignored.\n\n flip_vertically\n The default value for this parameter is False, so the first\n scanline in the values array is assumed to be the bottom\n scanline. If flip_vertically is True, the input values are\n assumed to oriented starting at the top scanline.\n\n If you call this method from outside the cook function in a Python\n COP, raises hou.OperationFailed.\n\n See also hou.Cop2Node.allPixels and\n hou.Cop2Node.setPixelsOfCookingPlaneFromString. Also see the HOM\n cookbook and the Python COP documentation for examples.\n\n\n \"\"\"\n def imageBounds(self, plane: str = ...) -> Tuple[int, int, int]:\n '''\n\n imageBounds(self, plane=\\\\\"C\\\\\") -> tuple of int\n\n Returns the x and y boundaries of the given plane in the form of\n (xmin, ymin, xmax, ymax). The value of the plane argument is the\n plane name. By default, the image bounds of the color plane is\n returned.\n\n Note that the image bounds is not the same as the image resolution.\n For example, the image bounds for a Font COP is the bounding\n rectangle around the displayed letters while the resolution is the\n size of the node\\'s image.\n\n Note that the returned image bounds is for the current frame.\n\n Raises ValueError if plane is None or empty. Raises\n hou.OperationFailed if the node could not be cooked or opened for\n processing. Raises hou.OperationFailed if the given plane does not\n exist.\n\n\n '''\n def xRes(self) -> int:\n \"\"\"\n\n xRes(self)\n\n Returns the x-resolution of the node's image for the current frame.\n\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def yRes(self) -> int:\n \"\"\"\n\n yRes(self)\n\n Returns the y-resolution of the node's image for the current frame.\n\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def sequenceStartFrame(self) -> float:\n \"\"\"\n\n sequenceStartFrame(self) -> float\n\n Returns the start frame in the node's image sequence.\n\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def sequenceEndFrame(self) -> float:\n \"\"\"\n\n sequenceEndFrame(self) -> float\n\n Returns the last frame in the node's image sequence.\n\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def sequenceFrameLength(self) -> float:\n \"\"\"\n\n sequenceFrameLength(self) -> float\n\n Returns the frame length of the node's image sequence.\n\n Raises hou.OperationFailed if the node could not be cooked or opened\n for processing.\n\n\n \"\"\"\n def isSingleImage(self) -> bool:\n \"\"\"\n\n isSingleImage(self) -> bool\n\n Returns True if the node has a single image. Returns False if the\n node has an image sequence.\n\n\n \"\"\"\n def saveImage(self, file_name: str, frame_range: Sequence[float] = ...) -> None:\n \"\"\"\n\n saveImage(self, file_name, frame_range=())\n\n Saves the node's cooked image sequence to disk. For multiple images,\n make sure that the file_name argument contains $F so that the\n sequence is written to multiple files.\n\n The optional frame_range argument can be specified to write only a\n subset of frames in the image sequence. frame_range must be a\n 2-tuple or a 3-tuple, where the first element is the start frame,\n the second element is the end frame and the third element is the\n frame increment. If frame_range is not given, then every frame in\n the image sequence is saved to disk.\n\n Raises ValueError if the frame increment in frame_range is 0. Raises\n hou.InvalidSize if the size of frame_range is not 0, 2 or 3. Raises\n hou.OperationFailed if the node could not be cooked or opened for\n processing. Raises hou.OperationFailed if the image could not be\n saved to disk.\n\n\n \"\"\"\n def hasMetaData(self, metadata_name: str) -> bool:\n \"\"\"\n\n hasMetaData(self, metadata_name) -> bool\n\n Returns True if the metadata with name metadata_name exists, False\n otherwise.\n\n\n \"\"\"\n def getMetaDataInt(self, metadata_name: str, index: int = 0) -> int:\n \"\"\"\n\n getMetaDataInt(self, metadata_name, index=0) -> int\n\n Returns numeric metadata as a single integer. In the case of\n vectors, matrices and arrays, index indicates the component to\n fetch. Floating point metadata will be truncated.\n\n\n \"\"\"\n def getMetaDataFloat(self, metadata_name: str, index: int = 0) -> float:\n \"\"\"\n\n getMetaDataFloat(self, metadata_name, index=0) -> double\n\n Returns numeric metadata as a single double precision value. In the\n case of vectors, matrices and arrays, index indicates the component\n to fetch.\n\n\n \"\"\"\n def getMetaDataString(self, metadata_name: str) -> str:\n \"\"\"\n\n getMetaDataString(self, metadata_name) -> str\n\n Returns string metadata from metadata_name.\n\n\n \"\"\"\n def getMetaDataIntArray(self, metadata_name: str) -> Tuple[int, ...]:\n \"\"\"\n\n getMetaDataIntArray(self, metadata_name) -> tuple of int\n\n Returns numeric metadata as an array of integers. Floating point\n metadata values will be truncated.\n\n\n \"\"\"\n def getMetaDataFloatArray(self, metadata_name: str) -> Tuple[float, ...]:\n \"\"\"\n\n getMetaDataFloatArray(self, metadata_name) -> tuple of double\n\n Returns numeric metadata as an array of double-precision values.\n\n\n \"\"\"\n def setPixelsOfCookingPlaneFromString(self, values: bytes, component: str|None = ..., interleaved: bool = ..., depth: EnumValue|None = ..., flip_vertically: bool = ...) -> None:\n \"\"\"\n\n setPixelsOfCookingPlaneFromString(self, values, component=None,\n interleaved=True, depth=None, flip_vertically=False)\n\n Set the pixels of the plane being cooked by the currently-running\n Python COP. This method is like hou.Cop2Node.setPixelsOfCookingPlane\n except values contains a binary string representation of the data\n instead of a sequence of floats. Consequently, this method is\n faster.\n\n The values binary string must be a bytes object in Python 3 and a\n str object in Python 2. See HOM binary data for more information.\n\n The depth parameter specifies how to interpret the values in the\n binary string, and is a hou.imageDepth enumerated value. If depth is\n None, the depth is assumed to be in the depth of the plane being\n cooked. Note that, by specifying depth explicitly, you can provide\n data in any depth, regardless of the actual depth stored by the COP.\n\n Note that this method can accept more types that just a string: it\n can receive any Python object that supports the buffer interface. In\n particular, arrays from the array and numpy Python modules are\n supported, so there is no need to first construct strings from those\n arrays.\n\n See hou.Cop2Node.setPixelsOfCookingPlane and\n hou.Cop2Node.allPixelsAsString for more information.\n\n\n \"\"\"\n\nclass crowds:\n \"\"\"\n\n hou.crowds\n\n Crowd-related functions.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def addBlendshapeInputs(base_shape_geo: Geometry, shapes: Sequence[AgentShape], channel_names: Sequence[str]) -> None:\n \"\"\"\n\n addBlendshapeInputs(self, base_shape_geo, shapes, channel_names)\n\n Adds blendshape inputs to a shape's geometry. This sets up the\n required detail attributes (blendshape_shapenames and\n blendshape_channels) on the base shape's geometry. For an existing\n agent shape, blendshape inputs can also be added using\n hou.AgentShape.addBlendshapeInputs.\n\n\n base_shape_geo\n A modifiable hou.Geometry for the base shape.\n\n shapes\n A hou.AgentShape sequence to add as blendshape inputs.\n hou.AgentShapeLibrary.addShape should be called separately to\n add these shapes to the shape library.\n\n channel_names\n A str sequence specifying the channel name to use for each\n shape. Raises hou.InvalidSize if the length does not match the\n shapes list.\n\n\n \"\"\"\n @staticmethod\n def addInBetweenShapes(primary_shape_geo: Geometry, shapes: Sequence[AgentShape], weights: Sequence[float]) -> None:\n \"\"\"\n\n addInBetweenShapes(self, primary_shape_geo, shapes, weights)\n\n Adds in-between shapes to a blendshape input. This sets up the\n required detail attributes (blendshape_shapenames and\n blendshape_inbetweenweights) on the primary shape's geometry. For an\n existing agent shape, in-between shapes can also be added using\n hou.AgentShape.addInBetweenShapes.\n\n\n primary_shape_geo\n A modifiable hou.Geometry for the primary shape.\n\n shapes\n A hou.AgentShape sequence to add as in-between shapes.\n hou.AgentShapeLibrary.addShape should be called separately to\n add these shapes to the shape library.\n\n weights\n A float sequence specifying the weight that each in-between\n shape is applied at. Raises hou.InvalidSize if the length does\n not match the shapes list.\n\n\n \"\"\"\n @staticmethod\n def setBlendshapeDeformerParms(base_shape_geo: Geometry, attribs: str = ..., point_id_attrib: str = ..., prim_id_attrib: str = ...) -> None:\n '''\n\n setBlendshapeDeformerParms(self, base_shape_geo, attribs=\\\\\"P N\\\\\",\n point_id_attrib=\\\\\"id\\\\\", prim_id_attrib=\\\\\"id\\\\\")\n\n Adds attributes to the geometry to specify parameters for the\n blendshapes deformer. This creates the following detail attributes:\n blendshape_attribs, blendshape_ptidattr, and blendshape_primidattr.\n For an existing agent shape, the deformer parameters can be set\n using hou.AgentShape.setBlendshapeDeformerParms.\n\n\n attribs\n Specifies a list or pattern of attributes to be blended by the\n deformer.\n\n point_id_attrib\n Specifies the name of a point attribute used to match up points\n between the different blendshape inputs.\n\n prim_id_attrib\n Specifies the name of a primitive attribute used to match up\n points between the different blendshape inputs.\n\n\n '''\n @staticmethod\n def findAgentDefinitions(geometry: Geometry, group: str = ..., group_type: EnumValue = ...) -> Tuple[AgentDefinition,...]:\n '''\n\n findAgentDefinitions(geometry, group = \\\\\"\\\\\",\n group_type=hou.geometryType.Primitives) -> tuple of hou.AgentDefinition\n\n Returns a list of the unique agent definitions in the geometry.\n\n This is equivalent to the following code, but is significantly\n faster.\n\n > definitions = set()\n > for prim in geometry.globPrims(group):\n > if prim.type() == hou.primType.Agent:\n > definitions.add(prim.definition())\n > \n > return definitions\n\n geometry\n A hou.Geometry.\n\n group\n An optional group string to filter which primitives are\n inspected. The pattern format is the same as the format used for\n group parameters on SOP nodes.\n\n group_type\n A hou.geometryType indicating whether to parse the group string\n as a point or primitive group. If the value is None, the group\n will be guessed by parsing it as a point group if it fails to\n parse as a primitive group.\n\n\n '''\n @staticmethod\n def replaceAgentDefinitions(geometry: Geometry, new_definition_map: Mapping[AgentDefinition, AgentDefinition], group: str = ..., group_type: EnumValue = ...) -> None:\n '''\n\n replaceAgentDefinitions(geometry, new_definition_map, group = \\\\\"\\\\\",\n group_type=hou.geometryType.Primitives)\n\n Replaces agent definitions in the geometry with new versions. This\n is a useful convenience function when modifying each agent\n definition in the geometry, particularly when also using\n hou.crowds.findAgentDefinitions.\n\n For example:\n\n > defns = hou.crowds.findAgentDefinitions(geo, group)\n > new_defn_map = {}\n > for defn in defns:\n > new_defn = defn.freeze()\n > new_defn_map[defn] = new_defn\n > \n > # Add a clip to the new agent definition.\n > new_defn.addClip(...)\n > \n > # Switch all agents in the group to their respective new agent definition.\n > hou.crowds.replaceAgentDefinitions(geo, new_defn_map, group)\n\n geometry\n A modifiable hou.Geometry.\n\n new_definition_map\n A dictionary mapping each hou.AgentDefinition to a\n hou.AgentDefinition that it should be replaced by.\n\n group\n An optional group string to filter which primitives are\n modified. The pattern format is the same as the format used for\n group parameters on SOP nodes.\n\n group_type\n A hou.geometryType indicating whether to parse the group string\n as a point or primitive group. If the value is None, the group\n will be guessed by parsing it as a point group if it fails to\n parse as a primitive group.\n\n\n '''\n @staticmethod\n def computeLocalTransforms(rig: AgentRig, world_xforms: typing.Iterable[Matrix4]) -> Tuple[Matrix4, ...]:\n \"\"\"\n\n computeLocalTransforms(self, rig, xforms) -> tuple of hou.Matrix4\n\n Converts transforms from world space to local space using the\n provided rig.\n\n\n rig\n A hou.AgentRig, which specifies the transform hierarchy.\n\n xforms\n A sequence of hou.Matrix4, with a world space transform for each\n joint in the rig. Raises hou.InvalidSize if the length does not\n match hou.AgentRig.transformCount.\n\n\n \"\"\"\n @staticmethod\n def computeWorldTransforms(rig: AgentRig, local_xforms: typing.Iterable[Matrix4]) -> Tuple[Matrix4, ...]:\n \"\"\"\n\n computeWorldTransforms(self, rig, xforms) -> tuple of hou.Matrix4\n\n Converts transforms from local space to world space using the\n provided rig.\n\n\n rig\n A hou.AgentRig, which specifies the transform hierarchy.\n\n xforms\n A sequence of hou.Matrix4, with a local space transform for each\n joint in the rig. Raises hou.InvalidSize if the length does not\n match hou.AgentRig.transformCount.\n\n\n \"\"\"\n @staticmethod\n def computeRotationLimits(rig: AgentRig, clips: Sequence[AgentClip], xform_idx: int, parent_xform_idx: int) -> dict[str, Any]:\n \"\"\"\n\n computeRotationLimits(rig, clips, transform, parent_transform) -> dict\n of str to values\n\n Computes rotation limits for the specified joint based on the range\n of motion in the provided clips.\n\n The return value is a dictionary with the following keys:\n\n * anchor_pos: A hou.Vector3 containing the cone's anchor position.\n\n * rotation: A hou.Vector3 containing the cone's orientation.\n\n * child_rotation: A hou.Vector3 containing the child's orientation.\n\n * twist_limits: A hou.Vector2 containing the rotation limits for the\n twist axis.\n\n * up_limits: A hou.Vector2 containing the rotation limits for the up\n axis.\n\n * out_limits: A hou.Vector2 containing the rotation limits for the out\n axis.\n\n\n rig\n A hou.AgentRig.\n\n clips\n A list of hou.AgentClip.\n\n transform\n Index of a transform in the agent's rig.\n\n parent_transform\n Index of the parent transform in the agent's rig.\n\n\n \"\"\"\n @staticmethod\n def shapeDeformers() -> Tuple[AgentShapeDeformer, ...]:\n \"\"\"\n\n shapeDeformers() -> tuple of hou.AgentShapeDeformer\n\n Returns a list of the available shape deformers.\n\n\n \"\"\"\n @staticmethod\n def findShapeDeformer(name: str) -> Optional[AgentShapeDeformer]:\n \"\"\"\n\n findShapeDeformer(name) -> hou.AgentShapeDeformer\n\n Finds the shape deformer with the specified name, or None if no such\n deformer exists.\n\n\n \"\"\"\n @staticmethod\n def applyUsdProcedural(stage: pxr.Usd.Stage, selection_rule: LopSelectionRule, camera_path: str, resolution: Tuple[int, int], lod_threshold: float, offscreen_quality: float, optimize_identical_poses: bool, bake_all_agents: bool, frame: float, prototype_material: str, instance_material: str, default_material: str) -> None:\n \"\"\"\n\n applyUsdProcedural(self, stage, selection_rule, camera_path, resolution,\n lod_threshold, frame, optimize_identical_poses, bake_all_agents,\n prototype_material, instance_material, default_material)\n\n Applies the crowd procedural to a USD stage.\n\n Raises hou.OperationFailed if an error occurred when applying the\n procedural.\n\n\n stage\n The USD stage to modify.\n\n selection_rule\n A hou.LopSelectionRule specifying the SkelRoot instances the\n procedural should be applied to.\n\n camera_path\n A path to a Camera primitive in the stage to use for evaluating\n LOD.\n\n resolution\n A pair of integers specifying the output image's resolution.\n\n lod_threshold\n The threshold at which the LOD optimization will be used. The\n default value of 1.0 means that the optimization will be used\n when tolerance between the agent poses is less than\n approximately 1 pixel. Lower values can eliminate deformed\n geometry differences which might still be noticeable depending\n on the scene, but make it less likely for the LOD optimization\n to trigger and may increase the render's memory footprint.\n\n offscreen_quality\n Scales the approximate size of the agent in screen space for\n agents that are not directly visible to the camera. Smaller\n values will make offscreen agents more likely to become an\n instance of another agent.\n\n optimize_identical_poses\n A boolean value indicating whether to instance the deformed\n geometry for agents with exactly the same pose (including\n foreground agents). In most scenarios it is rare for agents to\n have identical poses (due to randomizing clip speeds, time\n offsets, etc) so this can typically be disabled to eliminate\n unnecessary computation.\n\n bake_prototype_agents\n A boolean value indicating whether to generate deformed geometry\n for the SkelRoot primitives that became prototypes for\n background agents. This geometry is instanced by the matching\n background agents as well as the prototype's original source\n agent.\n\n When turned off, the procedural only authors overrides for the\n skel:animationSource relationship to bind background agents to\n the same SkelAnimation primitive (skeleton pose) as their\n prototype agent. This produces the same final result, rendering\n background agents as instances of the prototype's deformed\n geometry, but is only supported in Hydra 2 and will not work if\n the USDIMAGINGGL_ENGINE_ENABLE_SCENE_INDEX environment variable\n is set to 0. This method can be more efficient since the\n procedural authors a smaller set of changes to the stage, and\n the deformed point positions are generated through Hydra at\n render time in the usual manner.\n\n bake_all_agents\n A boolean value indicating whether to generate deformed geometry\n for the remaining SkelRoot primitives that did not become an\n instance or prototype. This can be useful if the deformed\n geometry is required for subsequent procedurals. Otherwise, the\n deformed point positions for these agents will be generated\n through Hydra at render time.\n\n frame\n The time sample to apply the procedural at.\n\n prototype_material\n The path to a material to apply to SkelRoot primitives whose\n deformed geometry became a prototype for background instances.\n\n instance_material\n The path to a material to apply to SkelRoot primitives which\n became an instance of another SkelRoot's deformed geometry.\n\n default_material\n The path to a material to apply to SkelRoot primitives which\n were not modified by the crowd procedural.\n\n\n \"\"\"\n\nclass DataParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.DataParmTemplate\n\n Describes a parameter tuple containing data values.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, num_components: int, look: EnumValue = ..., naming_scheme: EnumValue = ..., unknown_str: str|None = ..., disable_when: str|None = ..., is_hidden: bool = ..., is_label_hidden: bool = ..., join_with_next: bool = ..., help: str|None = ..., script_callback: str|None = ..., script_callback_language: EnumValue = ..., tags: dict[str, str] = ..., unknown_dict: dict[EnumValue, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[EnumValue] = ...) -> None:\n \"\"\"\n\n __init__(self, name, label, num_components, look=hou.parmLook.Regular,\n naming_scheme=hou.parmNamingScheme.XYZW, disable_when=None,\n is_hidden=False, is_label_hidden=False, join_with_next=False, help=None,\n script_callback=None,\n script_callback_language=hou.scriptLanguage.Hscript, tags={},\n default_expression=(), default_expression_language=())\n\n Construct a new DataParmTemplate.\n\n\n name\n See hou.ParmTemplate.name for more information.\n\n label\n See hou.ParmTemplate.label for more information.\n\n num_components\n See hou.ParmTemplate.numComponents for more information.\n\n look\n See hou.ParmTemplate.look for more information.\n\n naming_scheme\n See hou.ParmTemplate.namingScheme for more information.\n\n disable_when\n See hou.ParmTemplate.disableWhen for more information.\n\n is_hidden\n See hou.ParmTemplate.isHidden for more information.\n\n is_label_hidden\n See hou.ParmTemplate.isLabelHidden for more information.\n\n join_with_next\n See hou.ParmTemplate.joinsWithNext for more information.\n\n help\n See hou.ParmTemplate.help for more information.\n\n script_callback\n See hou.ParmTemplate.scriptCallback for more information.\n\n script_callback_language\n See hou.ParmTemplate.scriptCallbackLanguage for more\n information.\n\n tags\n See hou.ParmTemplate.tags for more information.\n\n default_expression\n See the defaultExpression method for more information.\n\n default_expression_language\n See the defaultExpressionLanguage method for more information.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def dataParmType(self) -> EnumValue:\n \"\"\"\n\n dataParmType(self) -> hou.dataParmType enum value\n\n Return the type of this data parameter. This type determines whether\n the parameter stores geometry data or a JSON map structure.\n\n See hou.dataParmType for more information.\n\n\n \"\"\"\n def setDataParmType(self, data_type: EnumValue) -> None: ...\n def defaultExpression(self) -> Tuple[str, ...]:\n \"\"\"\n\n defaultExpression(self) -> tuple of strings\n\n Return the default expression for new parameter instances.\n\n The default expression takes precedence over the default value. If a\n component has no default expression (i.e. an empty string), then the\n default value is used for new parameter instances.\n\n Note that the default expression language is needed to interpret the\n meaning of the default expression.\n\n For example, suppose this parm template is named t, the naming\n scheme is XYZW, it has 3 components, the default value is (1.0, 2.0,\n 3.0), the default expression is ($F, hou.frame(), ) and the default\n expression language is (hou.scriptLanguage.Hscript,\n hou.scriptLanguage.Python, hou.scriptLanguage.Hscript). Then the\n corresponding parm tuple instance on a node would be named t and\n would contain parameters tx, ty, tz. When the node is created, tx\n would have a default Hscript expression of $F, ty would have a\n default Python expression of hou.frame(), and tz would have a\n default value of 3.0.\n\n\n \"\"\"\n def setDefaultExpression(self, default_expression: Sequence[str]) -> None:\n \"\"\"\n\n setDefaultExpression(self, default_expression)\n\n Set the default expression for new parameter instances to a sequence\n of strings.\n\n See the hou.DataParmTemplate.defaultExpression method for more\n information. Note that if the number of strings in the sequence is\n different from the number of components in the parm template, any\n extra values will be discarded and any missing expressions will\n become the empty string.\n\n\n \"\"\"\n def defaultExpressionLanguage(self) -> Tuple[EnumValue, ...]:\n \"\"\"\n\n defaultExpressionLanguage(self) -> tuple of hou.scriptLanguage\n\n Return the default expression language for new parameter instances.\n\n The default expression language only applies if the default\n expression is set. If the default expression of a component is not\n set, then the expression language is set to\n hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n def setDefaultExpressionLanguage(self, default_expression_language: Sequence[EnumValue]) -> None:\n \"\"\"\n\n setDefaultExpressionLanguage(self, default_expression_language)\n\n Set the default expression language for new parameter instances to a\n sequence of hou.scriptLanguage values.\n\n See the defaultExpressionLanguage method for more information. Note\n that if the number of hou.scriptLanguage values in the sequence is\n different from the number of components in the parm template, any\n extra values will be discarded and any missing expression languages\n will become hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n\nclass DataTree(PaneTab):\n \"\"\"\n\n hou.DataTree\n\n Represents a Data Tree panetab.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def treeTypes(self) -> Tuple[str, ...]:\n \"\"\"\n\n treeTypes(self) -> tuple of str\n\n Returns a tuple of strings that represent the different tree types\n that can be shown in the Data Tree pane.\n\n\n \"\"\"\n def treeType(self) -> str:\n \"\"\"\n\n treeType(self) -> str\n\n Returns the current tree type being shown in the Data Tree. This\n function may return an empty string if no tree type has been chosen\n yet.\n\n\n \"\"\"\n def setTreeType(self, tree_type: str) -> bool:\n \"\"\"\n\n setTreeType(self, tree_type) -> bool\n\n Changes the tree type being displayed in the Data Tree. Valid values\n are any strings returned by the treeTypes function. Returns True if\n the tree type was successfully changed, otherwise False.\n\n\n \"\"\"\n def currentPath(self) -> str:\n \"\"\"\n\n currentPath(self) -> str\n\n Returns the path to the current node in the tree.\n\n\n \"\"\"\n def clearCurrentPath(self) -> None:\n \"\"\"\n\n clearCurrentPath(self) -> str\n\n Clears the node(s) currently selected in the tree.\n\n\n \"\"\"\n def setCurrentPath(self, path: str, multi_select: bool = False, index: int = -1) -> None:\n \"\"\"\n\n setCurrentPath(self, path, multi=False, index=-1)\n\n Sets the currently selected node in the tree. If the provided path\n does not match a node in the tree, the tree will still attempt to\n set the current node to the best possible match of the provided\n path.\n\n If multi is set to True, the previous selection will not be cleared\n before selecting the new the node. This allows multiple nodes to be\n selected in the tree.\n\n\n \"\"\"\n def setCurrentPaths(self, paths: Sequence[str], expanded: bool) -> None:\n \"\"\"\n\n setCurrentPaths(self, paths, expand)\n\n Selects mutliple nodes in the data tree based on the array of paths\n passed in. If the expand flag is set to True the tree nodes will be\n expanded after selection.\n\n\n \"\"\"\n def setTreeExpanded(self, expanded: bool) -> None:\n \"\"\"\n\n setTreeExpanded(self, expanded)\n\n Recursively sets the expanded state of the entire data tree.\n\n\n \"\"\"\n def setCurrentNodeExpanded(self, expanded: bool) -> None:\n \"\"\"\n\n setCurrentNodeExpanded(self, expanded)\n\n Sets the expanded state of the currently selected node in the tree.\n If there is no selected node the method has no effect on the tree.\n\n\n \"\"\"\n\nclass Desktop:\n \"\"\"\n\n hou.Desktop\n\n Class representing a Houdini desktop (a pane layout).\n\n A desktop contains one or more panes. Each pane contains one or more\n pane tabs of various types (scene viewer, parameters, network editor,\n etc.) The main desktop window can be split horizontally or vertically\n into two panes, and each pane can itself be split horizontally or\n vertically.\n\n Note that a floating panel also contains one or more panes and a\n floating panel may optionally be attached to a desktop.\n\n The methods in this class that return pane tabs, panes, and floating\n panels only return those objects that are attached to (i.e. saved with)\n the desktop. To access all the visible pane tabs, panes, and floating\n panels, including those not attached to any desktop, use the functions\n in hou.ui.\n\n See also hou.ui.curDesktop, hou.ui.desktops, hou.Pane, hou.PaneTab, and\n hou.FloatingPanel.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def panes(self) -> Tuple[Pane, ...]:\n \"\"\"\n\n panes(self) -> tuple of hou.Pane\n\n Return the panes inside this desktop. Note that the result includes\n panes in floating panels as long as they are attached to the\n desktop.\n\n The following function will return all visible panes, regardless of\n whether or not they are attached to a desktop:\n\n > def allPanes():\n > '''Return a tuple of all visible panes, regardless of whether or not\n > they are attached to a desktop.'''\n > # Loop through all the pane tabs and add each tab's pane to the result\n > # if it's not already there. Note that the only way to uniquely\n > # identify a pane is using its id.\n > ids_to_panes = {}\n > for pane_tab in hou.ui.paneTabs():\n > pane = pane_tab.pane()\n > if pane.id() not in ids_to_panes:\n > ids_to_panes[pane.id()] = pane\n > return ids_to_panes.values()\n\n \"\"\"\n def paneTabs(self) -> Tuple[PaneTab, ...]:\n \"\"\"\n\n paneTabs(self) -> tuple of hou.PaneTab\n\n Return the pane tabs that are contained in this desktop or are in\n floating panels attached to this desktop.\n\n This method does not return floating pane tabs that are not attached\n to this desktop. Use hou.ui.paneTabs to get all the visible pane\n tabs, regardless of whether they are attached to this desktop.\n\n\n \"\"\"\n def currentPaneTabs(self) -> Tuple[PaneTab, ...]:\n \"\"\"\n\n currentPaneTabs(self) -> tuple of hou.PaneTab\n\n Return the pane tabs that are contained in this desktop or are in\n floating panels attached to this desktop and are currently selected\n in their containing panes.\n\n This method does not return floating pane tabs that are not attached\n to this desktop. Use hou.ui.currentPaneTabs to get all the selected\n pane tabs, regardless of whether they are attached to this desktop.\n\n\n \"\"\"\n def floatingPaneTabs(self) -> Tuple[PaneTab, ...]:\n \"\"\"\n\n floatingPaneTabs(self) -> tuple of hou.PaneTab\n\n Return all the pane tabs in floating panels that are attached to\n this desktop.\n\n\n \"\"\"\n def paneTabOfType(self, type: EnumValue, index: int = 0) -> Optional[PaneTab]:\n \"\"\"\n\n paneTabOfType(self, type, index=0) -> hou.PaneTab or None\n\n Find and return the pane tab with the desired type. If no such tab\n exists, return None. Like hou.Desktop.paneTabs, this method searches\n pane tabs in the desktop or in floating panels attached to the\n desktop.\n\n Use hou.ui.paneTabOfType to search all the visible pane tabs,\n regardless of whether they are attached to this desktop.\n\n\n type\n A hou.paneTabType enumerated variable.\n\n index\n If there are multiple tabs with the desired type, this parameter\n determines which one is returned. Use index=0 to return the\n first found tab, index=1 to return the second found tab, etc. By\n default, index is 0.\n\n This method can be approximately implemented as follows:\n\n > def paneTabOfType(self, tab_type, index=0):\n > pane_tabs = [t for t in self.paneTabs() if t.type() == tab_type]\n > \n > if max(index, 0) > len(pane_tabs):\n > return None\n > return pane_tabs[max(index, 0)]\n\n \"\"\"\n def findPane(self, pane_id: int) -> Optional[Pane]:\n \"\"\"\n\n findPane(self, pane_id) -> hou.Pane or None\n\n Return the pane with the given unique id, or None if no such pane\n exists. Like hou.Desktop.panes, this method searches panes in the\n desktop or in floating panels attached to the desktop.\n\n Use hou.ui.findPane to search all the visible panes, regardless of\n whether they are attached to this desktop.\n\n\n \"\"\"\n def findPaneTab(self, name: str) -> Optional[PaneTab]:\n \"\"\"\n\n findPaneTab(self, name) -> hou.PaneTab or None\n\n Return the pane tab with the given name, or None if no such tab\n exists. Like hou.Desktop.paneTabs, this method searches pane tabs in\n the desktop or in floating panels attached to the desktop.\n\n The name may optionally be prefixed by the desktop name and a\n period.\n\n Use hou.ui.findPaneTab to search all the visible pane tabs,\n regardless of whether they are attached to this desktop.\n\n\n \"\"\"\n def createFloatingPaneTab(self, pane_tab_type: EnumValue, position: Sequence[float] = ..., size: Sequence[float] = ..., python_panel_interface: PythonPanelInterface|None = ..., immediate: bool = ...) -> PaneTab:\n \"\"\"\n\n createFloatingPaneTab(self, pane_tab_type, position=(), size=(),\n python_panel_interface=None, immediate=False) -> hou.PaneTab\n\n Create and return a new floating window containing a single pane\n tab. Note that this method creates a floating panel with a single\n pane tab, and the graphical interface to add more tabs or split the\n pane inside the panel is not exposed.\n\n\n pane_tab_type\n A hou.paneTabType enumerated variable.\n\n position\n A tuple of two floats specifying the X and Y positions of the\n new window, respectively. The window will open near this\n position, not necessarily exactly at this position. If this\n value is an empty tuple, Houdini will choose a default location.\n\n size\n A tuple of two floats specifying the width and height of the new\n window, respectively. If this value is an empty tuple, Houdini\n will choose a default size.\n\n python_panel_interface\n The name of the Python Panel interface to be displayed in the\n floating pane tab. Specifying the interface name additionally\n hides the Python Panel toolbar. If python_panel_interface is\n None or points to an interface that does not exist then the\n default Python Panel pane tab is displayed along with the\n toolbar.\n\n This argument is ignored if pane_tab_type is not set to\n hou.paneTabType.PythonPanel.\n\n immediate\n Open the window immediately to help setting the window position\n correctly.\n\n Also note that the floating panel containing the new pane tab does\n not contain any panes: calling hou.PaneTab.pane on the pane tab\n returns None, and calling hou.FloatingPanel.panes on its floating\n panel returns an empty tuple. See hou.FloatingPanel for more\n information on these stripped down floating panels.\n\n See also hou.Desktop.createFloatingPanel.\n\n The following example function takes a hou.OpNode and opens a\n floating parameter pane pinned to that node.\n\n > def openParmPane(node):\n > '''Open a floating parameter pane for a particular node.'''\n > pane_tab = hou.ui.curDesktop().createFloatingPaneTab(hou.paneTabType.Parm)\n > pane_tab.setCurrentNode(node)\n > pane_tab.setPin(True)\n > return pane_tab\n\n \"\"\"\n def createFloatingPane(self, pane_tab_type: EnumValue, position: Sequence[float] = ..., size: Sequence[float] = ..., python_panel_interface: PythonPanelInterface|None = ..., immediate: bool = ...) -> PaneTab: ...\n def floatingPanels(self) -> Tuple[FloatingPanel, ...]:\n \"\"\"\n\n floatingPanels(self) -> tuple of hou.FloatingPanel\n\n Return all the floating panels attached to this desktop.\n\n Use hou.ui.floatingPanels to get all the visible floating panels,\n including those not attached to this desktop.\n\n See also hou.Desktop.floatingPaneTabs.\n\n\n \"\"\"\n def createFloatingPanel(self, pane_tab_type: EnumValue, position: Sequence[float] = ..., size: Sequence[float] = ..., python_panel_interface: PythonPanelInterface|None = ..., immediate: bool = ...) -> FloatingPanel:\n \"\"\"\n\n createFloatingPanel(self, pane_tab_type, position=(), size=(),\n python_panel_interface=None, immediate=False) -> hou.FloatingPanel\n\n Create a floating panel and return it. The returned floating panel\n contains one pane which contains one pane tab of the desired type.\n\n See hou.Desktop.createFloatingPaneTab for a description of the\n parameters. This method differs from createFloatingPaneTab in two\n ways: First, it returns the floating panel instead of the pane tab.\n Second, the floating panel that is created from this method is not\n locked down, and the user can add more pane tabs and split the\n panes.\n\n The following example creates a floating panel with a parameters\n pane tab and a channel viewer (motion viewer) pane tab:\n\n > panel = hou.ui.curDesktop().createFloatingPanel(hou.paneTabType.Parm)\n > pane1 = panel.panes()[0]\n > pane2 = pane1.splitVertically()\n > pane2.tabs()[0].setType(hou.paneTabType.ChannelViewer)\n\n \"\"\"\n def paneUnderCursor(self) -> Optional[Pane]:\n \"\"\"\n\n paneUnderCursor(self)\n\n Return the hou.Pane object located under the mouse cursor. Return\n None if no pane is located under the mouse cursor.\n\n This method does not search floating panes that are not attached to\n this desktop. Use hou.ui.paneUnderCursor to search all the visible\n panes, regardless of whether they are attached to this desktop.\n\n\n \"\"\"\n def paneTabUnderCursor(self) -> Optional[PaneTab]:\n \"\"\"\n\n paneTabUnderCursor(self)\n\n Similar to hou.Desktop.paneUnderCursor but return the hou.PaneTab\n object instead located under the mouse cursor. Return None if no\n pane tab is located under the mouse cursor.\n\n This method does not search floating pane tabs that are not attached\n to this desktop. Use hou.ui.paneTabUnderCursor to search all the\n visible pane tabs, regardless of whether they are attached to this\n desktop.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the desktop's name.\n\n Each desktop has a unique name. The desktop's name cannot be changed\n through either the scripting interface or through Houdini.\n\n\n \"\"\"\n def shelfDock(self) -> ShelfDock:\n \"\"\"\n\n shelfDock(self) -> hou.ShelfDock\n\n Return the shelf dock for the current desktop.\n\n\n \"\"\"\n def displaySideHelp(self, show: bool = True) -> Optional[PaneTab]:\n \"\"\"\n\n displaySideHelp(self, show=True) -> hou.PaneTab\n\n Show or hide the side help pane.\n\n If show is set to True (default) this method displays the help pane\n and returns a help browser pane tab. If set to False then this\n method hides the help browser pane at the side of the desktop and\n returns None.\n\n\n \"\"\"\n def displayHelp(self, node_type: NodeType) -> None:\n \"\"\"\n\n displayHelp(self, node_type)\n\n Loads the help for the specified node type in the last opened help\n browser pane tab. Creates a help browser pane tab if no such pane\n tab already exists.\n\n\n \"\"\"\n def displayHelpPath(self, help_path: str) -> None:\n \"\"\"\n\n displayHelpPath(self, help_path)\n\n Loads the help for the specified help path in the last opened help\n browser pane tab. Creates a help browser pane tab if no such pane\n tab already exists. The path can either be a Houdini help URL (i.e.\n op:Sop/copy, tool:curve) or a raw help path (i.e. /nodes/sop/copy,\n shelf/curve).\n\n\n \"\"\"\n def displayHelpPyPanel(self, interface_name: str) -> None:\n \"\"\"\n\n displayHelpPyPanel(self, interface_name)\n\n Loads the help for the python panel with the specified name in the\n last opened help browser pane tab. Creates a help browser pane tab\n if no such pane tab already exists.\n\n Raises HOM_Error if the interface name is invalid.\n\n\n \"\"\"\n def setAsCurrent(self) -> None:\n \"\"\"\n\n setAsCurrent(self)\n\n Make this desktop the currently selected one. See also\n hou.ui.desktops.\n\n This example changes to the animate desktop:\n\n > desktops_dict = dict((d.name(), d) for d in hou.ui.desktops())\n > desktops_dict['Animate'].setAsCurrent()\n\n \"\"\"\n\nclass Dialog:\n \"\"\"\n\n hou.Dialog\n\n Class representing a Houdini dialog.\n\n This class represents only dialogs created by hou.ui.createDialog.\n\n Custom dialogs can be created with Houdini's User Interface Script\n Language. An overview of the language can be found in the Houdini\n Development Kit (HDK) documentation, specifically in the Houdini User\n Interface -> The .ui Script Language section.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Delete this dialog.\n\n If you call methods on a Dialog instance after it has been\n destroyed, Houdini will raise hou.ObjectWasDeleted.\n\n\n \"\"\"\n def setValue(self, name: str, value: OptionType) -> None:\n \"\"\"\n\n setValue(self, name, value)\n\n Set the value of the specified UI variable.\n\n Raises TypeError if either name or value is None. Raises\n hou.OperationFailed if no UI variable with the specified name\n exists.\n\n\n \"\"\"\n def enableValue(self, name: str, onoff: bool) -> None:\n \"\"\"\n\n enableValue(self, name, onoff)\n\n Enable or disable the specified UI variable.\n\n Set onoff to True to enable the variable. Set onoff to False to\n disable the variable.\n\n Raises TypeError if either name is None. Raises hou.OperationFailed\n if no UI variable with the specified name exists.\n\n\n \"\"\"\n def waitForValueToChangeTo(self, name: str, new_value: OptionType) -> None:\n \"\"\"\n\n waitForValueToChangeTo(self, name, new_value)\n\n Wait for the specified UI variable to change its value to new_value.\n\n This is a blocking call. The method will return execution when the\n variable has changed to the desired value. Note that Houdini will\n remain responsive even when this method is blocked waiting.\n\n If the variable's current value is already set to new_value then\n this method will return immediately.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists.\n\n\n \"\"\"\n def menuItems(self, name: str) -> Tuple[str, ...]:\n \"\"\"\n\n menuItems(self, name) -> tuple of str\n\n Return the menu entries for the specified UI variable.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists. Raises\n hou.OperationFailed if the UI variable does not point to a menu.\n\n\n \"\"\"\n def setMenuItems(self, name: str, items: Sequence[str]) -> None:\n \"\"\"\n\n setMenuItems(self, name, items)\n\n Set the menu entries in the specified UI variable.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists. Raises\n hou.OperationFailed if the UI variable does not point to a menu.\n\n\n \"\"\"\n def value(self, name: str) -> OptionType:\n \"\"\"\n\n value(self, name)\n\n Return the value of the given UI variable.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists.\n\n\n \"\"\"\n def addCallback(self, name: str, callback: Callable[[], None]) -> None:\n \"\"\"\n\n addCallback(self, name, callback)\n\n Register a callback function for the specified UI variable.\n\n The function is invoked when the value of the UI variable changes\n and receives no arguments.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists.\n\n\n \"\"\"\n def removeCallback(self, name: str, callback: Callable[[], None]) -> None:\n \"\"\"\n\n removeCallback(self, name, callback)\n\n Remove the specified callback function from the UI variable.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists. Raises\n hou.OperationFailed if the specified callback is not registered with\n the UI variable.\n\n\n \"\"\"\n def callbacks(self, name: str) -> Tuple[Callable[[], None],...]:\n \"\"\"\n\n callbacks(self, name) -> tuple of callbacks\n\n Return all callback functions registered with the given UI variable.\n\n Raises TypeError if name is None. Raises hou.OperationFailed if no\n UI variable with the specified name exists.\n\n\n \"\"\"\n\nclass dop:\n \"\"\"\n\n hou.dop\n\n DOP related functions.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def isScriptSolverRunning() -> bool:\n \"\"\"\n\n isScriptSolverRunning() -> bool\n\n Return whether or not a Python script solver DOP is currently\n running.\n\n This function is called from the Python code that is automatically\n generated when you create a new Python solver DOP type.\n\n\n \"\"\"\n @staticmethod\n def scriptSolverData() -> Optional[DopData]:\n \"\"\"\n\n scriptSolverData() -> hou.DopData\n\n Return the solver solver data corresponding to the currently running\n Python script solver DOP.\n\n A Python script solver DOP runs in two passes. During the first\n pass, it evaluates its node parameters and stores them in the solver\n data. During this pass, hou.dop.isScriptSolverRunning returns False\n and you can access a writable version of the script solver data with\n hou.DopNode.pythonSolverData. During the second pass the solver is\n invoked to actually solve the objects. During this pass,\n hou.dop.isScriptSolverRunning returns True and you use this function\n to access a read-only version of the script solver data. You can\n access the objects being solved in this pass with\n hou.dop.scriptSolverNewObjects and hou.dop.scriptSolverObjects.\n\n DOP nodes attach data named Solver to each of the DOP objects being\n solved. If the only solver in use is the script solver, this data\n will be of type SIM_SolverScript. Otherwise, this data will be of\n type SIM_SolverMulti, and the SIM_SolverScript will be subdata of\n the multisolver data. This function provides an easy way of\n retrieving this data, regardless of where it exists.\n\n Typically, the solver data is shared between all the objects being\n solved. For this reason, the data returned by this function is read-\n only. Otherwise, if you modified this data, the DOP engine would\n copy it and the objects being solved would not share this data.\n\n\n \"\"\"\n @staticmethod\n def scriptSolverNetwork() -> OpNode | None:\n \"\"\"\n\n scriptSolverNetwork() -> hou.OpNode or None\n\n Return the DOP network node that contains the script solver DOP that\n is currently running, or None if not script solver is running. You\n would call this function from a script solver DOP.\n\n\n \"\"\"\n @staticmethod\n def scriptSolverSimulation() -> Optional[DopSimulation]: ...\n @staticmethod\n def scriptSolverObjects() -> Tuple[DopData, ...]:\n \"\"\"\n\n scriptSolverObjects() -> tuple of hou.DopObject\n\n Return a tuple of DOP objects being solved by the current script\n solver DOP. If no script solver is running, returns an empty tuple.\n\n\n \"\"\"\n @staticmethod\n def scriptSolverNewObjects() -> Tuple[DopData, ...]:\n \"\"\"\n\n scriptSolverNewObjects() -> tuple of hou.DopObject\n\n Return a tuple of newly-created DOP objects to later be solved by\n the current script solver DOP. If no script solver is running,\n returns an empty tuple.\n\n\n \"\"\"\n @staticmethod\n def scriptSolverTimestepSize() -> float:\n \"\"\"\n\n scriptSolverTimestepSize() -> float\n\n Return the timestep size for the script solver that is currently\n running, or 0.0 if no script solver is running.\n\n\n \"\"\"\n @staticmethod\n def scriptSolverTime() -> float: ...\n\nclass DopNode(OpNode):\n \"\"\"\n\n hou.DopNode\n\n Represents a dynamics node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def dopNetNode(self) -> OpNode:\n \"\"\"\n\n dopNetNode(self) -> hou.OpNode\n\n Return the DOP network node that contains this DOP node.\n\n\n \"\"\"\n def simulation(self) -> DopSimulation:\n \"\"\"\n\n simulation(self) -> hou.DopSimulation\n\n Return the simulation that this node contributes to. This method is\n a shortcut for self.dopNetNode().simulation().\n\n\n \"\"\"\n def processedObjects(self) -> Tuple[DopObject, ...]:\n \"\"\"\n\n processedObjects(self) -> tuple of hou.DopObject\n\n Return a tuple of DOP objects that this DOP node processes.\n\n\n \"\"\"\n def createdObjects(self) -> Tuple[DopObject, ...]:\n \"\"\"\n\n createdObjects(self) -> tuple of hou.DopObject\n\n Return a tuple of DOP objects that this DOP node creates.\n\n\n \"\"\"\n def isBypassed(self) -> bool:\n \"\"\"\n\n isBypassed(self) -> bool\n\n Returns whether the node's bypass flag is on.\n\n\n \"\"\"\n def bypass(self, on: bool) -> None:\n \"\"\"\n\n bypass(self, on)\n\n Turn the node's bypass flag on or off, making this node have no\n effect.\n\n\n \"\"\"\n def isDisplayFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayFlagSet(self) -> bool\n\n Return whether this node's display flag is on. This is the orange\n Output flag in the interface.\n\n\n \"\"\"\n def setDisplayFlag(self, on: bool) -> None:\n \"\"\"\n\n setDisplayFlag(self, on)\n\n Turn the node's display flag on or off. This the orange Output flag\n in the interface.\n\n\n \"\"\"\n def isTemplateFlagSet(self) -> bool:\n \"\"\"\n\n isTemplateFlagSet(self) -> bool\n\n Returns whether this node's template flag is on. This is the brown\n Hidden flag in the interface.\n\n\n \"\"\"\n def setTemplateFlag(self, on: bool) -> None:\n \"\"\"\n\n setTemplateFlag(self, on)\n\n Turns this node's template flag on or off. This is the brown Hidden\n flag in the interface.\n\n\n \"\"\"\n def displayNode(self) -> OpNode | None:\n \"\"\"\n\n displayNode(self) -> hou.OpNode or None\n\n If this node is a subnet (i.e. it contains child nodes), return the\n child that has its display flag set, or None if there are no\n children. Otherwise, return None.\n\n\n \"\"\"\n def renderNode(self) -> OpNode | None: ...\n def objectsToProcess(self) -> Tuple[DopObject, ...]:\n \"\"\"\n\n objectsToProcess(self) -> tuple of hou.DopObject\n\n Return a tuple of DOP objects that this node should process. Raises\n hou.PermissionError if called from outside a DOP implemented in\n Python.\n\n\n \"\"\"\n def pythonSolverData(self) -> DopData:\n \"\"\"\n\n pythonSolverData(self) -> hou.DopData\n\n If this node is a Python DOP solver, return the solver data added to\n the DOP network by this node. Otherwise, raises hou.PermissionError.\n\n This method is called from Python DOP solvers when the solver is not\n running, to copy data from the DOP parameters into the solver data.\n\n See also hou.dop.scriptSolverData.\n\n\n \"\"\"\n\nclass DopObject(DopData):\n \"\"\"\n\n hou.DopObject\n\n A type of DOP data that contains an object in the simulation.\n\n This object might be a rigid body, a fluid, cloth, etc. The type and\n properties of the DOP object are determined by the subdata attached to\n the object.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of this DOP object.\n\n\n \"\"\"\n def objid(self) -> int:\n '''\n\n objid(self) -> int\n\n Return the index of this object in the output from\n hou.DopSimulation.objects. This method is a shortcut for\n self.options().field(\\\\\"objid\\\\\").\n\n See hou.DopData.id for an example.\n\n Some fields in DOP records store an objid to refer to other objects.\n The following function looks up an object by objid:\n\n > def findObjectByObjid(dopnet_node, objid):\n > return dopnet_node.simulation().objects()[objid]\n\n '''\n def matches(self, pattern: str) -> bool:\n '''\n\n matches(self, pattern) -> bool\n\n Return whether or not this object\\'s name matches a pattern. * will\n match any number of characters and ? will match any single\n character. The pattern string contains only one pattern, so spaces\n in the pattern will be compared against the object name.\n\n > >>> obj = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().objects()[0]\n > >>> obj.name()\n > \\'box_object1\\'\n > >>> obj.matches(\\\\\"box*\\\\\")\n > True\n > >>> obj.matches(\\\\\"c*\\\\\")\n > False\n > >>> obj.matches(\\\\\"box* b*\\\\\")\n > False\n > >>> obj.matches(\\\\\"b?x_object1\\\\\")\n > True\n\n '''\n def transform(self, include_geometry_transform: bool = True) -> Matrix4:\n '''\n\n transform(self, include_geometry_transform=True) -> hou.Matrix4\n\n Return the transformation matrix for this object. If\n include_geometry_transform is False, the result is determined only\n by the object\\'s Position data. Otherwise, it is the transform in the\n object\\'s Geometry data, followed by the position transform.\n\n For simple DopData types, this method can be approximately\n implemented as follows:\n\n > def transform(self, include_geometry_transform=True):\n > result = hou.hmath.identityTransform()\n > \n > geometry = self.findSubData(\\\\\"Geometry\\\\\")\n > if include_geometry_transform and geometry is not None:\n > result *= geometry.record(\\\\\"Transform\\\\\").field(\\\\\"transform\\\\\")\n > \n > # Retrieve the position. If there is Geometry data, use its\n > # positionpath field to get the SIM_Position subdata. If not, look\n > # for data named Position.\n > position = None\n > if geometry is not None:\n > position = geometry.findSubData(\n > geometry.options().field(\\\\\"positionpath\\\\\"))\n > if position is None:\n > position = self.findSubData(\\\\\"Position\\\\\")\n > \n > # If we found position data, build a transformation from the pivot,\n > # rotation quaternion, and translate.\n > if position is not None:\n > options = position.options()\n > rotation = hou.Matrix4(options.field(\\\\\"orient\\\\\").extractRotationMatrix3())\n > result *= (hou.hmath.buildTranslate(-options.field(\\\\\"p\\\\\")) *\n > rotation *\n > hou.hmath.buildTranslate(options.field(\\\\\"p\\\\\")) *\n > hou.hmath.buildTranslate(options.field(\\\\\"t\\\\\")))\n > \n > return result\n\n '''\n\nclass DopRecord:\n \"\"\"\n\n hou.DopRecord\n\n A table of values stored inside a DopData.\n\n See hou.DopData for a description of DOP data, records, and fields.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def recordType(self) -> str:\n \"\"\"\n\n recordType(self) -> str\n\n Return the name of this record. See hou.DopData.recordTypes for more\n information.\n\n\n \"\"\"\n def recordIndex(self) -> int:\n \"\"\"\n\n recordIndex(self) -> int\n\n Return the index of this record. See hou.DopData.record and\n hou.DopData.records for more information.\n\n\n \"\"\"\n def fieldNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n fieldNames(self) -> tuple of str\n\n Return the names of all the fields inside this record. See\n hou.DopRecord.field for an example.\n\n\n \"\"\"\n def fieldType(self, field_name: str) -> EnumValue:\n \"\"\"\n\n fieldType(self, field_name) -> hou.fieldType enum value\n\n Return a hou.fieldType enumerated value that describes the type of\n data stored in a field. Returns hou.fieldType.NoSuchField if no\n field exists with that name.\n\n See hou.DopRecord.field for an example.\n\n\n \"\"\"\n def field(self, field_name: str) -> OptionType:\n '''\n\n field(self) -> int, bool, float, str, hou.Vector2, hou.Vector3,\n hou.Vector4, hou.Quaternion, hou.Matrix3, or hou.Matrix4\n\n Return the value of a field inside this record, or None if no such\n field exists.\n\n Note that you can add the suffixes x, y, and z to a vector field\\'s\n name to access the individual float values.\n\n > # The following code assumes you have created a box from the shelf and used\n > # Rigid Bodies > RBD Object on the shelf to make it a rigid body.\n > >>> record = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation().findData(\\\\\"box_object1/Forces/Gravity_gravity1\\\\\").options()\n > >>> record.fieldNames()\n > (\\'force\\', \\'handlepos\\')\n > >>> record.field(\\\\\"force\\\\\")\n > \n > >>> record.field(\\\\\"forcey\\\\\")\n > -9.8066501617431641\n > >>> record.fieldType(\\\\\"force\\\\\")\n > fieldType.Vector3\n > >>> record.fieldType(\\\\\"forcey\\\\\")\n > fieldType.Float\n\n This example function creates a dict out of a record:\n\n > def recordAsDict(record):\n > return dict((field_name, record.field(field_name))\n > for field_name in record.fieldNames())\n\n The following function returns the geometry transform of an object:\n\n > def dopGeometryTransform(dopnet_node, object_name):\n > subdata = dopnet_node.simulation().findObject(object_name).findSubData(\\\\\"Geometry\\\\\")\n > return subdata.record(\\\\\"Transform\\\\\").field(\\\\\"transform\\\\\")\n\n '''\n def setFieldBool(self, field_name: str, value: bool) -> None:\n \"\"\"\n\n setFieldBool(self, field_name, value)\n\n Set a field to the specified boolean value. You would call this\n method from a script solver DOP.\n\n To set a field to a different type, use hou.DopRecord.setField.\n\n Raises hou.PermissionError if called from outside a script solver\n DOP.\n\n\n \"\"\"\n def setField(self, field_name: str, value: OptionType) -> None:\n \"\"\"\n\n setField(self, field_name, value)\n\n Set a field to the specified value. You would call this method from\n a script solver DOP. value may be an int, float, str, hou.Vector2,\n hou.Vector3, hou.Vector4, hou.Quaternion, hou.Matrix3, or\n hou.Matrix4.\n\n Unfortunately, this method cannot be used to set a field to a\n boolean (True or False) value. If you pass a boolean to this method,\n it will set the field to the integer 1 or 0. To properly set it to a\n boolean value, use hou.DopRecord.setFieldBool.\n\n Raises hou.PermissionError if called from outside a script solver\n DOP.\n\n\n \"\"\"\n\nclass DopRelationship(DopData):\n \"\"\"\n\n hou.DopRelationship\n\n A type of DOP data that stores which DOP objects affect one another.\n\n In addition to the Basic and Options records, a DopRelationship contains\n ObjInAffectors and ObjInGroup records. The former contains the objects\n doing the affecting and the latter contains the objects being affected.\n\n See hou.DopSimulation.relationships for an example.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of this DOP relationship.\n\n\n \"\"\"\n def matches(self, pattern: str) -> bool:\n \"\"\"\n\n matches(self, pattern) -> bool\n\n Return whether or not this relationship's name matches a pattern.\n See hou.DopObject.matches for more information.\n\n\n \"\"\"\n def setGroup(self, objects: Sequence[DopObject]) -> None:\n \"\"\"\n\n setGroup(self, objects)\n\n Sets the list of objects that are being affected. This corresponds\n to the ObjInGroup record.\n\n objects: A list of DOP objects.\n\n Raises hou.PermissionError if called from outside a Python DOP.\n\n\n \"\"\"\n def setAffectorGroup(self, objects: Sequence[DopObject]) -> None:\n \"\"\"\n\n setAffectorGroup(self, objects)\n\n Sets the list of objects that are doing the affecting. This\n corresponds to the ObjInAffectors record.\n\n objects: A list of DOP objects.\n\n Raises hou.PermissionError if called from outside a Python DOP.\n\n\n \"\"\"\n def relationshipTypeData(self) -> Optional[DopData]:\n \"\"\"\n\n relationshipTypeData(self) -> hou.DopData or None\n\n Returns the subdata that defines the relationship type.\n\n\n \"\"\"\n\nclass DopSimulation:\n \"\"\"\n\n hou.DopSimulation\n\n A dynamics simulation contained inside a DOP network node.\n\n See hou.DopData for more information about the contents of a DOP\n simulation. Note that methods of this class implicitly use the\n simulation data from the current frame.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__()\n\n Creates a new simulation, which is not associated with a node. Use\n hou.DopNode.simulation to access a DOP network's simulation.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def createObject(self, name: str, solve_on_creation_frame: bool) -> Optional[DopData]:\n \"\"\"\n\n createObject(self, name, solve_on_creation_frame) -> hou.DopObject\n\n Create and return a new DOP object, or return None if the object was\n not created successfully.\n\n\n name\n The name of the new object.\n\n solve_on_creation_frame\n If True, the object will be solved on its first frame of\n existence.\n\n Raises hou.PermissionError if the simulation cannot be modified\n (e.g. called from outside a Python DOP).\n\n Use hou.DopData.copyContentsFrom to clone data from an existing\n object.\n\n\n \"\"\"\n def removeObject(self, obj: DopObject) -> None:\n \"\"\"\n\n removeObject(self, object)\n\n Remove the given DOP object from the simulation.\n\n\n object\n The hou.DopObject to remove.\n\n Raises hou.PermissionError if the simulation cannot be modified\n (e.g. called from outside a Python DOP).\n\n\n \"\"\"\n def createRelationship(self, name: str) -> Optional[DopData]:\n \"\"\"\n\n createRelationship(self, name) -> hou.DopRelationship\n\n Create and return a new DOP relationship, or return None if the\n relationship was not created successfully.\n\n\n name\n The name of the new relationship.\n\n Raises hou.PermissionError if the simulation cannot be modified\n (e.g. called from outside a Python DOP).\n\n Use hou.DopData.copyContentsFrom to clone data from an existing\n relationship, and use hou.DopRelationship.setGroup and\n hou.DopRelationship.setAffectorGroup to update the ObjInGroup and\n ObjInAffectors records.\n\n\n \"\"\"\n def removeRelationship(self, rel: DopRelationship) -> None:\n \"\"\"\n\n removeRelationship(self, rel)\n\n Remove the given DOP relationship from the simulation.\n\n\n rel\n The hou.DopRelationship to remove.\n\n Raises hou.PermissionError if the simulation cannot be modified\n (e.g. called from outside a Python DOP).\n\n\n \"\"\"\n def dopNetNode(self) -> Node:\n \"\"\"\n\n dopNetNode(self) -> hou.OpNode\n\n Return the DOP network node containing this simulation.\n\n\n \"\"\"\n def objects(self) -> Tuple[DopData, ...]:\n \"\"\"\n\n objects(self) -> tuple of hou.DopData\n\n Return a tuple of all the DOP objects in the simulation.\n\n You cannot index into this list using the object ID (see\n hou.DopObject.objid). To create a dictionary mapping object IDs to\n hou.DopObjects, do this:\n\n > id_dict = dict((obj.objid(), obj) for obj in simulation.objects())\n\n \"\"\"\n def relationships(self) -> Tuple[DopData, ...]:\n '''\n\n relationships(self) -> tuple of hou.DopRelationship\n\n Return a tuple of hou.DopRelationship objects for all the DOP\n relationships in the simulation.\n\n > # The following example assumes you have created two box objects and made\n > # them rigid bodies.\n > >>> simulation = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation()\n > >>> relationship = simulation.relationships()[1]\n > >>> affecting_objects = [\n > ... simulation.objects()[record.field(\\\\\"objid\\\\\")]\n > ... for record in relationship.records(\\\\\"ObjInAffectors\\\\\")]\n > >>> [obj.name() for obj in affecting_objects]\n > [\\'box_object1\\']\n > >>> affected_objects = [\n > ... simulation.objects()[record.field(\\\\\"objid\\\\\")]\n > ... for record in relationship.records(\\\\\"ObjInGroup\\\\\")]\n > >>> [obj.name() for obj in affected_objects]\n > [\\'box_object2\\']\n\n '''\n def findObject(self, obj_spec: str) -> Optional[DopData]:\n \"\"\"\n\n findObject(self, obj_spec) -> hou.DopObject or None\n\n Return the DOP object with the given name, or None if no object\n exists with that name. See also hou.DopSimulation.findData and\n hou.DopSimulation.objects.\n\n\n \"\"\"\n def findRelationship(self, rel_spec: str) -> Optional[DopData]:\n \"\"\"\n\n findRelationship(self, rel_spec) -> hou.DopRelationship\n\n Find a DOP relationship by name. Return None if no such relationship\n with that name exists. See also hou.DopSimulation.relationships.\n\n\n \"\"\"\n def findData(self, data_spec: str) -> Optional[DopData]:\n \"\"\"\n\n findData(self, data_spec) -> hou.DopData or None\n\n Return the DOP data with the given name. Note that the name may also\n be a slash-separated path to nested subdata.\n\n If the data path refers to a DOP object, this method returns a\n hou.DopObject instance. If it refers to a DOP relationship, it\n returns a hou.DopRelationship instance. Otherwise, it returns a\n hou.DopData instance.\n\n Note this method implicitly uses the simulation data from the\n current frame.\n\n See also hou.DopData.findSubData.\n\n\n \"\"\"\n def findAllObjects(self, obj_spec: str) -> Tuple[DopData, ...]:\n '''\n\n findAllObjects(self, obj_spec) -> tuple of hou.DopObject\n\n Given a pattern, return a tuple of DOP objects whose names match the\n pattern.\n\n > >>> simulation = hou.node(\\\\\"/obj/AutoDopNetwork\\\\\").simulation()\n > >>> [obj.name() for obj in simulation.findAllObjects(\\\\\"box_object?\\\\\")]\n > [\\'box_object1\\', \\'box_object2\\']\n > >>> [obj.name() for obj in simulation.findAllObjects(\\\\\"o* b*\\\\\")]\n > [\\'obj1\\', \\'obj2\\', \\'box_object1\\', \\'box_object2\\']\n\n '''\n def findAllRelationships(self, rel_spec: str) -> Tuple[DopData, ...]:\n \"\"\"\n\n findAllRelationships(self, rel_spec) -> tuple of hou.DopRelationship\n\n Return a tuple of hou.DopRelationship objects whose names match a\n pattern. See also hou.DopSimulation.relationships and\n hou.DopSimulation.findRelationship.\n\n\n \"\"\"\n def findAllData(self, data_spec: str) -> Tuple[DopData, ...]:\n \"\"\"\n\n findAllData(self, data_spec) -> tuple of hou.DopData\n\n Given a pattern, return a tuple of DOP data whose names match the\n pattern. See also hou.DopSimulation.findData.\n\n\n \"\"\"\n def time(self) -> float:\n \"\"\"\n\n time(self)\n\n Return the simulation's current time. This value is often the same\n as hou.time, unless it is called from a Python solver DOP or the\n Time Scale or Offset Time parameters of the DOP network have been\n changed from their default values.\n\n\n \"\"\"\n def setTime(self, t: float, resim_last_timestep: bool = False, force_reset_sim: bool = False, allow_simulation: bool = True) -> None:\n \"\"\"\n\n setTime(self, t, resim_last_timestep=False, force_reset_sim=False,\n allow_simulation=True)\n\n Sets the simulation's current time.\n\n\n resim_last_timestep\n Deletes the most recent simulation cache entry before setting\n the current time.\n\n force_reset_sim\n Resets the simulation before moving to the specified time.\n\n allow_simulation\n Specifies whether simulation is enabled when moving to the\n specified time.\n\n Raises hou.PermissionError if the simulation cannot be modified. If\n the simulation is owned by a DOP network, the simulation time should\n be changed through the playbar.\n\n\n \"\"\"\n def timestep(self) -> float:\n \"\"\"\n\n timestep(self)\n\n Returns the length of a simulation timestep.\n\n\n \"\"\"\n def setTimestep(self, t: float) -> None:\n \"\"\"\n\n setTimestep(self, t)\n\n Sets the length of a simulation timestep.\n\n Raises hou.PermissionError if the simulation cannot be modified. If\n the simulation is owned by a DOP network, the timestep should be set\n through the node's parameters.\n\n\n \"\"\"\n def memoryUsage(self) -> int:\n \"\"\"\n\n memoryUsage(self)\n\n Return the simulation's total memory usage.\n\n\n \"\"\"\n\nclass Drawable:\n \"\"\"\n\n hou.Drawable\n\n The base class for drawables.\n\n This class provides a common interface to all drawable classes.\n\n TIPS AND NOTES\n\n * Houdini supports various drawables such as hou.SimpleDrawable,\n hou.GeometryDrawable and hou.TextDrawable.\n\n * hou.SimpleDrawable and hou.GeometryDrawable represent extra geometry\n to draw in the viewer alongside user content (for example, as guide\n geometry).\n\n * hou.SimpleDrawable is the most basic Houdini drawable class, it is\n easy to use as you just need to attach a geometry, enable it and\n Houdini will take care of drawing the geometry.\n\n * hou.GeometryDrawable, hou.GadgetDrawable and\n hou.GeometryDrawableGroup also draw guide geometries but provide an\n API with advanced drawing capabilities.\n\n * hou.GadgetDrawable is similar to hou.GeometryDrawable but also\n allows you to identify located and picked geometries.\n\n * hou.TextDrawable draws text in the viewport.\n\n * hou.Drawable2D can draw shape entities in both compositing and scene\n viewers within a 2D context.\n\n * Drawables are mostly used with custom python states, you will\n generally store a reference to drawable objects on the state\n implementation object.\n\n * When you create a drawable object, it is hidden. You need to call\n show(True) for the attached element to appear. hou.SimpleDrawable\n requires an extra call to hou.SimpleDrawable.enable for the geometry\n to appear.\n\n * The drawable element will appear in the viewer until the drawable\n object is hidden or deleted. If there are no references to the\n object, Python will automatically delete it during garbage\n collection, and the attached element will disappear. So, you need to\n make sure to keep a live reference to the object as long as you want\n it to appear.\n\n RELATED\n\n * hou.AdvancedDrawable\n\n * hou.Drawable2D\n\n * hou.GadgetDrawable\n\n * hou.GeometryDrawable\n\n * hou.GeometryDrawableGroup\n\n * hou.SimpleDrawable\n\n * hou.TextDrawable\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def name(self) -> str:\n \"\"\"\n\n name(self)\n\n The name of this drawable.\n\n\n \"\"\"\n def label(self) -> str:\n \"\"\"\n\n label(self)\n\n The label of this drawable.\n\n\n \"\"\"\n def show(self, value: bool) -> None:\n \"\"\"\n\n show(self, value)\n\n Displays or hides the element attached to this drawable in the\n viewport. The element will appear the next time the viewer redraws.\n\n\n value\n True to show the element or False to hide it.\n\n\n \"\"\"\n def visible(self) -> bool:\n \"\"\"\n\n visible(self) -> bool\n\n Returns True if the drawable is visible or not.\n\n\n \"\"\"\n def transform(self) -> Matrix4:\n \"\"\"\n\n transform(self): -> hou.Matrix4\n\n Returns the transform matrix of the element attached to the\n drawable.\n\n\n \"\"\"\n def setTransform(self, xform: Matrix4) -> None:\n \"\"\"\n\n setTransform(self, xform)\n\n Sets the transform matrix of the element attached to this drawable.\n The changes will appear the next time the viewer redraws.\n\n\n xform\n A hou.Matrix4 transformation matrix to set the element's\n translation, rotation, and scale.\n\n\n \"\"\"\n def setLabel(self, label: str) -> None:\n \"\"\"\n\n setLabel(self, label)\n\n Set the label for this drawable.\n\n\n \"\"\"\n def setIsControl(self, is_control: bool) -> None:\n \"\"\"\n\n setIsControl(self, value)\n\n Flags the drawable as control geometry. Simple Drawables are not\n affected by certain shading modes nor will they have decorations or\n visualizers drawn for it. They will be hidden when the Node Guides\n display option is off.\n\n\n NOTE\n This method does not apply to hou.Drawable2D objects.\n\n\n \"\"\"\n def isControl(self) -> bool:\n \"\"\"\n\n isControl(self): -> bool\n\n Query if a drawable has been flaged as control geometry.\n\n\n \"\"\"\n\nclass Drawable2D(Drawable):\n \"\"\"\n\n hou.Drawable2D\n\n Drawable for drawing 2D entities.\n\n OVERVIEW\n\n The hou.Drawable2D API provides a unified solution for drawing shape\n entities in both compositing and scene viewers within a 2D context.\n It supports rendering of various geometric primitives, from simple\n lines to complex freeform shapes, as either wireframes or filled\n areas. Full picking and locating functionality is integrated across\n both viewer types.\n\n\n NOTE\n hou.Drawable2D shape entities are constrained to the XY plane\n (z=0) in Front and Perspective views. Primarily intended for COP\n Python states and handles, they can also be utilized in other\n contexts like SOPs and LOPs. A current limitation prevents the\n concurrent use of hou.Drawable2D and hou.GeometryDrawable.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, scene_viewer: SceneViewer|CompositorViewer, type: EnumValue, name: str, label: str|None = ..., pickable: bool = ..., params: dict[str, Any]|None = ...) -> None:\n \"\"\"\n\n __init__(self, scene_viewer, type, name, label=None, pickable=False,\n params=None)\n\n Creates a new drawable object of a specified type. The newly created\n drawable is initially hidden.\n\n\n WARNING\n hou.Drawable2D objects must be created within the onEnter event\n of a Python state or Python handle. Creating them outside of\n this context may lead to unexpected behavior or the drawable not\n functioning correctly.\n\n\n scene_viewer\n A reference to the viewer where the drawable will be displayed,\n either a hou.SceneViewer or hou.CompositorViewer.\n\n type\n A hou.drawable2DType value indicating the type of drawable to\n create (e.g., Arc, Line, Shape).\n\n name\n A string used to uniquely identify this drawable object.\n\n label\n An optional string to set a display label for the drawable.\n Defaults to an empty string.\n\n pickable\n A boolean value indicating whether the drawable can be picked\n and located. Set to False to disable interaction. Defaults to\n True.\n\n params\n An optional dictionary containing parameters to configure the\n drawable's appearance and behavior. See hou.Drawable2D.setParams\n for a detailed list of available parameters for each drawable\n type.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def setParams(self, params: dict[str, Any]) -> None:\n \"\"\"\n\n setParams(self, params)\n\n Sets the parameters of the drawable entity using a dictionary. The\n params dictionary can include attributes common to all drawable\n types (e.g., position, color) and those specific to the drawable's\n type (e.g., radius for an Arc, points for a Line or Shape).\n\n Common parameters available for each drawable type:\n\n color\n The main color of the drawable, as an RGB or RGBA value.\n\n Sequence of 3 or 4 ints or doubles, hou.Color. Defaults to\n hou.Color(1, 1, 1, 1).\n\n locate_color\n The locate color (or highlight) of the drawable, as an RGB or RGBA\n value.\n\n Sequence of 3 or 4 ints or doubles, hou.Color. Defaults to\n hou.Color(0, 0, 0, 0).\n\n Specific parameters for each drawable type:\n\n end_angle\n The ending angle of the arc in degrees.\n\n int or double. Defaults to 0.0\n\n end_cap\n The cap style at the end of the arc.\n\n hou.drawable2DCapStyle. Defaults to hou.drawable2DCapStyle.Butt.\n\n end_cap_color\n The end cap color, as an RGB or RGBA value.\n\n Array of 3 or 4 ints or doubles, hou.Color. Defaults to hou.Color(0,\n 0, 0, 1).\n\n fill\n Whether to fill the arc area.\n\n int or bool. Defaults to False.\n\n inner_radius\n The inner radius of the arc.\n\n int or double. Defaults to 0.\n\n position\n The position where the entity is placed in the viewer (XY plane).\n\n Array of 2 ints or doubles, hou.Vector2. Defaults to\n hou.Vector2(0,0).\n\n radius\n The radius of the arc.\n\n int or double. Defaults to 0.5.\n\n start_angle\n The starting angle of the arc in degrees.\n\n int or double. Defaults to 0.\n\n start_cap\n The cap style at the start of the arc.\n\n hou.drawable2DCapStyle. Defaults to hou.drawable2DCapStyle.Butt.\n\n start_cap_color\n The start cap color, as an RGB or RGBA value.\n\n Array of 3 or 4 ints or doubles, hou.Color. Defaults to hou.Color(0,\n 0, 0, 1).\n\n thickness\n The arc thickness value (1 to 5)\n\n int, double. Defaults to 2\n\n Circle\n Description\n Type\n fill\n Whether to fill the circle area.\n\n int or bool. Defaults to False.\n\n inner_radius\n The inner radius of the circle.\n\n int or double. Defaults to 0.\n\n position\n The position where the entity is placed in the viewer (XY plane).\n\n Array of 2 ints or doubles, hou.Vector2. Defaults to\n hou.Vector2(0,0).\n\n radius\n The radius of the circle.\n\n int or double. Defaults to 0.5.\n\n thickness\n The circle thickness value (1 to 5)\n\n int, double. Defaults to 2.\n\n Line\n Description\n Type\n end_cap\n The cap style at the end of the arc.\n\n hou.drawable2DCapStyle. Defaults to hou.drawable2DCapStyle.Butt.\n\n end_cap_color\n The end cap color, as an RGB or RGBA value.\n\n Array of 3 or 4 ints or doubles, hou.Color. Defaults to hou.Color(0,\n 0, 0, 1).\n\n points\n An array containing the points defining the line. The first two\n values describe the starting point (x0, y0), and the next two\n describe the ending point (x1, y1).\n\n Array of 4 ints or doubles. Defaults to [0, 0, 1, 0].\n\n start_cap\n The cap style at the start of the line.\n\n hou.drawable2DCapStyle. Defaults to hou.drawable2DCapStyle.Butt.\n\n start_cap_color\n The start cap color, as an RGB or RGBA value.\n\n Array of 3 or 4 ints or doubles, hou.Color. Defaults to hou.Color(0,\n 0, 0, 1).\n\n style\n The style of a line drawable.\n\n hou.drawable2DLineStyle. Defaults to hou.drawable2DLineStyle.Solid`.\n\n thickness\n The line thickness value (1 to 5)\n\n int, double. Defaults to 2.\n\n Marker\n Description\n Type\n position\n The position where the entity is placed in the viewer (XY plane).\n\n Array of 2 ints or doubles, hou.Vector2. Defaults to\n hou.Vector2(0,0).\n\n size\n Enumerator value to set the size of the marker.\n\n hou.drawable2DMarkerSize. Defaults to\n hou.drawable2DMarkerSize.Small.\n\n thickness\n The marker thickness value (1 to 5)\n\n int, double. Defaults to 2.\n\n style\n The style of marker.\n\n hou.drawable2DMarkerStyle. Defaults to\n hou.drawable2DMarkerStyle.Cross.\n\n Rect\n Description\n Type\n radius\n Corner radius parameter for rounded corners.\n\n int or double. Defaults to 0.\n\n fill\n Whether to fill the rectangle area.\n\n int or bool. Defaults to False.\n\n position\n The position where the entity is placed in the viewer (XY plane).\n\n Array of 2 ints or doubles, hou.Vector2. Defaults to\n hou.Vector2(0,0).\n\n size\n Sets the width and height of the rectangle. Pass a single value for\n a square.\n\n int, double, Array of 2 ints or doubles, hou.Vector2. Defaults to\n hou.Vector2(0.5,0.5).\n\n thickness\n The rectangle thickness value (1 to 5)\n\n int, double. Defaults to 2.\n\n Shape\n Description\n Type\n close\n If True, an extra vertex is automatically added to connect the last\n and first points, closing the shape.\n\n int or bool. Defaults to False.\n\n points\n\n The vertices describing the shape, defined as a flattened sequence\n of point coordinates (e.g., x0, y0, x1, y1, ...).\n\n thickness\n The shape thickness value (1 to 5)\n\n int, double. Defaults to 2.\n\n Text\n Description\n Type\n position\n The position where the entity is placed in the viewer (XY plane).\n\n Sequence of 2 ints or doubles, hou.Vector2. Defaults to\n hou.Vector2(0,0).\n\n size\n The text font size.\n\n int or double. Defaults to 11.\n\n text\n The text value.\n\n string\n\n\n \"\"\"\n def params(self) -> dict[str, Any]:\n \"\"\"\n\n params(self) -> dict[str, Any]\n\n Returns the parameter dictionary currently stored in a\n hou.Drawable2D object. See hou.Drawable2D.setParams for details on\n the dictionary's contents.\n\n\n \"\"\"\n def draw(self, handle: Handle, params: dict[str, Any]|None = ...) -> None:\n \"\"\"\n\n draw(self, handle, params=None)\n\n Draws the drawable in a viewport. This method is typically called\n during the Python state's onDraw or onDrawInterrupt event to render\n the drawable in the current viewport.\n\n\n handle\n An opaque identifier generated by Houdini for rendering the\n drawable. This handle value is provided to the Python state's\n onDraw callback and should be passed directly to this draw\n method of the drawable object.\n\n params\n An optional dictionary of parameters to override the drawable's\n current settings specifically for this draw call. These\n parameters are the same as those used by\n hou.Drawable2D.setParams.\n\n\n \"\"\"\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.drawable2DType\n\n Returns the type of this drawable.\n\n\n \"\"\"\n def setPickable(self, value: bool) -> None:\n \"\"\"\n\n setPickable(self, value)\n\n Sets whether this drawable can be picked and located by user\n interactions.\n\n\n value\n A boolean value. Set to True to enable picking and locating for\n this drawable. Set to False to disable interaction.\n\n\n \"\"\"\n def isPickable(self) -> bool:\n \"\"\"\n\n isPickable(self) -> bool\n\n Returns True if this drawable is currently enabled for picking and\n locating, False otherwise.\n\n\n \"\"\"\n def mapToModel(self, x: float, y: float, z: float = 0) -> Vector3:\n \"\"\"\n\n mapToModel(self, x, y, z=0) -> hou.Vector3\n\n Maps a screen-space mouse position (x, y, z) to a corresponding\n point in the drawable's local model space. This is particularly\n useful for positioning and interacting with 2D drawables within both\n 2D and 3D viewports.\n\n\n NOTE\n The z parameter is often 0 for interactions constrained to the\n 2D plane.\n\n Returns a hou.Vector3 representing the mapped point in the\n drawable's model space.\n\n\n x\n The mouse's X-coordinate in screen space.\n\n y\n The mouse's Y-coordinate in screen space.\n\n z\n The mouse's Z-coordinate in screen space (typically 0 for 2D\n drawables).\n\n\n \"\"\"\n\nclass AdvancedDrawable(Drawable):\n \"\"\"\n\n hou.AdvancedDrawable\n\n The base class for advanced drawables.\n\n This base class provides a common interface for drawables such as\n hou.GeometryDrawable and hou.TextDrawable. These are advanced drawables\n used by custom python states for drawing text and guide geometries in\n the viewport and, to convey visual information from the state to the\n user.\n\n RELATED\n\n * hou.GeometryDrawable\n\n * hou.GeometryDrawableGroup\n\n * hou.SimpleDrawable\n\n * hou.TextDrawable\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def setParams(self, params: Mapping[str, Any]|None = ...) -> None:\n \"\"\"\n\n setParams(self, params)\n\n Sets the parameters of the drawable. The settings will take effect\n in the viewport the next time hou.AdvancedDrawable.draw is called.\n\n\n params\n A dictionary of parameters for setting the drawable options.\n Each drawable type uses a specific set of parameters, detailed\n information can be found in the drawable derived class params\n documentation such as GeometryDrawable and TextDrawable.\n\n The following are parameters common to all hou.AdvancedDrawable\n types:\n\n color1\n hou.Vector4\n\n Vector representing an rgba value used as the main color of a\n drawable. This color is multiplied by the overlay stencil colors\n at the time of compositing. The default value is hou.Vector4(1,\n 1, 1, 1).\n\n For hou.TextDrawable, color1 is the default foreground color for\n drawing the text.\n\n color2\n hou.Vector4\n\n Vector representing an rgba value for setting the glow color\n around the drawable generated matte. Defaults to hou.Vector4(0,\n 0, 0, 0.25).\n\n For instance, color2 can be used for drawing a glow around the\n generated matte for a face or point drawable.\n\n fade_factor\n double\n\n Value used as the occlusion factor of the overlay in areas\n occluded by the existing geometry as determined by the depth\n buffer. A fade factor of 1.0 means no distinction must be made\n and a value of 0.0 completely hides occluded parts. Defaults to\n 0.\n\n glow_width\n int\n\n Sets the glow width value. For instance, this changes the glow\n width of line segments or text. Defaults to 0.\n\n highlight_mode\n hou.drawableHighlightMode\n\n Sets the mode for highlighting the generated matte of the\n drawable. Defaults to hou.drawableHighlightMode.Matte.\n\n translate\n hou.Vector3 or sequence of 3 doubles\n\n Position of the geometry in 3D space.\n\n For hou.TextDrawable, it's the position of the text to display\n in viewport coordinates.\n\n Defaults to hou.Vector3(0, 0, 0).\n\n rotation\n hou.Vector3 or sequence of 3 doubles\n\n Rotation vector in degrees. Defaults to hou.Vector3(0, 0, 0).\n\n scale\n hou.Vector3 or sequence of 3 doubles\n\n Scaling vector. Defaults to hou.Vector3(1, 1, 1).\n\n screen_space\n Sequence of doubles or ints\n\n Assigns a 2D window to the viewport, in viewport coordinates,\n for drawing a geometry. The sequence defines the location and\n size of the window, and must contain the following values:\n\n * X position (defaults to 0)\n\n * Y position (defaults to 0)\n\n * Width (defaults to 0)\n\n * Height (defaults to 0)\n\n * X margin (defaults to 0)\n\n * Y margin (defaults to 0)\n\n use_cd\n Bool\n\n Specifies if the drawable should use the Cd attribute of the\n attached geometry (if any). If an Alpha attribute exists, the\n drawable will use it as well. Defaults to True.\n\n use_uv\n Bool\n\n Specifies if the drawable should use the Uv attribute of the\n attached geometry (if any). Defaults to True.\n\n\n \"\"\"\n def draw(self, handle: Handle, params: Mapping[str, Any]|None = ...) -> None:\n \"\"\"\n\n draw(self, handle, params=None)\n\n Method implemented by leaf classes to support the drawing of\n elements in a viewport. This method should normally be called from\n the python state onDraw or onDrawInterrupt event to render the\n drawable in the current viewport.\n\n\n handle\n This is an opaque value created by Houdini to render the\n drawable. This handle value is passed to the python state onDraw\n callback by Houdini and should be passed directly to the\n drawable object's draw method.\n\n params\n An optional dictionary of parameters for setting the drawable\n parameters. These are the same parameters\n hou.AdvancedDrawable.setParams is using.\n\n\n \"\"\"\n\nclass SimpleDrawable(Drawable):\n '''\n\n hou.SimpleDrawable\n\n Represents extra geometry to draw in the viewer alongside user content\n (for example, as guide geometry).\n\n OVERVIEW\n\n You can attach geometry to a viewer in a Drawable object, causing\n the geometry to appear in the viewer even though the geometry is not\n actually part of the scene. This is useful to show guide geometry in\n a custom Python state.\n\n hou.SimpleDrawable basic support is ideal for simple guide\n geometries. For an advanced API for creating and drawing guide\n geometries, see hou.GeometryDrawable and hou.GeometryDrawableGroup.\n\n > import hou\n > # Create an empty geometry object\n > geo = hou.Geometry()\n > # Get the verb from the Box node\n > box_verb = hou.sopNodeTypeCategory().nodeVerb(\\\\\"box\\\\\")\n > # Set the verb\\'s parameters\n > box_verb.setParms({\n > \\\\\"t\\\\\": hou.Vector3(0.5, 0.5, -0.5),\n > \\\\\"scale\\\\\": 0.5,\n > })\n > # Execute the verb and put its output in the Geometry object\n > box_verb.execute(geo, [])\n > \n > # Grab a reference to the viewer\n > scene_viewer = hou.ui.paneTabOfType(hou.paneTabType.SceneViewer)\n > # Create a Drawable object\n > drawable = hou.SimpleDrawable(scene_viewer, geo, \\\\\"my_guide\\\\\")\n > # Set the Drawable display mode as wireframe (this is the default)\n > drawable.setDisplayMode(hou.drawableDisplayMode.WireframeMode)\n > # Enable and show the drawable geometry\n > drawable.enable(True)\n > drawable.show(True)\n > # Tumble the view to see the geometry\n > import hou\n > # Create a geometry from the Sphere node\n > sphere_verb = hou.sopNodeTypeCategory().nodeVerb(\\\\\"sphere\\\\\")\n > geo = hou.Geometry()\n > sphere_verb.execute(geo, [])\n > \n > # Add color and alpha attributes to the sphere\n > color_attrib = geo.addAttrib(hou.attribType.Prim, \\\\\"Cd\\\\\", (1.0, 1.0, 1.0))\n > alpha_attrib = geo.addAttrib(hou.attribType.Prim, \\\\\"Alpha\\\\\", 1.0)\n > \n > color = hou.Color(1.0, 0.0, 0.0)\n > for prim in geo.prims():\n > prim.setAttribValue(color_attrib, color.rgb())\n > prim.setAttribValue(alpha_attrib, 0.7)\n > \n > # Create a Drawable object\n > scene_viewer = hou.ui.paneTabOfType(hou.paneTabType.SceneViewer)\n > drawable = hou.SimpleDrawable(scene_viewer, geo, \\\\\"my_sphere\\\\\") \n > # Set the Drawable display mode with the current viewport shading mode\n > drawable.setDisplayMode(hou.drawableDisplayMode.CurrentViewportMode)\n > # Set the size of the sphere\n > drawable.setTransform(hou.hmath.buildScale(0.5, 0.5, 0.5))\n > drawable.enable(True)\n > drawable.show(True)\n\n TIPS AND NOTES\n\n * The SimpleDrawable object keeps a reference to the Geometry object\n you pass. You can change the Geometry object\\'s contents and the next\n time the viewer redraws it will draw the new contents.\n\n * When you create the SimpleDrawable object, it is disabled and\n hidden. You need to call enable(True) and then show(True) for the\n geometry to appear.\n\n * Even after they are activated and shown, SimpleDrawable geometry\n does not appear in the viewer until the next redraw (for example,\n when the user changes the view).\n\n You can force an individual viewport to redraw using\n hou.GeometryViewport.draw.\n\n > scene_viewer.curViewport().draw()\n\n * You can generate the contents of a Geometry object from scratch\n using verbs, or grab a copy of the output of a SOP node using\n hou.SopNode.geometry.\n\n * You can also use hou.drawablePrimitive to specify a built-in shape\n to generate the content of a SimpleDrawable object.\n\n * enabling/disabling a drawable may cause performances issues if\n performed too often, especially with large geometries. It\\'s good\n practice to use show instead of enable for hiding and showing a\n drawable.\n\n * It\\'s also good practice to disable drawables when they are not\n actively used in a viewer.\n\n * Add a Vertex or Point uv attribute to the hou.SimpleDrawable\n geometry to draw in the UV view:\n\n > sops = hou.sopNodeTypeCategory() \n > verb = sops.nodeVerb(\\\\\"sphere\\\\\")\n > verb.setParms(parms)\n > geo = hou.Geometry()\n > verb.execute(geo, [])\n > \n > # add uv vertex attribute to the drawable.\n > geo.addAttrib(hou.attribType.Vertex, \\\\\"uv\\\\\", (0,0)) \n > \n > # add color and alpha attributes\n > color_attrib = geo.addAttrib(hou.attribType.Prim, \\\\\"Cd\\\\\", (1.0, 1.0, 1.0))\n > for prim in geo.prims():\n > prim.setAttribValue(color_attrib, StrokeCursor.COLOR.rgb())\n > \n > # create a wireframe brush\n > brush = hou.SimpleDrawable(self.scene_viewer, geo, \\'%s_%s\\' % (self.state_name, \\\\\"sphere\\\\\"))\n > brush.setDisplayMode(hou.drawableDisplayMode.WireframeMode)\n\n RELATED\n\n * hou.TextDrawable\n\n * hou.GeometryDrawable\n\n * hou.GeometryDrawableGroup\n\n\n '''\n thisown: Incomplete\n def __init__(self, scene_viewer: SceneViewer, geometry: Geometry|EnumValue, name: str) -> None:\n '''\n\n __init__(self, scene_viewer, geometry, name)\n\n Creates a drawable object for drawing a geometry in a viewport. The\n new drawable is hidden and disabled by default.\n\n\n scene_viewer\n A hou.SceneViewer reference to the viewer the guide geometry\n will appear in.\n\n geometry\n Either a hou.Geometry object containing the geometry to draw, or\n a hou.drawablePrimitive value specifying a shape to draw.\n\n name\n A string to identify this drawable object. This should be unique\n across all drawables in the current session.\n\n In a custom state, you can base the SimpleDrawable\\'s name on the\n state name to try to ensure uniqueness. For example:\n\n > class MyState(object):\n > def __init__(self, state_name, scene_viewer):\n > self.state_name = state_name\n > self.scene_viewer = scene_viewer\n > \n > geo = hou.Geometry()\n > verb = hou.sopNodeTypeCategory().nodeVerb(\\\\\"box\\\\\")\n > verb.execute(geo, [])\n > self._box = hou.SimpleDrawable(\n > self.scene_viewer, geo,\n > # Use the state name as the basis for the drawable\\'s name\n > self.state_name + \\\\\"_box\\\\\"\n > )\n\n '''\n __swig_destroy__: Incomplete\n def enable(self, value: bool) -> None:\n \"\"\"\n\n enable(self,value)\n\n Enables or disables the drawing of the geometry. This method is\n typically called first for the show method to take effect.\n\n\n value\n True to enable or False to disable the drawing.\n\n\n \"\"\"\n def enabled(self) -> bool:\n \"\"\"\n\n enabled(self,value) -> bool\n\n Returns True if the drawable is enabled or not.\n\n\n \"\"\"\n def setDisplayMode(self, value: EnumValue) -> None:\n \"\"\"\n\n displayMode(self): -> hou.drawableDisplayMode\n\n Returns the display mode of the geometry.\n\n\n \"\"\"\n def displayMode(self) -> EnumValue: ...\n def setWireframeColor(self, color: Color) -> None:\n \"\"\"\n\n setWireframeColor(self, color)\n\n Updates the color of the geometry when the drawable display mode is\n set to hou.drawableDisplayMode.WireframeMode. The change will appear\n the next time the viewer redraws.\n\n\n color\n A hou.Color value to specify the primitive color.\n\n\n \"\"\"\n def wireframeColor(self) -> Color:\n \"\"\"\n\n wireframeColor(self) -> hou.Color\n\n Returns the current wireframe color.\n\n\n \"\"\"\n def setUseWireframeColor(self, value: bool) -> None:\n \"\"\"\n\n setUseWireframeColor(self, value)\n\n Turns on or off usage of the drawable's wireframe color. The default\n is True. The change will appear the next time the viewer redraws.\n\n\n value\n True to turn on or False to turn off wireframe color usage.\n\n\n \"\"\"\n def useWireframeColor(self) -> bool:\n \"\"\"\n\n useWireframeColor(self) -> bool\n\n Returns whether the current wireframe color is being used.\n\n\n \"\"\"\n def setXray(self, value: bool) -> None:\n \"\"\"\n\n setXray(self, value)\n\n Sets the xray rendering flag on the drawable.\n\n\n value\n True to enable or False to disable xray rendering.\n\n\n \"\"\"\n def isXray(self) -> bool:\n \"\"\"\n\n isXray(self): -> bool\n\n Returns True if the drawable will render with xray rendering.\n\n\n \"\"\"\n def setShowMaterials(self, value: bool) -> None:\n \"\"\"\n\n setShowMaterials(self, value)\n\n Enables or disables materials for the drawable. The drawable\n geometry must have a valid shop_materialpath attribute.\n\n\n value\n True to enable or False to disable materials.\n\n\n \"\"\"\n def isShowMaterials(self) -> bool:\n \"\"\"\n\n isShowMaterials(self): -> bool\n\n Returns True if the drawable is drawn with materials.\n\n\n \"\"\"\n def setCastShadows(self, value: bool) -> None:\n \"\"\"\n\n setCastShadows(self, value)\n\n Enables or disables the shadow casting flag for the drawable.\n\n\n value\n True to enable or False to disable shadow casting.\n\n\n \"\"\"\n def isCastShadows(self) -> bool:\n \"\"\"\n\n isCastShadows(self): -> bool\n\n Returns True if the drawable is set to cast shadows.\n\n\n \"\"\"\n def setDrawOutline(self, value: bool) -> None:\n \"\"\"\n\n setDrawOutline(self, value)\n\n Turns on or off the outline drawing flag for the drawable.\n\n\n value\n True to turn on or False to turn off outline drawing.\n\n\n \"\"\"\n def isDrawOutline(self) -> bool:\n \"\"\"\n\n isDrawOutline(self): -> bool\n\n Returns True if the drawable is set to have outlines.\n\n\n \"\"\"\n def setOutlineColor(self, color: Color|Vector4) -> None:\n \"\"\"\n\n setOutlineColor(self, color)\n\n Updates the color of the outline of the drawable. Outlines are only\n displayed if the flag on the drawable has been turned on.\n\n\n color\n A hou.Color value to specify the outline color in RGB (Alpha is\n set to 1), or a hou.Vector4 value to specify the outline color\n in RGBA.\n\n\n \"\"\"\n def outlineColor(self) -> Vector4:\n \"\"\"\n\n outlineColor(self) -> hou.Vector4\n\n Returns the outline color of the drawable in RGBA format.\n\n\n \"\"\"\n def setSeparateOutline(self, value: bool) -> None:\n \"\"\"\n\n setSeparateOutline(self, value)\n\n Turns on or off the separate outline drawing flag for the drawable.\n By default, when multiple outlined objects overlap, only the\n silhouette of their combination is outlined. Use this flag to\n outline each object separately. Note: Separate outlines are\n expensive and can impact performance.\n\n\n value\n True to turn on or False to turn off separate outline drawing.\n\n\n \"\"\"\n def isSeparateOutline(self) -> bool:\n \"\"\"\n\n isSeparateOutline(self): -> bool\n\n Returns True if the drawable is set to have separate outlines.\n\n\n \"\"\"\n def setOutlineOnly(self, value: bool) -> None:\n \"\"\"\n\n setOutlineOnly(self, value)\n\n Turns on or off the outline only flag on the drawable. When outline\n only is turned on, only the outline of the drawable is drawn, and\n the drawable itself is not drawn.\n\n\n value\n True to turn on or False to turn off outline only drawing.\n\n\n \"\"\"\n def isOutlineOnly(self) -> bool:\n \"\"\"\n\n isOutlineOnly(self): -> bool\n\n Returns True if the drawable is set to only have its outline drawn.\n\n\n \"\"\"\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self): -> hou.Geometry\n\n Returns the drawable's geometry object. The returned geometry is\n read-only.\n\n\n \"\"\"\n def setGeometry(self, geometry: Geometry) -> None:\n \"\"\"\n\n setGeometry(self, geometry)\n\n Sets the drawable with a new geometry. The changes will appear the\n next time the viewer redraws.\n\n\n geometry\n A hou.Geometry object.\n\n\n \"\"\"\n def setVisibleInViewport(self, viewport: GeometryViewport) -> None:\n \"\"\"\n\n setVisibleInViewport(self, viewport)\n\n Restricts the drawable to be only visible in viewport. The drawable\n can be made visible in more than one viewport by calling this once\n per viewport.\n\n\n \"\"\"\n def setVisibleInAllViewports(self) -> None:\n \"\"\"\n\n setVisibleInAllViewports(self)\n\n Remove all per-viewport visibility restrictions, so that the\n drawable is shown in all viewports.\n\n\n \"\"\"\n def isVisibleInViewport(self, viewport: GeometryViewport) -> bool:\n \"\"\"\n\n isVisibleInViewport(self, viewport) -> bool\n\n Query to see if this drawable is visible in viewport.\n\n\n \"\"\"\n\nclass Edge:\n \"\"\"\n\n hou.Edge\n\n Each Edge object resides inside a Geometry object and stores an edge.\n Edges are reprsented as pairs of points.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def geometry(self) -> Geometry: ...\n def points(self) -> Tuple[Point, ...]:\n \"\"\"\n\n points(self) -> tuple of hou.Point\n\n Return a tuple of the points that make up this edge.\n\n\n \"\"\"\n def edgeId(self) -> str:\n \"\"\"\n\n edgeId(self) -> str\n\n Return a string such as p8-9 that identifies the edge\n\n\n \"\"\"\n def length(self) -> float:\n \"\"\"\n\n length(self) -> float\n\n Returns the length of this edge\n\n\n \"\"\"\n def prims(self) -> Tuple[Prim, ...]:\n \"\"\"\n\n prims(self) -> tuple of hou.Prim\n\n Return a tuple of the prims that has this edge\n\n\n \"\"\"\n\nclass EdgeGroup:\n \"\"\"\n\n hou.EdgeGroup\n\n A named group of edges inside a Geometry object.\n\n Edge groups reside inside the geometry, and each edge group has a unique\n name.\n\n See hou.Edge for more information about edges. See also hou.PrimGroup,\n hou.PointGroup, and hou.VertexGroup.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self) -> hou.Geometry\n\n Return the geometry object containing this group.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self)\n\n Return the name of the group. Each edge group has a unique name.\n\n\n \"\"\"\n def iterEdges(self) -> _EdgeTupleGenerator:\n \"\"\"\n\n iterEdges(self) -> generator of hou.Edge\n\n Return a generator that iterates through all the contents of this\n group.\n\n Whereas hou.EdgeGroup.edges allocates and returns a tuple of all the\n edges in the group, this method returns a generator object that will\n yield hou.Edge objects on demand.\n\n\n \"\"\"\n def edges(self) -> Tuple[Edge, ...]:\n \"\"\"\n\n edges(self) -> tuple of hou.Edge\n\n Return the contents of this group.\n\n See also hou.EdgeGroup.iterEdges.\n\n\n \"\"\"\n def contains(self, edge: Edge) -> bool:\n \"\"\"\n\n contains(self, edge) -> bool\n\n Return whether or not an edge is in this group.\n\n Raises hou.OperationFailed if the edge belongs to a different\n geometry object than this group.\n\n\n \"\"\"\n def add(self, edge_or_list_or_edge_group: Edge|Sequence[Edge]|EdgeGroup) -> None:\n \"\"\"\n\n add(self, edge_or_list_or_edge_group)\n\n If given a hou.Edge or a list of hou.Edge's, add the edge(s) to the\n group. If given a hou.EdgeGroup, merge the contents of the other\n edge group with this group (the other group is unaffected). You\n would typically call this method from the code of a Python-defined\n SOP.\n\n It is ok to add edges to the group that were already in the group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Raises hou.OperationFailed if the edge or edge group belong to a\n different geometry object than this group.\n\n\n \"\"\"\n def remove(self, edge_or_list_or_edge_group: Edge|Sequence[Edge]|EdgeGroup) -> None:\n \"\"\"\n\n remove(self, edge_or_list_or_edge_group)\n\n If given a hou.Edge or a list of hou.Edge's, remove the edge(s) from\n the group. If given a hou.EdgeGroup, remove all edges in the other\n group from this group (the other group is unaffected). You would\n typically call this method from the code of a Python-defined SOP.\n\n It is not an error to try to remove an edge from the group that\n wasn't already in the group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Raises hou.OperationFailed if the edge belongs to a different\n geometry object than this group.\n\n\n \"\"\"\n def clear(self) -> None: ...\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Remove this group from the geometry. You would typically call this\n method from the code of a Python-defined SOP.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def edgeCount(self) -> int:\n \"\"\"\n\n edgeCount(self) -> int\n\n Returns the number of edges in this group.\n\n\n \"\"\"\n def dataId(self) -> AttribDataId:\n \"\"\"\n\n dataId(self)\n\n Returns the data id that represents the contents of this group.\n\n\n \"\"\"\n def incrementDataId(self) -> None:\n \"\"\"\n\n incrementDataId(self)\n\n Increment the data id to indicate that the contents of this group\n has changed.\n\n\n \"\"\"\n\nclass EditableDopGeometryGuard:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __enter__(self) -> Optional[Geometry]: ...\n def __exit__(self, type: Any, value: Any, traceback: Any) -> None: ...\n\nclass FlipbookSettings:\n \"\"\"\n\n hou.FlipbookSettings\n\n A collection of options for the viewport flipbook dialog.\n\n The viewport flipbook has a set of options beyond the Display Options\n provided by the viewport itself. This object contains all these\n settings.\n\n * Use hou.SceneViewer.flipbookSettings to get this object representing\n the current flipbook settings for the viewer. Changing the options\n on this object changes the settings for future interactive flipbooks\n generated from the viewer.\n\n * You can also pass the settings object directly to\n hou.SceneViewer.flipbook to generate a flipbook using the current\n settings.\n\n * To generate a flipbook using custom settings, first use\n hou.SceneViewer.flipbookSettings to get the current settings, and\n call hou.FlipbookSettings.stash to create a copy (so changing the\n options won't affect the viewer's interactive options). Then modify\n the settings and pass the object to hou.SceneViewer.flipbook.\n\n > # Copy the viewer's current flipbook settings\n > scene = hou.ui.paneTabOfType(hou.paneTabType.SceneViewer)\n > flipbook_options = scene.flipbookSettings().stash()\n > \n > # Change the settings however you need\n > # (for example, set the frame range and output filename)\n > frame = hou.frame()\n > flipbook_options.frameRange( (frame, frame) )\n > flipbook_options.outputToMPlay(True) # or: flipbook_options.output(filename)\n > \n > # Generate the flipbook using the modified settings\n > scene.flipbook(scene.curViewport(), flipbook_options)\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def stash(self) -> FlipbookSettings:\n \"\"\"\n\n stash(self) -> hou.FlipbookSettings\n\n Return a new copy of this FlipbookSettings object. Changes to this\n new object will not update the flipbook dialog, but can be passed to\n hou.SceneViewer.flipbook() as the settings to use.\n\n\n \"\"\"\n def copy(self, from_settings: FlipbookSettings) -> None:\n \"\"\"\n\n copy(self, from_settings)\n\n Copy all settings in from_settings into this object.\n\n\n \"\"\"\n def outputToMPlay(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n outputToMPlay(self) -> bool\n\n Query if images are being sent to an interactive MPlay sesion.\n\n\n \"\"\"\n def leaveFrameAtEnd(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n leaveFrameAtEnd(self) -> bool\n\n Query if the playbar frame is being left at the last frame (True) or\n restored to the previous frame (False).\n\n\n \"\"\"\n def output(self, value: str|None = ...) -> str|None:\n \"\"\"\n\n output(self) -> str\n\n The current output destination for flipbooking.\n\n\n \"\"\"\n def sessionLabel(self, value: str|None = ...) -> str|None:\n \"\"\"\n\n sessionLabel(self) -> str\n\n The current flipbook session label.\n\n\n \"\"\"\n def visibleObjects(self, value: str|None = ...) -> str|None:\n \"\"\"\n\n visibleObjects(self) -> str\n\n The current visibility list for objects to be rendered.\n\n\n \"\"\"\n def visibleTypes(self, value: EnumValue|None = ...) -> EnumValue|None:\n \"\"\"\n\n visibleTypes(self) -> hou.flipbookObjectType\n\n The current visible object types.\n\n\n \"\"\"\n def frameRange(self, value: Sequence[float]|None = ...) -> Tuple[float, float]|None:\n \"\"\"\n\n frameRange(self) -> tuple of double\n\n The current frame range of the flipbook, as a tuple of 2 ints\n (start, end).\n\n\n \"\"\"\n def frameIncrement(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n frameIncrement(self) -> double\n\n The current frame increment of the flipbook.\n\n\n \"\"\"\n def beautyPassOnly(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n beautyPassOnly(self) -> bool\n\n The current state of the beauty pass render flag.\n\n\n \"\"\"\n def renderAllViewports(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n renderAllViewports(self) -> bool\n\n Render all visible viewports (True), or only the currently selected\n one.\n\n\n \"\"\"\n def appendFramesToCurrent(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n appendFramesToCurrent(self) -> bool\n\n The current state of the flipbook append mode, either Append (True)\n or Overwrite (False).\n\n\n \"\"\"\n def scopeChannelKeyframesOnly(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n scopeChannelKeyframesOnly(self) -> bool\n\n The current state of scoped keyframe mode.\n\n\n \"\"\"\n def blockEditing(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n blockEditing(self) -> bool\n\n The current state of block editing mode.\n\n\n \"\"\"\n def initializeSimulations(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n initializeSimulations(self) -> bool\n\n The current state of simulation initialization. True indicates that\n simulations will be reset, and False indicates that any cached\n results will be used.\n\n\n \"\"\"\n def audioFilename(self, audio_file: str|None = ...) -> str|None:\n \"\"\"\n\n audioFilename(self, audio_file)\n\n The current audio file used by the flipbook.\n\n\n \"\"\"\n def audioFrameStart(self, audio_file: float|None = ...) -> float|None:\n \"\"\"\n\n audioFrameStart(self) -> double\n\n The frame where the audio will be playing audioTimeOffset seconds.\n\n\n \"\"\"\n def audioTimeOffset(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n audioTimeOffset(self) -> double\n\n The audio time that will be playing at audioFrameStart frames.\n\n\n \"\"\"\n def backgroundImage(self, value: str|None = ...) -> str|None:\n \"\"\"\n\n backgroundImage(self) -> str\n\n The pathname of the background image or images.\n\n\n \"\"\"\n def overrideGamma(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n overrideGamma(self) -> bool\n\n The current state of the gamma override.\n\n\n \"\"\"\n def gamma(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n gamma(self) -> double\n\n The current gamma value.\n\n\n \"\"\"\n def overrideLUT(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n overrideLUT(self) -> bool\n\n The current state of the LUT override.\n\n\n \"\"\"\n def LUT(self, value: str|None = ...) -> str|None:\n \"\"\"\n\n LUT(self) -> str\n\n The current LUT used for flipbooking.\n\n\n \"\"\"\n def setUseFrameTimeLimit(self, limit: bool) -> None:\n \"\"\"\n\n setUseFrameTimeLimit(self, limit)\n\n Enable the frame time limit for progressive renderers in LOPs.\n\n\n \"\"\"\n def useFrameTimeLimit(self) -> bool:\n \"\"\"\n\n useFrameTimeLimit(self) -> bool\n\n The frame time limit for progressive renderers in LOPs.\n\n\n \"\"\"\n def setFrameTimeLimit(self, t: float) -> None:\n \"\"\"\n\n setFrameTimeLimit(self, t)\n\n Set the frame time limit for progressive renderers in LOPs, in\n seconds. Once this is exceeeded the flipbook will advance to the\n next frame.\n\n\n \"\"\"\n def frameTimeLimit(self) -> float:\n \"\"\"\n\n frameTimeLimit(self) -> double\n\n The frame time limit for progressive renderers in LOPs, in seconds.\n Once this is exceeeded the flipbook will advance to the next frame.\n\n\n \"\"\"\n def setUseFrameProgressLimit(self, limit: bool) -> None:\n \"\"\"\n\n setUseFrameProgressLimit(self, limit)\n\n Enable the frame progress limit for progressive renderers in LOPs.\n\n\n \"\"\"\n def useFrameProgressLimit(self) -> bool:\n \"\"\"\n\n useFrameProgressLimit(self) -> bool\n\n The frame progress limit for progressive renderers in LOPs.\n\n\n \"\"\"\n def setFrameProgessLimit(self, t: float) -> None:\n \"\"\"\n\n setFrameProgessLimit(self, t)\n\n Specify the frame progress limit for progressive renderers in LOPs,\n in percent. Once this is exceeeded the flipbook will advance to the\n next frame.\n\n\n \"\"\"\n def frameProgressLimit(self) -> float:\n \"\"\"\n\n frameProgressLimit(self) -> double\n\n The frame progress limit for progressive renderers in LOPs, in\n percent. Once this is exceeeded the flipbook will advance to the\n next frame.\n\n\n \"\"\"\n def antialias(self, value: EnumValue|None = ...) -> EnumValue|None:\n \"\"\"\n\n antialias(self) -> hou.flipbookAntialias\n\n Query the current flipbook antialiasing setting:\n\n * hou.flipbookAntialias.UseViewportSetting: Use the current viewport\n setting.\n\n * hou.flipbookAntialias.Off: No antialiasing.\n\n * hou.flipbookAntialias.Fast: Minimal 2-sample antialiasing.\n\n * hou.flipbookAntialias.Good: 4-sample antialiasing.\n\n * hou.flipbookAntialias.HighQuality: 8-sample antialiasing.\n\n\n \"\"\"\n def useMotionBlur(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n useMotionBlur(self) -> bool\n\n Query if motion blur is enabled.\n\n\n \"\"\"\n def motionBlurSegments(self, value: int|None = ...) -> int|None:\n \"\"\"\n\n motionBlurSegments(self) -> int\n\n Query the number of subframes currently used for motion blur.\n\n\n \"\"\"\n def motionBlurFrameRange(self, value: EnumValue|None = ...) -> EnumValue|None:\n \"\"\"\n\n motionBlurFrameRange(self) -> hou.flipbookMotionBlurBias\n\n Query the subframe range for motion blur:\n\n * hou.flipbookMotionBlurBias.Centered: Subframe range is centered\n around the currently rendering frame.\n\n * hou.flipbookMotionBlurBias.Forward: Subframe range starts at the\n currently rendering frame.\n\n * hou.flipbookMotionBlurBias.Previous: Subframe range ends at the\n currently rendering frame.\n\n\n \"\"\"\n def shutterFromCamera(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n shutterFromCamera(self) -> bool\n\n Query if the shutter is sourced from the camera or the flipbook\n dialog.\n\n\n \"\"\"\n def shutter(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n shutter(self) -> double\n\n Query the current camera shutter for motion blur.\n\n\n \"\"\"\n def useDepthOfField(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n useDepthOfField(self) -> bool\n\n Obsolete. Use the DOF settings in hou.GeometryViewportSettings.\n\n\n \"\"\"\n def depthOfFieldFromCamera(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n depthOfFieldFromCamera(self) -> bool\n\n Obsolete. Use the DOF settings in hou.GeometryViewportSettings.\n\n\n \"\"\"\n def depthOfFieldQuality(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n depthOfFieldQuality(self) -> double\n\n Obsolete. Use the DOF settings in hou.GeometryViewportSettings.\n\n\n \"\"\"\n def focusDistance(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n focusDistance(self) -> double\n\n Obsolete. Uses the setting on the camera.\n\n\n \"\"\"\n def aperture(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n aperture(self) -> double\n\n Obsolete. Uses the setting on the camera.\n\n\n \"\"\"\n def fStop(self, value: float|None = ...) -> float|None:\n \"\"\"\n\n fStop(self) -> double\n\n Obsolete. Use the DOF settings in hou.GeometryViewportSettings.\n\n\n \"\"\"\n def outputZoom(self, value: int|None = ...) -> int|None:\n \"\"\"\n\n outputZoom(self) -> int\n\n Query the output zoom level. Valid settings are 100, 75, 50, and 25.\n\n\n \"\"\"\n def useResolution(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n useResolution(self) -> bool\n\n Query if the resolution is defined by the flipbook dialog (True) or\n by the current size of the viewport (False).\n\n\n \"\"\"\n def resolution(self, value: Tuple[int, int]|None = ...) -> Tuple[int, int]|None:\n \"\"\"\n\n resolution(self) -> tuple of int\n\n Returns a 2-tuple of ints representing the width and height of the\n flipbook dialog image output resolution. This is not used unless\n useResolution is enabled.\n\n\n \"\"\"\n def useSheetSize(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n useSheetSize(self) -> bool\n\n Query if the viewport captures will be arranged into a sheet (True)\n or each frame will produce a different flipbook image (False).\n\n\n \"\"\"\n def sheetSize(self, value: Sequence[int]|None = ...) -> Tuple[int, int]|None:\n \"\"\"\n\n sheetSize() -> tuple of int\n\n Returns a 2-tuple of ints representing the number of columns and\n rows of frames in each output image. This is not used unless\n useSheetSize is enabled.\n\n\n \"\"\"\n def cropOutMaskOverlay(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n cropOutMaskOverlay(self) -> bool\n\n Query if the resulting image will be cropped to the camera area.\n\n\n \"\"\"\n def fromAudioPanel(self, value: bool|None = ...) -> bool|None:\n \"\"\"\n\n fromAudioPanel(self) -> bool\n\n When enabled, the flipbook gets it's audio settings from the Audio\n Panel.\n\n\n \"\"\"\n\nclass FloatingPanel:\n \"\"\"\n\n hou.FloatingPanel\n\n A floating window that contains one or more panes.\n\n Much like a desktop, a floating panel contains panes. A floating panel\n may be attached to a desktop, in which case it is saved with the\n desktop, hidden when the desktop is closed, and shown when the desktop\n is opened. You can use floating panels to create desktops that span\n multiple monitors.\n\n When you create a new floating panel, for example, it contains a single\n pane, which in turn contains a single pane tab showing the network\n editor.\n\n Note that a floating panel may be locked to one particular pane tab.\n These stripped down panels do not display the interface for adding new\n pane tabs or splitting panes. In fact, these stripped down floating\n panels do not contain any panes at all, and hou.FloatingPanel.panes will\n return an empty tuple. You can create such a stripped down floating\n panel with hou.Desktop.createFloatingPaneTab.\n\n See hou.Desktop for more information about panes and pane tabs.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def panes(self) -> Tuple[Pane, ...]:\n \"\"\"\n\n panes(self) -> tuple of hou.Pane\n\n Return all the panes inside the panel. As mentioned in the\n documentation for this class, a floating panel may be stripped down\n and locked to one particular pane tab, and these stripped down\n floating panels do not contain any panes.\n\n\n \"\"\"\n def paneTabs(self) -> Tuple[PaneTab, ...]:\n \"\"\"\n\n paneTabs(self) -> tuple of hou.PaneTab\n\n Return all the pane tabs that are in this floating panel, regardless\n of which pane they are in.\n\n\n \"\"\"\n def paneTabOfType(self, type: EnumValue, index: int = 0) -> Optional[PaneTab]:\n \"\"\"\n\n paneTabOfType(self, type, index=0) -> hou.PaneTab or None\n\n Find and return the pane tab with the desired type or None if no\n such pane tab exists.\n\n\n type\n A hou.paneTabType enumerated variable.\n\n index\n If there are multiple tabs with the desired type, this parameter\n determines which one is returned. Use index=0 to return the\n first found tab, index=1 to return the second found tab, etc. By\n default, index is 0.\n\n\n \"\"\"\n def findPaneTab(self, name: str) -> Optional[PaneTab]:\n \"\"\"\n\n findPaneTab(self, name) -> hou.PaneTab or None\n\n Return the pane tab with the given name, or None if no such tab\n exists.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of the floating panel. The panel's name is displayed\n in its window's title.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Set this panel's name. Any characters in the name that are not\n letters, numbers, or underscores are replaced with underscores.\n\n Raises hou.OperationFailed if the name is an empty string.\n\n\n \"\"\"\n def containsPlaybar(self) -> bool:\n \"\"\"\n\n containsPlaybar(self) -> bool\n\n Return whether or not this panel contains Houdini's playbar.\n\n See also hou.FloatingPanel.setContainsPlaybar.\n\n\n \"\"\"\n def setContainsPlaybar(self, on: bool) -> None:\n \"\"\"\n\n setContainsPlaybar(self, on)\n\n If on is True, move Houdini's playbar to this panel. Otherwise, move\n it back to the main desktop window.\n\n See also hou.FloatingPanel.containsPlaybar.\n\n\n \"\"\"\n def containsShelf(self) -> bool:\n \"\"\"\n\n containsShelf(self) -> bool\n\n Return whether or not this panel contains Houdini's shelf.\n\n See also hou.FloatingPanel.setContainsShelf.\n\n\n \"\"\"\n def setContainsShelf(self, on: bool) -> None:\n \"\"\"\n\n setContainsShelf(self, on)\n\n If on is True, move Houdini's shelf to this panel. Otherwise, move\n it back to the main desktop window.\n\n See also hou.FloatingPanel.containsShelf.\n\n\n \"\"\"\n def containsStatusBar(self) -> bool:\n \"\"\"\n\n containsStatusBar(self) -> bool\n\n Return whether or not this panel contains Houdini's status bar (the\n bar at the bottom of the desktop for status messages).\n\n See also hou.FloatingPanel.setContainsStatusBar.\n\n\n \"\"\"\n def setContainsStatusBar(self, on: bool) -> None:\n \"\"\"\n\n setContainsStatusBar(self, on)\n\n If on is True, move Houdini's status bar to this panel. Otherwise,\n move it back to the main desktop window.\n\n See also hou.FloatingPanel.containsStatusBar.\n\n\n \"\"\"\n def containsMenuBar(self) -> bool:\n \"\"\"\n\n containsMenuBar(self) -> bool\n\n Return whether or not this panel contains Houdini's main menu bar.\n\n See also hou.FloatingPanel.setContainsMenuBar.\n\n\n \"\"\"\n def setContainsMenuBar(self, on: bool) -> None:\n \"\"\"\n\n setContainsMenuBar(self, on)\n\n If on is True, move Houdini's main menu bar to this panel.\n Otherwise, move it back to the main desktop window.\n\n See also hou.FloatingPanel.containsMenuBar.\n\n\n \"\"\"\n def isAttachedToDesktop(self) -> bool:\n \"\"\"\n\n isAttachedToDesktop(self) -> bool\n\n Return whether or not this panel is attached to the desktop. Panels\n attached to the desktop are saved with the desktop and are opened\n when the desktop is opened and closed when the desktop is closed.\n\n See also hou.FloatingPanel.attachToDesktop.\n\n\n \"\"\"\n def attachToDesktop(self, on: bool) -> None:\n \"\"\"\n\n attachToDesktop(self, on)\n\n Attach this panel to the desktop. See\n hou.FloatingPanel.isAttachedToDesktop for more information.\n\n\n \"\"\"\n def isFullscreen(self) -> bool:\n \"\"\"\n\n isFullscreen(self) -> bool\n\n Return whether or not this panel is in full screen mode.\n\n See also hou.FloatingPanel.setIsFullscreen.\n\n\n \"\"\"\n def setIsFullscreen(self, on: bool) -> None:\n \"\"\"\n\n setIsFullscreen(self, on)\n\n Set whether or not this panel is in full screen mode.\n\n See also hou.FloatingPanel.isFullscreen.\n\n\n \"\"\"\n def position(self) -> Vector2:\n \"\"\"\n\n position(self) -> hou.Vector2\n\n Return the desktop position (in pixels) of the floating panel\n window.\n\n\n \"\"\"\n def setPosition(self, position: Sequence[int]) -> None:\n \"\"\"\n\n setPosition(self, position)\n\n Move the floating panel window to the specified desktop position (in\n pixels).\n\n Raise TypeError if position does not contain exactly two values.\n\n\n \"\"\"\n def size(self) -> Vector2:\n \"\"\"\n\n size(self) -> hou.Vector2\n\n Return the floating panel window's size (in pixels).\n\n\n \"\"\"\n def setSize(self, size: Sequence[int]) -> None:\n \"\"\"\n\n setSize(self, size)\n\n Resize the floating panel window (in pixels).\n\n Raise TypeError if size does not contain exactly two values. Raise\n TypeError if size contains a value that is less than or equal to\n zero.\n\n\n \"\"\"\n def close(self) -> None:\n \"\"\"\n\n close(self)\n\n Close the floating panel's window, closing all the pane tabs inside\n it.\n\n\n \"\"\"\n\nclass FloatParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.FloatParmTemplate\n\n Describes a parameter tuple containing floating point values.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, num_components: int, default_value: Sequence[float] = ..., min: float = ..., max: float = ..., min_is_strict: bool = ..., max_is_strict: bool = ..., look: EnumValue = ..., naming_scheme: EnumValue = ..., disable_when: str|None = ..., is_hidden: bool = ..., is_label_hidden: bool = ..., join_with_next: bool = ..., help: str|None = ..., script_callback: str|None = ..., script_callback_language: EnumValue = ..., tags: Mapping[str, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[EnumValue] = ...) -> None:\n \"\"\"\n\n __init__(self, name, label, num_components, default_value=(), min=0.0,\n max=10.0, min_is_strict=False, max_is_strict=False,\n look=hou.parmLook.Regular, naming_scheme=hou.parmNamingScheme.XYZW,\n disable_when=None, is_hidden=False, is_label_hidden=False,\n join_with_next=False, help=None, script_callback=None,\n script_callback_language=hou.scriptLanguage.Hscript, tags={},\n default_expression=(), default_expression_language=())\n\n Construct a new FloatParmTemplate.\n\n\n name\n See hou.ParmTemplate.name for more information.\n\n label\n See hou.ParmTemplate.label for more information.\n\n num_components\n See hou.ParmTemplate.numComponents for more information.\n\n default_value\n See the defaultValue method for more information.\n\n min\n See the minValue method for more information.\n\n max\n See the maxValue method for more information.\n\n min_is_strict\n See the minIsStrict method for more information.\n\n max_is_strict\n See the maxIsStrict method for more information.\n\n look\n See hou.ParmTemplate.look for more information.\n\n naming_scheme\n See hou.ParmTemplate.namingScheme for more information.\n\n disable_when\n See hou.ParmTemplate.disableWhen for more information.\n\n is_hidden\n See hou.ParmTemplate.isHidden for more information.\n\n is_label_hidden\n See hou.ParmTemplate.isLabelHidden for more information.\n\n join_with_next\n See hou.ParmTemplate.joinsWithNext for more information.\n\n help\n See hou.ParmTemplate.help for more information.\n\n script_callback\n See hou.ParmTemplate.scriptCallback for more information.\n\n script_callback_language\n See hou.ParmTemplate.scriptCallbackLanguage for more\n information.\n\n tags\n See hou.ParmTemplate.tags for more information.\n\n default_expression\n See the defaultExpression method for more information.\n\n default_expression_language\n See the defaultExpressionLanguage method for more information.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def minValue(self) -> float:\n \"\"\"\n\n minValue(self) -> float\n\n Return the minimum value of the parameter.\n\n See also the minIsStrict method.\n\n\n \"\"\"\n def setMinValue(self, min_value: float) -> None:\n \"\"\"\n\n setMinValue(self, min_value)\n\n Set the minimum value of the parameter.\n\n See the minValue method for more information.\n\n\n \"\"\"\n def maxValue(self) -> float:\n \"\"\"\n\n maxValue(self) -> float\n\n Return the minimum value of the parameter.\n\n See also the minIsStrict method.\n\n\n \"\"\"\n def setMaxValue(self, max_value: float) -> None:\n \"\"\"\n\n setMaxValue(self, max_value)\n\n Set the maximum value of the parameter.\n\n See the maxValue method for more information.\n\n\n \"\"\"\n def minIsStrict(self) -> bool:\n \"\"\"\n\n minIsStrict(self) -> bool\n\n Return whether the minimum value is strictly enforced.\n\n If a minimum value is not strictly enforced, the slider will not let\n you change the value below the minimum, but you can set the value to\n be lower than the minimum by typing it in, changing it via\n hou.Parm.setValue, or using the ladder handle.\n\n If it is strictly enforced and you try to change it below the\n minimum value using any mechanism, Houdini will set it to the\n minimum value.\n\n See also the minValue method.\n\n\n \"\"\"\n def setMinIsStrict(self, on: bool) -> None:\n \"\"\"\n\n setMinIsStrict(self, on)\n\n Set whether the minimum value is strictly enforced.\n\n See the minIsStrict method for more information.\n\n\n \"\"\"\n def maxIsStrict(self) -> bool:\n \"\"\"\n\n maxIsStrict(self) -> bool\n\n Return whether the maximum value is strictly enforced.\n\n See the minIsStrict method for more information.\n\n\n \"\"\"\n def setMaxIsStrict(self, on: bool) -> None:\n \"\"\"\n\n setMaxIsStrict(self, on)\n\n Set whether the maximum value is strictly enforced.\n\n See the maxIsStrict method for more information.\n\n\n \"\"\"\n def defaultValue(self) -> Tuple[float, ...]:\n \"\"\"\n\n defaultValue(self) -> tuple of float\n\n Return the default value for new parameter instances.\n\n For example, suppose this parm template is named t, the naming\n scheme is XYZW, it has 3 components, and the default value is (1.0,\n 2.0, 3.0). The corresponding parm tuple instance on a node would be\n named t and would contain parameters tx, ty, and tz. When the node\n is created, tx would be 1.0, ty would be 2.0, and tz would be 3.0.\n\n\n \"\"\"\n def setDefaultValue(self, default_value: Sequence[float]) -> None:\n \"\"\"\n\n setDefaultValue(self, tuple_of_default_values)\n\n Set the default value for new parameter instances to a sequence of\n floats.\n\n See the defaultValue method for more information. Note that if the\n number of floats in the sequence is different from the number of\n components in the parm template, any extra values will be discarded\n and any missing values will become zeros.\n\n\n \"\"\"\n def defaultExpression(self) -> Tuple[str, ...]:\n \"\"\"\n\n defaultExpression(self) -> tuple of strings\n\n Return the default expression for new parameter instances.\n\n The default expression takes precedence over the default value. If a\n component has no default expression (i.e. an empty string), then the\n default value is used for new parameter instances.\n\n Note that the default expression language is needed to interpret the\n meaning of the default expression.\n\n For example, suppose this parm template is named t, the naming\n scheme is XYZW, it has 3 components, the default value is (1.0, 2.0,\n 3.0), the default expression is ($F, hou.frame(), ) and the default\n expression language is (hou.scriptLanguage.Hscript,\n hou.scriptLanguage.Python, hou.scriptLanguage.Hscript). Then the\n corresponding parm tuple instance on a node would be named t and\n would contain parameters tx, ty, tz. When the node is created, tx\n would have a default Hscript expression of $F, ty would have a\n default Python expression of hou.frame(), and tz would have a\n default value of 3.0.\n\n\n \"\"\"\n def setDefaultExpression(self, default_expression: Sequence[str]) -> None:\n \"\"\"\n\n setDefaultExpression(self, tuple_of_default_expressions)\n\n Set the default expression for new parameter instances to a sequence\n of strings.\n\n See the hou.FloatParmTemplate.defaultExpression method for more\n information. Note that if the number of strings in the sequence is\n different from the number of components in the parm template, any\n extra values will be discarded and any missing expressions will\n become the empty string.\n\n\n \"\"\"\n def defaultExpressionLanguage(self) -> Tuple[EnumValue, ...]:\n \"\"\"\n\n defaultExpressionLanguage(self) -> tuple of hou.scriptLanguage\n\n Return the default expression language for new parameter instances.\n\n The default expression language only applies if the default\n expression is set. If the default expression of a component is not\n set, then the expression language is set to\n hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n def setDefaultExpressionLanguage(self, default_expression_language: Sequence[EnumValue]) -> None:\n \"\"\"\n\n setDefaultExpressionLanguage(self,\n tuple_of_default_expression_languages)\n\n Set the default expression language for new parameter instances to a\n sequence of hou.scriptLanguage values.\n\n See the defaultExpressionLanguage method for more information. Note\n that if the number of hou.scriptLanguage values in the sequence is\n different from the number of components in the parm template, any\n extra values will be discarded and any missing expression languages\n will become hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n\nclass FolderParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.FolderParmTemplate\n\n Describes a folder in a parameter dialog.\n\n Unlike all other hou.ParmTemplate subclasses, a folder does not\n correspond to an individual hou.ParmTuple. Instead, the set of adjacent\n folders form a folder set, and there is one parameter for this set that\n controls which folder is currently visible. These folder sets correspond\n to hou.FolderSetParmTemplate objects.\n\n Folder parm template objects are useful when manipulating the parameter\n interface of a node or a digital asset definition. Unlike folder set\n parm templates, they contain the parm templates inside the folder. They\n also let you add, remove, or hide an individual folder or move it from\n set one to another using hou.ParmTemplateGroup objects. Doing these\n individual folder-level operations is not possible with folder set parm\n templates.\n\n Note that folder parm templates are also used to represent multiparm\n blocks, much like the dialog does. The folder parm\n template's hou.folderType determines whether it is a folder or a\n multiparm block. Unlike folder parm templates, which do not correspond\n directly to parameter instances, a multiparm parm template does\n correspond to an integer parameter that controls the number of instances\n of the multiparm.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, parm_templates: Sequence[ParmTemplate] = ..., folder_type: EnumValue = ..., is_hidden: bool = ..., ends_tab_group: bool = ..., tags: Mapping[str, str] = ..., conditionals: Mapping[EnumValue, str] = ..., tab_conditionals: Mapping[EnumValue, str] = ...) -> None:\n \"\"\"\n\n __init__(name, label, parm_templates=(),\n folder_type=hou.folderType.Tabs, is_hidden=False, ends_tab_group=False,\n tags={}, conditionals={}, tab_conditionals={})\n\n Create a new folder parm template.\n\n\n name\n The internal name of the parm template. Normally, parm template\n names correspond directly to parm tuples on nodes. However,\n because folder sets, not folders, correspond directly to parm\n tuples, the name used for the folder set parm tuple is the name\n of the first folder parm template in the set of adjacent folder\n parm templates.\n\n label\n The name of the folder that is displayed in the parameter\n dialog.\n\n parm_templates\n A sequence of hou.ParmTemplate subclass objects for the\n parameters inside the folder. Folders may be nested in other\n folders by putting FolderParmTemplates in this sequence.\n\n folder_type\n A hou.folderType enumerated value controlling whether the\n parameter is a folder or a multiparm block. This value controls\n the look of the folder/multiparm instance.\n\n is_hidden\n Whether or not this folder is hidden.\n\n ends_tab_group\n If True, this folder will be the last in the folder set, even if\n the next parameter is also a folder. In that case, the next\n parameter will begin a new folder set.\n\n tags\n A dictionary of extra information attached to the parm template.\n\n conditionals\n A dictionary that specifies conditionals (i.e. disable when,\n hide when) on the parameter template. For folder tab parameters\n these conditionals affect the entire folder set.\n\n The dictionary maps hou.parmCondType types to conditional\n strings.\n\n See the Conditionals section of the help for more information on conditional strings.\n\n tab_conditionals\n A dictionary that specifies conditionals (i.e. disable when,\n hide when) on the parameter template. These conditionals affect\n only the folder tab generated by this parameter template and not\n the entire folder set.\n\n The dictionary maps hou.parmCondType types to conditional\n strings.\n\n See the Conditionals section of the help for more information on conditional strings.\n\n hou.OperationFailed is raised if tab conditionals are specified\n for multi-parameter templates or import blocks.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def folderStyle(self) -> EnumValue: ...\n def folderType(self) -> EnumValue:\n \"\"\"\n\n folderType(self) -> hou.folderType enum value\n\n Return the type of folder. Note that the folder may actually be a\n multiparm block.\n\n\n \"\"\"\n def setFolderType(self, folder_type: EnumValue) -> None:\n \"\"\"\n\n setFolderType(self, folder_type)\n\n Set the type of folder to a hou.folderType enum value.\n\n\n \"\"\"\n def isActualFolder(self) -> bool:\n \"\"\"\n\n isActualFolder(self) -> bool\n\n Return whether or not this parm template corresponds to an actual\n folder, as opposed to a multiparm or import block.\n\n This method can be implemented as follows:\n\n > def isActualFolder(self):\n > return self.folderType() in (\n > hou.folderType.Tabs, hou.folderType.RadioButtons)\n\n \"\"\"\n def defaultValue(self) -> int:\n \"\"\"\n\n defaultValue(self) -> int\n\n Return the integer default value.\n\n The default value is only used for folders that are multiparm\n blocks, and controls the default number of multiparm instances in\n newly created nodes.\n\n\n \"\"\"\n def setDefaultValue(self, default_value: int) -> None:\n \"\"\"\n\n setDefaultValue(self, tuple_of_default_values)\n\n Set the default value to an integer.\n\n The default value is only used for folders that are multiparm\n blocks. See the defaultValue method for more information.\n\n\n \"\"\"\n def tabConditionals(self) -> Optional[dict[EnumValue, str]]:\n \"\"\"\n\n tabConditionals(self) -> dict of [Hom:hou.parmCondType] enum value to\n string\n\n Returns the set of conditionals that affect the folder tab generated\n by this parameter template. The conditionals correspond to the Tab\n disable when and Tab hide when properties that appear Edit Parameter\n Interface window for folder parameters.\n\n See the Conditionals section of the help for more information on conditional strings.\n\n This method returns an empty dictionary if this parameter template\n is for a multi-parameter or import block.\n\n\n \"\"\"\n def setTabConditional(self, cond_type: EnumValue, conditional: str) -> None:\n \"\"\"\n\n setTabConditional(self, type, conditional)\n\n Set a conditional string of the given hou.parmCondType type that\n affects the folder tab generated by this parameter template. The\n string consists of rules on how this parameter's folder tab's\n display behaves when other parameters change.\n\n See the Conditionals section of the help for more information on conditional strings.\n\n Raises hou.OperationFailed if this parameter template is for a\n multi-parameter or import block.\n\n\n \"\"\"\n def endsTabGroup(self) -> bool:\n \"\"\"\n\n endsTabGroup(self) -> bool\n\n Return whether this folder will be the last in the folder set, even\n if the next parameter is also a folder. In that case, the next\n parameter will begin a new folder set.\n\n This parameter only has meaning if the parm template is for an\n actual folder and not for a multiparm block.\n\n\n \"\"\"\n def setEndsTabGroup(self, on: bool) -> None:\n \"\"\"\n\n setEndsTabGroup(self, on)\n\n Set the flag to indicate whether or not the folder tab is the last\n one in the folder set. If the flag is set to True and the next\n parameter is also a folder, then that next folder will begin a new\n folder set.\n\n This parameter only has meaning if the parm template is for an\n actual folder and not for a multiparm block.\n\n\n \"\"\"\n def parmTemplates(self) -> Tuple[ParmTemplate, ...]:\n \"\"\"\n\n parmTemplates(self) -> tuple of hou.ParmTemplate\n\n Return a tuple of copies of the parm templates stored inside this\n folder.\n\n Because copies are returned, you cannot change the contents of the\n parm templates inside this folder by modifying the parm templates\n returned. Instead, use methods in hou.ParmTemplateGroup to modify\n parm templates in this folder.\n\n\n \"\"\"\n def setParmTemplates(self, parm_templates: Sequence[ParmTemplate]) -> None:\n \"\"\"\n\n setParmTemplates(self, parm_templates)\n\n Replace the parm templates inside this folder with a new sequence of\n parm templates.\n\n\n \"\"\"\n def addParmTemplate(self, parm_template: ParmTemplate) -> None:\n \"\"\"\n\n addParmTemplate(self, parm_template)\n\n Append a parm template to the end of the list of parm templates\n inside the folder.\n\n Note that hou.ParmTemplateGroup provides a number of methods to\n insert parm templates inside folders, including\n hou.ParmTemplateGroup.appendToFolder.\n\n\n \"\"\"\n\nclass FolderSetParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.FolderSetParmTemplate\n\n Describes a set of folders.\n\n A folder set is a group of adjacent folders, and only one of those\n folders can be displayed at a time. A folder set corresponds to one\n parameter, and the value of that parameter determines which folder is\n displayed.\n\n Note that there is also a hou.FolderParmTemplate class. Folder sets are\n used when there is a mapping to a parameter; for example, asking a\n hou.ParmTuple for its parm template may return a folder set, but it will\n never return a folder. Folder parm templates are used by\n hou.ParmTemplateGroup because they easily let you add, remove, and move\n individual folders, and they let you easily place parameters inside\n folders. Attempting to place folder set parm templates in\n hou.ParmTemplateGroup objects will raise hou.OperationFailed.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, folder_names: Sequence[str], folder_type: EnumValue, tags: Mapping[str, str] = ...) -> None:\n \"\"\"\n\n hou.FolderSetParmTemplate\n\n Describes a set of folders.\n\n A folder set is a group of adjacent folders, and only one of those\n folders can be displayed at a time. A folder set corresponds to one\n parameter, and the value of that parameter determines which folder is\n displayed.\n\n Note that there is also a hou.FolderParmTemplate class. Folder sets are\n used when there is a mapping to a parameter; for example, asking a\n hou.ParmTuple for its parm template may return a folder set, but it will\n never return a folder. Folder parm templates are used by\n hou.ParmTemplateGroup because they easily let you add, remove, and move\n individual folders, and they let you easily place parameters inside\n folders. Attempting to place folder set parm templates in\n hou.ParmTemplateGroup objects will raise hou.OperationFailed.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def folderNames(self) -> list[str]:\n \"\"\"\n\n setFolderNames(self, folder_names)\n\n Set the names of the folders in this set to the given sequence of\n strings.\n\n See the folderNames method for more information.\n\n Raises hou.OperationFailed if folder_names is an empty sequence.\n\n\n \"\"\"\n def setFolderNames(self, folder_names: Sequence[str]) -> None: ...\n def folderType(self) -> EnumValue:\n \"\"\"\n\n folderType(self) -> hou.folderType enum value\n\n Return the type of folder.\n\n\n \"\"\"\n def setFolderType(self, folder_type: EnumValue) -> None:\n \"\"\"\n\n setFolderType(self, folder_type)\n\n Set the type of folder to a hou.folderType enum value.\n\n Raises TypeError if the folder type is for a multiparm or import\n block.\n\n\n \"\"\"\n def folderStyle(self) -> EnumValue:\n \"\"\"\n\n folderStyle(self) -> hou.folderType enum value\n\n This method is deprecated. It is an alias for the folderType method.\n\n\n \"\"\"\n\nclass GadgetContext:\n \"\"\"\n\n hou.GadgetContext\n\n The base class for a viewer resource gadget context.\n\n OVERVIEW\n\n hou.GadgetContext provides a common interface to viewer resources\n such as Python viewer handles and Python viewer states. It holds\n relevant information about a gadget drawable or 2D drawable that is\n bound to the viewer resource currently active in a viewport. The\n term drawable is used interchangeably to refer to either a\n hou.GadgetDrawable or a hou.Drawable2D.\n\n RELATED\n\n hou.ViewerStateContext hou.ViewerHandleContext\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def gadget(self) -> str:\n \"\"\"\n\n gadget(self) -> string\n\n Similar to name().\n\n\n \"\"\"\n def gadgetLabel(self) -> str:\n \"\"\"\n\n gadgetLabel(self) -> string\n\n Similar to label().\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> string\n\n Returns the name of the active drawable. A drawable is active when\n it is picked or when the mouse moves over its visuals (located).\n\n\n \"\"\"\n def label(self) -> str:\n \"\"\"\n\n label(self) -> string\n\n The active drawable label name.\n\n\n \"\"\"\n def component1(self) -> int:\n \"\"\"\n\n component1(self) -> int\n\n A component id of the active gadget geometry. The id refers to\n either a polygon, a polygon vertex or the start point of a line\n geometry. Returns -1 if no gadget is active.\n\n\n NOTE\n This method does not apply to hou.Drawable2D objects.\n\n\n \"\"\"\n def component2(self) -> int:\n \"\"\"\n\n component2(self) -> int\n\n A component id of the active gadget geometry. The returned id\n typically identifies the end point of a line geometry. Returns -1 if\n no line geometry is picked or located, or no gadget is active.\n\n\n NOTE\n This method does not apply to hou.Drawable2D objects.\n\n\n \"\"\"\n def isLocating(self) -> bool:\n \"\"\"\n\n isLocating(self) -> bool\n\n Returns True if any drawable is being located.\n\n\n \"\"\"\n def isPicking(self) -> bool:\n \"\"\"\n\n isPicking(self) -> bool\n\n Returns True if any drawable is being picked.\n\n\n \"\"\"\n def isDrawing(self) -> bool:\n \"\"\"\n\n isDrawing(self) -> bool\n\n Returns True if the handle is in a drawing state which means no\n drawable is being picked or located.\n\n\n \"\"\"\n def isLocated(self, gadget_name: str) -> bool:\n \"\"\"\n\n isLocated(drawable_name) -> bool\n\n Returns True if a given drawable is located.\n\n\n drawable_name\n Name of the drawable to test.\n\n\n \"\"\"\n def isPicked(self, gadget_name: str) -> bool:\n \"\"\"\n\n isPicked(drawable_name) -> bool\n\n Returns True if a given drawable is picked.\n\n\n drawable_name\n Name of the drawable to test.\n\n\n \"\"\"\n\nclass galleries:\n \"\"\"\n\n hou.galleries\n\n A module for managing galleries and their entries.\n\n This module provides a few basic functions for accessing and managing\n hou.Gallery and hou.GalleryEntry.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def galleries() -> Tuple[Gallery, ...]:\n \"\"\"\n\n galleries() -> tuple of hou.Gallery\n\n Return a tuple containing all the galleries currently installed in\n the Houdini session.\n\n\n \"\"\"\n @staticmethod\n def galleryEntries(name_pattern: Optional[str] = None, label_pattern: Optional[str] = None, keyword_pattern: Optional[str] = None, category: Optional[str] = None, node_type: Optional[NodeType] = None) -> Tuple[GalleryEntry, ...]:\n '''\n\n galleryEntries(name_pattern=None, label_pattern=None,\n keyword_pattern=None, category=None, node_type=None) -> tuple of\n hou.GalleryEntry\n\n Return a tuple of hou.GalleryEntry objects matching the search\n criteria. The result is the intersection of the matches against all\n the parameters. If you call this function with no parameters, it\n returns all the gallery entries. See also\n hou.Gallery.galleryEntries.\n\n Unless a parameter is None, the results are filtered by the\n following:\n\n\n name_pattern\n gallery entry names matching this pattern\n\n label_pattern\n gallery entry label names matching this pattern\n\n keyword_pattern\n gallery entries that have a keyword matching this pattern\n\n category\n gallery entries in a category matching this pattern\n\n node_type\n gallery entries that can be applied to this node type\n\n This example prints all the gallery entries starting with a b that\n have the Material keyword.\n\n > >>> hou.galleries.galleryEntries(\\\\\"b*\\\\\", keyword_pattern=\\\\\"Material\\\\\")\n > (, , ...)\n\n This example prints the name and description of all the entries in\n the Metals category:\n\n > >>> for entry in hou.galleries.galleryEntries(category=\\\\\"Metals\\\\\"):\n > ... print \\\\\"%s: %s\\\\\" % (entry.name(), entry.description())\n > chrome: Very bright metal with mirror reflections\n > aged_metal: Aged metal material with ray traced or environment mapped reflections\n > ...\n\n This example prints the gallery entry names for the Lsystem SOP.\n\n > >>> node_type = hou.nodeType(hou.sopNodeTypeCategory(), \\\\\"lsystem\\\\\")\n > >>> for entry in hou.galleries.galleryEntries(node_type=node_type):\n > ... print entry.name()\n > planta\n > plantb\n > plantc\n > ...\n > sympodial_tree\n > ternary_tree\n > wheel\n\n '''\n @staticmethod\n def installGallery(gallery_path: str) -> Optional[Gallery]:\n \"\"\"\n\n installGallery(gallery_path) -> hou.Gallery or None\n\n Load a gallery into the current Houdini session.\n\n\n gallery_path\n The file path of the gallery to be installed.\n\n\n \"\"\"\n @staticmethod\n def removeGallery(gallery_path: str) -> bool:\n \"\"\"\n\n removeGallery(gallery_path) -> bool\n\n Remove a gallery from the current Houdini session. Returns False if\n the specified gallery file was not installed.\n\n\n gallery_path\n The file path of the gallery to be removed.\n\n\n \"\"\"\n @staticmethod\n def createGalleryEntry(gallery_path: str, entry_name: str, node: Optional[Node] = None) -> GalleryEntry:\n \"\"\"\n\n createGalleryEntry(gallery_path, entry_name, node) -> hou.GalleryEntry\n or None\n\n Create and return a new gallery entry.\n\n\n gallery_path\n The path of the gallery file in which the new element should be\n stored.\n\n entry_name\n The name of the new gallery entry.\n\n node\n The operator node from which the new gallery entry should copy\n the settings. The settings include parameter values, channels,\n spare parameters etc, and also the children nodes if the node is\n a subnetwork.\n\n\n \"\"\"\n\nclass Gallery:\n \"\"\"\n\n hou.Gallery\n\n A collection of gallery entries that can be applied to operator nodes to\n set their parameters to predefined values.\n\n In Houdini, a gallery is a collection of node templates and their\n parameter presets, which are represented by a hou.GalleryEntry. A\n gallery corresponds to a file where such templates are saved. Galleries\n can be managed with a hou.galleries module.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def galleryEntries(self, name_pattern: Optional[str] = None, label_pattern: Optional[str] = None, keyword_pattern: Optional[str] = None, category: Optional[str] = None, node_type: Optional[NodeType] = None) -> Tuple[GalleryEntry, ...]:\n \"\"\"\n\n galleryEntries(self, name_pattern=None, label_pattern=None,\n keyword_pattern=None, category=None, node_type=None) -> tuple of\n hou.GalleryEntry\n\n Return a tuple of entries that are stored in the gallery. See also\n hou.galleries.galleryEntries.\n\n\n name_pattern\n A pattern that the gallery entry name must match to be included\n in the returned tuple. The pattern can contain '?' to match a\n single character, '*' to match any number of characters, and ''\n to match any character in the set. If None, all gallery entries\n are considered to match it.\n\n label_pattern\n A pattern that the gallery entry label must match to be included\n in the returned tuple. See the name_pattern above for special\n characters in the pattern. If None, all gallery entries are\n considered to match it.\n\n keyword_pattern\n A pattern that any of the gallery entry keywords needs to match\n for the entry to be included in the returned tuple. See the\n name_pattern above for special characters in the pattern. If\n None, all gallery entries are considered to match it.\n\n category\n If not None, only gallery entries in the specified category will\n be included in the returned tuple.\n\n node_type\n If not None, only gallery entries for a given node type will be\n included in the returned tuple.\n\n\n \"\"\"\n def createEntry(self, entry_name: str, node: Optional[Node] = None) -> GalleryEntry: ...\n def deleteEntry(self, entry_name: str) -> None: ...\n\nclass GalleryEntry:\n '''\n\n hou.GalleryEntry\n\n A gallery entry that can be applied to operator nodes to set their\n parameters to predefined values.\n\n A gallery entry is an entity containing data about an operator node\n setup. It has information about the node\\'s parameter values, any\n additional spare parameters, channels, and for subnet nodes the\n information about the children, etc. Thus, a gallery entry is like a\n node template or a parameter preset. Such templates can be created from\n and applied to existing nodes.\n\n A gallery entry is identified by a unique, and has a non-unique label,\n and is usually associated with a specific hou.NodeType (or several node\n types) of the nodes to which it applies. In addition to the node\n information, gallery entries can have own categories that organize them\n into manageable sets and also can have keywords that identify their\n purpose. For more information about gallery entries, please see a\n gallery entry editor.\n\n In order for your gallery entries to appear in the Material Palette\n pane, they must satisfy two conditions. First, the node category must be\n set to indicate the gallery entry creates a SHOP node. Use code like:\n\n > hou.galleries.galleryEntries(\\\\\"entry_name\\\\\")[0].setNodeTypeCategory(hou.shopNodeTypeCategory())\n\n The second condition is that the entry must contain one or more keywords\n that indicate what renderer the SHOP works with. This affects whether\n the gallery entry appears when a specific renderer is chosen in the\n Material Palette renderer menu. Even if All is chosen in that menu, the\n gallery entry must contain a keyword that matches one of the renderers\n that appears in that menu. To associate a gallery entry with the Mantra\n renderer, do the following:\n\n > hou.galleries.galleryEntries(\\\\\"entry_name\\\\\")[0].setKeywords((\\'Mantra\\',))\n\n In HOM the gallery entries can be managed using hou.Gallery.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def canApplyToNode(self, node: Node) -> bool:\n \"\"\"\n\n canApplyToNode(self, node) -> bool\n\n Return True if this gallery entry can be safely applied to the given\n node. See hou.GalleryEntry.applyToNode for more info.\n\n\n node\n A node to test whether the gallery entry can be applied to.\n\n\n \"\"\"\n def applyToNode(self, node: Node) -> None:\n \"\"\"\n\n applyToNode(self, node)\n\n Apply the gallery entry to a given node. This method sets the node's\n parameter values to match the ones stored by the entry. It may also\n add spare parameters and channels to the node and for the subnets,\n it may create new child nodes.\n\n\n node\n A node to which to apply the gallery entry.\n\n\n \"\"\"\n def canCreateChildNode(self, parent: Node) -> bool:\n \"\"\"\n\n canCreateChildNode(self, parent) -> bool\n\n Return True if hou.GalleryEntry.createChildNode can succeed.\n\n\n \"\"\"\n def createChildNode(self, parent: Node) -> Node:\n \"\"\"\n\n createChildNode(self, parent) -> Node\n\n Create a new node in the parent network and then apply this gallery\n entry to that newly created node.\n\n\n parent\n A subnetwork within which the new node should be created. If\n None, an implicit natural parent is chosen using a node type\n this gallery entry is associated with.\n\n\n \"\"\"\n def setEqual(self, entry: GalleryEntry) -> None:\n \"\"\"\n\n setEqual(self, entry)\n\n Set this gallery entry to be exactly the same as the given entry,\n except for the name, which is left unchanged.\n\n\n entry\n The gallery entry to copy the information from.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> string\n\n Return the gallery entry name.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Set the gallery entry name.\n\n\n name\n The name string.\n\n\n \"\"\"\n def label(self) -> str:\n \"\"\"\n\n label(self) -> str\n\n Return the gallery entry label.\n\n\n \"\"\"\n def setLabel(self, label: str) -> None:\n \"\"\"\n\n setLabel(self, label)\n\n Set the gallery entry label.\n\n\n label\n The label string.\n\n\n \"\"\"\n def description(self) -> str:\n \"\"\"\n\n description(self) -> string\n\n Return a description of the gallery entry. A description is a short\n string that states the gallery entry purpose. It is used for tool-\n tip pop-ups.\n\n\n \"\"\"\n def setDescription(self, description: str) -> None:\n \"\"\"\n\n setDescription(self, description)\n\n Set the description of the gallery entry.\n\n\n description\n The text briefly describing the gallery entry purpose.\n\n\n \"\"\"\n def helpURL(self) -> str:\n \"\"\"\n\n helpURL(self) -> string\n\n Return the URL of the help document for this gallery entry.\n\n\n \"\"\"\n def setHelpURL(self, helpurl: str) -> None:\n \"\"\"\n\n setHelpURL(self, helpurl)\n\n Set the URL of the help document for this gallery entry.\n\n\n \"\"\"\n def requiredHDAFile(self) -> str:\n \"\"\"\n\n requiredHDAFile(self) -> string\n\n Return a file path to an HDA library that should be loaded before\n trying to apply this gallery entry. It is often used for gallery\n entries associated with a non-native operator type.\n\n\n \"\"\"\n def setRequiredHDAFile(self, hda_file: str) -> None:\n \"\"\"\n\n setRequiredHDAFile(self, hda_file)\n\n Set a file path to an HDA library on which this gallery entry\n depends.\n\n\n hda_file\n A path of the HDA library file (OTL).\n\n\n \"\"\"\n def icon(self) -> str:\n \"\"\"\n\n icon(self) -> string\n\n Return the icon name or a icon file path that should be used for\n this gallery entry.\n\n\n \"\"\"\n def setIcon(self, icon: str) -> None:\n \"\"\"\n\n setIcon(self, icon)\n\n Set the icon name or an icon file path that should be used for this\n gallery entry.\n\n\n \"\"\"\n def allowIconRegeneration(self) -> bool:\n \"\"\"\n\n allowIconRegeneration(self) -> bool\n\n Return True if this gallery entry wants to let Houdini regenerate\n the icon for it automatically using an appropriate renderer. Only\n applies to material gallery entries.\n\n\n \"\"\"\n def setAllowIconRegeneration(self, on: bool) -> None:\n \"\"\"\n\n setAllowIconRegeneration(self, allow)\n\n Sets the allow icon regeneration flag on this gallery entry.\n\n\n \"\"\"\n def isHidden(self) -> bool:\n \"\"\"\n\n isHidden(self) -> bool\n\n Return True if this gallery entry is hidden from the tools gallery\n menu.\n\n\n \"\"\"\n def setHidden(self, hide: bool) -> None:\n \"\"\"\n\n setHidden(self, hide)\n\n Set the hidden flag which controls whether a gallery entry is shown\n in the tools gallery menu.\n\n\n \"\"\"\n def bestNodeType(self) -> Optional[NodeType]:\n \"\"\"\n\n bestNodeType(self) -> NodeType or None\n\n Return a best node type which this gallery entry is associated with\n and whose nodes it can be applied to.\n\n\n \"\"\"\n def nodeTypeNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n nodeTypeNames(self) -> tuple of strings\n\n Return the names of the node type this gallery is associated with.\n The gallery can be safely applied to the nodes of these types.\n\n\n \"\"\"\n def setNodeTypeNames(self, nodetypes: Sequence[str]) -> None:\n \"\"\"\n\n setNodeTypeNames(self, nodetypes)\n\n Set the names of the node types this gallery should be associated\n with.\n\n\n nodetypes\n A string containing white-space separated list of node type\n names.\n\n\n \"\"\"\n def categories(self) -> Tuple[str, ...]:\n \"\"\"\n\n categories(self) -> tuple of strings\n\n Return the categories this gallery entry subscribes to.\n\n\n \"\"\"\n def setCategories(self, categories: Sequence[str]) -> None:\n \"\"\"\n\n setCategories(self, categories)\n\n Set the categories this gallery entry subscribes to.\n\n\n categories\n A sequence of strings containing the categories to set the\n gallery entry to.\n\n\n \"\"\"\n def keywords(self) -> Tuple[str, ...]:\n \"\"\"\n\n keywords(self) -> tuple of strings\n\n Return the keywords that describe this gallery entry.\n\n\n \"\"\"\n def setKeywords(self, keywords: Sequence[str]) -> None:\n \"\"\"\n\n setKeywords(self, keywords)\n\n Set the keywords that describe this gallery entry.\n\n\n keywords\n A string containing a white-space separated list of keywords.\n\n\n \"\"\"\n def nodeTypeCategory(self) -> NodeTypeCategory:\n \"\"\"\n\n nodeTypeCategory(self) -> NodeTypeCategory\n\n Return the category of the node types this gallery entry is\n associated with.\n\n\n \"\"\"\n def setNodeTypeCategory(self, category: NodeTypeCategory) -> None:\n \"\"\"\n\n setNodeTypeCategory(self, category)\n\n Set the category of the node types this gallery entry should be\n associated with.\n\n\n category\n A hou.NodeTypeCategory to associate this gallery entry with.\n\n\n \"\"\"\n def script(self) -> str:\n \"\"\"\n\n script(self) -> string\n\n Return a script that modifies the node parameters to match the\n information stored in the gallery entry.\n\n\n \"\"\"\n def setScript(self, script: str) -> None:\n \"\"\"\n\n setScript(self, script)\n\n Set a script that modifies the parameters when the gallery entry is\n applied to a node.\n\n\n script\n A string that contains the commands setting the node's\n parameters.\n\n\n \"\"\"\n def setScriptFromNode(self, node: Node) -> None:\n \"\"\"\n\n setScriptFromNode(self, node)\n\n Set a script that modifies node parameters. Later on, when applying\n this gallery entry to a node, the script will reconstruct that\n node's parameters to match exactly the parameters of a node passed\n to this method.\n\n\n node\n A node object from which to build the script.\n\n\n \"\"\"\n def setContentsFromNode(self, node: Node) -> None:\n \"\"\"\n\n setContentsFromNode(self, node)\n\n Save the information about the node contents (i.e., child nodes).\n When applying the node entry later on, these nodes will be\n reconstructed in a new parent to match the contents of the current\n parent.\n\n\n node\n The parent of the nodes whose data should be saved.\n\n\n \"\"\"\n\nclass Geometry:\n \"\"\"\n\n hou.Geometry\n\n A Geometry object contains the points and primitives that define a 3D\n geometric shape. For example, each SOP node in Houdini generates a\n single Geometry object.\n\n If you ask a SOP for its geometry via hou.SopNode.geometry, you'll get a\n read-only reference to it. If the SOP recooks, the corresponding\n Geometry object will update to the SOP's new geometry. If the SOP is\n deleted, accessing the Geometry object will raise a hou.ObjectWasDeleted\n exception. If you call methods that try to modify the geometry, they\n will raise a hou.GeometryPermissionError exception.\n\n\n NOTE\n Whenever you call a method on a hou.Geometry object, Houdini will\n first attempt to acquire a handle to the underlying geometry. When\n working with read-only references to geometry on a SOP node, if the\n SOP in question fails to cook after the read-only reference has been\n assigned to a variable then any calls to methods on that variable\n will throw a hou.InvalidGeometry exception. If you receive this\n exception, your read-only reference is still 'live' and so methods\n on it will be accessible when the node errors are resolved, until\n then your code should handle this exception to avoid getting further\n errors. See hou.Geometry.isValid\n\n If you do not want the geometry to update when the SOP recooks, you can\n call hou.Geometry.freeze. freeze returns another Geometry object that\n will not change when the SOP recooks. Accessing frozen Geometry is\n slightly faster, since Houdini does not need to look up the SOP node for\n each access, so you may want to use frozen geometry for speed-crucial\n operations.\n\n If you're writing a SOP using Python, you will have read-write access to\n the geometry, and it will be frozen. To create a Python-defined SOP,\n select File > New Operator Type... and place the Python code in the Code\n tab.\n\n Finally, you can allocate a new frozen geometry with read-write access\n by creating an instance of hou.Geometry.\n\n GEOMETRY MODIFICATION\n\n Since Houdini 18, modifying geometry outside of cooking that is then\n passed into other HOM methods requires a corresponding increment of\n the appropriate data ids as well as incrementing the modification\n counter. This is especially important if you pass this geometry to\n be processed such as hou.SopVerb.execute since it uses data id\n optimizations. The simplest way to do this is to call\n hou.Geometry.incrementAllDataIds. However, a fine-grained list of\n methods can used to obtain the best performance:\n hou.Geometry.incrementDataIdsForAddOrRemove,\n hou.Geometry.incrementPrimitiveIntrinsicsDataId,\n hou.Geometry.incrementTopologyDataId, hou.Attrib.incrementDataId,\n hou.PointGroup.incrementDataId, hou.PrimGroup.incrementDataId,\n hou.EdgeGroup.incrementDataId, hou.VertexGroup.incrementDataId,\n hou.Geometry.incrementModificationCounter.\n\n When modifying geometry while inside a SOP, all data ids are\n automatically incremented, as well as the geometry change counter.\n To opt out of automatic data ids incrementing, call\n hou.SopNode.setManagesAttribDataIds with True. Note that you cannot\n opt out of incrementing the geometry change counter, it must be\n always done whenever a SOP node cooks. When unsure, it is better to\n leave hou.SopNode.managesAttribDataIds to the default False or else\n there is a risk that users of the output geometry (eg. the viewport)\n will fail to update when the geometry has changed.\n\n RELATED\n\n * hou.AttribDataId\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, geo: Optional[Geometry] = None, clone_data_ids: bool = False) -> None:\n \"\"\"\n\n isValid(self)\n\n Check that the hou.Geometry object references a non-null geometry.\n\n Will only be False when the hou.Geometry is a read-only reference to\n a SOP node's geometry that has failed to cook since the reference\n was assigned.\n\n Will always be True for a 'frozen' geometry, see also\n hou.Geometry.freeze.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def sopNode(self) -> Optional[SopNode]:\n \"\"\"\n\n sopNode(self) -> hou.SopNode\n\n If the Geometry is not frozen, return the hou.SopNode object\n corresponding to this Geometry. Otherwise, return None.\n\n See hou.Geometry.freeze for more information on frozen geometry.\n\n\n \"\"\"\n def sopNodeOutputIndex(self) -> int:\n \"\"\"\n\n sopNodeOutputIndex(self) -> int\n\n If the Geometry is not frozen, return the index of the SOP node\n output that this geometry corresponds to. Otherwise, return -1.\n\n For most cases this method will return 0 to indicate that the\n geometry corresponds to the first output. This method will only\n return a value other than 0 for SOP nodes that have multiple\n outputs.\n\n See hou.Geometry.freeze for more information on frozen geometry.\n\n\n \"\"\"\n def isValid(self) -> bool: ...\n def freeze(self, read_only: bool = False, clone_data_ids: bool = False) -> Geometry:\n \"\"\"\n\n freeze(self, read_only=False, clone_data_ids=False) -> hou.Geometry\n\n Return another Geometry object that is not linked to a particular\n SOP.\n\n Normally, when you call hou.SopNode.geometry, the resultant Geometry\n object retains a reference to that SOP, and is said to be unfrozen.\n Each time you access points, primitives, attributes, etc. in an\n unfrozen Geometry object, Houdini uses the SOP's latest cooked\n geometry. So, if you change parameters or change the time for an\n animated SOP, the Geometry object will update to the SOP's new\n geometry.\n\n Unless Python SOPs are involved, a frozen Geometry object does not\n have a similar live association with a particular SOP. If you ask a\n SOP for its geometry and then store a frozen copy of that geometry,\n when the SOP recooks the frozen Geometry object will not update.\n Instead, the frozen geometry saves its own copy of the point and\n primitive data, and is unaffected by subsequent changes to the SOP.\n When a frozen Geometry object is destroyed, any geometry copy it\n created is also destroyed.\n\n Note that accessing a Geometry object's points, primitives,\n attributes, etc. may be faster when dealing with frozen objects. You\n may want to work with frozen Geometry in speed-sensitive operations.\n\n Calling this method on an unfrozen Geometry object returns a frozen\n one. Calling it on a frozen object has no effect, and it returns a\n frozen object.\n\n When a Python-defined SOP cooks and runs Python code that asks for\n the SOP's geometry, the returned Geometry object is writable.\n Modifying this Geometry object affects the output of this SOP. For\n efficiency, this geometry object is already frozen, so calling\n freeze on it has no effect.\n\n\n read_only\n If True, the resulting frozen geometry will be read-only. Use\n read-only frozen geometry to share embedded geometry among\n multiple packed primitives.\n\n clone_data_ids\n If the conditions of this method causes a copy of the geometry\n to be made, then this specifies whether the new copy will have\n the same data ids. This is useful to enable optimizations that\n cache data by only looking at the attribute data id regardless\n of whether it is from the same geometry object or not.\n Otherwise, the new copy will have data ids that are unique.\n\n\n \"\"\"\n def pointCount(self) -> int:\n \"\"\"\n\n pointCount(self) -> int\n\n Returns the number of points in the geometry.\n\n\n \"\"\"\n def vertexCount(self) -> int:\n \"\"\"\n\n vertexCount(self) -> int\n\n Returns the number of vertices in the geometry.\n\n\n \"\"\"\n def primCount(self) -> int:\n \"\"\"\n\n primCount(self) -> int\n\n Returns the number of primitivesin the geometry.\n\n\n \"\"\"\n def iterPoints(self) -> _PointTupleGenerator:\n \"\"\"\n\n iterPoints(self) -> generator of hou.Point\n\n Return a generator that iterates through all the points in the\n geometry.\n\n Whereas hou.Geometry.points allocates and returns a tuple of all the\n points in the geometry, this method returns a generator object that\n will allocate hou.Point objects on demand. This object is very fast\n at random access into the sequence.\n\n If you're accessing a specific point by index and the geometry\n contains many points, it is faster to use iterPoints() than\n points(). If, however, you are iterating over all the points in the\n geometry, it is generally faster to use points() than iterPoints().\n\n > # This is preferred:\n > geo.iterPoints()[23]\n > \n > # over this:\n > geo.points()[23]\n > \n > # But this is preferred:\n > for point in geo.points():\n > ...process point...\n > \n > # over this:\n > for point in geo.iterPoints():\n > ...process point...\n\n \"\"\"\n def points(self) -> Tuple[Point, ...]:\n \"\"\"\n\n points(self) -> tuple of hou.Point\n\n Return a tuple of all the points in the geometry.\n\n See also the hou.Geometry.iterPoints method.\n\n\n \"\"\"\n def point(self, index: int) -> Optional[Point]:\n \"\"\"\n\n point(self, index) -> hou.Point\n\n Return the point at the specified index.\n\n This is a convenience method for accessing a particular point\n without the overhead of obtaining all points via\n hou.Geometry.points.\n\n Return None if no such point at the specified index exists.\n\n\n \"\"\"\n def iterPrims(self) -> _PrimTupleGenerator:\n \"\"\"\n\n iterPrims(self) -> generator of hou.Prim\n\n Return a generator that iterates through all the primitives in the\n geometry.\n\n Whereas hou.Geometry.prims allocates and returns a tuple of all the\n primitives in the geometry, this method returns a generator object\n that will yield hou.Prim objects on demand. This object is very fast\n at random access into the sequence.\n\n If you're accessing a specific primitive by index and the geometry\n contains many primitives, it is faster to use iterPrims() than\n prims(). If, however, you are iterating over all the primitives in\n the geometry, it is generally faster to use prims() than\n iterPrims().\n\n > # This is preferred:\n > geo.iterPrims()[23]\n > \n > # over this:\n > geo.prims()[23]\n > \n > # But this is preferred:\n > for prim in geo.prims():\n > ...process prim...\n > \n > # over this:\n > for prim in geo.iterPrims():\n > ...process prim...\n\n See also the hou.Geometry.prims method.\n\n\n \"\"\"\n def prims(self) -> Tuple[Prim, ...]:\n \"\"\"\n\n prims(self) -> tuple of hou.Prim\n\n Return a tuple of all the primitives in the geometry. The primitives\n returned will be subclasses of hou.Prim (e.g.polygons, volumes,\n etc.).\n\n See also:\n\n * hou.Geometry.iterPrims\n\n * hou.Face\n\n * hou.Polygon\n\n * hou.Surface\n\n * hou.Volume\n\n\n \"\"\"\n def prim(self, index: int) -> Optional[Prim]:\n \"\"\"\n\n prim(self, index) -> hou.Prim\n\n Return the primitive at the specified index.\n\n This is a convenience method for accessing a particular primitive\n without the overhead of obtaining all primitives via\n hou.Geometry.prims.\n\n Return None if no such primitive at the specified index exists.\n\n\n \"\"\"\n def primTypeNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n primTypeNames(self) -> tuple of str\n\n Returns a list of all possible primitive type names. These are the\n internal names, as used by containsPrimType and similar functions.\n This includes HDK definied primitive types.\n\n Note the order may vary depending on library orders, but will be\n consistent with the other primType methods..\n\n\n \"\"\"\n def primTypeLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n primTypeLabels(self) -> tuple of str\n\n Returns a list of all possible primitive type labels. These are the\n external names meant to be more human readable. This includes HDK\n definied primitive types.\n\n Note the order may vary depending on library orders, but will be\n consistent with the other primType methods..\n\n\n \"\"\"\n def primTypeIcons(self) -> Tuple[str, ...]:\n \"\"\"\n\n primTypeIcons(self) -> tuple of str\n\n Returns a list of all possible primitive type icons. These are icon\n files that represent the primitive. Many are not defined. This\n includes HDK definied primitive types.\n\n Note the order may vary depending on library orders, but will be\n consistent with the other primType methods..\n\n\n \"\"\"\n def containsPrimType(self, type_or_name: EnumValue|str) -> bool:\n '''\n\n containsPrimType(self, type_or_name) -> bool\n\n Returns whether the geometry contains at least one primitive of the\n specified type.\n\n\n type_or_name\n A hou.primType, or a string containing the name of a primitive\n type.\n\n Typical examples of string values are \\\\\"Poly\\\\\" (polygon) or\n \\\\\"PackedAgent\\\\\" (agent packed primitive). To see a complete list\n of possible typename values, run ginfo -P on a Houdini tools\n command line.\n\n\n '''\n def countPrimType(self, type_or_name: EnumValue|str) -> int:\n '''\n\n countPrimType(self, type_or_name) -> long\n\n Returns the number of primitives of the specified type in the\n geometry.\n\n\n type_or_name\n A hou.primType, or a string containing the name of a primitive\n type.\n\n Typical examples of string values are \\\\\"Poly\\\\\" (polygon) or\n \\\\\"PackedAgent\\\\\" (agent packed primitive). To see a complete list\n of possible typename values, run ginfo -P on a Houdini tools\n command line.\n\n\n '''\n def countUnusedPoints(self) -> int:\n \"\"\"\n\n countUnusedPoints(self) -> long\n\n Returns the number of points in the geometry that are not part of\n any primitive.\n\n\n \"\"\"\n def primsOfType(self, prim_type: EnumValue) -> Tuple[Prim, ...]:\n \"\"\"\n\n primsOfType(primtype) -> tuple of hou.Prim\n\n Return a tuple of the primitives of the specified type in the\n geometry. The primitives returned will be subclasses of hou.Prim\n (e.g.polygons, volumes, etc.).\n\n\n \"\"\"\n def iterPrimsOfType(self, prim_type: EnumValue) -> Iterator[Prim]:\n \"\"\"\n\n iterPrimsOfType(primtype) -> generator of hou.Prim\n\n Return a generator that iterates through all the primitives of the\n specified type in the geometry.\n\n See also the hou.Geometry.prims and hou.Geometry.iterPrims methods.\n\n\n \"\"\"\n def preferredPrecision(self) -> int:\n \"\"\"\n\n preferredPrecision(self) -> int\n\n Returns the preferred computation precision of the geometry. This\n can be used to determine what sort of attributes to create and what\n precision to run intermediate computations in. Can be either 32 or\n 64.\n\n\n \"\"\"\n def setPreferredPrecision(self, prec: int) -> None:\n \"\"\"\n\n setPreferredPrecision(self, int)\n\n Adjusts the preferred precision of the geometry. The value should be\n either 32 or 64. Nodes may use this precision as a hint to set\n default attribute creation and computation to a certain precision.\n\n\n \"\"\"\n def averageMinDistance(self, local_transform: Matrix4, geometry: Geometry, geometry_transform: Matrix4) -> float:\n \"\"\"\n\n averageMinDistance(self, local_transform, geometry, geometry_transform)\n -> float\n\n Return the average over all points in of the minimum\n distance to the point set of \n\n\n local_transform\n A transform to be applied to all points in this geometry.\n\n geometry\n The geometry to find distances from.\n\n geometry_transform\n A transform to be applied to all points in .\n\n Raises hou.OperationFailed if has no vertices.\n\n > query_geometry = query_node.geometry()\n > queried_geometry = queried_node.geometry()\n > \n > # Return the average over all points in of the minimum\n > # distance to the point set of \n > query_geometry.averageMinDistance(\n > query_node.worldTransform(),\n > queried_geometry,\n > queried_node.worldTransform())\n\n \"\"\"\n def averageEdgeLength(self) -> float:\n \"\"\"\n\n averageEdgeLength(self) -> float\n\n Return the average edge length of the mesh.\n\n Raises hou.OperationFailed if mesh does not contain any edges.\n\n > # Return the average edge length.\n > geo.averageEdgeLength()\n\n \"\"\"\n def globPoints(self, pattern: str, ordered: bool = False) -> Tuple[Point, ...]:\n '''\n\n globPoints(self, pattern, ordered=False) -> tuple of hou.Point\n\n Return a tuple of points corresponding to a pattern of point\n numbers.\n\n The pattern format is the same one used by the group fields on SOP\n nodes that take point selections. Elements in the pattern are\n separated by spaces, and elements can be point numbers, point number\n ranges, or group names.\n\n Optionally, the points can be returned in the order they were added\n to the group.\n\n This method can be useful when writing a Python SOP that works on\n only a selected set of points.\n\n Raises hou.OperationFailed if the pattern is not valid or if it\n refers to a group that does not exist. Note that an empty pattern is\n considered to be invalid. Numbers that do not refer to valid points\n are not errors, and simply do not match points.\n\n > # Return a tuple containing points 5 and 7.\n > geo.globPoints(\\\\\"5 7\\\\\")\n > \n > # Return a tuple containing points 5 to 10.\n > geo.globPoints(\\\\\"5-10\\\\\")\n > \n > # Return a tuple containing all the points in the pointgroup called group1.\n > geo.globPoints(\\\\\"group1\\\\\")\n > \n > # Return all the points except those from 0 to 98.\n > geo.globPoints(\\\\\"!0-98\\\\\")\n > \n > # Return points 5, 10 to 20, and those in group1.\n > geo.globPoints(\\\\\"5 group1 10-20\\\\\")\n\n The following Python SOP example is behaves similarly to the Point\n sop.\n\n > # This code will work from inside a Python SOP, but not from the Python\n > # shell. It assumes the Python sop has the following parm tuples:\n > # group: A string containing which points to affect\n > # t: A set of 3 floats that behaves like the point sop\\'s position\n > # parameter. Set these parameters to the expressions ($TX, $TY, $TZ).\n > geo = hou.pwd().geometry()\n > \n > # Use the group field to determine which points to affect. If it\\'s blank,\n > # operate on all points.\n > pattern = hou.ch(\\\\\"group\\\\\")\n > if pattern == \\\\\"\\\\\":\n > points = geo.points()\n > else:\n > points = geo.globPoints(pattern)\n > \n > # Loop through the points, setting the SOP\\'s current point as we go.\n > # Then evaluate the t parm tuple, so it can use the current point (e.g.\n > # with hscript\\'s $TX or Python\\'s pwd().curPoint()).\n > for point in points:\n > hou.pwd().setCurPoint(point)\n > new_position = hou.pwd().evalParmTuple(\\\\\"t\\\\\")\n > point.setPosition(new_position)\n\n '''\n def globPrims(self, pattern: str) -> Tuple[Prim, ...]:\n \"\"\"\n\n globVertices(self, pattern) -> tuple of hou.Vertex\n\n Return a tuple of vertices corresponding to a pattern of vertex\n numbers.\n\n The pattern format is the same one used by the group fields on SOP\n nodes that take vertex selections. See hou.Geometry.globPoints for\n more information.\n\n\n \"\"\"\n def globVertices(self, pattern: str) -> Tuple[Vertex, ...]: ...\n def globEdges(self, pattern: str) -> Tuple[Edge, ...]: ...\n def findPointAttrib(self, name: str, scope: EnumValue = ...) -> Attrib|None:\n \"\"\"\n\n findPointAttrib(self, name, scope=hou.attribScope.Public) -> hou.Attrib\n or None\n\n Look up a point attribute by name. Returns the corresponding\n hou.Attrib object, or None if no attribute exists with that name.\n\n\n name\n The name of the point attribute.\n\n scope\n A hou.attribScope value to specify whether the attribute is\n public or private.\n\n Note that the point position attribute is named P and is 3 floats in\n size. Also, the point weight attribute is named Pw and is 1 float in\n size. P always exists, but Pw may not.\n\n See hou.Point.attribValue for an example.\n\n\n \"\"\"\n def findPrimAttrib(self, name: str, scope: EnumValue = ...) -> Attrib|None:\n \"\"\"\n\n findPrimAttrib(self, name, scope=hou.attribScope.Public) -> hou.Attrib\n or None\n\n Look up a primitive attribute by name. Returns the corresponding\n hou.Attrib object, or None if no attribute exists with that name.\n\n\n name\n The name of the primitive attribute.\n\n scope\n A hou.attribScope value to specify whether the attribute is\n public or private.\n\n\n \"\"\"\n def findVertexAttrib(self, name: str, scope: EnumValue = ...) -> Attrib|None:\n \"\"\"\n\n findVertexAttrib(self, name, scope=hou.attribScope.Public) -> hou.Attrib\n or None\n\n Look up a vertex attribute by name. Returns the corresponding\n hou.Attrib object, or None if no attribute exists with that name.\n\n\n name\n The name of the vertex attribute.\n\n scope\n A hou.attribScope value to specify whether the attribute is\n public or private.\n\n\n \"\"\"\n def findGlobalAttrib(self, name: str, scope: EnumValue = ...) -> Attrib|None:\n \"\"\"\n\n findGlobalAttrib(self, name, scope=hou.attribScope.Public) -> hou.Attrib\n or None\n\n Look up a global (a.k.a. detail) attribute by name. Returns the\n corresponding hou.Attrib object, or None if no attribute exists with\n that name.\n\n\n name\n The name of the global attribute.\n\n scope\n A hou.attribScope value to specify whether the attribute is\n public or private.\n\n\n \"\"\"\n def attribType(self) -> EnumValue:\n \"\"\"\n\n attribType(self) -> hou.attribType enum value\n\n Return the enumerated value hou.attribType.Global. Points,\n primitives, vertices, and geometry support the same set of methods\n for querying their attributes, and this method is one of them.\n\n See also:\n\n * hou.Prim.attribType\n\n * hou.Point.attribType\n\n * hou.Vertex.attribType\n\n\n \"\"\"\n def floatAttribValue(self, name_or_attrib: str|Attrib) -> float:\n \"\"\"\n\n floatAttribValue(self, name_or_attrib) -> float\n\n Return the global (a.k.a. detail) attribute value for a particular\n floating point attribute. The attribute may be specified by name or\n by hou.Attrib object.\n\n Raises hou.OperationFailed if no attribute exists with this name or\n the attribute is not a float of size 1.\n\n In most cases, you'll just use hou.Geometry.attribValue to access\n attribute values. Houdini uses this method internally to implement\n attribValue.\n\n\n \"\"\"\n def floatListAttribValue(self, name_or_attrib: str|Attrib) -> Tuple[float,...]:\n \"\"\"\n\n floatListAttribValue(self, name_or_attrib) -> tuple of float\n\n Return the global (a.k.a. detail) attribute value for a particular\n floating point attribute. The attribute may be specified by name or\n by hou.Attrib object. The return value is a list of floats.\n\n It is valid to call this method when the attribute's size is 1. In\n this case, a list with one element is returned.\n\n See also:\n\n * hou.Geometry.attribValue\n\n\n \"\"\"\n def intAttribValue(self, attrib: Attrib|str) -> int:\n \"\"\"\n\n intAttribValue(self, name_or_attrib) -> int\n\n Return the global (a.k.a. detail) attribute value for a particular\n integer attribute of size 1. The attribute may be specified by name\n or by hou.Attrib object. See hou.Geometry.floatAttribValue for more\n information.\n\n\n \"\"\"\n def intListAttribValue(self, name_or_attrib: Attrib|str) -> Tuple[int,...]:\n \"\"\"\n\n intListAttribValue(self, name_or_attrib) -> tuple of int\n\n Return the global (a.k.a. detail) attribute value for a particular\n integer attribute. The attribute may be specified by name or by\n hou.Attrib object. The return value is a list of ints. See\n hou.Geometry.floatListAttribValue for more information.\n\n\n \"\"\"\n def stringAttribValue(self, attrib: Attrib|str) -> str:\n \"\"\"\n\n stringAttribValue(self, name_or_attrib) -> str\n\n Return the global (a.k.a. detail) attribute value for a particular\n string attribute. The attribute may be specified by name or by\n hou.Attrib object. See hou.Geometry.floatAttribValue for more\n information.\n\n\n \"\"\"\n def stringListAttribValue(self, name_or_attrib: Attrib|str) -> Tuple[str,...]:\n \"\"\"\n\n stringListAttribValue(self, name_or_attrib) -> tuple of str\n\n Return the global (a.k.a. detail) attribute value for a particular\n string attribute. The attribute may be specified by name or by\n hou.Attrib object. The return value is a list of strings. See\n hou.Geometry.floatListAttribValue for more information.\n\n\n \"\"\"\n def dictAttribValue(self, attrib: Attrib|str) -> AttribDictReturnType:\n \"\"\"\n\n dictAttribValue(self, name_or_attrib) -> dict\n\n Return the global (a.k.a detail) attribute value for a particular\n dictionary attribute. The attribute may be specified by name or by\n hou.Attrib object. See hou.Geometry.floatAttribValue for more\n information.\n\n\n \"\"\"\n def dictListAttribValue(self, name_or_attrib: Attrib|str) -> Sequence[AttribDictReturnType]:\n \"\"\"\n\n dictListAttribValue(self, name_or_attrib) -> tuple of str\n\n Return the global (a.k.a detail) attribute value for a particular\n dictionary attribute. The attribute may be specified by name or by\n hou.Attrib object. The return value is a tuple of dictionaries.\n\n It is valid to call this method when the attribute's size is 1. In\n this case, a tuple with one element is returned. See\n hou.Geometry.floatAttribValue for more information.\n\n\n \"\"\"\n def pointFloatAttribValues(self, name: str) -> Tuple[float, ...]:\n \"\"\"\n\n pointFloatAttribValues(self, name) -> tuple of float\n\n Return a tuple of floats containing one attribute's values for all\n the points.\n\n This method only works on int or float attributes. If the attribute\n contains more than one element, each point will correspond to\n multiple values in the result. For example, if Cd is a float\n attribute of size 3 and there are 3 points with values (0.1, 0.2,\n 0.3), (0.5, 0.5, 0.5), and (0.8, 0.7, 0.6) then the result will be\n (0.1, 0.2, 0.3, 0.5, 0.5, 0.5, 0.8, 0.7, 0.6).\n\n Calling this method is faster than looping over all the points and\n calling hou.Point.attribValue.\n\n If the attribute name is invalid or the attribute is not an int or\n float (e.g. it's a string attribute), this method raises\n hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def pointFloatAttribValuesAsString(self, name: str, float_type: EnumValue = ...) -> bytes:\n '''\n\n pointFloatAttribValuesAsString(self, name,\n float_type=hou.numericData.Float32) -> str for Python 2, bytes for\n Python 3\n\n Return a binary string representation of the floats of one\n attribute\\'s value for all the points. This method is faster than\n hou.Geometry.pointFloatAttribValues, and you can use the array\n module to convert the string into a Python sequence.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n float_type\n A hou.numericData value to specify the float data type (either\n Float16, Float32 or Float64).\n\n This method provides a faster implementation of the following:\n\n > import array\n > def pointFloatAttribValuesAsString(self, name):\n > return array.array(\\\\\"f\\\\\", self.pointFloatAttribValues(name)).tostring()\n\n You can convert the return value from this method to an array using\n the following method:\n\n > import array\n > def pointFloatAttribValuesAsArray(geometry, name):\n > a = array.array(\\\\\"f\\\\\")\n > a.fromstring(geometry.pointFloatAttribValuesAsString(name))\n > return a\n\n See hou.Geometry.pointFloatAttribValues for more information.\n\n\n '''\n def primFloatAttribValues(self, name: str) -> Tuple[float, ...]:\n \"\"\"\n\n primFloatAttribValues(self, name) -> tuple of float\n\n Return a tuple of floats containing one attribute's values for all\n the primitives.\n\n This method only works on int or float attributes. If the attribute\n contains more than one element, each primitive will correspond to\n multiple values in the result. For example, if Cd is a float\n attribute of size 3 and there are 3 primitives with values (0.1,\n 0.2, 0.3), (0.5, 0.5, 0.5), and (0.8, 0.7, 0.6) then the result will\n be (0.1, 0.2, 0.3, 0.5, 0.5, 0.5, 0.8, 0.7, 0.6).\n\n Calling this method is faster than looping over all the primitives\n and calling hou.Prim.attribValue.\n\n If the attribute name is invalid or the attribute is not an int or\n float (e.g. it's a string attribute), this method raises\n hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def primFloatAttribValuesAsString(self, name: str, float_type: EnumValue = ...) -> bytes:\n '''\n\n primFloatAttribValuesAsString(self, name) -> str for Python 2, bytes for\n Python 3\n\n Return a binary string representation of the floats of one\n attribute\\'s value for all the primitives. This method is faster than\n hou.Geometry.primFloatAttribValues, and you can use the array module\n to convert the string into a Python sequence.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n This method provides a faster implementation of the following:\n\n > import array\n > def primFloatAttribValuesAsString(self, name):\n > return array.array(\\\\\"f\\\\\", self.primFloatAttribValues(name)).tostring()\n\n You can convert the return value from this method to an array using\n the following method:\n\n > import array\n > def primFloatAttribValuesAsArray(geometry, name):\n > a = array.array(\\\\\"f\\\\\")\n > a.fromstring(geometry.primFloatAttribValuesAsString(name))\n > return a\n\n See hou.Geometry.primFloatAttribValues for more information.\n\n\n '''\n def vertexFloatAttribValues(self, name: str) -> Tuple[float, ...]:\n \"\"\"\n\n vertexFloatAttribValues(self, name) -> tuple of float\n\n Return a tuple of floats containing one attribute's values for all\n the vertices.\n\n This method only works on int or float attributes. If the attribute\n contains more than one element, each vertex will correspond to\n multiple values in the result. For example, if attrib is a float\n attribute of size 3 and there are 3 vertices with values (0.1, 0.2,\n 0.3), (0.5, 0.5, 0.5), and (0.8, 0.7, 0.6) then the result will be\n (0.1, 0.2, 0.3, 0.5, 0.5, 0.5, 0.8, 0.7, 0.6).\n\n Calling this method is faster than looping over all the vertices and\n calling hou.Vertex.attribValue.\n\n If the attribute name is invalid or the attribute is not an int or\n float (e.g. it's a string attribute), this method raises\n hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def vertexFloatAttribValuesAsString(self, name: str, float_type: EnumValue = ...) -> bytes:\n '''\n\n vertexFloatAttribValuesAsString(self, name,\n float_type=hou.numericData.Float32) -> str for Python 2, bytes for\n Python 3\n\n Return a binary string representation of the floats of one\n attribute\\'s value for all the vertices. This method is faster than\n hou.Geometry.vertexFloatAttribValues, and you can use the array\n module to convert the string into a Python sequence.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n float_type\n A hou.numericData value to specify the float data type (either\n Float16, Float32 or Float64).\n\n This method provides a faster implementation of the following:\n\n > import array\n > def vertexFloatAttribValuesAsString(self, name):\n > return array.array(\\\\\"f\\\\\", self.vertexFloatAttribValues(name)).tostring()\n\n You can convert the return value from this method to an array using\n the following method:\n\n > import array\n > def vertexFloatAttribValuesAsArray(geometry, name):\n > a = array.array(\\\\\"f\\\\\")\n > a.fromstring(geometry.vertexFloatAttribValuesAsString(name))\n > return a\n\n See hou.Geometry.vertexFloatAttribValues for more information.\n\n\n '''\n def pointIntAttribValues(self, name: str) -> Tuple[int, ...]:\n \"\"\"\n\n pointIntAttribValues(self, name) -> tuple of int\n\n Return a tuple of integers containing one attribute's values for all\n the points.\n\n This method only works on int or float attributes. If the attribute\n contains more than one element, each point will correspond to\n multiple values in the result. For example, if idmap is an integer\n attribute of size 2 and there are 3 points with values (1, 2), (2,\n 3), and (3, 4) then the result will be (1, 2, 2, 3, 3, 4).\n\n Calling this method is faster than looping over all the points and\n calling hou.Point.attribValue.\n\n If the attribute name is invalid or the attribute is not an int or\n float (e.g. it's a string attribute), this method raises\n hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def pointIntAttribValuesAsString(self, name: str, int_type: EnumValue = ...) -> bytes:\n '''\n\n pointIntAttribValuesAsString(self, name, int_type=hou.numericData.Int32)\n -> str for Python 2, bytes for Python 3\n\n Return a binary string representation of the integers of one\n attribute\\'s value for all the points. This method is faster than\n hou.Geometry.pointIntAttribValues, and you can use the array module\n to convert the string into a Python sequence.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n int_type\n A hou.numericData value to specify the integer data type (either\n Int8, Int16, Int32 or Int64).\n\n This method provides a faster implementation of the following:\n\n > import array\n > def pointIntAttribValuesAsString(self, name):\n > return array.array(\\\\\"i\\\\\", self.pointIntAttribValues(name)).tostring()\n\n You can convert the return value from this method to an array using\n the following method:\n\n > import array\n > def pointIntAttribValuesAsArray(geometry, name):\n > a = array.array(\\\\\"i\\\\\")\n > a.fromstring(geometry.pointIntAttribValuesAsString(name))\n > return a\n\n See hou.Geometry.pointIntAttribValues for more information.\n\n\n '''\n def primIntAttribValues(self, name: str) -> Tuple[int, ...]:\n \"\"\"\n\n primIntAttribValues(self, name) -> tuple of int\n\n Return a tuple of integers containing one attribute's values for all\n the primitives.\n\n This method only works on int or float attributes. If the attribute\n contains more than one element, each primitive will correspond to\n multiple values in the result. For example, if idmap is an integer\n attribute of size 2 and there are 3 primitives with values (1, 2),\n (2, 3), and (3,4) then the result will be (1, 2, 2, 3, 3, 4).\n\n Calling this method is faster than looping over all the primitives\n and calling hou.Prim.attribValue.\n\n If the attribute name is invalid or the attribute is not an int or\n float (e.g. it's a string attribute), this method raises\n hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def primIntAttribValuesAsString(self, name: str, int_type: EnumValue = ...) -> bytes:\n '''\n\n primIntAttribValuesAsString(self, name, int_type=hou.numericData.Int32)\n -> str for Python 2, bytes for Python 3\n\n Return a binary string representation of the integers of one\n attribute\\'s value for all the primitives. This method is faster than\n hou.Geometry.primFloatAttribValues, and you can use the array module\n to convert the string into a Python sequence.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n int_type\n A hou.numericData value to specify the integer data type (either\n Int8, Int16, Int32 or Int64).\n\n This method provides a faster implementation of the following:\n\n > import array\n > def primIntAttribValuesAsString(self, name):\n > return array.array(\\\\\"i\\\\\", self.primIntAttribValues(name)).tostring()\n\n You can convert the return value from this method to an array using\n the following method:\n\n > import array\n > def primIntAttribValuesAsArray(geometry, name):\n > a = array.array(\\\\\"i\\\\\")\n > a.fromstring(geometry.primIntAttribValuesAsString(name))\n > return a\n\n See hou.Geometry.primIntAttribValues for more information.\n\n\n '''\n def vertexIntAttribValues(self, name: str) -> Tuple[int, ...]:\n \"\"\"\n\n vertexIntAttribValues(self, name) -> tuple of int\n\n Return a tuple of integers containing one attribute's values for all\n the vertices.\n\n This method only works on int or float attributes. If the attribute\n contains more than one element, each vertex will correspond to\n multiple values in the result. For example, if idmap is an integer\n attribute of size 2 and there are 3 vertices with values (1, 2), (2,\n 3), and (3, 4) then the result will be (1, 2, 2, 3, 3, 4).\n\n Calling this method is faster than looping over all the vertices and\n calling hou.Vertex.attribValue.\n\n If the attribute name is invalid or the attribute is not an int or\n float (e.g. it's a string attribute), this method raises\n hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def vertexIntAttribValuesAsString(self, name: str, int_type: EnumValue = ...) -> bytes:\n '''\n\n vertexIntAttribValuesAsString(self, name,\n int_type=hou.numericData.Int32) -> str for Python 2, bytes for Python 3\n\n Return a binary string representation of the integers of one\n attribute\\'s value for all the vertices. This method is faster than\n hou.Geometry.vertexIntAttribValues, and you can use the array module\n to convert the string into a Python sequence.\n\n The returned binary string is a bytes object in Python 3 and a str\n object in Python 2. See HOM binary data for more information.\n\n\n int_type\n A hou.numericData value to specify the integer data type (either\n Int8, Int16, Int32 or Int64).\n\n This method provides a faster implementation of the following:\n\n > import array\n > def vertexIntAttribValuesAsString(self, name):\n > return array.array(\\\\\"i\\\\\", self.vertexIntAttribValues(name)).tostring()\n\n You can convert the return value from this method to an array using\n the following method:\n\n > import array\n > def vertexIntAttribValuesAsArray(geometry, name):\n > a = array.array(\\\\\"i\\\\\")\n > a.fromstring(geometry.vertexIntAttribValuesAsString(name))\n > return a\n\n See hou.Geometry.vertexIntAttribValues for more information.\n\n\n '''\n def pointStringAttribValues(self, name: str) -> Tuple[str, ...]:\n \"\"\"\n\n pointStringAttribValues(self, name) -> tuple of str\n\n Return a tuple of strings containing one attribute's values for all\n the points.\n\n This method only works on string attributes. If the attribute\n contains more than one element, each point will correspond to\n multiple values in the result. For example, if strmap is a string\n attribute of size 2 and there are 3 points with values (apple,\n orange), (red, blue), and (one, two) then the result will be (apple,\n orange, red, blue, one, two).\n\n Calling this method is faster than looping over all the points and\n calling hou.Point.attribValue.\n\n If the attribute name is invalid or the attribute is not a string\n attribute then this method raises hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def primStringAttribValues(self, name: str) -> Tuple[str, ...]:\n \"\"\"\n\n primStringAttribValues(self, name) -> tuple of str\n\n Return a tuple of strings containing one attribute's values for all\n the primitives.\n\n This method only works on string attributes. If the attribute\n contains more than one element, each primitive will correspond to\n multiple values in the result. For example, if strmap is a string\n attribute of size 2 and there are 3 primitives with values (apple,\n orange), (red, blue), and (one, two) then the result will be (apple,\n orange, red, blue, one, two).\n\n Calling this method is faster than looping over all the primitives\n and calling hou.Prim.attribValue.\n\n If the attribute name is invalid or the attribute is not a string\n attribute) then this method raises hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def vertexStringAttribValues(self, name: str) -> Tuple[str, ...]:\n \"\"\"\n\n vertexStringAttribValues(self, name) -> tuple of str\n\n Return a tuple of strings containing one attribute's values for all\n the vertices.\n\n This method only works on string attributes. If the attribute\n contains more than one element, each vertex will correspond to\n multiple values in the result. For example, if strmap is a string\n attribute of size 2 and there are 3 vertices with values (apple,\n orange), (red, blue), and (one, two) then the result will be (apple,\n orange, red, blue, one, two).\n\n Calling this method is faster than looping over all the vertices and\n calling hou.Vertex.attribValue.\n\n If the attribute name is invalid or the attribute is not a string\n attribute then this method raises hou.OperationFailed.\n\n Note that you cannot pass a hou.Attrib object to this method like\n you can with many methods dealing with attributes. However, you can\n use hou.Attrib.name to easily get the name from an Attrib object.\n\n\n \"\"\"\n def setPointFloatAttribValues(self, name: str, values: Sequence[float]) -> None:\n \"\"\"\n\n setPointFloatAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all points.\n You would typically call this method from the code of a Python-\n defined SOP.\n\n\n name\n The name of the point attribute.\n\n values\n A sequence of int or float values in the same format as that\n returned by hou.Geometry.pointFloatAttribValues. See that method\n for more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not an int or float (i.e. it's a string), or the array\n of values is not the correct size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.pointFloatAttribValues.\n\n\n \"\"\"\n def setPrimFloatAttribValues(self, name: str, values: Sequence[float]) -> None:\n \"\"\"\n\n setPrimFloatAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all\n primitives. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n name\n The name of the primitive attribute.\n\n values\n A sequence of int or float values in the same format as that\n returned by hou.Geometry.primFloatAttribValues. See that method\n for more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not an int or float (i.e. it's a string), or the array\n of values is not the correct size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.primFloatAttribValues.\n\n\n \"\"\"\n def setVertexFloatAttribValues(self, name: str, values: Sequence[float]) -> None:\n \"\"\"\n\n setVertexFloatAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all\n vertices. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n name\n The name of the vertex attribute.\n\n values\n A sequence of int or float values in the same format as that\n returned by hou.Geometry.vertexFloatAttribValues. See that\n method for more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not an int or float (i.e. it's a string), or the array\n of values is not the correct size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.vertexFloatAttribValues.\n\n\n \"\"\"\n def setPointFloatAttribValuesFromString(self, name: str, values: bytes, float_type: EnumValue = ...) -> None: ...\n def setPrimFloatAttribValuesFromString(self, name: str, values: bytes, float_type: EnumValue = ...) -> None: ...\n def setVertexFloatAttribValuesFromString(self, name: str, values: bytes, float_type: EnumValue = ...) -> None: ...\n def setPointIntAttribValues(self, name: str, values: Sequence[int]) -> None:\n \"\"\"\n\n setPointIntAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all points.\n You would typically call this method from the code of a Python-\n defined SOP.\n\n\n name\n The name of the point attribute.\n\n values\n A sequence of int or float values in the same format as that\n returned by hou.Geometry.pointIntAttribValues. See that method\n for more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not an int or float (i.e. it's a string), or the array\n of values is not the correct size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.pointIntAttribValues.\n\n\n \"\"\"\n def setPrimIntAttribValues(self, name: str, values: Sequence[int]) -> None:\n \"\"\"\n\n setPrimIntAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all\n primitives. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n name\n The name of the primitive attribute.\n\n values\n A sequence of int or float values in the same format as that\n returned by hou.Geometry.primFloatAttribValues. See that method\n for more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not an int or float (i.e. it's a string), or the array\n of values is not the correct size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.primIntAttribValues.\n\n\n \"\"\"\n def setVertexIntAttribValues(self, name: str, values: Sequence[int]) -> None:\n \"\"\"\n\n setVertexIntAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all\n vertices. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n name\n The name of the vertex attribute.\n\n values\n A sequence of int or float values in the same format as that\n returned by hou.Geometry.vertexIntAttribValues. See that method\n for more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not an int or float (i.e. it's a string), or the array\n of values is not the correct size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.vertexIntAttribValues.\n\n\n \"\"\"\n def setPointIntAttribValuesFromString(self, name: str, values: bytes, int_type: EnumValue = ...) -> None: ...\n def setPrimIntAttribValuesFromString(self, name: str, values: bytes, int_type: EnumValue = ...) -> None: ...\n def setVertexIntAttribValuesFromString(self, name: str, values: bytes, int_type: EnumValue = ...) -> None: ...\n def setPointStringAttribValues(self, name: str, values: Sequence[str]) -> None:\n \"\"\"\n\n setPointStringAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all points.\n You would typically call this method from the code of a Python-\n defined SOP.\n\n\n name\n The name of the point attribute.\n\n values\n A sequence of string values in the same format as that returned\n by hou.Geometry.pointStringAttribValues. See that method for\n more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not a string, or the array of values is not the correct\n size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.pointStringAttribValues.\n\n\n \"\"\"\n def setPrimStringAttribValues(self, name: str, values: Sequence[str]) -> None:\n \"\"\"\n\n setPrimStringAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all\n primitives. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n name\n The name of the primitive attribute.\n\n values\n A sequence of string values in the same format as that returned\n by hou.Geometry.primStringAttribValues. See that method for more\n information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not a string, or the array of values is not the correct\n size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.primStringAttribValues.\n\n\n \"\"\"\n def setVertexStringAttribValues(self, name: str, values: Sequence[str]) -> None:\n \"\"\"\n\n setVertexStringAttribValues(self, name, values)\n\n For a particular attribute, set the attribute values for all\n vertices. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n name\n The name of the vertex attribute.\n\n values\n A sequence of string values in the same format as that returned\n by hou.Geometry.vertexStringAttribValues. See that method for\n more information.\n\n Raises hou.OperationFailed if the attribute name is not valid, the\n attribute is not a string, or the array of values is not the correct\n size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Also see hou.Geometry.vertexStringAttribValues.\n\n\n \"\"\"\n def renamePointAttrib(self, old_name: str, new_name: str) -> None:\n \"\"\"\n\n renamePointAttrib(self, old_name, new_name)\n\n Rename the point attribute with the specified old name to the new\n name. This method is typically called from within a Python-defined\n SOP when the SOP's geometry is writable.\n\n Raises GeometryPermissionError if called on a read-only geometry.\n Raises TypeError if old_name or new_name is None. Raises\n OperationFailed if no such point attribute with the old name exists.\n Raises OperationFailed if a point attribute with the new name\n already exists.\n\n\n \"\"\"\n def renamePrimAttrib(self, old_name: str, new_name: str) -> None:\n \"\"\"\n\n renamePrimAttrib(self, old_name, new_name)\n\n Rename the primitive attribute with the specified old name to the\n new name. This method is typically called from within a Python-\n defined SOP when the SOP's geometry is writable.\n\n Raises GeometryPermissionError if called on a read-only geometry.\n Raises TypeError if old_name or new_name is None. Raises\n OperationFailed if no such primitive attribute with the old name\n exists. Raises OperationFailed if a primitive attribute with the new\n name already exists.\n\n\n \"\"\"\n def renameVertexAttrib(self, old_name: str, new_name: str) -> None:\n \"\"\"\n\n renameVertexAttrib(self, old_name, new_name)\n\n Rename the vertex attribute with the specified old name to the new\n name. This method is typically called from within a Python-defined\n SOP when the SOP's geometry is writable.\n\n Raises GeometryPermissionError if called on a read-only geometry.\n Raises TypeError if old_name or new_name is None. Raises\n OperationFailed if no such vertex attribute with the old name\n exists. Raises OperationFailed if a vertex attribute with the new\n name already exists.\n\n\n \"\"\"\n def renameGlobalAttrib(self, old_name: str, new_name: str) -> None:\n \"\"\"\n\n renameGlobalAttrib(self, old_name, new_name)\n\n Rename the global attribute with the specified old name to the new\n name. This method is typically called from within a Python-defined\n SOP when the SOP's geometry is writable.\n\n Raises GeometryPermissionError if called on a read-only geometry.\n Raises TypeError if old_name or new_name is None. Raises\n OperationFailed if no such global attribute with the old name\n exists. Raises OperationFailed if a global attribute with the new\n name already exists.\n\n\n \"\"\"\n def createPoint(self) -> Point:\n \"\"\"\n\n createPoint(self) -> hou.Point\n\n Create a new point located at (0, 0, 0) and return the corresponding\n hou.Point object. You would typically call this method from the code\n of a Python-defined SOP.\n\n If the geometry contains point attributes, the new point receives\n the default values for those attributes.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See hou.Geometry.addAttrib, hou.Geometry.createPolygon, and\n hou.Face.addVertex for examples.\n\n\n \"\"\"\n def createPoints(self, point_positions: Sequence[Sequence[float]]) -> Tuple[Point,...]:\n \"\"\"\n\n createPoints(self, point_positions) -> tuple of hou.Point\n\n Create a set of points located at the specified positions and return\n a tuple of the new hou.Point objects. You would typically call this\n method from the code of a Python-defined SOP.\n\n point_positions can be either a tuple of hou.Vector3 objects or a\n tuple of 3-tuple floating point numbers. For example, if\n point_positions is ((0, 1, 2), (1, 2, 3)) then this method will\n create 2 points with one positioned at (0, 1, 2) and the other at\n (1, 2, 3).\n\n If the geometry contains point attributes, the new points receive\n the default values for those attributes.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable. Raises hou.InvalidSize if one of the specified point\n positions does not contain 3 values (for x, y, z).\n\n See hou.Geometry.addAttrib, hou.Geometry.createPolygons, and\n hou.Face.addVertex for examples.\n\n\n \"\"\"\n def createPolygon(self, is_closed: bool = True) -> Polygon:\n \"\"\"\n\n createPolygon(self, is_closed=True) -> hou.Polygon\n\n Create a new polygon and return the corresponding hou.Polygon\n object. You would typically call this method from the code of a\n Python-defined SOP.\n\n The newly created polygon has no vertices. Use hou.Face.addVertex to\n add them. The polygon is also closed (see hou.Face.isClosed for more\n information) by default unless specified otherwise for a polygon\n curve.\n\n If the geometry contains primitive attributes, the new polygon\n receives the default values for those attributes.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > geo = hou.pwd().geometry()\n > poly = geo.createPolygon()\n > for position in (0,0,0), (1,0,0), (0,1,0):\n > point = geo.createPoint()\n > point.setPosition(position)\n > poly.addVertex(point)\n\n See hou.Face.addVertex for a slightly more complicated example.\n\n\n \"\"\"\n def createPolygons(self, point_positions: Sequence[Point|Sequence[int]], is_closed: bool = ...) -> Tuple[Polygon,...]:\n \"\"\"\n\n createPolygons(self, points, is_closed=True) -> tuple of hou.Polygon\n\n Create a set of polygons with the specified points as vertices and\n return a tuple of the new hou.Polygon objects. You would typically\n call this method from the code of a Python-defined SOP.\n\n points can be either a tuple of tuples of hou.Point objects or a\n tuple of tuples of integers representing the point numbers. For\n example, if points is ((0, 1, 2), (3, 4, 5, 6)) then this method\n will create 2 polygons with one having points 0, 1 and 2 as its\n vertices and the other one having points 3, 4, 5 and 6 as its\n vertices.\n\n The created polygons are closed (see hou.Face.isClosed for more\n information) by default unless specified otherwise for polygon\n curves.\n\n If the geometry contains primitive attributes, then the new polygons\n receive the default values for those attributes.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable. Raises hou.InvalidSize if one of the specified point\n tuples does not contain at least 3 elements. Raises hou.InvalidInput\n if one of the point numbers or hou.Point objects do not exist in the\n geometry.\n\n Example:\n\n > # Create 6 points in the geometry.\n > geo = hou.pwd().geometry()\n > point_positions = (\n > (1, 0, 0), (0, 1, 0), (0, 0, 1),\n > (1, 1, 0), (1, 0, 1), (0, 1, 1),\n > )\n > points = geo.createPoints(point_positions)\n > \n > # Create 2 polygons.\n > # The first polygon uses the first 3 points in the geometry as its vertices.\n > # The second polygon uses the last 3 points in the geometry as its vertices.\n > polygons = geo.createPolygons(\n > ((points[0], points[1], points[2]), (points[3], points[4], points[5])))\n\n \"\"\"\n def createPacked(self, packed_type: str, point: Optional[Point] = None) -> PackedPrim:\n '''\n\n createPacked(self, typename, point=None) -> hou.PackedPrim\n\n\n typename\n A string containing the name of a type of packed primitive.\n Typical examples are \\\\\"PackedDisk\\\\\" (on-disk geometry file) or\n \\\\\"AlembicRef\\\\\" (Alembic file).\n\n To see a complete list of possible typename values, run ginfo -P\n on a Houdini tools command line.\n\n point\n\n See hou.PackedPrim for more information.\n\n\n '''\n def createTetrahedron(self) -> Prim:\n \"\"\"\n\n createTetrahedron(self) -> hou.Prim\n\n Create a new tetrahedron and return the corresponding hou.Prim\n object. You would typically call this method from the code of a\n Python-defined SOP.\n\n The newly created tetrahedron has four vertices and new points have\n been allocated for them. To build a tetrahedron out of existing\n points, use hou.Geometry.createTetrahedronInPlace\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def createTetrahedronInPlace(self, p0: Point, p1: Point, p2: Point, p3: Point) -> Prim:\n \"\"\"\n\n createTetrahedronInPlace(self, p0, p1, p2, p3) -> hou.Prim\n\n Create a new tetrahedron and return the corresponding hou.Prim\n object. You would typically call this method from the code of a\n Python-defined SOP.\n\n The newly created tetrahedron has four vertices and uses the points\n that have been passed into it.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def createHexahedron(self) -> Prim:\n \"\"\"\n\n createHexahedron(self) -> hou.Prim\n\n Create a new hexahedron and return the corresponding hou.Prim\n object. You would typically call this method from the code of a\n Python-defined SOP.\n\n The newly created hexahedron has eight vertices and new points have\n been allocated for them. To build a hexahedron out of existing\n points, use hou.Geometry.createHexahedronInPlace\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def createHexahedronInPlace(self, p0: Point, p1: Point, p2: Point, p3: Point, p4: Point, p5: Point, p6: Point, p7: Point) -> Prim:\n \"\"\"\n\n createHexahedronInPlace(self, p0, p1, p2, p3, p4, p5, p6, p7) ->\n hou.Prim\n\n Create a new hexahedron and return the corresponding hou.Prim\n object. You would typically call this method from the code of a\n Python-defined SOP.\n\n The newly created hexahedron has eight vertices and uses the points\n that have been passed into it.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def createNURBSCurve(self, num_points: int = 4, is_closed: bool = False, order: int = 4) -> Face:\n \"\"\"\n\n createNURBSCurve(self, num_vertices=4, is_closed=False, order=4) ->\n hou.Face\n\n Create a new NURBS with the specified number of vertices and return\n it. You would typically call this method from the code of a Python-\n defined SOP.\n\n\n num_vertices\n The number of verticies in the curve. A new point is added to\n the geometry for each vertex, and this point is located at the\n origin until you change its position. You can also add more\n vertices with hou.Face.addVertex.\n\n The minimum number of vertices for a NURBS curve is identical to\n its order. So for the default order of 4, the curve must have a\n minimum of 4 vertices. If you specify too few vertices, this\n method raises hou.OperationFailed.\n\n is_closed\n Controls if the curve is open or closed; see hou.Face.isClosed\n for more information. If not specified, the resulting curve is\n open. This behavior is different from\n hou.Geometry.createPolygon, where the new polygon is closed. You\n can also open or close it with hou.Face.setIsClosed.\n\n order\n Specifies the curve's order. The default order is 4,\n corresponding to a cubic NURBS curve. An order of 2, the lowest\n order, will give a curve with linear segments.\n\n If the geometry contains primitive attributes, the new curve\n receives the default values for those attributes.\n\n > # This code will work from inside a Python SOP, but not from the Python\n > # shell.\n > geo = hou.pwd().geometry()\n > curve = geo.createNURBSCurve(10)\n > i = 0\n > for vertex in curve.vertices():\n > vertex.point().setPosition((i, i % 3, 0))\n > i = i + 1\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also:\n\n * hou.Prim.vertices\n\n * hou.Point.setPosition\n\n\n \"\"\"\n def createBezierCurve(self, num_points: int = 4, is_closed: bool = False, order: int = 4) -> Face:\n \"\"\"\n\n createBezierCurve(num_points: 'int' = 4, is_closed: 'bool' = False,\n order: 'int' = 4) -> hou.Face\n\n Create a new Bezier curve with the specified number of vertices and\n return it. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n num_vertices\n The number of verticies in the curve. A new point is added to\n the geometry for each vertex, and this point is located at the\n origin until you change its position. You can also add more\n vertices with hou.Face.addVertex.\n\n is_closed\n Controls if the curve is open or closed; see hou.Face.isClosed\n for more information. If not specified, the resulting curve is\n open. This behavior is different from\n hou.Geometry.createPolygon, where the new polygon is closed.\n\n order\n Specifies the curve's order. The default order is 4,\n corresponding to a cubic Bezier curve. An order of 2, the lowest\n order, will give a curve with linear segments.\n\n An open Bezier curve must have (order - 1) * n + 1 vertices for some\n integer n>=1 (so valid values for order 4 curves are 4, 7, 10,\n etc.). A closed Bezier curve must have (order - 1) * n vertices\n (e.g. 3, 6, 9, etc. for order 4 curve). This restriction does not\n apply to curves of order 2, however.\n\n As a consequence, you cannot use hou.Face.setIsClosed on non-linear\n Bezier curves, since the number of vertices would need to change.\n\n See hou.Geometry.createNURBSCurve for more information.\n\n\n \"\"\"\n def createNURBSSurface(self, rows: int, cols: int, is_closed_in_u: bool = False, is_closed_in_v: bool = False, order_u: int = 4, order_v: int = 4) -> Surface:\n \"\"\"\n\n createNURBSSurface(self, rows, cols, is_closed_in_u=False,\n is_closed_in_v=False) -> hou.Surface\n\n Create a NURBS surface in the XY plane centered at the origin with\n size (1, 1) and return it. You would typically call this method from\n the code of a Python-defined SOP.\n\n\n rows, cols\n Determines the size of the 2D array of vertices defining the\n control points of the surface. The number of cols and rows in\n each direction, must be equal to or larger than the U and V\n orders, respectively.\n\n is_closed_in_u, is_closed_in_v\n Controls if the surface is open or closed in each of the U and V\n directions; see hou.Surface.isClosedInU for more information. If\n not specified, the default behavior is to build an open surface.\n\n order_u, order_v\n Specifies the surface's order in each of the U and V directions.\n The default order for both is 4, corresponding to a cubic NURBS\n surface. An order of 2, the lowest order, will give a surface\n with linear segments, essentially a mesh.\n\n If the geometry contains primitive attributes, the new surface\n receives the default values for those attributes.\n\n You can move or resize the surface using\n hou.Geometry.transformPrims.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Raises hou.OperationFailed if the number of rows and/or columns is\n invalid.\n\n > # This code will work from inside a Python SOP, but not from the Python\n > # shell.\n > geo = hou.pwd().geometry()\n > \n > # Create a surface with a 10x10 grid of vertices.\n > surf = geo.createNURBSSurface(10, 10)\n > \n > # Initially, the center is at (0, 0, 0), size is (1, 1, 1), on the XY\n > # plane. Scale to (20, 10) and rotate into the XZ plane.\n > geo.transformPrims((surf,),\n > hou.hmath.buildScale((20, 10, 1)) *\n > hou.hmath.buildRotateAboutAxis((1, 0, 0), 90))\n\n See also:\n\n * hou.Geometry.transformPrims\n\n * hou.Matrix4\n\n * hou.hmath\n\n\n \"\"\"\n def createBezierSurface(self, rows: int, cols: int, is_closed_in_u: bool = False, is_closed_in_v: bool = False, order_u: int = 4, order_v: int = 4) -> Surface:\n \"\"\"\n\n createBezierSurface(self, rows, cols, is_closed_in_u=False,\n is_closed_in_v=False) -> hou.Surface\n\n Create a Bezier surface in the XY plane centered at the origin with\n size (1, 1) and return it. You would typically call this method from\n the code of a Python-defined SOP.\n\n\n rows, cols\n Determines the size of the 2D array of vertices defining the\n control points of the surface.\n\n Note that the number of rows corresponds to v and the number or\n columns corresponds to u, which can be slightly confusing. For\n example, geo.createBezierSurface(9, 7, is_closed_in_u=False,\n is_closed_in_v=True) is valid, but geo.createBezierSurface(9, 7,\n is_closed_in_u=True, is_closed_in_v=False) raises\n hou.OperationFailed.\n\n is_closed_in_u, is_closed_in_v\n Determines if it is open or closed in each of the u and v\n directions; see hou.Surface.isClosedInU for more information.\n\n order_u, order_v\n Specifies the surface's order in of the U and V directions. The\n default order for both is 4, corresponding to a cubic NURBS\n surface. An order of 2, the lowest order, will give a surface\n with linear segments, essentially a mesh.\n\n As with Bezier curves, a Bezier surface has some restrictions on the\n point count in each of the U and V directions. For a given\n direction; if it's open the number of points in the direction must\n be (order - 1) * n + 1 for some integer n >= 1 (e.g. 4, 7, 10, ...).\n If it's open, the number of points must be (order - 1) * n where n\n >= 1 in that direction (e.g. 2, 4, 6, .. for order 3).\n\n You can move or resize the surface using\n hou.Geometry.transformPrims.\n\n If the geometry contains primitive attributes, the new surface\n receives the default values for those attributes.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > import math\n > \n > # This code will work from inside a Python SOP, but not from the Python\n > # shell.\n > geo = hou.pwd().geometry()\n > \n > # Build a tube-like object about the y axis.\n > num_rows, num_cols = (10, 9)\n > surf = geo.createBezierSurface(num_rows, num_cols, is_closed_in_u=True)\n > for v_index in range(num_rows):\n > for u_index in range(num_cols):\n > angle = u_index * (2.0 * math.pi) / num_cols\n > surf.vertex(u_index, v_index).point().setPosition(\n > (math.cos(angle), v_index / float(num_cols-1), math.sin(angle)))\n\n \"\"\"\n def createMeshSurface(self, rows: int, cols: int, is_closed_in_u: bool = False, is_closed_in_v: bool = False) -> Surface:\n \"\"\"\n\n createMeshSurface(self, rows, cols, is_closed_in_u=False,\n is_closed_in_v=False) -> hou.Surface\n\n Create a quadrilateral mesh surface in the XY plane centered at the\n origin with size (1, 1) and return it. You would typically call this\n method from the code of a Python-defined SOP.\n\n Note that a mesh object is not the same as a set of polygons\n defining the same shape. A mesh object is a single primitive.\n\n See hou.Geometry.createNURBSSurface for more information.\n\n\n \"\"\"\n def createVolume(self, xres: int, yres: int, zres: int, bounding_box: Optional[BoundingBox] = None) -> Volume:\n \"\"\"\n\n createVolume(self, xres, yres, zres, bounding_box=None) -> hou.Volume\n\n Given the x, y, and z resolution (or size) of a voxel array, add a\n new volume primitive to the geometry and return it. The values in\n the new volume's voxels are all zero.\n\n\n xres, yres, zres\n Integers greater than zero that specify the size of the voxel\n array in one dimension. Raises hou.OperationFailed if any of\n these values are not positive.\n\n bounding_box\n A hou.BoundingBox that specifies the volume's 3D size. Note that\n this size is independent of the volume's voxel resolution. If\n this parameter is None, Houdini uses a bounding box going from\n (-1,-1,-1) to (1,1,1).\n\n\n \"\"\"\n def createChannelPrim(self) -> ChannelPrim:\n \"\"\"\n\n createChannelPrim(self) -> hou.ChannelPrim\n\n Creates and adds a new channel primitive to the geometry and returns\n it. The new channel primitive is initialized to an empty channel.\n\n\n \"\"\"\n def transform(self, matrix: Matrix4) -> None:\n \"\"\"\n\n transform(self, matrix)\n\n Transforms (e.g. rotates, scales, translates, etc.) the geometry by\n a transformation matrix. You would typically call this method from\n the code of a Python-defined SOP.\n\n See hou.hmath for functions that build transformation matrices.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def transformPrims(self, prims: Sequence[Prim]|PrimGroup, matrix: Matrix4) -> None:\n \"\"\"\n\n transformPrims(self, prims, matrix)\n\n Transforms a set of primitives (e.g. rotates, scales, translates,\n etc.) by a transformation matrix. You would typically call this\n method from the code of a Python-defined SOP.\n\n\n prims\n A list of hou.Prim objects or hou.PrimGroup to transform.\n\n matrix\n A hou.Matrix4 to transform with. See hou.hmath functions that\n build transformation matrices.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > import math\n > \n > # This code will work from inside a Python SOP, but not from the Python\n > # shell.\n > \n > def createCircle(geo, num_vertices=10):\n > # Create a closed curve with the specified number of vertices.\n > curve = geo.createNURBSCurve(num_vertices)\n > curve.setIsClosed(True)\n > \n > # Arrange the points into a unit circle on the XZ plane,\n > # centered about the origin.\n > for i, vertex in enumerate(curve.vertices()):\n > angle = i * (2.0 * math.pi) / num_vertices\n > position = (math.cos(angle), 0, math.sin(angle))\n > vertex.point().setPosition(position)\n > return curve\n > \n > # Create a bunch of circles on the XZ plane, tilt them slightly\n > # about X, translate them away from the origin, and rotate each\n > # one about the y axis by a different amount.\n > geo = hou.pwd().geometry()\n > num_copies = 20\n > for i in range(num_copies):\n > curve = createCircle(geo)\n > geo.transformPrims([curve],\n > hou.hmath.buildRotateAboutAxis((1, 0, 0), 30) *\n > hou.hmath.buildTranslate((2, 0, 0)) *\n > hou.hmath.buildRotateAboutAxis((0, 1, 0), i * 360.0 / num_copies))\n\n \"\"\"\n def deletePrims(self, prims: Sequence[Prim]|PrimGroup, keep_points: bool = ...) -> None:\n \"\"\"\n\n deletePrims(self, prims, keep_points=False)\n\n Delete a sequence of primitives. You would typically call this\n method from the code of a Python-defined SOP.\n\n\n prims\n A list of hou.Prim objects or hou.PrimGroup to delete with.\n\n keep_points\n If True, the primitive will be deleted but its points will\n remain.\n\n To delete a single primitive, pass in a sequence with one primitive.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > # Delete every other primitive:\n > prims = [p for p in geo.prims() if p.number() % 2 == 0]\n > geo.deletePrims(prims)\n > \n > # Delete the first primitive:\n > geo.deletePrims([geo.iterPrims()[0]])\n\n \"\"\"\n def deletePrimsOutsideBoundingBox(self, bbox: BoundingBox) -> None:\n \"\"\"\n\n deletePrimsOutsideBoundingBox(self, bbox)\n\n Delete primitives who's bounding boxes are entirely outside of the\n specified bounding box.\n\n Also deletes points associated with the deleted primitives.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def deletePoints(self, points: Iterable[Point]|PointGroup) -> None:\n \"\"\"\n\n deletePoints(self, points)\n\n Delete a sequence of points. You would typically call this method\n from the code of a Python-defined SOP.\n\n Note that Houdini will delete any vertices that reference the point.\n For example, suppose you have a box with 6 polygons, each with 4\n vertices. Also suppose that each point on the box is shared by 3\n vertices on 3 separate polygons. If you delete one of those points,\n Houdini will remove each of those vertices from their corresponding\n polygons, leaving 3 polygons with 4 vertices and 3 polygons with 3\n vertices.\n\n To delete a single primitive, pass in a sequence with one point.\n\n\n points\n A list of hou.Point objects or hou.PointGroup to delete with.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def addAttrib(self, type: EnumValue, name: str, default_value: AttribArgType|AttribDictArgType, transform_as_normal: bool = ..., create_local_variable: bool = ...) -> Attrib:\n '''\n\n addAttrib(self, type, name, default_value, transform_as_normal=False,\n create_local_variable=False) -> hou.Attrib\n\n Create a new point, primitive, vertex, or global (a.k.a. detail)\n attribute. Returns a hou.Attrib object describing the newly created\n attribute. You would typically call this method from the code of a\n Python-defined SOP.\n\n\n type\n A hou.attribType value to specify if the new attribute should be\n a point, primitive, vertex, or global attribute.\n\n name\n The new attribute\\'s name. Each attribute in the geometry must\n have a unique name.\n\n default_value\n The default value for this attribute. When an attribute is\n created, all existing elements (e.g. primitives or points) will\n store this value. As well, elements that you add later will also\n use this value.\n\n This value also determines the attribute\\'s data type.\n\n You can use one of the following Python types:\n\n * int\n\n * float\n\n * str\n\n * sequence (generator, iterator, list, or tuple) of int\n\n * sequence of float\n\n * sequence of str\n\n * dict\n\n * sequence of dict\n\n If the default value is a sequence of integers or floats, the\n sequence size will determine the attribute\\'s size. Otherwise,\n the attribute\\'s size is 1.\n\n String attributes do not support a default value and use this\n value solely for type determination.\n\n transform_as_normal\n This parameter may only be set to True when the default value is\n a sequence of 3 floats. For such attributes, Houdini will not\n modify the attribute values when it transforms (translates,\n rotates, etc.) the geometry. If you want to the attribute to be\n transformed as a vector (such as a normal vector) when Houdini\n transforms the geometry, set this parameter to True.\n\n create_local_variable\n If True, Houdini will create a local variable for this attribute\n that may be used in parameter expressions. The name of the local\n variable is the attribute\\'s name, all in upper case. The mapping\n from attribute names to local variables is stored in a special\n global attribute named \\\\\"varmap\\\\\".\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Raises hou.OperationFailed if an attribute with this name already\n exists. If you are familiar with the C++ Houdini Development Kit\n (HDK), you know that Houdini can support attributes with the same\n name but with different types. However, many SOPs do not let you\n distinguish between attributes that have the same name, and multiple\n attributes with the same name are discouraged. For this reason, you\n cannot create them with this method.\n\n Raises hou.OperationFailed if transform_as_normal is True and the\n default value is not a sequence of 3 floats.\n\n > # Create an integer point attribute of size 1 named \\\\\"population\\\\\", and\n > # create 5 points with attribute values 0, 5, 10, 15, and 20. This code\n > # will work from inside a Python SOP, but not from the Python shell.\n > geo = hou.pwd().geometry()\n > population_attrib = geo.addAttrib(hou.attribType.Point, \\\\\"population\\\\\", 0)\n > for i in range(5):\n > point = geo.createPoint()\n > point.setPosition((i, 0, 0))\n > point.setAttribValue(population_attrib, i * 5)\n\n The following example shows how to copy an existing attribute:\n\n > def copyAttrib(attrib, new_name):\n > return attrib.geometry().addAttrib(\n > attrib.type(), new_name, attrib.defaultValue(), attrib.isTransformedAsNormal())\n\n If create_local_variable is True, this function performs the\n equivalent of the following code:\n\n > def addLocalVariable(geo, attrib_name):\n > \\'\\'\\'Create a geometry attribute and add a local variable for it.\\'\\'\\'\n > # The variable mappings are stored in the varmap attribute\\'s string\n > # table. This table is different than varmap\\'s current value, which\n > # simply refers to an entry in that table. So, to ensure an entry\n > # exists in the table, we simply set varmap\\'s value.\n > map_value = \\\\\"%s -> %s\\\\\" % (attrib_name, attrib_name.upper())\n > if geo.findGlobalAttrib(\\\\\"varmap\\\\\") is None:\n > geo.addAttrib(hou.attribType.Global, \\\\\"varmap\\\\\", \\\\\"\\\\\")\n > geo.setGlobalAttribValue(\\\\\"varmap\\\\\", map_value)\n\n See also:\n\n * hou.Prim.setAttribValue\n\n * hou.Point.setAttribValue\n\n * hou.Prim.setAttribValue\n\n * hou.Geometry.setGlobalAttribValue\n\n * hou.Geometry.setArrayAttrib\n\n\n '''\n def addArrayAttrib(self, type: EnumValue, name: str, data_type: EnumValue, tuple_size: int = 1) -> Attrib:\n \"\"\"\n\n addArrayAttrib(self, type, name, data_type, tuple_size=1) -> hou.Attrib\n\n Create a new point, primitive, vertex, or global (a.k.a. detail)\n array attribute. Returns a hou.Attrib object describing the newly\n created attribute. You would typically call this method from the\n code of a Python-defined SOP.\n\n\n type\n A hou.attribType value to specify if the new attribute should be\n a point, primitive, vertex, or global attribute.\n\n name\n The new attribute's name. Each attribute in the geometry must\n have a unique name.\n\n data_type\n A hou.attribData value to specify if the new attribute should be\n an int, float, or string attribute.\n\n tuple_size\n The new attribute's tuple size.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n Raises hou.OperationFailed if an attribute with this name already\n exists. If you are familiar with the C++ Houdini Development Kit\n (HDK), you know that Houdini can support attributes with the same\n name but with different types. However, many SOPs do not let you\n distinguish between attributes that have the same name, and multiple\n attributes with the same name are discouraged. For this reason, you\n cannot create them with this method.\n\n\n \"\"\"\n def setGlobalAttribValue(self, name_or_attrib: str|Attrib, attrib_value: AttribArgType|AttribDictArgType) -> None:\n '''\n\n setGlobalAttribValue(self, name_or_attrib, attrib_value)\n\n Set a global (a.k.a. detail) attribute value. The attribute may be\n specified by name or by hou.Attrib object. You would typically call\n this method from the code of a Python-defined SOP.\n\n If the attribute is an array attribute, then a sequence of values\n with length divisble by the attribute\\'s tuple size must be passed in\n for attrib_value. Any values at the end of the sequence that do not\n complete a tuple with the desired size are discarded.\n\n Raises hou.OperationFailed if no attribute exists with this name or\n if the attribute\\'s data type does not match the value passed in. If\n the attribute\\'s size is more than 1, the attribute value must be a\n sequence of integers/floats, and the size of the sequence must match\n the attribute\\'s size.\n\n If the attribute is an array, the seqeunce must be a flat array, not\n an array of tuples. If the attribute is float, ensure the python\n objects are float, and not integer (1.0, not 1).\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n > # This code will work from inside a Python SOP, but not from the Python\n > # shell.\n > geo = hou.pwd().geometry()\n > geo.addAttrib(hou.attribType.Global, \\\\\"author\\\\\", \\\\\"\\\\\")\n > geo.addAttrib(hou.attribType.Global, \\\\\"version\\\\\", (0, 0, 0))\n > geo.setGlobalAttribValue(\\\\\"author\\\\\", \\\\\"Joe\\\\\")\n > geo.setGlobalAttribValue(\\\\\"version\\\\\", (1, 0, 7))\n\n Here is an example for setting values in a global array attribute:\n\n > geo = hou.pwd().geometry()\n > geo.addArrayAttrib(\n > hou.attribType.Global, \\\\\"data\\\\\", hou.attribData.Float, tuple_size=3)\n > \n > # This will set the global attribute\\'s value to \n > # [(1.0, 2.0, 3.0), (4.0, 5.0, 6.0)].\n > geo.setGlobalAttribValue(\\\\\"data\\\\\", [1.0, 2.0, 3.0, 4.0, 5.0, 6.0])\n\n See also:\n\n * hou.Geometry.attribValue\n\n * hou.Point.setAttribValue\n\n * hou.Prim.setAttribValue\n\n * hou.Vertex.setAttribValue\n\n\n '''\n def copyAttrib(self, attrib: Attrib) -> None:\n \"\"\"\n\n copyAttribs(self, attribs)\n\n Copy a list of attributes hou.Attrib from another geometry.\n Attributes with the same name and right context must exist on the\n current geometry. Raises OperationFailed on failure describing the\n error condition in detail.\n\n\n \"\"\"\n def copyAttribs(self, attribs: Sequence[Attrib]) -> None: ...\n def copy(self, geometry: Geometry, clone_data_ids: bool = False, prims: Optional[Selection] = None) -> None:\n \"\"\"\n\n copy(self, geometry, clone_data_ids=False, prims=None)\n\n Copy the points and primitives from another hou.Geometry object into\n this one. This is faster than doing a clear() and a merge() as it\n avoid reallocating attributes and primitives. You would typically\n call this method from the code of a Python-defined SOP.\n\n When merging into an empty Geometry object, clone_data_ids specifies\n whether the resulting attributes will have the same data ids. This\n is useful to enable optimizations that cache data by only looking at\n the attribute data id regardless of whether it is from the same\n geometry object or not. Otherwise, the copied attributes will have\n data ids that are unique.\n\n The optional parameter is hou.Selection that gives a more\n precise subset of primitives to copy from.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.loadFromFile.\n\n\n \"\"\"\n def copyPoints(self, geometry: Geometry, points: Optional[PointGroup] = None) -> None:\n \"\"\"\n\n copyPoints(self, geometry, points=None)\n\n Copy a group of points from another hou.Geometry object into this\n one.\n\n\n geometry\n The hou.Geometry to copy.\n\n points\n The hou.PointGroup to copy. Raises hou.OperationFailed if\n geometry does not contain the points group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.copy.\n\n\n \"\"\"\n def copyPrims(self, geometry: Geometry, prims: Optional[PrimGroup] = None) -> None:\n \"\"\"\n\n copyPrims(self, geometry, prims=None)\n\n Copy a group of primitives from another hou.Geometry object into\n this one.\n\n\n geometry\n The hou.Geometry to copy.\n\n prims\n The hou.PrimGroup to copy. Raises hou.OperationFailed if\n geometry does not contain the prims group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.copy.\n\n\n \"\"\"\n def copyEdges(self, geometry: Geometry, edges: Optional[EdgeGroup] = None) -> None:\n \"\"\"\n\n copyEdges(self, geometry, edges=None)\n\n Copy a group of edges from another hou.Geometry object into this\n one. Each edge copied as a separate two-point line segment.\n\n\n geometry\n The hou.Geometry to copy.\n\n edges\n The hou.EdgeGroup to copy. Raises hou.OperationFailed if\n geometry does not contain the edges group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.copy.\n\n\n \"\"\"\n def attribValue(self, name_or_attrib: str|Attrib) -> AttribReturnType|AttribDictReturnType:\n \"\"\"\n\n attribValue(self, name_or_attrib) -> int, float, str, tuple or dict\n\n Return the global (a.k.a. detail) attribute value for a particular\n attribute. The attribute may be specified by name or by hou.Attrib\n object.\n\n Raises hou.OperationFailed if no attribute exists with this name.\n\n\n \"\"\"\n def attributeCaptureRegions(self) -> Tuple[str, ...]:\n \"\"\"\n\n attributeCaptureRegions(self) -> tuple of str\n\n Returns a tuple of strings representing the capture region paths for\n this geometry. The capture regions are identified from the\n geometry's capture attributes.\n\n See also:\n\n * hou.Geometry.attributeCaptureObjectPaths\n\n\n \"\"\"\n def attributeCaptureObjectPaths(self) -> Tuple[str, ...]:\n \"\"\"\n\n attributeCaptureObjectPaths(self) -> tuple of str\n\n Returns a tuple of strings representing the capture object paths for\n this geometry. The capture objects are those used to capture this\n geometry and are identified from the geometry's capture attributes.\n The skeleton root path is prepended to the capture object paths and\n the object nodes are given by:\n\n > # This code will work from inside a Python SOP, but not from the Python\n > # shell.\n > geo = hou.pwd().geometry()\n > nodes = [hou.node(x) for x in geo.attributeCaptureObjectPaths()]\n\n See also:\n\n * hou.Geometry.attributeCaptureRegions\n\n\n \"\"\"\n def intrinsicNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n intrinsicNames(self) -> tuple of str\n\n Returns a tuple of strings representing the intrinsic values\n available for this geometry. Different geometry types will have\n different intrinsic values available. You can then get or set the\n value using intrinsicValue and/or setIntrinsicValue.\n\n See the intrinsicValue method for more information.\n\n\n \"\"\"\n def intrinsicValue(self, intrinsic_name: str) -> AttribReturnType:\n \"\"\"\n\n intrinsicValue(self, intrinsic_name) -> int, float, str, or tuple\n\n Gets the value of an intrinsic, often computed, value of the\n geometry, such as memoryusage, pointcount, pointattributes, and so\n on. Raises OperationFailed if the given intrinsic name does not\n exist.\n\n You can also view these values in the user interface using the\n geometry spreadsheet.\n\n In Houdini, some primitives have intrinsic values which can't be\n accessed directly through the attribute interface. Most intrinsic\n values are computed, such as measuredarea, however a few are\n writeable with the setIntrinsicValue method. For example, sphere\n primitives have a transform matrix as part of their definition.\n\n You can get a list of the available intrinsic value names with the\n intrinsicNames method. Different geometry types will have different\n intrinsic values available.\n\n Bounding box intrinsic values like bounds are returned in (xmin,\n xmax, ymin, ymax, zmin, zmax) order.\n\n\n \"\"\"\n def intrinsicSize(self, intrinsic_name: str) -> int: ...\n def intrinsicReadOnly(self, intrinsic_name: str) -> bool: ...\n def setIntrinsicValue(self, intrinsic_name: str, value: AttribArgType) -> None:\n \"\"\"\n\n setIntrinsicValue(self, intrinsic_name, value)\n\n Some intrinsic values can be modified. For example, you change the\n internal size and rotation (transform) of a sphere primitive by\n passing a 16 float tuple representing the transform to\n setIntrinsicValue. Raises Error if the intrinsic is not writeable or\n does not accept the passed value, or if the given intrinsic name\n does not exist.\n\n\n NOTE\n Modifying the geometry directly will lock the geometry's parent\n node.\n\n See the intrinsicValue method for more information.\n\n\n \"\"\"\n def data(self) -> bytes:\n '''\n\n data(self) -> bytes\n\n Return the geometry data in bgeo format.\n\n For example:\n\n > geometry = hou.node(\\\\\"/obj/geo1/torus1\\\\\").geometry()\n > bgeo_data = geometry.data()\n > open(\\\\\"/tmp/torus.bgeo\\\\\", \\\\\"wb\\\\\").write(bgeo_data)\n\n '''\n def load(self, data: bytes) -> None:\n '''\n\n load(self, data)\n\n Loads a bgeo bytes into this object.\n\n For example:\n\n > torus = hou.node(\\\\\"/obj/geo1/torus1\\\\\").geometry()\n > bgeo_data = torus.data()\n > \n > geometry = hou.Geometry()\n > geometry.load(bgeo_data)\n\n '''\n def saveToFile(self, file_name: str) -> None:\n \"\"\"\n\n saveToFile(self, file_name)\n\n Save the contents of the geometry object to a file. The file\n extension determines what file format to use.\n\n All file formats supported by Houdini (e.g. geo, bgeo, obj, etc.),\n including extensions listed in GEOio, are supported. If the file\n extension is not recognized, the bgeo format is used.\n\n Raises hou.OperationFailed if the path to the file is invalid or\n there were permission or other I/O errors.\n\n\n \"\"\"\n def loadFromFile(self, file_name: str) -> None:\n \"\"\"\n\n loadFromFile(self, file_name)\n\n Replace the contents of this geometry object with the data stored in\n a file. You would typically call this method from the code of a\n Python-defined SOP.\n\n You may specify any type of file supported by Houdini's File SOP.\n See hou.Geometry.saveToFile for more information.\n\n Raises hou.OperationFailed if the file does not exist or otherwise\n cannot be loaded.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.merge.\n\n\n \"\"\"\n def merge(self, geometry: Geometry, clone_data_ids: bool = False, prims: Optional[Selection] = None) -> None:\n \"\"\"\n\n merge(self, geometry, clone_data_ids=False, prims=None)\n\n Merge the points and primitives from another hou.Geometry object\n into this one. The new points and primitives are appended to this\n geometry's points and primitives. You would typically call this\n method from the code of a Python-defined SOP.\n\n When merging into an empty Geometry object, clone_data_ids specifies\n whether the resulting attributes will have the same data ids. This\n is useful to enable optimizations that cache data by only looking at\n the attribute data id regardless of whether it is from the same\n geometry object or not. Otherwise, the copied attributes will have\n data ids that are unique.\n\n The optional parameter is hou.Selection that gives a more\n precise subset of primitives to merge from.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.loadFromFile.\n\n\n \"\"\"\n def mergePoints(self, geometry: Geometry, points: Optional[PointGroup] = None) -> None:\n \"\"\"\n\n mergePoints(self, geometry, points=None)\n\n Merge a group of points from another hou.Geometry object into this\n one. The new points are appended to this geometry's points.\n\n\n geometry\n The hou.Geometry to merge.\n\n points\n The hou.PointGroup to merge. Raises hou.OperationFailed if\n geometry does not contain the points group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.merge.\n\n\n \"\"\"\n def mergePrims(self, geometry: Geometry, prims: Optional[PrimGroup] = None) -> None:\n \"\"\"\n\n mergePrims(self, geometry, prims=None)\n\n Merge a group of primitives from another hou.Geometry object into\n this one. The new points and primitives are appended to this\n geometry's points and primitives.\n\n\n geometry\n The hou.Geometry to merge.\n\n prims\n The hou.PrimGroup to merge. Raises hou.OperationFailed if\n geometry does not contain the prims group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.merge.\n\n\n \"\"\"\n def mergeEdges(self, geometry: Geometry, edges: Optional[EdgeGroup] = None) -> None:\n \"\"\"\n\n mergeEdges(self, geometry, edges=None)\n\n Merge a group of edges from another hou.Geometry object into this\n one. The new points are appended to this geometry's points. Each\n edge merged as a separate two-point line segment.\n\n\n geometry\n The hou.Geometry to merge.\n\n edges\n The hou.EdgeGroup to merge. Raises hou.OperationFailed if\n geometry does not contain the edges group.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n See also hou.Geometry.merge.\n\n\n \"\"\"\n def clear(self) -> None:\n \"\"\"\n\n clear(self)\n\n Remove everything from this geometry object. The geometry will have\n no points or primitives after calling this method.\n\n Raises hou.GeometryPermissionError if this geometry is not\n modifiable.\n\n\n \"\"\"\n def intersect(self, rayorig: Vector3, dir: Vector3, p: Vector3, n: Vector3, uvw: Vector3, pattern: Optional[str] = None, min_hit: float = 0.01, max_hit: float = 1e+18, tolerance: float = 0.01) -> int:\n '''\n\n intersect(self, ray_origin, ray_direction, position_out, normal_out,\n uvw_out, pattern=None, min_hit=0.01, max_hit=1E18, tolerance=0.01) ->\n int\n\n Determines the intersection point of a ray with the geometry in this\n object.\n\n\n NOTE\n This method is unusual in that instead of returning multiple\n pieces of information about the intersection, it requires that\n you pass it objects which it modifies in-place with the\n information.\n\n > # Get some geometry from a SOP node\n > geometry = hou.node(\\\\\"/obj/geo1/sphere1\\\\\").geometry()\n > # Shoot a ray from high up in the \\\\\"sky\\\\\" straight down at the origin\n > origin = hou.Vector3(0, 100, 0)\n > direction = hou.Vector3(0, -1, 0)\n > # Make objects for the intersect() method to modify\n > position = hou.Vector3()\n > normal = hou.Vector3()\n > uvw = hou.Vector3()\n > # Find the first intersection (if it exists)\n > did_intersect = geometry.intersect(origin, direction, position, normal, uvw)\n\n Returns the ID number of the hit primitive if the ray intersected\n the geometry, or -1 if the ray did not hit.\n\n\n ray_origin\n A hou.Vector3 object representing the starting point of the ray\n in world space.\n\n ray_direction\n A hou.Vector3 object representing the direction vector of the\n ray.\n\n position_out\n Pass a hou.Vector3 object to this argument. The method will\n change the object\\'s values to represent the intersection\n position in world space.\n\n normal_out\n Pass a hou.Vector3 object to this argument. The method will\n change the object\\'s values to represent the normal direction\n from the surface to the ray.\n\n uvw_out\n Pass a hou.Vector3 object to this argument. The method will\n change the object\\'s values to represent the UVW position within\n the intersecting primitive where the ray hit.\n\n pattern\n If you pass a string containing primitive group syntax, the ray\n can only intersect primitives that match the pattern.\n\n min_hit\n Ignore intersections closer than this distance. You can use the\n min_hit argument to iterate through all possible hits along the\n ray, by setting the min_hit a tiny bit farther than the previous\n hit.\n\n > hit_positions = []\n > prev_dist = 0.01\n > while geometry.intersect(origin, direction, position, normal, uvw,\n > min_hit=prev_dist):\n > # Make sure to store a *copy* of the position, not the object\n > # that is being modified in each iteration of the loop\n > hit_positions.append(hou.Vector3(position))\n > prev_dist = origin.distanceTo(position) + 0.01\n\n max_hit\n Ignore intersections farther than this distance.\n\n tolerance\n Use this parameter to adjust the accuracy of intersections. If\n the ray approaches the geometry within the tolerance value, an\n intersection hit is assumed. A 0.01 tolerance (default) gives\n strict intersections while larger values produces less accurate\n intersections.\n\n\n '''\n def pointGroups(self, scope: EnumValue = ...) -> Tuple[PointGroup,...]:\n \"\"\"\n\n pointGroups(self, scope=hou.groupScope.Public) -> tuple of\n hou.PointGroup\n\n Return a tuple of all the point groups in the geometry.\n\n\n scope\n A hou.groupScope value to specify whether the public or private\n groups should be listed.\n\n The following function returns the names of all the groups in the\n geometry:\n\n > def pointGroupNames(geometry):\n > return [group.name() for group in geometry.pointGroups()]\n\n \"\"\"\n def findPointGroup(self, name: str, scope: EnumValue = ...) -> PointGroup|None:\n \"\"\"\n\n findPointGroup(self, name, scope=hou.groupScope.Public) ->\n hou.PointGroup or None\n\n Return the point group with the given name, or None if no such group\n exists.\n\n\n name\n The name of the point group.\n\n scope\n A hou.groupScope value to specify whether the group is public or\n private.\n\n\n \"\"\"\n def createPointGroup(self, name: str, is_ordered: bool = False, unique_name: bool = False) -> PointGroup:\n \"\"\"\n\n createPointGroup(self, name, is_ordered=False, unique_name=False) ->\n hou.PointGroup\n\n Create a new point group in this geometry.\n\n\n name\n The name of the new group. Raises hou.OperationFailed if a group\n with this name already exists.\n\n is_ordered\n Whether or not the new group should be ordered. See\n hou.PointGroup for more information about ordered groups.\n\n unique_name\n By default, an exception is thrown if the given group already\n exists. If is set to True, then the name will\n instead be modified to a non-existing name based on .\n\n Use hou.PointGroup.destroy to remove a point group from the\n geometry.\n\n\n NOTE\n Group names cannot start with a digit and can only contain\n alphanumeric characters or underscores.\n\n\n \"\"\"\n def primGroups(self, scope: EnumValue = ...) -> Tuple[PrimGroup,...]:\n \"\"\"\n\n primGroups(self, scope=hou.groupScope.Public) -> tuple of hou.PrimGroup\n\n Return a tuple of all the primitive groups in the geometry.\n\n\n scope\n A hou.groupScope value to specify whether the public or private\n groups should be listed.\n\n\n \"\"\"\n def findPrimGroup(self, name: str, scope: EnumValue = ...) -> PrimGroup|None:\n \"\"\"\n\n findPrimGroup(self, name, scope=hou.groupScope.Public) -> hou.PrimGroup\n or None\n\n Return the primitive group with the given name, or None if no such\n group exists.\n\n\n name\n The name of the primitive group.\n\n scope\n A hou.groupScope value to specify whether the group is public or\n private.\n\n\n \"\"\"\n def createPrimGroup(self, name: str, is_ordered: bool = False, unique_name: bool = False) -> PrimGroup:\n \"\"\"\n\n createPrimGroup(self, name, is_ordered=False, unique_name=False) ->\n hou.PrimGroup\n\n Create a new primitive group in this geometry.\n\n\n name\n The name of the new group. Raises hou.OperationFailed if a group\n with this name already exists.\n\n is_ordered\n Whether or not the new group should be ordered. See\n hou.PrimGroup for more information about ordered groups.\n\n unique_name\n By default, an exception is thrown if the given group already\n exists. If is set to True, then the name will\n instead be modified to a non-existing name based on .\n\n Use hou.PrimGroup.destroy to remove a primitive group from the\n geometry.\n\n\n NOTE\n Group names cannot start with a digit and can only contain\n alphanumeric characters or underscores.\n\n\n \"\"\"\n def edgeGroups(self, scope: EnumValue = ...) -> Tuple[EdgeGroup,...]:\n \"\"\"\n\n edgeGroups(self, scope=hou.groupScope.Public) -> tuple of hou.EdgeGroup\n\n Return a tuple of all the edge groups in the geometry.\n\n\n scope\n A hou.groupScope value to specify whether the public or private\n groups should be listed.\n\n\n \"\"\"\n def findEdgeGroup(self, name: str, scope: EnumValue = ...) -> EdgeGroup|None:\n \"\"\"\n\n findEdgeGroup(self, name, scope=hou.groupScope.Public) -> hou.EdgeGroup\n or None\n\n\n name\n The name of the edge group.\n\n scope\n A hou.groupScope value to specify whether the group is public or\n private.\n\n Return the edge group with the given name, or None if no such group\n exists.\n\n\n \"\"\"\n def createEdgeGroup(self, name: str) -> EdgeGroup:\n \"\"\"\n\n createEdgeGroup(self, name) -> hou.EdgeGroup\n\n Create a new edge group in this geometry.\n\n\n name\n The name of the new group. Raises hou.OperationFailed if a group\n with this name already exists.\n\n Use hou.EdgeGroup.destroy to remove an edge group from the geometry.\n\n\n \"\"\"\n def vertexGroups(self, scope: EnumValue = ...) -> Tuple[VertexGroup,...]:\n \"\"\"\n\n vertexGroups(self, scope=hou.groupScope.Public) -> tuple of\n hou.VertexGroup\n\n Return a tuple of all the vertex groups in the geometry.\n\n\n scope\n A hou.groupScope value to specify whether the public or private\n groups should be listed.\n\n The following function returns the names of all the groups in the\n geometry:\n\n > def vertexGroupNames(geometry):\n > return [group.name() for group in geometry.vertexGroups()]\n\n \"\"\"\n def findVertexGroup(self, name: str, scope: EnumValue = ...) -> VertexGroup|None:\n \"\"\"\n\n findVertexGroup(self, name, scope=hou.groupScope.Public) ->\n hou.VertexGroup or None\n\n Return the vertex group with the given name, or None if no such\n group exists.\n\n\n name\n The name of the vertex group.\n\n scope\n A hou.groupScope value to specify whether the group is public or\n private.\n\n\n \"\"\"\n def createVertexGroup(self, name: str, is_ordered: bool = False) -> VertexGroup:\n \"\"\"\n\n createVertexGroup(self, name, is_ordered=False) -> hou.VertexGroup\n\n Create a new vertex group in this geometry.\n\n\n name\n The name of the new group. Raises hou.OperationFailed if a group\n with this name already exists.\n\n is_ordered\n Whether or not the new group should be ordered. See\n hou.VertexGroup for more information about ordered groups.\n\n Use hou.VertexGroup.destroy to remove a vertex group from the\n geometry.\n\n\n \"\"\"\n def findEdge(self, p0: Point, p1: Point) -> Optional[Edge]:\n \"\"\"\n\n findEdge(self, p0, p1) -> hou.Edge\n\n\n p0\n The first point that makes up the edge. See hou.Point for more\n information.\n\n p1\n The second point that makes up the edge. See hou.Point for more\n information.\n\n finds an edge given two points, or None if no such edge exists\n\n\n \"\"\"\n def boundingBox(self, transform: Optional[Matrix4] = None) -> BoundingBox:\n \"\"\"\n\n boundingBox(self, transform=None) -> hou.BoundingBox\n\n Return an axis-aligned 3D bounding box (of optionally transformed\n instantiation) that is sized and positioned to be large enough to\n hold this geometry.\n\n\n transform\n A hou.Matrix4 that transforms the geometry instance. Does not\n change the original geometry.\n\n\n \"\"\"\n def pointBoundingBox(self, ptgroup: str) -> BoundingBox:\n \"\"\"\n\n pointBoundingBox(self, pointpattern) -> hou.BoundingBox\n\n Return an axis-aligned 3D bounding box that is sized and positioned\n to include the points specified by the point pattern. If the pattern\n is blank, all points will be included.\n\n Some primitives, such as spheres, extend beyond their points. This\n extension will not be included.\n\n\n \"\"\"\n def primBoundingBox(self, primgroup: str) -> BoundingBox:\n \"\"\"\n\n primBoundingBox(self, primpattern) -> hou.BoundingBox\n\n Return an axis-aligned 3D bounding box that is sized and positioned\n to include the primitives specified by the primitive pattern. If the\n pattern is blank, all primitives will be included.\n\n Some primitives, such as spheres, extend beyond their points. This\n extension will be included.\n\n\n \"\"\"\n def orientedBoundingBox(self) -> OrientedBoundingBox:\n \"\"\"\n\n orientedBoundingBox(self) -> hou.orientedBoundingBox\n\n Return an oriented 3D bounding box that is sized and positioned to\n be large enough to hold this geometry.\n\n\n \"\"\"\n def orientedPointBoundingBox(self, ptgroup: str) -> OrientedBoundingBox:\n \"\"\"\n\n orientedPointBoundingBox(self, pointpattern) -> hou.OrientedBoundingBox\n\n Return an oriented 3D bounding box that is sized and positioned to\n include the points specified by the point pattern. If the pattern is\n blank, all points will be included.\n\n Note oriented bounding boxes only use point locations, not the\n extents of primitives.\n\n\n \"\"\"\n def orientedPrimBoundingBox(self, primgroup: str) -> OrientedBoundingBox:\n \"\"\"\n\n orientedPrimBoundingBox(self, primpattern) -> hou.OrientedBoundingBox\n\n Return an oriented 3D bounding box that is sized and positioned to\n include the primitives specified by the primitive pattern. If the\n pattern is blank, all primitives will be included.\n\n Note oriented bounding boxes only use point locations, not the\n extents of primitives.\n\n\n \"\"\"\n def nearestPrim(self, position: Sequence[float]) -> Tuple[Prim, float, float, float]:\n \"\"\"\n\n nearestPrim(self, position) -> (hou.Prim or None, float, float, float)\n\n Given a sequence of three floats containing a position, find the\n location on the primitive closest to that position and return a\n tuple containing that primitive, the u value on the primitive, the v\n value on the primitive, and the distance to the primitive.\n\n Note that the first value in the return tuple can be None if there\n are no primitives in the geometry.\n\n NOTE: The returned UVs are in real coordinates, use the\n hou.Prim.primuvConvert to switch to unit coordinates to match VEX's\n xyzdist.\n\n\n \"\"\"\n def nearestPoint(self, position: Sequence[float], ptgroup: Optional[str] = None, max_radius: float = 1e+18) -> Optional[Point]:\n \"\"\"\n\n nearestPoint(self, position, ptgroup=None, max_radius=1E18) -> hou.Point\n or None\n\n Given a sequence of three floats containing a query position, find\n the closest point in the geometry to that position within\n max_radius.\n\n If ptgroup is a string group pattern, then the search will be\n restricted to the points specified.\n\n Note that None is returned when there are no points in the geometry.\n\n See also: hou.nearestPoints\n\n\n \"\"\"\n def nearestPoints(self, position: Sequence[float], max_points: int, ptgroup: Optional[str] = None, max_radius: float = 1e+18) -> Tuple[Point, ...]:\n \"\"\"\n\n nearestPoints(self, position, max_points, ptgroup=None, max_radius=1E18)\n -> tuple of hou.Point\n\n Given a sequence of three floats containing a query position, find\n the closest max_points in the geometry to that position within\n max_radius.\n\n If ptgroup is a string group pattern, then the search will be\n restricted to the points specified.\n\n Note that None is returned when there are no points in the geometry.\n\n See also: hou.nearestPoint\n\n\n \"\"\"\n def primLoop(self, prims: Sequence[Prim], loop_type: EnumValue) -> Tuple[Prim,...]:\n \"\"\"\n\n primLoop(self, prims, loop_type) -> tuple of hou.Prim\n\n Returns a tuple of hou.Prim objects that make a path connecting the\n primitives provided in the prims parameter. If multiple paths are\n being returned, they will be separated in the single returned tuple\n by a value of None. The paths are generated using the same algorithm\n used when performing loop selections in the viewport.\n\n prims: A list of hou.Prim objects that define the path or paths of\n connected primitives this function should return. Must contain at\n least two primitives.\n\n loop_type: Controls the type of path returned. Can be any of the\n hou.componentLoopType values. If using either the\n hou.componentLoopType.Extended or hou.componentLoopType.Closed loop\n types, the inputs prims cannot contain any None entries.\n Furthermore, each pair of primitives is used to define a separate\n full loop, so the number of primitives must be even. If these\n conditions are not met, a hou.OperationFailed exception will be\n thrown.\n\n Raises a hou.OperationFailed if it was unable to construct a loop\n from the desired components.\n\n\n \"\"\"\n def pointLoop(self, points: Sequence[Point], loop_type: EnumValue) -> Tuple[Point,...]:\n \"\"\"\n\n pointLoop(self, points, full_loop) -> tuple of hou.Point\n\n Returns a tuple of hou.Point objects that make a path connecting the\n points provided in the points parameter. If multiple paths are being\n returned, they will be separated in the single returned tuple by a\n value of None. The paths are generated using the same algorithm used\n when performing loop selections in the viewport.\n\n points: A list of hou.Point objects that define the path or paths of\n connected points this function should return. Must contain at least\n two points.\n\n loop_type: Controls the type of path returned. Can be any of the\n hou.componentLoopType values. If using either the\n hou.componentLoopType.Extended or hou.componentLoopType.Closed loop\n types, the inputs points cannot contain any None entries.\n Furthermore, each pair of points is used to define a separate full\n loop, so the number of points must be even. If these conditions are\n not met, a hou.OperationFailed exception will be thrown.\n\n Raises a hou.OperationFailed if it was unable to construct a loop\n from the desired components.\n\n\n \"\"\"\n def edgeLoop(self, edges: Sequence[Edge], loop_type: EnumValue, full_loop_per_edge: bool, force_ring: bool, allow_ring: bool) -> Tuple[Edge,...]:\n \"\"\"\n\n edgeLoop(self, edges, loop_type, full_loop_per_edge, force_ring,\n allow_ring) -> tuple of hou.Edge\n\n Returns a tuple of hou.Edge objects that make a path connecting the\n edges provided in the edges parameter. If multiple paths are being\n returned, they will be separated in the single returned tuple by a\n value of None. The paths are generated using the same algorithm used\n when performing loop selections in the viewport.\n\n edges: A list of hou.Edge objects that define the path or paths of\n connected edges this function should return. Must contain at least\n one or two edges depending on the loop options.\n\n loop_type: Controls the type of path returned. Can be any of the\n hou.componentLoopType values. If using either the\n hou.componentLoopType.Extended or hou.componentLoopType.Closed loop\n types, the inputs edges cannot contain any None entries. If these\n conditions are not met, a hou.OperationFailed exception will be\n thrown.\n\n full_loop_per_edge: If set to True, with the loop_type set to\n hou.componentLoopType.Extended or hou.componentLoopType.Closed loop\n types, each inputs edge is used to create its own full loop or ring.\n If False, the edges are taken in pairs, and so the number of edges\n must be even.\n\n force_ring: If set to True, this function will return edge rings\n instead of edge loops.\n\n allow_ring: If set to True, this function may return an edge ring if\n the edges provided produce a ring more naturally than they produce a\n loop (for example if two perpendicular edges are provided from the\n same row on a polygonal grid). If set to False, only edge loops will\n be returned.\n\n Raises a hou.OperationFailed if it was unable to construct a loop\n from the desired components.\n\n\n \"\"\"\n def pointNormals(self, points: Sequence[Point]|PointGroup) -> Sequence[Vector3]:\n \"\"\"\n\n pointNormals(self, points) -> tuple of hou.Vector3\n\n Returns a tuple of hou.Vector3 objects representing the point\n normals for the supplied points.\n\n\n points\n A list of hou.Point objects or hou.PointGroup for which to\n compute point normals.\n\n\n \"\"\"\n def importLop(self, lopnode: LopNode, selectionrule: LopSelectionRule, purpose: str|None = ..., traversal: str|None = ..., path_attrib_name: str|None = ..., name_attrib_name: str|None = ..., strip_layers: bool = ..., frame: float|None = ...) -> LopLockedStage:\n \"\"\"\n\n importLop(self, lopnode, selectionrule, purpose=None, traversal=None,\n path_attrib_name=None, name_attrib_name=None, strip_layers=False,\n frame=None, lop_output_index=-1) -> hou.LopLockedStage\n\n Imports primitives from the stage of the specified LOP as packed\n primitives.\n\n Returns a hou.LopLockedStage object which should be kept in scope\n for as long as this geometry object contains packed primitives\n created by this method. Allowing this hou.LopLockedStage object to\n be destroyed will prevent the USD packed primitives from being\n displayed or unpacked.\n\n Primitives are selected according to the hou.LopSelectionRule.\n\n When a purpose is specified, only primitives with that purpose are\n imported.\n\n When a traversal method is specified, the children of primitives\n specified by the hou.LopSelectionRule will be traversed using the\n specified traversal. Possible values are, for example std:component,\n std:boundables, std:groups.\n\n When a path_attrib_name is given, the path of each LOP primitive is\n stored in an attribute of that name.\n\n When a name_attrib_name is given, the name of each LOP primitive is\n stored in an attribute of that name.\n\n If strip_layers is True, any layers preceding a Layer Break node\n connected directly or indirectly to the requested LOP node will be\n stripped from the USD stage before importing the stage. This can be\n useful if a Layer Break is being used to keep data that may be\n modified (added after the Layer Break node) separate from primitives\n that should not be modified (added to the stage before the Layer\n Break node).\n\n If frame is given, the LOP will be evaluated at that specific\n sample. If left at None, the current evaluation time sample will be\n used instead.\n\n The lop_output_index specifies which output of a multi-output LOP to\n inspect. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n\n \"\"\"\n def importUsdStage(self, stage: pxr.Usd.Stage, selectionrule: LopSelectionRule, purpose: str|None = ..., traversal: str|None = ..., path_attrib_name: str|None = ..., name_attrib_name: str|None = ..., frame: float|None = ...) -> None:\n \"\"\"\n\n importUsdStage(self, stage, selectionrule, purpose=None, traversal=None,\n path_attrib_name=None, name_attrib_name=None, frame=None)\n\n Imports primitives from a USD Stage as packed primitives.\n\n The USD Stage should be kept in scope for as long as this geometry\n object contains packed primitives created by this method. Allowing\n the Stage object to be destroyed may prevent the USD packed\n primitives from being displayed or unpacked.\n\n Primitives are selected according to the hou.LopSelectionRule.\n\n When a purpose is specified, only primitives with that purpose are\n imported.\n\n When a traversal method is specified, the children of primitives\n specified by the hou.LopSelectionRule will be traversed using the\n specified traversal. Possible values are, for example std:component,\n std:boundables, std:groups.\n\n When a path_attrib_name is given, the path of each LOP primitive is\n stored in an attribute of that name.\n\n When a name_attrib_name is given, the name of each LOP primitive is\n stored in an attribute of that name.\n\n If frame is given, time samples from the stage will be extracted for\n the requested sample. If left at None, Houdini's current evaluation\n time sample will be used instead.\n\n\n \"\"\"\n def selection(self) -> Selection:\n \"\"\"\n\n selection(self) -> hou.Selection\n\n Returns the current cook component selection associated with this\n geometry. This is the default selection set by the SOP that created\n the geometry.\n\n\n \"\"\"\n def vexAttribDataId(self) -> Tuple[int, ...]:\n '''\n\n vexAttribDataId(self) -> tuple of int\n\n Return the same list of integers that the attribdataid() VEX\n function returns when calling attribdataid(geo, \\\\\"meta\\\\\", \\\\\"detail\\\\\").\n It is an identifier that can be used as a conservative check whether\n there are any modifications to this object. The value of\n hou.Geometry.modificationCounter is included in the return value.\n\n\n '''\n def modificationCounter(self) -> int:\n \"\"\"\n\n modificationCounter(self) -> int or long\n\n Return a counter that can be used as a conservative check to\n determine if changes have been made to this object. Note that this\n counter is not unique across different hou.Geometry objects. To\n compare these values across different geometries, use\n hou.Geometry.vexAttribDataId instead.\n\n\n \"\"\"\n def incrementModificationCounter(self) -> None:\n \"\"\"\n\n incrementModificationCounter(self)\n\n Increment the modification counter to mark this object as having its\n contents modified.\n\n\n \"\"\"\n def incrementAllDataIds(self) -> None:\n \"\"\"\n\n incrementAllDataIds(self)\n\n Increment all data ids on attributes in this geometry. Use this as\n an easy way to mark that everything in this geometry has changed.\n Internally, this also calls\n hou.Geometry.incrementModificationCounter.\n\n\n \"\"\"\n def incrementDataIdsForAddOrRemove(self, for_points: bool = True, for_prims: bool = True) -> None:\n \"\"\"\n\n incrementDataIdsForAddOrRemove(self, for_points=True, for_prims=True)\n\n Increment data ids which indicate that points and/or primitives have\n been added or removed.\n\n\n \"\"\"\n def primitiveIntrinsicsDataId(self) -> AttribDataId:\n \"\"\"\n\n primitiveIntrinsicsDataId(self)\n\n Returns the data id that represents the contents of primitives,\n excluding primitive attributes. Note that this data id is also\n incremented whenever the number of primitives changes as well.\n\n\n \"\"\"\n def incrementPrimitiveIntrinsicsDataId(self) -> None:\n \"\"\"\n\n incrementPrimitiveIntrinsicsDataId(self)\n\n Increment the primitive intrinsics data id to indicate that the\n contents of primitives have changed, excluding primitive attributes.\n\n\n \"\"\"\n def topologyDataId(self) -> AttribDataId:\n \"\"\"\n\n topologyDataId(self)\n\n Returns the data id that represents the topology of this geometry\n such as when points are wired to primitives.\n\n\n \"\"\"\n def incrementTopologyDataId(self) -> None:\n \"\"\"\n\n incrementTopologyDataId(self)\n\n Increment data ids to indicate that topology in this geometry has\n changed in some way.\n\n\n \"\"\"\n def generateAttribMenu(self, attrib_type: EnumValue|None = ..., data_type: EnumValue|None = ..., min_size: int = ..., max_size: int = ..., array_type: bool = ..., scalar_type: bool = ..., case_sensitive: bool = ..., pattern: str = ..., decode_tokens: bool = ...) -> Tuple[str,...]:\n '''\n\n generateAttribMenu(self, attrib_type=None, data_type=None, min_size=1,\n max_size=-1, array_type=True, scalar_type=True, case_sensitive=True,\n pattern=\\\\\"*\\\\\", decode_tokens=False) -> tuple of str\n\n Generates the tokens and labels for a parameter menu listing the\n geometry\\'s attributes.\n\n\n attrib_type\n A hou.attribType value specifying whether to list point,\n primitive, vertex, or global attributes. Providing a value of\n None will list attributes of all types.\n\n data_type\n Filters the attribute list to include only attributes with the\n specified hou.attribData data type. Providing a value of None\n will list attributes of all data types.\n\n min_size\n Includes only attributes whose size is at least this value.\n\n max_size\n If greater than min_size, includes only attributes whose size is\n at most this value.\n\n array_type\n Specifies whether array attributes should be included.\n\n scalar_type\n Specifies whether attributes that do not contain array data\n should be included.\n\n case_sensitive\n Specifies whether the menu labels are produced in a case-\n sensitive order. This also controls whether the pattern is\n treated as case-sensitive.\n\n pattern\n Specifies a pattern of attribute names that should be included.\n\n decode_tokens\n If enabled, the menu tokens will contain the decoded attribute\n names rather than the actual attribute names. This can be useful\n for parameters that support matching against decoded attribute\n names.\n\n\n '''\n def isReadOnly(self) -> bool:\n \"\"\"\n\n isReadOnly(self) -> bool\n\n Return true if the geometry is read-only.\n\n\n \"\"\"\n def extractPackedPaths(self, pattern: str) -> Tuple[str, ...]:\n \"\"\"\n\n extractPackedPaths(self, pattern) -> tuple of str\n\n Returns paths of any packed prim files that match the given pattern.\n See also hou.Geometry.unpackFromFolder and\n hou.Geometry.packToFolder.\n\n\n \"\"\"\n def unpackFromFolder(self, path: str) -> Geometry:\n \"\"\"\n\n unpackFromFolder(self, path) -> hou.Geometry\n\n Returns the unpacked geometry of the file at the given path. See\n also hou.Geometry.packToFolder and hou.Geometry.extractPackedPaths.\n\n\n \"\"\"\n def packedFolderProperties(self, path: str) -> dict[str, bool]:\n \"\"\"\n\n packedFolderProperties(self, path) -> dict\n\n Returns a dict containing the folder properties for the given path.\n The dict contains two entries: the entry under the visible key\n specifies whether the packed primitive is in the\n _3d_hidden_primitives group, and the entry under the treat_as_folder\n key specifies whether the primitive is treated as a folder with\n packed contents.\n\n\n \"\"\"\n def packToFolder(self, path: str, geometry: Geometry, is_folder: bool = False, is_visible: bool = True, pack: bool = True) -> bool:\n \"\"\"\n\n packToFolder(self, path, geometry, is_folder=False, is_visible=True,\n pack=True) -> bool\n\n Packs and inserts geometry into the folder at the given path. If\n is_folder is True, treat the inserted geometry as a folder with\n packed contents. is_visible controls the visibility of the packed\n primitive. If pack is true, the inputs are packed. If pack is false,\n the inputs are merged into a single stream of geometry and the names\n of all their primitives are set within each input.\n\n Returns True on success. Fails if the given path cannot be created.\n See also hou.Geometry.unpackFromFolder and\n hou.Geometry.extractPackedPaths.\n\n\n \"\"\"\n def removeFromFolder(self, path: str) -> bool:\n \"\"\"\n\n removeFromFolder(self, path) -> bool\n\n Removes a folder or file at the given path.\n\n Returns True on success. Fails if the given path cannot be created.\n See also hou.Geometry.unpackToFolder and\n hou.Geometry.extractPackedPaths.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def pointAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]: ...\n def primAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]: ...\n def vertexAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]: ...\n def globalAttribs(self, scope: EnumValue = ...) -> Tuple[Attrib, ...]: ...\n\nclass GeometryDelta:\n \"\"\"\n\n hou.GeometryDelta\n\n Geometry delta provides access to the geometry differences (deltas)\n stored by some Geometry nodes such as the edit SOP.\n\n If you ask a SOP for its geometry delta via hou.SopNode.geometryDelta,\n you'll get a reference to it. If the SOP recooks, the corresponding\n geometry delta objects will update to the SOP's new geometry delta\n object. If the SOP is deleted, accessing the geometry delta object will\n raise a hou.ObjectWasDeleted exception.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def setPointPositionsFromString(self, positions: bytes, float_type: EnumValue = ...) -> None:\n \"\"\"\n\n setPointPositionsFromString(self, positions)\n\n Stores the differences between the provided positions and this SOP\n node's input geometry into this node's geometry delta object. This\n can be used, for example, to preload an edit SOP's delta so its\n output geometry matches a desired shape without changing the input\n geometry.\n\n The positions parameter should be a binary representation of the\n positions. For example, the result of calling\n hou.Geometry.pointFloatAttribValuesAsString.\n\n\n \"\"\"\n\nclass GeometryDrawable(AdvancedDrawable):\n \"\"\"\n\n hou.GeometryDrawable\n\n Advanced drawable for drawing guide geometries.\n\n OVERVIEW\n\n hou.GeometryDrawable lets you draw guide geometries like\n hou.SimpleDrawable, but offers more drawing options with various\n kind of visualization effects. For instance, you can use a\n hou.GeometryDrawable object for drawing the faces of the attached\n geometry, drawing points in different shapes, drawing lines or\n vectors. You may also use a glow matte effect to highlight faces,\n lines, point radius, etc...\n\n Like hou.SimpleDrawable, hou.GeometryDrawable uses mostly the same\n services for managing geometries in the viewer without being part of\n the actual scene. Like hou.TextDrawable, hou.GeometryDrawable is\n designed for python states and requires the onDraw handler for\n drawing its attached geometry.\n\n\n NOTE\n hou.GeometryDrawable can only be used with polygon mesh\n geometries.\n\n RELATED\n\n * hou.GeometryDrawableGroup\n\n * hou.SimpleDrawable\n\n * hou.TextDrawable\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, scene_viewer: SceneViewer, geo_type: EnumValue, name: str, label: str|None = ..., geometry: Geometry|None = ..., params: Mapping[str, Any]|None = ...) -> None:\n \"\"\"\n\n __init__(self, scene_viewer, geo_type, name, label=None, geometry=None,\n params=None)\n\n Creates a new drawable object of a given highlight type. The new\n drawable is hidden by default.\n\n\n scene_viewer\n A hou.SceneViewer reference to the viewer the guide geometry\n will appear in.\n\n geo_type\n A hou.drawableGeometryType value for specifying the kind of\n drawable to create.\n\n name\n A string to identify this drawable object.\n\n label\n An optional string for the drawable label. Defaults to empty.\n\n geometry\n An optional hou.Geometry object containing the geometry to draw.\n\n params\n An optional parameter dictionary for setting the drawable\n parameters. The parameters contained in params must match the\n geo_type drawable being created or they will be ignored. These\n are the same parameters you can use with\n hou.AdvancedDrawable.setParams and hou.AdvancedDrawable.draw.\n\n Other common parameters are listed in\n hou.AdvancedDrawable.setParams.\n\n clip_plane\n hou.Vector4 or sequence of 4 doubles\n\n Vector representing a clip plane in world coordinates. (a, b, c,\n d) represents a plane ax + by + cz + d = 0, and geometry behind\n the plane is clipped. The default value is hou.Vector4(0, 0, 0,\n 0). Setting this param also enables the use of clip plane on\n this drawable. This can be enabled/disabled with useClipPlane.\n\n Line parameter\n Type\n Description\n line_width\n double\n\n Sets the line width value. Defaults to 1.0.\n\n style\n hou.drawableGeometryLineStyle or sequence of 2 doubles\n\n Sets the line style to draw: solid, dashed, or dotted. When\n passing in 2 doubles, the first value is the length of the dash\n in pixels and the second is the length of the gap between dashes\n in pixels. Defaults to hou.drawableGeometryLineStyle.Plain.\n\n Face parameter\n Type\n Description\n backface_culling\n Bool\n\n Enable or disable backface culling. Defaults to the current\n viewport Remove Backfaces display option.\n\n color_ramp_parm\n hou.Parm\n\n Sets the drawable with a color ramp object. If the ramp is\n enabled (i.e. use_ramp_color=True), the drawable hilites the\n geometry polygons with the ramp value settings along with a pre-\n existing Cd attribute on the geometry. Defaults to an RGB ramp\n object type.\n\n The ramp works as a transformation on values from the Cd. It's\n done per component, so, if your Cd doesn't have the same value\n in all the three components, you won't get the colors from the\n ramp.\n\n The way it works is that the ramp ends up being a 1-dimensional\n OpenGL texture (512 pixels long). The drawable takes each\n component (R, G, B) of each fragment color and maps it linearly\n (using the ramp_range min and max values) into an index in\n (0...511) and reads off the corresponding color component from\n the texture and substitutes the Cd value with that value for\n that component.\n\n If the value ends up out of min-max range, then depending on the\n ramp_clamp setting it either gets clamped to one of the two ends\n of the range, or is taken modulo the range interval (repeating\n cyclically), or is just blacked out.\n\n glyphe_scale\n double\n\n A scale value for the face patterns. Default to 1.0.\n\n indices\n sequence of int\n\n A list of indices representing the geometry faces to draw. All\n geometry faces are drawn by default.\n\n period\n double\n\n A value for displaying faces in patterns based on the style\n option selected. Defaults to 0.\n\n style\n hou.drawableGeometryFaceStyle\n\n Sets the face style to draw. Defaults to\n hou.drawableGeometryFaceStyle.Plain.\n\n ramp_clamp\n hou.drawableRampClamp\n\n Sets the ramp clamp type for color_ramp_parm. Defaults to\n hou.drawableRampClamp.Edge.\n\n ramp_range\n hou.Vector2\n\n Sets the minimum and maximum ramp value for color_ramp_parm.\n Defaults to hou.Vector2(-1,-1).\n\n reverse_winding\n Bool\n\n Pick which side of a face to remove when backface culling is\n active. Defaults to False;\n\n use_color_ramp\n Bool\n\n Enable the use of the color ramp if one is set on the drawable.\n Defaults to False.\n\n Point parameter\n Type\n Description\n falloff_range\n hou.Vector2\n\n Sets the falloff range value. Defaults to hou.Vector2(0, 0).\n\n indices\n sequence of int\n\n A list of polygon point indices, only the points of the\n corresponding indices are drawn. If no indices are provided, all\n geometry points are drawn by default.\n\n num_rings\n int\n\n Sets the number of rings around the point. Works with\n hou.drawableGeometryPointStyle.RingsCircle or\n hou.drawableGeometryPointStyle.RingsSquare. Defaults to 0.\n\n radius\n double\n\n Sets the point radius value. Defaults to 0.05.\n\n style\n hou.drawableGeometryPointStyle\n\n Sets the point style to draw. Ring styles work better when the\n max falloff_range value is > 0. Defaults to\n hou.drawableGeometryPointStyle.LinearCircle.\n\n Vector parameter\n Type\n Description\n indices\n sequence of int\n\n A list of polygon point indices, only the vectors for the points\n of the corresponding indices are drawn. If no indices are\n provided, all vectors are drawn by default.\n\n bidirect\n Bool\n\n Draws the vector segment with an arrow on both end. Defaults to\n False.\n\n length_scale\n double\n\n Sets the length of the vector segment. Defaults to 1.0.\n\n vector_width\n int\n\n Sets the width of the vector segment in pixel units. Defaults to\n 0.\n\n use_arrow\n Bool\n\n Draws the vector segment with an arrow on one end. Defaults to\n False.\n\n base_fade_factor\n double\n\n Fades the entire vector by this factor if the base point of the\n vector is occluded. Can be used in conjunction with fade_factor\n to achieve different levels of fading if the vector is occluded\n and the base of the vector is occluded, in which case the\n product of the two fade factors is used. Defaults to 0.25.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self) -> hou.Geometry\n\n Returns the drawable's geometry object. The returned geometry is\n read-only.\n\n\n \"\"\"\n def setGeometry(self, geometry: Geometry) -> None:\n \"\"\"\n\n setGeometry(self, geometry)\n\n Sets the drawable with a new geometry. The changes will appear the\n next time the viewer redraws.\n\n\n geometry\n A hou.Geometry object.\n\n\n \"\"\"\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.drawableGeometryType\n\n Returns the type of drawable as specified at creation time.\n\n\n \"\"\"\n def useClipPlane(self, value: bool) -> None:\n \"\"\"\n\n useClipPlane(self, value)\n\n Enable or disable the clip plane while rendering this drawable. It\n is disabled by default.\n\n\n value\n True to enable the clip plane and False to disable it.\n\n\n \"\"\"\n\nclass GeometryDrawableGroup(AdvancedDrawable):\n '''\n\n hou.GeometryDrawableGroup\n\n A container of hou.GeometryDrawable objects.\n\n OVERVIEW\n\n hou.GeometryDrawableGroup acts as a regular hou.GeometryDrawable\n object which can contain several hou.GeometryDrawable children.\n hou.GeometryDrawableGroup performs operations on its children in the\n order they were added. You can also query specific children from\n hou.GeometryDrawableGroup for setting their parameters individually.\n\n Here\\'s an example that creates a group composed of two\n hou.GeometryDrawable objects.\n\n > import hou\n > import viewerstate.utils as su\n > \n > class State(object): \n > def __init__(self, state_name, scene_viewer):\n > self.state_name = state_name\n > self.scene_viewer = scene_viewer\n > \n > # create the geometry\n > sops = hou.sopNodeTypeCategory()\n > verb = sops.nodeVerb(\\'tube\\')\n > verb.setParms({\n > \\\\\"rad\\\\\": (0.2, 0.4),\n > \\\\\"rows\\\\\": 3,\n > \\\\\"cols\\\\\": 6,\n > \\'height\\': 1.0,\n > \\\\\"cap\\\\\":True\n > })\n > \n > geo = hou.Geometry()\n > verb.execute(geo, [])\n > \n > # creates the drawable group \n > self.cursor = hou.GeometryDrawableGroup(\\\\\"cursor\\\\\")\n > \n > # adds the drawables\n > self.cursor.addDrawable( hou.GeometryDrawable( self.scene_viewer,\n > hou.drawableGeometryType.Face, \\\\\"face\\\\\", params = {\\'color1\\' : (0.0,1.0,0.0,1.0)} ))\n > self.cursor.addDrawable( hou.GeometryDrawable(self.scene_viewer, \n > hou.drawableGeometryType.Line, \\\\\"line\\\\\", params = {\\'color1\\' : (0,0,0,1.0)} ))\n > \n > # set the geometry on all children\n > self.cursor.setGeometry(geo)\n > self.cursor.show(False)\n > \n > self.cursor_pos = hou.Vector3()\n > \n > def onMouseEvent(self, kwargs):\n > ui_event = kwargs[\\\\\"ui_event\\\\\"]\n > (origin, dir) = ui_event.ray()\n > \n > gi = su.GeometryIntersector(kwargs[\\\\\"node\\\\\"].geometry())\n > gi.intersect(origin, dir)\n > \n > if gi.intersected: \n > self.cursor_pos = gi.position\n > self.cursor.show(True)\n > else:\n > self.cursor.show(False)\n > \n > def onDraw(self, kwargs):\n > handle = kwargs[\\'draw_handle\\']\n > \n > params = {\n > \\'translate\\' : (self.cursor_pos[0], self.cursor_pos[1], self.cursor_pos[2]), \n > \\'line_width\\' : 0.25\n > }\n > \n > self.cursor.draw( handle, params )\n\n RELATED\n\n * hou.GeometryDrawable\n\n\n '''\n thisown: Incomplete\n def __init__(self, name: str, label: str|None = ...) -> None:\n \"\"\"\n\n __init__(self, name, label=None)\n\n Creates a new geometry drawable group object. The new object is\n empty and must be filled with hou.GeometryDrawable objects to be\n useful.\n\n\n name\n Name of the drawable group.\n\n label\n An optional string for the drawable label. Defaults to empty.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def addDrawable(self, drawable: GeometryDrawable) -> None:\n \"\"\"\n\n addDrawable(geometry_drawable)\n\n Adds a hou.GeometryDrawable object at the end of the children.\n\n\n geometry_drawable\n The hou.GeometryDrawable to add.\n\n\n \"\"\"\n def drawable(self, drawable_name: str) -> GeometryDrawable:\n \"\"\"\n\n drawable(name): -> hou.GeometryDrawable\n\n Returns a drawable by name.\n\n\n \"\"\"\n def drawables(self) -> Tuple[GeometryDrawable, ...]:\n \"\"\"\n\n drawables(): -> list` of hou.GeometryDrawable\n\n Returns a list of all children.\n\n\n \"\"\"\n def geometry(self) -> Geometry:\n \"\"\"\n\n geometry(self): -> hou.Geometry\n\n Returns the drawable's geometry object. The returned geometry is\n read-only.\n\n\n \"\"\"\n def setGeometry(self, geometry: Geometry) -> None:\n \"\"\"\n\n setGeometry(self, geometry)\n\n Sets all drawable children with a new geometry. The changes will\n appear the next time the viewer redraws.\n\n\n geometry\n A hou.Geometry object.\n\n\n \"\"\"\n def useClipPlane(self, value: bool) -> None:\n \"\"\"\n\n useClipPlane(self, value)\n\n Enable or disable the clip plane on all drawables in this group. By\n default the clip plane for all drawables are disabled.\n\n\n value\n True to enable the clip plane on all drawables and False to\n disable it.\n\n\n \"\"\"\n\nclass GadgetDrawable(GeometryDrawable):\n thisown: Incomplete\n def __init__(self, widget: int, gadget_context: int) -> None: ...\n __swig_destroy__: Incomplete\n\nclass GeometryRayCache:\n \"\"\"\n\n hou.GeometryRayCache\n\n Geometry Ray Cache allows caching of ray-intersection structures.\n\n When you use hou.Geometry.intersect(), the hou.Geometry will store an\n acceleration structure. This is reset if the geometry changes at all,\n however. A ray cache allows you to maintain an acceleration structure\n and re-use it if only the point positions change.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Return a new GeometryRayCache. The same ray cache can be used across\n multiple geometries and, where possible, it will cache the\n acceleration structures for faster ray intersection.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def intersect(self, geo: Geometry, rayorig: Vector3, dir: Vector3, p: Vector3, n: Vector3, uvw: Vector3, min_hit: float = 0.01, max_hit: float = 1e+18, tolerance: float = 0.01) -> int:\n \"\"\"\n\n intersect(self, ray_origin, ray_direction, position_out, normal_out,\n uvw_out, min_hit=0.01, max_hit=1E18, tolerance=0.01) -> int\n\n Determines the intersection point of a ray with the geometry in this\n object.\n\n\n NOTE\n This method is unusual in that instead of returning multiple\n pieces of information about the intersection, it requires that\n you pass it objects which it modifies in-place with the\n information.\n\n Returns the ID number of the hit primitive if the ray intersected\n the geometry, or -1 if the ray did not hit.\n\n\n ray_origin\n A hou.Vector3 object representing the starting point of the ray\n in world space.\n\n ray_direction\n A hou.Vector3 object representing the direction vector of the\n ray.\n\n position_out\n Pass a hou.Vector3 object to this argument. The method will\n change the object's values to represent the intersection\n position in world space.\n\n normal_out\n Pass a hou.Vector3 object to this argument. The method will\n change the object's values to represent the normal direction\n from the surface to the ray.\n\n uvw_out\n Pass a hou.Vector3 object to this argument. The method will\n change the object's values to represent the UVW position within\n the intersecting primitive where the ray hit.\n\n min_hit\n Ignore intersections closer than this distance. You can use the\n min_hit argument to iterate through all possible hits along the\n ray, by setting the min_hit a tiny bit farther than the previous\n hit.\n\n > hit_positions = []\n > prev_dist = 0.01\n > while geometry.intersect(origin, direction, position, normal, uvw,\n > min_hit=prev_dist):\n > # Make sure to store a *copy* of the position, not the object\n > # that is being modified in each iteration of the loop\n > hit_positions.append(hou.Vector3(position))\n > prev_dist = origin.distanceTo(position) + 0.01\n\n max_hit\n Ignore intersections farther than this distance.\n\n tolerance\n Use this parameter to adjust the accuracy of intersections. If\n the ray approaches the geometry within the tolerance value, an\n intersection hit is assumed. A 0.01 tolerance (default) gives\n strict intersections while larger values produces less accurate\n intersections.\n\n\n \"\"\"\n def findAllInTube(self, geo: Geometry, rayorig: Vector3, dir: Vector3, radius: float, min_hit: float = 0.0, max_hit: float = 1e+18, tolerance: float = 0.005) -> Tuple[Point, ...]:\n \"\"\"\n\n findAllInTube(self, line_origin, line_direction, radius, min_hit=0,\n max_hit=1E18, tolerance=5E-3) -> tuple of hou.Point\n\n Return a tuple of all the points in the geometry inside the tube\n given by the line and radius.\n\n\n ray_origin\n A hou.Vector3 object representing the starting point of the line\n in world space.\n\n ray_direction\n A hou.Vector3 object representing the direction vector of the\n line.\n\n radius\n Find points within this distance of the line.\n\n min_hit\n Ignore intersections closer than this distance. You can use the\n min_hit argument to iterate through all possible hits along the\n ray, by setting the min_hit a tiny bit farther than the previous\n hit.\n\n max_hit\n Ignore intersections farther than this distance.\n\n tolerance\n Use this parameter to adjust the accuracy of intersections. A\n 5E-3 tolerance (default) gives strict intersections while larger\n values produces less accurate intersections.\n\n\n \"\"\"\n\nclass GeometrySelection:\n \"\"\"\n\n hou.GeometrySelection\n\n Represents a component selection performed by the user in a viewport.\n\n Calling hou.SceneViewer.selectGeometry waits for the user to perform a\n selection in the viewport, and returns an object of this type\n representing the elected components. The returned selection can be\n manipulated by converting it to a specific component type, grown, or\n shrunk. Then the selection can be converted to a string that can be used\n in a SOP node group parameter.\n\n If the selection contains components from more than one SOP, you can use\n the hou.GeometrySelection.mergedNode function to create a Merge SOP\n and/or Object Merge SOPs that brings all the referenced geometry into a\n single node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n hou.GeometrySelection\n\n Represents a component selection performed by the user in a viewport.\n\n Calling hou.SceneViewer.selectGeometry waits for the user to perform a\n selection in the viewport, and returns an object of this type\n representing the elected components. The returned selection can be\n manipulated by converting it to a specific component type, grown, or\n shrunk. Then the selection can be converted to a string that can be used\n in a SOP node group parameter.\n\n If the selection contains components from more than one SOP, you can use\n the hou.GeometrySelection.mergedNode function to create a Merge SOP\n and/or Object Merge SOPs that brings all the referenced geometry into a\n single node.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def ordered(self) -> bool:\n \"\"\"\n\n ordered(self) -> bool\n\n Returns true if this is an ordered selection. This means that the\n order in which the user selected the components is preserved. To\n have an ordered selection, the ordered parameter needs to have been\n set to True when calling hou.SceneViewer.geometrySelection.\n\n\n \"\"\"\n def geometryType(self) -> EnumValue:\n \"\"\"\n\n geometryType(self) -> hou.geometryType enum value\n\n Returns the type of component that was selected.\n\n\n \"\"\"\n def setGeometryType(self, type: EnumValue) -> None:\n \"\"\"\n\n setGeometryType(self, type)\n\n Changes the type of component contained in the selection, converting\n the existing selection to the new component type.\n\n\n \"\"\"\n def connectivity(self) -> EnumValue:\n \"\"\"\n\n connectivity(self) -> hou.connectivityType enum value\n\n Returns the hou.connectivityType that has been set on this geometry\n selection. Unless you call hou.GeometrySelection.setConnectivity,\n this function will return the no connectivity value.\n\n\n \"\"\"\n def setConnectivity(self, connectivity: EnumValue) -> None:\n \"\"\"\n\n setConnectivity(self, connectivity)\n\n Sets the type of connectivity to enforce when modifying the\n selection. The current selection is also expanded so that all\n connected components (using the supplied style of connectivity)\n become part of the selection.\n\n\n \"\"\"\n def primitiveTypes(self) -> Tuple[EnumValue, ...]:\n \"\"\"\n\n primitiveTypes(self) -> tuple of hou.primitiveType enum values\n\n Returns a tuple containing all primitive types that are contained in\n the selection.\n\n\n \"\"\"\n def setPrimitiveTypes(self, primitive_types: Sequence[EnumValue]) -> None:\n \"\"\"\n\n setPrimitiveTypes(self, primitive_types)\n\n Sets the tuple of primitive types allowed in the selection. Any\n primitives that are not of an allowed type are removed from the\n selection. Only has an effect if this is a primitive selection.\n\n\n \"\"\"\n def nodes(self) -> Tuple[Node, ...]:\n \"\"\"\n\n nodes(self) -> tuple of Nodes\n\n Returns a tuple of all nodes referenced by the selection.\n\n\n \"\"\"\n def selectionStrings(self, empty_string_selects_all: bool = True, force_numeric: bool = False) -> Tuple[str, ...]:\n \"\"\"\n\n selectionStrings(self, empty_string_selects_all=True, bool\n force_numeric=False) -> tuple of strings\n\n Returns a tuple of strings that can be used to refer to the selected\n components in each SOP node referenced by the selection.\n\n\n \"\"\"\n def selections(self) -> Tuple[Selection, ...]:\n \"\"\"\n\n selections(self) -> tuple of [Hom:hou.Selection]\n\n Returns a tuple of component selection objects. These correspond to\n the nodes returned by the nodes function.\n\n\n \"\"\"\n def needsMergedNode(self, parent: Node) -> bool:\n \"\"\"\n\n needsMergedNode(self, parent) -> bool\n\n Returns true if a Merge SOP needs to be created in order to access\n all components in the selection.\n\n\n \"\"\"\n def mergedNode(self, parent: Node, creator_name: str, force_keep_original_objects: bool = False, display_original_objects: bool = False) -> SopNode:\n \"\"\"\n\n mergedNode(self, parent, creator_name,\n force_keep_original_objects=False, display_original_objects=False) ->\n Node\n\n Creates a Merge SOP that combines all the SOPs referenced by the\n selection. Most selections will only reference a single SOP in which\n case no Merge SOP is required, and the selected SOP will be\n returned.\n\n\n \"\"\"\n def mergedSelectionString(self, empty_string_selects_all: bool = True, force_numeric: bool = False) -> str:\n \"\"\"\n\n mergedSelectionString(self, empty_string_selects_all=True,\n force_numeric=False) -> string\n\n Returns a single string that can be used in group parameters of the\n merged node returned by hou.GeometrySelection.mergedNode. If all\n components are selected from a single node this is equivalent to the\n first string in the tuple returned by\n hou.GeometrySelection.selectionStrings.\n\n\n \"\"\"\n def shrinkSelection(self, check_uv: bool = True) -> None:\n \"\"\"\n\n shrinkSelection(checkuv = true)\n\n Removes components that are on the boundary of the selection.\n\n\n \"\"\"\n def growSelection(self) -> None:\n \"\"\"\n\n growSelection()\n\n Expands the selection by adding all components that are connected to\n components currently in the selection.\n\n\n \"\"\"\n def boundingBox(self) -> BoundingBox:\n \"\"\"\n\n boundingBox(self) -> BoundingBox\n\n Returns the bounding box of the selected region.\n\n\n \"\"\"\n def orientedBoundingBox(self) -> OrientedBoundingBox:\n \"\"\"\n\n orientedBoundingBox(self) -> OrientedBoundingBox\n\n Returns the oriented bounding box of the selected region.\n\n\n \"\"\"\n\nclass GeometrySpreadsheet(PathBasedPaneTab):\n \"\"\"\n\n hou.GeometrySpreadsheet\n\n Represents a geometry spreadsheet pane tab.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def numRows(self) -> int:\n \"\"\"\n\n numRows(self) -> int\n\n Returns the number of rows in the geometry spreadsheet.\n\n\n \"\"\"\n def numColumns(self) -> int:\n \"\"\"\n\n numColumns(self) -> int\n\n Returns the number of columns in the geometry spreadsheet.\n\n\n \"\"\"\n def cellText(self, row: int, col: int) -> str:\n \"\"\"\n\n cellText(self, row, col) -> str\n\n Returns the text for the specified cell.\n\n\n \"\"\"\n def attribType(self) -> EnumValue:\n \"\"\"\n\n attribType(self) -> hou.attribType\n\n Returns whether the spreadsheet is displaying point, vertex,\n primitive, or detail attributes.\n\n\n \"\"\"\n def setAttribType(self, attrib_type: EnumValue) -> None:\n \"\"\"\n\n setAttribType(self, attrib_type)\n\n Sets whether the spreadsheet is displaying point, vertex, primitive,\n or detail attributes.\n\n\n attrib_type\n A hou.attribType specifying the type of attribute to display.\n\n\n \"\"\"\n def groupFilter(self) -> str:\n \"\"\"\n\n groupFilter(self) -> str\n\n Returns the spreadsheet's group filter pattern.\n\n\n \"\"\"\n def setGroupFilter(self, group: str) -> None:\n \"\"\"\n\n setGroupFilter(self, group)\n\n Sets the group pattern for the spreadsheet.\n\n\n \"\"\"\n def groupFilterEnabled(self) -> bool:\n \"\"\"\n\n groupFilterEnabled(self) -> bool\n\n Return whether the group filter is enabled in the spreadsheet.\n\n\n \"\"\"\n def setGroupFilterEnabled(self, enable: bool) -> None:\n \"\"\"\n\n setGroupFilterEnabled(self, enable)\n\n Toggles whether the group filter is enabled in the spreadsheet.\n\n\n \"\"\"\n def attribFilter(self) -> str:\n \"\"\"\n\n attribFilter(self) -> str\n\n Returns the spreadsheet's attribute filter pattern.\n\n\n \"\"\"\n def setAttribFilter(self, filter: str) -> None:\n \"\"\"\n\n setAttribFilter(self, filter)\n\n Sets the attribute filter pattern for the spreadsheet.\n\n\n \"\"\"\n def attribFilterEnabled(self) -> bool:\n \"\"\"\n\n attribFilterEnabled(self) -> bool\n\n Return whether the attribute filter is enabled in the spreadsheet.\n\n\n \"\"\"\n def setAttribFilterEnabled(self, enable: bool) -> None:\n \"\"\"\n\n setAttribFilterEnabled(self, enable)\n\n Toggles whether the attribute filter is enabled in the spreadsheet.\n\n\n \"\"\"\n def viewOnlySelected(self) -> bool:\n \"\"\"\n\n viewOnlySelected(self) -> bool\n\n Returns whether only the current selection's elements are displayed.\n\n\n \"\"\"\n def setViewOnlySelected(self, enable: bool) -> None:\n \"\"\"\n\n setViewOnlySelected(self, enable)\n\n Toggles whether only the current selection's elements are displayed.\n\n\n \"\"\"\n def viewDecomposedMatrices(self) -> bool:\n \"\"\"\n\n viewDecomposedMatrices(self) -> bool\n\n Returns whether matrix values are decomposed into translation,\n rotation, scale, and shear components.\n\n\n \"\"\"\n def setViewDecomposedMatrices(self, enable: bool) -> None:\n \"\"\"\n\n setViewDecomposedMatrices(self, enable)\n\n Toggles whether matrix values are decomposed into translation,\n rotation, scale, and shear components.\n\n\n \"\"\"\n def sceneGraphTree(self) -> Optional[SceneGraphTree]:\n \"\"\"\n\n sceneGraphTree(self) -> hou.SceneGraphTree or None\n\n Returns the scene graph tree pane that is embedded in the geometry\n spreadsheet pane when viewing the data for a LOP node.\n\n\n \"\"\"\n\nclass GeometryViewport:\n '''\n\n hou.GeometryViewport\n\n A viewport within a Scene Viewer pane, for viewing the scene at the\n Object or SOP level.\n\n OVERVIEW\n\n A viewer is a type of pane that shows the scene. The viewer\\'s\n contents is conceptually divided into viewports. By default, the\n scene viewer shows a single viewport, the Perspective view. However,\n you can use the view layout controls to, for example, split the view\n into four viewports (Perspective, Top, Front, and Right views).\n Viewports are the parts of the interface that actually display the\n scene to the user.\n\n\n To access a viewport, you must first get a reference to a Scene\n Viewer pane tab. See the following methods:\n\n\n hou.ui.paneTabOfType\n Use hou.ui.paneTabOfType(hou.paneTabType.SceneViewer) to get\n a reference to a Scene Viewer pane tab in the current pane\n layout. If the current layout has no Scene Viewer pane tab,\n this returns None.\n\n To be more precise about which viewer you grab in a possible\n multi-viewer layout, see also hou.ui.curDesktop to get a\n hou.Desktop object representing the current pane layout, and\n hou.Desktop.sceneViewers to get a list of scene viewer pane\n tabs in the current layout.\n\n Once you have a reference to a hou.SceneViewer pane object, you\n can use it to access the viewer pane\\'s viewport or viewports.\n See the following methods:\n\n\n hou.SceneViewer.viewports\n Returns a list of the viewports in the viewer pane.\n\n hou.SceneViewer.findViewport\n Gets a single viewport by name, for example \\\\\"Top\\\\\".\n\n hou.SceneViewer.selectedViewport\n Gets the currently selected viewport. The user can select a\n viewport by pressing [Space + N] in the viewport. The view\n menus in the upper right corner are drawn brighter in the\n selected viewport.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def type(self) -> EnumValue:\n \"\"\"\n\n type(self) -> hou.geometryViewportType enum value\n\n Query the viewport type (UV, 3D, top, left, etc).\n\n\n \"\"\"\n def changeType(self, type: EnumValue) -> None:\n \"\"\"\n\n changeType(self, [Hom:hou.geometryViewportType])\n\n Set the viewport type (hou.geometryViewportType). This method first\n attempts to restore a stashed view for the new viewport type, but\n failing that, will home the viewport.\n\n\n \"\"\"\n def settings(self) -> GeometryViewportSettings:\n \"\"\"\n\n settings(self) -> hou.GeometryViewportSettings\n\n Returns the hou.GeometryViewportSettings object for this viewport.\n By calling methods on that object, you can read/edit the viewport's\n display options.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Query of the name of the viewport (persp1, top1, etc).\n\n\n \"\"\"\n def changeName(self, name: str) -> None:\n \"\"\"\n\n changeName(self, str)\n\n Set the name of the viewport. Setting the name does not affect its\n type, so naming a perspective view front will be confusing. This is\n best used in conjunction with changeType().\n\n\n \"\"\"\n def home(self) -> None:\n \"\"\"\n\n home(self)\n\n Moves/tumbles the viewport to the default view.\n\n\n \"\"\"\n def homeAll(self) -> None:\n \"\"\"\n\n homeAll(self)\n\n Moves/tumbles the view to show all geometry/objects (including\n templated geometry). See also homeNonTemplated().\n\n\n \"\"\"\n def homeSelected(self) -> None:\n \"\"\"\n\n homeSelected(self)\n\n Moves/tumbles the view to show the selected geometry/objects.\n\n\n \"\"\"\n def homeGrid(self) -> None:\n \"\"\"\n\n homeGrid(self)\n\n Homes the viewport on the grid.\n\n\n \"\"\"\n def homeNonTemplated(self) -> None:\n \"\"\"\n\n homeNonTemplated(self)\n\n Moves/tumbles the view to show all non-templated geometry.\n\n\n \"\"\"\n def homeBoundingBox(self, bbox: BoundingBox, center_to_origin: bool = False) -> None:\n \"\"\"\n\n homeBoundingBox(self, bbox, center_to_origin=False)\n\n Moves/tumbles the viewport to show an arbitrary area in the scene.\n\n\n bbox\n A hou.BoundingBox representing the volume of space to focus on.\n\n center_to_origin\n\n\n \"\"\"\n def frameAll(self) -> None:\n \"\"\"\n\n frameAll(self)\n\n Moves the view to show all geometry/objects. See also\n frameNonTemplates().\n\n\n \"\"\"\n def frameBoundingBox(self, bbox: Optional[BoundingBox] = None) -> None:\n \"\"\"\n\n frameBoundingBox(self, bbox)\n\n Moves the view to show an arbitrary area in the scene.\n\n\n bbox\n A hou.BoundingBox representing the volume of space to focus on.\n\n\n \"\"\"\n def frameSelected(self) -> None:\n \"\"\"\n\n frameSelected(self)\n\n Moves the view to show the selected geometry/objects.\n\n\n \"\"\"\n def frameGrid(self) -> None:\n \"\"\"\n\n frameGrid(self)\n\n Frames the view on the grid.\n\n\n \"\"\"\n def frameNonTemplated(self) -> None:\n \"\"\"\n\n frameNonTemplated(self)\n\n Moves the view to show all non-templated geometry.\n\n\n \"\"\"\n def draw(self) -> None:\n \"\"\"\n\n draw(self)\n\n Request that the viewport redraw. Multiple draw() calls within the\n same script will be merged into a single call.\n\n\n \"\"\"\n def viewTransform(self) -> Matrix4:\n \"\"\"\n\n viewTransform(self) -> hou.Matrix4\n\n Returns the transform matrix of the view. To set the viewpoint\n programmatically, use defaultCamera() to get a hou.ViewportCamera\n object and manipulate that.\n\n\n \"\"\"\n def modelToGeometryTransform(self) -> Matrix4:\n \"\"\"\n\n modelToGeometryTransform(self) -> hou.Matrix4\n\n Returns the transform from the modeling space to the space of the\n points in the geometry. When modeling at object level, this converts\n from the object space into the SOP's space. When modeling at the SOP\n level, this is identity as the model space was the SOP space.\n\n\n \"\"\"\n def cameraToModelTransform(self) -> Matrix4:\n \"\"\"\n\n cameraToModelTransform(self) -> hou.Matrix4\n\n Equivalent to viewTransform, this is the transform matrix of the\n view. It converts from the camera's space into the space that\n modeling is currently being done at.\n\n\n \"\"\"\n def ndcToCameraTransform(self) -> Matrix4:\n \"\"\"\n\n ndcToCameraTransform(self) -> hou.Matrix4\n\n Returns the transform from normalized device coordinates to the\n viewport camera's space. This is often a projective transform, so if\n used the resulting points will have to be dehomogenized by dividing\n by w.\n\n\n \"\"\"\n def viewportToNDCTransform(self) -> Matrix4:\n \"\"\"\n\n viewportToNDCTransform(self) -> hou.Matrix4\n\n Returns the matrix converting from the viewport pixel coordinates to\n the normalized device coordinates. This is a two dimensional scale\n and translate, so the z and w components are identity.\n\n\n \"\"\"\n def windowToViewportTransform(self) -> Matrix4:\n \"\"\"\n\n windowToViewportTransform(self) -> hou.Matrix4\n\n Returns the matrix converting from the window pixel viewport\n coordinates to the viewport pixel coordinates. Window coordinates\n are present in hou.ViewerEvent and are unaware of quad-view\n viewports.\n\n This is a two dimensional translate, so z and w components are\n identity.\n\n\n \"\"\"\n def viewPivot(self) -> Vector3:\n \"\"\"\n\n viewPivot(self) -> hou.Vector3\n\n Returns a hou.Vector3 representing the view pivot as a point in\n world space.\n\n\n \"\"\"\n def resolutionInPixels(self) -> Tuple[int, ...]:\n \"\"\"\n\n resolutionInPixels(self) -> 2-tuple of int\n\n Returns the resolution of the viewport in pixels, as (width,\n height).\n\n\n \"\"\"\n def camera(self) -> ObjNode: ...\n def cameraPath(self) -> str:\n \"\"\"\n\n cameraPath(self) -> str\n\n Return the path to the camera that the viewport is looking through.\n If the viewport isn't looking through a camera, return an empty\n string. In objects, this is the path of the camera object node. In\n LOPs, this is the USD primitive path.\n\n\n \"\"\"\n def setCamera(self, camera_node: ObjNode) -> None:\n \"\"\"\n\n setCamera(self, camera_node)\n\n Copies the viewport transform from the transformation parameters of\n a camera or light onto the current view. This is the same as\n choosing a camera/light from the Look through submenu in the\n viewport's Camera menu.\n\n\n camera_node\n A hou.ObjNode object representing the node to save the view\n from.\n\n\n \"\"\"\n def saveViewToCamera(self, camera_node: ObjNode) -> None:\n \"\"\"\n\n saveViewToCamera(self, camera_node)\n\n Copies the viewpoint transform of the current view onto the\n transformation parameters of a camera or light node.\n\n\n camera_node\n A hou.ObjNode object representing the node to save the view to.\n\n\n \"\"\"\n def defaultCamera(self) -> GeometryViewportCamera:\n \"\"\"\n\n defaultCamera(self) -> hou.GeometryViewportCamera\n\n Returns an object representing the viewport's viewpoint. The\n returned object is live in that changing its settings will\n immediately change the view\n\n If a camera/light is locked to the view, changing the settings of\n the GeometryViewportCamera will change the camera/light node's\n parameters as well.\n\n Instead of a live object, you can get a disconnected version of the\n viewpoint using hou.GeometryViewportCamera.stash. This is a useful\n way to remember a certain viewpoint in code for later. You can\n restore a stashed camera using setDefaultCamera().\n\n > # Remember the current view\n > cam = viewport.defaultCamera()\n > saved = cam.stash()\n > \n > # Change the view somehow\n > \n > # Restore the original view\n > viewport.setDefaultCamera(saved)\n\n \"\"\"\n def setDefaultCamera(self, cam_settings: GeometryViewportCamera) -> None:\n \"\"\"\n\n setDefaultCamera(self, stashed_cam)\n\n Takes a hou.GeometryViewportCamera and copies its values into this\n viewport.\n\n Set the current camera settings of the viewport to the settings\n stored in cam_setting. If the viewport is looking through a camera\n and the view is not locked to the camera, it will be switched to No\n camera. If the view is locked to the camera, the camera object will\n be updated instead.\n\n\n \"\"\"\n def useDefaultCamera(self) -> None:\n \"\"\"\n\n useDefaultCamera(self)\n\n Set the viewport camera to No camera and stop looking through a\n camera object (or light).\n\n\n \"\"\"\n def isCameraLockedToView(self) -> bool:\n \"\"\"\n\n isCameraLockedToView(self) -> bool\n\n Query to see if the camera is locked to the view. This returns the\n state of the camera lock only; this can be enabled without viewing\n through a camera.\n\n\n \"\"\"\n def lockCameraToView(self, arg2: bool) -> None:\n \"\"\"\n\n lockCameraToView(self)\n\n Set the viewport camera lock. When True, any changes to the view\n will affect the camera object being viewed though. When False, the\n camera will become disconnected from the viewport and revert to the\n default viewport camera when the user tumbles the view. It is\n possible to enable this without the viewport looking through a\n camera, though view changes will not affect any objects until the\n user sets the viewport to look through a camera or light.\n\n\n \"\"\"\n def isViewExportedToCameraContinuously(self) -> bool:\n \"\"\"\n\n isViewExportedToCameraContinuously(self) -> bool\n\n Query to see if the view changes are exported to a locked camera\n continuously (True) or only on mouse release (False).\n\n\n \"\"\"\n def exportViewToCameraContinuously(self, arg2: bool) -> None:\n \"\"\"\n\n exportViewToCameraContinuously(self)\n\n Set whether the export of view changes to a locked camera happens\n continuously (True) or only on mouse release (False).\n\n\n \"\"\"\n def isActive2D(self) -> bool:\n \"\"\"\n\n isActive2D(self) -> bool\n\n Query if the viewport is currently displaying 2d geometry, often\n implying it is displaying UV information.\n\n\n \"\"\"\n def isActive3D(self) -> bool:\n \"\"\"\n\n isActive3D(self) -> bool\n\n Query if the viewport is currently displaying 3d geometry. This is\n the case for perspective and ortho viewports.\n\n\n \"\"\"\n def usesConstructionPlane(self) -> bool:\n \"\"\"\n\n usesConstructionPlane(self) -> bool\n\n Returns whether this viewport uses the construction plane when it is\n on.\n\n\n \"\"\"\n def queryNodeAtPixel(self, x: int, y: int, pick_templates: bool = False) -> Optional[Node]:\n \"\"\"\n\n queryNodeAtPixel(self, x, y, pick_templates=False) -> hou.ObjNode,\n hou.SopNode, or None\n\n Return the node draw at the specified pixel in the viewport, or None\n if there is nothing there. The type of node returned depends on the\n level of the viewer.\n\n If pick_templates is True then templated geometries will be included\n in the query.\n\n\n \"\"\"\n def queryPrimAtPixel(self, node: Node, x: int, y: int) -> Optional[Prim]:\n \"\"\"\n\n queryPrimAtPixel(self, node, x, y) -> hou.Prim or None\n\n Return the primitive drawn at the specified pixel in the viewport,\n or None if there is nothing there. The primitive returned will be a\n subclass of hou.Prim.\n\n The parameter node is used to restrict the query to geometry within\n a particular node. If node is None, then the query is unrestricted.\n\n\n \"\"\"\n def queryInspectedGeometry(self) -> Optional[Geometry]:\n \"\"\"\n\n queryInspectedGeometry(self) -> hou.Geometry or None\n\n Return the geometry currently being inspected in the viewport, or\n None when nothing is being inspected or when called outside of an\n inspect script.\n\n\n \"\"\"\n def queryInspectedPrim(self) -> Optional[Prim]:\n \"\"\"\n\n queryInspectedPrim(self) -> hou.Prim or None\n\n Return the primitive currently being inspected in the viewport, or\n None when nothing is being inspected or when called outside of an\n inspect script. The primitive returned will be a subclass of\n hou.Prim.\n\n\n \"\"\"\n def mapToWorld(self, x: float, y: float) -> Tuple[Vector3, Vector3]:\n \"\"\"\n\n mapToWorld(self, x, y) -> tuple of (hou.Vector3, hou.Vector3)\n\n Convert viewport coordinates to world coordinates. Returns a ray\n (direction vector and an origin point).\n\n\n \"\"\"\n def mapToScreen(self, pos: Vector3) -> Vector2:\n \"\"\"\n\n mapToScreen(self, position) -> hou.Vector2\n\n Convert world coordinates to viewport coordinates.\n\n\n position\n A hou.Vector3 containing a world space position.\n\n\n \"\"\"\n def mapFromMouseChop(self, x: float, y: float) -> Tuple[int, int]:\n \"\"\"\n\n mapFromMouseChop(self, x, y) -> tuple of (int, int)\n\n Convert from the Mouse CHOP's X and Y screen values (which range\n from -1 to 1) to viewport coordinates, where (0,0) is the bottom\n left corner of the viewport.\n\n\n \"\"\"\n def queryWorldPositionAndNormal(self, x: int, y: int, selectionRestriction: bool = ...) -> Tuple[Vector3, Vector3, bool]:\n \"\"\"\n\n queryWorldPositionAndNormal(self, x,y,selectionRestriction) -> tuple of\n (hou.Vector3, hou.Vector3, bool)\n\n Look up the world position and normal of geometry at viewport\n coordinates (x,y) where (0,0) is the bottom left corner of the\n viewport. The returned tuple contains the position, normal, and a\n boolean flag that is True if there is geometry at that screen\n position. The selectionRestriction can optionally exclude selected\n or non-selected prims; it defaults to querying all prims.\n\n\n \"\"\"\n def size(self) -> Tuple[int, ...]:\n \"\"\"\n\n size(self) -> tuple of double\n\n Returns the size of this viewport. The tuple elements are returned\n in viewport coordinates.\n\n 1. X position (lower left)\n\n 2. Y position (lower left)\n\n 3. Width dimension\n\n 4. Height dimension\n\n\n \"\"\"\n def geometry(self) -> Tuple[int, ...]:\n \"\"\"\n\n geometry(self) -> tuple of int\n\n Returns the position and size of this viewport in the UI space. The\n tuple elements are returned in viewport coordinates, relative to the\n lower-left corner position of the scene viewer.\n\n 1. X position (lower left)\n\n 2. Y position (lower left)\n\n 3. Width dimension\n\n 4. Height dimension\n\n\n \"\"\"\n def isFloating(self) -> bool:\n \"\"\"\n\n isFloating(self) -> bool\n\n Returns True if the viewport is a floating viewport, and False if it\n is one of the four docked viewports in the scene viewer layout.\n\n\n \"\"\"\n def addEventCallback(self, callback: Callable[[dict[str, Any]], None]) -> None:\n '''\n\n addEventCallback(self, callback)\n\n Register a Python callback to be called whenever a viewport event\n occurs.\n\n\n callback\n Any callable Python object that expects keyworded arguments\n specific to an event type. This\n\n callback can be used for any geometry viewport event type.\n\n The kwargs contains the following:\n\n * event_type: A viewport event.\n\n * desktop: The desktop object holding the scene viewer.\n\n * viewer: The scene viewer object pointing to the viewport.\n\n * viewport: The viewport object that triggered the event.\n\n > import hou\n > \n > def onViewportCB(**kwargs):\n > event_type=kwargs[\\'event_type\\']\n > desktop=kwargs[\\'desktop\\']\n > viewer=kwargs[\\'viewer\\']\n > viewport=kwargs[\\'viewport\\']\n > \n > print( \\\\\"event type=\\\\\",event_type )\n > print( \\\\\"desktop=\\\\\",desktop )\n > print( \\\\\"viewer=\\\\\",viewer )\n > print( \\\\\"viewport=\\\\\",viewport )\n > \n > cam = viewport.camera()\n > if cam:\n > print( \\\\\"camera=%s\n\n \\\\\"%(cam.name()) )\n > \n > curSceneViewer = [item for item in hou.ui.curDesktop().currentPaneTabs() if item.type() == hou.paneTabType.SceneViewer][0]\n > curSceneViewer.curViewport().addEventCallback(onViewportCB)\n\n '''\n def removeEventCallback(self, callback: Callable[[dict[str, Any]], None]) -> None:\n \"\"\"\n\n removeEventCallback(self,callback)\n\n Remove a specific Python callback that have been registered with\n hou.GeometryViewport.addEventCallback.\n\n\n \"\"\"\n def clearEventCallbacks(self) -> None:\n \"\"\"\n\n clearEventCallbacks(self)\n\n Remove all Python callbacks that have been registered with\n hou.GeometryViewport.addEventCallback.\n\n\n \"\"\"\n def eventCallbacks(self) -> Tuple[Callable[[dict[str, Any]], None],...]:\n \"\"\"\n\n eventCallbacks(self) -> tuple of callbacks\n\n Return a tuple of all the Python callbacks that have been registered\n with hou.GeometryViewport.addEventCallback.\n\n\n \"\"\"\n\nclass GeometryViewportCamera:\n \"\"\"\n\n hou.GeometryViewportCamera\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def stash(self) -> GeometryViewportCamera:\n \"\"\"\n\n stash(self) -> hou.GeometryViewportCamera\n\n Create a copy of the camera settings which can be used to store the\n view, usually so it can be restored later. Stashed camera settings\n are not connected to a viewport, so modifying them will have no\n effect on the viewport until it is passed to the viewport via\n hou.GeometryViewport.setDefaultCamera().\n\n\n \"\"\"\n def setPerspective(self, perspective: bool) -> None:\n \"\"\"\n\n setPerspective(self, perspective)\n\n Set the camera view to perspective (True) or orthographic (False).\n Fixed orthographics views cannot be changed to perspective (Top,\n Bottom, Left, Right, Front, and Back).\n\n\n \"\"\"\n def isPerspective(self) -> bool:\n \"\"\"\n\n isPerspective(self) -> bool\n\n Query if the camara view uses a perspective projection.\n\n\n \"\"\"\n def isOrthographic(self) -> bool:\n \"\"\"\n\n isOrthographic(self) -> bool\n\n Query if the camara view uses an orthographic projection.\n\n\n \"\"\"\n def setAperture(self, ap: float) -> None:\n \"\"\"\n\n setAperture(self, ap)\n\n Set the aperture of the viewport camera. Throws an error if the\n viewport is looking though camera object and the view is not locked\n to that camera.\n\n\n \"\"\"\n def aperture(self) -> float:\n \"\"\"\n\n aperture(self) -> float\n\n Query the aperture of the viewport camera (or current camera).\n\n\n \"\"\"\n def setFocalLength(self, fl: float) -> None:\n \"\"\"\n\n setFocalLength(self, fl)\n\n Set the focal length of the viewport camera. Throws an error if the\n viewport is looking though camera object and the view is not locked\n to that camera.\n\n\n \"\"\"\n def focalLength(self) -> float:\n \"\"\"\n\n focalLength(self) -> float\n\n Query the focal length of the viewport camera (or current camera).\n\n\n \"\"\"\n def focalUnitScale(self) -> float:\n \"\"\"\n\n focalUnitScale(self) -> float\n\n Query the scale which needs to be applied to aperture and focal\n length due to the Focal Units parameter on the Camera object.\n\n\n \"\"\"\n def setAspectRatio(self, ar: float) -> None:\n \"\"\"\n\n setAspectRatio(self, ar)\n\n Set the view aspect ratio of the viewport camera (16:9 would be\n 1.777). Throws an error if the viewport is looking though camera\n object and the view is not locked to that camera.\n\n\n \"\"\"\n def aspectRatio(self) -> float:\n \"\"\"\n\n aspectRatio(self) -> float\n\n\n \"\"\"\n def setOrthoWidth(self, ow: float) -> None:\n \"\"\"\n\n setOrthoWidth(self, ow)\n\n Set the orthographic width of the viewport camera. Throws an error\n if the viewport is looking though camera object and the view is not\n locked to that camera. This has no effect on perspective cameras.\n\n\n \"\"\"\n def orthoWidth(self) -> float:\n \"\"\"\n\n orthoWidth(self) -> float\n\n\n \"\"\"\n def setRotation(self, mat: Matrix3) -> None: ...\n def rotation(self) -> Matrix3: ...\n def setTranslation(self, xyz: Sequence[float]) -> None:\n \"\"\"\n\n setTranslation(self, xyz)\n\n\n \"\"\"\n def translation(self) -> Tuple[float, ...]:\n \"\"\"\n\n translation(self) -> 3-tuple of float\n\n Query the translation (position) of the viewport camera.\n\n\n \"\"\"\n def setPivot(self, xyz: Sequence[float]) -> None:\n \"\"\"\n\n setPivot(self, xyz)\n\n\n \"\"\"\n def pivot(self) -> Tuple[float, ...]:\n \"\"\"\n\n pivot(self) -> 3-tuple of float\n\n Query the pivot of the viewport camera.\n\n\n \"\"\"\n def setClipPlanes(self, near_far: Sequence[float]) -> None:\n \"\"\"\n\n setClipPlanes(self, near_far)\n\n\n \"\"\"\n def clipPlanes(self) -> Tuple[float, ...]:\n \"\"\"\n\n clipPlanes(self) -> 2-tuple of float\n\n Query the clip planes of the viewport camera as (near,far).\n\n\n \"\"\"\n def setWindowOffset(self, xy: Sequence[float]) -> None:\n \"\"\"\n\n setWindowOffset(self, xy)\n\n\n \"\"\"\n def windowOffset(self) -> Tuple[float, ...]:\n \"\"\"\n\n windowOffset(self) -> 2-tuple of float\n\n Query the window offset of the viewport, in (0,1) space.\n\n\n \"\"\"\n def setWindowSize(self, size: Sequence[float]) -> None:\n \"\"\"\n\n setWindowSize(self, size)\n\n\n \"\"\"\n def windowSize(self) -> Tuple[float, ...]:\n \"\"\"\n\n windowSize(self) -> 2-tuple of float\n\n Query the window size of the viewport, in (0,1) space.\n\n\n \"\"\"\n\nclass GeometryViewportDisplaySet:\n \"\"\"\n\n hou.GeometryViewportDisplaySet\n\n A Display Set represents a group of 3D viewport display options that\n apply to a particular context of geometry.\n\n OVERVIEW\n\n In Houdini's 3D viewer display options window, you can apply\n different display options to certain subsets of objects/geometry,\n for example selected objects, or the displayed SOP. This object\n represents a set of options that apply to one of these subsets. For\n example, you can set templated SOPs to display as wireframe:\n\n > # Get a reference to the geometry viewer\n > pane = hou.ui.curDesktop().paneTabOfType(hou.paneTabType.SceneViewer)\n > \n > # Get the display settings\n > settings = pane.curViewport().settings()\n > \n > # Get the GeometryViewportDisplaySet for objects\n > tmplset = settings.displaySet(hou.displaySetType.TemplateModel)\n > \n > # Tell Houdini to show set the shading mode for this subset to wireframe\n > tmplset.setShadedMode(hou.glShadingType.Wire)\n\n There are several subsets available:\n\n Objects\n\n hou.displaySetType.SceneObject\n Object nodes which are not selected or ghosted.\n\n hou.displaySetType.SelectedObject\n Object nodes which are selected.\n\n hou.displaySetType.GhostObject\n Object nodes which ghosted, which occurs when they are visible\n when at the SOP level and Ghost Other Objects is the current\n object mode, but are not the current object.\n\n Geometry\n\n hou.displaySetType.DisplayModel\n SOP with the display flag. This takes precedence over\n TemplateModel and CurrentModel, if the SOP has either the\n template flag set or is selected.\n\n hou.displaySetType.CurrentModel\n SOP that is currently selected. This takes precedence over\n TemplateModel, if that SOP also has the template flag set.\n\n hou.displaySetType.TemplateModel\n SOP that has a template flag set.\n\n You can set the options in each display set independently of the\n other sets. You can also link a subset to another, so this subset\n uses the linked set's options.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def displaySetType(self) -> EnumValue:\n '''\n\n displaySetType() -> hou.displaySetType\n\n Returns the geometry context this display set represents:\n\n * hou.displaySetType.SceneObject - object nodes which are not selected\n or ghosted.\n\n * hou.displaySetType.SelectedObject - object nodes which are selected.\n\n * hou.displaySetType.GhostObject - object nodes which ghosted, which\n occurs when they are visible when at the SOP level and \\\\\"Ghost Other\n Objects\\\\\" is the current object mode, but are not the current object.\n\n * hou.displaySetType.DisplayModel - SOP with the display flag. This\n takes precedence over TemplateModel and CurrentModel, if the SOP has\n either the template flag set or is selected.\n\n * hou.displaySetType.CurrentModel - SOP that is currently selected.\n This takes precedence over TemplateModel, if that SOP also has the\n template flag set.\n\n * hou.displaySetType.TemplateModel - SOP that has a template flag set.\n\n\n '''\n def showPointMarkers(self, b: bool) -> None:\n \"\"\"\n\n showPointMarkers(self, on)\n\n Show or hide point markers.\n\n\n \"\"\"\n def isShowingPointMarkers(self) -> bool:\n \"\"\"\n\n isShowingPointMarkers(self) -> bool\n\n Query if point markers are shown (blue dots at points).\n\n\n \"\"\"\n def showPointNumbers(self, b: bool) -> None:\n \"\"\"\n\n showPointNumbers(self, on)\n\n Show or hide point numbers.\n\n\n \"\"\"\n def isShowingPointNumbers(self) -> bool:\n \"\"\"\n\n isShowingPointNumbers(self) -> bool\n\n Query if point numbers are shown as text (blue point numbers, one\n per point).\n\n\n \"\"\"\n def showPointNormals(self, b: bool) -> None:\n \"\"\"\n\n showPointNormals(self, on)\n\n Show or hide point normals.\n\n\n \"\"\"\n def isShowingPointNormals(self) -> bool:\n \"\"\"\n\n isShowingPointNormals(self) -> bool\n\n Query if point normals are shown.\n\n If the point normals are blue, the geometry has point normals. If\n they are dimmed, the model does not have normals and the normals\n shown have been automatically generated for display. If no normals\n are shown, the geometry has vertex normals. This query does not\n check for those conditions, but just the current setting of the\n display option.\n\n\n \"\"\"\n def showPointPositions(self, b: bool) -> None:\n \"\"\"\n\n showPointPositions(self, on)\n\n Show or hide point position text display, drawn by each point.\n\n\n \"\"\"\n def isShowingPointPositions(self) -> bool:\n \"\"\"\n\n isShowingPointPositions(self) -> bool\n\n Query if 3D point positions are being shown, as text: (x,y,z).\n\n\n \"\"\"\n def showPointUVs(self, b: bool) -> None:\n \"\"\"\n\n showPointUVs(self, on)\n\n Show or hide point UVs. If the geometry does not have point UVs,\n nothing will be displayed (ie. no UVs or vertex UVs).\n\n\n \"\"\"\n def isShowingPointUVs(self) -> bool:\n \"\"\"\n\n isShowingPointUVs(self) -> bool\n\n Query if point texture coordinates are being shown, as text: (u,v).\n\n\n \"\"\"\n def showPointTrails(self, b: bool) -> None:\n \"\"\"\n\n showPointTrails(self, on)\n\n Show or hide point trails on all points. Geometry must have a\n velocity attribute v.\n\n\n \"\"\"\n def isShowingPointTrails(self) -> bool:\n \"\"\"\n\n isShowingPointTrails(self) -> bool\n\n Query if point trails are shown (based on the velocity v attribute).\n\n\n \"\"\"\n def showCoincidentPoints(self, b: bool) -> None:\n \"\"\"\n\n showCoincidentPoints(self, on)\n\n Enable or disable coincident point detection. Orange points markers\n and a duplicate count are placed where coincident points are\n detected.\n\n Coincident point detection has affects viewport performance more\n significantly than other markers. It is best used when zoomed in on\n an area of the geometry for dense meshes, to avoid false positives.\n\n\n NOTE\n Coincident point detection has affects viewport performance more\n significantly than other markers. It is best used when zoomed in\n on an area of the geometry for dense meshes, to avoid false\n positives.\n\n\n \"\"\"\n def isShowingCoincidentPoints(self) -> bool:\n \"\"\"\n\n isShowingCoincidentPoints(self) -> bool\n\n Query if coincident point detection is enabled (yellow points and a\n duplicate count where coincident points are detected).\n\n\n \"\"\"\n def showPrimHulls(self, b: bool) -> None:\n \"\"\"\n\n showPrimHulls(self, on)\n\n Enable or disable primitive hulls. Only certain primitive types have\n hulls, such as NURBS, volumes, agents, and bezier curves.\n\n\n \"\"\"\n def isShowingPrimHulls(self) -> bool:\n \"\"\"\n\n isShowingPrimHulls(self) -> bool\n\n Query if primitive hulls are shown. Only some primitives have hulls,\n such as volumes, NURBS, crowd agents, and bezier curves.\n\n\n \"\"\"\n def showPrimNumbers(self, b: bool) -> None:\n \"\"\"\n\n showPrimNumbers(self, on)\n\n Enable or disable the display of primitive numbers, which are shown\n in the middle of the primitive.\n\n\n \"\"\"\n def isShowingPrimNumbers(self) -> bool:\n \"\"\"\n\n isShowingPrimNumbers(self) -> bool\n\n Query if primitive numbers are shown. The primitive numbers can be\n used to specify primitives in primitive groups. The number is shown\n at the center of the primitive.\n\n\n \"\"\"\n def showPrimNormals(self, b: bool) -> None:\n \"\"\"\n\n showPrimNormals(self, on)\n\n Enable or disable primitive face normals. This shows the face\n normals of polygons, not the value of a primitive N attribute.\n\n\n \"\"\"\n def isShowingPrimNormals(self) -> bool:\n \"\"\"\n\n isShowingPrimNormals(self) -> bool\n\n Query if the primitive face normals are shown. Only polygon-based\n primitives have face normals.\n\n\n \"\"\"\n def showPrimProfiles(self, b: bool) -> None:\n \"\"\"\n\n showPrimProfiles(self, on)\n\n Enable or disable profile curve display on NURBS surfaces.\n\n\n \"\"\"\n def isShowingPrimProfiles(self) -> bool:\n \"\"\"\n\n isShowingPrimProfiles(self) -> bool\n\n Query if profile curves are shown, on NURBS surfaces only.\n\n\n \"\"\"\n def showPrimBreakpoints(self, b: bool) -> None:\n \"\"\"\n\n showPrimBreakpoints(self, on)\n\n Enable or disable breakpoints display. Breakpoints are only\n available on NURBS and bezier surfaces and curves, and appear as\n hollow circles along the isoparms.\n\n\n \"\"\"\n def isShowingPrimBreakpoints(self) -> bool:\n \"\"\"\n\n isShowingPrimBreakpoints(self) -> bool\n\n Query if breakpoints are displayed. Breakpoints are only available\n on NURBS and bezier surfaces and curves.\n\n\n \"\"\"\n def showPrimProfileNumbers(self, b: bool) -> None:\n \"\"\"\n\n showPrimProfileNumbers(self, on)\n\n Enable or disable profile curve number display on NURBS surfaces.\n Each profile on a NURBS surface has an index from 0 to #profiles-1.\n\n\n \"\"\"\n def isShowingPrimProfileNumbers(self) -> bool:\n \"\"\"\n\n isShowingPrimProfileNumbers(self) -> bool\n\n Query if profile curve numbers are shown, on NURBS surfaces only.\n Each profile curve has an index from 0 to #profiles-1.\n\n\n \"\"\"\n def showPrimBackfaces(self, b: bool) -> None:\n \"\"\"\n\n showPrimBackfaces(self, on)\n\n Enable to tint backfacing polygons to distinguish them from front\n facing polygons.\n\n\n \"\"\"\n def isShowingPrimBackfaces(self) -> bool:\n \"\"\"\n\n isShowingPrimBackfaces(self) -> bool\n\n Query if backfacing polygons are tinted to distinguish them from\n front facing polygons.\n\n\n \"\"\"\n def showVertexMarkers(self, b: bool) -> None:\n \"\"\"\n\n showVertexMarkers(self, on)\n\n Enable or disable vertex markers. Vertex markers are drawn as small\n squares inset into its parent polygon slightly.\n\n\n \"\"\"\n def isShowingVertexMarkers(self) -> bool:\n \"\"\"\n\n isShowingVertexMarkers(self) -> bool\n\n Query if vertex markers are shown. Vertex markers are inset into\n their polygon slightly, for ease of selection and selection display.\n The markers are small hollow squares. Not all primitive types have\n vertex markers.\n\n\n \"\"\"\n def showVertexNumbers(self, b: bool) -> None:\n \"\"\"\n\n showVertexNumbers(self, on)\n\n Enable or disable vertex numbers. Vertex numbers are drawn as\n numbers inset into its parent polygon slightly, ranging 0 to\n #edges-1.\n\n\n \"\"\"\n def isShowingVertexNumbers(self) -> bool:\n \"\"\"\n\n isShowingVertexNumbers(self) -> bool\n\n Query if vertex numbers are shown. Each vertex on a polygon or mesh\n is numbered 0 to #edges-1.\n\n\n \"\"\"\n def showVertexNormals(self, b: bool) -> None:\n \"\"\"\n\n showVertexNormals(self, on)\n\n Enable or disable vertex normal display. Vertex normals are drawn\n inset into its parent polygon slightly. The geometry must have\n vertex normals to be shown (vertex N).\n\n\n \"\"\"\n def isShowingVertexNormals(self) -> bool:\n \"\"\"\n\n isShowingVertexNormals(self) -> bool\n\n Query if vertex normals are shown. If the geometry does not have\n vertex normals, they will not be shown. The base of the vertex\n normal is inset slightly into its polygon to make it easier to see\n which polygon the normal is influencing.\n\n\n \"\"\"\n def showVertexUVs(self, b: bool) -> None:\n \"\"\"\n\n showVertexUVs(self, on)\n\n Enable or disable vertex UV texture display. Vertex UVs are drawn\n inset into its parent polygon. The geometry must have vertex texture\n coordinates to be shown (vertex uv).\n\n\n \"\"\"\n def isShowingVertexUVs(self) -> bool: ...\n def showUVBackfaces(self, b: bool) -> None:\n \"\"\"\n\n showUVBackfaces(self, on)\n\n Enable or disable UV backface highlighting in the UV viewport.\n Backfacing polygons would have the texture displayed on them\n backwards, from the point of view of the background image in the UV\n viewport.\n\n\n \"\"\"\n def isShowingUVBackfaces(self) -> bool:\n \"\"\"\n\n isShowingUVBackfaces(self) -> bool\n\n Query if UV Backface highlighting is enabled in the UV view.\n Highlight polygons that are facing away, as the texture will appear\n backwards on these polygons.\n\n\n \"\"\"\n def showUVOverlap(self, b: bool) -> None:\n \"\"\"\n\n showUVOverlap(self, on)\n\n Enable or disable highlighting of UV overlap. Areas of the texture\n that would be share the same UVs are highlighted.\n\n\n \"\"\"\n def isShowingUVOverlap(self) -> bool:\n \"\"\"\n\n isShowingUVOverlap(self) -> bool\n\n Query if the UV overlap is shown in the UV texture viewport. UV\n areas that reuse the same UV coordinates will be highlighted.\n\n\n \"\"\"\n def setPointMarkerVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPointMarkerVisibility(self, visibility)\n\n Controls how point markers are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only markers for selected points are\n shown.\n\n * hou.markerVisibility.AroundPointer: Markers close to the 3D point\n the mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Markers under the mouse cursor\n are shown.\n\n\n \"\"\"\n def pointMarkerVisibility(self) -> EnumValue:\n \"\"\"\n\n pointMarkerVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of point markers.\n\n\n \"\"\"\n def setPointNumberVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPointNumberVisibility(self, visibility)\n\n Controls how point numbers are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only numbers for selected points are\n shown.\n\n * hou.markerVisibility.AroundPointer: Numbers close to the 3D point\n the mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Numbers under the mouse cursor\n are shown.\n\n\n \"\"\"\n def pointNumberVisibility(self) -> EnumValue:\n \"\"\"\n\n pointNumberVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of point numbers.\n\n\n \"\"\"\n def setPointNormalVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPointNormalVisibility(self, visibility)\n\n Controls how point normals are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only normals for selected points are\n shown.\n\n * hou.markerVisibility.AroundPointer: Normals close to the 3D point\n the mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Normals under the mouse cursor\n are shown.\n\n\n \"\"\"\n def pointNormalVisibility(self) -> EnumValue:\n \"\"\"\n\n pointNormalVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of point normals.\n\n\n \"\"\"\n def setPointPositionVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPointPositionVisibility(self, visibility)\n\n Controls how point positions are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only positions for selected points\n are shown.\n\n * hou.markerVisibility.AroundPointer: Positions close to the 3D point\n the mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Positions under the mouse cursor\n are shown.\n\n\n \"\"\"\n def pointPositionVisibility(self) -> EnumValue:\n \"\"\"\n\n pointPositionVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of point UVs.\n\n\n \"\"\"\n def setPointUVVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPointUVVisibility(self, visibility)\n\n Controls how point UVs are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only UVs for selected points are\n shown.\n\n * hou.markerVisibility.AroundPointer: UVs close to the 3D point the\n mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: UVs under the mouse cursor are\n shown.\n\n\n \"\"\"\n def pointUVVisibility(self) -> EnumValue:\n \"\"\"\n\n pointUVVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of point UVs.\n\n\n \"\"\"\n def setPointTrailVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPointTrailVisibility(self, visibility)\n\n Controls how point trails are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only trails for selected points are\n shown.\n\n * hou.markerVisibility.AroundPointer: Trails close to the 3D point the\n mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Trails under the mouse cursor are\n shown.\n\n\n \"\"\"\n def pointTrailVisibility(self) -> EnumValue:\n \"\"\"\n\n pointTrailVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of point trails.\n\n\n \"\"\"\n def setPrimNumberVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPrimNumberVisibility(self, visibility)\n\n Controls how primitive numbers are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only numbers for selected primitives\n are shown.\n\n * hou.markerVisibility.AroundPointer: Numbers close to the 3D point\n the mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Numbers under the mouse cursor\n are shown.\n\n\n \"\"\"\n def primNumberVisibility(self) -> EnumValue:\n \"\"\"\n\n primNumberVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of primitive numbers.\n\n\n \"\"\"\n def setPrimNormalVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPrimNormalVisibility(self, visibility)\n\n Controls how primitive face normals are shown when displayed.\n\n * hou.markerVisibility.Always: All are shown.\n\n * hou.markerVisibility.Selected: Only normals for selected primitives\n are shown.\n\n * hou.markerVisibility.AroundPointer: Normals close to the 3D point\n the mouse cursor is currently over are shown.\n\n * hou.markerVisibility.UnderPointer: Normals under the mouse cursor\n are shown.\n\n\n \"\"\"\n def primNormalVisibility(self) -> EnumValue:\n \"\"\"\n\n primNormalVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of primitive normals.\n\n\n \"\"\"\n def setPrimBreakpointVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setPrimBreakpointVisibility(self, visibility)\n\n Controls how primitive breakpoints are shown when displayed.\n\n\n \"\"\"\n def primBreakpointVisibility(self) -> EnumValue:\n \"\"\"\n\n primBreakpointVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of primitive breakpoints.\n\n\n \"\"\"\n def setVertexMarkerVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setVertexMarkerVisibility(self, visibility)\n\n Controls how vertex markers are shown when displayed.\n\n\n \"\"\"\n def vertexMarkerVisibility(self) -> EnumValue:\n \"\"\"\n\n vertexMarkerVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of vertex markers.\n\n\n \"\"\"\n def setVertexNormalVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setVertexNormalVisibility(self, visibility)\n\n Controls how vertex normals are shown when displayed.\n\n\n \"\"\"\n def vertexNormalVisibility(self) -> EnumValue:\n \"\"\"\n\n vertexNormalVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of vertex normals.\n\n\n \"\"\"\n def setVertexNumberVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setVertexNumberVisibility(self, visibility)\n\n Controls how vertex numbers are shown when displayed.\n\n\n \"\"\"\n def vertexNumberVisibility(self) -> EnumValue:\n \"\"\"\n\n vertexNumberVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of vertex numbers.\n\n\n \"\"\"\n def setVertexUVVisibility(self, v: EnumValue) -> None:\n \"\"\"\n\n setVertexUVVisibility(self, visibility)\n\n Controls how vertex normals are shown when displayed.\n\n\n \"\"\"\n def vertexUVVisibility(self) -> EnumValue:\n \"\"\"\n\n vertexUVVisibility(self) -> hou.markerVisibility\n\n Query the visibility setting of vertex UVs.\n\n\n \"\"\"\n def useGhostedLook(self, b: bool) -> None:\n \"\"\"\n\n useGhostedLook(self, on)\n\n Make all geometry in the display set appear ghosted - slightly\n translucent. This allows geometry behind the ghosted to seen and de-\n emphasizes the ghosted geometry in the viewport. This is normal used\n to direct focus to other geometry (displayed SOP within an object,\n for example).\n\n\n \"\"\"\n def isUsingGhostedLook(self) -> bool:\n \"\"\"\n\n isUsingGhostedLook(self) -> bool\n\n Query if the display set is ghosted. Ghosted geometry appears\n translucent so that geometry behind it can be easily seen.\n\n\n \"\"\"\n def useFadedLook(self, b: bool) -> None:\n \"\"\"\n\n useFadedLook(self, on)\n\n Suppress geometry color (Cd attribute, point, primitive, or vertex)\n on the geometry in the display set.\n\n\n \"\"\"\n def isUsingFadedLook(self) -> bool:\n \"\"\"\n\n isUsingFadedLook(self) -> bool\n\n Query if the display set is faded. Faded geometry suppresses the\n display of geometry color.\n\n\n \"\"\"\n def useXRay(self, b: bool) -> None:\n \"\"\"\n\n useXRay(self, on)\n\n Draw the geometry in the display set as XRay, which draws the\n geometry normally if not occluded, and as a dimmed wireframe where\n occluded by other geometry.\n\n\n \"\"\"\n def isUsingXRay(self) -> bool:\n \"\"\"\n\n isUsingXRay(self) -> bool\n\n Query if the display set is drawn with XRay. XRay geometry will\n appear as a faded wireframe behind other geometry that occludes it.\n\n\n \"\"\"\n def useLighting(self, b: bool) -> None:\n \"\"\"\n\n useLighting(self, on)\n\n Enable lighting for the geometry in the display set. This works in\n conjunction with the global lighting mode in the viewport. Both this\n option and the global lighting mode must be set to a lighting mode\n in order to see lighting (ie, enabling Lighting on this display set\n will not cause it to be lit if the global viewport mode is No\n Lighting).\n\n\n \"\"\"\n def isUsingLighting(self) -> bool:\n \"\"\"\n\n isUsingLighting(self) -> bool\n\n Query if lighting is used for this display set. When off, the\n geometry is displayed without any lighting (often much brighter).\n\n\n \"\"\"\n def useUVMap(self, b: bool) -> None:\n \"\"\"\n\n useUVMap(self, on)\n\n Use a UV map texture for visualizing UVs when a model has UVs but no\n material assignment.\n\n\n \"\"\"\n def isUsingUVMap(self) -> bool:\n \"\"\"\n\n isUsingUVMap(self) -> bool\n\n Query if a UV map texture is used for visualizing UVs when a model\n has UVs but no material assignment.\n\n\n \"\"\"\n def setShadingModeLocked(self, b: bool) -> None:\n \"\"\"\n\n setShadingModeLocked(self, on)\n\n Locks the shading mode so that it cannot be changed by the user\n using the Shading Mode menu in the viewport or the wireframe toggle\n hotkey. Passing False unlocks the display set so that it follows the\n viewport's shading mode.\n\n\n \"\"\"\n def isShadingModeLocked(self) -> bool:\n \"\"\"\n\n isShadingModeLocked(self) -> bool\n\n Query if the shading mode is locked. When locked, changing the\n shading mode in the viewport will not affect the look of geometry in\n this display set.\n\n\n \"\"\"\n def setToolbarLinked(self, b: bool) -> None:\n \"\"\"\n\n setToolbarLinked(self, on)\n\n Link the display set's options to the option toggles in the right\n viewport toolbar. When linked, clicking a display option button on\n this toolbar will affect the corresponding option in this display\n set.\n\n\n \"\"\"\n def isToolbarLinked(self) -> bool:\n \"\"\"\n\n isToolbarLinked(self) -> bool\n\n Query if the display set is linked to the right viewport toolbar.\n When linked, clicking a display option button on this toolbar will\n affect the corresponding option in this display set.\n\n\n \"\"\"\n def setUniqueDisplaySet(self, b: bool) -> None:\n \"\"\"\n\n setUniqueDisplaySet(self, on)\n\n When True, remove any link from this display set to another display\n set. Its own settings will be used. Passing False has no effect; use\n setLinkToDisplaySet to link this set to another display set.\n\n\n \"\"\"\n def isUniqueDisplaySet(self) -> bool:\n \"\"\"\n\n isUniqueDisplaySet(self) -> bool\n\n A display set can be linked to another display set, so that all of\n its options are taken from that linked set rather than its own. This\n method returns True if the display set is unique, in that it is not\n linked to another display set, and False if the set refers to\n another display set.\n\n\n \"\"\"\n def setShadedMode(self, arg2: EnumValue) -> None:\n \"\"\"\n\n setShadedMode(self, shaded_mode)\n\n Sets the shading mode for this display set:\n\n * hou.glShadingType.WireBoundingBox: no geometry, only bounding box\n outline\n\n * hou.glShadingType.ShadedBoundingBox: no geometry, solid bounding box\n\n * hou.glShadingType.Wire: wireframe\n\n * hou.glShadingType.WireGhost: wireframe with muted hidden lines\n\n * hou.glShadingType.HiddenLineInvisible: wireframe with hidden lines\n\n * hou.glShadingType.HiddenLineGhost: wireframe with solid constant\n faces\n\n * hou.glShadingType.Flat: shaded with primitive face normals\n\n * hou.glShadingType.FlatWire: shaded with primitive face normals,\n outlined polygons\n\n * hou.glShadingType.Smooth: shaded with point or vertex normals\n\n * hou.glShadingType.SmoothWire: shaded with point or vertex normals,\n outlined polygons\n\n\n \"\"\"\n def shadedMode(self) -> EnumValue:\n \"\"\"\n\n shadedMode(self) -> hou.glShadingType\n\n Query the shading mode of the display set (hou.glShadingType):\n\n * hou.glShadingType.WireBoundingBox: no geometry, only bounding box\n outline\n\n * hou.glShadingType.ShadedBoundingBox: no geometry, solid bounding box\n\n * hou.glShadingType.Wire: wireframe\n\n * hou.glShadingType.WireGhost: wireframe with muted hidden lines\n\n * hou.glShadingType.HiddenLineInvisible: wireframe with hidden lines\n\n * hou.glShadingType.HiddenLineGhost: wireframe with solid constant\n faces\n\n * hou.glShadingType.MatCap: shaded with a MatCap texture, ignores\n other lighting and shading.\n\n * hou.glShadingType.MatCapWire: shaded MatCap texture, outlined\n polygons\n\n * hou.glShadingType.Flat: shaded with primitive face normals\n\n * hou.glShadingType.FlatWire: shaded with primitive face normals,\n outlined polygons\n\n * hou.glShadingType.Smooth: shaded with point or vertex normals\n\n * hou.glShadingType.SmoothWire: shaded with point or vertex normals,\n outlined polygons\n\n\n \"\"\"\n def setBoundaryMode(self, arg2: EnumValue) -> None:\n \"\"\"\n\n setBoundaryMode(self, hou.boundaryDisplay)\n\n Set the viewport types that highlight 3D boundaries for the geometry\n in the display set.\n\n * hou.boundaryDisplay.Off:\n\n No 3D boundaries are displayed.\n\n * hou.boundaryDisplay.On:\n\n 3D boundaries are shown in all viewports.\n\n * hou.boundaryDisplay.View3D:\n\n 3D boundaries are shown in 3D viewports only.\n\n * hou.boundaryDisplay.ViewUV: .\n\n 3D boundaries are shown in UV viewports only.\n\n\n \"\"\"\n def boundaryMode(self) -> EnumValue:\n \"\"\"\n\n boundaryMode(self) -> hou.boundaryDisplay\n\n Query which viewport types display 3D boundaries\n (hou.boundaryDisplay).\n\n * hou.boundaryDisplay.Off:\n\n No 3D boundaries are displayed.\n\n * hou.boundaryDisplay.On:\n\n 3D boundaries are shown in all viewports.\n\n * hou.boundaryDisplay.View3D:\n\n 3D boundaries are shown in 3D viewports only.\n\n * hou.boundaryDisplay.ViewUV: .\n\n 3D boundaries are shown in UV viewports only.\n\n\n \"\"\"\n def setUVBoundaryMode(self, arg2: EnumValue) -> None:\n \"\"\"\n\n setUVBoundaryMode(self, hou.boundaryDisplay)\n\n Set viewport types that highlight UV boundaries for the geometry in\n the display set.\n\n * hou.boundaryDisplay.Off:\n\n No UV boundaries are displayed.\n\n * hou.boundaryDisplay.On:\n\n UV boundaries are shown in all viewports.\n\n * hou.boundaryDisplay.View3D:\n\n UV boundaries are shown in 3D viewports only.\n\n * hou.boundaryDisplay.ViewUV: .\n\n UV boundaries are shown in UV viewports only.\n\n\n \"\"\"\n def uvBoundaryMode(self) -> EnumValue:\n \"\"\"\n\n uvBoundaryMode(self) -> hou.boundaryDisplay\n\n Query which viewport types display UV boundaries\n (hou.boundaryDisplay).\n\n * hou.boundaryDisplay.Off:\n\n No UV boundaries are displayed.\n\n * hou.boundaryDisplay.On:\n\n UV boundaries are shown in all viewports.\n\n * hou.boundaryDisplay.View3D:\n\n UV boundaries are shown in 3D viewports only.\n\n * hou.boundaryDisplay.ViewUV: .\n\n UV boundaries are shown in UV viewports only.\n\n\n \"\"\"\n def setLinkToDisplaySet(self, arg2: EnumValue) -> None:\n \"\"\"\n\n setLinkToDisplaySet(self, view_display_set)\n\n Link this display set to the settings of another display set. This\n display set's option settings are then ignored, and the other sets\n are used in their place. Linking a set to itself restores its own\n settings.\n\n * hou.displaySetType.SceneObject\n\n * hou.displaySetType.SelectedObject\n\n * hou.displaySetType.GhostObject\n\n * hou.displaySetType.DisplayModel\n\n * hou.displaySetType.CurrentModel\n\n * hou.displaySetType.TemplateModel\n\n\n \"\"\"\n def linkedToDisplaySet(self) -> EnumValue:\n \"\"\"\n\n linkedToDisplaySet(self) -> hou.displaySetType\n\n A display set can be linked to another display set, so that all of\n its options are taken from that linked set rather than its own. This\n method returns the display set this set is linked to. If it is not\n linked to another set, it will return the its own set.\n\n\n \"\"\"\n\nclass GeometryViewportSettings:\n '''\n\n hou.GeometryViewportSettings\n\n A collection of settings controlling a viewport\\'s view of the scene\n (such as the view angle and whether different guides are displayed).\n Many of this object\\'s methods correspond to settings in the Display\n Options dialog.\n\n OVERVIEW\n\n\n To access a viewport, you must first get a reference to a Scene\n Viewer pane tab. See the following methods:\n\n\n hou.ui.paneTabOfType\n Use hou.ui.paneTabOfType(hou.paneTabType.SceneViewer) to get\n a reference to a Scene Viewer pane tab in the current pane\n layout. If the current layout has no Scene Viewer pane tab,\n this returns None.\n\n To be more precise about which viewer you grab in a possible\n multi-viewer layout, see also hou.ui.curDesktop to get a\n hou.Desktop object representing the current pane layout, and\n hou.Desktop.sceneViewers to get a list of scene viewer pane\n tabs in the current layout.\n\n Once you have a reference to a hou.SceneViewer pane object, you\n can use it to access the viewer pane\\'s viewport or viewports.\n See the following methods:\n\n\n hou.SceneViewer.viewports\n Returns a list of the viewports in the viewer pane.\n\n hou.SceneViewer.findViewport\n Gets a single viewport by name, for example \\\\\"Top\\\\\".\n\n hou.SceneViewer.selectedViewport\n Gets the currently selected viewport. The user can select a\n viewport by pressing [Space + N] in the viewport. The view\n menus in the upper right corner are drawn brighter in the\n selected viewport.\n\n You can then get a GeometryViewportSettings object for the viewport\n by calling hou.GeometryViewport.settings.\n\n\n TIP\n Some of the more commonly-used methods, such as setting the view\n to look through a camera, are duplicated on the\n hou.GeometryViewport object for convenience.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def viewportType(self) -> EnumValue:\n \"\"\"\n\n viewportType(self) -> hou.geometryViewportType enum value\n\n Query the viewport type (UV, 3D, top, left, etc).\n\n\n \"\"\"\n def displaySet(self, settype: EnumValue) -> GeometryViewportDisplaySet:\n \"\"\"\n\n displaySet(self, display_set) -> hou.GeometryViewportDisplaySet\n\n Returns the hou.GeometryViewportDisplaySet object associated with\n display_set, which must be a type of hou.displaySetType. A display\n set describes a certain category of displayed geometry (for example,\n templated geometry, or current (selected) geometry). The associated\n GeometryViewportDisplaySet object lets you customize how that\n category of geometry is drawn in the viewport, for example\n wireframe/shaded, showing point numbers, and so on.\n\n\n \"\"\"\n def viewAspectRatio(self, masked: bool = True) -> float:\n \"\"\"\n\n viewAspectRatio(self, masked) -> float\n\n Query the actual viewport aspect ratio. If masked is True, return\n the aspect ratio of the area inside the camera mask, otherwise\n return the full viewport aspect ratio.\n\n\n \"\"\"\n def normalScale(self) -> float: ...\n def setNormalScale(self, normal_scale: float) -> None:\n \"\"\"\n\n setNormalScale(self, normal_scale)\n\n Set a scale factor for the display of normals to increase or\n decrease their length.\n\n\n \"\"\"\n def vectorScale(self) -> float:\n \"\"\"\n\n vectorScale(self) -> float\n\n Query the scale applied to the length of vector decorations.\n\n\n \"\"\"\n def setVectorScale(self, vec_scale: float) -> None:\n \"\"\"\n\n setVectorScale(self, scale)\n\n Set the scale applied to vector decorations, to make them longer or\n shorter.\n\n\n \"\"\"\n def pointMarkerSize(self) -> float:\n \"\"\"\n\n pointMarkerSize(self) -> float\n\n Queries the size of point marker decorations, in pixels.\n\n\n \"\"\"\n def setPointMarkerSize(self, psize: float) -> None:\n \"\"\"\n\n setPointMarkerSize(self, point_size)\n\n Set the size of point marker decorations, in pixels.\n\n\n \"\"\"\n def originGnomonSize(self) -> float:\n \"\"\"\n\n originGnomonSize(self) -> float\n\n Queries the world size of the gnomon axes that appear at the world\n origin.\n\n\n \"\"\"\n def setOriginGnomonSize(self, size: float) -> None:\n \"\"\"\n\n setOriginGnomonSize(self, size)\n\n Sets the world size of the gnomon axes that appear at the world\n origin.\n\n\n \"\"\"\n def floatingGnomonSize(self) -> float:\n \"\"\"\n\n floatingGnomonSize(self) -> float\n\n Queries the size of the gnomon axes that appear in the corner of the\n 3D viewport.\n\n\n \"\"\"\n def setFloatingGnomonSize(self, size: float) -> None:\n \"\"\"\n\n setFloatingGnomonSize(self, size)\n\n Sets the world size of the gnomon axes that appear in the corner of\n the 3D viewport.\n\n\n \"\"\"\n def camera(self) -> Optional[ObjNode]:\n \"\"\"\n\n camera(self) -> ObjNode or None\n\n Return the camera or light node that the viewport is looking\n through. Return None if the viewport is not looking through a camera\n or light node.\n\n\n \"\"\"\n def setCamera(self, camera_node: ObjNode) -> None:\n \"\"\"\n\n setCamera(self, camera_node)\n\n Makes the viewport look through the given camera node.\n\n\n \"\"\"\n def saveViewToCamera(self, camera_node: ObjNode) -> None:\n \"\"\"\n\n saveViewToCamera(self, camera_node)\n\n Saves the viewport's current view into the given camera node. It\n does this by setting the camera's transform parameters to match the\n viewport's view transform matrix.\n\n\n \"\"\"\n def geometryInfo(self, arg: EnumValue) -> EnumValue:\n \"\"\"\n\n geometryInfo(self, hou.viewportGeometryInfo)\n\n Queries the current geometry information display setting:\n\n * hou.viewportGeometryInfo.Off: No information displayed.\n\n * hou.viewportGeometryInfo.SelectedOnly: only display information if\n something is selected.\n\n * hou.viewportGeometryInfo.Always: Always display information.\n\n\n \"\"\"\n def handleHighlight(self, arg: EnumValue) -> EnumValue:\n \"\"\"\n\n handleHighlight(self, hou.viewportHandleHighlight)\n\n Sets the size of the handle highlight when the mouse is over a\n handle part:\n\n * hou.viewportHandleHighlight.Off: Handles do not show highlights.\n\n * hou.viewportHandleHighlight.Small: Handles have a subtle highlight.\n\n * hou.viewportHandleHighlight.Normal: Handles use their default\n highlight, which is twice the width of the small highlight.\n\n\n \"\"\"\n def closureSelection(self, arg: EnumValue) -> EnumValue:\n \"\"\"\n\n closureSelection(self, hou.viewportClosureSelection)\n\n Change the closure selection display setting. A Closure selection is\n shown on a primitive when any part of that primitive is selected.\n\n * hou.viewportClosureSelection.Hide: Do not show closure selections.\n\n * hou.viewportClosureSelection.HullPrimitives: Only show closure\n selections on primitives that have hulls which are disconnected from\n the tessellated surface or curve (such as a NURBS surface).\n\n * hou.viewportClosureSelection.Show: Show closure selections on all\n primitive types.\n\n\n \"\"\"\n def guideFontSize(self) -> EnumValue: ...\n def setOffsetVertexMarkers(self, enable: bool) -> None:\n \"\"\"\n\n setOffsetVertexMarkers(self, enable)\n\n When enabled, vertex markers and normals are inset into the polygon\n so they can be selected independently when part of a seamless mesh.\n When disabled, the markers and normals are placed at the actual\n vertex, potentially overlapping.\n\n\n \"\"\"\n def offsetVertexMarkers(self) -> bool:\n \"\"\"\n\n offsetVertexMarkers(self) -> bool\n\n When enabled, vertex markers and normals are inset into the polygon\n so they can be selected independently when part of a seamless mesh.\n When disabled, the markers and normals are placed at the actual\n vertex, potentially overlapping.\n\n\n \"\"\"\n def enableGuide(self, guide: EnumValue, enabled: bool) -> None:\n \"\"\"\n\n enableGuide(self, guide, on)\n\n Show or hide a guide. The guide argument must be a type of\n hou.viewportGuide.\n\n\n \"\"\"\n def guideEnabled(self, guide: EnumValue) -> bool:\n \"\"\"\n\n guideEnabled(self, guide) -> bool\n\n Test if a guide is visible. The guide argument must be a type of\n hou.viewportGuide.\n\n\n \"\"\"\n def levelOfDetail(self) -> float:\n \"\"\"\n\n levelOfDetail(self) -> double\n\n Query the current level of detail used for tessellating geometry.\n\n\n \"\"\"\n def volumeQuality(self) -> EnumValue:\n \"\"\"\n\n volumeQuality(self) -> hou.viewportVolumeQuality\n\n Query the volume display quality.\n\n * hou.viewportVolumeQuality.VeryLow: Very fast, low quality preview\n\n * hou.viewportVolumeQuality.Low: Fewer slices than Normal for speed\n\n * hou.viewportVolumeQuality.Normal: Good quality vs. speed setting.\n\n * hou.viewportVolumeQuality.High: Large number of slices with\n jittering\n\n\n \"\"\"\n def volumeAmbientShadows(self) -> float:\n \"\"\"\n\n volumeAmbientShadows(self) -> double\n\n Query the default intensity of self-shadowing for fog volumes from\n ambient light sources.\n\n\n \"\"\"\n def volumeBSplines(self) -> EnumValue:\n \"\"\"\n\n volumeBSplines(self) -> hou.viewportVolumeBSplines\n\n Query if higher order interpolation is used by the viewport to draw\n fog volumes.\n\n * hou.viewportVolumeBSplines.Off: the viewport will never use higher-\n order volume interpolation. This is the fastest to draw, but low\n resolution volumes may appear blocky in the viewport.\n\n * hou.viewportVolumeBSplines.NonInteractive: the viewport will use the\n higher-order interpolation when not interacting with the viewport.\n This mode falls back to linear interpolation while interacting with\n the viewport to speed up draws.\n\n * hou.viewportVolumeBSplines.On: the viewport will always use higher-\n order volume interpolation. This is the slowest, highest quality\n option.\n\n\n NOTE\n The equivalent setting in the viewport display options can be\n found in the Geometry tab and is labelled Volume Filtering.\n\n\n \"\"\"\n def volumeWireAsPoints(self) -> bool:\n \"\"\"\n\n volumeWireAsPoints(self) -> bool\n\n Query if volumes are currently drawn as a point field in wireframe.\n\n\n \"\"\"\n def polygonConvexQuality(self) -> bool:\n \"\"\"\n\n polygonConvexQuality(self) -> bool\n\n Query the polygon convexing quality, true for high quality and false\n for fast convexing.\n\n\n \"\"\"\n def subdivsionLimit(self) -> int:\n \"\"\"\n\n subdivsionLimit(self) -> int\n\n Returns the current subdivision polygon limit, in millions of\n polygons.\n\n\n \"\"\"\n def wireWidth(self) -> float:\n \"\"\"\n\n wireWidth(self) -> double\n\n Query the width of lines drawn for wireframe and wire-over-shaded\n modes.\n\n\n \"\"\"\n def wireBlend(self) -> float:\n \"\"\"\n\n wireBlend(self) -> double\n\n Query the blend factor between wires and the surface in wire-over-\n shaded modes. Values close to 0 produce very faint lines, values\n closer to 1 produce solid lines.\n\n\n \"\"\"\n def interiorWireAlpha(self) -> float:\n \"\"\"\n\n interiorWireAlpha(self) -> double\n\n Query the dimness of the interior wires in a tet mesh. Outer wires\n are drawn normally, inner wires are dimmed. This only affects tet\n meshes in wireframe mode.\n\n\n \"\"\"\n def shadeOpenCurves(self) -> bool:\n \"\"\"\n\n shadeOpenCurves(self) -> bool\n\n Query if shaded open curves are enabled or not.\n\n\n \"\"\"\n def selectWireframeAsSolid(self) -> bool:\n \"\"\"\n\n selectWireframeAsSolid(self) -> bool\n\n Query if selection of wireframe polygons is done by face (true) or\n edge (false).\n\n\n \"\"\"\n def setWireOverPackedGeo(self, wire_over_packed: bool) -> None:\n \"\"\"\n\n setWireOverPackedGeo(self, wire_over_packed)\n\n Show polygon outlines on meshes in packed geometry when drawing a\n wire-over-shaded mode. Disabling this hides the outlines on packed\n geometry, making meshes appear as a single shape, which packed\n geometry technically is.\n\n\n \"\"\"\n def wireOverPackedGeo(self) -> bool:\n \"\"\"\n\n wireOverPackedGeo(self) -> bool\n\n Query if polygon outlines are visible on packed geometry when a\n wire-over-shaded mode is active.\n\n\n \"\"\"\n def particleDisplayType(self) -> EnumValue:\n \"\"\"\n\n particleDisplayType(self) -> hou.viewportParticleDisplay\n\n Query the default particle display.\n\n * hou.viewportParticleDisplay.Points: Constant sized point marker,\n with the diameter specified by particlePointSize. This marker is\n unaffected by pscale.\n\n * hou.viewportParticleDisplay.Pixels: Single pixel drawn for a\n particle.\n\n * hou.viewportParticleDisplay.Lines: Streak trail plus marker.\n\n * hou.viewportParticleDisplay.Discs: World-space circle, affected by\n pscale or discSize.\n\n\n \"\"\"\n def allowParticleSprites(self) -> bool:\n \"\"\"\n\n allowParticleSprites(self) -> bool\n\n Query if particles are drawn as sprites when sprite attributes are\n detected on the particle (sprite* or shop_materialpath).\n\n\n \"\"\"\n def particlePointSize(self) -> float:\n \"\"\"\n\n particlePointSize(self) -> double\n\n Query the point diameter for particles drawn as Points or Lines.\n\n\n \"\"\"\n def particleDiscSize(self) -> float:\n \"\"\"\n\n particleDiscSize(self) -> double\n\n Query the disc diameter for particles drawn as Discs or Sprites if\n the pscale attribute does not exist. This is specified in world-\n space units.\n\n\n \"\"\"\n def orientDiscToNormal(self) -> bool:\n \"\"\"\n\n orientDiscToNormal(self) -> bool\n\n Queries if discs and sprites are oriented to the normal (true) or\n not. The normal will be orthogonal to the disc (they will face in\n that direction).\n\n\n \"\"\"\n def spriteTextureLimit(self) -> Tuple[int,...]:\n \"\"\"\n\n spriteTextureLimit(self) -> tuple of int\n\n Query the maximum texture resolution for sprites. This is primarily\n a performance vs. quality trade-off option. Larger sprites look\n better but may cause slowdowns for large particle systems.\n\n\n \"\"\"\n def pointInstancing(self) -> bool:\n \"\"\"\n\n pointInstancing(self) -> bool\n\n Query if point instancing is globally enabled.\n\n\n \"\"\"\n def pointInstancingPercent(self) -> float:\n \"\"\"\n\n pointInstancingPercent(self) -> double\n\n Query the percentage of instances shown in the viewport for point\n instancing.\n\n\n \"\"\"\n def pointInstancingLimit(self) -> int:\n \"\"\"\n\n pointInstancingLimit(self) -> int\n\n Query the current polygon limit for instancing.\n\n\n \"\"\"\n def instanceStandInGeometry(self) -> EnumValue:\n \"\"\"\n\n instanceStandInGeometry(self) -> hou.viewportStandInGeometry\n\n Query the current stand-in geometry for culled instances.\n\n * hou.viewportStandInGeometry.DisplayOff: Show nothing for culled\n instances.\n\n * hou.viewportStandInGeometry.LocationMarker: Show a location marker\n at the local space origin of each instanced.\n\n * hou.viewportStandInGeometry.BoundingBox: Show the culled instances'\n bounding boxes.\n\n\n \"\"\"\n def autoGenerateVertexNormals(self) -> bool:\n \"\"\"\n\n autoGenerateVertexNormals(self) -> bool\n\n Query if vertex normals are produced when geometry is missing\n normals. If false, point numbers are produced.\n\n\n \"\"\"\n def vertexNormalCuspAngle(self) -> float:\n \"\"\"\n\n vertexNormalCuspAngle(self) -> double\n\n Query the cusp angle for vertex normal generation. Any shared edge\n between polygons will be considered a hard edge if the polygon faces\n differ by more than this angle, otherwise the normals will be smooth\n over the edge.\n\n\n \"\"\"\n def vertexNormalLimit(self) -> int:\n \"\"\"\n\n vertexNormalLimit(self) -> int\n\n Query the polygon limit for generating vertex normals, in millions\n of polygons.\n\n\n \"\"\"\n def setSceneAntialias(self, aa: int) -> None:\n \"\"\"\n\n setSceneAntialias(self, aalevel)\n\n Sets the viewports full-scene antialiasing level to one of 1, 2, 4,\n 8, 16, 32, 64, or 128. This represents the number of samples\n rendered to produce a higher quality image. Higher numbers produce\n better antialiasing, but this can affect the viewport's rendering\n performance. Some graphics hardware only support a subset of these\n modes (eg. up to 8 or 32).\n\n\n \"\"\"\n def sceneAntialias(self) -> int:\n \"\"\"\n\n sceneAntialias(self)\n\n Returns the number of samples used to antialias the viewport.\n Possible values are 1 (no antialiasing), 2, 4 (default for most\n hardware), 8, 16, 32, 64, or 128.\n\n\n \"\"\"\n def setHdrRendering(self, hdr: bool) -> None:\n \"\"\"\n\n hdrRendering(self) -> bool\n\n Queries if High Dynamic Range (HDR) rendering is enabled.\n\n\n \"\"\"\n def hdrRendering(self) -> bool: ...\n def setXrayDrawing(self, global_enable: bool) -> None:\n \"\"\"\n\n setXrayDrawing(self, global_enable)\n\n Globally enable or disable X-ray drawing. Object must have their\n X-ray flag set in order to render as X-ray. X-ray causes the object\n to be visible when occluded.\n\n\n \"\"\"\n def xrayDrawing(self) -> bool:\n \"\"\"\n\n xrayDrawing(self) -> bool\n\n Query if X-ray drawing is enabled globally.\n\n\n \"\"\"\n def setXrayQuality(self, quality: bool) -> None:\n \"\"\"\n\n setXrayQuality(self, quality)\n\n Enable high-quality X-ray rendering, which draws X-rayed objects as\n dimmed shaded surfaces when occluded, with up to 8 levels of overlap\n between X-rayed objects. This looks better but takes longer to\n render. Regular X-ray rendering displays X-ray objects as wireframe\n when occluded.\n\n\n \"\"\"\n def xrayQuality(self) -> bool:\n \"\"\"\n\n xrayQuality(self) -> bool\n\n Queries if high quality X-ray rendering is active.\n\n\n \"\"\"\n def setXrayStrength(self, strength: float) -> None:\n \"\"\"\n\n setXrayStrength(self, strength)\n\n Sets the strength of the occluded x-ray objects. Lower values make\n occluded X-ray objects dimmer.\n\n\n \"\"\"\n def xrayStrength(self) -> float:\n \"\"\"\n\n xrayStrength(self) -> double\n\n Query the strength of occluded x-ray objects.\n\n\n \"\"\"\n def setObjectOrigins(self, globel_enable: bool) -> None:\n \"\"\"\n\n setObjectOrigins(self, globel_enable)\n\n Globally allow object origins to be displayed. Object origins are\n enabled by setting the Origin flag on objects.\n\n\n \"\"\"\n def objectOrigins(self) -> bool:\n \"\"\"\n\n objectOrigins(self) -> bool\n\n Query if object origin display is globally enabled.\n\n\n \"\"\"\n def setOnionSkinning(self, global_enable: bool) -> None:\n \"\"\"\n\n setOnionSkinning(self, global_enable)\n\n Globally allow onion skinning to be displayed. Onion skinning is\n enabled on a per-object basis in the Misc tab of objects. This shows\n animation as a series of ghosted poses at other frames around the\n current frame.\n\n\n \"\"\"\n def onionSkinning(self) -> bool:\n \"\"\"\n\n onionSkinning(self) -> bool\n\n Query if onion skinning is globally enabled.\n\n\n \"\"\"\n def setOnionSkinFramesBeforeCount(self, num_frames: int) -> None:\n \"\"\"\n\n setOnionSkinFramesBeforeCount(self, num_frames)\n\n Set the number of onion skins before the current frame. Their\n spacing depends on the onion skin frame increment.\n\n\n \"\"\"\n def onionSkinFramesBeforeCount(self) -> int:\n \"\"\"\n\n onionSkinFramesBeforeCount(self) -> int\n\n Queries the number of onion skins before the current frame.\n\n\n \"\"\"\n def setOnionSkinFramesBeforeTint(self, tint: Color) -> None:\n \"\"\"\n\n setOnionSkinFramesBeforeTint(self, tint)\n\n Tint all onion skins that appear before the current frame with this\n color.\n\n\n \"\"\"\n def onionSkinFramesBeforeTint(self) -> Color:\n \"\"\"\n\n onionSkinFramesBeforeTint(self) -> tuple of double\n\n Query the tint color of skins that appear before the current frame.\n\n\n \"\"\"\n def setOnionSkinFramesAfterCount(self, num_frames: int) -> None:\n \"\"\"\n\n setOnionSkinFramesAfterCount(self, num_frames)\n\n Set the number of onion skins after the current frame. Their spacing\n depends on the onion skin frame increment.\n\n\n \"\"\"\n def onionSkinFramesAfterCount(self) -> int:\n \"\"\"\n\n onionSkinFramesAfterCount(self) -> int\n\n Queries the number of onion skins after the current frame.\n\n\n \"\"\"\n def setOnionSkinFramesAfterTint(self, tint: Color) -> None:\n \"\"\"\n\n setOnionSkinFramesAfterTint(self, tint)\n\n Tint all onion skins that appear after the current frame with this\n color.\n\n\n \"\"\"\n def onionSkinFramesAfterTint(self) -> Color:\n \"\"\"\n\n onionSkinFramesAfterTint(self) -> tuple of double\n\n Query the tint color of skins that appear after the current frame.\n\n\n \"\"\"\n def setOnionSkinFrameIncrement(self, frame_increment: int) -> None:\n \"\"\"\n\n setOnionSkinFrameIncrement(self, frame_increment)\n\n Set the frame increment between onion skins. Using 1 will draw every\n frame around the current frame ($F-2 $F-1 $F $F+1 $F+2, while 5\n would step by 5 ($F-10 $F-5 $F $F+5 $F+10).\n\n\n \"\"\"\n def onionSkinFrameIncrement(self) -> int:\n \"\"\"\n\n onionSkinFrameIncrement(self) -> int\n\n Query the frame increment between onion skins.\n\n\n \"\"\"\n def setOnionSkinOpacity(self, opacity: float) -> None:\n \"\"\"\n\n setOnionSkinOpacity(self, opacity)\n\n Set the opacity of the onion skins to make them more or less\n prominent.\n\n\n \"\"\"\n def onionSkinOpacity(self) -> float:\n \"\"\"\n\n onionSkinOpacity(self) -> double\n\n Query the current onion skin opacity.\n\n\n \"\"\"\n def setSceneGamma(self, gamma: float) -> None:\n \"\"\"\n\n setSceneGamma(self, gamma)\n\n Set the gamma correction for the scene. This value should match the\n calibrated gamma of the display device.\n\n\n \"\"\"\n def sceneGamma(self) -> float:\n \"\"\"\n\n sceneGamma(self) -> double\n\n Query the scene gamma correction.\n\n\n \"\"\"\n def setUseSceneLUT(self, enable: bool) -> None:\n \"\"\"\n\n setUseSceneLUT(self, enable)\n\n Enable Lookup Table (LUT) color correction. A valid LUT file must\n also be present.\n\n\n \"\"\"\n def useSceneLUT(self) -> bool:\n \"\"\"\n\n useSceneLUT(self) -> bool\n\n Query if Lookup Table color correction is enabled. This will return\n True even no LUT file exists.\n\n\n \"\"\"\n def setSceneLUT(self, lut_file: str) -> None:\n \"\"\"\n\n setSceneLUT(self, lut_file)\n\n Specify a Lookup Table (LUT) file to use for color correction.\n\n\n \"\"\"\n def sceneLUT(self) -> str:\n \"\"\"\n\n sceneLUT(self) -> str\n\n Query the current Lookup Table (LUT) file.\n\n\n \"\"\"\n def setBackgroundImageGammaLUT(self, apply_to_bg: bool) -> None:\n \"\"\"\n\n setBackgroundImageGammaLUT(self, apply_to_bg)\n\n Apply gamma and Lookup Table (LUT) color correction to the\n background image.\n\n\n \"\"\"\n def backgroundImageGammaLUT(self) -> bool:\n \"\"\"\n\n backgroundImageGammaLUT(self) -> bool\n\n Query if color correction is applied to the background image.\n\n\n \"\"\"\n def setDepthOfField(self, enable: bool) -> None:\n \"\"\"\n\n setDepthOfField(self, enable)\n\n Enable depth of field effect (also requires the viewport look\n through a camera with a non-zero fstop).\n\n\n \"\"\"\n def getDepthOfField(self) -> bool:\n \"\"\"\n\n getDepthOfField(self) -> bool\n\n Query if the Depth of Field setting is enabled.\n\n\n \"\"\"\n def setDepthOfFieldBokeh(self, viewportDOFBokeh: EnumValue) -> None:\n \"\"\"\n\n setDepthOfFieldBokeh(self, viewportDOFBokeh)\n\n Set the bokeh effect.\n\n * hou.viewportDOFBokeh.NoBokeh:\n\n No additional bokeh effect.\n\n * hou.viewportDOFBokeh.Circular:\n\n Circular bokeh (can also be oval if the aspect is adjusted).\n\n * hou.viewportDOFBokeh.Texture:\n\n Use a texture, either from a image file or COP (using the op:\n syntax).\n\n\n \"\"\"\n def getDepthOfFieldBokeh(self) -> EnumValue:\n \"\"\"\n\n getDepthOfFieldBokeh(self) -> hou.EnumValue\n\n Query the current bokeh effect state.\n\n\n \"\"\"\n def setDepthOfFieldBokehTexture(self, file_or_node: str) -> None:\n \"\"\"\n\n setDepthOfFieldBokehTexture(self, file_or_node)\n\n Set the path to an image file or COP node to use as the bokeh shape.\n COP references use the op: syntax.\n\n\n \"\"\"\n def getDepthOfFieldBokehTexture(self) -> str:\n \"\"\"\n\n getDepthOfFieldBokehTexture(self) -> str\n\n Return the file or COP path of the bokeh shape.\n\n\n \"\"\"\n def setDepthOfFieldBokehBoost(self, boost: float) -> None:\n \"\"\"\n\n setDepthOfFieldBokehBoost(self, boost)\n\n Boost the brightness of the image to produce more more and brighter\n bokeh shapes.\n\n\n \"\"\"\n def getDepthOfFieldBokehBoost(self) -> float:\n \"\"\"\n\n getDepthOfFieldBokehBoost(self) -> float\n\n Query the current bokeh boost.\n\n\n \"\"\"\n def setDepthOfFieldBokehAspect(self, aspect: float) -> None:\n \"\"\"\n\n setDepthOfFieldBokehAspect(self, aspect)\n\n Set the aspect ratio (width/height) of the bokeh shape.\n\n\n \"\"\"\n def getDepthOfFieldBokehAspect(self) -> float:\n \"\"\"\n\n getDepthOfFieldBokehAspect(self) -> float\n\n Query the current bokeh aspect ratio.\n\n\n \"\"\"\n def showsName(self, show: bool) -> None:\n \"\"\"\n\n showsName(self, show)\n\n Display the viewport name and menu in the upper right corner.\n\n\n \"\"\"\n def showName(self) -> bool:\n \"\"\"\n\n showName(self) -> bool\n\n Query if the viewport name menu is displayed.\n\n\n \"\"\"\n def showsCameraName(self, show: bool) -> None:\n \"\"\"\n\n showsCameraName(self, show)\n\n Display the camera name and menu in the upper right corner.\n\n\n \"\"\"\n def showCameraName(self) -> bool:\n \"\"\"\n\n showCameraName(self) -> bool\n\n Query if the camera name menu is displayed.\n\n\n \"\"\"\n def showsStateStatus(self, show: bool) -> None:\n \"\"\"\n\n showsStateStatus(self, show)\n\n Display any status messages of the current tool.\n\n\n \"\"\"\n def showStateStatus(self) -> bool:\n \"\"\"\n\n showStateStatus(self) -> bool\n\n Query if the tool status messages are displayed.\n\n\n \"\"\"\n def showsBadges(self, show: bool) -> None:\n \"\"\"\n\n showsBadges(self, show)\n\n Display viewport status badges as icons beside the camera menu,\n which presents additional state information.\n\n\n \"\"\"\n def showBadges(self) -> bool:\n \"\"\"\n\n showBadges(self) -> bool\n\n Query if viewport status badges are displayed. Badges are icons\n which present additional state information.\n\n\n \"\"\"\n def useAspectRatio(self, enable: bool) -> None:\n \"\"\"\n\n useAspectRatio(self, enable)\n\n Enforce a specific aspect ratio for the viewport, which will add\n bars if the viewport aspect ratio does not match.\n\n\n \"\"\"\n def usingAspectRatio(self) -> bool:\n \"\"\"\n\n usingAspectRatio(self) -> bool\n\n Query if a specific aspect ratio is being enforced.\n\n\n \"\"\"\n def setAspectRatio(self, aspect: float) -> None:\n \"\"\"\n\n setAspectRatio(self, aspect)\n\n Set the viewport aspect ratio (width/height).\n\n\n \"\"\"\n def aspectRatio(self) -> float:\n \"\"\"\n\n aspectRatio(self) -> float\n\n Query the viewport aspect ratio display option. Use\n viewAspectRatio() to query the current viewport aspect ratio.\n\n\n \"\"\"\n def setViewMaskOpacity(self, opacity: float) -> None:\n \"\"\"\n\n setViewMaskOpacity(self, opacity)\n\n Set the opacity of the bars used to mask areas out the viewport\n outside the aspect ratio.\n\n\n \"\"\"\n def viewMaskOpacity(self) -> float:\n \"\"\"\n\n viewMaskOpacity(self) -> float\n\n Query the opacity of the bars used to mask areas out the viewport\n outside the aspect ratio.\n\n\n \"\"\"\n def setStereoMode(self, viewportStereoMode: EnumValue) -> None:\n \"\"\"\n\n setStereoMode(self, viewportStereoMode)\n\n Set the stereo display mode when viewing through a stereo camera.\n\n * hou.viewportStereoMode.Anaglyph:\n\n Anaglyph display of left/right as red/cyan.\n\n * hou.viewportStereoMode.HorizontalInterlace:\n\n Interlace left and right on alternating scanlines. Only useful\n for 3D monitors which support this.\n\n * hou.viewportStereoMode.HorizontalInterlaceReverse:\n\n Interlace left and right on alternating scanlines, swapping\n which scanlines are used for left and right.\n\n * hou.viewportStereoMode.QuadBufferGL:\n\n Use OpenGL quad buffer stereo, generally only available on\n professional cards.\n\n\n \"\"\"\n def stereoMode(self) -> EnumValue:\n \"\"\"\n\n stereoMode(self) -> hou.viewportStereoMode\n\n Query the current stereo display mode.\n\n\n \"\"\"\n def setHomeAutoAdjustsClip(self, viewportHomeClipMode: EnumValue) -> None:\n \"\"\"\n\n setHomeAutoAdjustsClip(self, viewportHomeClipMode)\n\n Set which camera clip planes are adjusted when performing a homing\n operation.\n\n * hou.viewportHomeClipMode.Neither:\n\n Neither clip plane is adjusted.\n\n * hou.viewportHomeClipMode.FarOnly:\n\n Only the far clip plane is adjusted.\n\n * hou.viewportHomeClipMode.NearOnly:\n\n Only the near clip plane is adjusted.\n\n * hou.viewportHomeClipMode.NearAndFar:\n\n Both clip planes are adjusted.\n\n\n \"\"\"\n def homeAutoAdjustClip(self) -> EnumValue:\n \"\"\"\n\n homeAutoAdjustClip(self) -> hou.viewportHomeClipMode\n\n Queries which camera clip planes are adjusted when performing a\n homing operation.\n\n\n \"\"\"\n def setClipPlanes(self, clip: Sequence[float]) -> None:\n \"\"\"\n\n setClipPlanes(self, clip)\n\n Set the near and far camera clip planes from a 2-tuple.\n\n\n \"\"\"\n def clipPlanes(self) -> Tuple[float, ...]:\n \"\"\"\n\n clipPlanes(self) -> tuple of float\n\n Query the near and far camera clip planes, returning them in a\n 2-tuple.\n\n\n \"\"\"\n def setMinHomeSize(self, min_size: float) -> None:\n \"\"\"\n\n setMinHomeSize(self, min_size)\n\n Set the smallest area that viewport can home to, in world units.\n\n\n \"\"\"\n def minHomeSize(self) -> float:\n \"\"\"\n\n minHomeSize(self) -> float\n\n Query the smallest area that viewport can home to, in world units.\n\n\n \"\"\"\n def setUVDisplayAttribute(self, uv: str) -> None: ...\n def uvDisplayAttribute(self) -> str:\n \"\"\"\n\n uvDisplayAttribute(self) -> str\n\n Return the attribute currently displayed in the UV viewport.\n\n\n \"\"\"\n def setUVAutoAttribute(self, detect: bool) -> None: ...\n def uvAutoAttribute(self) -> bool:\n \"\"\"\n\n uvAutoAttribute(self) -> bool\n\n Return True if the UV viewport is auto-detecting the class of the\n displayed UV attribute.\n\n\n \"\"\"\n def setUVVertexType(self, is_vertex_uv: bool) -> None: ...\n def uvVertexType(self) -> bool:\n \"\"\"\n\n uvVertexType(self) -> bool\n\n Return the class of the UV attribute, Point or Vertex. This returns\n the viewport setting, and not the detected class of the current UV\n attribute. If uvAutoAttribute is enabled, the class will be the same\n as the currently displayed attribute, but if it is disabled it may\n be different.\n\n\n \"\"\"\n def setUVMapTexture(self, uv_file: str) -> None:\n \"\"\"\n\n setUVMapTexture(self, uv)\n\n Set the file path of the texture map used to visualize UVs when\n geometry has a UV attribute but no material assigned.\n\n\n \"\"\"\n def uvMapTexture(self) -> str:\n \"\"\"\n\n uvMapTexture(self) -> str\n\n Return the file path of the texture map used to visualize UVs when\n geometry has a UV attribute but no material assigned.\n\n\n \"\"\"\n def setUVMapScale(self, uv_scale: float) -> None:\n \"\"\"\n\n setUVMapScale(self, scale)\n\n Set the UV scaling factor for the UV Map when visualizing UVs. It\n defaults to 1.\n\n\n \"\"\"\n def uvMapScale(self) -> float:\n \"\"\"\n\n uvMapScale(self) -> float\n\n Returns the UV scaling factor for the UV Map when visualizing UVs.\n\n\n \"\"\"\n def setLighting(self, viewportLighting: EnumValue) -> None:\n \"\"\"\n\n setLighting(self, viewportLighting)\n\n Set the global lighting mode for all viewports.\n\n * hou.viewportLighting.Off:\n\n No lighting, constant shaded.\n\n * hou.viewportLighting.Headlight:\n\n Basic lighting from a single directional light defined in the\n display options.\n\n * hou.viewportLighting.Normal:\n\n Good quality lighting from up to 10 basic lights (area lights\n modeled as point lights, limited environment lights).\n\n * hou.viewportLighting.HighQuality:\n\n High quality lighting from an unlimited number of lights\n including area, geometry, environment and ambient occlusion.\n\n * hou.viewportLighting.HighQualityWithShadows:\n\n High quality lighting with shadows.\n\n\n \"\"\"\n def lighting(self) -> EnumValue:\n \"\"\"\n\n lighting(self) -> hou.viewportLighting\n\n Query the current global lighting mode.\n\n\n \"\"\"\n def setWorkLightType(self, viewportWorkLight: EnumValue) -> None:\n \"\"\"\n\n setWorkLightType(self, viewportWorkLight)\n\n Set the work light type. Does not change the lighting mode to\n Headlight; this must be done separately.\n\n * hou.viewportWorkLight.Headlight:\n\n Single over-the-shoulder distant light.\n\n * hou.viewportWorkLight.Domelight:\n\n Environment light with optional texture map.\n\n * hou.viewportWorkLight.PhysicalSky:\n\n Outdoor lighting with a distant and environment map based on the\n sun position and atmospheric conditions.\n\n * hou.viewportWorkLight.ThreePoint:\n\n Three distant lights set up in a classic three point lighting\n arrangement.\n\n\n \"\"\"\n def workLightType(self) -> EnumValue:\n \"\"\"\n\n workLightType(self) -> hou.viewportWorkLight\n\n Return the current work light type.\n\n\n \"\"\"\n def setWorkLightOptions(self, p: dict[str, Any]) -> None:\n \"\"\"\n\n setWorkLightOptions(self, light_parms)\n\n Set any number of the work light parameters using a python\n dictionary. The name and types of the parameters can be queried with\n workLightOptions.\n\n\n \"\"\"\n def workLightOptions(self) -> dict[str, Any]:\n \"\"\"\n\n workLightOptions(self) -> dictionary\n\n Return a python dictionary of the parameters of all the work light\n types, which can be modified and passed back to setWorkLightOptions.\n\n\n \"\"\"\n def showDiffuse(self, enable: bool) -> None:\n \"\"\"\n\n showDiffuse(self, enable)\n\n Enable diffuse contribution of lighting. When disabled, diffuse will\n not contribute to the final lit color. This can be used to debug\n lighting.\n\n\n \"\"\"\n def showingDiffuse(self) -> bool:\n \"\"\"\n\n showingDiffuse(self) -> bool\n\n Query if diffuse lighting is enabled.\n\n\n \"\"\"\n def showSpecular(self, enable: bool) -> None:\n \"\"\"\n\n showSpecular(self, enable)\n\n Enable specular highlights. When disabled, specular will not\n contribute to the final lit color. This will also disable most\n reflections. This can be used to debug lighting.\n\n\n \"\"\"\n def showingSpecular(self) -> bool:\n \"\"\"\n\n showingSpecular(self) -> bool\n\n Query if specular lighting is enabled.\n\n\n \"\"\"\n def showAmbient(self, enable: bool) -> None:\n \"\"\"\n\n showAmbient(self, enable)\n\n Enable ambient lighting. When disabled, all ambient lights will not\n contribute to the final lit color. This can be used to debug\n lighting.\n\n\n \"\"\"\n def showingAmbient(self) -> bool:\n \"\"\"\n\n showingAmbient(self) -> bool\n\n Query if ambient lighting is enabled.\n\n\n \"\"\"\n def showEmission(self, enable: bool) -> None:\n \"\"\"\n\n showEmission(self, enable)\n\n Enable emissive lighting. Emission lighting comes from materials on\n geometry, not lights, so modifying the lights in the scene has no\n effect on it. This can be used to debug lighting.\n\n\n \"\"\"\n def showingEmission(self) -> bool:\n \"\"\"\n\n showingEmission(self) -> bool\n\n Query if emission lighting is enabled.\n\n\n \"\"\"\n def setLightSampling(self, num_samples: int) -> None:\n \"\"\"\n\n setLightSampling(self, num_samples)\n\n Set the number of lighting samples to perform when doing high\n quality lighting for area and environment lights.\n\n\n \"\"\"\n def lightSampling(self) -> int:\n \"\"\"\n\n lightSampling(self) -> int\n\n Query the number of lighting samples.\n\n\n \"\"\"\n def setMaxLightSamples(self, samples: int) -> None:\n \"\"\"\n\n setMaxLightSamples(self, samples)\n\n Set the maximum number of light samples to use, across all lights.\n If there are more lights than samples, at least 1 sample will be\n used for each light. Setting this to zero removes the limit and each\n light will use up to the number of samples defined by the Light\n Sampling display option. Not all lights use multiple samples.\n\n\n \"\"\"\n def maxLightSamples(self) -> int:\n \"\"\"\n\n maxLightSamples(self) -> int\n\n Return the maximum light samples, or zero if there is no limit.\n\n\n \"\"\"\n def setLightLimit(self, limit: int) -> None:\n \"\"\"\n\n setLightLimit(self, limit)\n\n Set the maximum number of lights to contribute to lighting in HQ\n Lighting. The brightest lights are taken first. Setting this to zero\n disables the limit.\n\n\n \"\"\"\n def getLightLimit(self) -> int:\n \"\"\"\n\n getLightLimit(self) -> int\n\n Return the maximum number of lights to use in HQ Lighting, or zero\n if there is no light limit.\n\n\n \"\"\"\n def setHeadlightIntensity(self, intensity: float) -> None:\n \"\"\"\n\n setHeadlightIntensity(self, intensity)\n\n Set the intensity of the headlight used in Headlight lighting mode.\n\n\n \"\"\"\n def headlightIntensity(self) -> float:\n \"\"\"\n\n headlightIntensity(self) -> double\n\n Query the intensity of the headlight.\n\n\n \"\"\"\n def setHeadlightDirection(self, dir: Sequence[float]) -> None:\n \"\"\"\n\n setHeadlightDirection(self, dir)\n\n Set the direction of the headlight used in Headlight lighting mode.\n This is expressed as a direction vector in camera space (the camera\n looks down -Z).\n\n\n \"\"\"\n def headlightDirection(self) -> Tuple[float, ...]:\n \"\"\"\n\n headlightDirection(self) -> tuple of double\n\n Query the vector direction of the headlight.\n\n\n \"\"\"\n def setHeadlightSpecular(self, enable: bool) -> None:\n \"\"\"\n\n setHeadlightSpecular(self, enable)\n\n Enable specular reflections when in Headlight lighting mode. Turning\n this off results in purely diffuse lighting.\n\n\n \"\"\"\n def headlightSpecular(self) -> bool:\n \"\"\"\n\n headlightSpecular(self) -> bool\n\n Query if specular reflections are generated by the headlight.\n\n\n \"\"\"\n def setHeadlightOcclusion(self, enable: bool) -> None:\n \"\"\"\n\n setHeadlightOcclusion(self, enable)\n\n Enables ambient occlusion when in headlight mode. This has no effect\n if a lighting mode other than headlight is active.\n\n\n \"\"\"\n def headlightOcclusion(self) -> bool:\n \"\"\"\n\n headlightOcclusion(self) -> bool\n\n Query if ambient occlusion is active for headlight mode.\n\n\n \"\"\"\n def setAmbientOcclusion(self, enable: bool) -> None:\n \"\"\"\n\n setAmbientOcclusion(self, enable)\n\n Enable an ambient occlusion pass in high quality lighting modes.\n This generates local occlusion shadows.\n\n\n \"\"\"\n def ambientOcclusion(self) -> bool:\n \"\"\"\n\n ambientOcclusion(self) -> bool\n\n Query if ambient occlusion is enabled. This can return true even if\n not in a high quality mode as this queries the raw display option\n value, not a reflection of whether the pass is active. If querying\n it the pass is active, the lighting mode should also be checked.\n\n\n \"\"\"\n def setAmbientOcclusionLevel(self, level: int) -> None:\n \"\"\"\n\n setAmbientOcclusionLevel(self, level)\n\n Set the level of occlusion to generate, from 1-4. Higher levels\n produce a larger area of effect, while lower values produce fine\n detail.\n\n\n \"\"\"\n def ambientOcclusionLevel(self) -> int:\n \"\"\"\n\n ambientOcclusionLevel(self) -> int\n\n Return the current occlusion level for ambient occlusion.\n\n\n \"\"\"\n def setShadowQuality(self, viewportShadowQuality: EnumValue) -> None:\n \"\"\"\n\n setShadowQuality(self, viewportShadowQuality)\n\n Set the quality of shadow sampling in High Quality Lighting with\n Shadows lighting mode.\n\n * hou.viewportShadowQuality.Point:\n\n Area lights are treated as point lights when generating and\n sampling shadow maps. This is the fastest option.\n\n * hou.viewportShadowQuality.PointAA:\n\n Do some antialiasing of shadow edges. Treat area lights as point\n lights when generating and sampling shadow maps.\n\n * hou.viewportShadowQuality.Area:\n\n Area lights generate multiple shadow maps which are sampled to\n generate an approximation of a blurred shadow from an area\n source.\n\n * hou.viewportShadowQuality.AreaAA:\n\n Area lights generate multiple maps and antialias the shadow\n lookups.\n\n\n \"\"\"\n def shadowQuality(self) -> EnumValue:\n \"\"\"\n\n shadowQuality(self) -> hou.viewportShadowQuality\n\n Query the current shadow quality.\n\n\n \"\"\"\n def setShadowSensitivity(self, offset: Sequence[int]) -> None:\n \"\"\"\n\n setShadowSensitivity(self, offset)\n\n Set the shadow bias to avoid self-shadowing. A 2-tuple is expected,\n with the first value setting the variable offset (depending on how\n parallel the surface is to the view direction) and the second a\n constant offset. Generally these don't need to be changed from their\n default, but larger values reduce self shadowing but increase the\n risk of missing shadows for very close geometry.\n\n\n \"\"\"\n def shadowSensitivity(self) -> Tuple[int, ...]:\n \"\"\"\n\n shadowSensitivity(self) -> tuple of int\n\n Query the variable and constant shadow offsets, returned in a\n 2-tuple.\n\n\n \"\"\"\n def setShadowMapSize(self, size: int) -> None:\n \"\"\"\n\n setShadowMapSize(self, size)\n\n Set the maximum shadow map size, in pixels. Larger maps will produce\n sharper shadows but increase memory usage. Shadow maps are always\n square.\n\n\n \"\"\"\n def shadowMapSize(self) -> int:\n \"\"\"\n\n shadowMapSize(self) -> int\n\n Query the maximum size of the shadow maps used by High Quality\n Lighting with Shadows lighting mode.\n\n\n \"\"\"\n def setShadowMapSizeFromLight(self, enable: bool) -> None:\n \"\"\"\n\n setShadowMapSizeFromLight(self, enable)\n\n Set whether to use the shadow map size specified by the Shadow Map\n size parameter in the light object (clamped to the maximum size\n specified in the display options) or always use the maximum size.\n\n\n \"\"\"\n def shadowMapSizeFromLight(self) -> bool:\n \"\"\"\n\n shadowMapSizeFromLight(self) -> bool\n\n Query if the shadow map size is defined by the light object.\n\n\n \"\"\"\n def setShadowMapMem(self, mem_in_mb: int) -> None:\n \"\"\"\n\n setShadowMapMem(self, mem_in_mb)\n\n Set the amount of VRAM to use for all shadowmaps, in MiB.\n\n\n \"\"\"\n def getShadowMapMem(self) -> int:\n \"\"\"\n\n getShadowMapMem(self) -> int\n\n Query the amount of VRAM used for shadowmaps, in MiB.\n\n\n \"\"\"\n def setShadowMapTime(self, time_in_sec: float) -> None:\n \"\"\"\n\n setShadowMapTime(self, time_in_sec)\n\n Set the time limit for generating shadowmaps in one redraw (in\n seconds). If more shadowmaps are left to generate, cause another\n redraw (and so on until all are complete).\n\n\n \"\"\"\n def getShadowMapTime(self) -> float:\n \"\"\"\n\n getShadowMapTime(self) -> int\n\n Return the time limit for generating shadowmaps within one redraw,\n in seconds.\n\n\n \"\"\"\n def useReflections(self, enable: bool) -> None:\n \"\"\"\n\n useReflections(self, enable)\n\n Enable reflection mapping. Objects with reflective materials\n generate reflection maps of the scene around them, which can be\n quite expensive.\n\n\n \"\"\"\n def usingReflections(self) -> bool:\n \"\"\"\n\n usingReflections(self) -> bool\n\n Query if reflection mapping is enabled.\n\n\n \"\"\"\n def setHdrReflections(self, hdr_reflect: bool) -> None:\n \"\"\"\n\n setHdrReflections(self, hdr_reflect)\n\n Enable High Dynamic Range (HDR) color buffers for the generated\n scene cubemap, which allows for higher contrast and bright spots in\n reflections.\n\n\n \"\"\"\n def hdrReflections(self) -> bool:\n \"\"\"\n\n hdrReflections(self) -> bool\n\n Query if High Dynamic Range (HDR) color buffers are use for the\n scene cubemap.\n\n\n \"\"\"\n def setReflectMapSize(self, size: int) -> None:\n \"\"\"\n\n setReflectMapSize(self, size)\n\n Set the size of the cubemap used to store the surrounding scene as\n an environment map. Larger cubemaps produce sharper reflections but\n increase memory use.\n\n\n \"\"\"\n def reflectMapSize(self) -> int:\n \"\"\"\n\n reflectMapSize(self) -> int\n\n Query the size of reflection cubemaps.\n\n\n \"\"\"\n def setMinReflectAmount(self, min_reflect: float) -> None:\n \"\"\"\n\n setMinReflectAmount(self, min_reflect)\n\n Set the minimum level of reflection required for a reflection\n cubemap to be generated for an object. This is based on the largest\n reflective value from all the materials assigned to the object. The\n larger this value, the more reflective an object must be to generate\n a reflection maps. A value of zero is not recommended, as all\n objects will generate a reflection map.\n\n\n \"\"\"\n def minReflectAmount(self) -> float:\n \"\"\"\n\n minReflectAmount(self) -> double\n\n Query the minimum reflection level required for a cubemap to be\n generated for an object.\n\n\n \"\"\"\n def setUseRayTracing(self, enable: bool) -> None:\n \"\"\"\n\n setUseRayTracing(self)\n\n Ray tracing is used for Ambient Occlusion and shading lights. This\n can be enabled even if the hardware doesn't support ray tracing, in\n which case it will be as if the option is off.\n\n\n \"\"\"\n def useRayTracing(self) -> bool:\n \"\"\"\n\n getUseRayTracing(self) -> bool\n\n Query if ray tracing is enabled. This may return True if even if the\n hardware does not support ray tracing (but it will not have any\n effect in that case).\n\n\n \"\"\"\n def setUseDenoising(self, enable: bool) -> None:\n \"\"\"\n\n setUseDenoising(self)\n\n Control if denoising may be used to smooth out noise from\n environment lights, ambient occlusion, and/or raytraced lights.\n\n\n \"\"\"\n def useDenoising(self) -> bool:\n \"\"\"\n\n getUseDenoising(self) -> bool\n\n Query if denoising is enabled.\n\n\n \"\"\"\n def setFastInteractiveSampling(self, fast: bool) -> None:\n \"\"\"\n\n setFastInteractiveSampling(self, fast)\n\n When enabled, drops the number of samples used in HQ Lighting to\n improve performance when interacting with the viewer, which includes\n tumbling, moving handles, or playing the timeline. This may result\n in slightly different lighting while interacting with the viewer.\n\n\n \"\"\"\n def fastInteractiveSampling(self) -> bool:\n \"\"\"\n\n fastInteractiveSampling(self) -> bool\n\n Query if Fast Interactive Sampling is enabled on the viewer. This\n drops the number of samples used in HQ Lighting to improve\n performance when interacting with the viewer.\n\n\n \"\"\"\n def showMaterials(self, enable: bool) -> None:\n \"\"\"\n\n showMaterials(self, enable)\n\n Enable materials on geometry from SHOPs or VOPs. When disabled,\n these material assignments are ignored and only the attributes on\n the geometry will affect shading.\n\n\n \"\"\"\n def showingMaterials(self) -> bool:\n \"\"\"\n\n showingMaterials(self) -> bool\n\n Query if materials are shown.\n\n\n \"\"\"\n def showGeometryColor(self, enable: bool) -> None:\n \"\"\"\n\n showGeometryColor(self, enable)\n\n Enable contribution of the geometry Cd attribute to the material.\n When disabled, this is ignored. Cd multiplies both the material\n diffuse and ambient colors.\n\n\n \"\"\"\n def showingGeometryColor(self) -> bool:\n \"\"\"\n\n showingGeometryColor(self) -> bool\n\n Query if geometry Cd contributes to the material.\n\n\n \"\"\"\n def useTransparency(self, enable: bool) -> None:\n \"\"\"\n\n useTransparency(self, enable)\n\n Enable transparency rendering. When transparency is enabled, another\n pass handles areas of the geometry that have Alpha less than one\n (either due to an Alpha attribute or material opacity). When\n disabled, alpha is ignored and rendered as opaque.\n\n\n \"\"\"\n def usingTransparency(self) -> bool:\n \"\"\"\n\n usingTransparency(self) -> bool\n\n Query if transparency rendering is enabled.\n\n\n \"\"\"\n def setTransparencyQuality(self, viewportTransparency: EnumValue) -> None:\n \"\"\"\n\n setTransparencyQuality(self, viewportTransparency)\n\n Set the quality of the transparency pass performed by the viewport.\n\n * hou.viewportTransparency.Cutout:\n\n Fast test to render the transparent pixel as opaque (>0) or to\n discard it (0). This can be used for texture cards such as\n leaves. This doesn't require an additional pass for\n transparency.\n\n * hou.viewportTransparency.Low:\n\n Render transparent pixels in a separate pass. Only the front-\n most transparent pixel is rendered.\n\n * hou.viewportTransparency.Medium:\n\n Render transparent pixels in an Order-Independent buffer of 8\n samples, which is then sorted and composited together to do\n multi-layer transparency for up to 8 layers of overlapping\n transparency.\n\n * hou.viewportTransparency.High:\n\n Render transparent pixels in an Order-Independent buffer of 16\n samples, which is then sorted and composited together to do\n multi-layer transparency for up to 16 layers of overlapping\n transparency.\n\n\n \"\"\"\n def transparencyQuality(self) -> EnumValue:\n \"\"\"\n\n transparencyQuality(self) -> hou.viewportTransparency\n\n Query the transparency quality.\n\n\n \"\"\"\n def useDisplacement(self, enable: bool) -> None:\n \"\"\"\n\n useDisplacement(self, enable)\n\n Enable displacement mapping for materials that have a displacement\n map. When disabled, the displacement map is ignored. This can have a\n significant hit for lower-end GPUs.\n\n\n \"\"\"\n def usingDisplacement(self) -> bool:\n \"\"\"\n\n usingDisplacement(self) -> bool\n\n Query if displacement mapping is allowed.\n\n\n \"\"\"\n def setDisplacementLevel(self, level: float) -> None:\n \"\"\"\n\n setDisplacementLevel(self, level)\n\n Set the level of detail for displacement mapping. Displacement\n mapping adaptively subdivides the geometry to provide finer detail.\n Higher values result in denser subdivision, while lower values\n produce lighter meshes. The default is 1.0.\n\n\n \"\"\"\n def displacementLevel(self) -> float:\n \"\"\"\n\n displacementLevel(self) -> double\n\n Query the level of detail used for displacement mapping.\n\n\n \"\"\"\n def setDefaultMaterialDiffuse(self, tint: Color) -> None:\n \"\"\"\n\n setDefaultMaterialDiffuse(self, tint)\n\n Set the diffuse color of the default material (used when no material\n assignment is present or Show Materials is disabled).\n\n\n \"\"\"\n def defaultMaterialDiffuse(self) -> Color:\n \"\"\"\n\n defaultMaterialDiffuse(self) -> hou.Color\n\n Query the default material's diffuse color.\n\n\n \"\"\"\n def setDefaultMaterialSpecular(self, tint: Color) -> None:\n \"\"\"\n\n setDefaultMaterialSpecular(self, tint)\n\n Set the specular color of the default material (used when no\n material assignment is present or Show Materials is disabled).\n\n\n \"\"\"\n def defaultMaterialSpecular(self) -> Color:\n \"\"\"\n\n defaultMaterialSpecular(self) -> hou.Color\n\n Query the default material's specular color.\n\n\n \"\"\"\n def setDefaultMaterialAmbient(self, tint: Color) -> None:\n \"\"\"\n\n setDefaultMaterialAmbient(self) -> hou.Color\n\n Query the default material's ambient color.\n\n\n \"\"\"\n def defaultMaterialAmbient(self) -> Color:\n \"\"\"\n\n defaultMaterialAmbient(self, tint)\n\n Set the ambient color of the default material (used when no material\n assignment is present or Show Materials is disabled).\n\n\n \"\"\"\n def setDefaultMaterialEmission(self, tint: Color) -> None:\n \"\"\"\n\n setDefaultMaterialEmission(self) -> hou.Color\n\n Query the default material's emission color.\n\n\n \"\"\"\n def defaultMaterialEmission(self) -> Color:\n \"\"\"\n\n defaultMaterialEmission(self, tint)\n\n Set the emission color of the default material (used when no\n material assignment is present or Show Materials is disabled).\n\n\n \"\"\"\n def setDefaultMaterialMatCapFile(self, filepath: str) -> None:\n \"\"\"\n\n setDefaultMaterialMatCapFile(self, filepath)\n\n Set the file path to a Material Capture (MatCap) texture for the\n MatCap default material. A MatCap texture encodes lighting and\n shading information, much like a lat-long environment map.\n\n\n \"\"\"\n def getDefaultMaterialMatCapFile(self) -> str:\n \"\"\"\n\n getDefaultMaterialMatCapFile(self) -> str\n\n Return the file path of the current MatCap texture.\n\n\n \"\"\"\n def setDefaultMaterialMatCapIntensity(self, i: float) -> None:\n \"\"\"\n\n setDefaultMaterialMatCapIntensity(self, i)\n\n Set the intensity of the MatCap texture, which can be used to boost\n or dim the values in a MatCap texture file. This is a direct\n multiplier on the texture values.\n\n\n \"\"\"\n def getDefaultMaterialMatCapIntensity(self) -> float:\n \"\"\"\n\n getDefaultMaterialMatCapIntensity(self) -> float\n\n Return the MatCap texture intensity multiplier.\n\n\n \"\"\"\n def setDefaultMaterialType(self, viewportDefaultMaterial: EnumValue) -> None:\n \"\"\"\n\n setDefaultMaterialType(self, viewportDefaultMaterial)\n\n Set the default material type used when the geometry has to material\n assignment.\n\n * hou.viewportDefaultMaterial.Simple:\n\n An untextured material with variable roughness and color\n settings for diffuse, specular, emission, and ambient values.\n\n * hou.viewportDefaultMaterial.MatCap:\n\n A material that uses a MatCap texture (Material Capture) to\n define the lighting and shading of the surface rather than the\n lights in the scene.\n\n\n \"\"\"\n def getDefaultMaterialType(self) -> EnumValue:\n \"\"\"\n\n getDefaultMaterialType(self) -> hou.EnumValue\n\n Return the default material type, either Simple or MatCap\n\n\n \"\"\"\n def setUniformFog(self, enable: bool) -> None:\n \"\"\"\n\n setUniformFog(self, enable)\n\n Draw an simple atmospheric fog effect in the viewport, based on\n distance and not affected by lighting.\n\n\n \"\"\"\n def getUniformFog(self) -> bool:\n \"\"\"\n\n getUniformFog(self) -> bool\n\n Query if uniform fog is active.\n\n\n \"\"\"\n def setUniformFogColor(self, color: Sequence[float]) -> None:\n \"\"\"\n\n setUniformFogColor(self, color)\n\n Tints the generated fog so it can be made to look more like smog,\n haze, or dust.\n\n\n \"\"\"\n def getUniformFogColor(self) -> Tuple[float, ...]:\n \"\"\"\n\n getUniformFogColor(self) -> tuple of float\n\n Query the uniform fog color.\n\n\n \"\"\"\n def setUniformFogDensity(self, density: float) -> None:\n \"\"\"\n\n setUniformFogDensity(self, density)\n\n Factor that controls how dense the fog is. Must be a positive value.\n\n\n \"\"\"\n def getUniformFogDensity(self) -> float:\n \"\"\"\n\n getUniformFogDensity(self) -> float\n\n Query the uniform fog density.\n\n\n \"\"\"\n def setUniformFogOpacity(self, opacity: float) -> None:\n \"\"\"\n\n setUniformFogOpacity(self, opacity)\n\n An additional factor on the final fog result to make it heavier\n (>1.0) or lighter (<1.0). Must be zero or greater.\n\n\n \"\"\"\n def getUniformFogOpacity(self) -> float:\n \"\"\"\n\n getUniformFogOpacity(self) -> float\n\n Query the fog opacity.\n\n\n \"\"\"\n def setUniformFogDepthRange(self, range: Sequence[float]) -> None:\n \"\"\"\n\n setUniformFogDepthRange(self, range)\n\n For uniform fog, this is the depths where the fog begins and ends,\n in unit distance from the camera. All depths beyond the end are\n clamped to the end depth. Any depth before the fog start do not have\n fog applied. The fog start should be smaller than fog end, and both\n should be positive.\n\n\n \"\"\"\n def getUniformFogDepthRange(self) -> Tuple[float, ...]:\n \"\"\"\n\n getUniformFogDepthRange(self) -> tuple of float\n\n Query the uniform depth range (near,far).\n\n\n \"\"\"\n def setUniformFogHeightMode(self, viewportFogHeightMode: EnumValue) -> None:\n \"\"\"\n\n setUniformFogHeightMode(self, viewportFogHeightMode)\n\n * hou.viewportFogHeightMode.Off:\n\n Height has no effect on the fog.\n\n * hou.viewportFogHeightMode.Above:\n\n Fog only appears above the fog height.\n\n * hou.viewportFogHeightMode.Below:\n\n Fog only appears below the fog height.\n\n\n \"\"\"\n def getUniformFogHeightMode(self) -> EnumValue:\n \"\"\"\n\n getUniformFogHeightMode(self) -> hou.EnumValue\n\n Query the uniform fog height mode.\n\n\n \"\"\"\n def setUniformFogHeight(self, h: float) -> None:\n \"\"\"\n\n setUniformFogHeight(self, h)\n\n Set the height where fog starts, in world units.\n\n\n \"\"\"\n def getUniformFogHeight(self) -> float:\n \"\"\"\n\n getUniformFogHeight(self) -> float\n\n Query the uniform fog height.\n\n\n \"\"\"\n def setUniformFogHeightFalloff(self, h: float) -> None:\n \"\"\"\n\n setUniformFogHeightFalloff(self, h)\n\n Set the height of the fog transition area between no and uniform\n full fog, in world units.\n\n\n \"\"\"\n def getUniformFogHeightFalloff(self) -> float:\n \"\"\"\n\n getUniformFogHeightFalloff(self) -> float\n\n Query the uniform fog falloff.\n\n\n \"\"\"\n def setUniformFogDepthClip(self, depth: float) -> None:\n \"\"\"\n\n setUniformFogDepthClip(self, depth)\n\n Anything beyond the depth clip value not have uniform fog applied.\n This is useful for preventing fog on skyboxes or other image-based\n background elements.\n\n\n \"\"\"\n def getUniformFogDepthClip(self) -> float:\n \"\"\"\n\n getUniformFogDepthClip(self) -> float\n\n Query the depth clip value.\n\n\n \"\"\"\n def setUniformFogUseSun(self, enable: bool) -> None:\n \"\"\"\n\n setUniformFogUseSun(self, enable)\n\n Enable or disable simple lighting of uniform fog based on a distant\n light in the scene.\n\n\n \"\"\"\n def getUniformFogUseSun(self) -> bool:\n \"\"\"\n\n getUniformFogUseSun(self) -> bool\n\n Query if the sun light is enabled for uniform fog.\n\n\n \"\"\"\n def setUniformFogSunBloom(self, bloom: float) -> None:\n \"\"\"\n\n setUniformFogSunBloom(self, bloom)\n\n Set the size of the light bloom around the sun (scattering).\n\n\n \"\"\"\n def getUniformFogSunBloom(self) -> float:\n \"\"\"\n\n getUniformFogSunBloom(self) -> float\n\n Query the sun bloom.\n\n\n \"\"\"\n def setUniformFogSunIntensity(self, intensity: float) -> None:\n \"\"\"\n\n setUniformFogSunIntensity(self, intensity)\n\n For uniform fog with the Sun enabled, this provides an additional\n intensity adjustment on the distant light's color.\n\n\n \"\"\"\n def getUniformFogSunIntensity(self) -> float:\n \"\"\"\n\n getUniformFogSunIntensity(self) -> float\n\n Query the sun light intensity modifier.\n\n\n \"\"\"\n def setVolumeFog(self, enable: bool) -> None:\n \"\"\"\n\n setVolumeFog(self, enable)\n\n Draw an simple atmospheric fog effect in the viewport, based on\n distance and not affected by lighting.\n\n\n \"\"\"\n def getVolumeFog(self) -> bool:\n \"\"\"\n\n getVolumeFog(self) -> bool\n\n Query if volume fog is active.\n\n\n \"\"\"\n def setVolumeFogColor(self, color: Sequence[float]) -> None:\n \"\"\"\n\n setVolumeFogColor(self, color)\n\n Tints the generated fog so it can be made to look more like smog,\n haze, or dust.\n\n\n \"\"\"\n def getVolumeFogColor(self) -> Tuple[float, ...]:\n \"\"\"\n\n getVolumeFogColor(self) -> tuple of float\n\n Query the volume fog color.\n\n\n \"\"\"\n def setVolumeFogDensity(self, density: float) -> None:\n \"\"\"\n\n setVolumeFogDensity(self, density)\n\n Factor that controls how dense the fog is. Must be a positive value.\n\n\n \"\"\"\n def getVolumeFogDensity(self) -> float:\n \"\"\"\n\n getVolumeFogDensity(self) -> float\n\n Query the volume fog density.\n\n\n \"\"\"\n def setVolumeFogOpacity(self, opacity: float) -> None:\n \"\"\"\n\n setVolumeFogOpacity(self, opacity)\n\n An additional factor on the final fog result to make it heavier\n (>1.0) or lighter (<1.0). Must be zero or greater.\n\n\n \"\"\"\n def getVolumeFogOpacity(self) -> float:\n \"\"\"\n\n getVolumeFogOpacity(self) -> float\n\n Query the fog opacity.\n\n\n \"\"\"\n def setVolumeFogDepthRange(self, range: Sequence[float]) -> None:\n \"\"\"\n\n setVolumeFogDepthRange(self, range)\n\n For volume fog, this is the depths where the fog begins and ends, in\n unit distance from the camera. All depths beyond the end are clamped\n to the end depth. Any depth before the fog start do not have fog\n applied. The fog start should be smaller than fog end, and both\n should be positive.\n\n\n \"\"\"\n def getVolumeFogDepthRange(self) -> Tuple[float, ...]:\n \"\"\"\n\n getVolumeFogDepthRange(self) -> tuple of float\n\n Query the volume depth range (near,far).\n\n\n \"\"\"\n def setVolumeFogHeightMode(self, viewportFogHeightMode: EnumValue) -> None:\n \"\"\"\n\n setVolumeFogHeightMode(self, viewportFogHeightMode)\n\n * hou.viewportFogHeightMode.Off:\n\n Height has no effect on the fog.\n\n * hou.viewportFogHeightMode.Above:\n\n Fog only appears above the fog height.\n\n * hou.viewportFogHeightMode.Below:\n\n Fog only appears below the fog height.\n\n\n \"\"\"\n def getVolumeFogHeightMode(self) -> EnumValue:\n \"\"\"\n\n getVolumeFogHeightMode(self) -> hou.EnumValue\n\n Query the volume fog height mode.\n\n\n \"\"\"\n def setVolumeFogHeight(self, h: float) -> None:\n \"\"\"\n\n setVolumeFogHeight(self, h)\n\n Set the height where fog starts, in world units.\n\n\n \"\"\"\n def getVolumeFogHeight(self) -> float:\n \"\"\"\n\n getVolumeFogHeight(self) -> float\n\n Query the volume fog height.\n\n\n \"\"\"\n def setVolumeFogHeightFalloff(self, h: float) -> None:\n \"\"\"\n\n setVolumeFogHeightFalloff(self, h)\n\n Set the height of the fog transition area between no and volume full\n fog, in world units.\n\n\n \"\"\"\n def getVolumeFogHeightFalloff(self) -> float:\n \"\"\"\n\n getVolumeFogHeightFalloff(self) -> float\n\n Query the volume fog falloff.\n\n\n \"\"\"\n def setVolumeFogQuality(self, viewportFogQuality: EnumValue) -> None:\n \"\"\"\n\n setVolumeFogQuality(self, viewportFogQuality)\n\n The quality determines the size of the volume used for fog lighting.\n\n * hou.viewportFogQuality.Low:\n\n Small volume for fast drawing.\n\n * hou.viewportFogQuality.Medium:\n\n Larger volume balanced for quality and speed.\n\n * hou.viewportFogQuality.High:\n\n Very large volume for quality.\n\n\n \"\"\"\n def getVolumeFogQuality(self) -> EnumValue:\n \"\"\"\n\n getVolumeFogQuality(self) -> hou.EnumValue\n\n Query the volume fog quality.\n\n\n \"\"\"\n def setVolumeFogLightIntensity(self, h: float) -> None:\n \"\"\"\n\n setVolumeFogLightIntensity(self, h)\n\n Set the default light intensity modifier for any lights without the\n gl_fogintensity property on them. Zero will cause only lights with\n that property to contribute to the lighting.\n\n\n \"\"\"\n def getVolumeFogLightIntensity(self) -> float:\n \"\"\"\n\n getVolumeFogLightIntensity(self) -> float\n\n Query the volume light intensity modifier.\n\n\n \"\"\"\n def setVolumeFogLightScattering(self, scatter: Sequence[float]) -> None:\n \"\"\"\n\n setVolumeFogLightScattering(self, scatter)\n\n\n \"\"\"\n def getVolumeFogLightScattering(self) -> Tuple[float, ...]:\n \"\"\"\n\n getVolumeFogLightScattering(self) -> tuple of float\n\n Query the volume light scattering (2-tuple).\n\n\n \"\"\"\n def setBloom(self, enable: bool) -> None:\n \"\"\"\n\n setBloom(self, enable)\n\n Enable or disable the drawing of the bloom post-process effect which\n creates light bloom around very bright pixels.\n\n\n \"\"\"\n def getBloom(self) -> bool:\n \"\"\"\n\n getBloom(self) -> bool\n\n Query if bloom is enabled.\n\n\n \"\"\"\n def setBloomScale(self, scale: float) -> None:\n \"\"\"\n\n setBloomScale(self, scale)\n\n Scale the radius of blooms. The size is initially based on the\n brightness of the pixel, and this multiplies that value.\n\n\n \"\"\"\n def getBloomScale(self) -> float:\n \"\"\"\n\n getBloomScale(self) -> float\n\n Query the bloom scale.\n\n\n \"\"\"\n def setBloomIntensity(self, i: float) -> None:\n \"\"\"\n\n setBloomIntensity(self, i)\n\n Brighten or darken the blooms. The intensity is initially based on\n the brightness of the pixel, and this multiplies that value.\n\n\n \"\"\"\n def getBloomIntensity(self) -> float:\n \"\"\"\n\n getBloomIntensity(self) -> float\n\n Query the bloom intensity.\n\n\n \"\"\"\n def setBloomThreshold(self, i: float) -> None:\n \"\"\"\n\n setBloomThreshold(self, i)\n\n Any pixels in the scene which are brighter than this threshold will\n have bloom applied to them (white being 1.0). Increasing this value\n reduces the amount of bloom generated.\n\n\n \"\"\"\n def getBloomThreshold(self) -> float:\n \"\"\"\n\n getBloomThreshold(self) -> float\n\n Query the bloom threshold.\n\n\n \"\"\"\n def setFogNode(self, node: Node) -> None:\n \"\"\"\n\n setFogNode(self, node)\n\n Specify a node path which contains the fog parameters above. Any\n parameter that is found will override its corresponding display\n option. See Fog Properties. Passing None will clear the fog node and\n use the display option settings instead.\n\n\n \"\"\"\n def getFogNode(self) -> Optional[Node]:\n \"\"\"\n\n getFogNode(self) -> hou.OpNode\n\n Query the fog node override.\n\n\n \"\"\"\n def setDisplayOrthoGrid(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayOrthoGrid(self, enable)\n\n Display the grid in fixed orthographic views (Top, Left, Front,\n Bottom, Right, Back).\n\n\n \"\"\"\n def displayOrthoGrid(self) -> bool:\n \"\"\"\n\n displayOrthoGrid(self) -> bool\n\n Query if the grid is displayed in fixed orthographic views.\n\n\n \"\"\"\n def setOrthoGridOffset(self, offset: Sequence[float]) -> None:\n \"\"\"\n\n setOrthoGridOffset(self, offset)\n\n Set the offset of the grid in fixed orthographic views, as a 3-tuple\n in world space.\n\n\n \"\"\"\n def orthoGridOffset(self) -> Tuple[float, ...]:\n \"\"\"\n\n orthoGridOffset(self) -> tuple of float\n\n Query the offset of the grid in fixed orthographic views.\n\n\n \"\"\"\n def setOrthoGridSpacing(self, offset: Sequence[float]) -> None:\n \"\"\"\n\n setOrthoGridSpacing(self, offset)\n\n Set the spacing of the grid lines in fixed orthographic views as a\n 2-tuple.\n\n\n \"\"\"\n def orthoGridSpacing(self) -> Tuple[float, ...]:\n \"\"\"\n\n orthoGridSpacing(self) -> tuple of float\n\n Query the spacing of the grid lines in fixed orthographic views as a\n 2-tuple.\n\n\n \"\"\"\n def setOrthoGridRuler(self, offset: Sequence[int]) -> None:\n \"\"\"\n\n setOrthoGridRuler(self, offset)\n\n Set the spacing of the grid numbers in fixed orthographic views as a\n 2-tuple.\n\n\n \"\"\"\n def orthoGridRuler(self) -> Tuple[int, ...]:\n \"\"\"\n\n orthoGridRuler(self) -> tuple of int\n\n Query the spacing of the grid numbers in fixed orthographic views as\n a 2-tuple.\n\n\n \"\"\"\n def setOrthoRuler(self, viewportGridRuler: EnumValue) -> None:\n \"\"\"\n\n setOrthoRuler(self, viewportGridRuler)\n\n Where to display the grid numbers on the fixed orthographic view\n grid.\n\n * hou.viewportGridRuler.Hide:\n\n Do not display.\n\n * hou.viewportGridRuler.MainAxis:\n\n Display along the main axes at grid line intersections.\n\n * hou.viewportGridRuler.GridPoints:\n\n Display on grid line intersections.\n\n\n \"\"\"\n def orthoRuler(self) -> EnumValue:\n \"\"\"\n\n orthoRuler(self) -> hou.viewportGridRuler\n\n Query where the grid numbers are displayed on the fixed orthographic\n view grid.\n\n * hou.viewportGridRuler.Hide:\n\n Not displayed.\n\n * hou.viewportGridRuler.MainAxis:\n\n Displayed along the main axes at grid line intersections.\n\n * hou.viewportGridRuler.GridPoints:\n\n Displayed on grid line intersections.\n\n\n \"\"\"\n def setUVReferenceGrid(self, enable: bool) -> None:\n \"\"\"\n\n setUVReferenceGrid(self, enable)\n\n Display the grid in UV viewports.\n\n\n \"\"\"\n def uvReferenceGrid(self) -> bool:\n \"\"\"\n\n uvReferenceGridOverImage(self) -> bool\n\n Query if the dot grid is displayed.\n\n\n \"\"\"\n def setUVDisplayGridOverImage(self, enable: bool) -> None: ...\n def uvReferenceGridOverImage(self) -> bool: ...\n def setUVGridPixelSpacing(self, offset: Sequence[int]) -> None:\n \"\"\"\n\n setUVGridPixelSpacing(self, offset)\n\n Set the spacing of the UV dot grid displayed over the background\n image.\n\n\n \"\"\"\n def uvGridPixelSpacing(self) -> Tuple[int, ...]:\n \"\"\"\n\n uvGridPixelSpacing(self) -> tuple of float\n\n Query the spacing of the UV dot grid displayed over background\n images.\n\n\n \"\"\"\n def setUVGridPixelOffset(self, offset: Sequence[float]) -> None:\n \"\"\"\n\n setUVGridPixelOffset(self, offset)\n\n Set the spacing, in pixels, of the dot grid.\n\n\n \"\"\"\n def uvGridPixelOffset(self) -> Tuple[float, ...]:\n \"\"\"\n\n uvGridPixelOffset(self) -> tuple of float\n\n Query the spacing of the dot grid in pixels.\n\n\n \"\"\"\n def setClampUVGridToBackground(self, enable: bool) -> None:\n \"\"\"\n\n setClampUVGridToBackground(self, enable)\n\n Restrict the grid to the background image's area.\n\n\n \"\"\"\n def clampUVGridToBackground(self) -> bool:\n \"\"\"\n\n clampUVGridToBackground(self) -> bool\n\n Query if the grid is restricted to the background image's area.\n\n\n \"\"\"\n def setDisplayUVTileBoundaries(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayUVTileBoundaries(self, enable)\n\n Display the boundaries of UV tiles at integral U and V numbers.\n\n\n \"\"\"\n def displayUVTileBoundaries(self) -> bool:\n \"\"\"\n\n displayUVTileBoundaries(self) -> bool\n\n Query if the boundaries of UV tiles are displayed.\n\n\n \"\"\"\n def setColorScheme(self, viewportColorScheme: EnumValue) -> None:\n \"\"\"\n\n setColorScheme(self, viewportColorScheme)\n\n Set the color scheme for the viewport.\n\n * hou.viewportColorScheme.Dark:\n\n Black background.\n\n * hou.viewportColorScheme.Grey:\n\n Light grey background.\n\n * hou.viewportColorScheme.Light:\n\n Light blue gradient background.\n\n * hou.viewportColorScheme.DarkGrey:\n\n Dark grey background.\n\n\n \"\"\"\n def colorScheme(self) -> EnumValue:\n \"\"\"\n\n colorScheme(self) -> hou.viewportColorScheme\n\n Query the current viewport color scheme.\n\n * hou.viewportColorScheme.Dark:\n\n Black background.\n\n * hou.viewportColorScheme.Grey:\n\n Light grey background.\n\n * hou.viewportColorScheme.Light:\n\n Light blue gradient background.\n\n * hou.viewportColorScheme.DarkGrey:\n\n Dark grey background.\n\n\n \"\"\"\n def colorFromName(self, name: str) -> Color:\n \"\"\"\n\n colorFromName(self, colorName) -> hou.Color\n\n Query a specific color from the current viewport color scheme. The\n valid color names can be found in the color scheme configuration\n files in 3DSceneColors.\n\n\n \"\"\"\n def alphaFromName(self, name: str) -> float:\n \"\"\"\n\n alphaFromName(self, colorName) -> double\n\n Query a specific alpha from the current viewport color scheme. The\n valid alpha names can be found in the color scheme configuration\n files in 3DSceneColors.\n\n\n \"\"\"\n def backgroundImage(self, viewportBackgroundView: EnumValue, layer: int = 1) -> GeometryViewportBackground:\n \"\"\"\n\n backgroundImage(self, viewportBGImageView, layer=1) ->\n hou.GeometryViewportBackground\n\n Access the background image parameters for the target view type.\n layer is currently not used but reserved for future use.\n\n * hou.viewportBGImageView.Perspective:\n\n The 3D view not attached to a camera (No cam).\n\n * hou.viewportBGImageView.Camera:\n\n The 3D view looking through a camera.\n\n * hou.viewportBGImageView.Top:\n\n The orthographic top view.\n\n * hou.viewportBGImageView.Front:\n\n The orthographic front view.\n\n * hou.viewportBGImageView.Right:\n\n The orthographic right view.\n\n * hou.viewportBGImageView.Bottom:\n\n The orthographic bottom view.\n\n * hou.viewportBGImageView.Back:\n\n The orthographic back view.\n\n * hou.viewportBGImageView.Left:\n\n The orthographic left view.\n\n * hou.viewportBGImageView.UV:\n\n The UV texture viewport.\n\n\n \"\"\"\n def setDisplayBackgroundImage(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayBackgroundImage(self, enable)\n\n Globally enable background image display.\n\n\n \"\"\"\n def displayBackgroundImage(self) -> bool:\n \"\"\"\n\n displayBackgroundImage(self) -> bool\n\n Query if background image display is globally enabled.\n\n\n \"\"\"\n def setDisplayEnvironmentBackgroundImage(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayEnvironmentBackgroundImage(self, enable)\n\n Allow environment lights to show their environment maps as 360\n degree background images.\n\n\n \"\"\"\n def displayEnvironmentBackgroundImage(self) -> bool:\n \"\"\"\n\n displayEnvironmentBackgroundImage(self) -> bool\n\n Query if environment lights' environment maps are shown as 360\n degree background images.\n\n\n \"\"\"\n def setFilterBackgroundImage(self, enable: bool) -> None:\n \"\"\"\n\n setFilterBackgroundImage(self, enable)\n\n Enable texture filtering of background images. When off, individual\n pixels are shown as blocks at high zoom levels rather than blended.\n\n\n \"\"\"\n def filterBackgroundImage(self) -> bool:\n \"\"\"\n\n filterBackgroundImage(self) -> bool\n\n Query if texture filtering of background images is enabled.\n\n\n \"\"\"\n def setApplyZoomToBackgroundImage(self, enable: bool) -> None:\n \"\"\"\n\n setApplyZoomToBackgroundImage(self, enable)\n\n Allow the camera zoom to affect the background image.\n\n\n \"\"\"\n def applyZoomToBackgroundImage(self) -> bool:\n \"\"\"\n\n applyZoomToBackgroundImage(self) -> bool\n\n Query if the camera zoom is affecting the background image.\n\n\n \"\"\"\n def setBackgroundImageQuality(self, quality: int) -> None:\n \"\"\"\n\n setBackgroundImageQuality(self, quality)\n\n Set the quality of the background image, from 0-100. Values less\n than 100 will scale down the resolution of the background image.\n\n\n \"\"\"\n def backgroundImageQuality(self) -> int:\n \"\"\"\n\n backgroundImageQuality(self) -> int\n\n Query the quality of background image display, from 0-100.\n\n\n \"\"\"\n def setDisplayTextures(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayTextures(self, enable)\n\n Enable material texturing.\n\n\n \"\"\"\n def displayTextures(self) -> bool:\n \"\"\"\n\n displayTextures(self) -> bool\n\n Query if material texturing is enabled.\n\n\n \"\"\"\n def setDisplayTextureLayers(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayTextureLayers(self, enable)\n\n Enable multiple texture layers when texturing. This causes an extra\n render of the geometry per texture layer.\n\n\n \"\"\"\n def displayTextureLayers(self) -> bool:\n \"\"\"\n\n displayTextureLayers(self) -> bool\n\n Query if multiple texture layers are rendered.\n\n\n \"\"\"\n def setDisplayProjectedTextures(self, enable: bool) -> None:\n \"\"\"\n\n setDisplayProjectedTextures(self, enable)\n\n Enable projected textures from spotlights with a valid texture.\n\n\n \"\"\"\n def displayProjectedTextures(self) -> bool:\n \"\"\"\n\n displayProjectedTextures(self) -> bool\n\n Query if projected textures from spotlights are rendered.\n\n\n \"\"\"\n def setTextureMipmapping(self, enable: bool) -> None:\n \"\"\"\n\n setTextureMipmapping(self, enable)\n\n Enable mipmapping for textures, improving display quality but\n increasing texture memory use by 50%.\n\n\n \"\"\"\n def textureMipmapping(self) -> bool:\n \"\"\"\n\n textureMipmapping(self) -> bool\n\n Query if texture mipmapping is enabled.\n\n\n \"\"\"\n def setTextureAnisotropicFilter(self, num_samples: int) -> None:\n \"\"\"\n\n setTextureAnisotropicFilter(self, num_samples)\n\n Set the number of samples for anisotropic texture filtering. More\n samples produces better results for textures on polygons on an angle\n to the view direction.\n\n\n \"\"\"\n def textureAnisotropicFilter(self) -> int:\n \"\"\"\n\n textureAnisotropicFilter(self) -> int\n\n Query the number of samples used for anisotropic texture filtering.\n\n\n \"\"\"\n def setTextureCacheSize(self, size_in_mb: int) -> None:\n \"\"\"\n\n setTextureCacheSize(self, size_in_mb)\n\n Set the size of the texture cache, in megabytes. The viewport will\n use as much texture memory as it needs, even if it exceeds this\n level, but textures will be culled once they are no longer used to\n remain within this limit.\n\n\n \"\"\"\n def textureCacheSize(self) -> int:\n \"\"\"\n\n textureCacheSize(self) -> int\n\n Query the texture cache size, in megabytes.\n\n\n \"\"\"\n def setTextureMaxMemory(self, size_in_mb: int) -> None:\n \"\"\"\n\n setTextureMaxMemory(self, size_in_mb)\n\n Set the maximum size of a single texture, in megabytes. This\n prevents extremely large textures from starving the graphics\n hardware's bandwidth (mostly by 3D textures).\n\n\n \"\"\"\n def textureMaxMemory(self) -> int:\n \"\"\"\n\n textureMaxMemory(self) -> int\n\n Return the maximum size of a single texture, in megabytes.\n\n\n \"\"\"\n def setTextureAutoReduce(self, enable: bool) -> None:\n \"\"\"\n\n setTextureAutoReduce(self, enable)\n\n Enable auto-reduction of viewport textures. This attempts to scale\n down textures to fit within the texture cache.\n\n\n \"\"\"\n def textureAutoReduce(self) -> bool:\n \"\"\"\n\n textureAutoReduce(self) -> bool\n\n Query if auto-reduction of viewport textures is enabled.\n\n\n \"\"\"\n def setTextureAutoReduce2D(self, enable: bool) -> None:\n \"\"\"\n\n setTextureAutoReduce2D(self, enable)\n\n Allow auto-reduction of regular 2D textures.\n\n\n \"\"\"\n def textureAutoReduce2D(self) -> bool:\n \"\"\"\n\n textureAutoReduce2D(self) -> bool\n\n Query if auto-reduction of regular 2D textures is allowed.\n\n\n \"\"\"\n def setTextureAutoReduce3D(self, enable: bool) -> None:\n \"\"\"\n\n setTextureAutoReduce3D(self, enable)\n\n Allow auto-reduction of 3D textures (volumes).\n\n\n \"\"\"\n def textureAutoReduce3D(self) -> bool:\n \"\"\"\n\n textureAutoReduce3D(self) -> bool\n\n Query if auto-reduction of 3D textures is allowed.\n\n\n \"\"\"\n def setTextureResLimit2D(self, enable: bool) -> None:\n \"\"\"\n\n setTextureResLimit2D(self, enable)\n\n Limit the resolution of all 2D textures, so that the width and\n height cannot exceed the limit. Even if disabled, OpenGL has its own\n texture limits which will be applied (usually 8k or 16k).\n\n\n \"\"\"\n def textureResLimit2D(self) -> bool:\n \"\"\"\n\n textureResLimit2D(self) -> bool\n\n Query if 2D textures have their resolutions limited.\n\n\n \"\"\"\n def setTextureMaxRes2D(self, res: Sequence[int]) -> None:\n \"\"\"\n\n setTextureMaxRes2D(self, res)\n\n Set the maximum resolution of a 2D texture. res is an integer\n 2-tuple of (width, height). OpenGL has its own limit, and setting\n this limit higher than that will have no effect. The image will be\n scaled to fit the limit if it exceeds it.\n\n\n \"\"\"\n def textureMaxRes2D(self) -> Tuple[int, ...]:\n \"\"\"\n\n textureMaxRes2D(self) -> 2-tuple of int\n\n Return the maximum resolution for a 2D texture.\n\n\n \"\"\"\n def setTextureBitDepthLimit2D(self, viewportTextureDepth: EnumValue) -> None:\n \"\"\"\n\n setTextureBitDepthLimit2D(self, viewportTextureDepth)\n\n Set the maximum bit depth for a 2D texture. Textures with a bit\n depth higher than this will be downconverted to this bit depth.\n Textures with an equal or lower bit depth will not be converted.\n\n * hou.viewportTextureDepth.Compressed8:\n\n Compressed, 8b SDR texture format. Smallest memory use.\n\n * hou.viewportTextureDepth.Fixed8:\n\n 8b SDR texture format. Good balance between memory and quality.\n\n * hou.viewportTextureDepth.HDR16:\n\n 16b HDR texture format. Excellent dynamic range, but more memory\n use and slower texturing performance.\n\n * hou.viewportTextureDepth.FullHDR:\n\n 32b HDR texture format. Extreme dynamic range, but very high\n memory use and slow texturing performance. Use with care.\n\n\n \"\"\"\n def textureBitDepthLimit2D(self) -> EnumValue:\n \"\"\"\n\n textureBitDepthLimit2D(self) -> hou.viewportTextureDepth\n\n Query the maximum bit depth for a 2D texture.\n\n * hou.viewportTextureDepth.Compressed8:\n\n Compressed, 8b SDR texture format. Smallest memory use.\n\n * hou.viewportTextureDepth.Fixed8:\n\n 8b SDR texture format. Good balance between memory and quality.\n\n * hou.viewportTextureDepth.HDR16:\n\n 16b HDR texture format. Excellent dynamic range, but more memory\n use and slower texturing performance.\n\n * hou.viewportTextureDepth.FullHDR:\n\n 32b HDR texture format. Extreme dynamic range, but very high\n memory use and slow texturing performance. Use with care.\n\n\n \"\"\"\n def setTextureScale2D(self, scale: float) -> None:\n \"\"\"\n\n setTextureScale2D(self, scale)\n\n Uniformly downscale all 2D textures by this fraction (default 1.0,\n no scale).\n\n\n \"\"\"\n def textureScale2D(self) -> float:\n \"\"\"\n\n textureScale2D(self) -> float\n\n Query the uniform scale applied to 2D textures.\n\n\n \"\"\"\n def setTextureResLimit3D(self, enable: bool) -> None:\n \"\"\"\n\n setTextureResLimit3D(self, enable)\n\n Limit the resolution of all 3D textures (volumes), so that the\n width, height, and depth cannot exceed the limit. Even if disabled,\n OpenGL has its own texture limits which will be applied (usually 2k\n or 8k).\n\n\n \"\"\"\n def textureResLimit3D(self) -> bool:\n \"\"\"\n\n textureResLimit3D(self) -> bool\n\n Query if 3D textures have their resolutions limited.\n\n\n \"\"\"\n def setTexture2DSettingsFor3D(self, enable: bool) -> None:\n \"\"\"\n\n setTexture2DSettingsFor3D(self, enable)\n\n When enabled, use all the 2D texture settings for 3D textures.\n\n\n \"\"\"\n def texture2DSettingsFor3D(self) -> bool:\n \"\"\"\n\n texture2DSettingsFor3D(self) -> bool\n\n Query if the 2D settings are used for 3D textures.\n\n\n \"\"\"\n def setTextureMaxRes3D(self, res: Sequence[int]) -> None:\n \"\"\"\n\n setTextureMaxRes3D(self, res)\n\n Set the maximum resolution of a 3D texture (volume). res is an\n integer 3-tuple of (width, height, depth). OpenGL has its own limit,\n and setting this limit higher than that will have no effect. The\n image will be scaled to fit the limit if it exceeds it.\n\n\n \"\"\"\n def textureMaxRes3D(self) -> Tuple[int, ...]:\n \"\"\"\n\n textureMaxRes3D(self) -> 3-tuple of int\n\n Query the maximum resolution of a 3D texture (volume).\n\n\n \"\"\"\n def setTextureBitDepthLimit3D(self, viewportTextureDepth: EnumValue) -> None:\n \"\"\"\n\n setTextureBitDepthLimit3D(self, viewportTextureDepth)\n\n Set the maximum bit depth for a 3D texture (volume). Textures with a\n bit depth higher than this will be downconverted to this bit depth.\n Textures with an equal or lower bit depth will not be converted. 3D\n textures do not support compressed formats.\n\n * hou.viewportTextureDepth.Fixed8:\n\n 8b SDR texture format. Good balance between memory and quality.\n\n * hou.viewportTextureDepth.HDR16:\n\n 16b HDR texture format. Excellent dynamic range, but more memory\n use and slower texturing performance.\n\n * hou.viewportTextureDepth.FullHDR:\n\n 32b HDR texture format. Extreme dynamic range, but very high\n memory use and slow texturing performance. Use with care.\n\n\n \"\"\"\n def textureBitDepthLimit3D(self) -> EnumValue:\n \"\"\"\n\n textureBitDepthLimit3D(self) -> hou.viewportTextureDepth\n\n Query the maximum bit depth of a 3D texture (volume).\n\n * hou.viewportTextureDepth.Fixed8:\n\n 8b SDR texture format. Good balance between memory and quality.\n\n * hou.viewportTextureDepth.HDR16:\n\n 16b HDR texture format. Excellent dynamic range, but more memory\n use and slower texturing performance.\n\n * hou.viewportTextureDepth.FullHDR:\n\n 32b HDR texture format. Extreme dynamic range, but very high\n memory use and slow texturing performance. Use with extreme\n care.\n\n\n \"\"\"\n def setTextureScale3D(self, scale: float) -> None:\n \"\"\"\n\n setTextureScale3D(self, scale)\n\n Uniformly downscale all 3D textures (volumes) by this fraction\n (default 1.0, no scale).\n\n\n \"\"\"\n def textureScale3D(self) -> float:\n \"\"\"\n\n textureScale3D(self) -> float\n\n Query the uniform scale applied to 3D textures (volumes).\n\n\n \"\"\"\n def useMaterialStylesheets(self, enable: bool) -> None:\n \"\"\"\n\n useMaterialStylesheets(self, enable)\n\n Enable evaluation of material stylesheets for viewport material\n assignment.\n\n\n \"\"\"\n def usingMaterialStylesheets(self) -> bool:\n \"\"\"\n\n usingMaterialStylesheets(self) -> bool\n\n Query if material stylesheet assignment is active.\n\n\n \"\"\"\n def usePerPrimStylesheets(self, enable: bool) -> None:\n \"\"\"\n\n usePerPrimStylesheets(self, enable)\n\n Enable evaluation of per-primitive stylesheets.\n\n\n \"\"\"\n def usingPerPrimStylesheets(self) -> bool:\n \"\"\"\n\n usingPerPrimStylesheets(self) -> bool\n\n Query if per-primitive stylesheets are evaluated.\n\n\n \"\"\"\n def usePackedStylesheets(self, enable: bool) -> None:\n \"\"\"\n\n usePackedStylesheets(self, enable)\n\n Enable assignment of material stylesheets to geometry within packed\n primitives.\n\n\n \"\"\"\n def usingPackedStylesheets(self) -> bool:\n \"\"\"\n\n usingPackedStylesheets(self) -> bool\n\n Query if material stylesheet assignments are applied to geometry\n within packed primitives.\n\n\n \"\"\"\n def useMaterialOverrides(self, enable: bool) -> None:\n \"\"\"\n\n useMaterialOverrides(self, enable)\n\n Allow material overrides from material stylesheets and the\n material_override attribute.\n\n\n \"\"\"\n def usingMaterialOverrides(self) -> bool:\n \"\"\"\n\n usingMaterialOverrides(self) -> bool\n\n Query if material overrides are being applied to material\n assignments.\n\n\n \"\"\"\n def setSingleObjectMaterialLimit(self, num_materials: int) -> None:\n \"\"\"\n\n setSingleObjectMaterialLimit(self, num_materials)\n\n Set the maximum number of material variations for a single object.\n\n\n \"\"\"\n def singleObjectMaterialLimit(self) -> int:\n \"\"\"\n\n singleObjectMaterialLimit(self) -> int\n\n Query the maximum number of material variations for a single object.\n\n\n \"\"\"\n def setMaterialUpdate(self, viewportMaterialUpdate: EnumValue) -> None:\n \"\"\"\n\n setMaterialUpdate(self, viewportMaterialUpdate)\n\n Set the material assignment update frequency.\n\n * hou.viewportMaterialUpdate.Always:\n\n Update assignments whenever needed.\n\n * hou.viewportMaterialUpdate.OffForPlayback:\n\n Update assignments whenever needed, but not during playback.\n\n * hou.viewportMaterialUpdate.Manual:\n\n Only update assignments when Update Materials is pressed.\n\n\n \"\"\"\n def materialUpdate(self) -> EnumValue:\n \"\"\"\n\n materialUpdate(self) -> hou.viewportMaterialUpdate\n\n Query the material assignment update frequency.\n\n * hou.viewportMaterialUpdate.Always:\n\n Update assignments whenever needed.\n\n * hou.viewportMaterialUpdate.OffForPlayback:\n\n Update assignments whenever needed, but not during playback.\n\n * hou.viewportMaterialUpdate.Manual:\n\n Only update assignments when Update Materials is pressed.\n\n\n \"\"\"\n def setInteractiveMaterialUpdate(self, enable: bool) -> None:\n \"\"\"\n\n setInteractiveMaterialUpdate(self, enable)\n\n Update materials when they are changed to reflect their new state.\n When disabled, Update Materials must be pressed manually for changes\n to be reflected in the viewport.\n\n\n \"\"\"\n def interactiveMaterialUpdate(self) -> bool:\n \"\"\"\n\n interactiveMaterialUpdate(self) -> bool\n\n Query if materials are updated when they change.\n\n\n \"\"\"\n def updateMaterials(self) -> None:\n \"\"\"\n\n updateMaterials(self)\n\n Manually update all materials and material assignments.\n\n\n \"\"\"\n def setVisibleObjects(self, uv: str) -> None:\n \"\"\"\n\n setVisibleObjects(self, uv)\n\n Set the mask for all visible objects in the viewport. Wildcards can\n be used.\n\n\n \"\"\"\n def visibleObjects(self) -> str:\n \"\"\"\n\n visibleObjects(self) -> str\n\n Query the current visible object mask.\n\n\n \"\"\"\n def setRemoveBackfaces(self, enable: bool) -> None:\n \"\"\"\n\n setRemoveBackfaces(self, enable)\n\n Cull polygons facing backwards instead of rasterizing them.\n\n\n \"\"\"\n def removeBackfaces(self) -> bool:\n \"\"\"\n\n removeBackfaces(self) -> bool\n\n Query if backwards facing polygons are culled.\n\n\n \"\"\"\n def setHullsOnly(self, enable: bool) -> None:\n \"\"\"\n\n setHullsOnly(self, enable)\n\n Draw only hulls for complex curves and surfaces like NURBS and\n Beziers.\n\n\n \"\"\"\n def hullsOnly(self) -> bool:\n \"\"\"\n\n hullsOnly(self) -> bool\n\n Query if only hulls are drawn for complex curves and surfaces.\n\n\n \"\"\"\n def setDistanceBasedPackedCulling(self, enable: bool) -> None:\n \"\"\"\n\n setDistanceBasedPackedCulling(self, enable)\n\n Enable culling of packed primitives when the polygon count of the\n visible objects in the frustum exceeds a certain amount, starting\n with the most distant.\n\n\n \"\"\"\n def distanceBasedPackedCulling(self) -> bool:\n \"\"\"\n\n distanceBasedPackedCulling(self) -> bool\n\n Query if packed primitive culling is enabled.\n\n\n \"\"\"\n def setScenePolygonLimit(self, millions_of_polygons: int) -> None:\n \"\"\"\n\n setScenePolygonLimit(self, millions_of_polygons)\n\n Set the maximum number of polygons in the view frustum, in millions,\n before the viewport begins culling packed primitives.\n\n\n \"\"\"\n def scenePolygonLimit(self) -> int:\n \"\"\"\n\n scenePolygonLimit(self) -> int\n\n Query the maximum allowed number of polygons in the view frustum, in\n millions of polygons.\n\n\n \"\"\"\n def setPackedBoundingBoxMode(self, viewportPackedBoxMode: EnumValue) -> None:\n \"\"\"\n\n setPackedBoundingBoxMode(self, viewportPackedBoxMode)\n\n Define how culled packed primitives are displayed.\n\n * hou.viewportPackedBoxMode.NoDisplay:\n\n Culled packed primitives are not displayed at all.\n\n * hou.viewportPackedBoxMode.Wireframe:\n\n A wireframe bounding box replaces the packed primitive.\n\n * hou.viewportPackedBoxMode.Shaded:\n\n A shaded bounding box replaces the packed primitive.\n\n * hou.viewportPackedBoxMode.CurrentShadingMode:\n\n A bounding box replaces the packed primitive, drawn wireframe in\n wireframe shading modes and shaded otherwise.\n\n\n \"\"\"\n def packedBoundingBoxMode(self) -> EnumValue:\n \"\"\"\n\n packedBoundingBoxMode(self) -> hou.viewportPackedBoxMode\n\n Query how culled packed primitives are displayed.\n\n * hou.viewportPackedBoxMode.NoDisplay:\n\n Culled packed primitives are not displayed at all.\n\n * hou.viewportPackedBoxMode.Wireframe:\n\n A wireframe bounding box replaces the packed primitive.\n\n * hou.viewportPackedBoxMode.Shaded:\n\n A shaded bounding box replaces the packed primitive.\n\n * hou.viewportPackedBoxMode.CurrentShadingMode:\n\n A bounding box replaces the packed primitive, drawn wireframe in\n wireframe shading modes and shaded otherwise.\n\n\n \"\"\"\n def setOptimizeGeometry(self, enable: bool) -> None:\n \"\"\"\n\n setOptimizeGeometry(self, enable)\n\n Optimize packed geometry when loaded to make it faster for display\n (triangulating and splitting meshes).\n\n\n \"\"\"\n def optimizeGeometry(self) -> bool:\n \"\"\"\n\n optimizeGeometry(self) -> bool\n\n Query if packed geometry is optimized.\n\n\n \"\"\"\n def setAgentLODReduction(self, enable: bool) -> None:\n \"\"\"\n\n setAgentLODReduction(self, enable)\n\n Enable the use of multiple levels of detail for crowd agents, each\n LOD level being half the polygon count of the previous level.\n\n\n \"\"\"\n def agentLODReduction(self) -> bool:\n \"\"\"\n\n agentLODReduction(self) -> bool\n\n Query if multiple levels of detail (LOD) are generated for crowd\n agents.\n\n\n \"\"\"\n def setAgentLODReductionBias(self, reduce_bias: int) -> None:\n \"\"\"\n\n setAgentLODReductionBias(self, reduce_bias)\n\n Set the LOD balance from Performance (0) to Quality (10), which\n biases which LOD levels are chosen.\n\n\n \"\"\"\n def agentLODReductionBias(self) -> int:\n \"\"\"\n\n agentLODReductionBias(self) -> int\n\n Query the LOD bias for agents.\n\n\n \"\"\"\n def setAgentShapePointCutoff(self, num_points: int) -> None:\n \"\"\"\n\n setAgentShapePointCutoff(self, num_points)\n\n Set the minimum number of points in an agent LOD level. If an LOD\n level would go below this number, it is not generated.\n\n\n \"\"\"\n def agentShapePointCutoff(self) -> int:\n \"\"\"\n\n agentShapePointCutoff(self) -> int\n\n Query the minimum number of points in an agent LOD level.\n\n\n \"\"\"\n def setMaxLODLevels(self, num_levels: int) -> None:\n \"\"\"\n\n setMaxLODLevels(self, num_levels)\n\n Set the maximum number of levels to generate for an agent. This will\n be the original model plus this number.\n\n\n \"\"\"\n def maxLODLevels(self) -> int:\n \"\"\"\n\n maxLODLevels(self) -> int\n\n Query the maximum number of levels generated for an agent.\n\n\n \"\"\"\n def setBaseLODLevel(self, base_level: int) -> None:\n \"\"\"\n\n setBaseLODLevel(self, base_level)\n\n Set the level to use as the full level of detail model, generally 0\n (the original agent model). For very heavy poly count agents, this\n can be set to higher values to reduce the polygon count of the\n highest level of detail model.\n\n\n \"\"\"\n def baseLODLevel(self) -> int:\n \"\"\"\n\n baseLODLevel(self) -> int\n\n Query the base level of detail.\n\n\n \"\"\"\n def setSingleBoneDeform(self, viewportAgentBoneDeform: EnumValue) -> None:\n \"\"\"\n\n setSingleBoneDeform(self, viewportAgentBoneDeform)\n\n Set the complexity of bone-based deformation on agents.\n\n * hou.viewportAgentBoneDeform.Always:\n\n Only use 1 bone to deform on all agent instances (the one with\n the most influence).\n\n * hou.viewportAgentBoneDeform.ReducedLOD:\n\n Use up to 4 bones to deform the highest LOD agent instances, and\n 1 bone on all the reduced LOD instances.\n\n * hou.viewportAgentBoneDeform.Disabled:\n\n Use up to 4 bones to deform on all agent instances.\n\n\n \"\"\"\n def singleBoneDeform(self) -> EnumValue:\n \"\"\"\n\n singleBoneDeform(self) -> hou.viewportAgentBoneDeform\n\n Query the complexity of bone-based deformation on agents.\n\n * hou.viewportAgentBoneDeform.Always:\n\n Only use 1 bone to deform on all agent instances (the one with\n the most influence).\n\n * hou.viewportAgentBoneDeform.ReducedLOD:\n\n Use up to 4 bones to deform the highest LOD agent instances, and\n 1 bone on all the reduced LOD instances.\n\n * hou.viewportAgentBoneDeform.Disabled:\n\n Use up to 4 bones to deform on all agent instances.\n\n\n \"\"\"\n def setAgentWireframe(self, viewportAgentWireframe: EnumValue) -> None:\n \"\"\"\n\n setAgentWireframe(self, viewportAgentWireframe)\n\n Set the appearance of agents in wireframe mode.\n\n * hou.viewportAgentWireframe.Bone:\n\n Agents are rendered as bone-based skeletons.\n\n * hou.viewportAgentWireframe.Line:\n\n Agents are rendered as line-based skeletons.\n\n\n \"\"\"\n def agentWireframe(self) -> EnumValue:\n \"\"\"\n\n agentWireframe(self) -> hou.viewportAgentWireframe\n\n Query the appearance of agents in wireframe mode.\n\n * hou.viewportAgentWireframe.Bone:\n\n Agents are rendered as bone-based skeletons.\n\n * hou.viewportAgentWireframe.Line:\n\n Agents are rendered as line-based skeletons.\n\n\n \"\"\"\n def setAgentBlendShapes(self, enable: bool) -> None:\n \"\"\"\n\n setAgentBlendShapes(self, enable)\n\n Enable the display of blend shapes for crowd agents.\n\n\n \"\"\"\n def agentBlendShapes(self) -> bool:\n \"\"\"\n\n agentBlendShapes(self) -> bool\n\n Query if blend shape display is enabled for crowd agents.\n\n\n \"\"\"\n\nclass GeometryViewportBackground:\n \"\"\"\n\n hou.GeometryViewportBackground\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def setImageFile(self, file_path: str) -> None:\n \"\"\"\n\n setImageFile(self, file_path)\n\n Set the filename of the background image and set the background\n source to 'File'.\n\n\n \"\"\"\n def imageFile(self) -> str:\n \"\"\"\n\n imageFile(self) -> str\n\n Query the filename of the background image.\n\n\n \"\"\"\n def setImageCOP(self, op_path: str) -> None:\n \"\"\"\n\n setImageCOP(self, op_path)\n\n Set the path to the Composite operator defining the background image\n and set the background source to 'COP'.\n\n\n \"\"\"\n def imageCOP(self) -> str:\n \"\"\"\n\n imageCOP(self) -> str\n\n Query the operation path of the background image.\n\n\n \"\"\"\n def sourceFromCOP(self, use_cop: bool) -> None:\n \"\"\"\n\n sourceFromCOP(self, use_cop)\n\n Fetch the background image from a composite operator instead of a\n disk file. If False, a disk file is used.\n\n\n \"\"\"\n def isCOPSource(self) -> bool:\n \"\"\"\n\n isCOPSource(self) -> bool\n\n Query if the background image is sourced from a composite operator.\n\n\n \"\"\"\n def isFileSource(self) -> bool:\n \"\"\"\n\n isFileSource(self) -> bool\n\n Query if the background image is sourced from a disk file.\n\n\n \"\"\"\n def setImageSource(self, file_or_op_path: str) -> None:\n \"\"\"\n\n setImageSource(self, file_or_op_path)\n\n Set the file or cop path, depending on the current background image\n source.\n\n\n \"\"\"\n def imageSource(self) -> str:\n \"\"\"\n\n imageSource(self) -> str\n\n Query the file or cop path, depending on the current background\n image source.\n\n\n \"\"\"\n def setEnvironmentMap(self, enable: bool) -> None:\n \"\"\"\n\n setEnvironmentMap(self, enable)\n\n Draw the background image as a 360 degree environment map, or a\n regular 2D image if set to False.\n\n\n \"\"\"\n def isEnvironmentMap(self) -> bool:\n \"\"\"\n\n isEnvironmentMap(self) -> bool\n\n Query if the background image is drawn as 360 degree environment\n map..\n\n\n \"\"\"\n def setAutoPlace(self, enable: bool) -> None:\n \"\"\"\n\n setAutoPlace(self, enable)\n\n Automatically fit the background image to the viewport. If False,\n use the manual offset and scale to position the image.\n\n\n \"\"\"\n def autoPlace(self) -> bool:\n \"\"\"\n\n autoPlace(self) -> bool\n\n Query if the background image is automatically fit to the viewport.\n\n\n \"\"\"\n def setImageFitMode(self, mode: EnumValue) -> None:\n \"\"\"\n\n setImageFitMode(self, mode)\n\n Sets how the auto-placed background image is fit to the viewport.\n\n\n \"\"\"\n def imageFitMode(self) -> EnumValue:\n \"\"\"\n\n imageFitMode(self) -> hou.geometryViewportBackgroundImageFitMode\n\n Queries how the auto-placed background image is fit to the viewport.\n\n\n \"\"\"\n def setImageOffset(self, offset: Sequence[float]) -> None:\n \"\"\"\n\n setImageOffset(self, offset)\n\n Set the background image offset, which is a 2-tuple of float. The\n values should be in the 0-1 range, representing fractions of the\n viewport width and height.\n\n\n \"\"\"\n def imageOffset(self) -> Tuple[float, ...]:\n \"\"\"\n\n imageOffset(self) -> tuple of float\n\n Query the background image offset.\n\n\n \"\"\"\n def setImageScale(self, scale: Sequence[float]) -> None:\n \"\"\"\n\n setImageScale(self, scale)\n\n Set the background image scale, which is a 2-tuple of float. The\n values should be in the 0-1 range, representing fractions of the\n viewport width and height.\n\n\n \"\"\"\n def imageScale(self) -> Tuple[float, ...]:\n \"\"\"\n\n imageScale(self) -> tuple of float\n\n Query the background image scale.\n\n\n \"\"\"\n def setOpacity(self, opacity: float) -> None:\n \"\"\"\n\n setOpacity(self, opacity)\n\n Set the opacity of the background image. A value of 1 makes it fully\n opaque, and smaller values turn it more transparent.\n\n\n \"\"\"\n def opacity(self) -> float:\n \"\"\"\n\n opacity(self) -> float\n\n Query the opacity of the background image.\n\n\n \"\"\"\n def setBrightness(self, intensity: float) -> None:\n \"\"\"\n\n setBrightness(self, intensity)\n\n Set the intensity multiplier of the background image. A value of 1\n keeps it at its original intensity, and values less than that dim\n it.\n\n\n \"\"\"\n def brightness(self) -> float:\n \"\"\"\n\n brightness(self) -> float\n\n Query the intensity multiplier of the background image.\n\n\n \"\"\"\n\nclass _GUDetailHandle:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isFrozen(self) -> bool: ...\n def isReadOnly(self) -> bool: ...\n def destroy(self) -> None: ...\n\nclass Handle:\n \"\"\"\n\n hou.Handle\n\n Gives access to an handle bound to a viewer state.\n\n OVERVIEW\n\n The Handle class lets you manipulate handles bound to viewer states.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, scene_viewer: PaneTab, name: str) -> None:\n '''\n\n __init__(self, scene_viewer, name)\n\n Creates an object for accessing a handle of a given name. hou.Handle\n is typically used with python viewer states.\n\n\n WARNING\n Handle objects are typically created from a python viewer state\n constructor. However, calling methods on Handle objects must be\n done once the state has been entered, exceptions will be raised\n otherwise.\n\n\n scene_viewer\n A hou.SceneViewer object referencing the scene viewer where the\n handle is going to be used. Exception is thrown if the scene\n viewer is not compatible.\n\n name\n A string to identify the handle object. The name corresponds to\n the handle\\'s name used at binding time. See\n hou.ViewerStateTemplate.bindHandle or\n hou.ViewerStateTemplate.bindStaticHandle for details.\n\n > class MyState(object):\n > def __init__(self, state_name, scene_viewer):\n > self.state_name = state_name\n > self.scene_viewer = scene_viewer\n > self.handle = hou.Handle(scene_viewer, \\\\\"Transform\\\\\")\n > \n > # Create a template to describe the state and its bindings\n > template = hou.ViewerStateTemplate(\\\\\"mystate\\\\\", \\\\\"My Custom State\\\\\", hou.sopNodeTypeCategory())\n > template.bindFactory(MyState)\n > template.bindHandle(\\\\\"xform\\\\\", \\\\\"Transform\\\\\")\n\n '''\n __swig_destroy__: Incomplete\n def name(self) -> str:\n \"\"\"\n\n name(self): -> string\n\n The name of this handle.\n\n\n \"\"\"\n def label(self) -> str:\n \"\"\"\n\n label(self): -> string\n\n The label of this handle for UI display purposes.\n\n\n \"\"\"\n def type(self) -> str:\n \"\"\"\n\n type(self): -> string\n\n Returns the type name of the handle. The return value corresponds to\n the type used for binding the handle. See\n hou.ViewerStateTemplate.bindHandle or\n hou.ViewerStateTemplate.bindStaticHandle for details.\n\n\n \"\"\"\n def show(self, value: bool) -> None:\n \"\"\"\n\n show(self, value)\n\n Shows or hides the handle.\n\n\n value\n Bool value, True to show the handle, False to hide it.\n\n\n \"\"\"\n def update(self, immediate: bool = False, node_update: bool = False, force_update: bool = False) -> None:\n \"\"\"\n\n update(self, immediate, node_update=False, force_update=False)\n\n Updates the handle if the value in any of its parameters has\n changed. Useful if a change made to a viewer state requires one of\n its handle to get updated. For dynamic handles, this will trigger a\n call to the onStateToHandle callback, allowing the viewer state to\n update the proper handle parameter(s).\n\n\n immediate\n Controls when the update is performed. If False, the update is\n delayed until Houdini is on idle. If True, the update is\n performed immediately. Defaults to False.\n\n node_update\n Calling update updates the handle parms by default. Set\n node_update to True to update the state node parms bound to the\n handle instead.\n\n\n NOTE\n This flag is supported for python viewer handles only.\n\n\n force_update\n Forces the underlying handle to update (default to False).\n Typically used with HUD handles to refresh their UI.\n\n\n NOTE\n This flag is supported for python viewer handles only.\n\n\n \"\"\"\n def visible(self) -> bool:\n \"\"\"\n\n visible(self): -> bool\n\n Returns True if the handle is visible, False otherwise.\n\n\n \"\"\"\n def enableParms(self, parm_names: Sequence[str]) -> None:\n \"\"\"\n\n enableParms(self, parm_names)\n\n Dynamically enables the parms of this handle specified with\n parm_names. If handle_parms is empty (default), all handle parms are\n enabled.\n\n Raises exception if the handle is not bound dynamically to a viewer\n state.\n\n\n NOTE\n Some handles like xform may not display its components right\n away when enabled. This can happen if the components were\n previously disabled. For instance, disabling the rotation\n (rx,ry,rz) and re-enabling it again will not restore the\n previous rotate mode to display the rotation knobs. Restoring\n the rotate mode must rather be achieved by cycling the Y key or\n by calling hou.Handle.applySetting.\n\n See also hou.Handle.disableParms.\n\n\n parm_names\n A list of names specifying the handle parms to enable.\n parm_names must contain the handle parm names as described here.\n Exception is raised if parm_names contains unknown parm names.\n\n\n \"\"\"\n def disableParms(self, parm_names: Sequence[str]) -> None:\n \"\"\"\n\n disableParms(self, parm_names)\n\n This method does the opposite of hou.Handle.enableParms and\n dynamically disables the handle parms specified in parm_names. If\n handle_parms is empty (default), all handle parms are disabled.\n\n Raises exception if the handle is not bound dynamically to a viewer\n state.\n\n\n parm_names\n A list of names specifying the handle parms to disable.\n parm_names must contain the handle parm names as described here.\n Exception is raised if parm_names contains unknown parm names.\n\n\n \"\"\"\n def applySettings(self, settings: str) -> None:\n \"\"\"\n\n applySettings(self, settings)\n\n Apply one or more settings to this handle.\n\n\n settings\n A string containing the handle specific settings. Multiple\n settings must be space separated.\n\n\n \"\"\"\n def settingValue(self, setting_name: str) -> Any:\n \"\"\"\n\n settingValue(self, setting_name) -> value\n\n Return the value of a setting parameter bound to this handle.\n\n\n setting_name\n The name of the setting to retrieve.\n\n\n \"\"\"\n def makePersistent(self, value: bool) -> None:\n \"\"\"\n\n makePersistent(self, value)\n\n Turns this handle to a persistent handle to make it visible when the\n node's handle is not selected.\n\n\n value\n If True, the handle is set as a persistent handle. If False, the\n handle is set to non-persistent and will only be visible when\n the node is selected.\n\n\n NOTE\n HUD handles, like HUD handles for parameters, are deleted\n and removed from the viewer if value is False.\n\n\n \"\"\"\n def isPersistent(self) -> bool:\n \"\"\"\n\n isPersistent(self): -> bool\n\n Returns True if the handle is a persistent handle, False otherwise.\n\n\n \"\"\"\n def isValid(self) -> bool:\n \"\"\"\n\n isValid(self): -> bool\n\n Returns True if the handle has been created properly, False\n otherwise.\n\n\n \"\"\"\n def isActive(self) -> bool:\n \"\"\"\n\n isActive(self): -> bool\n\n Returns True if the handle has been activated, False otherwise. This\n method indicates the handle has been initialized and activated by\n the current state.\n\n\n \"\"\"\n def parmPaths(self) -> Tuple[str, ...]:\n \"\"\"\n\n parmPaths(self): -> list of string\n\n Returns all parm paths mapped to this handle. A parm path is useful\n for creating a hou.Parm object.\n\n\n \"\"\"\n def isDynamic(self) -> bool:\n \"\"\"\n\n isDynamic(self): -> bool\n\n Returns True if the handle is bound to a python state dynamically.\n\n\n \"\"\"\n def info(self) -> str:\n \"\"\"\n\n info(self): -> string\n\n Returns a JSON dictionary string representing the python handle\n definition for this handle. Returns an empty string if the\n underlying handle type is not a python handle.\n\n See also hou.ui.viewerHandleInfo\n\n\n \"\"\"\n def nodePath(self, index: int = 0) -> str:\n \"\"\"\n\n nodePath(self, index): -> string\n\n Returns the node path for this handle.\n\n\n index\n The node index. Defaults to 0.\n\n\n \"\"\"\n def makeAsDefault(self) -> None:\n \"\"\"\n\n makeAsDefault(self)\n\n Make the current handle parms values the new default for the\n underlying handle type.\n\n\n \"\"\"\n def revertToDefault(self) -> None:\n \"\"\"\n\n revertToDefault(self)\n\n Set the current handle parms values with the handle default values.\n\n\n \"\"\"\n def revertToFactoryDefault(self) -> None:\n \"\"\"\n\n revertToFactoryDefault(self)\n\n\n Set the current handle parms values with the parms default values of\n the node definition. NOTE\n This method overwrites the current handle parms default values\n as well.\n\n\n \"\"\"\n def exportToHDA(self) -> None:\n \"\"\"\n\n exportToHDA(self)\n\n Adds the handle and its parms to the currently open digital asset\n editor.\n\n\n \"\"\"\n def exportParmsToHDA(self) -> None:\n \"\"\"\n\n exportParmsToHDA(self)\n\n Adds the handle parms to the currently open digital asset editor.\n\n\n \"\"\"\n def beginUndo(self) -> None:\n \"\"\"\n\n beginUndo(self)\n\n Opens an undo block to perform undoable operations with the\n underlying handle. All operations performed after\n\n\n \"\"\"\n def endUndo(self) -> None:\n \"\"\"\n\n endUndo(self)\n\n Closes an undo block previously opened with hou.Handle.beginUndo.\n\n\n \"\"\"\n def detach(self) -> None:\n \"\"\"\n\n detach(self)\n\n Places the handle in a detached mode. When in this mode, the\n handle's position and orientation can be manipulated independently\n without updating its bound parameters.\n\n This method toggles the handle's detached state. If the handle is\n currently detached, calling this method will re-attach it;\n otherwise, it will be detached.\n\n This functionality is applicable to handles that support detachment,\n such as xform and sidefx_transform2d handles.\n\n\n \"\"\"\n def attach(self) -> None:\n \"\"\"\n\n attach(self)\n\n Re-attaches the handle if it is currently in detached mode.\n\n\n \"\"\"\n def isDetached(self) -> bool:\n \"\"\"\n\n isDetached(self)\n\n Returns True if the handle is in detached mode; otherwise, returns\n False.\n\n\n \"\"\"\n def isDetachable(self) -> bool:\n \"\"\"\n\n isDetachable(self)\n\n Returns True if the handle can be detached; otherwise, returns\n False. Handles are not detachable by default.\n\n\n \"\"\"\n\nclass hda:\n \"\"\"\n\n hou.hda\n\n Module containing functions related to Houdini Digital Assets.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def installFile(file_path: str, oplibraries_file: Optional[str] = None, change_oplibraries_file: bool = True, force_use_assets: bool = False) -> None:\n \"\"\"\n\n installFile(file_path, oplibraries_file=None,\n change_oplibraries_file=True, force_use_assets=False)\n\n Install all the node types defined in an hda file into the current\n Houdini session. This function is equivalent to File > Install\n Digital Asset Library... in Houdini.\n\n\n file_path\n The hda file to load.\n\n oplibraries_file\n The path to an OPlibraries file or None. OPlibraries files are\n text files containing lists of hda files to load on startup.\n When Houdini starts up it reads all the OPlibraries files it\n finds in the Houdini path and loads all the hda files listed in\n them. By creating OPlibraries files in $HOME/houdiniX.Y,\n $HSITE/houdiniX.Y, $JOB, etc. you can create libraries that are\n specific to a particular user, studio, job, etc.\n\n This parameter is only meaningful when change_oplibraries_file\n is True.\n\n Note that OPlibraries are only used when the Use OPlibraries\n files to find HDAS checkbox in the Configuration tab of the\n Operator Type Manager is checked.\n\n If None or Current HIP File, the hda file is loaded only into\n the current Houdini session. The file name will also be saved in\n the Hip file so that when the same Hip file is loaded, the hda\n file will also be loaded automatically.\n\n If Scanned Asset Library Directories, this is equivalent to the\n installation menu entry in the Install Digital Asset Library\n dialog.\n\n change_oplibraries_file\n When oplibraries_file is not None and this parameter is True,\n Houdini will modify the OPlibraries file, adding the hda file to\n it.\n\n force_use_assets\n When True, ensure that the definitions inside the hda file are\n current. If they would not otherwise provide the current\n definition, they are marked as preferred to ensure they are\n current. See hou.HDADefinition.isPreferred for more information.\n\n Note that, if you do not store the path to the hda file in an\n OPlibraries file, Houdini will store it in the current Houdini\n session. So, when you load a hip file, it will try to load the hda\n files that it references.\n\n\n \"\"\"\n @staticmethod\n def uninstallFile(file_path: str, oplibraries_file: Optional[str] = None, change_oplibraries_file: bool = True) -> None:\n '''\n\n uninstallFile(file_path, oplibraries_file=None,\n change_oplibraries_file=True)\n\n Uninstall an hda file and all the node type definitions it provides\n from the current Houdini session. The hda file and its contents on\n disk are unchanged.\n\n You can set file_path to the special name \\\\\"Embedded\\\\\" to refer to the\n digital assets embedded in the current hip file. The following\n example removes any embedded digital asset definitions from the\n current Houdini session:\n\n > hou.hda.uninstallFile(\\\\\"Embedded\\\\\")\n\n If oplibraries_file is not None and change_oplibraries_file is True,\n Houdini will remove the path to the hda from the specified\n OPlibraries file. See hou.hda.installFile for more information about\n these parameters.\n\n If all the definitions of a node type are uninstalled, any instances\n of that node type will warn that they are using an incomplete asset\n definition. They will, however, retain their parameter values as\n spare parameters. Installing an hda file with the missing node type\n will restore those node instances and remove the warnings.\n\n See also hou.HDADefinition.destroy.\n\n\n '''\n @staticmethod\n def installFiles(file_paths: Sequence[str], oplibraries_file: Optional[str] = None, change_oplibraries_file: bool = True, force_use_assets: bool = False) -> None:\n \"\"\"\n\n installFiles(file_paths, oplibraries_file=None,\n change_oplibraries_file=True, force_use_assets=False)\n\n Batch install all the node types defined in the list of hda files\n into the current Houdini session. This function is equivalent to\n File > Install Digital Asset Library... in Houdini.\n\n\n file_paths\n The list of hda files to install.\n\n See hou.hda.installFile for more information about installing files.\n\n\n \"\"\"\n @staticmethod\n def uninstallFiles(file_paths: Sequence[str], oplibraries_file: Optional[str] = None, change_oplibraries_file: bool = True) -> None:\n \"\"\"\n\n uninstallFiles(file_paths, oplibraries_file=None,\n change_oplibraries_file=True)\n\n Batch uninstall a list of hda file and all the node type definitions\n it provides from the current Houdini session. The hda files and\n their contents on disk are unchanged.\n\n\n file_paths\n The list of hda files to uninstall.\n\n See hou.hda.uninstallFile for more information about uninstalling\n files.\n\n See also hou.HDADefinition.destroy.\n\n\n \"\"\"\n @staticmethod\n def reloadFiles(file_paths: Sequence[str]) -> None:\n \"\"\"\n\n reloadFiles(file_paths)\n\n Batch reload the contents of a list of hda file, loading any updated\n digital asset definitions inside them.\n\n You only need to call this function if the hda files were modified\n from outside the current Houdini session.\n\n\n file_paths\n The list of hda files to reload.\n\n See also hou.hda.reloadFile.\n\n\n \"\"\"\n @staticmethod\n def reloadFile(file_path: str) -> None:\n \"\"\"\n\n reloadFile(file_path)\n\n Reload the contents of an hda file, loading any updated digital\n asset definitions inside it.\n\n You only need to call this function if an hda file was modified from\n outside the current Houdini session.\n\n\n \"\"\"\n @staticmethod\n def reloadAllFiles(rescan: bool = True) -> None:\n \"\"\"\n\n reloadAllFiles(rescan=True)\n\n Reload the digital asset files and update asset definitions in the\n current session.\n\n If the rescan is true, Houdini will check the hda directories for\n any new hda files and load them too.\n\n See also hou.hda.reloadFile.\n\n\n \"\"\"\n @staticmethod\n def reloadNamespaceOrder() -> None:\n \"\"\"\n\n reloadNamespaceOrder()\n\n Check HOUDINI_OPNAMESPACE_HIERARCHY environment variable and rebuild\n the node type preference order that determines the node type to use\n when only unqualified root name is used in scripts, or, when Tab\n menu settings specify to show only a single preferred entry among\n several potential choices from different namespaces.\n\n\n \"\"\"\n @staticmethod\n def expandToDirectory(file_path: str, directory_path: str) -> None:\n \"\"\"\n\n expandToDirectory(file_path, directory_path)\n\n Expand the contents of the hda file in file_path into the directory\n directory_path. If the directory does not already exist it is\n created.\n\n When expanding an hda file, Houdini puts each digital asset\n definition in the file into its own directory. As well, it puts each\n section inside a definition into its own file. Each directory inside\n the expanded file tree contains a Sections.List file that maps the\n actual file or directory names into the section names, since section\n names may contain characters that cannot occur in directory or file\n names. See hou.HDASection for more information about sections.\n\n This function provides an easy way to inspect and modify the\n contents of an hda file. See also hou.hda.collapseFromDirectory.\n\n\n \"\"\"\n @staticmethod\n def collapseFromDirectory(file_path: str, directory_path: str) -> None:\n \"\"\"\n\n collapseFromDirectory(file_path, directory_path)\n\n Given a directory that contains a previously expanded hda file,\n collapse it into the hda file specified by file_path.\n\n This function provides the inverse of hou.hda.expandToDirectory.\n\n\n \"\"\"\n @staticmethod\n def loadedFiles() -> Tuple[str, ...]:\n \"\"\"\n\n loadedFiles() -> tuple of str\n\n Return a tuple of paths to the hda files that are loaded into the\n current Houdini session.\n\n This method is can be approximately implemented as follows:\n\n > def loadedFiles():\n > '''Return a list of hda files loaded into this Houdini session.'''\n > # Look through all the node types, and for those that have digital\n > # asset definitions, remember the hda file containing the definition.\n > result = []\n > for category in hou.nodeTypeCategories().values():\n > for node_type in category.nodeTypes().values():\n > definition = node_type.definition()\n > if definition is None:\n > continue\n > if definition.libraryFilePath() not in result:\n > result.append(definition.libraryFilePath())\n > return result\n\n See hou.HDADefinition.isCurrent for an example.\n\n\n \"\"\"\n @staticmethod\n def renameSource(oplibraries_file: str, source_name: Optional[str] = None) -> None:\n \"\"\"\n\n renameSource(oplibraries_file, source_name=None)\n\n Give a name to an OPlibraries file. This name appears in the\n Operator Type Manager's list of OPlibraries file. If source_name is\n None, the name is removed from the OPlibraries file.\n\n If the oplibraries_file does not already exist, it is created.\n\n See hou.hda.installFile for more information about OPlibraries\n files.\n\n\n \"\"\"\n @staticmethod\n def definitionsInFile(file_path: str) -> Tuple[HDADefinition, ...]:\n '''\n\n definitionsInFile(file_path) -> tuple of hou.HDADefinition\n\n Return all the digital asset definitions inside an hda file. See\n hou.HDADefinition for more information.\n\n Raises hou.OperationFailed if file_path does not refer to a valid\n hda file.\n\n > # Print the node types defined by digital assets in $HOME/houdiniX.Y/hda/OPcustom.hda:\n > >>> import os\n > >>> my_hda_file = \\\\\"%s/hda/OPcustom.hda\\\\\" % hou.homeHoudiniDirectory()\n > >>> for definition in hou.hda.definitionsInFile(my_hda_file):\n > ... print definition.nodeTypeCategory().name() + \\\\\"/\\\\\" + definition.nodeTypeName()\n > Sop/gcoggeo\n > Sop/gCogFlatGeo\n > Sop/gDivideAtCentroid\n > Object/gAxle\n > Object/gCog\n\n '''\n @staticmethod\n def componentsFromFullNodeTypeName(node_type_name: str) -> Tuple[str, ...]:\n \"\"\"\n\n componentsFromFullNodeTypeName(node_type_name) -> tuple of str\n\n Returns a tuple of operator type name components that constitute the\n full node type name. The components in the tuple appear in the\n following order: scope network type, node type namespace, node type\n core name, and version.\n\n > >>> # Parse the full name into components\n > >>> hou.hda.componentsFromFullNodeTypeName('MyUserNamespace::MyHDA::2.5')\n > ('', 'MyUserNamespace', 'MyHDA', '2.5')\n > >>> hou.hda.componentsFromFullNodeTypeName('Sop/foreach::MyCounterHDA')\n > ('Sop/foreach', '', 'MyCounterHDA', '')\n\n \"\"\"\n @staticmethod\n def fullNodeTypeNameFromComponents(scope_node_type: str, name_space: str, name: str, version: str) -> str:\n \"\"\"\n\n fullNodeTypeNameFromComponents(scope_node_type, name_space, name,\n version) -> str\n\n Returns a full node type name build out of the given components. The\n arguments represent the following components: scope network type,\n node type namespace, node type core name, and version.\n\n > >>> # Compose the node type full name from components\n > >>> hou.hda.fullNodeTypeNameFromComponents('', 'userA', 'sphere', '')\n > 'userA::sphere'\n > >>> hou.hda.fullNodeTypeNameFromComponents('', 'userB', 'myHda', '2.6')\n > 'userB::myHda::2.6'\n > >>> hou.hda.fullNodeTypeNameFromComponents('Sop/foreach', '', 'MyCounterHDA', '')\n > 'Sop/foreach::MyCounterHDA'\n\n \"\"\"\n @staticmethod\n def changeCurrentStoreUser(new_user: str) -> None: ...\n @staticmethod\n def safeguardHDAs() -> bool:\n \"\"\"\n\n safeguardHDAs() -> bool\n\n Return True if the Safeguard Operator Definitions configuration\n option is turned on. When safeguarding is turned on then no digital\n asset definition can be modified in the Houdini session.\n\n\n \"\"\"\n @staticmethod\n def setSafeguardHDAs(on: bool) -> None:\n \"\"\"\n\n setSafeguardHDAs(on)\n\n Set whether the Safeguard Operator Definitions configuration option\n should be turned on or off. The on argument must be either True of\n False.\n\n\n \"\"\"\n @staticmethod\n def removeAllEventCallbacks() -> None:\n \"\"\"\n\n removeAllEventCallbacks(self)\n\n Remove all event callbacks for all event types.\n\n See hou.hda.addEventCallback for more information.\n\n\n \"\"\"\n @staticmethod\n def defaultFileExtension() -> str:\n \"\"\"\n\n defaultFileExtension(self) -> str\n\n Returns the default hda file extension for the current session based\n on the taint.\n\n\n \"\"\"\n @staticmethod\n def addEventCallback(event_types: Sequence[EnumValue], callback: Callable) -> None:\n '''\n\n addEventCallback(self, event_types, callback)\n\n Register a Python callback that Houdini will call whenever a\n particular action, or event, occurs with digital asset libraries.\n\n Callbacks only persist for the current session. For example, they\n are not saved to the .hip file. If you want persistent callbacks in\n every session, you can add them in code in pythonrc.py (runs on\n startup) or 456.py (runs when the user opens a .hip file). See where\n to add Python scripting for more information.\n\n\n event_types\n A sequence of hou.hdaEventType enumeration values describing the\n event types that will cause Houdini to call the callback\n function.\n\n callback\n A callable Python object, such as a function or bound method.\n Houdini will call this function whenever one of the event types\n in event_types occurs.\n\n Houdini calls the function with an event_type keyword argument\n containing the hou.hdaEventType value corresponding to the event\n that triggered the callback.\n\n Houdini will pass additional keyword arguments depending on the\n event type. For example, in a callback for the LibraryInstalled\n or LibraryUninstalled events, Houdini will pass a library_path\n keyword argument containing the path of the .hda file that was\n installed or uninstalled. See hou.hdaEventType for the\n additional arguments passed for each event type.\n\n You can add **kwargs to the argument list to accept all keyword\n arguments, to allow the same callback to be used for different\n events, or to be safe from future changes:\n\n > def event_callback(event_type, **kwargs):\n > ...\n\n NOTE\n If you try to add the exact same callback function more than\n once, Houdini will still only call the function only once in\n response to an event. However, it may be useful to add the same\n function if you want to register it with different event_types.\n\n Raises hou.OperationFailed if the event_types list argument is\n empty.\n\n The following example shows to set up a function that\\'s called\n whenever a new asset is added to Houdini:\n\n > \n > def hda_event(event_type, asset_definition, **kwargs):\n > label = asset_definition.description()\n > library_path = asset_definition.libraryFilePath()\n > print(\\\\\"New asset %s in %s\\\\\" % (label, library_path))\n > \n > hou.hda.addEventCallback((hou.hdaEventType.AssetCreated, ), hda_event)\n\n See also hou.hda.removeEventCallback and\n hou.hda.removeAllEventCallbacks.\n\n\n '''\n @staticmethod\n def removeEventCallback(event_types: Sequence[EnumValue], callback: Callable) -> None:\n \"\"\"\n\n removeEventCallback(self, event_types, callback)\n\n Given a callback that was previously added and a sequence of\n hou.hdaEventType enumerated values, remove those event types from\n the set of event types for the callback. If the remaining set of\n event types is empty, the callback will be removed entirely.\n\n Raises hou.OperationFailed if the event_types list argument is\n empty.\n\n Raises hou.OperationFailed if the callback had not been previously\n added.\n\n See hou.hda.addEventCallback for more information.\n\n\n \"\"\"\n @staticmethod\n def eventCallbacks() -> Tuple[Tuple[Tuple[EnumValue, ...], Any], ...]: ...\n\n # Missing methods added by stubgen\n @staticmethod\n def reloadHDAModule(hda_module: HDAModule) -> None: ...\n\nclass HDADefinition:\n \"\"\"\n\n hou.HDADefinition\n\n Represents the definition of a houdini digital asset (HDA).\n\n A digital asset definition defines a node type and exists inside an hda\n file. The node type is implemented in terms of other nodes wired\n together inside a subnet. These nodes inside the subnet are called the\n definition's contents.\n\n An hda file contains one or more digital asset definitions, and\n installing an hda file installs all the definitions in the file. When a\n digital asset definition is installed, the node type it defines is added\n to Houdini. Note that you can access an HDADefinition without installing\n it.\n\n A digital asset's algorithm is determined by the nodes inside it. To\n edit those nodes you create an instance of the digital asset, unlock it,\n modify the contents, and save the definition. New digital asset\n instances are normally locked, meaning that they are read-only, and they\n automatically update when the asset's definition changes. An unlocked\n instance is editable, does not update when the definition changes, and\n you can save its contents to change the definition.\n\n To unlock a node, select Allow Editing of Contents or call\n hou.OpNode.allowEditingOfContents. To save the contents of an unlocked\n node to the definition, select Save Operator Type or call\n hou.HDADefinition.updateFromNode. To revert an unlocked instance back to\n the last saved definition and change it back into a locked instance,\n select Match Current Definition or call\n hou.OpNode.matchCurrentDefinition.\n\n See also hou.hda and hou.HDAOptions.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def nodeType(self) -> OpNodeType:\n \"\"\"\n\n nodeType(self) -> hou.NodeType\n\n Return the node type defined by this digital asset. Raises\n hou.OperationFailed if the digital asset is not installed.\n\n\n \"\"\"\n def nodeTypeCategory(self) -> OpNodeTypeCategory:\n \"\"\"\n\n nodeTypeCategory(self) -> hou.NodeTypeCategory\n\n Return the node type category (e.g. Objects, SOPs, DOPs, etc.) for\n the node type defined by this digital asset. See\n hou.NodeTypeCategory for more information.\n\n It is safe to call this method if the digital asset is not\n installed. If the digital asset is installed, this method is\n equivalent to self.nodeType().category().\n\n\n \"\"\"\n def nodeTypeName(self) -> str:\n \"\"\"\n\n nodeTypeName(self) -> str\n\n Return the name of the node type defined by this digital asset.\n Raises hou.OperationFailed if the digital asset is not installed.\n\n If the digital asset is installed, this method is a shortcut for\n self.nodeType().name().\n\n\n \"\"\"\n def libraryFilePath(self) -> str:\n '''\n\n libraryFilePath(self) -> str\n\n Return the path to the hda file containing the digital asset\\'s\n definition.\n\n Note that it is possible to save an asset with a hip file, without\n storing it in an hda file. In this case, this method returns\n \\\\\"Embedded\\\\\".\n\n\n '''\n def embeddedHelp(self) -> str:\n \"\"\"\n\n embeddedHelp(self) -> str\n\n Return the help text embedded in the digital asset. Return an empty\n string if no embedded help exists.\n\n Embedded help typically comes from the Help tab of the operator type\n properties window, but it may also come from a dialog script.\n\n\n \"\"\"\n def isInstalled(self) -> bool:\n \"\"\"\n\n isInstalled(self) -> bool\n\n Return whether this definition is installed in Houdini.\n\n It is possible to access HDADefinition objects in hda files that are\n not installed with hou.hda.definitionsInFile.\n\n See also hou.hda.installFile.\n\n\n \"\"\"\n def installed(self) -> bool: ...\n def isCurrent(self) -> bool:\n '''\n\n isCurrent(self) -> bool\n\n Return whether this definition is the one currently in use by\n Houdini.\n\n This example shows how you can access other definitions for the same\n node type:\n\n > def otherDefinitions(definition):\n > \\'\\'\\'Given an HDADefinition object, return the other loaded definitions\n > for the same node type.\\'\\'\\'\n > # Look through all the loaded hda files for definitions providing\n > # the same node type.\n > result = []\n > for hda_file in hou.hda.loadedFiles():\n > # Skip the hda file containing the definition that was passed in.\n > if hda_file == definition.libraryFilePath():\n > continue\n > \n > for other_definition in hou.hda.definitionsInFile(hda_file):\n > if other_definition.nodeType() == definition.nodeType():\n > result.append(other_definition)\n > return result\n > # Print the paths to hda files providing other definitions for a digital asset instance.\n > >>> for other_definition in otherDefinitions(hou.node(\\\\\"/obj/my_hda1\\\\\").type().definition()):\n > ... print other_definition.libraryFilePath()\n > /path/to/file1.hda\n > /path/to/file2.hda\n\n '''\n def current(self) -> bool: ...\n def isPreferred(self) -> bool:\n \"\"\"\n\n isPreferred(self) -> bool\n\n Return whether this definition is preferred.\n\n After loading hda files, Houdini uses a set of rules to resolve\n conflicts when it encounters multiple definitions for the same node\n type (e.g. preferring the most recent hda file, preferring\n definitions embedded in the hip file, etc.). When these rules do not\n use the definition you want, you can override them by explicitly\n marking a definition as preferred. Houdini saves this list of\n preferred definitions with the hip file. Marking a definition as not\n preferred will remove it from this list, and the normal rules will\n apply again.\n\n\n \"\"\"\n def preferred(self) -> bool: ...\n def setIsPreferred(self, preferred: bool) -> None:\n \"\"\"\n\n setIsPreferred(self, preferred)\n\n Set whether this definition is preferred. See\n hou.HDADefinition.isPreferred for more information.\n\n\n \"\"\"\n def setPreferred(self, preferred: bool) -> None: ...\n def enableCreateBackups(self, create_backups: bool) -> None:\n \"\"\"\n\n enableCreateBackups(self, create_backups)\n\n Sets whether or not backup files should be created each time the HDA\n is modified, e.g. if a section is added or removed, if the icon is\n changed, etc.\n\n\n \"\"\"\n def isCreateBackupsEnabled(self) -> bool:\n \"\"\"\n\n isCreateBackupsEnabled(self) -> bool\n\n Returns true if the HDA Definition creates backup files on disk when\n modified.\n\n\n \"\"\"\n def sections(self) -> dict[str, HDASection]:\n \"\"\"\n\n sections(self) -> dict of str to hou.HDASection\n\n Return a dictionary mapping section names to hou.HDASection objects.\n See hou.HDASection for more information on sections.\n\n\n \"\"\"\n def hasSection(self, name: str) -> bool:\n \"\"\"\n\n hasSection(self, name) -> bool\n\n Return True if the HDA definition contains a section with the\n specified name and False otherwise.\n\n See hou.HDASection for more information on sections.\n\n\n \"\"\"\n def addSection(self, name: str, contents: str = ..., compression_type: EnumValue = ...) -> HDASection:\n '''\n\n addSection(self, name, contents=\\\\\"\\\\\",\n compression_type=hou.compressionType.NoCompression) -> hou.HDASection\n\n Create a new section with the specified contents. If a section\n already exists with this name, changes the existing contents to the\n new contents. Note that the contents may contain binary data. Also\n note that section names may contain \\'/\\'.\n\n You can optionally specify a compression type, hou.compressionType,\n to compress the contents. Note that you must specify the same\n compression type when reading the contents back to decompress them.\n\n For Python 3, the contents can be either a str object for plain text\n data or a bytes object for binary data.\n\n See hou.HDASection for more information on sections. To remove a\n section, use hou.HDASection.destroy.\n\n Sections can have associated properties stored in the\n hou.HDADefinition.extraFileOptions.\n\n > def addSectionFromFile(hda_definition, section_name, file_name):\n > \\'\\'\\'Add a section whose contents come from a file. If the section\n > already exists, replace its contents.\\'\\'\\'\n > section_file = open(file_name, \\\\\"r\\\\\")\n > hda_definition.addSection(section_name, section_file.read())\n > section_file.close()\n\n '''\n def removeSection(self, name: str) -> None:\n \"\"\"\n\n removeSection(self, name)\n\n Remove an existing section. Only remove sections that you explicitly\n added. Do not remove the special sections that Houdini uses to store\n the contents of the digital asset definition, or Houdini will\n generate errors or strange side effects.\n\n See hou.HDASection for more information on sections. Note that\n hou.HDASection.destroy will also remove a section.\n\n Raises hou.OperationFailed if no such section exists in the\n definition.\n\n\n \"\"\"\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return the description for this definition's node type. Houdini uses\n this description for user interface elements such as the TAB menu.\n This description is also called the operator label in Houdini.\n\n See also hou.NodeType.description.\n\n\n \"\"\"\n def setDescription(self, label: str) -> None:\n \"\"\"\n\n setDescription(self, description)\n\n Set the description for this definition's node type. Houdini uses\n this description for user interface elements such as the TAB menu.\n This description is also called the operator label in Houdini.\n\n See also hou.HDADefinition.description and hou.NodeType.description.\n\n\n \"\"\"\n def icon(self) -> str:\n \"\"\"\n\n icon(self) -> str\n\n Return the name or path of the icon for this definition's node type.\n Note that Houdini uses its search path to locate icons, so you do\n not need to pass in a full path.\n\n See also hou.NodeType.icon.\n\n\n \"\"\"\n def setIcon(self, icon: str) -> None:\n \"\"\"\n\n setIcon(self, icon)\n\n Set the icon for this definition's node type. See\n hou.HDADefinition.icon for more information.\n\n\n \"\"\"\n def minNumInputs(self) -> int:\n \"\"\"\n\n minNumInputs(self) -> int\n\n Return the minimum number of connected inputs that node instances of\n this digital asset can have. If these inputs are not connected, the\n node will generate an error.\n\n See also hou.NodeType.minNumInputs.\n\n\n \"\"\"\n def setMinNumInputs(self, min_num_inputs: int) -> None:\n \"\"\"\n\n setMinNumInputs(self, min_num_inputs)\n\n Set the minimum number of connected inputs that node instances of\n this digital asset must have. min_num_inputs must be between 0 and\n 4, inclusive. If a node does not have the minimum number of inputs,\n it will generate an error.\n\n\n \"\"\"\n def maxNumInputs(self) -> int:\n \"\"\"\n\n maxNumInputs(self) -> int\n\n Return the maximum number of inputs that node instances of this\n digital asset can have. Return a number greater than 4 if this node\n type can accept an unlimited number of inputs.\n\n See also hou.NodeType.maxNumInputs.\n\n\n \"\"\"\n def setMaxNumInputs(self, max_num_inputs: int) -> None:\n \"\"\"\n\n setMaxNumInputs(self, max_num_inputs)\n\n Set the maximum number of inputs that node instances of this digital\n asset may have. This number must be greater than or equal to the\n minimum number of inputs. If it is 5 or greater, Houdini will use a\n merge SOP-style input connector that allows an unlimited number of\n inputs. Otherwise, the node will have between 0 and 4 input\n connectors, each of which may or may not be connected, that\n correspond to the subnet indirect inputs inside the digital asset.\n\n See hou.Node.inputConnectors and hou.SubnetIndirectInput for more\n information on input connectors and subnet indirect inputs.\n\n\n \"\"\"\n def maxNumOutputs(self) -> int:\n \"\"\"\n\n maxNumOutputs(self) -> int\n\n Return the maximum number of outputs that node instances of this\n digital asset can have.\n\n See also hou.NodeType.maxNumOutputs.\n\n\n \"\"\"\n def setMaxNumOutputs(self, max_num_outputs: int) -> None:\n \"\"\"\n\n setMaxNumOutputs(self, max_num_outputs)\n\n Set the maximum number of outputs that node instances of this\n digital asset may have.\n\n\n \"\"\"\n def extraInfo(self) -> str:\n \"\"\"\n\n extraInfoValue(self, key) -> str\n\n Return a string with the extra information item stored under known\n key key.\n\n See also hou.HDADefinition.extraInfo.\n\n\n \"\"\"\n def setExtraInfo(self, extra_info: str) -> None:\n \"\"\"\n\n setExtraInfo(self, extra_info)\n\n Set extra information about the asset definition that isn't stored\n elsewhere, like the representative node, guide geometry, etc. This\n string is encoded in a specific format, so it is recommended that\n you only call this method with values returned from\n hou.HDADefinition.extraInfo.\n\n\n \"\"\"\n def extraInfoValue(self, key: str) -> str: ...\n def userInfo(self) -> str:\n \"\"\"\n\n userInfo(self) -> str\n\n Return a string containing user specified information about the\n asset definition.\n\n\n \"\"\"\n def setUserInfo(self, extra_info: str) -> None:\n \"\"\"\n\n setUserInfo(self, extra_info)\n\n Set user information about the asset definition. This info isn't\n used by Houdini so it can contain any text.\n\n\n \"\"\"\n def hideDefaultParameters(self) -> bool:\n \"\"\"\n\n hideDefaultParameters(self) -> bool\n\n Return whether the parameters that are common to nodes types in this\n node type category are hidden or not. For example, nearly all\n objects have common translation, rotation, scale, etc. parameters,\n and object level digital assets have these parameters by default. If\n hidden, though, these parameters are still there but are not\n displayed to the user.\n\n Note that this value is also stored in the string returned by\n hou.HDADefinition.extraInfo.\n\n\n \"\"\"\n def representativeNodePath(self) -> str:\n \"\"\"\n\n representativeNodePath(self) -> str\n\n Return the contents of the Representative Node field on the Basic\n tab of the Type Properties dialog.\n\n For object-level digital assets that contain other object nodes, it\n is possible to make Houdini treat your digital asset like a camera\n or light by choosing a node inside the asset to represent it. For\n example, if you choose a camera inside the asset as the\n representative node, instances of the digital asset will appear in\n the viewport's list of camera objects.\n\n Note that this value is also stored in the string returned by\n hou.HDADefinition.extraInfo.\n\n\n \"\"\"\n def comment(self) -> str: ...\n def setComment(self, comment: str) -> None: ...\n def version(self) -> str: ...\n def setVersion(self, version: str) -> None: ...\n def modificationTime(self) -> int:\n '''\n\n modificationTime(self) -> int\n\n Return the time when the definition was last modified. This time is\n returned as a POSIX timestamp, such as is returned by time.time().\n\n > >>> import time\n > >>> time.ctime(hou.nodeType(hou.objNodeTypeCategory(), \\\\\"toon_character\\\\\").\n > ... definition().modificationTime())\n > \\'Thu Nov 6 18:22:38 2008\\'\n\n '''\n def setModificationTime(self, time: int = -1) -> None:\n \"\"\"\n\n setModificationTime(self, time=-1)\n\n Set the modification time for the definition to the given POSIX\n timestamp. If the time parameter is negative, uses the current time.\n\n See also hou.HDADefinition.modificationTime.\n\n\n \"\"\"\n def options(self) -> HDAOptions:\n \"\"\"\n\n options(self) -> hou.HDAOptions\n\n Return a hou.HDAOptions object for the options stored in this\n digital asset. See hou.HDAOptions for more information.\n\n\n \"\"\"\n def setOptions(self, options: HDAOptions) -> None:\n \"\"\"\n\n setOptions(self, options)\n\n Set this digital asset definition's options to the data in a\n hou.HDAOptions object. See hou.HDAOptions for more information.\n\n\n \"\"\"\n def updateFromNode(self, node: Node) -> None:\n '''\n\n updateFromNode(self, node)\n\n Update and save the definition to match the contents of a given\n unlocked instance of the asset. Calling this method is the same as\n selecting Save Operator Type on the node\\'s menu.\n\n > def saveUnlockedNodes():\n > \\'\\'\\'Look through all the nodes in the file for unlocked digital asset\n > instances and save and lock them.\\'\\'\\'\n > for node in hou.node(\\\\\"/\\\\\").allSubChildren():\n > if node.type().definition() is None or node.matchesCurrentDefinition():\n > continue\n > \n > node.type().definition().updateFromNode(node)\n > node.matchCurrentDefinition()\n\n '''\n def save(self, file_name: str, template_node: Optional[Node] = None, options: Optional[HDAOptions] = None, black_box: bool = False, create_backup: bool = True) -> None:\n \"\"\"\n\n save(self, file_name, template_node=None, options=None, black_box=False,\n create_backup=True)\n\n Save the definition into an hda file.\n\n\n file_name\n Where to save the definition. To save to the current hda file,\n use the return value from hou.HDADefinition.libraryFilePath.\n\n template_node\n Either None or a hou.OpNode object containing an unlocked\n instance of the digital asset that defines the definition's new\n contents. If None, this method does not update the definition's\n contents.\n\n options\n Either None or a hou.HDAOptions object that specifies extra\n behaviors of the definition. If template_node is not None, the\n compressContents, lockContents, saveSpareParms, and\n makeInitialParmsDefaults values of the hou.HDAOptions object are\n used. Otherwise, only the compressContents value is used.\n\n black_box\n If True, then the asset is saved as a black box asset that\n cannot be unlocked or edited. This parameter only applies if the\n template_node parameter is not None. The contents of the\n template node are compiled and saved into the black box asset.\n\n create_backup\n Create a backup before modifying existing hda files.\n\n See also hou.HDADefinition.updateFromNode for a way to save an\n unlocked node's definition to the current hda file. See also\n hou.HDADefinition.copyToHDAFile.\n\n\n \"\"\"\n def copyToHDAFile(self, file_name: str, new_name: Optional[str] = None, new_menu_name: Optional[str] = None) -> None:\n \"\"\"\n\n copyToHDAFile(self, file_name, new_name=None, new_menu_name=None)\n\n Copy this definition into an hda file.\n\n\n file_name\n The hda file where the definition will be saved. If the file\n does not already exist, it will be created. If it already\n contains a definition for this node type, it will be\n overwritten.\n\n new_name\n The new name of the node type. If None, the definition will be\n saved as the existing node type name. See also\n hou.NodeType.name.\n\n new_menu_name\n The new description of the node type that appears in the tab\n menu. If None, Houdini will use the existing description. Note\n that the node type name must be unique within the hda file, so\n saving the definition with a new description to an hda file\n containing a definition with the old node name will still\n overwrite the existing definition. See also\n hou.NodeType.description.\n\n\n \"\"\"\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Uninstall this definition and delete it from the hda file. Any node\n instances of this asset will warn that they are using an incomplete\n asset definition.\n\n See also hou.hda.uninstallFile.\n\n\n \"\"\"\n def parmTemplateGroup(self) -> ParmTemplateGroup:\n '''\n\n parmTemplateGroup(self) -> hou.ParmTemplateGroup\n\n Return the group of parm templates corresponding to the current\n parameter layout for this node.\n\n You can edit the parameter layout for this node (add or remove spare\n parameters, reorder or hide built-in parameters, etc.) by getting\n the current parameter group, modifying it, and calling\n hou.Node.setParmTemplateGroup with it.\n\n The following example creates a geometry object, adds a My Parms\n folder to it, and adds a My Parm float parameter to it in that\n folder. The parameters are added only to the geometry object\n created; other geometry objects are unaffected.\n\n > >>> node = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\")\n > >>> group = node.parmTemplateGroup()\n > >>> folder = hou.FolderParmTemplate(\\\\\"folder\\\\\", \\\\\"My Parms\\\\\")\n > >>> folder.addParmTemplate(hou.FloatParmTemplate(\\\\\"myparm\\\\\", \\\\\"My Parm\\\\\", 1))\n > >>> group.append(folder)\n > >>> node.setParmTemplateGroup(group)\n\n See hou.ParmTemplateGroup and the setParmTemplateGroup method for\n more information and examples.\n\n\n '''\n def setParmTemplateGroup(self, parm_template_group: ParmTemplateGroup, rename_conflicting_parms: bool = False, create_backup: bool = True) -> None:\n \"\"\"\n\n setParmTemplateGroup(self, parm_template_group,\n rename_conflicting_parms=False)\n\n Change the spare parameters for this node.\n\n\n parm_template_group\n A hou.ParmTemplateGroup object containing the new parameter\n layout.\n\n rename_conflicting_parms\n If True, parameters in the group with the same parm tuple names\n will be automatically renamed. If False and there are parms with\n the same name, this method raises hou.OperationFailed.\n\n Note that each node type has a set of parameters which must exist\n and must be of certain types. If your parm template group does not\n contain the required parameters for the node type the will be added\n at the bottom and will be made invisible. Similarly, if your parm\n template group attempts to modify the type, range, label, or other\n property of a required parameter, all changes to that parameter\n other than visibility settings will be ignored.\n\n This method is preferred over the other parameter-related methods in\n this class (addSpareParmTuple, removeSpareParmTuple,\n replaceSpareParmTuple, addSpareParmFolder, removeSpareParmFolder)\n because it lets you more easily make manipulate parameters.\n\n See hou.HDADefinition.setParmTemplateGroup to change the parameter\n interface of a digital asset.\n\n\n \"\"\"\n def setExtraFileOption(self, name, value: OptionType, type_hint: EnumValue = ...) -> None:\n '''\n\n setExtraFileOption(self, name, value, type_hint =\n hou.fieldType::NoSuchField)\n\n Set an entry in the dictionary of extra file options. See\n hou.HDADefinition.extraFileOptions for more information.\n\n\n name\n The name of the option to set.\n\n value\n An integer, float, string, hou.Vector2, hou.Vector3,\n hou.Vector4, hou.Quaternion, hou.Matrix3, hou.matrix4, or\n sequence of numbers.\n\n type_hint\n Used to determine the exact hou.fieldType desired when the\n specified value type is not enough to unambiguously determine\n it.\n\n The following example function marks an section, such as OnCreated,\n as containing Python code:\n\n > def markSectionAsPython(definition, section_name):\n > definition.setExtraFileOption(section_name + \\\\\"/IsPython\\\\\", True)\n\n '''\n def removeExtraFileOption(self, name: str) -> None:\n \"\"\"\n\n removeExtraFileOption(self, name)\n\n Remove an entry in the dictionary of extra file options. See\n hou.HDADefinition.extraFileOptions for more information.\n\n Raises hou.OperationFailed if there is no entry in the dictionary\n with this name.\n\n\n \"\"\"\n def compileCodeSection(self, source_section: str, destination_section: str) -> None:\n \"\"\"\n\n compileCodeSection(self, source_section, destination_section)\n\n This function is deprecated. Compiled VEX code should no longer be\n stored inside of an HDA.\n\n\n \"\"\"\n def tools(self) -> dict[str, Tool]:\n \"\"\"\n\n tools() -> dict of str to hou.Tool\n\n Returns a dictionary mapping from the internal name of tool defined\n in definition's shelf section to a corresponding hou.Tool object.\n The dictionary does not contain tools that are defined elsewhere.\n\n\n NOTE\n If you only want to get a single tool by its internal name, use\n the hou.shelves.tool function. Using shelves.tool(name) is much\n faster that constructing this dictionary and then pulling a\n single tool out of it.\n\n\n \"\"\"\n def extraFileOptions(self) -> dict[str, OptionType]:\n \"\"\"\n\n extraFileOptions(self) -> dict of str to bool, int, float, str\n\n Return a dictionary containing the extra options attached to\n sections in the asset's definition. For example, event handler\n scripts such as OnCreated are stored as sections inside the asset,\n and extra metadata in this dictionary determines whether Houdini\n runs these scripts as Python as as Hscript.\n\n These is one dictionary for the entire asset, and keys in this\n dictionary are usually of the form section_name/option_name. For\n example, if the OnCreated section is marked as containing Python\n code, this dictionary will contain OnCreated/IsPython set to True.\n\n Note that the contents of this dictionary are saved in the\n ExtraFileOptions section and are encoded in a binary format.\n\n See also hou.HDADefinition.setExtraFileOption and\n hou.HDADefinition.removeExtraFileOption.\n\n\n \"\"\"\n\nclass HDAModule:\n '''\n\n hou.HDAModule\n\n User-defined Python module containing functions, classes, and constants\n that are stored with and accessed from a digital asset.\n\n In Python, a module lets you organize functions, classes, and constants\n into a common namespace. For example, os is a module and os.getcwd is a\n function inside that module, and you access the contents of a module by\n looking up Python attributes on it.\n\n An HDAModule is a Python module that is associated with a particular\n digital asset type. It lets you store a library of Python code in one\n location in your asset, and you can invoke that code from parameters,\n event handlers, and callbacks inside that asset.\n\n The module\\'s source code is stored in the Python Module section of the\n Scripts tab in the Type Properties dialog. For example, suppose the\n digit asset is an object named gear and the Python Module section\n contains the following:\n\n > def position():\n > return (hou.frame() * 1.2, 0.0, 3.2)\n > \n > def onButtonPress():\n > print \\\\\"you pressed the button\\\\\"\n > \n > def onLoaded():\n > print \\\\\"onLoaded section running\\\\\"\n\n Unlike regular Python modules, which you access by name, you access a\n digital asset\\'s Python module by calling hou.NodeType.hdaModule on its\n node type. For example, suppose you created an object-level digital\n asset named gear and put the above code in its Python Module section.\n You could then access the contents of the Python module as follows:\n\n > >>> node_type = hou.nodeType(hou.objNodeTypeCategory(), \\\\\"gear\\\\\")\n > >>> node_type.hdaModule().position()\n > (1.2, 0.0, 3.2)\n > >>> node_type.hdaModule().onButtonPress()\n > you pressed the button\n\n One use for the Python module is drive parameter expressions on nodes\n inside the digital asset. For example, suppose /obj/gear1 is an instance\n of the digital asset and /obj/gear1/geo1 is a node inside the asset. You\n could put the following inside geo1\\'s tx parameter expression:\n\n > hou.node(\\\\\"..\\\\\").type().hdaModule().position()[0]\n\n For convenience, you can also access the module from a node instance of\n the digital asset using hou.OpNode.hdaModule. So, you could simplify the\n above expression to:\n\n > hou.node(\\\\\"..\\\\\").hdaModule().position()[0]\n\n And since you don\\'t need to use the hou. prefix inside expressions, you\n could further simplify it to:\n\n > node(\\\\\"..\\\\\").hdaModule().position()[0]\n\n The following example shows how you might run code in the module from\n the Callback Script field of a button parameter:\n\n > hou.pwd().hdaModule().onButtonPress()\n\n In an event handler script, such as On Loaded, you can use the kwargs\n dict to access the node type:\n\n > kwargs[\\\\\"type\\\\\"].hdaModule().onLoaded()\n\n Note that Houdini creates a local kwargs dict that\\'s accessible from the\n Python Module, too. It contains one entry with the key \\\\\"type\\\\\", to give\n you access to the hou.NodeType defined by the digital asset.\n\n If you find that a digital asset has too much Python code to store in\n one module, it\\'s possible to create submodules. For example, if you want\n to create a submodule named bar, put its source code in a new digital\n asset section (say, \\\\\"bar_PythonModule\\\\\"). Then, from the Python Module\n section, you can write the following:\n\n > import toolutils\n > bar = toolutils.createModuleFromSection(\\\\\"bar\\\\\", kwargs[\\\\\"type\\\\\"], \\\\\"bar_PythonModule\\\\\")\n\n NOTE\n New to Houdini 18.0, the createModuleFromSection function expects\n the code in the HDA section to have Python 3 style print statements.\n\n In general this means that print statements in the HDA section must\n have the arguments enclosed in parentheses.\n\n\n For example\n > print(\\\\\"Hello world!\\\\\")\n instead of\n > print \\\\\"Hello world!\\\\\"\n bar now appears as a submodule of the main module. If, for example, the\n bar_PythonModule section contains:\n\n > def foo():\n > return 3.2\n\n then you could write the following from a parameter on the digital asset\n node:\n\n > pwd().hdaModule().bar.foo()\n\n Note that the Python Module code is stored in a section of the digital\n asset named \\\\\"PythonModule\\\\\". For example, you can get a string containing\n that source code using\n node_type.definition().sections()[\\\\\"PythonModule\\\\\"].contents().\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __getattr__(self, name: str) -> Any: ...\n\nclass HDAOptions:\n '''\n\n hou.HDAOptions\n\n Stores miscellaneous options about a houdini digital asset (HDA).\n\n The contents of this object correspond to some of the checkboxes on the\n Basic tab of the Type Properties dialog. These values are stored in the\n TypePropertiesOptions section of a digital asset definition.\n\n Call hou.HDADefinition.options to get an HDAOptions instance. Note that\n an instance of this class is simply a data structure, and is not\n associated with an particular digital asset instance. In other words,\n changing the values inside this object will not change the digital\n asset. To save these values to the digital asset definition, call\n hou.HDADefinition.setOptions.\n\n > >>> node = hou.node(\\\\\"/obj/my_digital_asset1\\\\\")\n > >>> definition = node.type().definition()\n > >>> print definition.sections()[\\'TypePropertiesOptions\\'].contents()\n > ParmsFromVfl := 0;\n > PrefixDroppedParmName := 1;\n > UseDSParms := 1;\n > ForbidOutsideParms := 1;\n > LockContents := 1;\n > SaveSpareParms := 0; # <-- Currently 0\n > CheckExternal := 1;\n > GzipContents := 1;\n > MakeDefault := 1;\n > PrefixDroppedParmLabel := 1;\n > UnlockOnCreate := 0;\n > \n > >>> options = definition.options()\n > >>> options.saveSpareParms()\n > False\n > >>> options.setSaveSpareParms(True)\n > >>> definition.setOptions(options)\n > >>> print definition.sections()[\\'TypePropertiesOptions\\'].contents()\n > ParmsFromVfl := 0;\n > PrefixDroppedParmName := 1;\n > UseDSParms := 1;\n > ForbidOutsideParms := 1;\n > LockContents := 1;\n > SaveSpareParms := 1; # <-- Now 1\n > CheckExternal := 1;\n > GzipContents := 1;\n > MakeDefault := 1;\n > PrefixDroppedParmLabel := 1;\n > UnlockOnCreate := 0;\n\n '''\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Create an HDAOptions object with default settings.\n\n See the class documentation for more information.\n\n\n \"\"\"\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def checkForExternalLinks(self) -> bool:\n \"\"\"\n\n checkForExternalLinks(self) -> bool\n\n Return whether the Check for External Node References option is set.\n\n If set, this option changes all absolute node references inside the\n digital asset into relative references.\n\n\n \"\"\"\n def setCheckForExternalLinks(self, on: bool) -> None:\n \"\"\"\n\n setCheckForExternalLinks(self, check_for_external_links)\n\n Sets the Check for External Node References option. See\n hou.HDAOptions.checkForExternalLinks for more information.\n\n\n \"\"\"\n def compressContents(self) -> bool:\n \"\"\"\n\n compressContents(self) -> bool\n\n Return whether the Compress Contents option is on.\n\n When this option is set, Houdini compresses the contents of the\n asset definition to reduce the size of the .hda file. Note that this\n option only as effect when the result of hou.HDAOptions.lockContents\n is True.\n\n\n \"\"\"\n def setCompressContents(self, on: bool) -> None:\n \"\"\"\n\n setCompressContents(self, compress_contents)\n\n Sets the Compress Contents option. See\n hou.HDAOptions.compressContents for more information.\n\n\n \"\"\"\n def compressionType(self) -> int: ...\n def setCompressionType(self, type: int) -> None: ...\n def forbidOutsideParms(self) -> bool:\n \"\"\"\n\n forbidOutsideParms(self) -> bool\n\n Return whether the Forbid Linking Parameters from Outside this\n Subnet option is set.\n\n When set, this option does not allow you to drag parameters from\n nodes outside the contents of the digital asset.\n\n\n \"\"\"\n def setForbidOutsideParms(self, on: bool) -> None:\n \"\"\"\n\n setForbidOutsideParms(self, forbid_outside_parms)\n\n Sets the Forbid Linking Parameters from Outside this Subnet option.\n See hou.HDAOptions.forbidOutsideParms for more information.\n\n\n \"\"\"\n def lockContents(self) -> bool:\n \"\"\"\n\n lockContents(self) -> bool\n\n Return whether the Save Contents as Locked option is on.\n\n When this option is not set, Houdini will use a creation script to\n store the contents of the digital asset instead of storing the node\n data. A creation script cannot store extra data like locked SOPs,\n edit SOP information, paint SOP information, etc.\n\n If this option is not set, new instances of the digital asset will\n be locked, so the user can edit the contents. However, you probably\n do not ever want to turn this option off. Instead, if you want to\n lock new instances of the digital asset, see\n hou.HDAOptions.unlockNewInstances.\n\n\n \"\"\"\n def setLockContents(self, on: bool) -> None:\n \"\"\"\n\n setLockContents(self, lock_contents)\n\n Sets the Save Contents as Locked option. See\n hou.HDAOptions.lockContents for more information.\n\n\n \"\"\"\n def makeInitialParmsDefaults(self) -> bool:\n \"\"\"\n\n makeInitialParmsDefaults(self) -> bool\n\n Return whether the Save Defaults as Initial Parameters option is on.\n\n When set, this option uses the default values of the original\n parameters as the initial values for new nodes, instead of their\n current values.\n\n\n \"\"\"\n def setMakeInitialParmsDefaults(self, on: bool) -> None:\n \"\"\"\n\n setMakeInitialParmsDefaults(self, make_initial_parms_defaults)\n\n Sets the Save Defaults as Initial Parameters option. See\n hou.HDAOptions.makeInitialParmsDefaults for more information.\n\n\n \"\"\"\n def parametersFromVexCode(self) -> bool:\n \"\"\"\n\n parametersFromVexCode(self) -> bool\n\n Return whether the Get Properties from VEX Code option is on.\n\n When this option is set, most properties and parameters of the\n operator come from pragma statements in the VEX source code.\n\n\n \"\"\"\n def setParametersFromVexCode(self, on: bool) -> None:\n \"\"\"\n\n setParametersFromVexCode(self, parameters_from_vex_code)\n\n Sets the Get Properties from VEX Code option. See\n hou.HDAOptions.parametersFromVexCode for more information.\n\n\n \"\"\"\n def prefixDroppedParmLabels(self) -> bool: ...\n def setPrefixDroppedParmLabels(self, on: bool) -> None:\n \"\"\"\n\n setPrefixDroppedParmLabels(self, prefix_dropped_parm_labels)\n\n Sets the Prefix Dropped Parameter Labels option. See\n hou.HDAOptions.prefixDroppedParmLabels for more information.\n\n\n \"\"\"\n def prefixDroppedParmNames(self) -> bool:\n \"\"\"\n\n prefixDroppedParmNames(self) -> bool\n\n Return whether the Prefix Dropped Parameter Names option is on.\n\n When this option is set, Houdini will not include a prefix on\n parameter names when you drag and drop parameters into the Existing\n Parameters areas of the Parameters tab of the Type Properties\n dialog.\n\n See also hou.HDAOptions.prefixDroppedParmLabels.\n\n\n \"\"\"\n def setPrefixDroppedParmNames(self, on: bool) -> None:\n \"\"\"\n\n setPrefixDroppedParmNames(self, prefix_dropped_parm_names)\n\n Sets the Prefix Dropped Parameter Names option. See\n hou.HDAOptions.prefixDroppedParmNames for more information.\n\n\n \"\"\"\n def saveInitialParmsAndContents(self) -> bool:\n \"\"\"\n\n saveInitialParmsAndContents(self) -> bool\n\n Return whether the Save Initial Contents and Parameters option is\n on.\n\n When this option is set, Houdini saves any parameter values and node\n contents referenced by the digital asset to be saved as part of the\n asset's definition.\n\n\n \"\"\"\n def setSaveInitialParmsAndContents(self, on: bool) -> None:\n \"\"\"\n\n setSaveInitialParmsAndContents(self, save_initial_parms_and_contents)\n\n Set the Save Initial Contents and Parameters option. See\n hou.HDAOptions.saveInitialParmsAndContents for more information.\n\n\n \"\"\"\n def unlockNewInstances(self) -> bool:\n \"\"\"\n\n unlockNewInstances(self) -> bool\n\n Return whether the Unlock New Nodes on Creation option is set.\n\n When this option is set, Houdini will unlock new instances of the\n digital asset when they are created. Note that this option only has\n effect when the result of hou.HDAOptions.lockContents is True.\n\n\n \"\"\"\n def setUnlockNewInstances(self, on: bool) -> None:\n \"\"\"\n\n setUnlockNewInstances(self, unlock_new_instances)\n\n Sets the Unlock New Nodes on Creation option. See\n hou.HDAOptions.unlockNewInstances for more information.\n\n\n \"\"\"\n def saveSpareParms(self) -> bool:\n \"\"\"\n\n saveSpareParms(self) -> bool\n\n Return the Save Spare Parameters option.\n\n When set, this option will add code into the asset creation script\n to recreate the node's current spare parameters. New node instances\n of the digital asset will contain the same spare parameters as those\n on the representative node.\n\n\n \"\"\"\n def setSaveSpareParms(self, on: bool) -> None:\n \"\"\"\n\n setSaveSpareParms(self, save_spare_parms)\n\n Set the Save Spare Parameters option. See\n hou.HDAOptions.saveSpareParms for more information.\n\n\n \"\"\"\n def saveCachedCode(self) -> bool:\n \"\"\"\n\n saveCachedCode(self) -> bool\n\n Return the Save Cached Code option.\n\n When set, this option will save cached code for applicable\n definitions, such as digital assets defined by VOP networks that\n generate VEX code. With this option on, the compiled code will be\n saved to the HDA section(s) and will be used for shaders, etc,\n without the need to recompile the network. This can save significant\n amounts of time for complex shaders.\n\n\n \"\"\"\n def setSaveCachedCode(self, on: bool) -> None:\n \"\"\"\n\n setSaveCachedCode(self, save_cached_code)\n\n Set the Save Cached Code option. See hou.HDAOptions.saveCachedCode\n for more information.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass HDASection:\n '''\n\n hou.HDASection\n\n Represents a section of data stored along with a digital asset.\n\n A digital asset stores its contents in a number of different pieces of\n data called sections. Each section is named and contains an arbitrarily\n sized piece of data, often textual. Each section is like a file embedded\n inside the definition, and Houdini uses specially named sections to\n store the node contents, list of parameters, etc. You can embed your own\n data into a digital asset by putting it inside a section.\n\n Any parameter in Houdini that references a file can also reference a\n section inside a digital asset. For example, if car is an object-level\n digital asset and the section is named \\\\\"texture.jpg\\\\\", you can reference\n that texture with opdef:/Object/car?texture.jpg. Note that hou.readFile\n also supports this opdef: syntax.\n\n By moving files into digital asset sections, you can build self-\n contained digital assets that can be distributed via a single hda file.\n\n Note that section names may contain \\'/\\'.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def definition(self) -> HDADefinition:\n \"\"\"\n\n definition(self) -> hou.HDADefinition\n\n Return the digital asset definition containing this section.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of this section.\n\n Note that is is not possible to rename a section, but the following\n function will emulate renaming:\n\n > def renameSection(section):\n > '''Rename a section by removing it and creating a new one. Return the new section.'''\n > new_section = section.definition().addSection(new_name, section.contents())\n > section.destroy()\n > return new_section\n\n \"\"\"\n def contents(self, compressionType: EnumValue = ...) -> str:\n '''\n\n contents(self, compressionType=hou.compressionType.NoCompression) -> str\n\n Return a string containing the contents of this section.\n\n You can optionally specify a compression type, hou.compressionType,\n to decompress the contents.\n\n Raises hou.OperationFailed if a compression type is specified and\n the contents are not compressed by that type.\n\n > def saveSectionToFile(section, file_name):\n > \\'\\'\\'Given a section, save it to a file.\\'\\'\\'\n > section_file = file(file_name, \\\\\"w\\\\\")\n > section_file.write(section.contents())\n > section_file.close()\n\n '''\n def binaryContents(self, compressionType: EnumValue = ...) -> bytes:\n '''\n\n binaryContents(self, compressionType=hou.compressionType.NoCompression)\n -> bytes\n\n Only available in Python 3.\n\n Similar to hou.HDASection.contents but return a bytes object\n instead. Ideal for sections containing binary data.\n\n > def saveBinarySectionToFile(section, file_name):\n > \\'\\'\\'Given a section, save it to a file.\\'\\'\\'\n > section_file = file(file_name, \\\\\"wb\\\\\")\n > section_file.write(section.binaryContents())\n > section_file.close()\n\n '''\n def setContents(self, contents: str, compressionType: EnumValue = ...) -> None:\n \"\"\"\n\n setContents(self, contents,\n compressionType=hou.compressionType.NoCompression)\n\n Set the contents of this section to the given string. A section may\n contain binary information, like bgeo files, images, etc.\n\n You can optionally specify a compression type, hou.compressionType,\n to compress the contents. Note that you must specify the same\n compression type when reading the contents back to decompress them.\n\n For Python 3, the contents can be either a str object for plain text\n data or a bytes for binary data.\n\n See hou.HDADefinition.addSection for an example of how to create a\n section from a file on disk.\n\n\n \"\"\"\n def size(self) -> int:\n \"\"\"\n\n size(self) -> int\n\n Return the number of bytes in the contents. This method is a\n shortcut for len(self.contents()).\n\n\n \"\"\"\n def modificationTime(self) -> int:\n '''\n\n modificationTime(self) -> int\n\n Return the time when the section was last modified. This time is\n returned as a POSIX timestamp, such as is returned by time.time().\n\n > >>> hou.nodeType(hou.cop2NodeTypeCategory(), \\\\\"colorwheel\\\\\").definition()\n > \n > >>> definition = hou.nodeType(hou.cop2NodeTypeCategory(), \\\\\"colorwheel\\\\\").definition()\n > >>> definition.sections().keys()\n > [\\'VflCode\\', \\'DialogScript\\', \\'VexCode\\']\n > >>> section = definition.sections()[\\'VflCode\\']\n > >>> section.modificationTime()\n > 1177535169\n > >>> import datetime, time\n > >>> datetime.datetime.fromtimestamp(section.modificationTime())\n > datetime.datetime(2007, 4, 25, 17, 6, 9)\n > >>> time.ctime(section.modificationTime())\n > \\'Wed Apr 25 17:06:09 2007\\'\n\n '''\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Remove this section from the HDA definition. You can also remove a\n section with hou.HDADefinition.removeSection, and this method is\n equivalent to self.definition().removeSection(self.name()).\n\n Only remove sections that you explicitly added. Do not remove the\n special sections that Houdini uses to store the contents of the\n digital asset definition, or Houdini will generate errors or strange\n side effects.\n\n To add a section, use hou.HDADefinition.addSection.\n\n\n \"\"\"\n\nclass HDAViewerHandleModule:\n \"\"\"\n\n hou.HDAViewerHandleModule\n\n User-defined Python module containing the implementation and\n registration code of a python viewer handle stored in a digital asset.\n\n HDAViewerHandleModule is similar to hou.HDAViewerStateModule but\n dedicated for python viewer handles. It is mainly used to access the\n python viewer handle module that is associated with a particular digital\n asset type. You don't normally need HDAViewerHandleModule for using\n python handles though, this object is typically used by Houdini for\n registering the python handles embedded in the digital asset.\n\n The python handle state module's source code is stored in the\n ViewerHandle Module section of the Interactive|Handle Script tab in the\n Type Properties dialog. The source code can be edited with the Handle\n script editor.\n\n See hou.OpNode.hdaViewerHandleModule and\n hou.NodeType.hdaViewerHandleModule for creating HDAViewerHandleModule\n instances.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __getattr__(self, name: str) -> Any: ...\n\nclass HDAViewerStateModule:\n \"\"\"\n\n hou.HDAViewerStateModule\n\n User-defined Python module containing the implementation and\n registration code of a python viewer state stored in a digital asset.\n\n HDAViewerStateModule is similar to hou.HDAModule but dedicated for\n python viewer states. It is mainly used to access the python viewer\n state module that is associated with a particular digital asset type.\n You don't normally need HDAViewerStateModule for using python states\n though, this object is typically used by Houdini for registering the\n python states embedded in the digital asset.\n\n The python viewer state module's source code is stored in the\n ViewerState Module section of the Interactive|State Script tab in the\n Type Properties dialog. The source code can be edited with the State\n script editor.\n\n See hou.OpNode.hdaViewerStateModule and\n hou.NodeType.hdaViewerStateModule for creating HDAViewerStateModule\n instances.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __getattr__(self, name: str) -> Any: ...\n\nclass HelpBrowser(PaneTab):\n \"\"\"\n\n hou.HelpBrowser\n\n Class representing a help browser pane tab. Provides methods for\n controlling the help browser.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def displayHelp(self, node_type: NodeType) -> None:\n \"\"\"\n\n displayHelp(self, node_type)\n\n Loads the help for the specified node type.\n\n Raises HOM_ObjectWasDeleted if the help browser pane tab was\n deleted.\n\n\n \"\"\"\n def displayHelpPath(self, help_path: str) -> None:\n \"\"\"\n\n displayHelpPath(self, help_path)\n\n Loads the help for the specified help path. The path can either be a\n Houdini help URL (i.e. op:Sop/copy, tool:curve) or a raw help path\n (i.e. /nodes/sop/copy, shelf/curve).\n\n\n \"\"\"\n def displayHelpPyPanel(self, interface_name: str) -> None:\n \"\"\"\n\n displayHelpPyPanel(self, interface_name)\n\n Loads the help for the python panel with the specified name.\n\n Raises HOM_Error if the interface name is invalid.\n\n\n \"\"\"\n def homePage(self) -> str:\n \"\"\"\n\n homePage(self) -> str\n\n Returns the home page URL of this help browser.\n\n Raises HOM_ObjectWasDeleted if the help browser pane tab was\n deleted.\n\n\n \"\"\"\n def setHomePage(self, home_page: str) -> None:\n \"\"\"\n\n setHomePage(self, home_page)\n\n Sets the home page for this help browser to the specified URL.\n\n Raises HOM_ObjectWasDeleted if the help browser pane tab was\n deleted, and raises HOM_Error if home_page is not given.\n\n\n \"\"\"\n def url(self) -> str:\n \"\"\"\n\n url(self) -> str\n\n Return the current URL of this help browser.\n\n Raises HOM_ObjectWasDeleted if the help browser pane tab was\n deleted.\n\n\n \"\"\"\n def setUrl(self, url: str) -> None:\n \"\"\"\n\n setUrl(self, url)\n\n Loads the specified URL.\n\n Raises HOM_ObjectWasDeleted if the help browser pane tab was\n deleted, and raises HOM_Error if url is not given.\n\n\n \"\"\"\n def showUI(self, show: bool) -> None:\n \"\"\"\n\n showUI(self, show)\n\n Shows or hides the help browser's navigation controls.\n\n Raises HOM_ObjectWasDeleted if the help browser pane tab was\n deleted.\n\n\n \"\"\"\n\nclass hipFile:\n \"\"\"\n\n hou.hipFile\n\n Functions for working with the current scene (.hip) file.\n\n\n NOTE\n Houdini inherits the current directory (sometimes called the current\n working directory) from the environment where you run it. Some\n functions return or accept paths relative to the current directory.\n You can check Houdini's current directory by calling os.getcwd(),\n and change it by calling os.chdir.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def save(file_name: Optional[str] = None, save_to_recent_files: bool = True) -> None:\n \"\"\"\n\n save(file_name=None, save_to_recent_files=True)\n\n Saves the current scene to a .hip file.\n\n\n file_name\n If this is a string, saves the current scene to a file at this\n path, like File > Save As. The path can be absolute or relative\n to the current directory.\n\n If this is None, saves the scene to its current path\n (hou.hipFile.path), like File > Save.\n\n If intermediate directories in the path do not exist, Houdini\n will create them.\n\n save_to_recent_files\n In a graphical session, whether to add this file to the list of\n recent files in the File > Open Recent Files menu. The default\n is True.\n\n In a non-graphical session (hython), the function always acts\n like save_to_recent_files is off.\n\n Raises hou.OperationFailed if Houdini can't create intermediate\n directories or write to the specified file (for example, because of\n filesystem permissions).\n\n Also raises hou.OperationFailed if you call this while Houdini is\n shutting down (see hou.hipFile.isShuttingDown) or if Houdini is\n already loading or saving the scene file (see\n hou.hipFile.isLoadingHipFile).\n\n\n \"\"\"\n @staticmethod\n def saveAndIncrementFileName() -> None:\n \"\"\"\n\n saveAndIncrementFileName()\n\n Saves the scene to its current path (same as File > Save), but\n increments a number at the end of the filename.\n\n Raises hou.OperationFailed if Houdini can't create intermediate\n directories or write to the specified file (for example, because of\n filesystem permissions).\n\n Also raises hou.OperationFailed if you call this while Houdini is\n shutting down (see hou.hipFile.isShuttingDown) or if Houdini is\n already loading or saving the scene file (see\n hou.hipFile.isLoadingHipFile).\n\n\n \"\"\"\n @staticmethod\n def saveAndBackup() -> str:\n \"\"\"\n\n saveAndBackup() -> str\n\n Saves the current scene but first creates a backup of the previous\n saved state to a backup file in $HOUDINI_BACKUP_DIR with _bak and an\n increasing number added before the .hip extension. If\n $HOUDINI_BACKUP_DIR is not set, then this method creates the backup\n file in a backup directory in the same directory as the scene file.\n\n Returns the absolute path of the backup file.\n\n Raises hou.OperationFailed if Houdini can't create intermediate\n directories or write to the specified file (for example, because of\n filesystem permissions).\n\n Also raises hou.OperationFailed if you call this while Houdini is\n shutting down (see hou.hipFile.isShuttingDown) or if Houdini is\n already loading or saving the scene file (see\n hou.hipFile.isLoadingHipFile).\n\n\n \"\"\"\n @staticmethod\n def saveAsBackup() -> str:\n \"\"\"\n\n saveAsBackup() -> str\n\n Saves the current scene to a new file in $HOUDINI_BACKUP_DIR with\n _bak and an increasing number added before the .hip extension. If\n $HOUDINI_BACKUP_DIR is not set, this saves the file to a backup\n directory in the same directory as the scene file.\n\n Returns the absolute path of the backup file.\n\n Raises hou.OperationFailed if Houdini can't create intermediate\n directories or write to the specified file (for example, because of\n filesystem permissions).\n\n Also raises hou.OperationFailed if you call this while Houdini is\n shutting down (see hou.hipFile.isShuttingDown) or if Houdini is\n already loading or saving the scene file (see\n hou.hipFile.isLoadingHipFile).\n\n\n \"\"\"\n @staticmethod\n def basename() -> str:\n \"\"\"\n\n basename() -> str\n\n Return the filename portion of the current scene's path (including\n the .hip extension).\n\n\n \"\"\"\n @staticmethod\n def name() -> str:\n \"\"\"\n\n name() -> str\n\n Return the path of the current hip file relative to the current\n directory. Remember that a file may not exist at this path if the\n current scene hasn't been saved yet.\n\n This function returns a relative path from the current directory.\n For example, if the current directory is /home/alyah/ and the\n current scene file is /home/alyah/Houdini/Projects/city.hip, this\n would return Houdini/Projects/city.hip. If the current scene file,\n this is the same as calling hou.hipFile.basename().\n\n If you want an absolute path to the current scene file, use\n Hom:hou.hipFile#path instead.\n\n\n \"\"\"\n @staticmethod\n def path() -> str:\n \"\"\"\n\n path() -> str\n\n Return the absolute file path of the current scene file. Remember\n that a file may not exist at this path if the current scene hasn't\n been saved yet.\n\n\n \"\"\"\n @staticmethod\n def setName(file_name: str) -> None:\n \"\"\"\n\n setName(file_name)\n\n Sets the in-memory path of the current scene file. This is the path\n Houdini will save to if the user chooses File > Save or you call\n hou.hipFile.save without a file path.\n\n\n file_name\n The path to use. This can be an absolute path or relative to the\n current directory.\n\n This function does not save the scene, it only changes the path\n Houdini thinks the scene should be saved at. To actually save the\n scene to a new path, use hou.hipFile.save.\n\n\n \"\"\"\n @staticmethod\n def saveMode() -> EnumValue:\n \"\"\"\n\n saveMode(self) -> hou.saveMode\n\n Return the save mode of the current scene, either\n hou.saveMode.Binary or hou.saveMode.Text.\n\n\n \"\"\"\n @staticmethod\n def setSaveMode(savemode: EnumValue) -> None:\n \"\"\"\n\n setSaveMode(self, save_mode)\n\n Set the save mode of the current scene to either hou.saveMode.Binary\n or hou.saveMode.Text.\n\n\n \"\"\"\n @staticmethod\n def clear(suppress_save_prompt: bool = False) -> bool:\n \"\"\"\n\n clear(suppress_save_prompt=False) -> bool\n\n Clears the contents of the current scene file, starting a new\n unsaved file. Returns True if the contents were cleared and False\n otherwise. The contents will not be cleared, if, in a graphic\n session, the user chooses to cancel when prompted to save the\n current file.\n\n\n suppress_save_prompt\n Normally, in a graphical session, this function acts the same as\n if the user had chosen File > New, and prompts to save the\n current file if it has unsaved changes. You can force Houdini to\n clear without prompting by passing suppress_save_prompt=True.\n\n In a non-graphical session (hython), the function always acts\n like suppress_save_prompt is on.\n\n\n \"\"\"\n @staticmethod\n def load(file_name: str, suppress_save_prompt: bool = False, ignore_load_warnings: bool = False) -> None:\n \"\"\"\n\n load(file_name, suppress_save_prompt=False, ignore_load_warnings=False)\n\n Loads a new scene (.hip) file.\n\n Raises hou.OperationFailed if Houdini cannot read the file.\n\n Raises hou.LoadWarning if loading the new file triggers warnings\n (such as missing assets). You can prevent these exceptions by\n passing ignore_load_warnings=True.\n\n\n file_name\n The path to the scene file to load.\n\n suppress_save_prompt\n Normally, in a graphical session, this function acts the same as\n if the user had chosen File > Open, and prompts to save the\n current file if it has unsaved changes. You can force Houdini to\n load the new file without prompting by passing\n suppress_save_prompt=True.\n\n In a non-graphical session (hython), the function always acts\n like suppress_save_prompt is on.\n\n ignore_load_warnings\n Prevents Houdini from raising hou.LoadWarning exceptions if\n loading the new file triggers warnings (such as missing assets).\n\n Raises hou.OperationFailed if you call this while Houdini is cooking\n a node, shutting down (see hou.hipFile.isShuttingDown) or if Houdini\n is saving the scene file. If this method is called when loading a\n hip file (from 456.py), the operation will succeed, but after\n merging the hip file the 456.py script will not be run again.\n\n\n \"\"\"\n @staticmethod\n def merge(file_name: str, node_pattern: str = ..., overwrite_on_conflict: bool = ..., ignore_load_warnings: bool = ...) -> None:\n '''\n\n merge(file_name, node_pattern=\\\\\"*\\\\\", overwrite_on_conflict=False,\n ignore_load_warnings=False)\n\n Imports the contents of the file at path file_name into the current\n scene. (This does not save the current scene file.)\n\n Raises hou.LoadWarning if loading the new file triggers warnings\n (such as missing assets). You can prevent these exceptions by\n passing ignore_load_warnings=True.\n\n\n node_pattern\n Only merge in nodes matching this pattern.\n\n overwrite_on_conflict\n What to do if merged-in nodes have the same path/name as\n existing nodes. If this is True, merged in nodes replace\n existing nodes. If this is False (the default), merged in nodes\n are renamed if the conflict with existing nodes.\n\n See hou.hipFile.collisionNodesIfMerged to check for conflicts\n before merging.\n\n ignore_load_warnings\n Prevents Houdini from raising hou.LoadWarning exceptions if\n loading the new file triggers warnings (such as missing assets).\n\n Raises hou.OperationFailed if the file to merge doesn\\'t exist or\n Houdini cannot read the file.\n\n Also raises hou.OperationFailed if you call this while Houdini is\n cooking a node, shutting down (see hou.hipFile.isShuttingDown) or if\n Houdini is saving the scene file. If this method is called when\n loading a hip file (from 456.py), the operation will succeed, but\n after merging the hip file the 456.py script will not be run again.\n\n\n '''\n @staticmethod\n def collisionNodesIfMerged(file_name: str, node_pattern: str = ...) -> Tuple[OpNode,...]:\n '''\n\n collisionNodesIfMerged(file_name, node_pattern=\\\\\"*\\\\\") -> tuple of\n hou.OpNode\n\n Returns a sequence of hou.OpNode objects representing the nodes that\n would have conflicts if you tried to merge the given file with\n hou.hipFile.merge.\n\n\n node_pattern\n Only check nodes matching this pattern.\n\n Raises hou.OperationFailed if the file to merge doesn\\'t exist or\n Houdini cannot read the file.\n\n Also raises hou.OperationFailed if you call this while Houdini is\n shutting down (see hou.hipFile.isShuttingDown) or if Houdini is\n already loading or saving the scene file (see\n hou.hipFile.isLoadingHipFile).\n\n\n '''\n @staticmethod\n def isLoadingHipFile() -> bool:\n \"\"\"\n\n isLoadingHipFile() -> bool\n\n Returns True if Houdini is currently loading a scene file.\n\n\n \"\"\"\n @staticmethod\n def isShuttingDown() -> bool:\n \"\"\"\n\n isShuttingDown() -> bool\n\n Returns True if Houdini is currently exiting.\n\n\n \"\"\"\n @staticmethod\n def isNewFile() -> bool:\n \"\"\"\n\n isNewFile() -> bool\n\n Returns whether the current Houdini file is a new file or is a\n previously loaded file.\n\n This function only works accurately in a graphical session. In a\n non-graphical session (hython) it will always return True if the\n filename matches the default filename.\n\n\n \"\"\"\n @staticmethod\n def hasUnsavedChanges() -> bool:\n \"\"\"\n\n hasUnsavedChanges() -> bool\n\n Returns whether the current Houdini session has been modified since\n it was last saved. (This is sometimes referred to as the current\n file being dirty.)\n\n This function only works in a graphical session. In a non-graphical\n session (hython) it will always return True.\n\n\n \"\"\"\n @staticmethod\n def groupColorTable() -> dict[str, Color]:\n \"\"\"\n\n groupColorTable() -> dict of str to hou.Color\n\n Returns a dictionary of color overrides for the viewport group list.\n The viewport group list automatically assigns colors to groups based\n on a hash of the group name. The group color table is a dictionary\n of overrides to these default color assignments. This allows\n particular important groups to be assigned distinctive colors. The\n group color table is saved with the hip file. The color table can be\n modified with hou.hipFile.setGroupColorTable.\n\n\n \"\"\"\n @staticmethod\n def setGroupColorTable(color_table: dict[str, Color]) -> None:\n \"\"\"\n\n setGroupColorTable(color_table)\n\n Sets a dictionary of color overrides for the viewport group list.\n The viewport group list automatically assigns colors to groups based\n on a hash of the group name. The group color table is a dictionary\n of overrides to these default color assignments. This allows\n particular important groups to be assigned distinctive colors. The\n group color table is saved with the hip file. The current color\n table can be queried with hou.hipFile.groupColorTable.\n\n The supplied color_table must be a dict of str to hou.Color. The\n following example will cause groups names 'special_group' to appear\n with a red overlay:\n\n > color_table = { 'special_group' : hou.Color([1,0,0]) }\n > hou.hipFile.setGroupColorTable(color_table)\n\n \"\"\"\n @staticmethod\n def importFBX(file_name: str, suppress_save_prompt: bool = ..., merge_into_scene: bool = ..., import_cameras: bool = ..., import_joints_and_skin: bool = ..., import_geometry: bool = ..., import_lights: bool = ..., import_animation: bool = ..., import_materials: bool = ..., resample_animation: bool = ..., resample_interval: float = ..., override_framerate: bool = ..., framerate: int = ..., hide_joints_attached_to_skin: bool = ..., convert_joints_to_zyx_rotation_order: bool = ..., material_mode: EnumValue = ..., compatibility_mode: EnumValue = ..., single_precision_vertex_caches: bool = ..., triangulate_nurbs: bool = ..., triangulate_patches: bool = ..., import_global_ambient_light: bool = ..., import_blend_deformers_as_blend_sops: bool = ..., segment_scale_already_baked_in: bool = ..., convert_file_paths_to_relative: bool = ..., unlock_geometry: bool = ..., unlock_deformations: bool = ..., import_nulls_as_subnets: bool = ..., import_into_object_subnet: bool = ..., convert_into_y_up_coordinate_system: bool = ..., create_sibling_bones: bool = ..., override_scene_frame_range: bool = ..., convert_units: bool = ...) -> Tuple[ObjNode,...]:\n \"\"\"\n\n importFBX(file_name, suppress_save_prompt=False, merge_into_scene=True,\n import_cameras=True, import_joints_and_skin=True, import_geometry=True,\n import_lights=True, import_animation=True, import_materials=True,\n resample_animation=False, resample_interval=1.0,\n override_framerate=False,framerate=-1,\n hide_joints_attached_to_skin=True,\n convert_joints_to_zyx_rotation_order=False,\n material_mode=hou.fbxMaterialMode.FBXShaderNodes,\n compatibility_mode=hou.fbxCompatibilityMode.Maya,\n single_precision_vertex_caches=False, triangulate_nurbs=False,\n triangulate_patches=False, import_global_ambient_light=False,\n import_blend_deformers_as_blend_sops=False,\n segment_scale_already_baked_in=True,\n convert_file_paths_to_relative=True, unlock_geometry=False,\n unlock_deformations=False, import_nulls_as_subnets=False,\n import_into_object_subnet=True,\n convert_into_y_up_coordinate_system=False, create_sibling_bones=True,\n override_scene_frame_range=False, convert_units=False) -> (hou.ObjNode,\n str)\n\n Imports the contents of an FBX file into the scene, like when the\n user chooses File > Import > FBX. Returns a tuple of the parent\n Subnetwork Object node containing the FBX nodes (see\n import_into_object_subnet option) and a string containing any\n generated load messages.\n\n Important: see the help for the FBX import dialog for information on\n the various options.\n\n\n import_into_object_subnet\n When this is True (the default), Houdini creates a new\n Subnetwork node at the object level and puts imported FBX nodes\n inside the subnet. If you pass import_into_object_subnet=False,\n Houdini creates the FBX nodes directly at the object level (and\n the first item in the returned tuple will be the /obj network\n node).\n\n Raises hou.OperationFailed if the file to merge doesn't exist or\n Houdini cannot read the file.\n\n Also raises hou.OperationFailed if you call this while Houdini is\n shutting down (see hou.hipFile.isShuttingDown) or if Houdini is\n already loading or saving the scene file (see\n hou.hipFile.isLoadingHipFile).\n\n\n \"\"\"\n @staticmethod\n def clearEventCallbacks() -> None:\n \"\"\"\n\n clearEventCallbacks()\n\n This method is deprecated in favor of\n hou.hipFile.removeEventCallback.\n\n Removes all Python callbacks that have been registered with\n hou.hipFile.addEventCallback.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n @staticmethod\n def addEventCallback(callback: Callable[[EnumValue], None]) -> None: ...\n @staticmethod\n def removeEventCallback(callback: Callable[[EnumValue], None]) -> None: ...\n @staticmethod\n def eventCallbacks() -> Tuple[Callable[[EnumValue], None], ...]: ...\n\nclass hmath:\n \"\"\"\n\n hou.hmath\n\n Houdini and 3D related math functions.\n\n See hou.Geometry.transformPrims and hou.Matrix4.explode for matrix\n transform examples.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def identityTransform() -> Matrix4:\n \"\"\"\n\n identityTransform() -> hou.Matrix4\n\n Returns the identity matrix. This is the same as hou.Matrix4(1) but\n may make your code more understandable.\n\n > >>> hou.hmath.identityTransform()\n > \n\n See hou.Matrix4.\n\n\n \"\"\"\n @staticmethod\n def buildTranslate(tx: float|Vector3, ty: float = ..., tz: float = ...) -> Matrix4:\n \"\"\"\n\n buildTranslate(tx, ty, tz) -> hou.Matrix4\n\n Returns a transformation matrix containing only a translation. You\n can build more complex transformations by multiplying this with\n another transform matrix.\n\n You can supply three float values for x, y, and z, or a sequence of\n three floats, or a hou.Vector3.\n\n > forward_z = hou.hmath.buildTranslate(0, 0, 1)\n > forward_x = hou.hmath.buildTranslate(hou.Vector3(1, 0, 0))\n\n \"\"\"\n @staticmethod\n def buildScale(sx: float|Vector3, sy: float = ..., sz: float = ...) -> Matrix4:\n \"\"\"\n\n buildScale(sx, sy, sz) -> hou.Matrix4\n\n Returns a transformation matrix containing only a scale. You can\n build more complex transformations by multiplying this with another\n transform matrix.\n\n You can supply three float values for x, y, and z, or a sequence of\n three floats, or a hou.Vector3. To apply a uniform scale, use the\n same value for x, y, and z.\n\n > stretch = hou.hmath.buildScale(2, 1, 1)\n > uniform = hou.hmath.buildScale(hou.Vector3(2, 2, 2))\n\n See hou.Geometry.createNURBSSurface for an example.\n\n\n \"\"\"\n @staticmethod\n def buildShear(shearx: float|Vector3, sheary: float = ..., shearz: float = ...) -> Matrix4:\n \"\"\"\n\n buildShear(shearx, sheary, shearz) -> hou.Matrix4\n\n Returns a transformation matrix containing only a shear. You can\n build more complex transformations by multiplying this with another\n transform matrix.\n\n You can supply three float values for x, y, and z, or a sequence of\n three floats, or a hou.Vector3.\n\n See Wikipedia's shear matrix page for more information.\n\n\n \"\"\"\n @staticmethod\n def buildRotate(rx: float|Vector3, ry: float = ..., rz: float = ..., order: str = ...) -> Matrix4:\n '''\n\n buildRotate(rx, ry, rz, order=\\\\\"xyz\\\\\") -> hou.Matrix4\n\n Returns a transformation matrix containing only a rotation, given\n Euler angles in degrees. You can build more complex transformations\n by multiplying this with another transform matrix.\n\n You can supply three float values for x, y, and z, or a sequence of\n three floats, or a hou.Vector3.\n\n > xform1 = hou.hmath.buildRotate(45, 45, 0)\n > xform2 = hou.hmath.buildRotate(hou.Vector3(90, 0, 90))\n\n order\n A string containing a permutation of the letters x, y, and z\n that controls the order of rotations.\n\n See Wikipedia\\'s Euler angles page for more information.\n\n\n '''\n @staticmethod\n def buildRotateAboutAxis(axis: Sequence[float], angle_in_deg: float) -> Matrix4:\n \"\"\"\n\n buildRotateAboutAxis(axis, angle_in_deg) -> hou.Matrix4\n\n Returns a transformation matrix containing only a rotation computed\n from an axis and a rotation amount. You can build more complex\n transformations by multiplying this with another transform matrix.\n\n\n axis\n A hou.Vector3 normal defining an axis to rotate around. For\n example, hou.Vector3(0, 1, 1) would rotate around a diagonal\n pointed along positive Y and Z.\n\n angle_in_deg\n Number of degrees of rotation around the axis to store in the\n matrix.\n\n > turn_45_around_yz = hou.hmath.buildRotateAboutAxis(hou.Vector3(0, 1, 1), 45)\n\n If you want to convert Euler angles into a corresponding axis and\n angle, you can use the following code:\n\n > def extractAxisAndAngleFromRotateMatrix(m):\n > '''\n > Given a matrix, return an (Vector3, float) tuple containing the\n > axis and angle. See Wikipedia's rotation representation page for\n > more details.\n > '''\n > \n > import math\n > \n > acos_input = (m.at(0, 0) + m.at(1, 1) + m.at(2, 2) - 1.0) * 0.5\n > if acos_input < -1.0 or acos_input > 1.0:\n > return None\n > \n > angle = math.acos(acos_input)\n > if angle >= -1e-6 and angle <= 1e-6:\n > # There is no rotation. Choose an arbitrary axis and a rotation of 0.\n > return hou.Vector3(1, 0, 0), 0.0\n > \n > inv_sin = 1.0 / (2.0 * math.sin(angle))\n > axis = hou.Vector3(\n > (m.at(1, 2) - m.at(2, 1)) * inv_sin,\n > (m.at(2, 0) - m.at(0, 2)) * inv_sin,\n > (m.at(0, 1) - m.at(1, 0)) * inv_sin)\n > return axis, hou.hmath.radToDeg(angle)\n > \n > def eulerToAxisAndAngle(angles):\n > return extractAxisAndAngleFromRotateMatrix(hou.hmath.buildRotate(angles))\n\n See Wikipedia's axis angle page and rotation representation page for\n more information.\n\n\n \"\"\"\n @staticmethod\n def buildRotateZToAxis(axis: Sequence[float]) -> Matrix4:\n \"\"\"\n\n buildRotateZToAxis(axis) -> hou.Matrix4\n\n Returns a transformation matrix rotating the z-axis onto the given\n axis. You can build more complex transformations by multiplying this\n with another transform matrix.\n\n\n axis\n A hou.Vector3 defining an axis to rotate the z-axis to.\n\n > rotate_z_to_x = hou.hmath.buildRotateZToAxis(hou.Vector3(1, 0, 0))\n\n The rotation picked is the shortest rotation. If the goal vector is\n pointed the opposite direction of the z-axis, an arbitrary but\n consistent rotation that maps to the negative z-axis will be picked.\n\n\n \"\"\"\n @staticmethod\n def buildRotateLookAt(_from: Vector3, to: Vector3, up: Vector3) -> Matrix4:\n \"\"\"\n\n buildRotateLookAt(__from, to, up) -> hou.Matrix4\n\n Returns a rotation matrix to orient negative z-axis point along the\n vector (_from-to). up is an up vector that defines the roll and\n orienting the positive y-axis.\n\n\n _from\n A hou.Vector3 defining the origin position of the lookat.\n\n to\n A hou.Vector3 defining the target position of the lookat.\n\n up\n A hou.Vector3 defining the up vector.\n\n > p0 = hou.Vector3(1, 2, 3)\n > p1 = hou.Vector3(1, 1, 0)\n > up = hou.Vector3(0, 1, 0)\n > lookat_m = hou.hmath.buildRotateLookAt(p0, p1, up)\n > \n > # You can change which axis is the target by using another lookat\n > # and multiplying by the inverse matrix.\n > lookaxis = hou.Vector3(1, 0, 0)\n > upaxis = hou.Vector3(0, 0, 1)\n > fix_m = hou.hmath.buildRotateLookAt(hou.Vector3(0,0,0), lookaxis, upaxis)\n > lookat_m1 = fix_m.inverted() * lookat_m\n\n \"\"\"\n @staticmethod\n def buildTransform(values_dict: Mapping[str, Vector3|Sequence[float]], transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ..., rotate_order: Literal['xyz','xzy','yxz','yzx','zxy','zyx'] = ...) -> Matrix4:\n '''\n\n buildTransform(values_dict, transform_order=\\\\\"srt\\\\\", rotate_order=\\\\\"xyz\\\\\")\n -> hou.Matrix4\n\n Takes a dictionary containing mapping strings to vectors (such as\n produced by hou.Matrix4.explode), and returns a hou.Matrix4\n transformation. You can use this to explode a matrix, modify one or\n a few components, and then recompose into a matrix, or to generate a\n matrix from scratch from a few components.\n\n The dictionary can contain any of the following keys: translate,\n rotate, scale, shear, pivot, pivot_rotate. The values can be\n hou.Vector3 objects or 3-tuples of floats.\n\n\n transform_order\n A string containing a permutation of the letters s, r, and t.\n The rotate, scale, and translate results are dependent on the\n order in which you perform those operations, and this string\n specifies that order.\n\n rotate_order\n A string containing a permutation of the letters x, y, and z\n that determines the order in which rotations are performed about\n the coordinate axes. This does not apply to the pivot_rotate\n\n angles, which are always applied in \\\\\"xyz\\\\\" order.\n\n This function could be re-implemented like this:\n\n > def buildTransform(values_dict, transform_order=\\\\\"srt\\\\\", rotate_order=\\\\\"xyz\\\\\"):\n > # Take the return value from explode, along with the transform and\n > # rotate order, and rebuild the original matrix.\n > result = hou.hmath.identityTransform()\n > for operation_type in transform_order:\n > if operation_type == \\\\\"t\\\\\":\n > result *= hou.hmath.buildTranslate(values_dict[\\\\\"translate\\\\\"])\n > elif operation_type == \\\\\"s\\\\\":\n > result *= hou.hmath.buildScale(values_dict[\\\\\"scale\\\\\"])\n > if \\\\\"shear\\\\\" in values_dict:\n > result *= hou.hmath.buildShear(values_dict[\\\\\"shear\\\\\"])\n > elif operation_type == \\\\\"r\\\\\":\n > result *= hou.hmath.buildRotate(values_dict[\\\\\"rotate\\\\\"], rotate_order)\n > else:\n > raise ValueError(\\\\\"Invalid transform order\\\\\")\n > return result\n\n '''\n @staticmethod\n def degToRad(degrees: float) -> float:\n \"\"\"\n\n degToRad(degrees) -> float\n\n Given a value in degrees, return the corresponding value in radians.\n\n This function is equivalent to degrees * math.pi / 180.0.\n\n\n \"\"\"\n @staticmethod\n def radToDeg(radians: float) -> float:\n \"\"\"\n\n radToDeg(radians) -> double\n\n Given a value in radians, return the corresponding value in degrees.\n\n This function is equivalent to radians * 180.0 / math.pi.\n\n\n \"\"\"\n @staticmethod\n def noise1d(pos: Sequence[float]) -> float:\n \"\"\"\n\n noise1d(self, pos) -> float\n\n Given a sequence of 1 to 4 floats representing a position in\n N-dimensional space, return a single float corresponding to 1\n dimensional noise.\n\n This function matches the output of the noise() function from VEX.\n\n\n \"\"\"\n @staticmethod\n def noise3d(pos: Sequence[float]) -> Vector3:\n \"\"\"\n\n noise3d(self, pos) -> hou.Vector3\n\n Given a sequence of 1 to 4 floats representing a position in\n N-dimensional space, return a hou.Vector3 object representing the\n vector noise at the given position.\n\n This function matches the output of the noise() function from VEX.\n\n\n \"\"\"\n @staticmethod\n def fit(value: float, oldmin: float, oldmax: float, newmin: float, newmax: float) -> float:\n \"\"\"\n\n fit(value, old_min, old_max, new_min, new_max) -> float\n\n Returns a number between new_min and new_max that is relative to the\n value between the range old_min and old_max. If the value is outside\n the old_min to old_max range, it will be clamped to the new range.\n\n > >>> hou.hmath.fit(3, 1, 4, 5, 20)\n > 15.0\n\n \"\"\"\n @staticmethod\n def fit01(value: float, newmin: float, newmax: float) -> float:\n \"\"\"\n\n fit01(value, new_min, new_max) -> float\n\n Returns a number between new_min and new_max that is relative to the\n value between the range 0 and 1. If the value is outside the 0 to 1\n range, it will be clamped to the new range.\n\n This function is a shortcut for hou.hmath.fit(value, 0.0, 1.0,\n new_min, new_max).\n\n\n \"\"\"\n @staticmethod\n def fit10(value: float, newmin: float, newmax: float) -> float:\n \"\"\"\n\n fit10(value, new_min, new_max) -> float\n\n Returns a number between new_min and new_max that is relative to the\n value between the range 1 to 0. If the value is outside the 1 to 0\n range, it will be clamped to the new range.\n\n This function is a shortcut for hou.hmath.fit(value, 1.0, 0.0,\n new_min, new_max).\n\n\n \"\"\"\n @staticmethod\n def fit11(value: float, newmin: float, newmax: float) -> float:\n \"\"\"\n\n fit11(value, new_min, new_max) -> float\n\n Returns a number between new_min and new_max that is relative to the\n value between the range -1 to 1. If the value is outside the -1 to 1\n range, it will be clamped to the new range.\n\n This function is a shortcut for hou.hmath.fit(value, -1.0, 1.0,\n new_min, new_max).\n\n\n \"\"\"\n @staticmethod\n def sign(value: float) -> float:\n \"\"\"\n\n sign(value) -> int\n\n Returns 1.0 if value is positive, -1.0 if negative and 0.0 if value\n is zero.\n\n Note that you can achieve the same effect with Python's built-in cmp\n function: float(cmp(value, 0)).\n\n\n \"\"\"\n @staticmethod\n def clamp(value: float, min: float, max: float) -> float:\n \"\"\"\n\n clamp(value, min, max) -> float\n\n Returns the value clamped to the range min to max. See also\n hou.hmath.wrap. This function is useful in expressions to prevent a\n value from going outside the specified range.\n\n\n \"\"\"\n @staticmethod\n def smooth(value: float, min: float, max: float) -> float:\n '''\n\n smooth(value, min, max) -> float\n\n Takes a value and range and returns a smooth interpolation between 0\n and 1.\n\n When value is less than min, the return value is 0. If value is\n greater than max, the return value is 1.\n\n > >>> hou.hmath.smooth(5, 0, 20)\n > 0.15625\n > >>> hou.hmath.smooth(10, 0, 20)\n > 0.5\n > >>> hou.hmath.smooth(15, 0, 20)\n > 0.84375\n > # Visualize the output of this function by positioning geometry objects at various locations.\n > def createSpheres(num_spheres=40):\n > for i in range(num_spheres):\n > sphere = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\").createNode(\\\\\"sphere\\\\\")\n > sphere.parmTuple(\\\\\"rad\\\\\").set((0.1, 0.1, 0.1))\n > sphere.setDisplayFlag(True)\n > \n > # Given a value between 0 and 5, we\\'ll call smooth with a range\n > # of 0 to 3, and the resulting y value will be between 0 and 1.\n > x = 5.0 * i / num_spheres\n > y = hou.hmath.smooth(x, 0, 3)\n > sphere.parent().setParmTransform(hou.hmath.buildTranslate((x, y, 0)))\n\n '''\n @staticmethod\n def wrap(value: float, min: float, max: float) -> float:\n \"\"\"\n\n wrap(value, min, max)\n\n Similar to the hou.hmath.clamp function in that the resulting value\n will always fall between the specified minimum and maximum value.\n However, it will create a saw-tooth wave for continuously increasing\n or decreasing parameter values.\n\n\n \"\"\"\n @staticmethod\n def rand(seed: float) -> float:\n \"\"\"\n\n rand(seed) -> float\n\n Returns a pseudo-random number from 0 to 1. Using the same seed will\n always give the same result.\n\n\n \"\"\"\n @staticmethod\n def orient2d(pa: Sequence[float], pb: Sequence[float], point: Sequence[float]) -> float:\n \"\"\"\n\n orient2d(pa, pb, point) -> float\n\n Performs an adaptive exact sidedness test of the 2d point against\n the line defined by pa and pb.\n\n See http://www.cs.cmu.edu/~quake/robust.html for details of the\n implementation.\n\n\n \"\"\"\n @staticmethod\n def orient3d(pa: Sequence[float], pb: Sequence[float], pc: Sequence[float], point: Sequence[float]) -> float:\n \"\"\"\n\n orient3d(pa, pb, pc, point) -> float\n\n Performs an adaptive exact sidedness test of the 3d point against\n the plane defined by pa, pb, and pc.\n\n See http://www.cs.cmu.edu/~quake/robust.html for details of the\n implementation.\n\n\n \"\"\"\n @staticmethod\n def inCircle(pa: Sequence[float], pb: Sequence[float], pc: Sequence[float], point: Sequence[float]) -> float:\n \"\"\"\n\n inCircle(pa, pb, pc, point) -> float\n\n Performs an adaptive exact inside test of the 2d point against the\n circle defined by pa, pb, and pc. pa, pb, and pc must be in counter-\n clockwise order to get a positive value for interior points.\n\n See http://www.cs.cmu.edu/~quake/robust.html for details of the\n implementation.\n\n\n \"\"\"\n @staticmethod\n def inSphere(pa: Sequence[float], pb: Sequence[float], pc: Sequence[float], pd: Sequence[float], point: Sequence[float]) -> float:\n \"\"\"\n\n inSphere(pa, pb, pc, pd, point) -> float\n\n Performs an adaptive exact inside test of the 3d point against the\n sphere defined by pa, pb, pc, and pd. Note that inconsistent\n orientation of the four sphere defining points will reverse the sign\n of the result.\n\n See http://www.cs.cmu.edu/~quake/robust.html for details of the\n implementation.\n\n\n \"\"\"\n @staticmethod\n def intersectPlane(plane_point: Vector3, plane_dir: Vector3, line_origin: Vector3, line_dir: Vector3) -> Vector3:\n \"\"\"\n\n intersectPlane(plane_point, plane_normal, line_origin, line_dir) ->\n hou.Vector3\n\n Takes a plane defined by an origin point and normal vector\n (plane_point and plane_normal) and a line defined by an origin and\n direction (line_origin and line_dir) and returns a hou.Vector3 value\n representing the XYZ coordinates of the intersection point between\n the line and plane. All arguments must be hou.Vector3.\n\n > hou.hmath.intersectPlane(\n > hou.Vector3(0, 0, 0), hou.Vector3(0, 1, 0),\n > hou.Vector3(0.212, 1.56, 0), hou.Vector3(0, 0.62, -0.34)\n > ) # -> hou.Vector3(0.212, -1.19209e-07, 0.855484)\n\n (Note that line runs forward and backward along the line_dir from\n the origin. That is, even if line_dir points away from the plane,\n you will get the intersection behind the origin.)\n\n > hou.hmath.intersectPlane(\n > hou.Vector3(0, 0, 0), hou.Vector3(0, 1, 0), # Ground plane\n > hou.Vector3(0, 1, 0), hou.Vector3(0, 1, 0) # Line up from 1u above ground\n > ) # -> hou.Vector3(0, 0, 0)\n\n This function raises an exception if the line is parallel to the\n plane, or if the line_dir has no length, or even if the line is not\n mathematically parallel but parallel enough that the answer would be\n outside roughly a -100000, -100000 to 100000, 100000 square.\n\n\n \"\"\"\n @staticmethod\n def combineLocalTransform(local: Matrix4, world: Matrix4, parent_local: Matrix4|None = ..., mode: EnumValue = ...) -> Matrix4:\n \"\"\"\n\n combineLocalTransform(local, world, parent_local=None,\n mode=hou.scaleInheritanceMode.Default) -> hou.Matrix4\n\n Returns a new world transform given its local and parent world\n transforms.\n\n\n \"\"\"\n @staticmethod\n def extractLocalTransform(local: Matrix4, world: Matrix4, parent_local: Matrix4, mode: EnumValue = ..., effective_local: Matrix4|None = ...) -> Matrix4:\n \"\"\"\n\n extractLocalTransform(world, parent_world, parent_local,\n mode=hou.scaleInheritanceMode.Default, effective_local=None) ->\n hou.Matrix4\n\n Returns a new local transform given its world and new parent\n transforms. If effective_local is given, then it is a hou.Matrix4\n modified to be the effective local transform taking into account\n mode.\n\n\n \"\"\"\n @staticmethod\n def slerpTransforms(xforms: typing.Iterable[Matrix4], input_weights: Sequence[float], normalize_weigths: bool = True, slerp_method: int = 1, slerp_flip_mehtod: int = 1) -> Matrix4:\n \"\"\"\n\n slerpTransforms( xforms, input_weights, normalize_weights, slerp_method,\n slerp_flip_method) -> hou.Matrix4\n\n Spherically blend transforms by decomposing into separate\n quaternions. xforms is the array of hou.Matrix4 transforms to blend.\n input_weights is an array of floats with the same size as the\n xforms. Set normalize_weights to True to normalize the input\n weights. slerp_method can be 0 to blend using normalized linear\n interpolation of quaternions or 1 to use an iterative method.\n slerp_flip_method defines a flip methid for slerp to ensure\n consistency during blending. It can be 0 to use the hemisphere of\n the first quaternion, or 1 to compare each adjacent quaternions when\n using NLERP.\n\n\n \"\"\"\n\nclass hotkeys:\n \"\"\"\n\n hou.hotkeys\n\n Module containing hotkey related functions.\n\n See hotkeys for information about hotkeys in Houdini.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def assignments(hotkey_symbol: str) -> Tuple[str,...]: ...\n @staticmethod\n def assignmentsAsTuples(context: str, command: str, resolve_refs: bool = True) -> Tuple[Tuple[str, ...], ...]: ...\n @staticmethod\n def hotkeyDescription(hotkey_symbol: str) -> str:\n '''\n\n hotkeyDescription(hotkey_symbol) -> str\n\n Returns the long description/help for a the given symbol string.\n\n > desc = hou.hotkeys.hotkeyDescription(\\\\\"h.open\\\\\")\n > # \\\\\"Open a file\\\\\"\n\n '''\n @staticmethod\n def hotkeyLabel(hotkey_symbol: str) -> str:\n '''\n\n hotkeyLabel(hotkey_symbol) -> str\n\n Return the human-readable label for a symbol string.\n\n\n hotkey_symbol\n The target hotkey symbol name.\n\n > label = hou.hotkeys.hotkeyLabel(\\\\\"h.open\\\\\")\n > # \\\\\"Open\\\\\"\n\n '''\n @staticmethod\n def isKeyMatch(key: str, hotkey_symbol: str) -> bool:\n \"\"\"\n\n isKeyMatch(key, hotkey_symbol) -> bool\n\n Return True is key is a match for the given hotkey symbol. If key is\n a keyvoard shortcut string then it must match one of the keyboard\n shortcuts assigned to the hotkey. If key is a hotkey symbol then it\n must be a string match to hotkey_symbol.\n\n\n key\n Either a keyboard sequence string or a hotkey symbol. This is\n typically something given to us by an event processing system\n which would either know the hotkey invoked (like when a button\n is clicked) or just the key sequence pressed.\n\n hotkey_symbol\n The hotkey to check for a match against.\n\n\n \"\"\"\n @staticmethod\n def isKeycodeMatch(key_code: int, hotkey_symbol: str) -> bool:\n \"\"\"\n\n isKeycodeMatch(key_code, hotkey_symbol) -> bool\n\n Return True is keycode is a match for the given hotkey symbol.\n\n\n key_code\n A keycode from a keyboard event.\n\n hotkey_symbol\n The hotkey to check for a match against.\n\n\n \"\"\"\n @staticmethod\n def findConflicts(context: str, hotkey_symbol: str, key: str|None = ...) -> Tuple[str,...]:\n '''\n\n findConflicts(context, symbol, key) -> tuple of str\n\n Returns a sequence of symbol strings in ancestor and/or descendant\n contexts relative to the given context (including the symbol you\n passed in itself) that use the given key. This lets you see existing\n or potential conflicts. The returned strings are encoded as\n ?.\n\n This function also has a deprecated signature without the context\n argument. The deprecated signature should not be used unless use of\n the old hotkey system has been forced with an environment variable.\n Under the old hotkey system, the returned strings are simply the\n symbols.\n\n An example of a conflict would be if a high level action (for\n example, h.copy, in the h context) has hotkey [Ctrl + C], and a\n lower-level action (for example,\n h.panes.gview.state.sop.demo.duplicate in the\n h.panes.gview.state.sop.demo context) also uses [Ctrl + C], then\n where you\\'re in that state, the higher-level Copy key won\\'t be\n available because it\\'s overridden by the lower-level key.\n\n > # Find potential conflicts with K on the top-level Add Keyframe command\n > symbols = hou.hotkeys.findConflicts(\\\\\"h\\\\\", \\\\\"h.add_key\\\\\", \\\\\"k\\\\\")\n > # Returns (\\'h.pane.gview.state.sop.topobuild?h.pane.gview.state.sop.topobuild.bridge\\', \\'h?h.add_key\\'),\n > # meaning K is assigned to both h.add_key and\n > # h.pane.gview.state.sop.topobuild.bridge\n > # in the same hierarchy\n > \n > # Find potential conflicts with Ctrl + C on the top-level Copy command\n > symbols = hou.hotkeys.findConflicts(\\\\\"h.copy\\\\\", \\\\\"ctrl+c\\\\\") # (Use cmd+c on Mac)\n > # Returns (\\\\\"h.copy\\\\\",) meaning there are no conflicts (the symbol\n > # you checked is the only symbol in that hierarchy using that key)\n\n '''\n @staticmethod\n def resolveAssignments(contexts: Sequence[str], hotkey_symbols: Sequence[str]) -> Tuple[Tuple[str, ...], ...]:\n '''\n\n resolveAssignments(self, contexts, hotkey_symbols) -> tuple of tuple of\n str\n\n Return a tuple of strings that represent the hotkeys that will\n invoke each action from a tuple of hotkey symbols when resolved\n against a specific list of hotkey contexts. The key strings are of\n the form returned by the hou.ui.hotkeys method, which is a\n combination of the symbol on the key, and any modifier keys\n involved, such as \\\\\"Ctrl+Shift+G\\\\\".\n\n\n '''\n @staticmethod\n def changeIndex() -> int:\n \"\"\"\n\n changeIndex() -> int\n\n Return the monotonically increasing change index from the hotkey\n manager. This number increases by one whenever any change is made to\n the hotkey manager. If a module is caching any information from the\n hotkey manager it should check this change index to see if any\n changes have been made and thus the cache should be refreshed.\n\n\n \"\"\"\n @staticmethod\n def commandsInContext(context: str) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n commandsInContext(context) -> tuple of dict\n\n This method is deprecated under the new hotkey system. Use either\n hou.hotkeys.commandsInCategory or\n hou.hotkeys.commandBindingsInContext instead.\n\n Return all hotkey commands at the given parent hotkey context.\n\n Each command is a dict with the following keys: symbol, label, and\n help.\n\n\n context\n The hotkey symbol of the context.\n\n\n \"\"\"\n @staticmethod\n def contextsInContext(context: str) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n contextsInContext(context) -> tuple of dict\n\n Return all hotkey contexts at the given parent hotkey context.\n\n Each command is a dict with the following keys: symbol, label, and\n help.\n\n\n context\n The hotkey symbol of the context.\n\n\n \"\"\"\n @staticmethod\n def commandCategoriesInCategory(category: str) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n commandCategoriesInCategory(category) -> tuple of dict\n\n Return all hotkey command categories under the given parent hotkey\n category.\n\n Each category is a dict with the following keys: symbol, label, and\n help.\n\n\n category\n The symbol of the command category.\n\n\n \"\"\"\n @staticmethod\n def commandsInCategory(category: str) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n commandsInCategory(category) -> tuple of dict\n\n Return all hotkey commands under the given parent category.\n\n Each command is a dict with the following keys: symbol, label, and\n help.\n\n\n category\n The symbol of the command category.\n\n\n \"\"\"\n @staticmethod\n def commandBindingsInContext(context: str) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n commandBindingsInContext(context) -> tuple of dict\n\n Return all commands bound in the given hotkey context.\n\n Each command is a dict with the following keys: symbol, label, and\n help.\n\n\n context\n The hotkey symbol of the context.\n\n\n \"\"\"\n @staticmethod\n def addCommand(hotkey_symbol: str, label: str, description: str, assignments: Sequence[str]) -> bool:\n '''\n\n addCommand(hotkey_symbol, label, description, assignments) -> bool\n\n This method is deprecated. Use hou.hotkeys.installDefinitions\n instead.\n\n Registers a new configurable hotkey command with Houdini. The\n context it belongs to should already exist, see\n hou.hotkeys.addContext.\n\n A hotkey symbol represents an action, for example deleting the\n selected geometry when a certain tool is active. The user can change\n the actual key assigned to the action using the hotkey editor. After\n registering the symbol you can programmatically assign a default key\n using hou.hotkeys.addAssignment.\n\n To add a delete action to the demo python state, you would do\n something like this:\n\n > # Add a hotkey context for the demo python state\n > demo_context = \\\\\"h.pane.gview.state.sop.demo\\\\\"\n > hou.hotkeys.addContext(demo_context, \\\\\"demo Operation\\\\\", \\\\\"These keys apply to the demo operations\\\\\")\n > \n > # Add hotkeys to the \\\\\"demo\\\\\" state\n > delete_symbol = demo_context + \\\\\".delete\\\\\"\n > hou.hotkeys.addCommand(\n > delete_symbol,\n > \\\\\"Delete Selected\\\\\",\n > \\\\\"Delete the selected geometry\\\\\"\n > )\n > commit_symbol = demo_context + \\\\\".commit\\\\\"\n > hou.hotkeys.addCommand(\n > commit_symbol,\n > \\\\\"Commit Changes\\\\\",\n > \\\\\"Save changes to parameters and start a new cache\\\\\"\n > )\n > cancel_symbol = demo_context + \\\\\".cancel\\\\\"\n > hou.hotkeys.addCommand(\n > cancel_symbol,\n > \\\\\"Cancel Changes\\\\\",\n > \\\\\"Discard any changes and return to an empty cache\\\\\"\n > )\n\n hotkey_symbol\n A string containing a full dotted hotkey symbol.\n\n label\n A human readable title for the action. For example, Delete\n Selected.\n\n description\n A human readable description of the action. This should\n generally be one to three sentences of help text for the action.\n\n assignments\n An optional list of shortcut strings to be used as the default\n assignments for this command.\n\n\n '''\n @staticmethod\n def addContext(hotkey_symbol: str, label: str, description: str) -> bool:\n \"\"\"\n\n addContext(hotkey_symbol, label, long_description ) -> bool\n\n This method is deprecated. Use hou.hotkeys.installDefinitions\n instead.\n\n Registers a new hotkey context with Houdini. A context should be\n created before creating contexts or commands within that context.\n\n Currently this is only useful for adding hotkeys to Python states.\n\n\n hotkey_symbol\n A string containing a full dotted hotkey symbol representing the\n context. Currently the only useful value for hotkey_symbol is:\n\n > h.pane.gview.state.sop\n\n label\n A human readable title for the context. For example, Demo State\n Operation.\n\n description\n A human readable description of the context. This should\n generally be one to three sentences of help text for the action.\n\n\n \"\"\"\n @staticmethod\n def installDefinitions(definitions: PluginHotkeyDefinitions) -> None:\n \"\"\"\n\n uninstallDefinitions(definitions)\n\n Uninstalls any command categories, commands, binding contexts and\n default bindings used by a plugin.\n\n\n definitions\n A populated hou.PluginHotkeyDefinitions object that was\n previously used to install the definitions with\n hou.hotkeys.installDefinitions().\n\n\n \"\"\"\n @staticmethod\n def uninstallDefinitions(definitions: PluginHotkeyDefinitions) -> None: ...\n @staticmethod\n def addCommandBinding(context: str, command: str) -> bool:\n \"\"\"\n\n addCommandBinding(context, command) -> bool\n\n Adds a binding for command in context so that it appears in the\n hotkey manager for key assignment if one does not already exist.\n Keys can then be assigned to this binding via\n hou.hotkeys.addAssignment. It is not necessary to do this prior to\n adding assignments, but if you want to create an empty binding\n without any assigned keys, use this.\n\n\n context\n The hotkey context in which to create the binding.\n\n command\n The hotkey command to bind in the given context.\n\n\n \"\"\"\n @staticmethod\n def removeCommandBinding(context: str, command: str) -> bool:\n \"\"\"\n\n removeCommandBinding(context, command) -> bool\n\n Removes the binding for command from context. Note that in most\n cases you probably want remove all key assignments from the binding,\n leaving the binding itself in place. See\n hou.hotkeys.clearAssignments.\n\n\n context\n The hotkey context from which to remove the binding.\n\n command\n The hotkey command to unbind from the given context.\n\n\n \"\"\"\n @staticmethod\n def removeHotkeySymbol(hotkey_symbol: str) -> None:\n '''\n\n removeHotkeySymbol(hotkey_symbol)\n\n This method is deprecated. Use hou.hotkeys.uninstallDefinitions\n instead.\n\n Removes an existing hotkey previously created with .\n\n\n hotkey_symbol\n A string containing a full dotted hotkey symbol.\n\n Currently this is only useful for removing hotkeys of Python SOP\n states, so symbol will be in the form:\n\n h.pane.gview.state.sop..\n\n > hou.hotkeys.removeHotkeySymbol(\\\\\"h.pane.gview.state.sop.demo.delete\\\\\")\n\n '''\n @staticmethod\n def hotkeySymbol(english_context: str, english_command: Optional[str] = None) -> str:\n '''\n\n hotkeySymbol(context_label_path, command_label=None) -> str or None\n\n Does a reverse-lookup to retrieve the hotkey symbol given the human-\n readable context label(s). If you supply only a context label, the\n function returns the context\\'s prefix symbol. If you also supply a\n command label, the function returns the command\\'s hotkey symbol.\n\n\n context_label_path\n A string containing a path through the hierarchy of human-\n readable context labels, starting with and separated by slashes.\n For example, \\\\\"/Houdini/Panes/Geometry Viewers\\\\\".\n\n command_label\n An optional human-readable command label, for example \\\\\"Box\n Selection\\\\\".\n\n > hou.hotkeys.hotkeySymbol(\\\\\"/Houdini/Panes/Geometry Viewers\\\\\", \\\\\"Box Selection\\\\\")\n > # \\\\\"h.pane.gview.selectstylebox\\\\\"\n\n '''\n @staticmethod\n def clearAssignments(context: str, hotkey_symbol: str = ...) -> bool:\n '''\n\n clearAssignments(context, hotkey_symbol) -> bool\n\n Removes any keys assigned to a hotkey symbol in the given context.\n\n > hou.hotkeys.clearAssignments(\\\\\"h.pane.gview.state.sop.demo\\\\\", \\\\\"h.pane.gview.state.sop.demo.delete\\\\\")\n\n context\n The hotkey context in which to clear the asssignments.\n\n hotkey_symbol\n The symbol string for the action you want to remove hotkeys\n from.\n\n This function also has a deprecated signature without the context\n argument. The deprecated signature should not be used unless use of\n the old hotkey system has been forced with an environment variable.\n\n RELATED\n\n hou.hotkeys.addCommand\n\n\n '''\n @staticmethod\n def addAssignment(context: str, hotkey_symbol: str, key: str = ...) -> bool:\n '''\n\n addAssignment(context, hotkey_symbol, key) -> bool\n\n Assigns a key (or key combination) to a hotkey symbol in the given\n context.\n\n > hou.hotkeys.addAssignment(\\\\\"h.pane.gview.state.sop.demo\\\\\", \\\\\"h.pane.gview.state.sop.demo.delete\\\\\", \\\\\"alt+k\\\\\")\n > hou.hotkeys.addAssignment(\\\\\"h.pane.gview.state.sop.demo\\\\\", \\\\\"h.pane.gview.state.sop.demo.delete\\\\\", \\\\\"shift+del\\\\\")\n\n Returns True if the assignment succeeds, or False if the symbol is\n unknown or the key string is not valid.\n\n\n context\n The hotkey context in which to add the asssignment.\n\n hotkey_symbol\n The symbol string for the action you want to assign a hotkey to.\n\n key\n A string specifying the key (or key combination) to assign to\n the action. For example, \\\\\"shift+del\\\\\".\n\n This function also has a deprecated signature without the context\n argument. The deprecated signature should not be used unless use of\n the old hotkey system has been forced with an environment variable.\n\n\n '''\n @staticmethod\n def removeAssignment(context: str, hotkey_symbol: str, key: str = ...) -> bool:\n '''\n\n removeAssignment(context, hotkey_symbol, key) -> bool\n\n Removes a key (or key combination) from a hotkey symbol in a given\n context.\n\n > hou.hotkeys.removeAssignment(\\\\\"h.pane.gview.state.sop.demo\\\\\", \\\\\"h.pane.gview.state.sop.demo.delete\\\\\", \\\\\"alt+k\\\\\")\n\n context\n The target context name.\n\n hotkey_symbol\n The target hotkey symbol name.\n\n key\n The key string identifier to remove. For example, \\\\\"shift+del\\\\\".\n\n This function also has a deprecated signature without the context\n argument. The deprecated signature should not be used unless use of\n the old hotkey system has been forced with an environment variable.\n\n\n '''\n @staticmethod\n def availableKeycodes(context: str, hotkey_symbol: str, layout_keys: Sequence[str]|None = ..., modifiers: int = ...) -> Tuple[int,...]:\n \"\"\"\n\n availableKeycodes(context, hotkey_symbol, layout_keys, modifiers=0) ->\n tuple of int\n\n Return all available shortcut keycodes with their conflict status\n bits set w.r.t. the specified hotkey symbol. A keycode is considered\n available if it isn't assigned to another hotkey within the given\n context.\n\n\n context\n The context to check for availability.\n\n hotkey_symbol\n The target hotkey symbol name.\n\n layout_keys\n A list of unmodified keycodes to check. If empty, the unmodified\n keycodes from a standard US keyboard will be checked.\n\n modifiers\n UI_KeyBindings modifier key bits to be applied. Only keycodes\n with these modifier bits are returned.\n\n This function also has a deprecated signature without the context\n argument. The deprecated signature should not be used unless use of\n the old hotkey system has been forced with an environment variable.\n\n\n \"\"\"\n @staticmethod\n def keycodeToString(keycode: int, modifiers: int = 0) -> str:\n \"\"\"\n\n keycodeToString(keycode, modifiers=0) -> str\n\n Convert a hotkeymanager keycode to a key string.\n\n\n modifiers\n UI_KeyBindings modifier key bits to be applied.\n\n\n \"\"\"\n @staticmethod\n def stringToKeycode(key: str, modifiers: int = 0) -> int:\n \"\"\"\n\n stringToKeycode(key, modifiers=0) -> int\n\n Convert a keystring to a hotkeymanager keycode.\n\n\n modifiers\n UI_KeyBindings modifier key bits to be applied.\n\n\n \"\"\"\n @staticmethod\n def splitKeySequenceString(key: str) -> Tuple[str, ...]:\n \"\"\"\n\n splitKeySequenceString(key) -> tuple of str\n\n Splits a string specifying a key sequence into its component key\n strings. If the string does not specify a valid key sequence, it\n returns a tuple of one element containing that string.\n\n\n key\n A string specifying a key sequence or key combination or\n reference to a command binding.\n\n\n \"\"\"\n @staticmethod\n def revertToDefaults(context: str, hotkey_symbol: str, one_level_only: bool) -> None:\n \"\"\"\n\n revertToDefaults(context, hotkey_symbol, one_level_only)\n\n Revert the specified hotkey to its defaults from the keymap.\n\n\n hotkey_symbol\n The hotkey command symbol to reset. If using the deprecated\n signature without the context argument, this can also be a\n hotkey context symbol, otherwise a value of None or an empty\n string to revert all the bindings in the context.\n\n one_level_only\n When False, this item and its children are all set to their\n default. When True, only this context or command is reset. This\n only has an effect for contexts since commands have no children.\n\n This function also has a deprecated signature without the context\n argument. The deprecated signature should not be used unless use of\n the old hotkey system has been forced with an environment variable.\n\n\n \"\"\"\n @staticmethod\n def saveOverrides() -> bool:\n \"\"\"\n\n saveOverrides() -> bool\n\n Save changes to the hotkeys as overrides to the current keymap.\n Changes are things that are different from their default value e.g.\n modifying a shortcut key assignment. Note that adding a new hotkey\n command with addHotkey will treat it as a new default so that it\n won't be saved unless a change is made to it after it is added.\n\n\n \"\"\"\n @staticmethod\n def saveAsKeymap(name: str, path: Optional[str] = None) -> bool:\n \"\"\"\n\n saveAsKeymap(name, path=None) -> bool\n\n Save the currently defined hotkeys as a keymap. This combines the\n loaded keymap with all of the defined overrides into a single new\n keymap. Returns True upon successful save.\n\n\n name\n The name of the new keymap.\n\n path\n Optional save path for the new keymap. If None then it will be\n saved into the user prefs dir with a filename derived from the\n keymap name.\n\n\n \"\"\"\n @staticmethod\n def loadKeymap(name: str, path: Optional[str] = None) -> bool:\n \"\"\"\n\n loadKeymap(name, path=None) -> bool\n\n Save the currently defined hotkeys as a keymap. This combines the\n loaded keymap with all of the defined overrides into a single new\n keymap. Returns True upon successful load.\n\n\n name\n The name of the keymap to load.\n\n path\n Optional path for the keymap to load. If None then it will be\n searched in the search path.\n\n\n \"\"\"\n @staticmethod\n def importKeymap(name: str, path: str) -> bool:\n \"\"\"\n\n importKeymap(name, path=None) -> bool\n\n Copy the specified keymap into the user preferences directory and\n save it with an appropriate name. Returns True upon successful\n import.\n\n\n name\n The new name of the keymap.\n\n path\n The path of the keymap to import.\n\n\n \"\"\"\n @staticmethod\n def keymaps() -> Tuple[Tuple[str, str], ...]:\n \"\"\"\n\n keymaps() -> tuple or str\n\n Return a list of tuples of all the keymaps found. The tuple has the\n keymap's name and path.\n\n\n \"\"\"\n @staticmethod\n def currentKeymap() -> str:\n \"\"\"\n\n currentKeymap() -> str\n\n Return the name of the currently loaded keymap.\n\n\n \"\"\"\n\nclass ik:\n \"\"\"\n\n hou.ik\n\n Module containing functions related to inverse kinematics.\n\n API\n\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def solveFBIK(skeleton: Sequence[_ik_Skeleton], targets: Sequence[_ik_Target], iters: int = ..., tolerance: float = ..., pin_root: bool = ...) -> None:\n \"\"\"\n\n hou.ik.solveFBIK\n\n Applies a full-body inverse kinematics algorithm to a skeleton.\n\n USAGE\n solveFBIK(skeleton, targets, iters=30, tolerance=1e-5, pin_root=False)\n\n This solver is equivalent to the solvefbik() VEX function.\n\n\n skeleton\n The hou.ik.Skeleton to solve. The joints' transforms will be updated\n with the solution.\n\n targets\n A list of hou.ik.Target specifying the goal transforms for\n particular joints. Raises hou.ValueError if any of the targets are\n not attached to a joint, or if multiple targets are attached to the\n same joint.\n\n iters\n The maximum number of iterations to perform. The solver may\n terminate early if the tolerance parameter is used.\n\n tolerance\n The tolerance to use when checking for convergence, defaults to\n 1e-5. If positions converge to within this tolerance, the algorithm\n will stop. If 0, the solver will always perform exactly iters\n iterations.\n\n pin_root\n Specifies whether the root joint is allowed to translate.\n\n\n \"\"\"\n @staticmethod\n def solvePhysFBIK(skeleton: Sequence[_ik_Skeleton], targets: Sequence[_ik_Target], com_target: _ik_Target|None = ..., iters: int = ..., damping: float = ..., tolerance: float = ...) -> None:\n \"\"\"\n\n hou.ik.solvePhysFBIK\n\n Applies a full-body inverse kinematics algorithm to a skeleton, with\n optional control over the center of mass.\n\n USAGE\n solvePhysFBIK(skeleton, targets, com_target=None, iters=30,\n damping=0.5, tolerance=1e-5)\n\n This solver is equivalent to the solvephysfbik() VEX function.\n\n\n skeleton\n The hou.ik.Skeleton to solve. The joints' transforms will be updated\n with the solution.\n\n targets\n A list of hou.ik.Target specifying the goal transforms for\n particular joints. Raises hou.ValueError if any of the targets are\n not attached to a joint, or if multiple targets are attached to the\n same joint.\n\n com_target\n An optional hou.ik.Target which specifies the goal position of the\n skeleton's center of mass.\n\n iters\n The maximum number of iterations to perform. The solver may\n terminate early if the tolerance parameter is used.\n\n damping\n Damping factor for the solver. Larger values will produce more\n stable results when, for example, a target is unreachable. A value\n that is too large, however, will require more iterations to\n converge. Around 0.5 is typically a suitable initial value.\n\n tolerance\n The tolerance to use when checking for convergence, defaults to\n 1e-5. If positions converge to within this tolerance, the algorithm\n will stop. If 0, the solver will always perform exactly iters\n iterations.\n\n\n \"\"\"\n\nclass _ik_Joint:\n \"\"\"\n\n hou.ik.Joint\n\n Represents a joint in an inverse kinematics skeleton.\n\n Joints can be created using hou.ik.Skeleton.addJoint.\n\n RELATED\n\n * hou.ik.Skeleton\n\n * hou.ik.Target\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def worldTransform(self) -> Matrix4:\n \"\"\"\n\n worldTransform() -> hou.Matrix4\n\n Returns the joint's world space transform.\n\n\n \"\"\"\n def setWorldTransform(self, xform: Matrix4) -> None:\n \"\"\"\n\n setWorldTransform(xform)\n\n Sets the joint's world space transform (a hou.Matrix4).\n\n\n \"\"\"\n def parent(self) -> Optional[_ik_Joint]:\n \"\"\"\n\n parent() -> hou.ik.Joint\n\n Returns the joint's parent, or None for a root joint.\n\n\n \"\"\"\n def setParent(self, parent: _ik_Joint) -> None: ...\n def rotationOrder(self) -> str:\n \"\"\"\n\n rotationOrder() -> str\n\n Returns the joint's rotation order. See\n hou.ik.Joint.setRotationOrder.\n\n\n \"\"\"\n def setRotationOrder(self, rotate_order: str) -> None:\n \"\"\"\n\n setRotationOrder(rotate_order)\n\n Sets the joint's rotation order.\n\n\n rotate_order\n A string containing a permutation of the letters x, y, and z\n that determines the order in which rotations are performed about\n the coordinate axes.\n\n\n \"\"\"\n def rotationWeights(self) -> Vector3:\n \"\"\"\n\n rotationWeights() -> hou.Vector3\n\n Returns the weights for the joint's rotation axes. See\n hou.ik.Joint.setRotationWeights.\n\n\n \"\"\"\n def setRotationWeights(self, weights: Vector3) -> None:\n \"\"\"\n\n setRotationWeights(weights)\n\n Sets a hou.Vector3 specifying the weight of each rotation axis.\n Given a larger relative weight, the solution will tend to be\n achieved by rotating around that axis. A weight of zero will disable\n the rotation axis.\n\n\n \"\"\"\n def translationWeights(self) -> Vector3:\n \"\"\"\n\n translationWeights() -> hou.Vector3\n\n Returns the weights for the joint's translation axes. See\n hou.ik.Joint.setTranslationWeights.\n\n\n \"\"\"\n def setTranslationWeights(self, weights: Vector3) -> None:\n \"\"\"\n\n setTranslationWeights(weights)\n\n Sets a hou.Vector3 specifying the weight of each translation axis.\n Given a larger relative weight, the solution will tend to be\n achieved by translating along that axis. A weight of zero will\n disable the translation axis. To set up an unpinned root joint, the\n root's translation weight should be non-zero (e.g. hou.Vector3(1, 1,\n 1)).\n\n\n \"\"\"\n def mass(self) -> float:\n \"\"\"\n\n mass() -> float\n\n Returns the mass of the body attached to this joint. See\n hou.ik.Joint.setMass.\n\n\n \"\"\"\n def setMass(self, mass: float) -> None:\n \"\"\"\n\n setMass(mass)\n\n Sets the mass of the body attached to this joint. This is only used\n by solvers that support center of mass targets, such as\n hou.ik.solvePhysFBIK.\n\n\n \"\"\"\n def localCenterOfMass(self) -> Vector3:\n \"\"\"\n\n localCenterOfMass() -> hou.Vector3\n\n Returns the local space position of the body attached to this joint.\n See hou.ik.Joint.setLocalCenterOfMass.\n\n\n \"\"\"\n def setLocalCenterOfMass(self, com: Vector3) -> None:\n \"\"\"\n\n setLocalCenterOfMass(position)\n\n Sets the local space position of the body attached to this joint. A\n position of hou.Vector3(0, 0, 0) will position the center of mass at\n the joint's world space position. This is only used by solvers that\n support center of mass targets, such as hou.ik.solvePhysFBIK.\n\n\n \"\"\"\n def rotationLimits(self) -> Tuple[Vector3, Vector3]:\n \"\"\"\n\n rotationLimits() -> (hou.Vector3, hou.Vector3)\n\n Returns the lower and upper rotation limits (in radians) for the\n joint, relative to the rest transform. If\n hou.ik.Joint.hasRotationLimits() is False, (None, None) is returned.\n\n\n \"\"\"\n def setRotationLimits(self, lower: Vector3, upper: Vector3) -> None:\n \"\"\"\n\n setRotationLimits(lower, upper)\n\n Sets the lower and upper rotation limits (a hou.Vector3 in radians)\n for the joint.\n\n\n \"\"\"\n def translationLimits(self) -> Tuple[Vector3, Vector3]:\n \"\"\"\n\n translationLimits() -> (hou.Vector3, hou.Vector3)\n\n Returns the lower and upper translation limits for the joint,\n relative to the rest transform.\n\n\n \"\"\"\n def setTranslationLimits(self, lower: Vector3, upper: Vector3) -> None:\n \"\"\"\n\n setTranslationLimits(lower, upper)\n\n Sets the lower and upper translation limits for the joint.\n\n\n \"\"\"\n def restTransform(self) -> Matrix4:\n \"\"\"\n\n restTransform() -> hou.Matrix4\n\n Returns the joint's rest pose, or None if it has not been set.\n\n\n \"\"\"\n def setRestTransform(self, xform: Matrix4) -> None:\n \"\"\"\n\n setRestTransform(xform)\n\n Sets a local space hou.Matrix4 specifying the joint's rest pose. If\n not specified, the identity transform is used.\n\n The solver will attempt to maintain this local transform based on\n the rest rotation weights and rest translation weights. This has a\n priority lower than any of the end effector targets.\n\n Additionally, joint limits are enforced relative to this rest\n transform.\n\n\n \"\"\"\n def restRotationWeights(self) -> Vector3:\n \"\"\"\n\n restRotationWeights() -> hou.Vector3\n\n Returns the rest weights for the joint's rotation axes. See\n hou.ik.Joint.setRestRotationWeights.\n\n\n \"\"\"\n def setRestRotationWeights(self, weights: Vector3) -> None:\n \"\"\"\n\n setRestRotationWeights(weights)\n\n Sets a hou.Vector3 specifying how strongly the solver attempts to\n match the rest transform for the rotation axes. A value of 0.1 is\n typically a suitable value when enabling this behavior, and a value\n of 0 will disable the constraint. The default value is {0,0,0}.\n\n\n \"\"\"\n def restTranslationWeights(self) -> Vector3:\n \"\"\"\n\n restTranslationWeights() -> hou.Vector3\n\n Returns the rest weights for the joint's translation axes. See\n hou.ik.Joint.setRestTranslationWeights.\n\n\n \"\"\"\n def setRestTranslationWeights(self, weights: Vector3) -> None:\n \"\"\"\n\n setRestTranslationWeights(weights)\n\n Sets a hou.Vector3 specifying how strongly the solver attempts to\n match the rest transform for the translation axes. A value of 0.1 is\n typically a suitable value when enabling this behavior, and a value\n of 0 will disable the constraint. The default value is {0,0,0}.\n\n\n \"\"\"\n\nclass _ik_Skeleton:\n \"\"\"\n\n hou.ik.Skeleton\n\n Represents a skeleton for use with inverse kinematics solvers.\n\n RELATED\n\n * hou.ik.Joint\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n hou.ik.Skeleton\n\n Represents a skeleton for use with inverse kinematics solvers.\n\n RELATED\n\n * hou.ik.Joint\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def addJoint(self, world_transform: Matrix4 = ..., parent: _ik_Joint|None = ..., rotation_weights: Vector3 = ..., translation_weights: Vector3 = ..., mass: float = ..., local_com: Vector3 = ...) -> _ik_Joint:\n \"\"\"\n\n addJoint(self, world_transform=hou.Matrix4(1.0), parent=None,\n rotation_weights=hou.Vector3(1,1,1),\n translation_weights=hou.Vector3(0,0,0), mass=1.0,\n local_com=hou.Vector3(0,0,0)) -> hou.ik.Joint\n\n Appends a new joint to the skeleton.\n\n\n world_transform\n See hou.ik.Joint.setWorldTransform\n\n parent\n See hou.ik.Joint.setParent\n\n rotation_weights\n See hou.ik.Joint.setRotationWeights\n\n translation_weights\n See hou.ik.Joint.setTranslationWeights\n\n mass\n See hou.ik.Joint.setMass\n\n local_com\n See hou.ik.Joint.setLocalCenterOfMass\n\n\n \"\"\"\n def joints(self) -> Iterator[_ik_Joint]:\n \"\"\"\n\n joints(self) -> tuple of hou.ik.Joint\n\n Returns a list of the joints in the skeleton. The list follows the\n order in which the joints were added to the skeleton.\n\n\n \"\"\"\n def centerOfMass(self) -> Vector3:\n \"\"\"\n\n centerOfMass() -> hou.Vector3\n\n Returns the world space position of the skeleton's center of mass.\n This is computed from the mass, center of mass, and world transform\n of each joint.\n\n\n \"\"\"\n\nclass _ik_Target:\n \"\"\"\n\n hou.ik.Target\n\n Represents a position or orientation target for inverse kinematics\n solvers.\n\n RELATED\n\n * hou.ik.Joint\n\n * hou.ik.targetType\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, joint: _ik_Joint|None = ..., goal_transform: Matrix4 = ..., joint_offset: Matrix4 = ..., target_type: EnumValue = ..., weight: float = ..., priority: int = ..., depth: int = ...) -> None:\n \"\"\"\n\n __init__(joint=None, goal_transform=hou.Matrix4(1.0),\n joint_offset=hou.Matrix4(1.0), target_type=hou.ik.targetType.Position,\n weight=1.0, priority=0, depth=-1)\n\n Creates a new target.\n\n\n joint\n See hou.ik.Target.setJoint.\n\n goal_transform\n See hou.ik.Target.setGoalTransform.\n\n joint_offset\n See hou.ik.Target.setJointOffset.\n\n target_type\n See hou.ik.Target.setTargetType.\n\n weight\n See hou.ik.Target.setWeight.\n\n priority\n See hou.ik.Target.setPriority.\n\n depth\n See hou.ik.Target.setDepth.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def joint(self) -> _ik_Joint:\n \"\"\"\n\n joint() -> hou.ik.Joint\n\n Returns the joint that the target is attached to, or None.\n\n\n \"\"\"\n def setJoint(self, joint: _ik_Joint) -> None:\n \"\"\"\n\n setJoint(joint)\n\n Sets the hou.ik.Joint that the target is attached to. This may be\n None if, for example, the target defines a goal position for the\n skeleton's center of mass.\n\n\n \"\"\"\n def goalTransform(self) -> Matrix4:\n \"\"\"\n\n goalTransform() -> hou.Matrix4\n\n Returns the world space goal transform.\n\n\n \"\"\"\n def setGoalTransform(self, xform: Matrix4) -> None:\n \"\"\"\n\n setGoalTransform(xform)\n\n Sets the target world space transform (a hou.Matrix4) for the joint.\n\n\n \"\"\"\n def jointOffset(self) -> Matrix4:\n \"\"\"\n\n jointOffset() -> hou.Matrix4\n\n Returns the local space joint offset transform. See\n hou.ik.Target.setJointOffset.\n\n\n \"\"\"\n def setJointOffset(self, offset: Matrix4) -> None:\n \"\"\"\n\n setJointOffset(xform)\n\n Sets a local space transform (a hou.Matrix4) that is combined with\n the joint transform to produce the transform that the solver\n attempts to align with the goal transform. This can be used to place\n the target at an offset from the joint (for example, at the end of a\n bone).\n\n\n \"\"\"\n def targetType(self) -> EnumValue:\n \"\"\"\n\n targetType() -> hou.ik.targetType\n\n Returns the target's type. See hou.ik.Target.setTargetType.\n\n\n \"\"\"\n def setTargetType(self, target_type: EnumValue) -> None:\n \"\"\"\n\n setTargetType(target_type)\n\n Sets a hou.ik.targetType, which specifies whether the target affects\n position, orientation, or both.\n\n\n \"\"\"\n def weight(self) -> float:\n \"\"\"\n\n weight() -> float\n\n Returns the target's weight. See hou.ik.Target.setWeight.\n\n\n \"\"\"\n def setWeight(self, weight: float) -> None:\n \"\"\"\n\n setWeight(weight)\n\n Sets a float specifying the importance of the target. When multiple\n targets have the same priority level, targets with a higher relative\n weight are more likely to be reached.\n\n\n \"\"\"\n def priority(self) -> int:\n \"\"\"\n\n priority() -> int\n\n Returns the target's priority level. See hou.ik.Target.setPriority.\n\n\n \"\"\"\n def setPriority(self, level: int) -> None:\n \"\"\"\n\n setPriority(priority)\n\n Sets an int specifying the target's priority level. Targets from a\n lower priority level cannot interfere with targets from a higher\n priority level. For example, priority levels can be used to ensure\n that the feet remain planted when manipulating the upper body of a\n skeleton.\n\n\n \"\"\"\n def depth(self) -> int:\n \"\"\"\n\n depth() -> int\n\n Returns the target's depth. See hou.ik.Target.setDepth.\n\n\n \"\"\"\n def setDepth(self, depth: int) -> None:\n \"\"\"\n\n setDepth(depth)\n\n Specifies the number of parent joints that can be adjusted to\n achieve the goal transform. A negative depth indicates that the\n entire chain can be affected.\n\n\n \"\"\"\n\nclass ImageLayer:\n \"\"\"\n\n hou.ImageLayer\n\n An ImageLayer object contains the pixels that define a 2D image layer.\n For example, COP nodes in Houdini can generate multiple ImageLayer\n objects.\n\n If you ask a COP for its geometry via the hou.CopNode.layer, you'll cook\n the COP and get a read-only hou.ImageLayer. Unlike with SOPs and\n Geometry objects, the result is no longer tied to the COP Node so it\n stays the same if the COP node recooks or is deleted.\n\n Call hou.ImageLayer.freeze to edit an ImageLayer. This returns another\n ImageLayer object that's an independent writeable copy. Writing to the\n frozen layer doesn't affect the earlier read-only versions.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, layer: Optional[ImageLayer] = None) -> None:\n \"\"\"\n\n hou.ImageLayer\n\n An ImageLayer object contains the pixels that define a 2D image layer.\n For example, COP nodes in Houdini can generate multiple ImageLayer\n objects.\n\n If you ask a COP for its geometry via the hou.CopNode.layer, you'll cook\n the COP and get a read-only hou.ImageLayer. Unlike with SOPs and\n Geometry objects, the result is no longer tied to the COP Node so it\n stays the same if the COP node recooks or is deleted.\n\n Call hou.ImageLayer.freeze to edit an ImageLayer. This returns another\n ImageLayer object that's an independent writeable copy. Writing to the\n frozen layer doesn't affect the earlier read-only versions.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __enter__(self) -> Optional[ImageLayer]: ...\n def __exit__(self, type: Any, value: Any, traceback: Any) -> None: ...\n def close(self) -> None:\n \"\"\"\n\n close(self)\n\n Resets this object to be an empty object. This stops it holding a\n reference to the underlying ImageLayer data. This will also happen\n when the object goes out of scope and is garbage collected, but the\n close() provides exact control over the timing.\n\n ImageLayers also support contexts so the with statement can be used\n to auto-close the nanovdb at the with-block end.\n\n\n \"\"\"\n def storageType(self) -> EnumValue:\n \"\"\"\n\n storageType(self) -> hou.imageLayerStorageType enum value\n\n Returns the layer's storage type, which consists of its precision\n and float vs integer type.\n\n\n \"\"\"\n def border(self) -> EnumValue:\n \"\"\"\n\n border(self) -> hou.imageLayerBorder enum value\n\n Returns the layer's border type.\n\n\n \"\"\"\n def typeInfo(self) -> EnumValue:\n \"\"\"\n\n typeInfo(self) -> hou.imageLayerTypeInfo enum value\n\n Returns the semantic type of the layer. This is used for things like\n automatic visualizations.\n\n\n \"\"\"\n def setStorageType(self, storagetype: EnumValue) -> None:\n \"\"\"\n\n setStorageType(self, storagetype)\n\n Changes the storage type of the layer. Existing data will be lost.\n\n Requires a writable layer.\n\n\n \"\"\"\n def setBorder(self, storagetype: EnumValue) -> None:\n \"\"\"\n\n setBorder(self, storagetype)\n\n Changes the border of the layer.\n\n Requires a writable layer.\n\n\n \"\"\"\n def setTypeInfo(self, storagetype: EnumValue) -> None:\n \"\"\"\n\n setTypeInfo(self, storagetype)\n\n Changes the semantic type of the layer.\n\n Requires a writable layer.\n\n\n \"\"\"\n def channelCount(self) -> int:\n \"\"\"\n\n channelCount(self) -> int\n\n Returns the number of channels in the layer.\n\n\n \"\"\"\n def setChannelCount(self, chan: int) -> None:\n \"\"\"\n\n setChannelCount(self, chan)\n\n Changes the number of channels in the layer. Existing data will be\n lost. Must be within 1 and 4.\n\n Requires a writable layer.\n\n\n \"\"\"\n def bufferResolution(self) -> Tuple[int, ...]:\n \"\"\"\n\n bufferResolution(self) -> tuple of int\n\n Returns the underlying buffer size. This is the number of data\n elements in the X and Y directions. When PixelScale is 1, this\n corresponds to the number of pixels.\n\n\n \"\"\"\n def onCPU(self) -> bool:\n \"\"\"\n\n onCPU(self) -> bool\n\n An ImageLayer may be stored on the CPU or GPU. This is true if it is\n stored on the CPU.\n\n\n \"\"\"\n def onGPU(self) -> bool:\n \"\"\"\n\n onGPU(self) -> bool\n\n An ImageLayer may be stored on the CPU or GPU. This is true if it is\n stored on the GPU.\n\n\n \"\"\"\n def isConstant(self) -> bool:\n \"\"\"\n\n isConstant(self) -> bool\n\n True if the layer is compressed as a single constant value. Note\n that a layer that has all the same values will not necessarily\n return True, as this only detects if it has been collapsed to a\n single constant value.\n\n\n \"\"\"\n def storesIntegers(self) -> bool:\n \"\"\"\n\n storesIntegers(self) -> bool\n\n True if the layer holds integer data.\n\n\n \"\"\"\n def makeConstant(self, val: Sequence[float]) -> None:\n \"\"\"\n\n makeConstant(self, val)\n\n Collapse the layer into a single constant value of the value\n provided. Value should be a tuple which will be extended to the\n required number of channels.\n\n Requires a writable layer.\n\n\n \"\"\"\n def dataWindow(self) -> BoundingRect:\n \"\"\"\n\n dataWindow(self) -> hou.BoundingRect\n\n Return the data window. This is the area, in pixels, that the buffer\n elements cover.\n\n\n \"\"\"\n def displayWindow(self) -> BoundingRect:\n \"\"\"\n\n displayWindow(self) -> hou.BoundingRect\n\n Return the display window. This is the area, in pixels, that is\n framed to Image space.\n\n\n \"\"\"\n def pixelAspectRatio(self) -> float:\n \"\"\"\n\n pixelAspectRatio(self) -> float\n\n The ratio Image space coordinates and pixel coordinates.\n\n\n \"\"\"\n def pixelScale(self) -> Tuple[float, ...]:\n \"\"\"\n\n pixelScale(self) -> tuple of float\n\n The scaling factor between the pixel values and the underlying\n buffer elements. This is the number of pixels in each dimension that\n fit in a buffer element. Thus (2,2) would create one buffer element\n for every 2x2 block of pixels.\n\n\n \"\"\"\n def setDataWindow(self, x: int, y: int, w: int, h: int) -> None:\n \"\"\"\n\n setDataWindow(self, x, y, w, h)\n\n Set the buffer to cover the provided pixels. The actual size of the\n buffer will vary according to pixel scale. If pixel scale is 1, w\n and h will be the resolution. Existing data will be lost.\n\n This requires a writable layer.\n\n\n \"\"\"\n def setDisplayWindow(self, x: float, y: float, w: float, h: float) -> None:\n \"\"\"\n\n setDisplayWindow(self, x, y, w, h)\n\n Set the area in pixels that're framed by the Image space conversion.\n\n This requires a writable layer.\n\n\n \"\"\"\n def setPixelAspectRatio(self, aspect: float) -> None:\n \"\"\"\n\n setPixelAspectRatio(self, aspect)\n\n Set the ratio between pixel space and image space.\n\n This requires a writable layer.\n\n\n \"\"\"\n def setPixelScale(self, scale: Sequence[float]) -> None:\n \"\"\"\n\n setPixelScale(self, scale)\n\n Set the scaling between buffer space and pixel space.\n\n This requires a writable layer.\n\n\n \"\"\"\n def projection(self) -> EnumValue:\n \"\"\"\n\n projection(self) -> hou.imageLayerProjection\n\n Returns the style of projection performed by the layer's implicit\n camera.\n\n\n \"\"\"\n def aperture(self) -> float:\n \"\"\"\n\n aperture(self) -> float\n\n Returns the width of the camera aperture, nominally in mm, but most\n importantly in the same units as focalLength.\n\n\n \"\"\"\n def focalLength(self) -> float:\n \"\"\"\n\n focalLength(self) -> float\n\n Returns the focal length of the camera, nominally in mm, but most\n importantly in the same units as aperture.\n\n\n \"\"\"\n def cameraPosition(self) -> Tuple[float, ...]:\n \"\"\"\n\n cameraPosition(self) -> tuple of float\n\n The location of the projection point of the camera as measured from\n the center of image space.\n\n\n \"\"\"\n def fStop(self) -> float:\n \"\"\"\n\n fStop(self) -> float\n\n The camera's FStop.\n\n\n \"\"\"\n def clippingRange(self) -> Tuple[float, ...]:\n \"\"\"\n\n clippingRange(self) -> tuple of float\n\n The clipping range of the layer's camera.\n\n\n \"\"\"\n def focusDistance(self) -> float:\n \"\"\"\n\n focusDistance(self) -> float\n\n The location of the focus plane of the camera.\n\n\n \"\"\"\n def shutter(self) -> Tuple[float, ...]:\n \"\"\"\n\n shutter(self) -> tuple of float\n\n The duration of the camera's shutter. This is measured relative to a\n nominal zero point.\n\n\n \"\"\"\n def setProjection(self, projection: EnumValue) -> None:\n \"\"\"\n\n setProjection(self, projection)\n\n Change the projection type of the camera.\n\n\n \"\"\"\n def setAperture(self, aperture: float) -> None:\n \"\"\"\n\n setAperture(self, aperture)\n\n Set the camera's aperture.\n\n\n \"\"\"\n def setFocalLength(self, focal: float) -> None:\n \"\"\"\n\n setFocalLength(self, focal)\n\n Set the camera's focal length.\n\n\n \"\"\"\n def setCameraPosition(self, pos: Sequence[float]) -> None:\n \"\"\"\n\n setCameraPosition(self, pos)\n\n Adjust the position of the focus point of the camera, as measured in\n the image space of the layer.\n\n\n \"\"\"\n def setFStop(self, fstop: float) -> None:\n \"\"\"\n\n setFStop(self, fstop)\n\n Set the camera's FStop.\n\n\n \"\"\"\n def setClippingRange(self, range: Sequence[float]) -> None:\n \"\"\"\n\n setClippingRange(self, range)\n\n Set the camera's near/far clipping range.\n\n\n \"\"\"\n def setFocusDistance(self, focus: float) -> None:\n \"\"\"\n\n setFocusDistance(self, focus)\n\n Set the camera's focus distance.\n\n\n \"\"\"\n def setShutter(self, shutter: Sequence[float]) -> None:\n \"\"\"\n\n setShutter(self, shutter)\n\n Set the camera's shutter.\n\n\n \"\"\"\n def projectionTransform(self) -> Matrix4:\n \"\"\"\n\n projectionTransform(self) -> hou.Matrix4\n\n Compute the transform from world space to image space, including the\n camera's projection.\n\n\n \"\"\"\n def imageToWorldTransform(self) -> Matrix4:\n \"\"\"\n\n imageToWorldTransform(self) -> hou.Matrix4\n\n Compute the non-projective transform from image space to world\n space.\n\n\n \"\"\"\n def imageToPixelScale(self) -> Tuple[float, ...]:\n \"\"\"\n\n imageToPixelScale(self) -> tuple of float\n\n Return the scale factor from image space to pixel space.\n\n\n \"\"\"\n def imageToPixelTranslate(self) -> Tuple[float, ...]:\n \"\"\"\n\n imageToPixelTranslate(self) -> tuple of float\n\n Return the offset from image space to pixel space.\n\n\n \"\"\"\n def imageToBufferScale(self) -> Tuple[float, ...]:\n \"\"\"\n\n imageToBufferScale(self) -> tuple of float\n\n Return the scale factor from image space to buffer space.\n\n\n \"\"\"\n def imageToBufferTranslate(self) -> Tuple[float, ...]:\n \"\"\"\n\n imageToBufferTranslate(self) -> tuple of float\n\n Return the offset from image space to buffer space.\n\n\n \"\"\"\n def bufferToPixelScale(self) -> Tuple[float, ...]:\n \"\"\"\n\n bufferToPixelScale(self) -> tuple of float\n\n Return the scale factor from buffer space to pixel space.\n\n\n \"\"\"\n def bufferToPixelTranslate(self) -> Tuple[float, ...]:\n \"\"\"\n\n bufferToPixelTranslate(self) -> tuple of float\n\n Return the offset from buffer space to pixel space.\n\n\n \"\"\"\n def textureToBufferScale(self) -> Tuple[float, ...]:\n \"\"\"\n\n textureToBufferScale(self) -> tuple of float\n\n Return the scale factor from texture space to buffer space.\n\n\n \"\"\"\n def imageToPixel(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n imageToPixel(self, p) -> tuple of float\n\n Convert a 2-tuple from image space to pixel space.\n\n\n \"\"\"\n def imageToBuffer(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n imageToBuffer(self, p) -> tuple of float\n\n Convert a 2-tuple from image space to buffer space.\n\n\n \"\"\"\n def imageToTexture(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n imageToTexture(self, p) -> tuple of float\n\n Convert a 2-tuple from image space to texture space.\n\n\n \"\"\"\n def pixelToImage(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n pixelToImage(self, p) -> tuple of float\n\n Convert a 2-tuple from pixel space to image space.\n\n\n \"\"\"\n def pixelToBuffer(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n pixelToBuffer(self, p) -> tuple of float\n\n Convert a 2-tuple from pixel space to buffer space.\n\n\n \"\"\"\n def pixelToTexture(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n pixelToTexture(self, p) -> tuple of float\n\n Convert a 2-tuple from pixel space to texture space.\n\n\n \"\"\"\n def bufferToPixel(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n bufferToPixel(self, p) -> tuple of float\n\n Convert a 2-tuple from buffer space to pixel space.\n\n\n \"\"\"\n def bufferToImage(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n bufferToImage(self, p) -> tuple of float\n\n Convert a 2-tuple from buffer space to image space.\n\n\n \"\"\"\n def bufferToTexture(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n bufferToTexture(self, p) -> tuple of float\n\n Convert a 2-tuple from buffer space to texture space.\n\n\n \"\"\"\n def textureToPixel(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n textureToPixel(self, p) -> tuple of float\n\n Convert a 2-tuple from texture space to pixel space.\n\n\n \"\"\"\n def textureToImage(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n textureToImage(self, p) -> tuple of float\n\n Convert a 2-tuple from texture space to image space.\n\n\n \"\"\"\n def textureToBuffer(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n textureToBuffer(self, p) -> tuple of float\n\n Convert a 2-tuple from texture space to buffer space.\n\n\n \"\"\"\n def worldToBuffer(self, p: Sequence[float]) -> Tuple[float, ...]:\n \"\"\"\n\n worldToBuffer(self, p) -> tuple of float\n\n Convert a 3-tuple from world space to buffer space.\n\n\n \"\"\"\n def bufferIndexV4(self, x: int, y: int) -> Tuple[float, ...]:\n \"\"\"\n\n bufferIndexV4(self, int x, int y) -> tuple of float\n\n Returns a layer's RGBA value at the buffer coordinate (x, y).\n\n\n \"\"\"\n def bufferIndexI(self, x: int, y: int) -> int:\n \"\"\"\n\n bufferIndexI(self, int x, int y) -> int\n\n Returns an integer layer's value at the buffer coordinate (x, y).\n\n\n \"\"\"\n def bufferIndex(self, x: int, y: int) -> Any:\n \"\"\"\n\n bufferIndex(self, int x, int y) -> tuple of float | float | int\n\n Returns a layer's value at the buffer coordinate (x, y). The return\n type corresponds to the layer type, for example a mono layer returns\n a single float value.\n\n\n \"\"\"\n def bufferIndexRaw(self, x: int, y: int) -> bytes:\n \"\"\"\n\n bufferIndexRaw(self, int x, int y) -> bytes\n\n Returns a layer's raw bytes at the buffer coordinate (x, y).\n\n\n \"\"\"\n def freeze(self) -> Optional[ImageLayer]:\n \"\"\"\n\n freeze(self) -> hou.ImageLayer\n\n Create a writable copy of this and return it.\n\n\n NOTE\n The actual buffer duplication won't be done until a write is\n performed.\n\n\n \"\"\"\n def isFrozen(self) -> bool:\n \"\"\"\n\n isFrozen(self) -> bool\n\n Returns if this is frozen, and hence writable.\n\n\n \"\"\"\n def attributes(self) -> dict[str, Any]:\n \"\"\"\n\n attributes(self) -> dict\n\n Returns the layer attributes present on this layer.\n\n\n \"\"\"\n def setAttributes(self, p: dict[str, Any]) -> None:\n \"\"\"\n\n setAttributes(self, p)\n\n Replaces the layer attributes with the provided dictionary.\n\n\n \"\"\"\n def updateAttributes(self, p: dict[str, Any]) -> None:\n \"\"\"\n\n updateAttributes(self, p)\n\n Updates the layer attributes with the provided dictionary, replacing\n any matching keys.\n\n\n \"\"\"\n def allBufferElements(self, *args) -> bytes:\n \"\"\"\n\n allBufferElements(self, storagetype, channels) -> hou.BinaryString\n\n Return all the buffer elements as a binary string. This can then be\n effeciently re-interpreted and handled by numpy or tensor packages.\n The number of elements is the same as the bufferResolution. The bit\n depth and channels returned will match those provided, a conversion\n will be performed just-in-time if they differ from the internal\n layout.\n\n\n \"\"\"\n def setAllBufferElements(self, *args) -> None:\n \"\"\"\n\n setAllBufferElements(self, values, length)\n\n Take a binary string in values and replace all of the buffer\n elements of this layer with them. The binary string must have a\n number of elements matching the bufferResolution and be of the same\n storagetype and channels as this layer.\n\n\n \"\"\"\n\nclass IndexPairPropertyTable:\n \"\"\"\n\n hou.IndexPairPropertyTable\n\n Describes properties of an index pair attribute.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def attrib(self) -> Attrib:\n \"\"\"\n\n attrib(self) -> hou.Attrib\n\n Return the parent index pair attribute.\n\n\n \"\"\"\n def numIndices(self) -> int: ...\n def propertyNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n propertyNames(self) -> tuple of string\n\n Return a list of all property names.\n\n\n \"\"\"\n def propertyDataType(self, prop_name: str) -> EnumValue:\n \"\"\"\n\n propertyDataType(self, property_name) -> hou.attribData enum value\n\n Return the property's data type (int, float or string).\n\n\n \"\"\"\n def propertySize(self, prop_name: str) -> int:\n \"\"\"\n\n propertySize(self, property_name) -> int\n\n Return the number of data components in the property value.\n\n\n \"\"\"\n def floatPropertyValueAtIndex(self, prop_name: str, idx: int) -> float:\n \"\"\"\n\n floatPropertyValueAtIndex(self, property_name, row) -> float\n\n Return the property value for a particular floating point property.\n\n Raises hou.OperationFailed if no property exists with this name or\n the property is not float of size 1.\n\n\n \"\"\"\n def floatListPropertyValueAtIndex(self, prop_name: str, idx: int) -> Tuple[float, ...]:\n \"\"\"\n\n floatListPropertyValueAtIndex(self, property_name, row) -> tuple of\n float\n\n Return a list of property values for a particular floating point\n property.\n\n Raises hou.OperationFailed if no property exists with this name.\n\n\n \"\"\"\n def intPropertyValueAtIndex(self, prop_name: str, idx: int) -> int:\n \"\"\"\n\n intPropertyValueAtIndex(self, property_name, row) -> int\n\n Return the property value for a particular integer property.\n\n Raises hou.OperationFailed if no property exists with this name or\n the property is not integer of size 1.\n\n\n \"\"\"\n def intListPropertyValueAtIndex(self, prop_name: str, idx: int) -> Tuple[int, ...]:\n \"\"\"\n\n intListPropertyValueAtIndex(self, property_name, row) -> tuple of int\n\n Return a list of property values for a particular integer property.\n\n Raises hou.OperationFailed if no property exists with this name.\n\n\n \"\"\"\n def stringPropertyValueAtIndex(self, prop_name: str, idx: int) -> str:\n \"\"\"\n\n stringPropertyValueAtIndex(self, property_name, row) -> string\n\n Return the property value for a particular string property.\n\n Raises hou.OperationFailed if no property exists with this name or\n the property is not string of size 1.\n\n\n \"\"\"\n def stringListPropertyValueAtIndex(self, prop_name: str, idx: int) -> Tuple[str, ...]:\n \"\"\"\n\n stringListPropertyValueAtIndex(self, property_name, row) -> tuple of\n string\n\n Return a list of property values for a particular string property.\n\n Raises hou.OperationFailed if no property exists with this name.\n\n\n \"\"\"\n\nclass IndirectInput(NetworkMovableItem):\n \"\"\"\n\n hou.IndirectInput\n\n An abstract base class for a network item that can be used as an input\n to nodes in the same network, but which is not a node itself.\n\n There are two specific forms of an indirect input. The\n hou.SubnetIndirectInput provides a way to connect nodes outside a sub-\n network to nodes inside the sub-network. The hou.NetworkDot allows\n connections to be routed through a network along any path.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def outputs(self) -> Tuple[Node, ...]:\n \"\"\"\n\n outputConnections(self) -> tuple of hou.NodeConnection\n\n Return a tuple of objects representing each connection to a node\n from the output of this object. The objects returned by this method\n allow you to discover not just which nodes are connected to this\n object, but which inputs it feeds into.\n\n\n \"\"\"\n def outputConnections(self) -> Tuple[NodeConnection, ...]: ...\n def input(self) -> Optional[Node]: ...\n def inputOutputIndex(self) -> int: ...\n def inputItem(self) -> Optional[NetworkMovableItem]:\n \"\"\"\n\n inputItem(self) -> hou.NetworkMovableItem\n\n Returns the item connected directly to the input side of this\n indirect input. This may be a node, indirect input, or None if\n nothing is connected. Note that the returned item may not be inside\n the same parent network as this object if it is a\n hou.SubnetIndirectInput.\n\n\n \"\"\"\n def inputItemOutputIndex(self) -> int:\n \"\"\"\n\n inputItemOutputIndex(self) -> int\n\n Returns the index of the output connection on the network item\n connected directly to the input side of this object. Returns 0 if\n nothing is connected. This value will only be non-zero if a hou.Node\n is connected to this object since all other network items only has a\n single output connector.\n\n\n \"\"\"\n def setColorDefault(self) -> None:\n \"\"\"\n\n setColorDefault(self)\n\n Sets the color of this object to be the default for indirect inputs.\n By explicitly setting to the default color, any future changes to\n the default indirect input color will cause this object to use the\n new color. This method clears the symbolicColorName setting and the\n useColorFromOutput setting.\n\n\n \"\"\"\n def setUseColorFromOutput(self, use_output_color: bool) -> None:\n \"\"\"\n\n setUseColorFromOutput(self, use_output_color)\n\n Set this indirect input to display itself with the same color as the\n first input connector connected as an output to this object. If set\n to False, this object is displayed with its color returned by the\n hou.NetworkMovableItem.setColor method. This method clears the\n symbolicColorName setting, and causes the color value to be ignored.\n\n\n \"\"\"\n def useColorFromOutput(self) -> bool:\n \"\"\"\n\n useColorFromOutput(self) -> bool\n\n Return True if this object will be displayed based on the color of\n the first input to which it is connected. Return False if will be\n displayed using the color return by the hou.NetworkMovableItem.color\n method.\n\n\n \"\"\"\n def setSymbolicColorName(self, name: str) -> None:\n \"\"\"\n\n setSymbolicColorName(self, name)\n\n Sets the color of this object to use a symbolic color name defined\n in the current Houdini color scheme (see hou.ui.colorByName). The\n symbolic color name will be saved with the hip file so that changes\n to the color scheme will result in a new color being used for this\n object. This method clears the useColorFromDefault setting, and\n causes the color value to be ignored.\n\n\n \"\"\"\n def symbolicColorName(self) -> str:\n \"\"\"\n\n symbolicColorName(self) -> str\n\n Return the symbolic color name used to display this object, set with\n the setSymbolicColorName method. Returns an empty string if the\n color of this object was set using the setUseColorFromOutput or\n hou.NetworkMovableItem.setColor methods. The symbolic color name can\n be converted to a hou.Color using hou.ui.colorFromName.\n\n\n \"\"\"\n\nclass OpIndirectInput(IndirectInput):\n \"\"\"\n\n hou.OpIndirectInput\n\n An abstract base class for an indirect input in an OP network.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n\nclass InterruptableOperation:\n '''\n\n hou.InterruptableOperation\n\n Use this class to turn any Python code block into an interruptable\n operation.\n\n This class is a context manager which allows the user to press [Esc] to\n interrupt a long-running operation, and can also display a progress\n percentage in the status line at the bottom of the main window.\n\n You should use this in potentially long-running Python nodes (such as\n Python SOP) or shelf scripts. For example if you have code looping over\n every point in the input geometry, if the geometry has millions of\n points the operation could take a long time. You should perform the\n operation inside a hou.InterruptableOperation block so the user can\n interrupt it, and so you can display progress.\n\n Important: The script only checks if the user has pressed Escape when\n you call the context object\\'s updateProgress() method. So you need to\n add calls to updateProgress() in the block, usually at the start of each\n iteration of a loop (even if you don\\'t provide a progress fraction).\n\n (Calling updateProgress() also gives Houdini a chance to respond to\n events, so it doesn\\'t appear to be non-responsive to the operating\n system. For example, regularly calling updateProgress() prevents macOS\n from showing the beachball cursor.)\n\n If the user interrupts the operation, the context block will exit with a\n hou.OperationInterrupted exception. However, you may not want to catch\n the exception in your script.\n\n * If you don\\'t catch the hou.OperationInterrupted exception in a shelf\n tool, the tool script will simply stop and Houdini will not display\n the exception to the user. If your script doesn\\'t require any\n cleanup, this is usually what the user would expect.\n\n * If you don\\'t catch the exception in a Python node (for example, a\n Python SOP), Houdini will automatically display an error on the node\n (with the error text Cooking was interrupted). Again, this is\n typical of how nodes deal with long-running operations being\n interrupted.\n\n To try this object out, you can create a shelf tool and paste the\n following into the tool script:\n\n > import time\n > import hou\n > \n > try:\n > with hou.InterruptableOperation(\\\\\"Waiting around doing nothing\\\\\") as iop:\n > for i in range(100):\n > # Real work would go here, instead we\\'ll just go to sleep\n > time.sleep(0.1)\n > # In a loop or series of steps, call updateProgress() on\n > # the context object to check for interruption. You can optionally\n > # pass a fraction to let the user know how much is done.\n > # (The first argument is called \\\\\"percentage\\\\\" but it actually takes\n > # a fraction.)\n > iop.updateProgress(i / 100)\n > except hou.OperationInterrupted:\n > # The user pressed Esc (or the operation timed out if you used the\n > # timeout_ms argument)\n > hou.ui.displayMessage(\\\\\"Interrupted\\\\\")\n > else:\n > # The operation finished without interruption\n > hou.ui.displayMessage(\\\\\"Completed\\\\\")\n\n NESTED OPERATIONS\n\n You can nest multiple interruptable operations. For example:\n\n > # Start the overall, long operation.\n > with hou.InterruptableOperation(\\\\\"Beginning operation\\\\\",\n > \\\\\"Performing a Long Operation\\\\\",\n > open_interrupt_dialog=True) as iop:\n > for i in range(num_tasks):\n > # Update overall progress\n > operation.updateLongProgress(i / num_tasks)\n > \n > # Start the sub-operation\n > with hou.InterruptableOperation(f\\\\\"Performing Task {i + 1}\\\\\") as sub_iop:\n > for j in range(num_subtasks):\n > # Update sub-operation progress\n > sub_iop.updateProgress(j / num_subtasks)\n > \n > #\n > # PERFORM SUBTASK HERE.\n > #\n\n TIMING OUT OPERATIONS\n\n You can use the timeout_ms argument when you create the context\n object to limit the amount of time an operation can take.\n\n * Hitting the time limit raises hou.OperationInterrupted, just like\n the user pressing [Esc].\n\n * Just like the user pressing [Esc], the timeout is usually only\n checked when you call the updateProgress() method, so you need to\n call the method regularly inside the block.\n\n Some HOM functions may internally update progress, which can\n also trigger a check of the timeout. For example, you can wrap a\n call to LopNode.stagePrimStats() in a hou.InterruptableOperation\n block with a timeout, and the timeout will interrupt\n stagePrimStats() because internally stagePrimStats() updates\n Houdini as it works.\n\n For example, this modified version of the example would normally run\n for 10 seconds, but will display Interrupted after 1 second because\n of the timeout_ms=1000 argument:\n\n > import time\n > import hou\n > \n > try:\n > with hou.InterruptableOperation(\\\\\"Waiting around doing nothing\\\\\",\n > timeout_ms=1000) as iop:\n > for i in range(100):\n > # Real work would go here, instead we\\'ll just go to sleep\n > time.sleep(0.1)\n > iop.updateProgress(i / 100)\n > except hou.OperationInterrupted:\n > # The user pressed Esc (or the operation timed out if you used the\n > # timeout_ms argument)\n > hou.ui.displayMessage(\\\\\"Interrupted\\\\\")\n > else:\n > # The operation finished without interruption\n > hou.ui.displayMessage(\\\\\"Completed\\\\\")\n\n TIPS AND NOTES\n\n * By default, Houdini only shows the progress as text in the status\n line. If you pass open_interrupt_dialog=True when you create the\n object, Houdini will open a progress dialog that shows progress\n using a progress bar. You should generally open a dialog if the\n operation could take more than one or two seconds.\n\n * The call to updateProgress() takes a small amount of time that can\n add up. Inside tight loops you may want to only call it, for\n example, every 10th iteration instead of every iteration.\n\n * hou.InterruptableOperation` does not work in the Python Shell. If\n you just want to try it out, use a shelf tool.\n\n * Houdini may not display every progress update in the status bar. It\n updates the status bar on its own schedule for performance reasons.\n\n * Trying to create this object outside of a with statement will raise\n hou.OperationFailed.\n\n\n '''\n thisown: Incomplete\n def __init__(self, operation_name: str, long_operation_name: Optional[str] = None, open_interrupt_dialog: bool = False, timeout_ms: int = 0) -> None:\n \"\"\"\n\n __init__(self, operation_name, long_operation_name=None,\n open_interrupt_dialog=False, timeout_ms=0)\n\n Construct a new InterruptableOperation.\n\n\n operation_name\n A description of the interruptable operation that appears in the\n progress bar of the interrupt dialog.\n\n long_operation_name\n A description of the long, or higher-level, operation. If it is\n not None, a second progress bar appears on the interrupt dialog\n with the long operation name in it.\n\n open_interrupt_dialog\n Determines whether the interrupt dialog should appear or not.\n\n timeout_ms\n An integer value specifying the number of milliseconds an\n operation is allowed to spend before automatically being\n interrupted. The timeout is only checked when the progress is\n updated using the updateProgress or updateLongProgress methods\n (or the C++ equivalents when invoking native Houdini methods).\n Timeouts cannot be nested. A timeout set on an inner operation,\n after an outer operation already has a timeout, will be ignored.\n\n An interrupt triggered due to a timeout is treated exactly like\n an interrupt triggered by the user, and so may cause nodes to\n enter an interrupted error state. If you wish to avoid this\n situation, be sure to cook any nodes whose data may be required\n before starting the interruptable operation with the timeout.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def updateLongProgress(self, percentage: float = -1.0, long_op_status: Optional[str] = None) -> None:\n \"\"\"\n\n updateLongProgress(self, percentage=-1.0, long_op_status=None)\n\n Update the progress percentage and status of the long, or high-\n level, operation. At the same time, check if the operation was\n interrupted by the user.\n\n\n percentage\n Despite the name, this argument takes a fraction from 0.0 to\n 1.0, not a percentage. If this number is negative, Houdini will\n not display the progress.\n\n long_op_status\n Text describing the current status of the long operation, if\n there is one. If pass a value for this argument, it overwrites\n the text in the 2nd progress bar of the interrupt dialog.\n\n\n \"\"\"\n def updateProgress(self, percentage: float = -1.0) -> None:\n \"\"\"\n\n updateProgress(self, percentage=-1.0)\n\n Update the progress percentage of the operation. At the same time,\n check if the operation was interrupted by the user.\n\n\n percentage\n Despite the name, this argument takes a fraction from 0.0 to\n 1.0, not a percentage. If this number is negative, Houdini will\n not display the progress.\n\n\n \"\"\"\n def __enter__(self) -> InterruptableOperation: ...\n def __exit__(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None: ...\n\nclass IntParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.IntParmTemplate\n\n Describes a parameter tuple containing integer values.\n\n Note that integer parameters may also be menu parameters. Integer\n parameters with menus are conceptually the same as parameters derived\n from hou.MenuParmTemplate.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, num_components: int, default_value: Sequence[int] = ..., min: int = ..., max: int = ..., min_is_strict=..., max_is_strict: bool = ..., look: EnumValue = ..., naming_scheme: EnumValue = ..., menu_items: Sequence[str] = ..., menu_labels: Sequence[str] = ..., icon_names: Sequence[str] = ..., item_generator_script: str|None = ..., item_generator_script_language: EnumValue|None = ..., menu_type: EnumValue = ..., disable_when: str|None = ..., is_hidden: bool = ..., is_label_hidden: bool = ..., join_with_next: bool = ..., help: str|None = ..., script_callback: str|None = ..., script_callback_language: EnumValue = ..., tags: Mapping[str, str] = ..., default_expression: Sequence[str] = ..., default_expression_language: Sequence[str] = ...) -> None:\n \"\"\"\n\n __init__(self, name, label, num_components, default_value=(), min=0,\n max=10, min_is_strict=False, max_is_strict=False,\n look=hou.parmLook.Regular, naming_scheme=hou.parmNamingScheme.XYZW,\n menu_items=(), menu_labels=(), icon_names=(),\n item_generator_script=None, item_generator_script_language=None,\n menu_type=hou.menuType.Normal, disable_when=None, is_hidden=False,\n is_label_hidden=False, join_with_next=False, help=None,\n script_callback=None,\n script_callback_language=hou.scriptLanguage.Hscript, tags={},\n default_expression=(), default_expression_language=())\n\n Construct a new IntParmTemplate.\n\n\n name\n See hou.ParmTemplate.name for more information.\n\n label\n See hou.ParmTemplate.label for more information.\n\n num_components\n See hou.ParmTemplate.numComponents for more information.\n\n default_value\n See the defaultValue method for more information.\n\n min\n See the minValue method for more information.\n\n max\n See the maxValue method for more information.\n\n min_is_strict\n See the minIsStrict method for more information.\n\n max_is_strict\n See the maxIsStrict method for more information.\n\n look\n See hou.ParmTemplate.look for more information.\n\n naming_scheme\n See hou.ParmTemplate.namingScheme for more information.\n\n menu_items\n See the menuItems method for more information. Note that\n num_components must be 1 if menu items are supplied.\n\n menu_labels\n See the menuLabels method for more information.\n\n If this parameter is not given, it defaults to the value of the\n menu_items parameter.\n\n icon_names\n See the iconNames method for more information.\n\n If this parameter is an empty tuple, the menu will not contain\n icons.\n\n item_generator_script\n See the itemGeneratorScript method for more information. Note\n that num_components must be 1 if a script is given.\n\n item_generator_script_language\n See the itemGeneratorScriptLanguage method for more information.\n If this parameter is None it defaults to\n hou.scriptLanguage.Python.\n\n menu_type\n See the menuType method for more information.\n\n disable_when\n See hou.ParmTemplate.disableWhen for more information.\n\n is_hidden\n See hou.ParmTemplate.isHidden for more information.\n\n is_label_hidden\n See hou.ParmTemplate.isLabelHidden for more information.\n\n join_with_next\n See hou.ParmTemplate.joinsWithNext for more information.\n\n help\n See hou.ParmTemplate.help for more information.\n\n script_callback\n See hou.ParmTemplate.scriptCallback for more information.\n\n script_callback_language\n See hou.ParmTemplate.scriptCallbackLanguage for more\n information.\n\n tags\n See hou.ParmTemplate.tags for more information.\n\n default_expression\n See the defaultExpression method for more information.\n\n default_expression_language\n See the defaultExpressionLanguage method for more information.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def minValue(self) -> int:\n \"\"\"\n\n minValue(self) -> int\n\n Return the minimum value of the parameter.\n\n See also the minIsStrict method.\n\n\n \"\"\"\n def setMinValue(self, min_value: int) -> None:\n \"\"\"\n\n setMinValue(self, min_value)\n\n Set the minimum value of the parameter.\n\n See the minValue method for more information.\n\n\n \"\"\"\n def maxValue(self) -> int:\n \"\"\"\n\n maxValue(self) -> int\n\n Return the minimum value of the parameter.\n\n See also the minIsStrict method.\n\n\n \"\"\"\n def setMaxValue(self, max_value: int) -> None:\n \"\"\"\n\n setMaxValue(self, max_value)\n\n Set the maximum value of the parameter.\n\n See the maxValue method for more information.\n\n\n \"\"\"\n def minIsStrict(self) -> bool:\n \"\"\"\n\n minIsStrict(self) -> bool\n\n Returns whether the minimum value is strictly enforced.\n\n If a minimum value is not strictly enforced, the slider will not let\n you change the value below the minimum, but you can set the value to\n be lower than the minimum by typing it in, changing it via\n hou.Parm.setValue, or using the ladder handle.\n\n If it is strictly enforced and you try to change it below the\n minimum value using any mechanism, Houdini will set it to the\n minimum value.\n\n See also the minValue method.\n\n\n \"\"\"\n def setMinIsStrict(self, on: bool) -> None:\n \"\"\"\n\n setMinIsStrict(self, on)\n\n Set whether the minimum value is strictly enforced.\n\n See the minIsStrict method for more information.\n\n\n \"\"\"\n def maxIsStrict(self) -> bool:\n \"\"\"\n\n maxIsStrict(self) -> bool\n\n Return whether the maximum value is strictly enforced.\n\n See the minIsStrict method for more information.\n\n\n \"\"\"\n def setMaxIsStrict(self, on: bool) -> None:\n \"\"\"\n\n setMaxIsStrict(self, on)\n\n Set whether the maximum value is strictly enforced.\n\n See the maxIsStrict method for more information.\n\n\n \"\"\"\n def defaultValue(self) -> Tuple[int, ...]:\n \"\"\"\n\n defaultValue(self) -> tuple of int\n\n Return the default value for new parameter instances.\n\n For example, suppose this parm template is named divisions, the\n naming scheme is XYZW, it has 3 components, and the default value is\n (10, 20, 30). The corresponding parm tuple instance on a node would\n be named divisions and would contain parameters divisionsx,\n divisionsy, and divisionsz. When the node is created, divisionsx\n would be 10, divisionsy would be 20, and divisionsz would be 30.\n\n\n \"\"\"\n def setDefaultValue(self, default_value: Sequence[int]) -> None:\n \"\"\"\n\n setDefaultValue(self, tuple_of_default_values)\n\n Set the default value for new parameter instances to a sequence of\n ints.\n\n See the defaultValue method for more information. Note that if the\n number of ints in the sequence is different from the number of\n components in the parm template, any extra values will be discarded\n and any missing values will become zeros.\n\n\n \"\"\"\n def defaultExpression(self) -> Tuple[str, ...]:\n \"\"\"\n\n defaultExpression(self) -> tuple of strings\n\n Return the default expression for new parameter instances.\n\n The default expression takes precedence over the default value. If a\n component has no default expression (i.e. an empty string), then the\n default value is used for new parameter instances.\n\n Note that the default expression language is needed to interpret the\n meaning of the default expression.\n\n For example, suppose this parm template is named divisions, the\n naming scheme is XYZW, it has 3 components, the default value is\n (10, 20, 30), the default expression is ($F, hou.frame(), ) and the\n default expression language is (hou.scriptLanguage.Hscript,\n hou.scriptLanguage.Python, hou.scriptLanguage.Hscript). Then the\n corresponding parm tuple instance on a node would be named divisions\n and would contain parameters divisionsx, divisionsy, divisionsz.\n When the node is created, divisionsx would have a default Hscript\n expression of $F, divisionsy would have a default Python expression\n of hou.frame(), and divisionsz would have a default value of 30.\n\n\n \"\"\"\n def setDefaultExpression(self, default_expression: Sequence[str]) -> None:\n \"\"\"\n\n setDefaultExpression(self, tuple_of_default_expressions)\n\n Set the default expression for new parameter instances to a sequence\n of strings.\n\n See the hou.IntParmTemplate.defaultExpression method for more\n information. Note that if the number of strings in the sequence is\n different from the number of components in the parm template, any\n extra values will be discarded and any missing expressions will\n become the empty string.\n\n\n \"\"\"\n def defaultExpressionLanguage(self) -> Tuple[EnumValue, ...]:\n \"\"\"\n\n defaultExpressionLanguage(self) -> tuple of hou.scriptLanguage\n\n Return the default expression language for new parameter instances.\n\n The default expression language only applies if the default\n expression is set. If the default expression of a component is not\n set, then the expression language is set to\n hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n def setDefaultExpressionLanguage(self, default_expression_language: Sequence[EnumValue]) -> None:\n \"\"\"\n\n setDefaultExpressionLanguage(self,\n tuple_of_default_expression_languages)\n\n Set the default expression language for new parameter instances to a\n sequence of hou.scriptLanguage values.\n\n See the defaultExpressionLanguage method for more information. Note\n that if the number of hou.scriptLanguage values in the sequence is\n different from the number of components in the parm template, any\n extra values will be discarded and any missing expression languages\n will become hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n def menuItems(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuItems(self) -> tuple of str\n\n Return the tuple of internal menu names. If this integer does not\n use a menu, returns an empty tuple.\n\n These internal menu names are not displayed in the UI, but they can\n be passed to hou.Parm.set.\n\n\n \"\"\"\n def setMenuItems(self, menu_items: Sequence[str]) -> None:\n \"\"\"\n\n setMenuItems(self, menu_items)\n\n Set the internal menu names to the given sequence of strings.\n\n See the menuItems method for more information.\n\n If the new number of menu items is less than the old number, the\n menu labels will be shortened and the default value will be modified\n if it is out of range.\n\n\n \"\"\"\n def menuLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuLabels(self) -> tuple of str\n\n Return the tuple of menu labels displayed in the UI. These labels\n are used when this parm template uses a menu.\n\n\n \"\"\"\n def setMenuLabels(self, menu_labels: Sequence[str]) -> None:\n \"\"\"\n\n setMenuLabels(self, menu_labels)\n\n Set the menu labels displayed in the UI to the given sequence of\n strings.\n\n If the number of menu labels is less than the number of menu items,\n Houdini uses the internal menu item names for the missing labels. If\n the number of labels is more than the number of menu items, Houdini\n discards the extra labels.\n\n If you want to change both the menu items and menu labels, be sure\n to change the menu items first.\n\n\n \"\"\"\n def iconNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n iconNames(self) -> tuple of str\n\n Return the tuple of icons corresponding to the menu items. If there\n are no icons, returns a tuple of empty strings.\n\n These icons are used when this parm template uses a menu.\n\n\n \"\"\"\n def setIconNames(self, icon_names: Sequence[str]) -> None:\n \"\"\"\n\n setIconNames(self, icon_names)\n\n Set the icon names to the given sequence of strings.\n\n\n \"\"\"\n def itemGeneratorScript(self) -> str:\n \"\"\"\n\n itemGeneratorScriptLanguage(self) -> hou.scriptLanguage enum value\n\n Return the script used to generate menu items, or an empty string if\n there is no such script.\n\n\n \"\"\"\n def setItemGeneratorScript(self, item_generator_script: str) -> None:\n \"\"\"\n\n setItemGeneratorScript(self, item_generator_script)\n\n Set the script used to generate menu items.\n\n See the itemGeneratorScript method for more information.\n\n\n \"\"\"\n def itemGeneratorScriptLanguage(self) -> EnumValue: ...\n def setItemGeneratorScriptLanguage(self, language: EnumValue) -> None:\n \"\"\"\n\n setItemGeneratorScriptLanguage(self, language)\n\n Set the script language used to generate menu items to a\n hou.scriptLanguage enum value.\n\n See the itemGeneratorScriptLanguage method for more information.\n\n\n \"\"\"\n def menuType(self) -> EnumValue:\n \"\"\"\n\n menuType(self) -> hou.menuType enum value\n\n Return the type of menu. See hou.menuType for more information.\n\n\n \"\"\"\n def setMenuType(self, menu_type: EnumValue) -> None:\n \"\"\"\n\n setMenuType(self, menu_type)\n\n Set the type of menu to a hou.menuType enum value.\n\n See the menuType method for more information.\n\n\n \"\"\"\n def menuUseToken(self) -> bool:\n \"\"\"\n\n menuUseToken(self) -> bool\n\n Return whether the parameter is set to the token value instead of\n the index.\n\n See also the setMenuUseToken method.\n\n\n \"\"\"\n def setMenuUseToken(self, menuusetoken: bool) -> None:\n \"\"\"\n\n setMenuUseToken(self, on)\n\n Set whether the parameter is set to the token value instead of the\n index.\n\n See also the menuUseToken method.\n\n\n \"\"\"\n\nclass IPRViewer(PaneTab):\n \"\"\"\n\n hou.IPRViewer\n\n An interactive preview render (IPR) window.\n\n The IPR viewer progressively refines a render, first providing a rough\n view of the rendered image and eventually providing the fully rendered\n image. When you change a shader value, move an object, etc., the viewer\n will re-render the image.\n\n When you Ctrl+click on a pixel in the rendered image, Houdini searches\n $HOUDINI_PATH for scripts/ipr/pickpixel.py and runs it. The version of\n this file that ships with Houdini pops up the shader contributing the\n pixel, or an information window if there is is no shader. If Houdini\n cannot find that Python file it then looks for the Hscript file\n scripts/ipr/pickpixel.cmd.\n\n When you drag a SHOP node onto the rendered image, Houdini searches for\n and runs scripts/ipr/dragdrop.py. By default, this script assigns the\n SHOP to the object contributing the pixel. If it cannot find a Python\n version, Houdini then looks for scripts/ipr/dragdrop.cmd.\n\n Note that shelf scripts can access the last location the user clicked on\n with hou.IPRViewer.lastClickLocation.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isPaused(self) -> bool:\n \"\"\"\n\n isPaused(self) -> bool\n\n Indicates whether the IPR session is paused. If there is no active\n session, this returns false.\n\n\n \"\"\"\n def isRendering(self) -> bool:\n \"\"\"\n\n isRendering(self) -> bool\n\n Indicates whether the IPR session has an render in progress. Returns\n True even if the render is paused.\n\n\n \"\"\"\n def isActive(self) -> bool:\n \"\"\"\n\n isActive(self) -> bool\n\n Indicates whether an active IPR sessions exists.\n\n\n \"\"\"\n def killRender(self) -> None:\n \"\"\"\n\n killRender(self)\n\n Kills the active IPR session (if there is one).\n\n\n \"\"\"\n def pauseRender(self) -> None:\n \"\"\"\n\n pauseRender(self)\n\n Pauses the active IPR session (if there is one).\n\n\n \"\"\"\n def resumeRender(self) -> None:\n \"\"\"\n\n resumeRender(self)\n\n Resumes the active IPR session (if there is one).\n\n\n \"\"\"\n def startRender(self) -> None:\n \"\"\"\n\n startRender(self)\n\n Start a new render if there is no active IPR session or issue a re-\n render if there is one.\n\n\n \"\"\"\n def isPreviewOn(self) -> bool:\n \"\"\"\n\n isPreviewOn(self) -> bool\n\n Return whether or not the Preview checkbox is checked. When it is\n unchecked, the viewer will not progressively refine the image using\n IPR, and will instead use the rendering engine from the ROP node to\n render it.\n\n See also hou.IPRViewer.setPreview.\n\n\n \"\"\"\n def setPreview(self, on: bool) -> None:\n \"\"\"\n\n setPreview(self, on)\n\n Check or uncheck the Preview checkbox.\n\n See hou.IPRViewer.isPreviewOn for more information.\n\n\n \"\"\"\n def isAutoSaveOn(self) -> bool:\n \"\"\"\n\n isAutoSaveOn(self) -> bool\n\n Returns whether or not the Auto Save toggle is selected. When turned\n on, IPR will periodically save the render progress to the auto save\n file path. The time between saves can be configured by setting the\n auto save time.\n\n See also hou.IPRViewer.setAutoSave.\n\n\n \"\"\"\n def setAutoSave(self, on: bool) -> None:\n \"\"\"\n\n setAutoSave(self, on)\n\n Set or unset the Auto Save toggle.\n\n See hou.IPRViewer.isAutoSaveOn for more information.\n\n\n \"\"\"\n def autoSavePath(self) -> str:\n \"\"\"\n\n autoSavePath(self) -> str\n\n Returns the render save path. This is the path that is used when the\n IPR viewer is set to automatically save render progress to disk.\n\n See also hou.IPRViewer.setSavePath.\n\n\n \"\"\"\n def setAutoSavePath(self, path: str) -> None:\n \"\"\"\n\n setAutoSavePath(self, path)\n\n Sets the render progress save path.\n\n See also hou.IPRViewer.autoSavePath for more information.\n\n\n \"\"\"\n def isAutoUpdateOn(self) -> bool:\n \"\"\"\n\n isAutoUpdateOn(self) -> bool\n\n Return whether or not the Auto-Update checkbox is checked. When it\n is unchecked, the viewer will not refresh when objects, shaders,\n lights, etc. change. In this case, you can force a re-render by\n clicking on the Render button.\n\n See also hou.IPRViewer.setAutoUpdate.\n\n\n \"\"\"\n def setAutoUpdate(self, on: bool) -> None:\n \"\"\"\n\n setAutoUpdate(self, on)\n\n Check or uncheck the Auto-Update checkbox.\n\n See hou.IPRViewer.isAutoUpdateOn for more information.\n\n\n \"\"\"\n def autoSaveTime(self) -> float:\n \"\"\"\n\n autoSaveTime(self) -> float\n\n Returns the time between IPR auto saves in seconds. When auto saving\n is on, a render progress image is written out at this rate.\n\n See also hou.IPRViewer.setAutoSaveTime.\n\n\n \"\"\"\n def setAutoSaveTime(self, time: float) -> None:\n \"\"\"\n\n setAutoSaveTime(self, float)\n\n Sets the auto save time in seconds.\n\n See also hou.IPRViewer.autoSaveTime for more information.\n\n\n \"\"\"\n def delay(self) -> float:\n \"\"\"\n\n delay(self) -> float\n\n Return the contents of the viewer's Delay field. This value\n determines how long Houdini waits between when you change a\n parameter value and when it starts re-rendering.\n\n See also hou.IPRViewer.setDelay and hou.IPRViewer.updateTime.\n\n\n \"\"\"\n def setDelay(self, time: float) -> None:\n \"\"\"\n\n setDelay(self, time)\n\n Set the contents of the viewer's Delay field.\n\n See hou.IPRViewer.delay for more information.\n\n\n \"\"\"\n def updateTime(self) -> float:\n \"\"\"\n\n updateTime(self) -> float\n\n Return the contents of the viewer's Update Time field. This value\n determines approximately how long each progressive refinement should\n take. Smaller values will produce more progressive renders where\n detail is added more gradually.\n\n See also hou.IPRViewer.setUpdateTime and hou.IPRViewer.delay.\n\n\n \"\"\"\n def setUpdateTime(self, time: float) -> None:\n \"\"\"\n\n setUpdateTime(self, time)\n\n Set the contents of the viewer's Update Time field.\n\n See hou.IPRViewer.updateTime for more information.\n\n\n \"\"\"\n def lastClickLocation(self) -> Tuple[int, ...]:\n '''\n\n lastClickLocation(self) -> (int, int)\n\n Return the x and y coordinates for the pixel location where the user\n last clicked in the IPR viewer. Note that this location might be\n outside the image: the x and y coordinates can be negative and can\n be greater than or equal to the image resolution. Note that if the\n user never clicked in the viewer, the x and y coordinates will be\n negative.\n\n You would typically call this method from a shelf script. For\n example, a user can click on a pixel in the IPR viewer and then\n click on the shelf to perform an action on that pixel (e.g. display\n the shader parameters, assign a shader, etc.).\n\n Use hou.IPRViewer.imageResolution to get the valid range for pixel\n coordinates.\n\n Note that when you Ctrl-click on a pixel, Houdini searches\n $HOUDINI_PATH for scripts/ipr/pickpixel.py and runs it. This script\n can access the viewer with kwargs[\\\\\"viewer\\\\\"] and the location where\n the user clicked with kwargs[\\\\\"position\\\\\"].\n\n The following script opens a floating parameter window for the\n shader corresponding to the pixel the user last clicked on.\n\n > viewer = hou.ui.paneTabOfType(hou.paneTabType.IPRViewer)\n > px, py = viewer.lastClickLocation()\n > \n > if (px < 0 or px > viewer.imageResolution()[0] or\n > py < 0 or py >= viewer.imageResolution()[1]):\n > hou.ui.displayMessage(\\\\\"Click on the image and then run this script again\\\\\")\n > else:\n > material = viewer.materialNode(px, py)\n > \n > if material is not None:\n > parm_window = hou.ui.curDesktop().createFloatingPaneTab(\n > hou.paneTabType.Parm)\n > parm_window.setCurrentNode(material)\n > parm_window.setPin(True)\n > else:\n > hou.ui.displayMessage(\\\\\"Click on an object to bring up the shader.\\\\\")\n\n '''\n def ropNode(self) -> Optional[Node]:\n \"\"\"\n\n ropNode(self) -> hou.RopNode or None\n\n Return the ROP node that is selected in the viewer, or None if\n nothing is selected.\n\n\n \"\"\"\n def setRopNode(self, rop_node: Node) -> None:\n \"\"\"\n\n setRopNode(self, rop_node)\n\n Set the ROP node to use for rendering.\n\n\n \"\"\"\n def imageResolution(self) -> Tuple[int, ...]:\n \"\"\"\n\n imageResolution(self) -> (int, int)\n\n Return the resolution of the image.\n\n Raises hou.OperationFailed if the viewer does not contain an image.\n\n\n \"\"\"\n def cropRegion(self) -> Tuple[float, ...]:\n \"\"\"\n\n cropRegion(self) -> (float, float, float, float)\n\n Return the x0, x1, y0, and y1 normalized coordinates of the\n subregion that is selected, where (x0, y0) is the bottom-left corner\n and (x1, y1) is the top-right corner of the subregion.\n\n You can optionally tell the IPR viewer to only re-render only a\n portion of the image. To select a subportion of the image, hold down\n shift and select the box.\n\n Note that the bottom-left corner is (0.0, 0.0) and the top-right\n corner is (1.0, 1.0). For example, if the entire image is being\n rendered, this method returns (0.0, 1.0, 0.0, 1.0).\n\n\n \"\"\"\n def planes(self) -> Tuple[str, ...]:\n \"\"\"\n\n planes(self) -> tuple of str\n\n Return the names of the image planes in the rendered output.\n\n Note that the special Op_Id image plane contains the\n hou.Node.sessionId ids of the object nodes in the image. -1\n indicates that there is no object node associated with the pixel.\n Use hou.IPRViewer.objectNode to access the object corresponding to\n that id.\n\n Similarly, the Prim_Id plane contains the hou.Prim.number ids of the\n primitives in the image. Use hou.IPRViewer.prim to access the\n primitive corresponding to that id.\n\n Raises hou.OperationFailed if the viewer does not contain an image.\n\n\n \"\"\"\n def displayedPlane(self) -> str:\n \"\"\"\n\n displayedPlane(self) -> str\n\n Return the name of the currently-displayed image plane in the\n rendered output.\n\n Note that the special Op_Id image plane contains the\n hou.Node.sessionId ids of the object nodes in the image. -1\n indicates that there is no object node associated with the pixel.\n Use hou.IPRViewer.objectNode to access the object corresponding to\n that id.\n\n Similarly, the Prim_Id plane contains the hou.Prim.number ids of the\n primitives in the image. Use hou.IPRViewer.prim to access the\n primitive corresponding to that id.\n\n Raises hou.OperationFailed if the viewer does not contain an image.\n\n\n \"\"\"\n def pixel(self, plane_name: str, x: int, y: int) -> Tuple[float, ...]:\n '''\n\n pixel(self, plane_name, x, y) -> tuple of float\n\n Return the value of a pixel in one plane of the image. This method\n returns a tuple of 1 to 4 floats, depending on the type of image\n plane.\n\n Note that the color plane is named C.\n\n Raises hou.OperationFailed if the plane name is invalid, the pixel\n location is outside the image, or the viewer does not contain an\n image.\n\n You can determine the number of components in the image plane using\n the following: len(viewer.pixel(plane_name, 0, 0)).\n\n > >>> viewer.pixel(\\\\\"C\\\\\", 300, 200)\n > (0.69970703125, 0.46728515625, 0.289794921875, 1.0)\n\n '''\n def pixels(self, plane_name: str) -> Tuple[Tuple[float, ...], ...]:\n '''\n\n pixels(self, plane_name) -> tuple of tuple of float\n\n Returns the value of all pixels in one plane of the image. This\n method returns a tuple of tuples of 1 to 4 floats, depending on the\n type of image plane. The results are in row-major order, starting at\n the bottom left corner of the IPR image.\n\n Note that the color plane is named C.\n\n Raises hou.OperationFailed if the plane name is invalid or the\n viewer does not contain an image.\n\n > >>> all_pixels = viewer.pixels(\\\\\"C\\\\\")\n > >>> width = viewer.imageResolution()[0]\n > >>> all_pixels[width*200 + 300]\n > (0.69970703125, 0.46728515625, 0.289794921875, 1.0)\n\n '''\n def evaluatedStyleSheetJSON(self, x: int, y: int) -> str:\n \"\"\"\n\n evaluatedStyleSheetJSON(self, x, y) -> str\n\n Returns a JSON string describing the material style sheet at a given\n pixel. If no style sheet is active, an empty string is returned.\n\n\n \"\"\"\n def evaluatedStyleSheetPaths(self, x: int, y: int) -> Tuple[Tuple[str, int], ...]:\n \"\"\"\n\n evaluatedStyleSheetPaths(self, x, y) -> tuple of str\n\n Returns a list of paths to the styles that contribute to the style\n sheet at the current pixel.\n\n\n \"\"\"\n def saveFrame(self, file_path: str, snapshot: int = ..., xres: int = ..., yres: int = ..., color: str = ..., alpha: str = ..., scope: str = ..., lut: str = ..., gamma: float = ..., convert: bool = ...) -> bool:\n \"\"\"\n\n saveFrame(self, file_path, snapshot=0, xres=-1, yres=-1, color='C',\n alpha='C', scope='*', lut='', gamma=1.0, convert=True) -> bool\n\n Saves the current IPR render to the specified file path. It is\n possible to save an in progress/incomplete render.\n\n The output image type is inferred from the file extension on the\n provided file path. The snapshot parameter controls which IPR\n snapshot to save. A value of 0 indicates the active render.\n\n The native IPR resolution is used by default, however a custom\n resolution can be specified with the xres and yres parameters. The\n color and alpha parameters control which render planes are used when\n writing RGBA images like .jpg or .png. If a deep image format such\n as .pic or .exr is used, the scope parameter can be used to specify\n which image planes to include in the output.\n\n\n \"\"\"\n def objectNode(self, x: int, y: int) -> Optional[Node]:\n \"\"\"\n\n objectNode(self, x, y) -> hou.ObjNode or None\n\n Return the object node contributing the pixel at the specified\n location, or None if there is no object at the pixel or if the pixel\n location is outside the image bounds\n\n The following function returns the SOP node containing the geometry\n that contributes the pixel to the final image:\n\n > def sopNode(viewer, x, y):\n > obj_node = viewer.objectNode(x, y)\n > return (obj_node.renderNode() if obj_node is not None else None)\n\n Raises hou.OperationFailed if the viewer does not contain an image.\n\n\n \"\"\"\n def prim(self, x: int, y: int) -> Optional[Prim]:\n \"\"\"\n\n prim(self, x, y) -> hou.Prim or None\n\n Return the geometry primitive contributing the pixel at the\n specified location, or None if there is nothing at the pixel or if\n the pixel location is outside the image bounds\n\n Raises hou.OperationFailed if the viewer does not contain an image.\n\n\n \"\"\"\n def materialNode(self, x: int, y: int) -> Optional[Node]:\n \"\"\"\n\n materialNode(self, x, y) -> hou.ShopNode or None\n\n Return the SHOP node contributing the pixel at the specified\n location, or None if there is nothing at the pixel, the pixel\n location is outside the image bounds, or there is no shader on the\n geometry.\n\n This method first checks the primitive corresponding to the pixel\n and returns the SHOP corresponding to its shop_materialpath\n attribute. If the primitive does not have this attribute then it\n returns the SHOP assigned to the object. If no SHOP is assigned to\n the object, it returns None.\n\n Raises hou.OperationFailed if the viewer does not contain an image.\n\n\n \"\"\"\n def usingOCIO(self) -> bool:\n \"\"\"\n\n usingOCIO(self) -> bool\n\n Query if OpenColorIO is being used for color correction in the\n viewer.\n\n\n \"\"\"\n def setUsingOCIO(self, enable: bool) -> None:\n \"\"\"\n\n setUsingOCIO(self, enable)\n\n Enable or disable OpenColorIO for color correction in the viewer.\n\n\n \"\"\"\n def setOCIODisplayView(self, display: Optional[str] = None, view: Optional[str] = None) -> None:\n '''\n\n setOCIODisplayView(self, display=\\\\\"\\\\\", view=\\\\\"\\\\\")\n\n Set the OpenColorIO display name, view name, or both. The display\n and view together define the output colorspace for the viewer, and\n any number of color transforms (Looks) to be performed on the linear\n viewport image.\n\n\n '''\n def getOCIODisplay(self) -> str:\n \"\"\"\n\n getOCIODisplay(self) -> str\n\n Return the current OpenColorIO display used for color correction.\n\n\n \"\"\"\n def getOCIOView(self) -> str:\n \"\"\"\n\n getOCIOView(self) -> str\n\n Return the current OpenColorIO view used for color correction.\n\n\n \"\"\"\n\nclass Keyframe(BaseKeyframe):\n \"\"\"\n\n hou.Keyframe\n\n Class representing the default keyframe type, a numerical keyframe.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, value: float|None = ..., time: float|None = ...) -> None:\n \"\"\"\n\n __init__(self, values)\n\n Return a new Keyframe object. You can pass no parameters (the result\n will have no value set), a float value, a float value and float\n time, or a Keyframe object.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def evaluatedType(self) -> EnumValue:\n \"\"\"\n\n evaluatedType(self) -> hou.parmData enum value\n\n Return the data type of the keyframe's evaluated value. For\n keyframes storing numerical values this method returns\n hou.parmData.Float.\n\n\n \"\"\"\n def setValue(self, value: float) -> None:\n \"\"\"\n\n setValue(self, value)\n\n Sets the value leaving the keyframe.\n\n\n \"\"\"\n def value(self) -> float:\n \"\"\"\n\n value(self) -> double\n\n Returns the value leaving the keyframe.\n\n This method raises hou.KeyframeValueNotSet if the value has not been\n set.\n\n\n \"\"\"\n def isValueSet(self) -> bool:\n \"\"\"\n\n isValueSet(self) -> bool\n\n Returns True if the value entering or leaving the keyframe has been\n set.\n\n\n \"\"\"\n def setInValue(self, in_value: float) -> None:\n \"\"\"\n\n setInValue(self, in_value)\n\n Sets the value entering the keyframe. Sets the value leaving the\n keyframe, if not already set. Unties the value.\n\n\n \"\"\"\n def unsetInValue(self) -> None:\n \"\"\"\n\n unsetInValue(self)\n\n Unsets the value entering the keyframe and tie the values.\n\n\n \"\"\"\n def inValue(self) -> float:\n \"\"\"\n\n inValue(self) -> double\n\n Returns the value entering the keyframe.\n\n This method raises hou.KeyframeValueNotSet if the value has not been\n set or the value is tied.\n\n\n \"\"\"\n def isValueTied(self) -> bool:\n \"\"\"\n\n isValueTied(self) -> bool\n\n Returns True if the value entering the keyframe has not been set.\n\n\n \"\"\"\n def isValueUsed(self) -> bool:\n \"\"\"\n\n isValueUsed(self) -> bool\n\n Returns True if the value entering or leaving the keyframe is being\n used.\n\n\n \"\"\"\n def useValue(self, use: bool) -> None:\n \"\"\"\n\n useValue(self, on)\n\n Sets the value used flag.\n\n\n \"\"\"\n def setSlope(self, slope: float) -> None:\n \"\"\"\n\n setSlope(self, slope)\n\n Sets the slope leaving the keyframe.\n\n\n \"\"\"\n def slope(self) -> float:\n \"\"\"\n\n slope(self) -> double\n\n Returns the slope leaving the keyframe.\n\n This method raises hou.KeyframeValueNotSet if the slope has not been\n set.\n\n\n \"\"\"\n def isSlopeSet(self) -> bool:\n \"\"\"\n\n isSlopeSet(self) -> bool\n\n Returns True if the slope entering or leaving the keyframe has been\n set.\n\n\n \"\"\"\n def isSlopeUsed(self) -> bool:\n \"\"\"\n\n isSlopeUsed(self) -> bool\n\n Returns True if the slope entering or leaving the keyframe is being\n used.\n\n\n \"\"\"\n def useSlope(self, use: bool) -> None:\n \"\"\"\n\n useSlope(self, on)\n\n Sets the slope used flag.\n\n\n \"\"\"\n def isSlopeAuto(self) -> bool:\n \"\"\"\n\n isSlopeAuto(self) -> bool\n\n Returns True if the slope leaving the keyframe is set to automatic.\n\n\n \"\"\"\n def setSlopeAuto(self, on: bool) -> None:\n \"\"\"\n\n setSlopeAuto(self, on)\n\n Sets the slope leaving the keyframe to automatic.\n\n\n \"\"\"\n def setInSlope(self, in_slope: float) -> None:\n \"\"\"\n\n setInSlope(self, in_slope)\n\n Sets the slope entering the keyframe. Sets the slope leaving the\n keyframe, if not already set. Unties the slope.\n\n\n \"\"\"\n def unsetInSlope(self) -> None:\n \"\"\"\n\n unsetInSlope(self)\n\n Unsets the slope entering the keyframe and tie the slope.\n\n\n \"\"\"\n def inSlope(self) -> float:\n \"\"\"\n\n inSlope(self) -> double\n\n Returns the slope entering the keyframe.\n\n This method raises hou.KeyframeValueNotSet if the slope has not been\n set or the slope is tied.\n\n\n \"\"\"\n def isSlopeTied(self) -> bool:\n \"\"\"\n\n isSlopeTied(self) -> bool\n\n Returns True if the slope entering the keyframe has not been set.\n\n\n \"\"\"\n def isInSlopeAuto(self) -> bool:\n \"\"\"\n\n isInSlopeAuto(self) -> bool\n\n Returns True if the slope entering the keyframe is set to automatic.\n\n\n \"\"\"\n def setInSlopeAuto(self, on: bool) -> None:\n \"\"\"\n\n setInSlopeAuto(self, on)\n\n Sets the slope entering the keyframe to automatic.\n\n\n \"\"\"\n def setAccel(self, accel: float) -> None:\n \"\"\"\n\n setAccel(self, accel)\n\n Sets the acceleration leaving the keyframe.\n\n\n \"\"\"\n def accel(self) -> float:\n \"\"\"\n\n accel(self) -> double\n\n Returns the acceleration leaving the keyframe.\n\n This function raises hou.KeyframeValueNotSet if the acceleration has\n not been set.\n\n\n \"\"\"\n def isAccelSet(self) -> bool:\n \"\"\"\n\n isAccelSet(self) -> bool\n\n Returns True if the acceleration entering or leaving the keyframe\n has been set.\n\n\n \"\"\"\n def isAccelUsed(self) -> bool:\n \"\"\"\n\n isAccelUsed(self) -> bool\n\n Returns True if the acceleration entering or leaving the keyframe is\n being used.\n\n\n \"\"\"\n def useAccel(self, use: bool) -> None:\n \"\"\"\n\n useAccel(self, on)\n\n Sets the acceleration used flag.\n\n\n \"\"\"\n def setInAccel(self, in_accel: float) -> None:\n \"\"\"\n\n setInAccel(self, in_accel)\n\n Sets the acceleration entering the keyframe. Sets the acceleration\n leaving the keyframe, if not already set. Unties the acceleration.\n\n\n \"\"\"\n def unsetInAccel(self) -> None:\n \"\"\"\n\n unsetInAccel(self)\n\n Unsets the acceleration entering the keyframe and tie the\n acceleration.\n\n\n \"\"\"\n def inAccel(self) -> float:\n \"\"\"\n\n inAccel(self) -> double\n\n Returns the acceleration entering the keyframe.\n\n This method raises hou.KeyframeValueNotSet if the acceleration has\n not been set or it is tied.\n\n\n \"\"\"\n def isAccelTied(self) -> bool:\n \"\"\"\n\n isAccelTied(self) -> bool\n\n Returns True if the acceleration entering the keyframe has not been\n set.\n\n\n \"\"\"\n def interpretAccelAsRatio(self, on: bool) -> None:\n \"\"\"\n\n interpretAccelAsRatio(self, on)\n\n Sets whether Houdini should interpret the acceleration values\n entering and leaving the keyframe as a single ratio. When set to\n True, the ratio of the in-acceleration to out-acceleration is always\n maintained. If, for example, the in-acceleration is made to be twice\n as large using the Animation Editor, then the out-acceleration will\n automatically be adjusted to be twice as large as well. This is the\n default behavior for Houdini keyframes.\n\n\n \"\"\"\n def isAccelInterpretedAsRatio(self) -> bool:\n \"\"\"\n\n isAccelInterpretedAsRatio(self) -> bool\n\n Returns True if the acceleration values entering and leaving the\n keyframe are interpreted as a ratio by Houdini.\n\n\n \"\"\"\n\nclass LabelParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.LabelParmTemplate\n\n Describes a label parameter. Unlike most other parameters, labels do not\n store parameter values.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, column_labels: Sequence[str] = ..., is_hidden: bool = ..., is_label_hidden: bool = ..., join_with_next: bool = ..., help: str|None = ..., tags: Mapping[str, str] = ...) -> None:\n \"\"\"\n\n __init__(self, name, label, column_labels=(), is_hidden=False,\n is_label_hidden=False, join_with_next=False, help=None, tags={})\n\n Create a new LabelParmTemplate instance.\n\n\n name\n See hou.ParmTemplate.name for more information.\n\n label\n See hou.ParmTemplate.label for more information.\n\n column_labels\n See the setColumnLabels method for more information.\n\n is_hidden\n See hou.ParmTemplate.isHidden for more information.\n\n is_label_hidden\n See hou.ParmTemplate.isLabelHidden for more information.\n\n join_with_next\n See hou.ParmTemplate.joinsWithNext for more information.\n\n help\n See hou.ParmTemplate.help for more information.\n\n tags\n See hou.ParmTemplate.tags for more information.\n\n Note that the number of components in a label parm template\n corresponds to the number of column labels.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def labelParmType(self) -> EnumValue:\n \"\"\"\n\n labelParmType() -> hou.labelParmType\n\n Returns the label parm type for this parm template.\n\n\n \"\"\"\n def setLabelParmType(self, label_parm_type: EnumValue) -> None:\n \"\"\"\n\n setLabelParmType(label_parm_type)\n\n Sets the label parm type to a hou.labelParmType enum value.\n\n\n \"\"\"\n def columnLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n columnLabels() -> tuple of str\n\n Return the tuple of strings of column labels. Normally, label parm\n templates do not have any column labels. However, they may have\n these extra labels that are displayed in addition to the main label.\n\n Note that the number of components in a label parm template\n corresponds to the number of column labels.\n\n\n \"\"\"\n def setColumnLabels(self, column_labels: Sequence[str]) -> None:\n \"\"\"\n\n setColumnLabels(column_labels)\n\n Set the column labels to a sequence of strings.\n\n The parameter editor in the always has at\n least one column label, so if you supply an empty sequence there\n will be one column label that is an empty string.\n\n See the columnLabels method for more information.\n\n\n \"\"\"\n\nclass logging:\n \"\"\"\n\n hou.logging\n\n Module containing functions and classes for logging warnings and errors.\n\n Houdini's logging system consists of sources and sinks. Sources generate\n and distribute log entries. Sinks receive log entries from sources, and\n do something with them. Sources are global, and identified by a unique\n name string (such as Node Errors which is a source that generates a log\n entry for every message, warning, or error generated by nodes). There\n can be any number of sinks created in a Houdini session, and each one\n can connect to a different set of sources. Thus you could create one\n sink that sends all node errors to a file, another sink that sends all\n rendering messages to a different file, and a third sink that captures\n in memory all log entries generated by any sink (the same source may be\n connected to multiple sinks). This system allows for fine grained\n control over which log entries are captured, and what is done with each\n log entry.\n\n API\n\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def sources() -> Tuple[str, ...]:\n \"\"\"\n\n hou.logging.sources\n\n Return a tuple of all available log source names.\n\n USAGE\n sources() -> tuple of str\n\n The HDK can be used to create additional log sources, but the default\n list of sources returned by this method will be:\n\n * Generic Logging: Logs generated by Houdini which do not fall into\n any other category.\n\n * Licensing: Messages related to acquiring licenses to run Houdini.\n\n * Mocap Stream: Messages generated by motion capture devices.\n\n * Networking: Messages generated by networking components such as\n Houdini's built-in web server.\n\n * Node Errors: All messages, warnings, and errors generated by Houdini\n nodes.\n\n * Rendering: Messages generated by Karma running within the Houdini\n process. Use hou.logging.setRenderLogVerbosity to set the equivalent\n of the verbosity command line argument for external rendering\n processes.\n\n * Standard Error: Text sent to the stderr stream.\n\n * Standard Output: Text sent to the stdout stream.\n\n * USD Logging: Messages generated in the USD logging system.\n\n\n \"\"\"\n @staticmethod\n def setRenderLogVerbosity(verbosity: int) -> None:\n \"\"\"\n\n hou.logging.setRenderLogVerbosity\n\n Set the Karma logging verbosity level.\n\n USAGE\n setRenderLogVerbosity(verbosity)\n\n Set the current logging verbosity level for Karma running within the\n current Houdini session. This is equivalent to the value of the -V\n values passed to the husk process for a command line render. Values\n range from 0 to 9, and high values can impact the performance of the\n render.\n\n\n \"\"\"\n @staticmethod\n def renderLogVerbosity() -> int:\n \"\"\"\n\n hou.logging.renderLogVerbosity\n\n Return the Karma logging verbosity level.\n\n USAGE\n renderLogVerbosity() -> int\n\n Return the current logging verbosity level for Karma running within the\n current Houdini session. This is equivalent to the value of the -V\n values passed to the husk process for a command line render. Values\n range from 0 to 9, and high values can impact the performance of the\n render.\n\n\n \"\"\"\n @staticmethod\n def saveLogsToFile(logs: typing.Iterable[_logging_LogEntry], filepath: str) -> None:\n \"\"\"\n\n hou.logging.saveLogsToFile\n\n Save a tuple of LogEntry objects to a file in JSON format.\n\n USAGE\n saveLogsToFile(logs, filepath)\n\n Creates a file containing a JSON representation of a collection of\n hou.logging.LogEntry objects. This file can be converted back to a tuple\n of hou.logging.LogEntry objects by calling hou.logging.loadLogsFromFile\n with the same filepath.\n\n\n logs\n Iterable object containing hou.Logging.LogEntry objects which are to\n be saved to disk in a JSON format the preserves all available\n information from each entry.\n\n filepath\n Path to the file on disk where the log entries will be written.\n\n\n \"\"\"\n @staticmethod\n def loadLogsFromFile(filepath: str) -> Tuple[_logging_LogEntry, ...]:\n \"\"\"\n\n hou.logging.loadLogsFromFile\n\n Load a tuple of LogEntry objects saved in JSON format from a file.\n\n USAGE\n loadLogsFromFile(filepath) -> tuple of hou.logging.LogEntry\n\n Returns a tuple of log entries stored in a JSON file on disk. This file\n was most likely created with a call to hou.logging.saveLogsToFile.\n\n\n filepath\n The path to the file containing the JSON representation of an array\n of log entries.\n\n\n \"\"\"\n @staticmethod\n def createSource(source_name: str) -> None:\n \"\"\"\n\n hou.logging.createSource\n\n Create a new logging source which can send out log entries generated in\n python.\n\n USAGE\n createSource(source_name)\n\n Creates a new logging source that can be passed as the source_name\n argument to the hou.logging.log method. That method will create new\n logging sources automatically, but it can be useful to create logging\n sources before any logs are generated by that source so the user can\n enable the source in the Log Viewer pane.\n\n\n source_name\n The name for the new logging source. If this name matches any\n existing source (as returned by hou.logging.sources), this method\n does nothing.\n\n\n \"\"\"\n @staticmethod\n def log(entry: _logging_LogEntry, source_name: Optional[str] = None) -> None:\n \"\"\"\n\n hou.logging.log\n\n Send a LogEntry object to all log sinks connected to a logging source.\n\n USAGE\n log(entry, source_name = None)\n\n Sends a hou.logging.LogEntry from a source with the specified\n source_name. If no source_name is provided, or it is an empty string,\n then the source set on the log entry is used. If that source name is\n also not set, then the default source name of Python Logging is used.\n\n\n entry\n A hou.logging.LogEntry object which will be sent from the named\n logging source to all connected sinks. The source attribute of the\n log entry object will be automatically overridden to use the\n specified source_name.\n\n source_name\n The name of the logging source from which the log entry is sent.\n Only logging sources compatible with sending python log entries can\n be used here. If no value is specified, the value is assumed to be\n Python Logging. Other valid values are Generic Logging, or any value\n that does not match an existing logging source name. In this case a\n new logging source is automatically created as if\n hou.logging.createSource had been called.\n\n\n \"\"\"\n @staticmethod\n def defaultSink(force_create: bool = False) -> Optional[_logging_MemorySink]:\n \"\"\"\n\n hou.logging.defaultSink\n\n Return a shared memory sink object owned by the current Houdini session.\n\n USAGE\n defaultSink(force_create) -> hou.logging.MemorySink or None\n\n Every Houdini session can have a single shared hou.logging.MemorySink\n object which is used by all Log Viewer panes to display logs generated\n by the current Houdini session. This function provides access to this\n shared sink object.\n\n\n force_create\n If the default sink for the current Houdini session has not been\n created, this parameter controls whether the default sink should be\n created. Otherwise this method will return None. If the default sink\n has already been created, this parameter has no effect.\n\n\n \"\"\"\n @staticmethod\n def defaultFileSink() -> Optional['_logging_FileSink']:\n \"\"\"\n\n hou.logging.defaultFileSink\n\n Return a shared file sink object owned by the current Houdini session.\n\n USAGE\n defaultFileSink() -> hou.logging.FileSink or None\n\n Every Houdini session can have a single shared hou.logging.FileSink\n object which is used to log messages generated by the current Houdini\n session. This function provides access to this shared sink object. If\n the HOUDINI_DEFAULT_LOG_FILE or HOUDINI_DEFAULT_LOG_FILE_SOURCES\n environment variables are not set, Houdini will not send its logs to a\n file, and so this method will return None.\n\n\n \"\"\"\n\nclass _logging_FileSink(_logging_Sink):\n \"\"\"\n\n hou.logging.FileSink\n\n Represents a logging destination that writes log entries to a file.\n\n This kind of sink can be used to send log entries to a file on disk.\n Some of the log entry details are lost in writing the data to disk, as\n each log entry is output simply as a time stamp followed by the message\n text. So for most situations, using the Log Viewer pane to investigate\n log entries will be preferable.\n\n\n Tip\n In order to ensure all logs are captured and committed to disk, this\n sink type opens the log file, writes the log entry, and closes the\n file for each log message. This can introduce noticeable performance\n issues if a large amount of information is being logged. Therefore\n it is strongly recommended that the destination file be local to the\n machine running Houdini, and preferably be kept on an SSD hard\n drive.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, filepath: str) -> None:\n \"\"\"\n\n __init__(self, filepath)\n\n Creates a new file sink object which writes logs to the specified\n file path.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def filePath(self) -> str:\n \"\"\"\n\n filePath() -> str\n\n Returns the path to the file where logs are written.\n\n\n \"\"\"\n\nclass _logging_LogEntry:\n \"\"\"\n\n hou.logging.LogEntry\n\n Represents a single log message that is sent by a source to a sink.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, message: Optional[str] = None, source: Optional[str] = None, source_context: Optional[str] = None, severity: Optional[EnumValue] = None, verbosity: int = 0, time: float = 0.0, thread_id: int = 0, has_external_info: bool = False, external_host_name: Optional[str] = None, external_identifier: Optional[str] = None, external_command_line: Optional[str] = None, external_process_id: int = 0) -> None:\n \"\"\"\n\n __init__(self, message = None, source = None, source_context = None,\n severity = None, verbosity = 0, time = 0.0, thread_id = 0,\n has_external_info = False, external_host_name = None,\n external_identifier = None, external_command_line = None,\n external_process_id = 0)\n\n Return a new LogEntry with the provided data members.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def source(self) -> str:\n \"\"\"\n\n source() -> str\n\n Return the names of the source that generated this log entry.\n\n\n \"\"\"\n def sourceContext(self) -> str:\n \"\"\"\n\n sourceContext() -> str\n\n Return an optional string that identifies the context within the\n source that generated this log entry. One example is that the Node\n Errors source sets this value to the path of the specific Houdini\n node that generated the log entry.\n\n\n \"\"\"\n def message(self) -> str:\n \"\"\"\n\n message() -> str\n\n Return the main log entry message text.\n\n\n \"\"\"\n def severity(self) -> EnumValue:\n \"\"\"\n\n severity() -> hou.severityType\n\n Return an optional severity value for the log entry. This value will\n be set for node error logs, USD logs, and other sources with a well\n defined set of logging severity levels.\n\n\n \"\"\"\n def verbosity(self) -> int:\n \"\"\"\n\n verbosity() -> int\n\n Return an optional verbosity value for the log entry. This value\n will be set for rendering logs, and indicates the minimum\n hou.logging.renderLogVerbosity level required for Karma to generate\n this log entry.\n\n\n \"\"\"\n def time(self) -> float:\n '''\n\n time() -> float\n\n Return the time at which this log entry was generated. This value is\n expressed as the number of seconds since January 1, 1970, 00:00:00\n (UTC). This value can be converted to a local time using the python\n time module using code such as time.strftime(\\\\\"%H:%M:%S\\\\\",\n time.localtime(log.time())). Although log entries from a single\n source should always arrive in chronological order, some sources may\n delay their log reporting, and so log entries may arrive at a sink\n out of order.\n\n\n '''\n def threadId(self) -> int:\n \"\"\"\n\n threadId() -> int\n\n Return a number that uniquely identifies within a given Houdini\n session which thread in the process generated the log entry. This\n can be useful to establish a chronology of log entries when multiple\n threads are generating logs simultaneously.\n\n\n \"\"\"\n def hasExternalInfo(self) -> bool:\n \"\"\"\n\n hasExternalInfo() -> bool\n\n Return True if this log entry was generated by a process other than\n the current Houdini session. In this case, the various methods\n starting with external will return meaningful information. If this\n method returns False, the external methods should not be called on\n this object.\n\n\n \"\"\"\n def externalHostName(self) -> str:\n \"\"\"\n\n externalHostName() -> str\n\n If the external process was running on a different machine, return\n the name of the machine running the process. Otherwise return an\n empty string.\n\n\n \"\"\"\n def externalIdentifier(self) -> str:\n \"\"\"\n\n externalIdentifier() -> str\n\n Return an optional string to help identify the machine or process\n which generated the log entry. The meaning of this value varies\n depending on the logging source.\n\n\n \"\"\"\n def externalCommandLine(self) -> str:\n \"\"\"\n\n externalCommandLine() -> str\n\n Return the full command line used to launch the external process\n that generated this log entry.\n\n\n \"\"\"\n def externalProcessId(self) -> int:\n \"\"\"\n\n externalProcessId() -> int\n\n Return the process identifier (pid) of the process that generated\n the log entry.\n\n\n \"\"\"\n\nclass _logging_MemorySink(_logging_Sink):\n \"\"\"\n\n hou.logging.MemorySink\n\n Represents a logging destination that stores log entries in memory.\n\n All log entries sent to this sink are held in memory forever unless\n stealLogEntries is called. Depending on the frequency of logging, this\n can eventually result in a very large amount of memory being consumed by\n these logs, however in most normal operating circumstances this is very\n unlikely to be a problem.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n hou.logging.MemorySink\n\n Represents a logging destination that stores log entries in memory.\n\n All log entries sent to this sink are held in memory forever unless\n stealLogEntries is called. Depending on the frequency of logging, this\n can eventually result in a very large amount of memory being consumed by\n these logs, however in most normal operating circumstances this is very\n unlikely to be a problem.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def logEntries(self) -> Iterator[_logging_LogEntry]:\n \"\"\"\n\n logEntries() -> iterable of hou.logging.LogEntry\n\n Return an iterable object that represents all the log entries held\n in memory by this sink object.\n\n\n \"\"\"\n def stealLogEntries(self) -> Tuple[_logging_LogEntry, ...]:\n \"\"\"\n\n stealLogEntries() -> tuple of hou.logging.LogEntry\n\n Returns a tuple of all log entries that were held in memory by this\n sink object. In addition, all log entries owned by this sink object\n are cleared from memory. Thus subsequent calls to logEntries or\n stealLogEntries will not return any of these log entries again.\n\n\n \"\"\"\n\nclass LopLockedStage:\n \"\"\"\n\n hou.LopLockedStage\n\n Guarantees the lifetime of a USD stage created by a LOP node.\n\n This object is returned by a call to hou.Geometry.importLop. This object\n must remain in scope as long as the hou.Geometry object contains packed\n primitives representing USD primitives created from the LOP node. Once\n this object leaves scope, it may become impossible to view or unpack the\n USD packed primitives in the hou.Geometry object.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def rootLayerIdentifier(self) -> str:\n \"\"\"\n\n rootLayerIdentifier(self) -> str\n\n Returns the identifier for the root layer of the stage held by this\n object. This will always be an anonymous layer identifier.\n\n\n \"\"\"\n\nclass LopNetwork(OpNode):\n \"\"\"\n\n hou.LopNetwork\n\n Represents a lighting node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isDebugFlagSet(self) -> bool:\n \"\"\"\n\n isDebugFlagSet(self) -> bool\n\n Returns True if the node's debug flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setDebugFlag(self, on: bool) -> None:\n \"\"\"\n\n setDebugFlag(self, on)\n\n Turns the node's debug flag on or off. The debug flag on a LOP node\n is used to force the node to create its own USD Layer and apply its\n edits in that new layer. This makes it easier to track which scene\n graph modifications were made by which LOP node. Setting this flag\n will also affect the performance of the LOP Network since\n composition of the USD stage takes longer if there are more layers.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def displayNode(self) -> Optional[Node]:\n \"\"\"\n\n displayNode(self) -> Node\n\n Return the LOP node inside this network with its display flag on.\n Otherwise, return None.\n\n\n \"\"\"\n def viewerNode(self) -> Optional[Node]:\n \"\"\"\n\n viewerNode(self) -> Node\n\n Return the LOP node inside this LOP network with its display flag\n on. This method exists to mirror the matching hou.LopNode.viewerNode\n method. But unlike that method, in a LOP network, unless there are\n no child nodes at all, there will always be a node with the display\n flag set, so this method will return the same values as the\n displayNode method.\n\n\n \"\"\"\n def viewportOverrides(self, lop: LopNode, output_index: int = 0) -> LopViewportOverrides:\n \"\"\"\n\n viewportOverrides(self, lop, output_index = 0) ->\n hou.LopViewportOverrides\n\n Return a hou.LopViewportOverrides object that allows editing of the\n current session-only modifications which should be applied to any\n scene being viewed in a Scene Graph Tree pane or a Scene Viewer\n pane.\n\n The lop must be a hou.LopNode object. The cooked stage from this LOP\n Node is used to perform the requested edit operations in the\n returned hou.LopViewportOverrides object. The output_index controls\n which output of this LOP node will be used to author the stage\n presented through the hou.LopViewportOverrides.stage method. The\n layer_index parameter controls which specific session sublayer is to\n be modified.\n\n\n \"\"\"\n def saveNamedViewportOverrides(self, name: str, overrides: Optional[LopViewportOverrides] = None) -> None:\n \"\"\"\n\n saveNamedViewportOverrides(self, name, overrides=None)\n\n Saves the current set of session overrides to the LOP Network under\n the specified name. This set of overrides will be saved to the hip\n file, and can be restored with the loadNamedViewportOverrides\n method.\n\n\n \"\"\"\n def loadNamedViewportOverrides(self, name: str) -> None:\n \"\"\"\n\n loadNamedViewportOverrides(self, name)\n\n Loads the session overrides saved under the specified name on the\n LOP Network. This set of overrides will be applied to any viewport\n pointed at this LOP Network. These named session override sets can\n be created with the saveNamedViewportOverrides method.\n\n\n \"\"\"\n def namedViewportOverrides(self) -> Tuple[str, ...]:\n \"\"\"\n\n namedViewportOverrides(self) -> tuple of str\n\n Returns a list of the named session overrides saved on the LOP\n Network. The names returned from this method can be passed to the\n loadNamedViewportOverrides method to load a particular set of\n overrides saved with the saveNamedViewportOverrides method.\n\n\n \"\"\"\n def viewportOverridesLayer(self, layer_id: EnumValue) -> pxr.Sdf.Layer:\n \"\"\"\n\n viewportOverridesLayer(self, layer_id) -> pxr.Sdf.Layer\n\n Return a pxr.Sdf.Layer object that holds the specified viewport\n overrides layer. This layer should be treated as read only. To\n modify a viewport overrides layer, use the viewportOverrides method.\n The layer_id must be one of the hou.lopViewportOverridesLayer\n values. Each layer is used to hold a different type of edit. In\n strongest to weakest order the available layers are:\n\n\n Custom\n Reserved for use by tools created by users. Houdini itself will\n not author opinions on this layer. Use the\n hou.LopViewportOverrides.layer method to access and edit this\n layer.\n\n Purpose\n Used to isolate and display specific geometry based on its\n purpose attribute. Other purposes for the same geometry will be\n hidden.\n\n SoloGeometry\n Used to express soloing opinions on geometry, for making all\n geometry invisible except for a specific set.\n\n SoloLights\n Used to express soloing opinions on lights, for deactivating all\n lights except for a specific set.\n\n Base\n Used for most edits performed in the scene graph tree, such as\n deactivating or hiding individual primitives.\n\n\n \"\"\"\n def copyViewportOverrides(self, saved_name: Optional[str] = None) -> Optional[LopViewportOverrides]:\n \"\"\"\n\n copyViewportOverrides(self, saved_name) -> hou.LopViewportOverrides\n\n\n \"\"\"\n def setViewportOverrides(self, overrides: LopViewportOverrides) -> None:\n \"\"\"\n\n setViewportOverrides(self, overrides)\n\n\n \"\"\"\n def viewportLoadMasks(self) -> LopViewportLoadMasks:\n \"\"\"\n\n viewportLoadMasks(self) -> hou.LopViewportLoadMasks\n\n Returns the load masking configuration for the viewport currently\n set on the LOP Network. This controls payload loading, stage\n population masking, and layer muting on any viewport pointed at this\n LOP Network.\n\n\n \"\"\"\n def setViewportLoadMasks(self, load_masks: LopViewportLoadMasks) -> None:\n \"\"\"\n\n setViewportLoadMasks(self, payload_config)\n\n Sets a new load masking configuration on the LOP Network.\n\n\n \"\"\"\n def saveNamedViewportLoadMasks(self, name: str, load_masks: LopViewportLoadMasks) -> None:\n \"\"\"\n\n saveNamedViewportLoadMasks(self, name)\n\n Saves the supplied load masking configuration to the LOP Network\n under the specified name. This configuration will be saved to the\n hip file, and can be restored with the loadNamedViewportLoadMasks\n method.\n\n\n \"\"\"\n def loadNamedViewportLoadMasks(self, name: str) -> LopViewportLoadMasks:\n \"\"\"\n\n loadNamedViewportLoadMasks(self, name) -> hou.LopViewportLoadMasks\n\n Returns the load masking configuration saved under the specified\n name on the LOP Network. Raises a hou.OperationFailed exception if\n there is no load masking configuration stored under the specified\n name.\n\n\n \"\"\"\n def namedViewportLoadMasks(self) -> Tuple[str, ...]:\n \"\"\"\n\n namedViewportLoadMasks(self) -> tuple of str\n\n Returns a list of the named load masking configurations saved on the\n LOP Network. The names returned from this method can be passed to\n the loadNamedViewportLoadMasks method to load a particular load\n masking configuration saved with the saveNamedViewportLoadMasks\n method.\n\n\n \"\"\"\n def editablePostLayer(self, name: str, lop: LopNode, output_index: int = 0) -> LopPostLayer:\n \"\"\"\n\n editablePostLayer(self, name, lop, output_index=0) -> hou.LopPostLayer\n\n Return a hou.LopPostLayer object which can be used to manipulate the\n contents of a post-layer on this LOP Network. If the specified layer\n does not exist, it will be created as the weakest post-layer. If it\n does exist, the current contents of the layer are composed onto the\n stage accessible through the LopPostLayer object. In either case,\n all stronger post-layers will be composed on the stage accessible\n through the LopPostLayer.\n\n The lop (a hou.LopNode) and output_index parameters define the USD\n stage on which the post layer is composed, and provides the context\n in which and USD API calls can be run. This LOP stage is accessible\n through the hou.LopPostLayer.stage method.\n\n A LopPostLayer object must be used to begin a with block. When the\n block exits the LopPostLayer object is destroyed, and the modified\n post-layer is saved to the LOP Network.\n\n The following code creates a post layer called pl1 on the /stage LOP\n network containing a Null LOP named null1, and adds a sphere prim:\n\n > from pxr import UsdGeom\n > with hou.node('/stage').editablePostLayer('pl1', hou.node('/stage/null1')) as pl:\n > s = pl.stage()\n > UsdGeom.Sphere.Define(s, '/postlayer/sphere1')\n\n \"\"\"\n def postLayerNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n postLayerNames(self) -> tuple of str\n\n Returns the names of all post-layers authored on the LOP Network.\n These names can be passed to the other post-layer methods on this\n object to uniquely identify a specific post-layer to operate on. The\n list is ordered from strongest to weakest in terms of its effect on\n the composed stage.\n\n\n \"\"\"\n def postLayer(self, name: str) -> pxr.Sdf.Layer|None:\n \"\"\"\n\n postLayer(self, name) -> pxr.Sdf.Layer or None\n\n Returns a non-editable pxr.Sdf.Layer object that can be used to\n inspect the contents of a post-layer without triggering any change\n notifications as would occur when calling editablePostLayer. If\n there is no post-layer with the specified name, None is returned\n instead.\n\n\n \"\"\"\n def removePostLayer(self, name: str) -> None:\n \"\"\"\n\n removePostLayer(self, name)\n\n Removes a post-layer from the LOP Network. If the specified name\n does not identify an existing post-layer, this method does nothing.\n\n\n \"\"\"\n def selection(self) -> Tuple[str, ...]:\n \"\"\"\n\n selectionWithInstanceIds(self) -> tuple of str\n\n Return a tuple of strings representing all the scene graph locations\n of the instances currently selected in the LOP Network parent of\n this LOP node.\n\n\n \"\"\"\n def selectionCurrentPrim(self) -> str:\n \"\"\"\n\n selectionCurrentPrim(self) -> str\n\n Return a string with the path to the scene graph primitive that\n should be displayed in the Scene Graph Details pane. Set this value\n with the hou.LopNetwork.setSelection method.\n\n\n \"\"\"\n def selectionWithInstanceIds(self) -> Tuple[str, ...]: ...\n def setSelection(self, selection: Sequence[str], currentprim: Optional[str] = None) -> None:\n \"\"\"\n\n setSelection(self, selection, currentprim = None)\n\n Accepts a tuple of strings holding the scene graph locations which\n should become the selection in the LOP Network parent of this LOP\n node. This selection will be reflected in the Scene Graph Tree pane\n and the LOP viewport.\n\n The optional currentprim string can be supplied to have the Scene\n Graph Details pane show the information for a primitive at a\n specific path. The currentprim is usually in the selection list, but\n it doesn't need to be. Passing None for currentprim will set the\n current primitive to be the first primitive in the selection list.\n\n\n \"\"\"\n def selectionRules(self) -> dict[str, LopSelectionRule]:\n \"\"\"\n\n selectionRules(self) -> dict of str to hou.LopSelectionRule\n\n Return a dictionary mapping string names to hou.LopSelectionRule\n objects that match the selection rules stored on the LOP Network\n that owns this LOP node.\n\n\n \"\"\"\n def clearSelectionRules(self) -> None:\n \"\"\"\n\n clearSelectionRules(self)\n\n Deletes all selection rules stored on the LOP Network that owns this\n LOP node.\n\n\n \"\"\"\n def setSelectionRule(self, name: str, rule: LopSelectionRule) -> None:\n \"\"\"\n\n setSelectionRule(self, name, rule)\n\n Stores a named selection rule on the LOP Network that owns this LOP\n node. The rule parameter must be a hou.LopSelectionRule or None. Use\n None to remove a single named rule from the LOP Network.\n\n The selection rule name can be a slash-separated path, in which case\n the selection rule will appear in the Scene Graph Tree pane as part\n of a nested hierarchy. This in no way affects the operation of the\n rule, serving only as a way of organizing sets of rules.\n\n\n \"\"\"\n def expansionState(self) -> Optional[LopExpansionState]:\n \"\"\"\n\n expansionState(self) -> hou.LopExpansionState\n\n\n \"\"\"\n def setExpansionState(self, expansion_state: LopExpansionState) -> None:\n \"\"\"\n\n setExpansionState(self, expansion_state)\n\n\n \"\"\"\n def saveNamedExpansionState(self, name: str, expansion_state: LopExpansionState) -> None:\n \"\"\"\n\n saveNamedExpansionState(self, name, expansion_state)\n\n\n \"\"\"\n def loadNamedExpansionState(self, name: str) -> Optional[LopExpansionState]:\n \"\"\"\n\n loadNamedExpansionState(self, name) -> hou.LopExpansionState\n\n\n \"\"\"\n def namedExpansionStates(self) -> Tuple[str, ...]:\n \"\"\"\n\n namedExpansionStates(self) -> tuple of str\n\n\n \"\"\"\n def setPrimitiveExpansionUnlocked(self, path: str, preserve_descendant_expansion: bool = True) -> bool:\n \"\"\"\n\n setPrimitiveExpansionUnlocked(self, path,\n preserve_descendant_expansion=True) -> bool\n\n Removes the path from the expansionLockedPrimitives set. This also\n removes this prim and all its descendants from the\n expansionLockedExpandedPrimitives set.\n\n Setting preserve_descendant_expansion to False causes this method to\n remove all descendants of the path from the list of expansion locked\n and expansion locked expanded prims before setting the newly\n requested expansion locking and expanded states.\n\n The effect of this method is the same as fetching the\n hou.LopExpansionState object using expansionState, calling\n hou.LopExpansionState.setPrimitiveExpansionUnlocked on that object,\n then calling setExpansionState. But calling this method directly on\n the LOP Network will be much faster in scenarios with large, complex\n expansion states.\n\n\n \"\"\"\n def setPrimitiveExpansionLocked(self, path: str, expanded_subpaths: Optional[Any] = None, preserve_descendant_expansion: bool = True) -> bool:\n \"\"\"\n\n setPrimitiveExpansionLocked(self, path, expanded_subpaths,\n preserve_descendant_expansion=True) -> bool\n\n Locks the expansion state effect of a branch of the scene graph\n tree. The path parameter specifies the root prim which is locked,\n and will appear in the expansionLockedPrimitives set. The\n expanded_subpaths iterable of str or pxr.Sdf.Path objects is the set\n of all prims at or descended from path which should be treated as\n being expanded. For a prim to be treated as expanded by the\n expansion effect, every prim between the root path and the final\n prim must appear in this set.\n\n Prims in the expanded_subpaths which are not descendants of path are\n ignored.\n\n Setting preserve_descendant_expansion to False causes this method to\n remove all descendants of the path from the list of expansion locked\n and expansion locked expanded prims before setting the newly\n requested expansion locking and expanded states.\n\n The effect of this method is the same as fetching the\n hou.LopExpansionState object using expansionState, calling\n hou.LopExpansionState.setPrimitiveExpansionLocked on that object,\n then calling setExpansionState. But calling this method directly on\n the LOP Network will be much faster in scenarios with large, complex\n expansion states.\n\n\n \"\"\"\n\nclass LopNode(OpNode):\n \"\"\"\n\n hou.LopNode\n\n Represents a lighting node.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isBypassed(self) -> bool:\n \"\"\"\n\n isBypassed(self) -> bool\n\n Returns whether this node's bypass flag is on.\n\n\n \"\"\"\n def bypass(self, on: bool) -> None:\n \"\"\"\n\n bypass(self, on)\n\n Turns this node's bypass flag on or off, making this node have no\n effect.\n\n\n \"\"\"\n def isDisplayFlagSet(self) -> bool:\n \"\"\"\n\n isDisplayFlagSet(self) -> bool\n\n Returns whether this node's display flag is on.\n\n\n \"\"\"\n def setDisplayFlag(self, on: bool) -> None:\n \"\"\"\n\n setDisplayFlag(self, on)\n\n Turn this node's display flag on or off.\n\n\n \"\"\"\n def isDebugFlagSet(self) -> bool:\n \"\"\"\n\n isDebugFlagSet(self) -> bool\n\n Returns True if the node's debug flag is turned on. Returns False\n otherwise.\n\n\n \"\"\"\n def setDebugFlag(self, on: bool) -> None:\n \"\"\"\n\n setDebugFlag(self, on)\n\n Turns the node's debug flag on or off. The debug flag on a LOP node\n is used to force the node to create its own USD Layer and apply its\n edits in that new layer. This makes it easier to track which scene\n graph modifications were made by which LOP node. Setting this flag\n will also affect the performance of the LOP Network since\n composition of the USD stage takes longer if there are more layers.\n\n Raises hou.PermissionError if the node is unwritable.\n\n\n \"\"\"\n def displayNode(self) -> LopNode:\n \"\"\"\n\n displayNode(self) -> Node\n\n If this is a LOP Network or a subnet LOP, return the LOP node inside\n the subnet with its display flag on. Otherwise, return None.\n\n\n \"\"\"\n def viewerNode(self) -> Node:\n \"\"\"\n\n viewerNode(self) -> Node\n\n If this is a subnet LOP, return the LOP node inside the subnet with\n its display flag on. If the subnet LOP doesn't contain any children\n with a display flag set, the viewer node of the containing LOP\n Network or subnet is returned. This algorithm is the one used to\n determine which LOP node's stage to display in the 3D viewport. This\n recursive approach allows the user to work on the nodes inside a\n sub-network while viewing the result of the containing LOP network\n in the viewport.\n\n\n \"\"\"\n def editableLayer(self) -> pxr.Sdf.Layer | None:\n \"\"\"\n\n editableLayer(self) -> pxr.Sdf.Layer\n\n Returns a pxr.Sdf.Layer object with permission to edit that\n represents the active layer in a Python LOP. After calling this\n method, the uneditableStage method can be called to access a read-\n only pxr.Usd.Stage representation of the input to the Python LOP.\n\n\n \"\"\"\n def activeLayer(self, output_index: int = ..., ignore_errors: bool = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, Any] = ...) -> pxr.Sdf.Layer:\n \"\"\"\n\n activeLayer(self, output_index = -1, ignore_errors = False,\n use_last_cook_context_options = True, frame = None, context_options =\n {}) -> pxr.Sdf.Layer\n\n Returns a pxr.Sdf.Layer object representing the USD layer that has\n been modified by this node.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n The ignore_errors can be set to True to indicate that if this LOP\n node is in an error state after cooking, this method should search\n up the network looking for the first node not in an error state, and\n return the active layer from that node instead.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def editableStage(self) -> pxr.Usd.Stage | None:\n \"\"\"\n\n editableStage(self) -> pxr.Usd.Stage\n\n Returns a pxr.Usd.Stage object with permission to edit that\n represents the USD stage input to a Python LOP.\n\n\n \"\"\"\n def uneditableStage(self) -> pxr.Usd.Stage | None:\n \"\"\"\n\n uneditableStage(self) -> pxr.Usd.Stage\n\n Returns a pxr.Usd.Stage object after requesting either the\n editableStage or editableLayer of the currently running Python LOP\n node. If this node is not a Python LOP or neither editable object\n has yet been retrieved, this method returns None.\n\n If this method is called after calling editableStage, it returns\n exactly the same stage object, so it will in fact be editable, and\n any changes made through one stage object will be immediately\n visible on the other stage object.\n\n If this method is called after calling editableLayer, the returned\n stage will not have write permissions, and changes made to the\n editable layer will not be reflected on this stage object. The\n editable layer is not composed onto the returned stage object so\n changing it has no effect.\n\n\n \"\"\"\n def stage(self, output_index: int = ..., apply_viewport_overrides: bool = ..., ignore_errors: bool = ..., use_last_cook_context_options: bool = ..., apply_post_layers: bool = ..., frame: float|None = ..., context_options: Mapping[str, Any] = ...) -> pxr.Usd.Stage:\n \"\"\"\n\n stage(self, output_index = -1, apply_viewport_overrides = False,\n ignore_errors = False, use_last_cook_context_options = True,\n apply_post_layers = True, frame = None, context_options = {}}) ->\n pxr.Usd.Stage\n\n Returns a pxr.Usd.Stage object representing the USD stage output\n from this node. Set apply_viewport_overrides to True to return a\n stage with its session layer set with any temporary activation or\n visibility settings configured in the scene graph tree. Set it to\n False to return the stage without these overrides applied in the\n session layer.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n The apply_viewport_overrides flag controls whether or not the\n returned stage will have the LOP Network's current set of viewport\n overrides applied to the session layer. These viewport overrides are\n authored by interacting with the Scene Graph Tree pane.\n\n The ignore_errors flag can be set to True to indicate that if this\n LOP node is in an error state after cooking, this method should\n search up the network looking for the first node not in an error\n state, and return the stage from that node instead.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n The apply_post_layers flag controls whether or not the returned\n stage will have the LOP Network's post-layers applied to the session\n layer.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def sourceLayer(self, layer_index: int = ..., output_index: int = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, Any] = ...) -> pxr.Sdf.Layer:\n \"\"\"\n\n sourceLayer(self, layer_index = 0, output_index = -1,\n use_last_cook_context_options = True, frame = None, context_options =\n {}) -> pxr.Sdf.Layer\n\n Return a pxr.Sdf.Layer object representing the specific requested\n USD layer that is used to build the stage that is the output of this\n node.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def stagePrimStats(self, primpath: str|None = ..., output_index: int = ..., apply_viewport_overrides: bool = ..., ignore_errors: bool = ..., do_geometry_counts: bool = ..., do_separate_purposes: bool = ..., use_last_cook_context_options: bool = ..., apply_post_layers: bool = ..., frame: float|None = ..., context_options: Mapping[str, str|float]|None = ...) -> dict[str, int]:\n \"\"\"\n\n stagePrimStats(self, primpath = None, output_index = -1,\n apply_viewport_overrides = False, ignore_errors = False,\n do_geometry_counts = False, do_separate_purposes = False,\n use_last_cook_context_options = True, apply_post_layers = True, frame =\n None, context_options = {}, do_kind_counts = False, include_root = True)\n -> dict\n\n Returns a dictionary of statistics about the specified USD primitive\n on the USD stage output from this node. These statistics include a\n count of primitives of each type, the number of primitives with\n loaded and unloaded payloads, and other useful information about the\n type and complexity of information under the specified primitive.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n Set apply_viewport_overrides to True to return statistics from a\n stage with its session layer set with any temporary activation or\n visibility settings configured in the scene graph tree. Set it to\n False to return the statistics for the stage with an empty session\n layer.\n\n The apply_post_layers flag controls whether or not the stats will be\n generated with the LOP Network's post-layers applied to the session\n layer.\n\n The ignore_errors parameter can be set to True to indicate that if\n this LOP node is in an error state after cooking, this method should\n search up the network looking for the first node not in an error\n state, and return the statistics from that node instead.\n\n The do_geometry_counts parameter can be set to True to generate more\n details information about some USD primitive types, such as the\n total number of polygons on Mesh primitives, the number of curves on\n BasisCurves primitives, and the number of instances in\n PointInstancer primitives. The generation of these statistics may\n involve reading additional data from USD files on disk.\n\n Set do_separate_purposes to True to return per-purpose statistics,\n as well as the total counts. This separation into purposes applies\n to both basic primitive counts and the detailed geometry counts.\n\n Set do_kind_counts to True to return counts of the number of prims\n of each Kind. The returned dictionary of stats puts the count for\n each kind under a key of the form Kind::count. The\n validity of the model hierarchy is taken into account, so a prim\n that specifies group kind but which is not part of a valid model\n hierarchy will not be counted.\n\n Set include_root to False if you do not want the prim specified by\n primpath to be included in the counts.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def lastModifiedPrims(self) -> Tuple[pxr.Sdf.Path, ...]:\n \"\"\"\n\n lastModifiedPrims(self) -> tuple of pxr.Sdf.Path\n\n Returns the paths of the USD primitives modified by this node's last\n cook.\n\n\n \"\"\"\n def inputPrims(self, inputidx: int) -> Tuple[pxr.Sdf.Path, ...]:\n \"\"\"\n\n inputPrims(self, inputidx) -> tuple of pxr.Sdf.Path\n\n Returns the paths of the USD primitives modified by the specified\n input of this node. Returns None if the input is not connected. This\n method is roughly equivalent to:\n\n > lopnode.inputs()[inputidx].lastModifiedPrims()\n\n \"\"\"\n def setLastModifiedPrims(self, primPaths: Sequence[str]) -> None:\n \"\"\"\n\n setLastModifiedPrims(self, primpaths)\n\n When used in a Python based LOP node, this method sets the value\n that will be returned by subsequent calls to lastModifiedPrims. The\n primpaths parameter must be an iterable of pxr.Sdf.Path objects or\n strings.\n\n\n \"\"\"\n def loadMasks(self, output_index: int = ..., force_cook: bool = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, str|float]|None = ...) -> LopViewportLoadMasks:\n \"\"\"\n\n loadMasks(self, output_index = -1, force_cook = False,\n use_last_cook_context_options = True, frame = None, context_options =\n {}) -> hou.LopViewportLoadMasks\n\n Returns the load masking configuration cooked into the stage at this\n LOP node. This object controls stage population masking and layer\n muting. These masks can be set using the Configure Stage LOP. These\n load masks will affect the primitives available on the stage when\n cooking this node or nodes below it.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n The force_cook flag can be set to True to cause the LOP node to cook\n before returning the load mask.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def sourceLayerCount(self, output_index: int = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, str|float]|None = ...) -> LopViewportLoadMasks:\n \"\"\"\n\n sourceLayerCount(self, output_index = -1, use_last_cook_context_options\n = True, frame = None, context_options = {}) -> int\n\n Returns the number of source layers that are used to build the stage\n at the output of this node. The result from this method will be one\n greater than the maximum value that can be passed to the sourceLayer\n method.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def layersAboveLayerBreak(self, output_index: int = ..., use_last_cook_context_options: bool = ..., frame: float|None = ..., context_options: Mapping[str, str|float]|None = ...) -> Tuple[str,...]:\n \"\"\"\n\n layersAboveLayerBreak(self, output_index = -1,\n use_last_cook_context_options = True, frame = None, context_options =\n {}) -> tuple of str\n\n Returns the identifiers of all layers that will be removed by layer\n flattening or USD save operations because they were added to the\n stage above a Layer Break LOP. These are identifiers may include\n anonymous layer identifiers and paths to USD layers on disk.\n\n The output_index specifies which output of a multi-output LOP to\n access. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n The use_last_cook_context_options flag indicates that when cooking\n this node, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n A frame number can be provided to return the result of cooking the\n LOP node at a particular frame.\n\n The context_options parameter is a dict of str to either str or\n float values. These context options are used to cook the LOP node,\n overriding the current global context options.\n\n\n \"\"\"\n def isMostRecentStageLock(self) -> bool:\n \"\"\"\n\n isMostRecentStageLock(self) -> bool\n\n Return True if this LOP node was the node that most recently locked\n its shared USD stage. Since many LOP nodes can share a single USD\n stage, it is generally node safe to hold onto the result of a call\n to stage() beyond the invocation of a single python function.\n Houdini may need to cook another node in the LOP network that shares\n the USD stage with this node. At which point accessing data from\n this previously fetched stage object can return unexpected results.\n If this method returns True, then it is safe to read from the\n previously fetched stage object, and expect the results to reflect\n the state of the stage as output by this LOP node.\n\n\n \"\"\"\n def inEditLayerBlock(self) -> bool:\n \"\"\"\n\n inEditLayerBlock(self) -> bool\n\n Return True if this LOP node is inside an Edit Layer Block. This\n occurs if this node's input is connected to Edit Layer Begin LOP, or\n another LOP that is in an Edit Layer Block.\n\n\n \"\"\"\n def selectionRule(self, inputidx: int = -1, pattern: Optional[str] = None) -> LopSelectionRule:\n \"\"\"\n\n selectionRule(self, inputidx=-1, pattern=None) -> hou.LopSelectionRule\n\n Returns a selection rule pre-configured to evaluate its pattern\n using this node as the source of the USD stage when calling\n hou.LopSelectionRule.expandedPaths or similar methods that take a\n LOP node as a parameter. The inputidx parameter can further be used\n to cause selection rule evaluations to use the USD stage of one of\n the inputs to this node, instead of this node itself. This shortcut\n can simplify the code for evaluating a rule repeatedly.\n\n The optional pattern parameter populates the selection rule with the\n supplied pattern string. This is equivalent to creating the rule and\n then calling hou.LopSelectionRule.setPathPattern.\n\n\n \"\"\"\n def addLockedGeometry(self, identifier: str, geo: Geometry, args: Mapping[str, str]|None = ...) -> str:\n \"\"\"\n\n addLockedGeometry(self, identifier, geo, args = {}) -> str\n\n Adds a locked copy of a hou.Geometry to a registry, so that it can\n be used as a USD reference or sublayer.\n\n The returned string is a USD layer identifier that can be used when\n adding a composition arc.\n\n If an args dictionary is specified, the contents must be pre-\n converted to be strings. For example: { 't': '1.0' } is valid, but {\n 't': 1.0 } is not.\n\n\n NOTE\n The registry entries created by using this function are tied to\n this LOP node and will be destroyed when the LOP node is\n destroyed.\n\n Example:\n\n > geo = hou.Geometry()\n > geo.loadFromFile('$HH/geo/shaderteapot.bgeo')\n > node = hou.pwd()\n > stage = node.editableStage()\n > layer_id = node.addLockedGeometry('teapot', geo)\n > node.addSubLayer(layer_id)\n\n See also hou.lop.addLockedGeometry\n\n\n \"\"\"\n def addHeldLayer(self, identifier: str) -> None:\n \"\"\"\n\n addHeldLayer(self, identifier)\n\n Add the USD layer specified by the identifier argument to an\n internal registry to prevent it from being deleted by USD if the\n layer is no longer part of a composed stage (for example if it was\n created by a Python LOP inside as Subnet which then had the Bypass\n flag enabled).\n\n Note the loputils.createPythonLayer method will automatically call\n this, and hou.LopNode.addSubLayer similarly holds the layer\n automatically.\n\n > import loputils\n > from pxr import Sdf\n > node = hou.pwd()\n > stage = node.editableStage()\n > layer = loputils.createPythonLayer(node)\n > subLayer1 = loputils.createPythonLayer(node)\n > subLayer2 = Sdf.Layer.CreateAnonymous()\n > node.addHeldLayer(subLayer2.identifier)\n > layer.subLayerPaths.append(subLayer1)\n > layer.subLayerPaths.append(subLayer2)\n > node.addSubLayer(layer.identifier)\n\n \"\"\"\n def addSubLayer(self, identifier: str) -> None:\n \"\"\"\n\n addSubLayer(self, identifier)\n\n Add the USD layer specified by the identifier argument as a sublayer\n to the root layer of the USD stage. The layer identifier can refer\n to an existing file on disk, or an anonymous layer created earlier\n in the python script. Call editableStage() before calling this\n method, or it will raise an exception.\n\n Houdini has certain requirements for anonymous layers authored by\n LOP nodes to ensure that they can be saved to disk in a predictable\n way. The loputils.createPythonLayer method creates a new layer,\n properly configured so that it can be added to the LOP stage and\n saved to disk like any other LOP-authored layer.\n\n > import loputils\n > from pxr import Sdf\n > node = hou.pwd()\n > stage = node.editableStage()\n > layer = loputils.createPythonLayer(node, '$HIP/myfile.usda')\n > p = Sdf.CreatePrimInLayer(layer, '/cube')\n > p.specifier = Sdf.SpecifierDef\n > p.typeName = 'Cube'\n > node.addSubLayer(layer.identifier)\n\n \"\"\"\n def savePaths(self) -> Tuple[str, ...]:\n \"\"\"\n\n savePaths(self) -> list of str\n\n Returns a list of all the save paths for all layers used by the\n stage.\n\n\n \"\"\"\n\nclass lop:\n \"\"\"\n\n hou.lop\n\n Module containing functions related to Houdini LOP nodes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def defaultNewPrimPath() -> str:\n \"\"\"\n\n defaultNewPrimPath() -> str\n\n Return the USD primitive path that will be used by default on new\n LOP nodes with a primpath parameter with a default of /$OS.\n\n\n \"\"\"\n @staticmethod\n def setDefaultNewPrimPath(path: str) -> None:\n \"\"\"\n\n setDefaultNewPrimPath(path)\n\n Set the USD primitive path that will be used by default on new LOP\n nodes with a primpath parameter with a default of /$OS. This\n identifies a parameter that is used to create a new USD primitive.\n Being able to control this default makes it easier to conform to\n studio-wide standard naming conventions for primitive paths.\n\n\n \"\"\"\n @staticmethod\n def defaultCollectionsPrimPath() -> str:\n \"\"\"\n\n defaultCollectionsPrimPath() -> str\n\n Return the USD primitive path that will be used as the default\n location when creating new collections. If not set, the default\n value is /collections.\n\n\n \"\"\"\n @staticmethod\n def setDefaultCollectionsPrimPath(path: str) -> None:\n \"\"\"\n\n setDefaultCollectionsPrimPath(path)\n\n Set the USD primitive path that will be used as the default location\n when creating new collections. Being able to control this default\n makes it easier to conform to studio-wide standard naming\n conventions for primitive paths.\n\n\n \"\"\"\n @staticmethod\n def defaultCollectionsPrimType() -> str:\n \"\"\"\n\n defaultCollectionsPrimType() -> str\n\n Return the USD primitive type that will be created for holding\n collections when the destination primitive doesn't already exist. If\n not set, the default value is an empty string, indicating that a\n typeless primitive will be created.\n\n\n \"\"\"\n @staticmethod\n def setDefaultCollectionsPrimType(primtype: str) -> None:\n \"\"\"\n\n setDefaultCollectionsPrimType(path)\n\n Set the USD primitive type that will be created for holding\n collections when the destination primitive doesn't already exist.\n Being able to control this default makes it easier to conform to\n studio-wide standard conventions for using primitive types.\n\n\n \"\"\"\n @staticmethod\n def defaultLightsPrimPath() -> str:\n \"\"\"\n\n defaultLightsPrimPath() -> str\n\n Return the USD primitive path that will be used as the default\n location when creating new lights. If not set, the default value is\n /lights.\n\n\n \"\"\"\n @staticmethod\n def setDefaultLightsPrimPath(path: str) -> None:\n \"\"\"\n\n setDefaultLightsPrimPath(path)\n\n Set the USD primitive path that will be used as the default location\n when creating new lights. Being able to control this default makes\n it easier to conform to studio-wide standard naming conventions for\n primitive paths.\n\n\n \"\"\"\n @staticmethod\n def defaultCamerasPrimPath() -> str:\n \"\"\"\n\n defaultCamerasPrimPath() -> str\n\n Return the USD primitive path that will be used as the default\n location when creating new cameras. If not set, the default value is\n /cameras.\n\n\n \"\"\"\n @staticmethod\n def setDefaultCamerasPrimPath(path: str) -> None:\n \"\"\"\n\n setDefaultCamerasPrimPath(path)\n\n Set the USD primitive path that will be used as the default location\n when creating new cameras. Being able to control this default makes\n it easier to conform to studio-wide standard naming conventions for\n primitive paths.\n\n\n \"\"\"\n @staticmethod\n def defaultTransformSuffix() -> str:\n \"\"\"\n\n defaultTransformSuffix() -> str\n\n Return the string that will be used as the default suffix on\n transform attribute names.\n\n\n \"\"\"\n @staticmethod\n def setDefaultTransformSuffix(suffix: str) -> None:\n \"\"\"\n\n setDefaultTransformSuffix(suffix)\n\n Set the string that will be used as the default suffix on transform\n attribute names. USD transforms always start with xformOp: followed\n by the transform type (translate, rotate, transform), followed by an\n optional suffix that describes the transform. This string is the\n default Houdini will use in situations where this suffix can be\n provided, which can help make USD layers authored in LOPs conform to\n studio-wide standard naming conventions.\n\n\n \"\"\"\n @staticmethod\n def showResolvedPaths() -> bool:\n \"\"\"\n\n showResolvedPaths() -> bool\n\n Return True if the option to show resolved layer file paths is\n turned on.\n\n\n \"\"\"\n @staticmethod\n def setShowResolvedPaths(show_resolved_paths: bool) -> None:\n \"\"\"\n\n setShowResolvedPaths(show_resolved_paths)\n\n Set the option to control whether panels that show layer file paths\n should display the exact path set on the layer, or the path after\n passing it through the USD path resolver. The resolved path will\n generally be a full path to a file on disk, where the unresolved\n path may be a relative path, a search path, or a path format that is\n specific to a custom resolver.\n\n\n \"\"\"\n @staticmethod\n def panesFollowCurrentNode() -> bool:\n \"\"\"\n\n panesFollowCurrentNode() -> bool\n\n Return True if LOP panes such as the Scene Graph Tree and Scene\n Graph Details should follow the current node selected in the network\n editor.\n\n\n \"\"\"\n @staticmethod\n def setPanesFollowCurrentNode(follow_current_node: bool) -> None:\n \"\"\"\n\n setPanesFollowCurrentNode(follow_current_node)\n\n Set the option for LOP panes such as the Scene Graph Tree and Scene\n Graph Details to follow the current node selected in the network\n editor. If set to False, these panes will instead show information\n for the LOP node with its display flag set.\n\n\n \"\"\"\n @staticmethod\n def panesShowViewportStage() -> bool:\n \"\"\"\n\n panesShowViewportStage() -> bool\n\n Return True if LOP panes such as the Scene Graph Tree and Scene\n Graph Details should show information about the USD stage generated\n by applying any viewport overrides set in the Scene Graph Tree.\n\n\n \"\"\"\n @staticmethod\n def setPanesShowViewportStage(show_viewport_stage: bool) -> None:\n \"\"\"\n\n setPanesShowViewportStage(show_viewport_stage)\n\n Set the option for LOP panes such as the Scene Graph Tree and Scene\n Graph Details to show information about the USD stage generated by\n applying any viewport overrides set in the Scene Graph Tree.\n\n Turning this option off will improve the performance of these panes\n when there are viewport overrides applied to the scene. The tradeoff\n is that the values shown in the scene graph tree and scene graph\n details for visibility and activation may not match what is shown in\n the viewport. However it will better match the scene description\n that would be used by a final render, as viewport overrides are not\n included in the USD sent to a final render.\n\n\n \"\"\"\n @staticmethod\n def panesShowPostLayers() -> bool:\n \"\"\"\n\n panesShowPostLayers() -> bool\n\n Return True if LOP panes such as the Scene Graph Tree and Scene\n Graph Details should show information about the USD stage generated\n by applying any post-layers applied to the parent LOP Network.\n\n\n \"\"\"\n @staticmethod\n def setPanesShowPostLayers(show_post_layers: bool) -> None:\n \"\"\"\n\n setPanesShowPostLayers(show_post_layers)\n\n Set the option for LOP panes such as the Scene Graph Tree and Scene\n Graph Details to show information about the USD stage generated by\n applying any post-layers applied to the parent LOP Network.\n\n\n \"\"\"\n @staticmethod\n def autoSetAssetResolverContext() -> bool:\n \"\"\"\n\n autoSetAssetResolverContext() -> bool\n\n Return True if the Sublayer and Reference LOP nodes should\n automatically use their first USD layer loaded from disk as the\n resolver context asset path passed to the USD stage to define it's\n asset resolver context.\n\n\n \"\"\"\n @staticmethod\n def setAutoSetAssetResolverContext(auto_set_context: bool) -> None:\n \"\"\"\n\n setAutoSetAssetResolverContext(auto_set_context)\n\n Pass in a value of True if the Sublayer and Reference LOP nodes\n should automatically use their first USD layer loaded from disk as\n the resolver context asset path passed to the USD stage to define\n it's asset resolver context. The resolver context is used by the USD\n asset resolver to help find the right files when opening a layer\n file in the context of a particular stage. Often this resolver\n context can be determined by looking at the root layer of the stage.\n In the case of LOPs, the first layer loaded by a Sublayer or\n Reference LOP is the closest thing we have to a root layer. This\n preference makes it easier to implement this workflow. The\n alternative involves using a Configure Stage LOP as the first node\n in the LOP Network to explicitly set the resolver context asset\n path. Similarly this option only affects a Sublayer or Reference LOP\n if it is the first node in the chain.\n\n\n \"\"\"\n @staticmethod\n def updateRendererInBackground() -> bool:\n \"\"\"\n\n updateRendererInBackground() -> bool\n\n Return True if the LOP viewport has been configured to run update\n tasks in the background.\n\n\n \"\"\"\n @staticmethod\n def setUpdateRendererInBackground(update_in_background: bool) -> None:\n \"\"\"\n\n setUpdateRendererInBackground(update_in_background)\n\n Pass in a value of True to cause the LOP viewport to run update\n tasks in the background, which results in better interactivity but\n allows the viewport display to be temporarily out of sync with the\n current cooked LOP stage.\n\n\n \"\"\"\n @staticmethod\n def loadPayloadsByDefault() -> bool:\n \"\"\"\n\n loadPayloadsByDefault() -> bool\n\n Return True if new LOP Networks will be created with the option to\n load all payloads in the viewport enabled.\n\n\n \"\"\"\n @staticmethod\n def setLoadPayloadsByDefault(load_payloads: bool) -> None:\n \"\"\"\n\n setLoadPayloadsByDefault(load_payloads)\n\n Pass in a value of True to cause new LOP Networks to be created with\n the option to load all payloads in the viewport enabled. Pass in a\n value of False to disable the loading of payloads in the viewport\n for any new LOP Networks. No existing LOP Networks are affected by\n this method. The default value for this preference is True.\n\n\n \"\"\"\n @staticmethod\n def allowViewportOnlyPayloads() -> bool:\n \"\"\"\n\n allowViewportOnlyPayloads() -> bool\n\n Return True if the scene graph tree can allow the user to force the\n loading of a payload into the viewport which has been prevented from\n loading by a Configure Stage node. Return False if the scene graph\n tree should prevent the explicit loading of such payloads. This\n value ensures that the viewport will only show payloads that have\n been processed by the LOP network, eliminating a potential mismatch\n between the scene displayed in the viewport, and the same scene\n rendered with the USD Render ROP with a different set of loaded\n payloads processed by the LOP Network.\n\n\n \"\"\"\n @staticmethod\n def setAllowViewportOnlyPayloads(allow_viewport_only_payloads: bool) -> None:\n \"\"\"\n\n setAllowViewportOnlyPayloads(allow_viewport_only_payloads)\n\n Set the flag that indicates whether the viewport is allowed to load\n payloads that have been specified as unloaded by a Configure Stage\n node.\n\n\n \"\"\"\n @staticmethod\n def pathParameterCompletion() -> bool:\n \"\"\"\n\n pathParameterCompletion() -> bool\n\n Return True if USD Primitive Path parameters should provide syntax\n highlighting and prim path completion hints. Enabling this may cause\n pauses when editing Primitive Path parameters with very large USD\n stages.\n\n\n \"\"\"\n @staticmethod\n def setPathParameterCompletion(path_parameter_completion: bool) -> None:\n \"\"\"\n\n setPathParameterCompletion(path_parameter_completion)\n\n Set the flag that indicates whether the USD Primitive Path\n parameters should provide path completion hints.\n\n\n \"\"\"\n @staticmethod\n def defaultMetersPerUnit() -> float:\n \"\"\"\n\n defaultMetersPerUnit() -> float\n\n Return the default meters per unit metric that will be saved into\n USD layers that do not have this value explicitly set. A value of\n zero indicates that Houdini's Unit Length option will be used to\n generate an equivalent meters per unit value.\n\n\n \"\"\"\n @staticmethod\n def setDefaultMetersPerUnit(meters_per_unit: float) -> None:\n \"\"\"\n\n setDefaultMetersPerUnit(meters_per_unit)\n\n Set the default meters per unit metric that will be saved into USD\n layers that do not have this value explicitly set. A value of zero\n indicates that Houdini's Unit Length option should be used to\n generate an equivalent meters per unit value.\n\n\n \"\"\"\n @staticmethod\n def defaultUpAxis() -> str:\n \"\"\"\n\n defaultUpAxis() -> str\n\n Return the default up axis value that will be saved into USD layers\n that do not have this value explicitly set. An empty string\n indicates that the USD up axis fallback value\n (pxr.UsdGeom.GetFallbackUpAxis) should be used.\n\n\n \"\"\"\n @staticmethod\n def setDefaultUpAxis(up_axis: str) -> None:\n \"\"\"\n\n setDefaultUpAxis(up_axis)\n\n Set the default up axis that will be saved into USD layers that do\n not have this value explicitly set. An empty string indicates that\n the USD up axis fallback value (pxr.UsdGeom.GetFallbackUpAxis)\n should be used. Other acceptable values are Y and Z. Trying to set\n any other value will raise a hou.ValueError exception.\n\n\n \"\"\"\n @staticmethod\n def savePreferences() -> bool:\n \"\"\"\n\n savePreferences() -> bool\n\n Saves out the current LOP preferences to\n $HOME/houdiniX.Y/solaris.pref. This happens automatically when the\n preferences are modified in the preferences dialog, and when exiting\n Houdini. But in a batch scripting environment, changes made to these\n preferences will not be saved automatically, so this method must be\n used. Returns True is the preference file was saved successfully.\n\n\n \"\"\"\n @staticmethod\n def reloadLayer(layer_path: str, recursive: bool = False) -> None:\n \"\"\"\n\n reloadLayer(layer_path, recursive = False)\n\n This method calls the USD Reload method for the specified layer\n path. In addition, it updates internal Houdini data structures of\n the reload so that they can update. This method should be used in\n place of the pxr.Sdf.Layer.Reload or similar methods when running in\n Houdini.\n\n Setting the recursive parameter to True will cause Houdini to\n recursively look for other layers referenced by the specified layer,\n and reload them as well.\n\n\n \"\"\"\n @staticmethod\n def mutingIdentifier(identifier: str) -> str:\n \"\"\"\n\n mutingIdentifier(self, identifier)\n\n Return the identifier that will be returned by\n hou.LopViewportLoadMasks.muteLayers when muting a USD layer authored\n by a LOP node. This identifier will be of the form\n lop:/path/to/lop/node, which is not a valid USD layer identifier,\n and should not be used as such. But in the context of layer muting,\n this special string is recognized as a way to mute anonymous layers\n authored by LOP nodes (even if that LOP node occurs later in the LOP\n network). When calling hou.LopViewportLoadMasks.addMuteLayer or\n hou.LopViewportLoadMasks.removeMuteLayer, either the original\n anonymous LOP layer identifier of the return of calling this method\n are acceptable. Anonymous layer identifiers will be automatically\n translated into this special muting identifier form.\n\n\n \"\"\"\n @staticmethod\n def makeValidPrimName(name: str) -> str:\n \"\"\"\n\n makeValidPrimName(name) -> str\n\n This function ensures that a string meets the requirements of a\n legal USD primitive name that can be used as part of a valid\n primitive path. Invalid characters such as spaces and most\n punctuation will be converted to underscores. Note that this means\n the translation is not reversible. If the original string is already\n a legal primitive name, the name is returned unchanged.\n\n\n \"\"\"\n @staticmethod\n def makeValidPrimPath(path: str, allow_relative: bool = False) -> str:\n \"\"\"\n\n makeValidPrimPath(path, allow_relative = False) -> str\n\n This function ensures that a string meets the requirements of a\n legal USD primitive path that can be converted into a psx.Sdf.Path\n object. Invalid characters such as spaces and most punctuation will\n be converted to underscores. Note that this means the translation is\n not reversible. If the original string is already a legal primitive\n path, the string is returned unchanged.\n\n If the allow_relative value is True, the path is allowed to be a\n relative primitive path. A relative path is one that starts with ./\n or ../. If this argument is False, only absolute paths (which start\n with /) are allowed. Relative prefixes are simply removed from the\n path and the returned path will always start with a /.\n\n\n \"\"\"\n @staticmethod\n def createParmsForProperty(source: LopNode|str, primpath: str, propertyname: str, parametername: str|None = ..., prepend_control_parm: bool = ..., prefix_xform_parms: bool = ...) -> ParmTemplateGroup:\n \"\"\"\n\n createParmsForProperty(source, primpath, propertyname, parametername,\n prepend_control_parm, prefix_xform_parms) -> [Hom:hou.ParmTemplateGroup]\n\n Given a property on a USD stage, this method returns a\n hou.ParmTemplateGroup object that describes the parameters that can\n be placed on an Edit Properties LOP node to control that USD\n property.\n\n\n source\n Either a hou.LopNode object or a string. If a hou.LopNode, the\n property is extracted from the USD stage owned by that LOP node.\n If a string, the USD file on disk at the specified path will be\n loaded, and the property extracted from there.\n\n primpath\n Path to the USD primitive where the property lives.\n\n propertyname\n The name of the USD property for which parameters will be\n created.\n\n parametername\n The name of the parameter to generate. This value can be a\n string or None, in which case the parameter name will match the\n property name. It is the parameter names that determines the\n name of the property that will be authored by the Edit\n Properties node, so setting a value for this parameter will\n cause a different property to be authored than the one used to\n generate the parameter.\n\n prepend_control_parm\n Set to True if the returned parameter template group should\n include a menu for choosing whether the property value should be\n set, ignored, or one of the other standard actions supported by\n the Edit Properties node.\n\n prefix_xform_parms\n If the specified property is a transform property, this method\n will generate separate translate, rotate, scale, and other\n parameters that get combined to generate a transformation\n matrix. If this option is set to False, these additional\n parameters will use standard Houdini transform parameter names\n like t, s, and r. If set to True, these parameter will be\n prefixed by the property name, which means the parameter names\n will not conflict with other transform parameters on the Edit\n Properties node.\n\n\n \"\"\"\n @staticmethod\n def createParmsForParameter(source: ParmTemplate, parametername: Optional[str] = None, usdvaluetype: Optional[str] = None, prepend_control_parm: bool = True, propertyname: Optional[str] = None) -> ParmTemplateGroup:\n \"\"\"\n\n createParmsForParameter(source, parametername, usdvaluetype,\n prepend_control_parm, propertyname) -> [Hom:hou.ParmTemplateGroup]\n\n Given a source node parameter, this method returns a\n hou.ParmTemplateGroup object that describes the parameters that can\n be placed on an Edit Properties LOP node to control a value of a\n corresponding USD property.\n\n The returned group contains a control parameter that decides how the\n USD property is changed and a value parameter, which is very similar\n to the given parameter, except for disable-when condition and a few\n other small differences.\n\n\n source\n A hou.ParmTemplate object on which to base the returned edit\n parameter group.\n\n parametername\n The name of the parameter to generate. This value can be a\n string or None, in which case the parameter name will match the\n given parameter.\n\n usdvaluetype\n The name of the USD type of the corresponding USD attribute.\n\n prepend_control_parm\n Set to True if the returned parameter template group should\n include a menu for choosing whether the property value should be\n set, ignored, or one of the other standard actions supported by\n the Edit Properties node.\n\n propertyname\n The name of the USD property that corresponds to this parameter.\n Usually, property name is inferred from the parameter name, but,\n optionally, it can be explicitly specified with this parameter.\n\n\n \"\"\"\n @staticmethod\n def createConnectionParmsForProperty(source: LopNode|str, primpath: str, propertyname: str, parametername: str|None = ..., prepend_control_parm: bool = ...) -> ParmTemplateGroup:\n \"\"\"\n\n createConnectionParmsForProperty(source, primpath, propertyname,\n parametername=None, prepend_control_parm=True) ->\n [Hom:hou.ParmTemplateGroup]\n\n Given a property on a USD stage, this method returns a\n hou.ParmTemplateGroup object that describes the parameters that can\n be placed on an Edit Properties LOP node to modify the connection of\n that USD (destination) property to a source attribute.\n\n\n source\n Either a hou.LopNode object or a string. If a hou.LopNode, the\n property is extracted from the USD stage owned by that LOP node.\n If a string, the USD file on disk at the specified path will be\n loaded, and the property extracted from there.\n\n primpath\n Path to the USD primitive where the property lives.\n\n propertyname\n The name of the USD property for which parameters will be\n created.\n\n parametername\n The name of the parameter to generate. This value can be a\n string or None, in which case the parameter name will be based\n on the property name.\n\n prepend_control_parm\n Set to True if the returned parameter template group should\n include a menu for choosing whether the property connection\n should be set, severed, or ignored or one of the other standard\n actions supported by the Edit Properties node.\n\n\n \"\"\"\n @staticmethod\n def setParmTupleFromProperty(parmtuple: ParmTuple, source: LopNode|str, primpath: str, propertyname: str) -> None:\n \"\"\"\n\n setParmTupleFromProperty(parmtuple, source, primpath, propertyname)\n\n Set the value of a node parameter tuple from the value of a property\n on a USD primitive. If the parameter cannot be set because the data\n type of the parameter is not compatible with the data type of the\n USD property, or the USD property cannot be found, raises a\n hou.OperationFailed exception.\n\n\n parmtuple\n A hou.ParmTuple object specifying the parameter which should be\n set to the value of the USD property.\n\n source\n A hou.LopNode object holding the USD stage from which the USD\n property value will be extracted.\n\n Either a hou.LopNode object or a string. If a hou.LopNode, the\n property value is extracted from the USD stage owned by that LOP\n node. If a string, the USD file on disk at the specified path\n will be loaded, and the property value extracted from there.\n\n primpath\n A string indicating the scene graph path of the USD primitive.\n\n propertyname\n A string indicating the name of the property on the USD\n primitive.\n\n\n \"\"\"\n @staticmethod\n def shaderTranslatorID(node: Node) -> int:\n \"\"\"\n\n shaderTranslatorID(node) -> int\n\n Returns the ID of the shader translator for the given node. The ID\n is specific to Houdini session and can change between them.\n\n\n \"\"\"\n @staticmethod\n def shaderRenderContextName(node: Node, node_output_name: str) -> str:\n \"\"\"\n\n shaderRenderContextName(node, node_output_name) -> str\n\n Returns the render context name for the given node and output. It is\n used in the USD material primitive output name, to associate the\n connected shader with a given renderer.\n\n\n node\n The shader node to whose render context name to return.\n\n node_output_name\n The output name for which to return the render context name.\n Nodes can have several output, each for a different renderer.\n\n\n \"\"\"\n @staticmethod\n def translateShader(node: Node, node_output_name: str, material_prim_path: str, container_prim_path: str, shader_prim_name: str|None = ..., frame: float|None = ...) -> str:\n \"\"\"\n\n translateShader(node, node_output_name, material_prim_path,\n container_prim_path, shader_prim_name=None, frame=None ) -> str\n\n Creates a new shader primitive and returns a path to the shader\n primitive output.\n\n\n node\n The shader node to translate into a USD shader primitive.\n\n node_output_name\n The node output that represents the shader to translate (if the\n node is a material), or an output value that is needed as an\n input to another USD shader primitive.\n\n material_prim_path\n The USD path to the material primitive that contains the USD\n shader.\n\n container_prim_path\n The path to the parent primitive (ie, NodeGraph or Material) in\n which the USD shader should be directly authored.\n\n shader_prim_name\n The name to be used for the created USD shader primitive. If not\n given, it will be inferred from the node.\n\n frame\n The frame number at which to evaluate node parameters, and also\n the USD time code at which to author animated attributes. If not\n given, the current time is used for evaluating parameters, and\n the USD attribute values are authored at the default time code.\n\n\n \"\"\"\n @staticmethod\n def reportShaderTranslation(node: Node, usd_shader_path: str) -> None:\n \"\"\"\n\n reportShaderTranslation(node, usd_shader_path)\n\n Adds an entry to the table of known shader translations. This allows\n LOPs to find out the USD shader primitives given a shader VOP node,\n which is necessary for incremental re-translation of shaders.\n\n\n node\n The shader node that was translated into a USD shader primitive.\n\n usd_shader_path\n The USD shader primitive path to which the node was translated.\n\n\n \"\"\"\n @staticmethod\n def shaderNodeType(shader_name: str) -> NodeType:\n '''\n\n shaderNodeType(shader_name) -> hou.NodeType\n\n Returns a shader hou.NodeType given the shader name.\n\n Shader name is generic identifier of the abstract shader entity, and\n the returned node type is a representation of that shader in a form\n of the node of that type.\n\n For example, shader \\\\\"foo\\\\\" may correspond to a VOP node of type\n my_namespace::FooShader::2.0.\n\n\n '''\n @staticmethod\n def availableRendererNames() -> Tuple[str, ...]:\n \"\"\"\n\n availableRendererNames() -> tuple of str\n\n Returns a tuple with the internal names of registered renderer\n plugins.\n\n\n \"\"\"\n @staticmethod\n def availableRendererLabels() -> Tuple[str, ...]:\n \"\"\"\n\n availableRendererLabels() -> tuple of str\n\n Returns a tuple with the display labels of registered renderer\n plugins.\n\n\n \"\"\"\n @staticmethod\n def outputProcessors() -> Tuple[Tuple[str, str], ...]:\n \"\"\"\n\n outputProcessors() -> tuple of tuple of str\n\n Returns a tuple holding the internal name and user facing label for\n each output processor plugin in the registry. See the USD ROP for\n more information about output processors.\n\n\n \"\"\"\n @staticmethod\n def outputProcessorParms(name: str) -> ParmTemplateGroup:\n \"\"\"\n\n outputProcessorParms(name) -> hou.ParmTemplateGroup\n\n Returns the parameters that can be used to configure the output\n processor with an internal name that matches the name parameter. See\n the USD ROP for more information about output processors.\n\n\n \"\"\"\n @staticmethod\n def usdVersionInfo() -> dict[str, str]:\n \"\"\"\n\n usdVersionInfo() -> dict of str to str\n\n Returns a dictionary holding information about the USD library built\n into Houdini.\n\n\n usdversion\n The USD release number converted to a string. USD releases take\n the form YY.MM, where YY and MM are the year and month in which\n the release occurred.\n\n packageurl\n The URL of the git repository from which the USD library was\n built.\n\n packagerevision\n The git commit hash code for the specific branch used to build\n the USD library.\n\n The packageurl and packagerevision values may return an empty string\n if the USD library that ships with Houdini is replaced with a custom\n USD build.\n\n\n \"\"\"\n @staticmethod\n def usdOutputMinimumSeverity() -> EnumValue:\n \"\"\"\n\n usdOutputMinimumSeverity() -> hou.severityType\n\n Returns the minimum USD message severity that will be output to\n standard output. The USD library can produce a variety of messages\n indicating error or warning conditions, or just status messages. If\n such a message is generated while a LOP node is cooking, the message\n will never be output to the console, regardless of this setting.\n\n\n \"\"\"\n @staticmethod\n def setUsdOutputMinimumSeverity(severity: EnumValue) -> None:\n \"\"\"\n\n setUsdOutputMinimumSeverity(hou.severityType)\n\n Sets the minimum message severity produced by the USD library that\n should be written to standard output. This method only controls the\n output of messages produced when a LOP node is not cooking.\n\n\n \"\"\"\n @staticmethod\n def addLockedGeometry(identifier: str, geo: Geometry, args: Mapping[str, str]|None = ...) -> str:\n \"\"\"\n\n addLockedGeometry(self, identifier, geo, args = {}) -> str\n\n Adds a locked copy of a hou.Geometry to a registry, so that it can\n be used as a USD reference or sublayer.\n\n The returned string is a USD layer identifier that can be used when\n adding a composition arc.\n\n If an args dictionary is specified, the contents must be pre-\n converted to be strings. For example: { 't': '1.0' } is valid, but {\n 't': 1.0 } is not.\n\n\n NOTE\n The registry entries created by using this function must be\n explicitly removed via hou.lop.removeLockedGeometry.\n\n Example:\n\n > from pxr import Usd\n > geo = hou.Geometry()\n > geo.loadFromFile('shaderteapot.bgeo')\n > stage = Usd.Stage.CreateInMemory()\n > layer_id = hou.lop.addLockedGeometry('teapot', geo)\n > stage.GetRootLayer().subLayerPaths.append(layer_id)\n\n See also hou.LopNode.addLockedGeometry\n\n\n \"\"\"\n @staticmethod\n def removeLockedGeometry(identifier: str) -> bool:\n \"\"\"\n\n removeLockedGeometry(self, identifier) -> bool\n\n Removes a locked hou.Geometry from the registry, returning a bool to\n indicate success or failure.\n\n\n NOTE\n The identifier should be the str value returned from a previous\n call to hou.lop.addLockedGeometry.\n\n Example:\n\n > geo = hou.Geometry()\n > geo.loadFromFile('shaderteapot.bgeo')\n > layer_id = hou.lop.addLockedGeometry('teapot', geo)\n > hou.lop.removeLockedGeometry(layer_id)\n\n \"\"\"\n @staticmethod\n def forceReloadAllFilesFromDisk(reload_viewports: bool = False) -> None:\n \"\"\"\n\n forceReloadAllFilesFromDisk(self, reload_viewports)\n\n Presses the reload button on every LOP node with such a parameter.\n If the reload_viewports parameter is True, this method also clears\n all USD stages owned by scene viewer panes, which will effectively\n cause all USD stages in Houdini to be rebuilt from scratch. This is\n a potentially very expensive operation, but in some cases may be\n required to force USD to reload and re-resolve paths to assets on\n disk, such as when the configuration of an asset resolver has been\n changed.\n\n\n \"\"\"\n @staticmethod\n def availableRendererInfo() -> list[dict[str, Any]]:\n \"\"\"\n\n availableRendererInfo() -> list of dict\n\n Returns a list of dicts containing meta data for registered renderer\n plugins.\n\n\n \"\"\"\n @staticmethod\n def addPreferenceChangeCallback(callback: Callable) -> None:\n \"\"\"\n\n addPreferenceChangeCallback(callback)\n\n Registers a callback function that is invoked any time one of these\n preferences is changed.\n\n\n \"\"\"\n @staticmethod\n def removePreferenceChangeCallback(callback: Callable) -> None:\n \"\"\"\n\n removePreferenceChangeCallback(callback)\n\n Deregisters a callback function previously registered with a call to\n addPreferenceChangeCallback.\n\n\n \"\"\"\n\nclass LopExpansionState:\n \"\"\"\n\n hou.LopExpansionState\n\n Used to inspect or edit the scene graph tree expansion state of a LOP\n network.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Create an empty expansion state object, with no expanded primitives.\n\n\n \"\"\"\n def setPinnedPathExpanded(self, path: str, expanded: bool) -> bool:\n \"\"\"\n\n setPinnedPathExpanded(self, path, expanded) -> bool\n\n Change the expanded state of a single path in the pinned primitives\n section of the scene graph tree to be either expanded or collapsed.\n Returns True if this changes the expansion state, False otherwise.\n\n\n \"\"\"\n def setPathExpanded(self, path: str, expanded: bool) -> bool:\n \"\"\"\n\n setPathExpanded(self, path, expanded) -> bool\n\n Change the expanded state of a single path in the scene graph tree\n to be either expanded or collapsed. Returns True if this changes the\n expansion state, False otherwise.\n\n\n \"\"\"\n def setPrimitiveExpansionUnlocked(self, path: str, preserve_descendant_expansion: bool = True) -> bool:\n \"\"\"\n\n setPrimitiveExpansionUnlocked(self, path,\n preserve_descendant_expansion=True) -> bool\n\n Removes the path from the expansionLockedPrimitives set. This also\n removes this prim and all its descendants from the\n expansionLockedExpandedPrimitives set.\n\n Setting preserve_descendant_expansion to False causes this method to\n remove all descendants of the path from the list of expansion locked\n and expansion locked expanded prims before setting the newly\n requested expansion locking and expanded states.\n\n\n \"\"\"\n def dumps(self) -> bytes:\n \"\"\"\n\n dumps(self) -> hou.BinaryString\n\n Serialize the contexts of this expansion state object into a binary\n string.\n\n\n \"\"\"\n def loads(self, expansion_str: bytes) -> None:\n \"\"\"\n\n loads(self, overrides_str)\n\n Load the contents of a binary string into this expansion state\n object.\n\n\n \"\"\"\n def expandedPinnedPaths(self) -> Any:\n \"\"\"\n\n expandedPinnedPaths(self) -> tuple of pxr.Sdf.Path\n\n Return a tuple of paths that are expanded in the pinned primitives\n branch of the scene graph tree.\n\n\n \"\"\"\n def setExpandedPinnedPaths(self, expanded_paths: Any) -> None:\n \"\"\"\n\n setExpandedPinnedPaths(self, expanded_paths)\n\n The expanded_paths parameter is an iterable collection of strings or\n pxr.Sdf.Path objects indicating which primitives in the pinned\n primitives branch of the scene graph tree should be expanded.\n\n\n \"\"\"\n def expandedPaths(self) -> Any:\n \"\"\"\n\n expandedPaths(self) -> tuple of pxr.Sdf.Path\n\n Return a tuple of paths that are expanded in the scene graph tree.\n\n\n \"\"\"\n def setExpandedPaths(self, expanded_paths: Any) -> None:\n \"\"\"\n\n setExpandedPaths(self, expanded_paths)\n\n The expanded_paths parameter is an iterable collection of strings or\n pxr.Sdf.Path objects indicating which primitives in the scene graph\n tree should be expanded.\n\n\n \"\"\"\n def expansionLockedPrimitives(self) -> Any:\n \"\"\"\n\n expansionLockedPrimitives(self) -> tuple of pxr.Sdf.Path\n\n Returns the paths of all prims which have had their expansion effect\n in the scene graph tree locked, so this prim and its descendants are\n no longer affected by the scene graph tree expansion state. A prim\n in this set may be either locked in the expanded or collapsed state.\n\n\n \"\"\"\n def expansionLockedExpandedPrimitives(self) -> Any:\n \"\"\"\n\n expansionLockedExpandedPrimitives(self) -> tuple of pxr.Sdf.Path\n\n Returns the paths of all prims which have had their expansion effect\n in the scene graph tree locked in the expanded state. These prims\n will all be in or descndants of prims in the\n expansionLockedPrimitives set. Note that a prim in the\n expansionLockedPrimitives set may not appear in this set if the prim\n has been locked in a collapsed state.\n\n\n \"\"\"\n def setPrimitiveExpansionLocked(self, path: str, expanded_subpaths: Optional[Any] = None, preserve_descendant_expansion: bool = True) -> bool:\n \"\"\"\n\n setPrimitiveExpansionLocked(self, path, expanded_subpaths=None,\n preserve_descendant_expansion=True) -> bool\n\n Locks the expansion state effect of a branch of the scene graph\n tree. The path parameter specifies the root prim which is locked,\n and will appear in the expansionLockedPrimitives set. The\n expanded_subpaths iterable of str or pxr.Sdf.Path objects is the set\n of all prims at or descended from path which should be treated as\n being expanded. For a prim to be treated as expanded by the\n expansion effect, every prim between the root path and the final\n prim must appear in this set.\n\n Prims in the expanded_subpaths which are not descendants of path are\n ignored.\n\n Setting preserve_descendant_expansion to False causes this method to\n remove all descendants of the path from the list of expansion locked\n and expansion locked expanded prims before setting the newly\n requested expansion locking and expanded states.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass LopInstanceIdRule:\n \"\"\"\n\n hou.LopInstanceIdRule\n\n Stores a string that expresses a pattern to select instances from a\n point instancer primitive by id.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Create a LopInstanceIdRule object with default settings.\n\n\n \"\"\"\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def instanceIds(self, lopnode: LopNode, use_last_cook_context_options: bool = True) -> Tuple[int, ...]:\n \"\"\"\n\n instanceIds(self, lopnode, use_last_cook_context_options = True) ->\n tuple of int\n\n Calculates the instance ids that match the pattern on the point\n instancer primitive on the stage generated by the provided LOP node\n object. The returned tuple of integers are ids from the point\n instancer's ids attribute. If no ids attribute is set on the point\n instancer, the instances are assumed to have increasing ids starting\n at 0.\n\n The use_last_cook_context_options flag indicates that when cooking\n the lopnode, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n\n \"\"\"\n def primPath(self) -> str:\n \"\"\"\n\n primPath(self) -> str\n\n Return the path to the point instancer primitive that is used to\n evaluate the instance id pattern.\n\n\n \"\"\"\n def setPrimPath(self, primpath: str) -> None:\n \"\"\"\n\n setPrimPath(self, primpath)\n\n Sets the path to the point instancer primitive that is used to\n evaluate the instance id pattern.\n\n\n \"\"\"\n def instanceIdPattern(self) -> str:\n \"\"\"\n\n instanceIdPattern(self) -> str\n\n Return the pattern that described the instance ids that should be\n returned by the instanceIds method. This pattern accepts standard\n Houdini numeric range formatting, like what is provided in SOP group\n parameters.\n\n\n \"\"\"\n def setInstanceIdPattern(self, pattern: str) -> None:\n \"\"\"\n\n setInstanceIdPattern(self, pattern)\n\n Sets the pattern that described the instance ids that should be\n returned by the instanceIds method. This pattern accepts standard\n Houdini numeric range formatting, like what is provided in SOP group\n parameters, such as 2-5 to indicate ids between 2 and 5, or ^15 to\n exclude id number 15.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass LopPostLayer:\n \"\"\"\n\n hou.LopPostLayer\n\n Provides the ability to author post-layer data on a LOP Network.\n\n This object is used to define a with block in Python, which guarantees a\n well defined lifetime. Inside this block, this object provides access to\n an editable USD layer. When the block ends and this object is destroyed,\n the changes made to the USD layer are saved to the LOP Network, and any\n viewers pointed at nodes inside that LOP Network will be updated\n appropriately.\n\n This object is returned by a call to hou.LopNetwork.editablePostLayer.\n\n A post-layer is a concept within Solaris which allows USD layers to be\n added to the session layer of every LOP node's composed stage. These\n layers live outside the LOP node cook process, and so their content does\n not affect the operation of any LOP nodes. For example, primitives\n defined in a post-layer cannot be seen by any LOP nodes. But any request\n to access the stage of a LOP node will contain the content of these\n post-layers unless you specifically request that post-layers be excluded\n (using the apply_post_layers parameter in hou.LopNode.stage or turning\n off post layers in the Scene Viewer). Disabling post-layers should\n generally only be required when debugging the post-layer content.\n\n Because these are session layers, their opinions are stronger than any\n opinions authored by LOP nodes (which author opinions on the stage's\n root layer). Unlike Viewport Overrides, the content of these layers is\n also saved by the USD and USD Render ROPs, and so will affect final\n renders.\n\n Use cases for post-layers include the creation of standard primitives\n (like Render Settings) which should be available anywhere in the LOP\n Network. Another use case would be to apply a final pass to the scene\n graph data, such as disabling all materials for quick render tests. But\n since post-layers can only be authored by python code, integrating them\n into an artist's workflow will always require some custom user\n interface, though that interface may be as simple as providing\n checkboxes to turn certain post-layers on or off.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __enter__(self) -> LopPostLayer: ...\n def layer(self) -> pxr.Sdf.Layer: ...\n def stage(self) -> pxr.Usd.Stage: ...\n def __exit__(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None: ...\n\nclass LopSelectionRule:\n \"\"\"\n\n hou.LopSelectionRule\n\n Stores a set of rules that define how to make a selection of scene graph\n primitives.\n\n See for more information on primitive patterns.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, pattern: Optional[str] = None) -> None:\n \"\"\"\n\n __init__(self, pattern=None)\n\n Create a LopSelectionRule object with default settings.\n\n The optional pattern parameter populates the selection rule with the\n supplied pattern string. This is equivalent to creating the rule and\n then calling hou.LopSelectionRule.setPathPattern.\n\n\n \"\"\"\n def expandedPaths(self, lopnode: LopNode|None = ..., return_ancestors: bool = ..., fallback_to_new_paths: bool = ..., stage: pxr.Usd.Stage|None = ..., use_last_cook_context_options: bool = ...) -> Tuple[pxr.Sdf.Path,...]:\n \"\"\"\n\n expandedPaths(self, lopnode=None, return_ancestors=False,\n fallback_to_new_paths=False, stage=None, use_last_cook_context_options =\n True, lop_output_index = -1) -> tuple of pxr.Sdf.Path\n\n Calculates the scene graph primitive selection using the scene graph\n from the LOP node object provided as the lopnode parameter. If this\n selection rule was created with a call to hou.LopNode.selectionRule\n the lopnode parameter is assumed to be equal to the creator node. As\n an alternative to providing a LOP node, the pattern will evalaute\n over any Usd.Stage passed as the stage parameter. If both a LOP node\n and a Usd.Stage are provided, the stage parameter takes priority.\n\n Returns the full paths to every scene graph primitive matching the\n selection rules. All collections in the path pattern are expanded to\n list their included prims explicitly.\n\n If return_ancestors is set to True, after the full set of primitives\n is calculated, if there are any primitives with all of their direct\n children in the set, the parent primitive is added to the set, and\n the child primitives are removed from the set. This reduced set can\n be very useful to reduce the number of primitives that need to be\n modified if the modification is one that inherits down the scene\n graph tree (such as visibility or activation).\n\n The fallback_to_new_paths parameter can be set to True to allow the\n selection rule to return scene graph paths if the pattern consists\n entirely of explicit paths which do not correspond to any existing\n primitives on the stage. Such paths may be used to express desired\n scene graph locations for new primitives. If the pattern contains a\n mix of existing paths and new paths, this method will always return\n only the existing paths. The new paths in such a scenario can be\n accessed by calling hou.LopSelectionRule.newPaths.\n\n The use_last_cook_context_options flag indicates that when cooking\n the lopnode, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n The lop_output_index specifies which output of a multi-output LOP to\n inspect. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n\n \"\"\"\n def firstPath(self, lopnode: LopNode|None = ..., return_ancestors: bool = ..., fallback_to_new_paths: bool = ..., stage: pxr.Usd.Stage|None = ..., use_last_cook_context_options: bool = ...) -> pxr.Sdf.Path:\n \"\"\"\n\n firstPath(self, lopnode=None, return_ancestors=False,\n fallback_to_new_paths=False, stage=None, use_last_cook_context_options =\n True, lop_output_index = -1) -> pxr.Sdf.Path\n\n Behaves exactly like hou.LopSelectionRule.expandedPaths, but returns\n only a single path, which will be the first match (alphabetically\n sorted) of all matches, or the first new path if no matches are\n found.\n\n The use_last_cook_context_options flag indicates that when cooking\n the lopnode, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n The lop_output_index specifies which output of a multi-output LOP to\n inspect. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n\n \"\"\"\n def collectionAwarePaths(self, lopnode: LopNode|None = ..., fallback_to_new_paths: bool = ..., stage: pxr.Usd.Stage|None = ..., use_last_cook_context_options: bool = ...) -> Tuple[pxr.Sdf.Path,...]:\n \"\"\"\n\n collectionAwarePaths(self, lopnode=None, fallback_to_new_paths=False,\n stage=None, use_last_cook_context_options = True, lop_output_index = -1)\n -> tuple of pxr.Sdf.Path\n\n Calculates the scene graph primitive selection using the scene graph\n from the LOP node object provided as the lopnode parameter. If this\n selection rule was created with a call to hou.LopNode.selectionRule\n the lopnode parameter is assumed to be equal to the creator node. As\n an alternative to providing a LOP node, the pattern will evalaute\n over any Usd.Stage passed as the stage parameter. If both a LOP node\n and a Usd.Stage are provided, the stage parameter takes priority.\n\n Returns the full paths to every scene graph primitive or collection\n matching the selection pattern. Unlike the expandedPaths method,\n collections are not expanded to explicitly list their contents as\n primitives. Instead the full path of the collection itself is\n returned.\n\n If the primitive pattern contains any exclusions the included\n collections cannot be accurately tracked, so the results of this\n method will be the same as for expandedPaths.\n\n The fallback_to_new_paths parameter can be set to True to allow the\n selection rule to return scene graph paths if the pattern consists\n entirely of explicit paths which do not correspond to any existing\n primitives on the stage. Such paths may be used to express desired\n scene graph locations for new primitives. If the pattern contains a\n mix of existing paths and new paths, this method will always return\n only the existing paths. The new paths in such a scenario can be\n accessed by calling hou.LopSelectionRule.newPaths.\n\n The use_last_cook_context_options flag indicates that when cooking\n the lopnode, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n The lop_output_index specifies which output of a multi-output LOP to\n inspect. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n\n \"\"\"\n def newPaths(self, lopnode: LopNode|None = ..., stage: pxr.Usd.Stage|None = ..., use_last_cook_context_options: bool = ...) -> Tuple[pxr.Sdf.Path,...]:\n \"\"\"\n\n newPaths(self, lopnode=None, stage=None, use_last_cook_context_options =\n True, lop_output_index = -1) -> tuple of pxr.Sdf.Path\n\n Calculates the scene graph primitive selection using the scene graph\n from the LOP node object provided as the lopnode parameter. If this\n selection rule was created with a call to hou.LopNode.selectionRule\n the lopnode parameter is assumed to be equal to the creator node. As\n an alternative to providing a LOP node, the pattern will evalaute\n over any Usd.Stage passed as the stage parameter. If both a LOP node\n and a Usd.Stage are provided, the stage parameter takes priority.\n\n Nothing will be returned by this method unless the pattern consists\n entirely of explicit paths. Paths which represent existing\n primitives on the USD stage are not returned by this method.\n\n The use_last_cook_context_options flag indicates that when cooking\n the lopnode, the context option values used on the previous cook\n should be used if any context options used by this node do not exist\n in the global context option set. If the\n HOUDINI_NEW_CONTEXT_OPTION_RULES environment variable is set, the\n last cook context options will take priority over any global\n options, unless the node being cooked has its display flag set in\n which case last cook context options are never used.\n\n The lop_output_index specifies which output of a multi-output LOP to\n inspect. The special value -1 in most cases is simply treated as\n meaning 0 (the first output). However, when use as part of a\n parameter expression in a LOP node, it indicates the output that is\n connected to the input of the node that owns the parameter being\n evaluated. This can greatly simplify the authoring of expressions\n that need to access data from the connected input LOP.\n\n\n \"\"\"\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def lastError(self) -> str:\n \"\"\"\n\n lastError(self) -> str\n\n Any status or error messages generated the last time expandedPaths\n or collectionAwarePaths was called. This will generally contain\n information about invalid pattern strings.\n\n\n \"\"\"\n def lastErrorSeverity(self) -> EnumValue:\n \"\"\"\n\n lastErrorSeverity(self) -> hou.severityType\n\n The error status of the last time expandedPaths or\n collectionAwarePaths was called. If this value is anything other\n than hou.severityType.None, the lastError method will return a\n string with more information.\n\n\n \"\"\"\n def lastMayBeTimeVarying(self) -> bool:\n \"\"\"\n\n lastMayBeTimeVarying(self) -> bool\n\n A boolean indicating if the most recent calculation of the members\n of this selection rule might produce a time varying result. This may\n occur if the selection rule depends on a time varying attribute such\n as the transform or bounding box of some primitives.\n\n\n \"\"\"\n def pathPattern(self) -> str:\n \"\"\"\n\n pathPattern(self) -> str\n\n Return the path pattern string used in this selection rule.\n\n\n \"\"\"\n def setPathPattern(self, pattern: str) -> None:\n \"\"\"\n\n setPathPattern(self, pattern)\n\n Sets the path pattern string used in this selection rule.\n\n See for the pattern syntax.\n\n\n \"\"\"\n def traversalDemands(self) -> int:\n \"\"\"\n\n traversalDemands(self) -> int\n\n Return an integer value that expresses any demands made on the USD\n primitives while traversing the scene graph looking for matches.\n\n\n \"\"\"\n def setTraversalDemands(self, demands: int) -> None:\n \"\"\"\n\n setTraversalDemands(self, options)\n\n Set demands that must be met by primitives while traversing the\n scene graph. These demands are expressed as an integer value. This\n value can be any combination of the hou.lopTraversalDemands values.\n\n Multiple demands can be combined with the | operator. The following\n builds a rule that will only return USD primitives that are active\n and defined:\n\n > >>> rule = hou.LopSelectionRule()\n > >>> rule.SetTraversalDemands(hou.lopTraversalDemands.Active | hou.lopTraversalDemands.Defined)\n\n \"\"\"\n def icon(self) -> str:\n \"\"\"\n\n icon(self) -> str\n\n Return the icon that should be associated with this selection rule\n when displaying it in the Scene Graph Tree collection panel.\n\n\n \"\"\"\n def setIcon(self, icon: str) -> None:\n \"\"\"\n\n setIcon(self, icon)\n\n Set the path to the icon file that should be associated with this\n selection rule in the Scene Graph Tree collection panel. This string\n can be a path to an image or SVG file on disk, or the name of any\n standard Houdini icon.\n\n\n \"\"\"\n def sourceNode(self) -> LopNode | None:\n \"\"\"\n\n sourceNode(self) -> hou.LopNode or None\n\n Return the LOP node that was used to create this rule, if it was\n created by calling hou.LopNode.selectionRule. Otherwise return None.\n\n\n \"\"\"\n def sourceNodeInputIndex(self) -> int:\n \"\"\"\n\n sourceNodeInputIndex(self) -> int\n\n Return the input index parameter used to create this rule, if it was\n created by calling hou.LopNode.selectionRule. Otherwise return -1.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass LopViewportLoadMasks:\n \"\"\"\n\n hou.LopViewportLoadMasks\n\n Stores a description of which payloads on the USD stage should be loaded\n into the viewport.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Create a LopViewportLoadMasks object with default settings. This\n object describes various options for controlling which primitives\n and layers are composed together on the stage that is visible in the\n viewport. This object allows for the control of the stage population\n mask, the loading of payload primitives, and the muting of layers\n from disk. The default settings populate and load all primitives and\n layers.\n\n\n \"\"\"\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def setPopulateAll(self, populate_all: bool = True) -> None:\n \"\"\"\n\n setPopulateAll(self, populate_all = True)\n\n Configures the stage mask to include the entire scene graph. This\n clears the current list of paths to populate because it is not\n needed. If populate_all is set to False, and populateAll is\n currently set to True, this method is equivalent to calling\n setPopulatePaths with an empty path list. If populateAll is already\n False, calling this method with a populate_all value of False will\n do nothing. Calling any method which manipulates the list of paths\n to populate will automatically set this flag back to False.\n\n\n \"\"\"\n def populateAll(self) -> bool:\n \"\"\"\n\n populateAll(self) -> bool\n\n Returns True if the stage mask is configured to include the entire\n scene graph. If True, the explicit list of paths has no meaning.\n\n\n \"\"\"\n def populatePaths(self) -> Tuple[str, ...]:\n \"\"\"\n\n populatePaths(self) -> tuple of str\n\n Return the list of all paths which should be populated on the stage.\n Descendants of explicitly named primitives will also populate on the\n stage.\n\n\n \"\"\"\n def isPathPopulated(self, path: str, exact_match: bool = True) -> bool:\n \"\"\"\n\n isPathPopulated(self, path, exact_match = True) -> bool\n\n Return True if the specified scene graph path is explicitly named in\n the list of paths to populate. If exact_match is False, this method\n also returns true if any ancestor of the supplied path is in the set\n of paths to populate.\n\n\n \"\"\"\n def setPopulatePaths(self, paths: Sequence[str]) -> None:\n \"\"\"\n\n setPopulatePaths(self, paths)\n\n Set the list of paths which should be populated on the stage.\n\n\n \"\"\"\n def addPopulatePath(self, path: str) -> None:\n \"\"\"\n\n addPopulatePath(self, path)\n\n Adds a single path to the list of paths to populate. If the path is\n already in the list of paths, this method does nothing.\n\n\n \"\"\"\n def removePopulatePath(self, path: str, remove_children: bool = False) -> None:\n \"\"\"\n\n removePopulatePath(self, path)\n\n Removes a single path from the list of paths to populate . If the\n path is not in the list of paths, this method does nothing.\n\n If remove_children is set to True, all children of the primitive at\n path are also removed from the set of populated paths.\n\n\n \"\"\"\n def muteLayers(self) -> Tuple[str, ...]:\n \"\"\"\n\n muteLayers(self) -> tuple of str\n\n Return the list of all muted layer identifiers.\n\n\n \"\"\"\n def isLayerMuted(self, identifier: str) -> bool:\n \"\"\"\n\n isLayerMuted(self, identifier) -> bool\n\n Return True if the specified layer identifier should be ignored when\n composing the stage.\n\n\n \"\"\"\n def setMuteLayers(self, identifiers: Sequence[str]) -> None:\n \"\"\"\n\n setMuteLayers(self, identifiers)\n\n Set the list of layer identifiers that should be muted.\n\n\n \"\"\"\n def addMuteLayer(self, identifier: str) -> None:\n \"\"\"\n\n addMuteLayer(self, identifier)\n\n Adds a single layer identifier to the list of muted layer\n identifiers. If the identifier is already being muted, this method\n does nothing.\n\n\n \"\"\"\n def removeMuteLayer(self, identifier: str) -> None:\n \"\"\"\n\n removeMuteLayer(self, identifier)\n\n Removes a single layer identifier from the list of muted layer\n identifiers. If the identifier is not being muted, this method does\n nothing.\n\n\n \"\"\"\n def setLoadAll(self, load_all: bool = True) -> None:\n \"\"\"\n\n setLoadAll(self, load_all = True)\n\n Set the flag indicating that all payloads should be loaded by\n default. If load_all is set to False, and loadAll is currently set\n to True, this method is equivalent to calling setLoadPaths with an\n empty path list. If loadAll is already False, calling this method\n with a load_all value of False will do nothing. Calling any method\n which manipulates the list of paths to be loaded will automatically\n set this flag back to False.\n\n\n \"\"\"\n def loadAll(self) -> bool: ...\n def loadPaths(self) -> Tuple[str, ...]:\n \"\"\"\n\n loadPaths(self) -> tuple of str\n\n Return a list of all scene graph branches which will load their\n payloads in the viewport. Descendants of explicitly named primitives\n will also load their payloads.\n\n\n \"\"\"\n def isPathLoaded(self, path: str, exact_match: bool = True) -> bool:\n \"\"\"\n\n isPathLoaded(self, path, exact_match = True) -> bool\n\n Return True if the specified scene graph path is explicitly named in\n the list of paths to load. If exact_match is False, this method also\n returns true if any ancestor of the supplied path is in the set of\n paths to load.\n\n\n \"\"\"\n def isAnyChildPathLoaded(self, path: str) -> bool:\n \"\"\"\n\n isAnyChildPathLoaded(self, path) -> bool\n\n Return True if the specified scene graph path or any of its children\n appear in the list of paths to load.\n\n\n \"\"\"\n def setLoadPaths(self, paths: Sequence[str]) -> None:\n \"\"\"\n\n setLoadPaths(self, paths)\n\n Set the list of scene graph paths which should load their payloads\n in the viewport.\n\n\n \"\"\"\n def addLoadPath(self, path: str) -> None:\n \"\"\"\n\n addLoadPath(self, path)\n\n Adds a single path to the list of scene graph paths which will load\n their payloads inthe viewport. If the path is already in the list,\n this method does nothing.\n\n\n \"\"\"\n def removeLoadPath(self, path: str, remove_children: bool = False) -> None:\n \"\"\"\n\n removeLoadPath(self, path, remove_children = False)\n\n Removes a single path from the list of scene graph paths which will\n load their payloads in the viewport. If the path is not in the list,\n this method does nothing.\n\n If remove_children is set to True, all children of the primitive at\n path are also removed from the set of loaded paths.\n\n\n \"\"\"\n def setVariantSelectionFallbacks(self, fallbacks: dict[str, typing.Iterable[str]]) -> None: ...\n def variantSelectionFallbacks(self) -> dict[str, Tuple[str, ...]]: ...\n def dumps(self) -> str: ...\n def loads(self, masks_str: str) -> bool: ...\n __swig_destroy__: Incomplete\n\nclass LopViewportOverrides:\n \"\"\"\n\n hou.LopViewportOverrides\n\n Used to edit the current session overlay layer that is applied to the\n current LOP node's scene graph.\n\n This object can exist in one of two modes. One mode does not allow\n editing of the overrides other than to save and load the entire object.\n An object is created in this mode either using the default constructor,\n or by calling hou.LopNetwork.copyViewportOverrides which makes a read-\n only copy of either the current viewport overrides, or a saved set of\n overrides.\n\n In its other mode, this object is a context manager. You can create one\n using hou.LopNetwork.viewportOverrides. At the end of the with block,\n the notification of the session edits is propagated to viewer panes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self) -> None:\n \"\"\"\n\n __init__(self)\n\n Creates an empty, read-only set of viewport overrides. This\n constructor is necessary to allow loading the contents of a binary\n string previsouly with the dumps method.\n\n\n \"\"\"\n def __enter__(self) -> LopViewportOverrides: ...\n def setDrawMode(self, prims: LopSelectionRule, drawmode: str) -> None:\n \"\"\"\n\n setDrawMode(self, prims, drawmode)\n\n Change the draw mode of USD primitives by editing the session layer\n of a LOP Network. The draw mode of a primitive is only respected if\n the primitive is part of a valid, contiguous USD model hierarchy.\n The LOP Network to edit is determined by looking at the LOP node\n used to create this session editor object.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD\n primitives should be affected.\n\n drawmode\n A string value indicating the new draw mode for the USD\n primitives. Only primitives that are part of a valid USD model\n hierarchy can have their draw mode changed. The allowed values\n for this string are default (draw the full geometry), origin\n (draw a set of axes at the origin of the primitive), bounds\n (draw a bounding box around the primitive), and cards (draw\n three axis-aligned cards that fill the primitive's bounding\n box).\n\n\n \"\"\"\n def setActive(self, prims: LopSelectionRule, active: bool) -> None:\n \"\"\"\n\n setActive(self, prims, active)\n\n Change the active state of USD primitives by editing the session\n layer of a LOP Network. Deactivated primitives do not appear in the\n viewport, and cannot be expanded in the scene graph tree. The LOP\n Network to edit is determined by looking at the LOP node used to\n create this session editor object.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD\n primitives should be affected.\n\n active\n A boolean value indicating the new activation state of the USD\n primitives.\n\n\n \"\"\"\n def setVisible(self, prims: LopSelectionRule, visible: bool) -> None:\n \"\"\"\n\n setVisible(self, prims, visible)\n\n Change the visibility of USD primitives by editing the session layer\n of a LOP Network. Invisible primitives are not drawn in the\n viewport, but still appear in the scene graph tree. The LOP Network\n to edit is determined by looking at the LOP node used to create this\n session editor object.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD\n primitives should be affected.\n\n visible\n A boolean value indicating whether the USD primitives should be\n visible.\n\n\n \"\"\"\n def setSelectable(self, prims: LopSelectionRule, active: bool, solo: bool = False) -> None:\n \"\"\"\n\n setSelectable(self, prims, selectable, solo = False)\n\n Change the selectability of USD primitives by editing the session\n layer of a LOP Network. Unselectable primitives are ignored when\n performing a selection operation in the viewport. The LOP Network to\n edit is determined by looking at the LOP node used to create this\n session editor object. All descendants of an unselectable primitive\n are also unselectable, even if they are explicitly set as\n selectable. An unselectable setting on and ancestor primitive takes\n precedence.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD\n primitives should be affected.\n\n selectable\n A boolean value indicating the new selectable value of the USD\n primitives.\n\n solo\n A boolean value indicating that the supplied set of primitives\n should be the only primitives in the scene that are selectable\n (or not selectable). This may involve modifying the selectable\n attribute on many primitives across the scene, not just the\n specified primitives.\n\n\n \"\"\"\n def setSoloLights(self, prims: Optional[LopSelectionRule] = None) -> None:\n \"\"\"\n\n setSoloLights(self, prims)\n\n Deactivates any lights not specified by the prims parameter.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD light\n primitives should be remain active after running this method. Or\n can be None to disable any existing soloing of lights.\n\n\n \"\"\"\n def addSoloLights(self, prims: LopSelectionRule) -> None:\n \"\"\"\n\n addSoloLights(self, prims)\n\n Adds lights to the set of activated lights in the scene.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD light\n primitives should be added to the set of solo active lights.\n\n\n \"\"\"\n def removeSoloLights(self, prims: LopSelectionRule) -> None:\n \"\"\"\n\n removeSoloLights(self, prims)\n\n Remove lights from the set of activated lights in the scene. If all\n lights are removed from the solo lights group, all lights in the\n scene will be activated.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD light\n primitives should be removed from the set of solo active lights.\n\n\n \"\"\"\n def setSoloGeometry(self, prims: Optional[LopSelectionRule] = None) -> None:\n \"\"\"\n\n setSoloGeometry(self, prims)\n\n Turns off the visibility of any geometry not specified by the prims\n parameter.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD geometry\n primitives should be remain visible after running this method.\n Any descendants of the specified primitives will also be made\n visible. This parameter can also be None to disable any existing\n soloing of geometry.\n\n\n \"\"\"\n def addSoloGeometry(self, prims: LopSelectionRule) -> None:\n \"\"\"\n\n addSoloGeometry(self, prims)\n\n Adds geometry primitives to the set of activated geometry in the\n scene.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD geometry\n primitives should be added to the set of solo visible geometry.\n\n\n \"\"\"\n def removeSoloGeometry(self, prims: LopSelectionRule) -> None:\n \"\"\"\n\n removeSoloGeometry(self, prims)\n\n Remove geometry from the set of visible geometry in the scene. If\n all geometry are removed from the solo geometry group, all geometry\n in the scene will be made visible.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD geometry\n primitives should be removed from the set of solo visible\n geometry.\n\n\n \"\"\"\n def showPurpose(self, prims: LopSelectionRule, purpose: str) -> None:\n \"\"\"\n\n showPurpose(self, prims, purpose)\n\n Show the selected purpose for a geometry primitive if it exists.\n Other purposes for the same geometry are hidden from the viewport.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD geometry\n primitives' purpose should be isolated and displayed.\n\n purpose\n A string value indicating the purpose(render/proxy/guide) to\n display.\n\n\n \"\"\"\n def setDisplayOpacity(self, prims: LopSelectionRule, opacity: float) -> None:\n \"\"\"\n\n setDisplayOpacity(self, prims, opacity)\n\n Change the display opacity of USD primitives by editing the session\n layer of a LOP Network. The LOP Network to edit is determined by\n looking at the LOP node used to create this session editor object.\n\n\n prims\n A hou.LopSelectionRule object that specifies which USD\n primitives should be affected.\n\n opacity\n A float value between 0 (fully transparent) and 1 (fully\n opaque).\n\n\n \"\"\"\n def clear(self, layer_id: Optional[EnumValue] = None, from_prim: Optional[str] = None) -> None:\n \"\"\"\n\n clear(self, layer_id = None, from_prim = None)\n\n Clears one or all viewport overrides layers.\n\n\n layer_id\n A hou.lopViewportOverridesLayer value to clear a specific\n overrides layer, or None to clear all layers.\n\n from_prim\n A path to the primitive that is the root of the portion of the\n scene graph tree from which the overrides should be cleared. Set\n to None to clear overrides for the whole scene graph.\n\n\n \"\"\"\n def dumps(self) -> bytes:\n \"\"\"\n\n dumps(self) -> hou.BinaryString\n\n Generates a binary string that contains a serialized copy of this\n object. The format of this serialization is opaque and should not be\n directly inspected or modified. The output should only be used to\n persist this object for later reuse in another process.\n\n\n \"\"\"\n def loads(self, overrides_str: bytes) -> None:\n \"\"\"\n\n loads(self, overrides_str)\n\n Loads the contents of a binary string into this object. The provided\n data must have been generated by calling the dumps method. This\n method can only be called either on a read-only object created by\n calling the default constructor method, or on an object returned by\n hou.LopNetwork.viewportOverrides.\n\n\n \"\"\"\n def layer(self) -> pxr.Sdf.Layer:\n \"\"\"\n\n layer(self) -> pxr.Sdf.Layer\n\n Return the pxr.Sdf.Layer object that contains current custom session\n edits to the scene graph. These edits are accessible using the\n hou.lopViewportOverridesLayer.Custom layer id. This layer does not\n include opinions set using built in Houdini panels. This layer only\n hold opinions authored through the layer returned by this method.\n This object can be modified using the pxr.Sdf.Layer API to make\n further session modifications to the scene graph.\n\n\n \"\"\"\n def stage(self) -> pxr.Usd.Stage:\n \"\"\"\n\n stage(self) -> pxr.Sdf.Stage\n\n Return the pxr.Usd.Stage object that contains all the current\n session edits to the scene graph. This object can be modified using\n the pxr.Usd.Stage API to make further session modifications to the\n scene graph.\n\n\n \"\"\"\n def soloLights(self) -> pxr.Sdf.Path:\n \"\"\"\n\n soloLights(self) -> tuple of pxr.Sdf.Path\n\n Return a set containing the paths to all solo active light\n primitives.\n\n\n \"\"\"\n def soloGeometry(self) -> pxr.Sdf.Path:\n \"\"\"\n\n soloGeometry(self) -> tuple of pxr.Sdf.Path\n\n Return a set containing the paths to all solo visible geometry\n primitives.\n\n\n \"\"\"\n def __exit__(self, type: type[BaseException], value: BaseException, traceback: TracebackType) -> None: ...\n __swig_destroy__: Incomplete\n\nclass Matrix2:\n \"\"\"\n\n hou.Matrix2\n\n A 2x2 matrix of floating point values.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, values: int|float|Sequence[int]|Sequence[float]|Sequence[Sequence[int]|Sequence[float]]|'Matrix2' = ...) -> None:\n \"\"\"\n\n __init__(self, values)\n\n Return a new Matrix2. You can pass no parameters (the result will\n contain all zeros), a float (the result's diagonal values will\n contain that float and the rest is all zeros), a sequence of 4\n floats, or a sequence of sequences of 2 floats.\n\n > >>> hou.Matrix2()\n > \n > \n > >>> hou.Matrix2(1)\n > \n > \n > >>> hou.Matrix2((0, 1, 2, 3))\n > \n > \n > >>> hou.Matrix2(((0, 1), (3, 4)))\n > \n\n Note that Houdini's matrices are stored in row-major order, so the\n matrix's contents are grouped by row.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, matrix2: Matrix2, tolerance: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, matrix2, tolerance=0.00001) -> bool\n\n Returns whether this matrix is equal to another, within a tolerance.\n\n\n \"\"\"\n def __hash__(self) -> int: ...\n def at(self, row: int, col: int) -> float:\n \"\"\"\n\n at(self, row, col) -> double\n\n Return the value of the matrix at the given row and column.\n\n Raises IndexError if the row or column are not between 0 and 1,\n inclusive. Note that negative indices will not index from the end.\n\n\n \"\"\"\n def asTuple(self) -> Tuple[float, ...]:\n \"\"\"\n\n asTuple(self) -> tuple of float\n\n Return the contents of the matrix as a tuple of 4 floats.\n\n\n \"\"\"\n def asTupleOfTuples(self) -> Tuple[Tuple[float, ...], ...]:\n \"\"\"\n\n asTupleOfTuples(self) -> tuple of tuple of float\n\n Return the contents of the matrix as a tuple of tuples of 2 floats.\n\n\n \"\"\"\n def setAt(self, row: int, col: int, value: float) -> None:\n \"\"\"\n\n setAt(self, row, col, value)\n\n Set the value of the matrix at the given row and column.\n\n Raises IndexError if the row or column are not between 0 and 1,\n inclusive. Note that negative indices will not index from the end.\n\n\n \"\"\"\n def setTo(self, value: Sequence[float]) -> None:\n \"\"\"\n\n setTo(self, tuple)\n\n Set this matrix's contents. The sequence may contain either 4 floats\n or 2 sequences, each with 2 floats.\n\n See hou.Matrix2.__init__ for examples of suitable parameter values.\n\n\n \"\"\"\n def setToIdentity(self) -> None:\n \"\"\"\n\n setToIdentity(self)\n\n Set this matrix to the multiplicative identity, having 1's in the\n diagonal.\n\n The matrix will contain the values [[1, 0], [0, 1]]. Note that you\n can construct a new matrix with these values using hou.Matrix2(1).\n\n\n \"\"\"\n def setToZero(self) -> None:\n \"\"\"\n\n setToZero(self)\n\n Set this matrix to contain all zeros.\n\n Note that you can construct a new matrix with all zeros with\n hou.Matrix2().\n\n\n \"\"\"\n def __add__(self, matrix2: Matrix2) -> Matrix2:\n \"\"\"\n\n __add__(self, matrix2) -> hou.Matrix2\n\n Add two matrices by adding corresponding entries together and return\n a new matrix. This method lets you write m1 + m2, where m1 and m2\n are Matrix2 objects.\n\n\n \"\"\"\n def __sub__(self, matrix2: Matrix2) -> Matrix2:\n \"\"\"\n\n __sub__(self, matrix2) -> hou.Matrix2\n\n Subtract another matrix from this one, subtracting corresponding\n entries, and return a new matrix. This method lets you write m1 -\n m2, where m1 and m2 are Matrix2 objects.\n\n\n \"\"\"\n def __mul__(self, matrix2_or_scalar: Matrix2|float) -> Matrix2:\n \"\"\"\n\n __mul__(self, matrix2_or_scalar) -> hou.Matrix2\n\n Multiply this matrix by another matrix or by a scalar, returning a\n new matrix. This method lets you write m1 * m2, where m1 and m2 are\n Matrix2 objects, or m1 * s, where s is a float.\n\n See Wikipedia's matrix multiplication page for details on how each\n element in the result is computed.\n\n\n \"\"\"\n def preMult(self, matrix2: Matrix2) -> Matrix2:\n \"\"\"\n\n preMult(self, matrix2) -> hou.Matrix2\n\n Returns matrix2 * self. Note that __mul__ returns self * matrix2,\n which is a different result because matrix multiplication is not\n commutative.\n\n\n \"\"\"\n def transposed(self) -> Matrix2:\n \"\"\"\n\n transposed(self) -> hou.Matrix2\n\n Return the transpose of this matrix. The result is such that\n self.at(i, j) == self.transposed().at(j, i) for 0 <= i,j <= 1.\n\n See Wikipedia's transpose page for more information.\n\n\n \"\"\"\n def inverted(self) -> Matrix2:\n \"\"\"\n\n inverted(self) -> hou.Matrix2\n\n Return the inverse of this matrix.\n\n Raises hou.OperationFailed if the matrix is not invertible.\n Otherwise, (self * self.inverted()).isAlmostEqual(hou.Matrix2(1)) is\n True.\n\n See Wikipedia's invertible matrix page for more information.\n\n\n \"\"\"\n def determinant(self) -> float:\n \"\"\"\n\n determinant(self) -> double\n\n Return the determinant of the matrix.\n\n See Wikipedia's determinant page.\n\n\n \"\"\"\n\nclass Matrix3:\n \"\"\"\n\n hou.Matrix3\n\n A 3x3 matrix of floating point values.\n\n 3x3 matrices are typically used in Houdini to represent a 3D rotation\n (with a possible scale). Most places in Houdini use hou.Matrix4, which\n can store generation 3D transformations (including translations).\n\n Note that you can construct a general transformation Matrix4 from a\n Matrix3 by writing hou.Matrix4(matrix3).\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, values: int|float|Sequence[int]|Sequence[float]|Sequence[Sequence[int]|Sequence[float]]|'Matrix3' = ...) -> None:\n \"\"\"\n\n __init__(self, values)\n\n Return a new Matrix3. You can pass no parameters (the result will\n contain all zeros), a float (the result's diagonal values will\n contain that float and the rest is all zeros), a sequence of 9\n floats, a sequence of sequences of 3 floats, or a hou.Matrix4.\n\n > >>> hou.Matrix3()\n > \n > \n > >>> hou.Matrix3(1)\n > \n > \n > >>> hou.Matrix3((0, 1, 2, 3, 4, 5, 6, 7, 8))\n > \n > \n > >>> hou.Matrix3(((0, 1, 2), (3, 4, 5), (6, 7, 8)))\n > \n > \n > >>> matrix4 = hou.Matrix4((0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15))\n > >>> matrix4\n > \n > >>> hou.Matrix3(matrix4)\n > \n\n Note that Houdini's matrices are stored in row-major order, so the\n matrix's contents are grouped by row.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, matrix3: Matrix3, tolerance: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, matrix3, tolerance=0.00001) -> bool\n\n Returns whether this matrix is equal to another, within a tolerance.\n\n\n \"\"\"\n def __hash__(self) -> int: ...\n def at(self, row: int, col: int) -> float:\n \"\"\"\n\n at(self, row, col) -> double\n\n Return the value of the matrix at the given row and column.\n\n Raises IndexError if the row or column are not between 0 and 2,\n inclusive. Note that negative indices will not index from the end.\n\n\n \"\"\"\n def asTuple(self) -> Tuple[float, ...]:\n \"\"\"\n\n asTuple(self) -> tuple of float\n\n Return the contents of the matrix as a tuple of 9 floats.\n\n\n \"\"\"\n def asTupleOfTuples(self) -> Tuple[Tuple[float, ...], ...]:\n \"\"\"\n\n asTupleOfTuples(self) -> tuple of tuple of float\n\n Return the contents of the matrix as a tuple of tuples of 3 floats.\n\n\n \"\"\"\n def setAt(self, row: int, col: int, value: float) -> None:\n \"\"\"\n\n setAt(self, row, col, value)\n\n Set the value of the matrix at the given row and column.\n\n Raises IndexError if the row or column are not between 0 and 2,\n inclusive. Note that negative indices will not index from the end.\n\n\n \"\"\"\n def setTo(self, value: Sequence[float]) -> None:\n \"\"\"\n\n setTo(self, tuple)\n\n Set this matrix's contents. The sequence may contain either 9 floats\n or 3 sequences, each with 3 floats.\n\n See hou.Matrix3.__init__ for examples of suitable parameter values.\n\n\n \"\"\"\n def setToIdentity(self) -> None:\n \"\"\"\n\n setToIdentity(self)\n\n Set this matrix to the multiplicative identity, having 1's in the\n diagonal.\n\n The matrix will contain the values [[1, 0, 0], [0, 1, 0], [0, 0,\n 1]]. Note that you can construct a new matrix with these values\n using hou.Matrix3(1).\n\n\n \"\"\"\n def setToZero(self) -> None:\n \"\"\"\n\n setToZero(self)\n\n Set this matrix to contain all zeros.\n\n Note that you can construct a new matrix with all zeros with\n hou.Matrix3().\n\n\n \"\"\"\n def __add__(self, matrix3: Matrix3) -> Matrix3:\n \"\"\"\n\n __add__(self, matrix3) -> hou.Matrix3\n\n Add two matrices by adding corresponding entries together and return\n a new matrix. This method lets you write m1 + m2, where m1 and m2\n are Matrix3 objects.\n\n\n \"\"\"\n def __sub__(self, matrix3: Matrix3) -> Matrix3:\n \"\"\"\n\n __sub__(self, matrix3) -> hou.Matrix3\n\n Subtract another matrix from this one, subtracting corresponding\n entries, and return a new matrix. This method lets you write m1 -\n m2, where m1 and m2 are Matrix3 objects.\n\n\n \"\"\"\n def __mul__(self, matrix3_or_scalar: Matrix3|float) -> Matrix4:\n \"\"\"\n\n __mul__(self, matrix3_or_scalar) -> hou.Matrix3\n\n Multiply this matrix by another matrix or by a scalar, returning a\n new matrix. This method lets you write m1 * m2, where m1 and m2 are\n Matrix3 objects, or m1 * s, where s is a float.\n\n See Wikipedia's matrix multiplication page for details on how each\n element in the result is computed. Also see hou.Matrix4.\n\n\n \"\"\"\n def preMult(self, matrix3: Matrix3) -> Matrix3:\n \"\"\"\n\n preMult(self, matrix3) -> hou.Matrix3\n\n Returns matrix3 * self. Note that __mul__ returns self * matrix3,\n which is a different result because matrix multiplication is not\n commutative.\n\n\n \"\"\"\n def transposed(self) -> Matrix3:\n \"\"\"\n\n transposed(self) -> hou.Matrix3\n\n Return the transpose of this matrix. The result is such that\n self.at(i, j) == self.transposed().at(j, i) for 0 <= i,j <= 2.\n\n See Wikipedia's transpose page for more information.\n\n\n \"\"\"\n def inverted(self) -> Matrix3:\n \"\"\"\n\n inverted(self) -> hou.Matrix3\n\n Return the inverse of this matrix.\n\n Raises hou.OperationFailed if the matrix is not invertible.\n Otherwise, (self * self.inverted()).isAlmostEqual(hou.Matrix3(1)) is\n True.\n\n See Wikipedia's invertible matrix page for more information.\n\n\n \"\"\"\n def determinant(self) -> float:\n \"\"\"\n\n determinant(self) -> double\n\n Return the determinant of the matrix.\n\n See Wikipedia's determinant page.\n\n\n \"\"\"\n def extractRotates(self, rotate_order: Literal['xyz','xzy','yxz','yzx','zxy','zyx'] = ...) -> Vector3:\n '''\n\n extractRotates(self, rotate_order=\\\\\"xyz\\\\\") -> hou.Vector3\n\n Return a Vector3 of Euler angles, in degrees, representing the\n rotation component of this matrix. Rotating about the coordinate\n axes in the specified order by these amounts will yield the rotation\n contained in this matrix.\n\n\n rotate_order\n A string containing a permutation of the letters x, y, and z\n that determines the order in which rotations are performed about\n the coordinate axes.\n\n Raises hou.OperationFailed if the matrix does not represent a valid\n rotation matrix (e.g. it is singular) or the rotate order is not a\n permutation of the string \\'xyz\\'.\n\n See also hou.Matrix4.explode and hou.Matrix4.extractRotates.\n\n\n WARNING\n If there are scales or shears in the matrix, the results are as\n if they were first removed on the left side. (ie. SR -> R). If\n you wish to control for this, first use\n hou.Matrix3.removeScalesAndShears with the desired transform\n order.\n\n\n '''\n def removeScalesAndShears(self, transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ...) -> Tuple[Vector3, Vector3]:\n '''\n\n removeScalesAndShears(self, transform_order=\\\\\"srt\\\\\") -> tuple of\n (hou.Vector3, hou.Vector3)\n\n Remove scales and shears from this matrix and return them as a tuple\n of (scales, shears).\n\n\n transform_order\n A 3 character string containing a permutation of the letters s,\n r, and t. If s occurs before r, then the scales/shears are\n extracted from the left of this matrix. Otherwise, they will be\n extracted from the right instead.\n\n Raises hou.OperationFailed if transform_order is invalid.\n\n See also: hou.Matrix3.extractRotates, hou.Matrix4.extractRotates,\n hou.Matrix4.extractRotationMatrix3\n\n\n '''\n\nclass Matrix4:\n \"\"\"\n\n hou.Matrix4\n\n A 4x4 matrix of floating point values.\n\n 4x4 matrices are typically used in Houdini to represent a 3D\n transformation (e.g. some combination of rotation, scaling, shearing,\n and translation). A single matrix compactly represents a transformation,\n and is much easier to deal with than multiple translate, rotate, scale,\n shear, transformation order, and rotation order values.\n\n Note that Houdini's matrices are stored in row-major format, and vectors\n that are multiplied with matrices are treated as row vectors. So, if p\n is a hou.Vector4 representing a point and M is a Matrix4, you write p*M,\n not M*p. Similarly, p*M1*M2 will first transform p by M1, and then\n transform it by M2.\n\n\n NOTE\n Most mathematical notations treat vectors and points as column\n vectors instead of row vectors. They will often use A*B*C (or simply\n ABC) to refer to a combined transform that first applies C's\n transform, then B's, and then applies A's. However, the convention\n is different in Houdini. To represent the equivalent matrix\n expression in Houdini, you need to concatenate the transforms in the\n reverse order. So, you would instead write C'*B'*A', where C', B',\n A' are the transpose of C, B, A respectively.\n\n You can multiply Vector3s or Vector4s by Matrix4s. If you multiply a\n Vector3, it is the same as multiplying a Vector4 where the fourth\n component is 1 (see hou.Vector3.__mul__).\n\n To transform a normal (as opposed to a point or vector), you need to\n multiply by the inverse transpose of the matrix. For example, suppose:\n\n\n p\n is a hou.Vector3 object representing a position (or a hou.Vector4\n with p[3]==1)\n\n v\n is a hou.Vector4 object representing a vector (a direction with a\n length but no fixed location in space), with v[3]==0\n\n n\n is a hou.Vector4 object representing a normal, with v[3]==0\n\n m\n is a Matrix4 object representing a transform matrix\n\n Then you would write:\n\n > p * m # to transform the point\n > v * m # to transform the vector\n > n * m.inverted().transposed() # to transform the normal\n > # (note that m.inverted().transposed() is mathematically equivalent to m.transposed().inverted())\n\n Here is a concrete example:\n\n > >>> m = hou.hmath.buildTranslate((1, 1, 2))\n > >>> m\n > \n > >>> p = hou.Vector3(1, 2, 3)\n > >>> p * m\n > \n\n Both VEX and the UT_DMatrix4 class in the Houdini Development Kit (HDK)\n also store matrices in row-major format.\n\n RELATED\n\n * hou.hmath\n\n * hou.Matrix3\n\n * hou.Quaternion\n\n * hou.Vector3\n\n * hou.Vector4\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, values: int|float|Sequence[int]|Sequence[float]|Sequence[Sequence[int]|Sequence[float]]|'Matrix4' = ...) -> None:\n \"\"\"\n\n __init__(self, values)\n\n Return a new Matrix4. You can pass no parameters (the result will\n contain all zeros), a float (the result's diagonal values will\n contain that float and the rest is all zeros), a sequence of 16\n floats, a sequence of sequences of 4 floats, or a hou.Matrix3.\n\n > >>> hou.Matrix4()\n > \n > \n > >>> hou.Matrix4(1)\n > \n > \n > >>> hou.Matrix4((0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15))\n > \n > \n > >>> hou.Matrix4(((0, 1, 2, 3), (4, 5, 6, 7), (8, 9, 10, 11), (12, 13, 14, 15)))\n > \n > \n > >>> matrix3 = hou.Matrix3((0, 1, 2, 3, 4, 5, 6, 7, 8))\n > >>> matrix3\n > \n > >>> hou.Matrix4(matrix3)\n > \n\n Note that Houdini's matrices are stored in row-major order, so the\n matrix's contents are grouped by row.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, matrix4: Matrix4, tolerance: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, matrix4, tolerance=0.00001) -> bool\n\n Return whether this matrix is equal to another, within a tolerance.\n\n\n \"\"\"\n def __hash__(self) -> int: ...\n def at(self, row: int, col: int) -> float:\n \"\"\"\n\n at(self, row, col) -> float\n\n Return the value of the matrix at the given row and column.\n\n Raises IndexError if the row or column are not between 0 and 3,\n inclusive. Note that negative indices will not index from the end.\n\n\n \"\"\"\n def asTuple(self) -> Tuple[float, ...]:\n \"\"\"\n\n asTuple(self) -> tuple of float\n\n Return the contents of the matrix as a tuple of 16 floats.\n\n\n \"\"\"\n def asTupleOfTuples(self) -> Tuple[Tuple[float, ...], ...]:\n \"\"\"\n\n asTupleOfTuples(self) -> tuple of tuple of float\n\n Return the contents of the matrix as a tuple of tuples of 4 floats.\n\n\n \"\"\"\n def setAt(self, row: int, col: int, value: float) -> None:\n \"\"\"\n\n setAt(self, row, col, value)\n\n Set the value of the matrix at the given row and column.\n\n Raises IndexError if the row or column are not between 0 and 3,\n inclusive. Note that negative indices will not index from the end.\n\n\n \"\"\"\n def setTo(self, value: Sequence[float]) -> None:\n \"\"\"\n\n setTo(self, sequence)\n\n Set this matrix's contents. The sequence may contain either 16\n floats or 4 sequences, each with 4 floats.\n\n See hou.Matrix4.__init__ for examples of suitable parameter values.\n\n\n \"\"\"\n def setToIdentity(self) -> None:\n \"\"\"\n\n setToIdentity(self)\n\n Set this matrix to the multiplicative identity, having 1's in the\n diagonal.\n\n The matrix will contain the values [[1, 0, 0, 0], [0, 1, 0, 0], [0,\n 0, 1, 0], [0, 0, 0, 1]]. Note that you can construct a new matrix\n with these values using hou.hmath.identityTransform or\n hou.Matrix4(1).\n\n\n \"\"\"\n def setToZero(self) -> None:\n \"\"\"\n\n setToZero(self)\n\n Set this matrix to contain all zeros.\n\n Note that you can construct a new matrix with all zeros with\n hou.Matrix4().\n\n\n \"\"\"\n def __add__(self, matrix4: Matrix4) -> Matrix4:\n \"\"\"\n\n __add__(self, matrix4) -> hou.Matrix4\n\n Add two matrices by adding corresponding entries together and return\n a new matrix. This method lets you write m1 + m2, where m1 and m2\n are Matrix4 objects.\n\n\n \"\"\"\n def __sub__(self, matrix4: Matrix4) -> Matrix4:\n \"\"\"\n\n __sub__(self, matrix4) -> hou.Matrix4\n\n Subtract another matrix from this one, subtracting corresponding\n entries, and return a new matrix. This method lets you write m1 -\n m2, where m1 and m2 are Matrix4 objects.\n\n\n \"\"\"\n def __mul__(self, matrix4_or_scalar: Matrix4|float) -> Matrix4:\n \"\"\"\n\n __mul__(self, matrix4_or_scalar) -> hou.Matrix4\n\n Multiply this matrix by another matrix or by a scalar, returning a\n new matrix. This method lets you write m1 * m2, where m1 and m2 are\n Matrix4 objects, or m1 * s, where s is a float.\n\n If m1 and m2 are transformation matrices and v is a vector, v * m1 *\n m2 will transform v by m1, and then transform it by m2. This\n ordering occurs because Houdini's Matrices are stored in row-major\n format, and is opposite from the ordering used in traditional\n mathematical notation. Note that m1 * v is not a valid expression in\n Houdini\n\n See the Matrix4 class documentation and hou.Vector3.__mul__ for more\n information. See Wikipedia's matrix multiplication page for details\n on how each element in the result is computed.\n\n\n \"\"\"\n def preMult(self, matrix4: Matrix4) -> Matrix4:\n \"\"\"\n\n preMult(self, matrix4) -> hou.Matrix4\n\n Returns matrix4 * self. Note that __mul__ returns self * matrix4,\n which is a different result because matrix multiplication is not\n commutative.\n\n\n \"\"\"\n def transposed(self) -> Matrix4:\n \"\"\"\n\n transposed(self) -> hou.Matrix4\n\n Return the transpose of this matrix. The result is such that\n self.at(i, j) == self.transposed().at(j, i) for 0 <= i,j <= 3.\n\n See Wikipedia's transpose page for more information.\n\n\n \"\"\"\n def inverted(self) -> Matrix4:\n \"\"\"\n\n inverted(self) -> hou.Matrix4\n\n Return the inverse of this matrix.\n\n Raises hou.OperationFailed if the matrix is not invertible.\n Otherwise, (self *\n self.inverted()).isAlmostEqual(hou.hmath.identityTransform()) is\n True.\n\n See Wikipedia's invertible matrix page for more information.\n\n\n \"\"\"\n def determinant(self) -> float:\n \"\"\"\n\n determinant(self) -> float\n\n Return the determinant of the matrix.\n\n See Wikipedia's determinant page.\n\n\n \"\"\"\n def explode(self, transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ..., rotate_order: Literal['xyz','xzy','yxz','yzx','zxy','zyx'] = ..., pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> dict[str, Vector3]:\n \"\"\"\n\n explode(self, transform_order='srt', rotate_order='xyz',\n pivot=hou.Vector3(), pivot_rotate=hou.Vector3()) -> dict of str to\n hou.Vector3\n\n Return a dictionary with keys 'rotate', 'scale', 'translate', and\n 'shear' whose values are hou.Vector3 objects. When applied in the\n specified order, the corresponding rotations, scales (and shears),\n and translations will give this matrix.\n\n The rotation is returned as a set of Euler angles, in degrees. See\n Wikipedia's Euler angles page for more information.\n\n\n transform_order\n A string containing a permutation of the letters s, r, and t.\n The rotate, scale, and translate results are dependent on the\n order in which you perform those operations, and this string\n specifies that order.\n\n For example, imagine a transformation where you first translate\n in x by one unit, then you rotate in z by 45 degrees. With a\n transform order of 'trs' (translate, rotate, scale), the\n translate component is (1, 0, 0). However, this same\n transformation could be constructed, for example, by first\n scaling, then rotating, and then translating. For this\n transformation order, the translate component would be (1.0 /\n math.sqrt(2), 1.0 / math.sqrt(2), 0).\n\n rotate_order\n A string containing a permutation of the letters x, y, and z\n that determines the order in which rotations are performed about\n the coordinate axes.\n\n pivot\n A Vector3 containing a position about which rotations and scales\n are performed. By default, this parameter is set to the origin.\n\n pivot_rotate\n A Vector3 containing the Euler angles about the x, y, and z\n axes, in degrees, that specifies the base rotation about the\n pivot. These angles are always processed in 'xyz' order.\n\n Raises hou.OperationFailed if the matrix does not represent a valid\n transform matrix (e.g. it is singular), the transform order is not a\n permutation of the string 'srt', or the rotate order is not a\n permutation of the string 'xyz'.\n\n See hou.hmath.buildRotateAboutAxis for an example of how to convert\n Euler angles into an axis and rotation.\n\n See hou.ObjNode.setParmTransform for an example. This method is the\n inverse of hou.hmath.buildTransform. See also the other functions in\n hou.hmath that build transformation matrices.\n\n\n \"\"\"\n def extractTranslates(self, transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ..., pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3:\n \"\"\"\n\n extractTranslates(self, transform_order='srt',\n pivot_rotate=hou.Vector3(), pivot=hou.Vector3()) -> hou.Vector3\n\n A shortcut for self.explode(transform_order, hou.Vector3(), pivot,\n pivot_rotate)['translate']. See hou.Matrix4.explode for more\n information.\n\n > >>> matrix = hou.hmath.buildTranslate(1, 0, 0) * hou.hmath.buildRotate(0, 0, 45)\n > >>> matrix.extractTranslates('trs')\n > \n > >>> matrix.extractTranslates('srt')\n > \n\n \"\"\"\n def extractRotates(self, transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ..., rotate_order: Literal['xyz','xzy','yxz','yzx','zxy','zyx'] = ..., pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3:\n \"\"\"\n\n extractRotates(self, transform_order='srt', rotate_order='xyz',\n pivot=hou.Vector3(), pivot_rotate=hou.Vector3()) -> hou.Vector3\n\n A shortcut for self.explode(transform_order, rotate_order, pivot,\n pivot_rotate)['rotate']. See hou.Matrix4.explode for more\n information.\n\n\n \"\"\"\n def extractScales(self, transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ..., pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3:\n \"\"\"\n\n extractScales(self, transform_order='srt', pivot=hou.Vector3(),\n pivot_rotate=hou.Vector3()) -> hou.Vector3\n\n A shortcut for self.explode(transform_order, rotate_order, pivot,\n pivot_rotate)['scale']. See hou.Matrix4.explode for more\n information.\n\n\n \"\"\"\n def extractShears(self, transform_order: Literal['srt','str','rst','rts','tsr','trs'] = ..., pivot: Vector3 = ..., pivot_rotate: Vector3 = ...) -> Vector3:\n \"\"\"\n\n extractShears(self, transform_order='srt', pivot=hou.Vector3(),\n pivot_rotate=hou.Vector3()) -> hou.Vector3\n\n A shortcut for self.explode(transform_order, rotate_order, pivot,\n pivot_rotate)['shear']. See hou.Matrix4.explode for more\n information.\n\n\n \"\"\"\n def extractRotationMatrix3(self) -> Matrix3:\n \"\"\"\n\n extractRotationMatrix3(self) -> hou.Matrix3\n\n Extracts the 3x3 rotation matrix from this matrix, assuming it is a\n transformation matrix. If it fails to extract the rotation, for\n example if scaling is zero on one axis, it returns the identity\n matrix instead.\n\n\n \"\"\"\n def setToPerspective(self, zoom: float, image_aspect: float = 1, pixel_aspect: float = 1, clip_near: float = 0, clip_far: float = 1, window_xmin: float = 0, window_xmax: float = 1, window_ymin: float = 0, window_ymax: float = 1) -> None:\n \"\"\"\n\n setToOrthographic(self, zoom, orthowidth=1, image_aspect=1,\n pixel_aspect=1, clip_near=0, clip_far=1, window_xmin=0, window_xmax=1,\n window_ymin=0, window_ymax=1)\n\n Set this matrix to an orthographic projection matrix with the given\n parameters.\n\n Sometimes the zoom is expressed in terms of focal and aperture. In\n this case: zoom = focal/aperture. Sometimes the image_aspect is\n expressed in terms of xres and yres. In this case: image_aspect =\n xres / yres.\n\n\n \"\"\"\n def setToOrthographic(self, zoom: float, orthowidth: float = 1, image_aspect: float = 1, pixel_aspect: float = 1, clip_near: float = 0, clip_far: float = 1, window_xmin: float = 0, window_xmax: float = 1, window_ymin: float = 0, window_ymax: float = 1) -> None: ...\n\nclass MenuParmTemplate(ParmTemplate):\n \"\"\"\n\n hou.MenuParmTemplate\n\n Describes a menu parameter containing evaluating to integer values. Note\n that StringParmTemplates may also have menus.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, name: str, label: str, menu_items: Sequence[str], menu_labels: Sequence[str] = ..., default_value: int = ..., icon_names: Sequence[str] = ..., item_generator_script: str = ..., item_generator_script_language: EnumValue|None = ..., disable_when: str|None = ..., menu_type: EnumValue = ..., is_hidden: bool = ..., is_label_hidden: bool = ..., join_with_next: bool = ..., help: str|None = ..., script_callback: str|None = ..., script_callback_language: EnumValue = ..., tags: Mapping[str, str] = ..., default_expression: str = ..., default_expression_language: EnumValue = ..., store_default_value_as_string: bool = ..., menu_use_token: bool = ..., is_button_strip: bool = ..., strip_uses_icons: bool = ...) -> None:\n '''\n\n __init__(self, name, label, menu_items, menu_labels=(), default_value=0,\n icon_names=(), item_generator_script=\\'\\',\n item_generator_script_language=None, disable_when=None,\n menu_type=hou.menuType.Normal, is_hidden=False, is_label_hidden=False,\n join_with_next=False, help=None, script_callback=None,\n script_callback_language=hou.scriptLanguage.Hscript, tags={},\n default_expression=\\\\\"\\\\\",\n default_expression_language=hou.scriptLanguage.Hscript,\n store_default_value_as_string=False, menu_use_token=False,\n is_button_strip=False, strip_uses_icons=False)\n\n\n name\n See hou.ParmTemplate.name for more information.\n\n label\n See hou.ParmTemplate.label for more information.\n\n menu_items\n See the menuItems method for more information.\n\n menu_labels\n See the menuLabels method for more information.\n\n If this parameter is not given, it defaults to the value of the\n menu_items parameter.\n\n default_value\n See the defaultValue method for more information.\n\n icon_names\n See the iconNames method for more information.\n\n If this parameter is an empty tuple, the menu will not contain\n icons.\n\n item_generator_script\n See the itemGeneratorScript method for more information.\n\n item_generator_script_language\n See the itemGeneratorScriptLanguage method for more information.\n If this parameter is None it defaults to\n hou.scriptLanguage.Python.\n\n menu_type\n See the menuType method for more information.\n\n disable_when\n See hou.ParmTemplate.disableWhen for more information.\n\n is_hidden\n See hou.ParmTemplate.isHidden for more information.\n\n is_label_hidden\n See hou.ParmTemplate.isLabelHidden for more information.\n\n join_with_next\n See hou.ParmTemplate.joinsWithNext for more information.\n\n help\n See hou.ParmTemplate.help for more information.\n\n script_callback\n See hou.ParmTemplate.scriptCallback for more information.\n\n script_callback_language\n See hou.ParmTemplate.scriptCallbackLanguage for more\n information.\n\n tags\n See hou.ParmTemplate.tags for more information.\n\n default_expression\n See the defaultExpression method for more information.\n\n default_expression_language\n See the defaultExpressionLanguage method for more information.\n\n store_default_value_as_string\n If set to True then the template stores the chosen default\n string instead of the default index in dialog scripts and other\n parameter formats internal to Houdini. menu_use_token: See the\n menuUseToken method for more information.\n\n is_button_strip\n See hou.ParmTemplate.isButtonStrip for more information.\n\n strip_uses_icons\n See hou.ParmTemplate.isIconStrip for more information.\n\n Note that MenuParmTemplates have only one component.\n\n\n '''\n __swig_destroy__: Incomplete\n def defaultValue(self) -> int:\n \"\"\"\n\n defaultValue(self) -> int\n\n Return the index of the default menu item.\n\n See also the defaultValueAsString method.\n\n\n \"\"\"\n def defaultValueAsString(self) -> str: ...\n def setDefaultValue(self, default_value: int) -> None:\n \"\"\"\n\n setDefaultValue(self, default_value)\n\n Set the index of the default menu item.\n\n Note that if this index is out of range of the menu item entries, it\n will be adjusted. If the menu is driven by a script, i.e. the\n itemGeneratorScript is set to a non-empty value, the default value\n is not adjusted.\n\n\n \"\"\"\n def defaultExpression(self) -> str:\n \"\"\"\n\n defaultExpression(self) -> string\n\n Return the expression, which when evaluated, returns the index of\n the default menu item.\n\n The default expression takes precedence over the default value. If\n the default expression is not set (i.e. an empty string), then the\n default value is used instead.\n\n Note that the default expression language is needed to interpret the\n meaning of the default expression.\n\n\n \"\"\"\n def setDefaultExpression(self, default_expression: str) -> None:\n \"\"\"\n\n setDefaultExpression(self, default_expression)\n\n Set the default expression, which when evaluated, returns the index\n of the default menu item.\n\n If default_expression is the empty string, then the default\n expression is unset.\n\n\n \"\"\"\n def defaultExpressionLanguage(self) -> EnumValue:\n \"\"\"\n\n defaultExpressionLanguage(self) -> hou.scriptLanguage\n\n Return the default expression language.\n\n The default expression language only applies if the default\n expression is set. If the default expression is not set, then the\n expression language is set to hou.scriptLanguage.Hscript.\n\n\n \"\"\"\n def setDefaultExpressionLanguage(self, default_expression_language: EnumValue) -> None:\n \"\"\"\n\n setDefaultExpressionLanguage(self, default_expression_language)\n\n Set the default expression language.\n\n See the defaultExpressionLanguage method for more information.\n\n\n \"\"\"\n def menuItems(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuItems(self) -> tuple of str\n\n Return the tuple of internal menu names.\n\n These internal menu names are not displayed in the UI, but they can\n be passed to hou.Parm.set and will be returned by\n hou.Parm.evalAsString for menu parameters.\n\n\n \"\"\"\n def setMenuItems(self, menu_items: Sequence[str]) -> None:\n \"\"\"\n\n setMenuItems(self, menu_items)\n\n Set the internal menu names to the given sequence of strings.\n\n See the menuItems method for more information.\n\n If the new number of menu items is less than the old number, the\n menu labels will be shortened and the default value will be modified\n if it is out of range.\n\n\n \"\"\"\n def menuLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuLabels(self) -> tuple of str\n\n Return the tuple of menu labels displayed in the UI.\n\n\n \"\"\"\n def setMenuLabels(self, menu_labels: Sequence[str]) -> None:\n \"\"\"\n\n setMenuLabels(self, menu_labels)\n\n Set the menu labels displayed in the UI to the given sequence of\n strings.\n\n If the number of menu labels is less than the number of menu items,\n Houdini uses the internal menu item names for the missing labels. If\n the number of labels is more than the number of menu items, Houdini\n discards the extra labels.\n\n If you want to change both the menu items and menu labels, be sure\n to change the menu items first.\n\n\n \"\"\"\n def iconNames(self) -> Tuple[str, ...]:\n \"\"\"\n\n iconNames(self) -> tuple of str\n\n Return the tuple of icons corresponding to the menu items. If there\n are no icons, returns a tuple of empty strings.\n\n\n \"\"\"\n def setIconNames(self, icon_names: Sequence[str]) -> None:\n \"\"\"\n\n setIconNames(self, icon_names)\n\n Set the icon names to the given sequence of strings.\n\n\n \"\"\"\n def itemGeneratorScript(self) -> str:\n \"\"\"\n\n itemGeneratorScriptLanguage(self) -> hou.scriptLanguage enum value\n\n Return the programming language for the script that generates menu\n items.\n\n\n \"\"\"\n def setItemGeneratorScript(self, item_generator_script: str) -> None:\n \"\"\"\n\n setItemGeneratorScript(self, item_generator_script)\n\n Set the script used to generate menu items.\n\n See the itemGeneratorScript method for more information.\n\n\n \"\"\"\n def itemGeneratorScriptLanguage(self) -> EnumValue: ...\n def setItemGeneratorScriptLanguage(self, language: EnumValue) -> None:\n \"\"\"\n\n setItemGeneratorScriptLanguage(self, language)\n\n Set the script language used to generate menu items to a\n hou.scriptLanguage enum value.\n\n See the itemGeneratorScriptLanguage method for more information.\n\n\n \"\"\"\n def menuType(self) -> EnumValue:\n \"\"\"\n\n menuType(self) -> hou.menuType enum value\n\n Return the type of menu. Note that some menu types only apply to\n string parameters with menus, so the meaningful menu types for\n MenuParmTemplates are hou.menuType.Normal (for standard menus) and\n hou.menuType.Mini for menus that only display a dropdown arrow. See\n hou.menuType for more information.\n\n\n \"\"\"\n def setMenuType(self, menu_type: EnumValue) -> None:\n \"\"\"\n\n setMenuType(self, menu_type)\n\n Set the type of menu to a hou.menuType enum value.\n\n See the menuType method for more information.\n\n\n \"\"\"\n def menuUseToken(self) -> bool:\n \"\"\"\n\n menuUseToken(self) -> bool\n\n Return whether the parameter is set to the token value instead of\n the index.\n\n See also the setMenuUseToken method.\n\n\n \"\"\"\n def setMenuUseToken(self, menuusetoken: bool) -> None:\n \"\"\"\n\n setMenuUseToken(self, on)\n\n Set whether the parameter is set to the token value instead of the\n index.\n\n See also the menuUseToken method.\n\n\n \"\"\"\n def isButtonStrip(self) -> bool:\n \"\"\"\n\n isButtonStrip(self) -> bool\n\n Return whether the parameter is set to use the button strip widget.\n\n\n \"\"\"\n def isIconStrip(self) -> bool:\n \"\"\"\n\n isIconStrip(self) -> bool\n\n Return whether the parameter is set to use the icon strip widget.\n\n\n \"\"\"\n def isMenu(self) -> bool:\n \"\"\"\n\n isMenu(self) -> bool\n\n Return whether the parameter is set to use the drop down menu\n widget.\n\n\n \"\"\"\n def setAsButtonStrip(self) -> None:\n \"\"\"\n\n setAsButtonStrip(self)\n\n Set the parameter to use a Button Strip widget.\n\n See also the setAsMenu, setAsIconStrip methods.\n\n\n \"\"\"\n def setAsIconStrip(self) -> None:\n \"\"\"\n\n setAsIconStrip(self)\n\n Set the parameter to use a Icon Strip widget.\n\n See also the setAsMenu, setAsButtonStrip methods.\n\n\n \"\"\"\n def setAsMenu(self) -> None:\n \"\"\"\n\n setAsMenu(self)\n\n Turn back the parameter to a default menu drop down.\n\n See also the setAsButtonStrip, setAsIconStrip methods.\n\n\n \"\"\"\n\nclass NanoVDB:\n \"\"\"\n\n hou.NanoVDB\n\n An NanoVDB object contains the voxels that define a sparse 3D vdb\n volume. For example, COP nodes in Houdini can generate multiple NanoVDB\n objects.\n\n If you ask a COP for its geometry via the hou.CopNode.vdb, you'll cook\n the COP and get a read-only hou.NanoVDB. Unlike with SOPs and Geometry\n objects, the result is no longer tied to the COP Node so it stays the\n same if the COP node recooks or is deleted.\n\n Call hou.NanoVDB.freeze to edit an NanoVDB. This returns another NanoVDB\n object that's an independent writeable copy. Writing to the frozen layer\n doesn't affect the earlier read-only versions.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, layer: Optional[NanoVDB] = None) -> None:\n \"\"\"\n\n hou.NanoVDB\n\n An NanoVDB object contains the voxels that define a sparse 3D vdb\n volume. For example, COP nodes in Houdini can generate multiple NanoVDB\n objects.\n\n If you ask a COP for its geometry via the hou.CopNode.vdb, you'll cook\n the COP and get a read-only hou.NanoVDB. Unlike with SOPs and Geometry\n objects, the result is no longer tied to the COP Node so it stays the\n same if the COP node recooks or is deleted.\n\n Call hou.NanoVDB.freeze to edit an NanoVDB. This returns another NanoVDB\n object that's an independent writeable copy. Writing to the frozen layer\n doesn't affect the earlier read-only versions.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __enter__(self) -> Optional[NanoVDB]: ...\n def __exit__(self, type: Any, value: Any, traceback: Any) -> None: ...\n def close(self) -> None:\n \"\"\"\n\n close(self)\n\n Resets this object to be an empty object. This stops it holding a\n reference to the underlying NanoVDB data. This will also happen when\n the object goes out of scope and is garbage collected, but the\n close() provides exact control over the timing.\n\n NanoVDBs also support contexts so the with statement can be used to\n auto-close the nanovdb at the with-block end.\n\n\n \"\"\"\n def vdbType(self) -> EnumValue:\n \"\"\"\n\n vdbType(self) -> hou.EnumValue\n\n Returns the vdb's vdb type, which consists of its precision, float\n vs integer, and vector size.\n\n\n \"\"\"\n def typeInfo(self) -> EnumValue:\n \"\"\"\n\n typeInfo(self) -> hou.EnumValue\n\n Returns the semantic type of the vdb. This is used for things like\n automatic visualizations.\n\n\n \"\"\"\n def setTypeInfo(self, storagetype: EnumValue) -> None:\n \"\"\"\n\n setTypeInfo(self, storagetype)\n\n Changes the semantic type of the vdb.\n\n Requires a writable layer.\n\n\n \"\"\"\n def leafCount(self) -> int:\n \"\"\"\n\n leafCount(self) -> int64\n\n Returns the number of active leaf nodes in the VDB. If the leaf\n nodes are fully active, the active voxels will be 512 times this.\n\n\n \"\"\"\n def onCPU(self) -> bool:\n \"\"\"\n\n onCPU(self) -> bool\n\n A NanoVDB may be stored on the CPU or GPU. This is true if it is\n stored on the CPU.\n\n\n \"\"\"\n def onGPU(self) -> bool:\n \"\"\"\n\n onGPU(self) -> bool\n\n A NanoVDB may be stored on the CPU or GPU. This is true if it is\n stored on the GPU.\n\n\n \"\"\"\n def voxelSize(self) -> Vector3:\n \"\"\"\n\n voxelSize(self) -> hou.Vector3\n\n The world space size of voxels in the VDB.\n\n\n \"\"\"\n def indexToWorldTransform(self) -> Matrix4:\n \"\"\"\n\n indexToWorldTransform(self) -> hou.Matrix4\n\n A transform from the voxel indices into worlds space. Note this does\n not account for tapers.\n\n\n \"\"\"\n def worldToIndexTransform(self) -> Matrix4:\n \"\"\"\n\n worldToIndexTransform(self) -> hou.Matrix4\n\n A transform from the world space into the voxel indices. Note this\n does not account for tapers.\n\n\n \"\"\"\n def freeze(self) -> Optional[NanoVDB]:\n \"\"\"\n\n freeze(self) -> hou.NanoVDB\n\n Create a writable copy of this and return it.\n\n\n NOTE\n The actual buffer duplication won't be done until a write is\n performed.\n\n\n \"\"\"\n def isFrozen(self) -> bool:\n \"\"\"\n\n isFrozen(self) -> bool\n\n Returns if this is frozen, and hence writable.\n\n\n \"\"\"\n def attributes(self) -> dict[str, Any]:\n \"\"\"\n\n attributes(self) -> std::map\n\n Returns the vdb attributes present on this layer.\n\n\n \"\"\"\n def setAttributes(self, p: dict[str, Any]) -> None:\n \"\"\"\n\n setAttributes(self, std::map None:\n \"\"\"\n\n updateAttributes(self, std::map bytes:\n \"\"\"\n\n rawNanoVDB(self) -> hou.BinaryString\n\n Return all the voxels as a binary string. This is in the NanoVDB\n memory layout, so can be re-interpreted into third party tools that\n understand NanoVDB.\n\n Note NanoVDB is not meant as a long term storage format, so it is\n recommended any long term storage is done with VDBs rather than\n relying on this format being the same.\n\n\n \"\"\"\n def setFromRawNanoVDB(self, values: Any) -> None:\n \"\"\"\n\n setFromRawNanoVDB(self, values, length)\n\n Take a binary string in values and replaces this NanoVDB with the\n NanoVDB so encoded.\n\n\n \"\"\"\n\nclass NetworkDot(IndirectInput):\n \"\"\"\n\n hou.NetworkDot\n\n A small dot in a network that allows wires to be routed along specific\n paths without affecting the data passing through them.\n\n Network dots are allowed to have a single input, but may have many\n outputs. They can be moved around to force a wire connecting two nodes\n to follow a specific path. They can also be used as scaffolding for a\n set of nodes that you want to be able to quickly add or remove in a\n larger network.\n\n New dots are created by calling hou.Node.createNetworkDot on the node\n that will contain the dot. A list of all existing dots in a network can\n be generated by calling hou.Node.networkDots.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isPinned(self) -> bool:\n \"\"\"\n\n isPinned(self) -> bool\n\n Returns the pinned state of this dot. See hou.NetworkDot.setPinned\n for a more detailed discussion of the meaning of a pinned dot.\n\n\n \"\"\"\n def setPinned(self, pinned: bool) -> None:\n \"\"\"\n\n setPinned(self, pinned)\n\n Sets the boolean pinned state of this dot. Pinned dots are not\n functionally different from unpinned dots, but are treated\n differently by the network editor. A pinned dot remains even if its\n input and output connections are removed. An unpinned dot will be\n deleted automatically by the network editor if its input or last\n output is cut.\n\n The following code is a greatly simplified version of the code for\n automatically deleting unconnected dots, which will delete any dots\n that are not pinned and that don't have an input connection:\n\n > >>> net = hou.node('/obj')\n > >>> net.createNetworkDot().setPinned(False)\n > >>> net.createNetworkDot().setPinned(True)\n > >>> net.networkDots()\n > (, )\n > >>> for dot in net.networkDots():\n > ... if not dot.isPinned():\n > ... if dot.inputItem() is None:\n > ... dot.destroy()\n > ...\n > >>> net.networkDots()\n > (,)\n\n \"\"\"\n def setInput(self, input_index: int, item_to_become_input: NetworkMovableItem|None, output_index: int = ...) -> None:\n \"\"\"\n\n setInput(self, item_to_become_input, output_index=0)\n\n Connects a network item to the input of this dot. This effectively\n rewires any nodes that are connected to the output of this dot.\n\n Raises hou.InvalidInput if output_index is invalid. Raises\n hou.OperationFailed if item_to_become_input is not in the same\n network as this dot. Raises hou.PermissionError if the dot is inside\n a locked asset.\n\n\n \"\"\"\n def inputConnections(self) -> Tuple[NodeConnection, ...]:\n \"\"\"\n\n inputConnections(self) -> tuple of hou.NodeConnection\n\n Returns a tuple of hou.NodeConnection objects for the connection\n coming into this dot. The tuple will have a length of one if\n anything is connected to the input of this dot. Returns an empty\n tuple if nothing is connected.\n\n\n \"\"\"\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Delete this dot. Connections in and out of the dot are automatically\n re-established such that the behavior of the network will be\n unchanged by the removal of this dot.\n\n\n \"\"\"\n\nclass OpNetworkDot(OpIndirectInput, NetworkDot):\n \"\"\"\n\n hou.OpNetworkDot\n\n A small dot in an OP network that allows wires to be routed along\n specific paths without affecting the data passing through them.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n\nclass NetworkEditor(PathBasedPaneTab):\n \"\"\"\n\n hou.NetworkEditor\n\n Represents a Network Editor panetab.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def isShowingConnectors(self) -> bool:\n \"\"\"\n\n isShowingConnectors(self) -> bool\n\n Return True if the network editor zoom level is high enough that\n input and output connectors are visible. This can be useful in\n network editor event handlers that expect the user to click on a\n connector. If the connectors are not visible, some alternative\n interaction is required.\n\n\n \"\"\"\n def isUnderCursor(self) -> bool: ...\n def isPosInside(self, pos: Vector2, ignore_floating_windows: bool = True) -> bool:\n \"\"\"\n\n isPosInside(self, pos, ignore_floating_windows=True) -> bool\n\n Return True if the hou.Vector2 passed as the pos parameter is inside\n the network view. The values in pos are mouse coordinates expressed\n relative to the network editor pane.\n\n\n ignore_floating_windows\n When set to True, isPosInside will ignore any windows floating\n over the network view at the given position and will return True\n as long as the position is inside the network view area. When\n set to False, isPosInside will additionally check for floating\n windows and will return True if the position is inside the\n network view and if no other window is on top of the network\n view at the given position.\n\n\n \"\"\"\n def setCursorPosition(self, pos: Vector2) -> None:\n \"\"\"\n\n setCursorPosition(self, pos)\n\n Moves the mouse cursor to the position specified by the hou.Vector2\n pos parameter.\n\n\n \"\"\"\n def cursorPosition(self, confine_to_view: bool = True) -> Vector2:\n '''\n\n cursorPosition(self, confine_to_view=True) -> hou.Vector2\n\n Return the current mouse cursor position expressed in network view\n coordinates. If confine_to_view is True, the returned value will be\n clipped to the area of the network currently visible in the network\n editor.\n\n Here is an example of moving a node underneath the mouse cursor:\n\n > # Get the network editor.\n > net_editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > \n > # Get the node.\n > node = hou.node(\\\\\"/obj/myNode\\\\\")\n > \n > # Set the node\\'s new position.\n > node.setPosition(net_editor.cursorPosition())\n\n '''\n def screenBounds(self) -> BoundingRect:\n \"\"\"\n\n screenBounds(self) -> hou.BoundingRect\n\n Return the screen space bounds of the network editor viewing area.\n This does not include the menu bar, toolbar, or other UI elements.\n Only the area where the network contents are displayed is returned.\n The bounds are relative to the network area itself, so the lower\n left corner of the returned bounding box will always be (0, 0).\n\n\n \"\"\"\n def visibleBounds(self) -> BoundingRect:\n \"\"\"\n\n visibleBounds(self) -> hou.BoundingRect\n\n Return the network space bounds of the network editor viewing area.\n\n\n \"\"\"\n def setVisibleBounds(self, bounds: BoundingRect, transition_time: float = 0.0, max_scale: float = 0.0, set_center_when_scale_rejected: bool = False) -> None:\n \"\"\"\n\n setVisibleBounds(self, bounds, transition_time=0.0, max_scale=0.0,\n set_center_when_scale_rejected=False)\n\n Sets the visible bounds of the network editor viewing area,\n expressed in network space coordinates. This method will never alter\n the screen space size or location of the network editor. If the area\n specified by the bounds parameter has a different aspect ratio from\n the actual network editor, this method will automatically adjust the\n bounds to ensure that the area specified is fully visible.\n\n\n bounds\n A hou.BoundingRect specifying the area that should be visible in\n the network editor.\n\n transition_time\n The amount of time, in seconds, over which the network editor\n will animate the transition from the current visible bounds to\n the new visible bounds.\n\n max_scale\n If set to a non-zero value, this parameter controls the maximum\n zoom level that will be allowed. The default maximum scale used\n by the network editor code is 100.\n\n set_centered_when_scale_rejected\n If set to True, but the new zoom level is determined to be the\n same as the previous zoom, no change is made to the bounds at\n all. This prevents a bounds change, that was intended as a pure\n zoom, from inadvertently panning the view if the zoom doesn't\n actually change.\n\n\n \"\"\"\n def requestZoomReset(self) -> None:\n \"\"\"\n\n requestZoomReset()\n\n Request zoom reset so that all the items in the network will be\n visible. Actual calculation happens in the next drawing.\n\n\n \"\"\"\n def isZoomResetRequested(self) -> bool:\n \"\"\"\n\n isZoomResetRequested()\n\n Return True if there has been a request to reset zoom. This means\n the visible bounds are not vaild until the next drawing. After the\n reset this function will return False.\n\n\n \"\"\"\n def setLocatingEnabled(self, enabled: bool) -> None:\n \"\"\"\n\n setLocatingEnabled(self, enabled)\n\n Enables or disables highlighting of UI elements under the mouse in\n the network editor. When disabled, mouse events sent to the network\n editor event processing code will never specify a located or\n selected UI element. In some modes (such as when in a viewing state\n where mouse events only modify the view) it is desirable to disable\n this behavior.\n\n\n \"\"\"\n def locatingEnabled(self) -> bool:\n \"\"\"\n\n locatingEnabled(self) -> bool\n\n Return True if the network editor will highlight UI elements under\n the mouse, and allow clicking on those UI elements.\n\n\n \"\"\"\n def lengthToScreen(self, len: float) -> float:\n \"\"\"\n\n lengthToScreen(self, len) -> float\n\n Given a length value len, expressed in network units, return the\n equivalent length in screen units (pixels). The result will depend\n on the current zoom level of the network editor.\n\n\n \"\"\"\n def lengthFromScreen(self, len: float) -> float:\n \"\"\"\n\n lengthFromScreen(self, len) -> float\n\n Given a length value len, expressed in screen units (pixels), return\n the equivalent length in network units. The result will depend on\n the current zoom level of the network editor.\n\n\n \"\"\"\n def sizeToScreen(self, size: Vector2) -> Vector2:\n \"\"\"\n\n sizeToScreen(self, size) -> hou.Vector2\n\n Given a box size value size as a hou.Vector2, expressed in network\n units, return the equivalent size in screen units (pixels). This is\n equivalent to making two separate calls to lengthToScreen() for the\n width and height. The result will depend on the current zoom level\n of the network editor.\n\n\n \"\"\"\n def sizeFromScreen(self, size: Vector2) -> Vector2:\n \"\"\"\n\n sizeFromScreen(self, size) -> hou.Vector2\n\n Given a box size value size as a hou.Vector2, expressed in screen\n units (pixels), return the equivalent size in network units. This is\n equivalent to making two separate calls to lengthFromScreen() for\n the width and height. The result will depend on the current zoom\n level of the network editor.\n\n\n \"\"\"\n def posToScreen(self, pos: Vector2) -> Vector2:\n \"\"\"\n\n posToScreen(self, pos) -> hou.Vector2\n\n Given a position value pos as a hou.Vector2, expressed in network\n units, return the equivalent position in screen units (pixels). The\n result will depend on both the current zoom level and view position\n of the network editor.\n\n This method is intended to be used for drawing and positioning\n within the network editor, so the returned screen coordinates are in\n pixels relative to the lower left corner of the network editor\n window, rather than being relative to a specific position on the\n user's monitor. If the specified position is not currently visible\n in the network editor pane, the resulting screen position may be\n negative, or larger than the size of the network editor pane (see\n hou.NetworkEditor.visibleBounds).\n\n\n \"\"\"\n def posFromScreen(self, pos: Vector2) -> Vector2:\n \"\"\"\n\n posFromScreen(self, pos) -> hou.Vector2\n\n Given a position value pos as a hou.Vector2, expressed in screen\n units (pixels), return the equivalent position in network units. The\n result will depend on both the current zoom level and view position\n of the network editor.\n\n See hou.NetworkEditor.posToScreen for more detail about the way the\n screen position is interpreted by this method.\n\n\n \"\"\"\n def overviewPosToScreen(self, pos: Vector2) -> Vector2:\n \"\"\"\n\n overviewPosToScreen(self, pos) -> hou.Vector2\n\n Given a position value pos as a hou.Vector2, expressed in network\n units, return the equivalent position in screen units (pixels)\n within the overview gadget in the network editor. This method\n returns a value that assumes the overview area is visible, even if\n it is not.\n\n\n \"\"\"\n def overviewPosFromScreen(self, pos: Vector2) -> Vector2:\n \"\"\"\n\n overviewPosFromScreen(self, pos) -> hou.Vector2\n\n Given a position value pos as a hou.Vector2, expressed in screen\n units (pixels) within the overview gadget, return the equivalent\n position in network units. This method returns a value that assumes\n the overview area is visible, even if it is not. If the provided\n position is outside the overview area, this method returns a value\n that assumes the overview gadget extends as far as required to reach\n the specified coordinates.\n\n\n \"\"\"\n def overviewVisible(self) -> bool:\n \"\"\"\n\n overviewVisible(self) -> bool\n\n Return a boolean indicating whether or not the overview gadget is\n currently visible. This result reflects the true state of the\n overview gadget even if the overview is configured to display\n automatically.\n\n\n \"\"\"\n def overviewVisibleIfAutomatic(self) -> bool:\n \"\"\"\n\n overviewVisibleIfAutomatic(self) -> bool\n\n Return a boolean indicating whether or not the overview gadget would\n currently be visible if it was configured to display automatically.\n In other words, this method returns True if any part of the network\n is currently outside the visible bounds of the editor.\n\n\n \"\"\"\n def networkItemsInBox(self, pos1: Vector2, pos2: Vector2, for_drop: bool = False, for_select: bool = False) -> Tuple[Tuple[NetworkItem, str, int], ...]:\n \"\"\"\n\n networkItemsInBox(self, pos1, pos2, for_drop=False, for_select=False) ->\n tuple of (hou.NetworkItem, str, int)\n\n Return any network items inside the bounding box defined by the\n hou.Vector2 points pos1 and pos2. These points are specified in\n screen space, which makes it easy to call this function given a\n mouse position.\n\n The returned tuple of triples are sorted in increasing distance from\n the center of the specified bounding box. Each triple consists of a\n network item (which may be a node, sticky note, wire, etc.), a\n string which describes the part of the UI for that item that was\n found in the box, and an optional index value which differentiates\n between different instances of the same item/name combination. For\n example, if the connector for input 2 of the node geo1 was the only\n thing inside the provided box, the return value would be:\n\n > >>> editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > >>> editor.networkItemsInBox(pos1, pos2)\n > ((, 'input', 2),)\n\n One of for_drop or for_select may be set to True to use a different\n criteria for deciding what a valid target is. By default, any UI\n widget that highlights with the mouse over it will be returned by\n this method. Setting for_drop to True will return only UI widgets\n that can be drop targets. Setting for_select to True will only\n return UI widgets that result in the item being selected when box\n picking.\n\n\n \"\"\"\n def setDropTargetItem(self, item: NetworkItem, name: str, index: int) -> None:\n \"\"\"\n\n setDropTargetItem(self, item, name, index)\n\n When the user is performing a drag and drop operation within the\n network editor, it is important that they receive some feedback\n about where the thing they are dragging will be dropped if they let\n go of the mouse button. This indication is provided by highlighting\n the drop target in the UI. This method allows the current drop\n target to be specified in python code. Usually the item, name, and\n index will be values returned in one of the tuples from the\n networkItemsInBox method.\n\n\n \"\"\"\n def dropTargetItem(self) -> Tuple[NetworkItem, str, int]:\n \"\"\"\n\n dropTargetItem(self) -> (hou.NetworkItem, str, int)\n\n Return the currently set drop target item information. These are\n just the values passed into the last call to setDropTargetItem.\n\n\n \"\"\"\n def setDecoratedItem(self, item: NetworkItem, interactive: bool) -> None:\n \"\"\"\n\n setDecoratedItem(self, item, interactive)\n\n This method is similar to setDropTargetItem in that it tells the\n network editor to highlight a particular item when drawing it. In\n the case of the decorated item, however, only the network item needs\n to be provided. The result of setting a node as the decorated item\n is to bring up the node ring. Network dots may also be the decorated\n item, in which case the input and output connectors for the dot are\n shown. The interactive boolean flag indicates whether the user is\n allowed to interact with the decorations. If not, the node ring is\n drawn faded, and its buttons cannot be clicked. This non-interactive\n mode corresponds to having the Control key pressed while moving the\n mouse around the network editor.\n\n\n \"\"\"\n def decoratedItem(self) -> Optional[NetworkItem]:\n \"\"\"\n\n decoratedItem(self) -> hou.NetworkItem\n\n Return the currently set decorated item. This is just the item value\n passed into the last call to setDecoratedItem.\n\n\n \"\"\"\n def decorationInteractive(self) -> bool:\n \"\"\"\n\n decorationInteractive(self) -> bool\n\n Return whether the currently decorated item is interactive. This is\n just the interactive value passed into the last call to\n setDecoratedItem.\n\n\n \"\"\"\n def setPreSelectedItems(self, items: Sequence[NetworkItem]) -> None:\n \"\"\"\n\n setPreSelectedItems(self, items)\n\n When box selecting items in the network, it is useful to be able to\n see what will be selected if the mouse button is released. These\n items are drawn to the overlay layer of the network editor canvas in\n a light blue color with transparency. The network items passed as a\n tuple to this method are the ones that get drawn with this pre-\n selection highlight.\n\n\n \"\"\"\n def preSelectedItems(self) -> Tuple[NetworkItem, ...]:\n \"\"\"\n\n selectedConnections(self) -> tuple of hou.NodeConnection\n\n Return the currently selected wires.\n\n\n \"\"\"\n def selectedConnections(self) -> Tuple[NodeConnection, ...]: ...\n def clearAllSelected(self) -> None:\n \"\"\"\n\n clearAllSelected(self)\n\n For an OP network editor, the behavior is equivalent to\n hou.clearAllSelected, deselecting all network items and wires. For\n an APEX network editor, this clears the selection for the current\n APEX graph.\n\n\n \"\"\"\n def setNetworkBoxPendingRemovals(self, items: Sequence[NetworkMovableItem]) -> None:\n \"\"\"\n\n setNetworkBoxPendingRemovals(self, items)\n\n When moving items around the network, network boxes automatically\n resize to contain their child items as they move. To indicate that\n items will be removed from their network box, pass them as a tuple\n to this method. Doing so will cause their network box containers to\n not resize to fit the items as they move.\n\n\n \"\"\"\n def networkBoxPendingRemovals(self) -> Tuple[NetworkMovableItem, ...]:\n \"\"\"\n\n networkBoxPendingRemovals(self) -> tuple of hou.NetworkMovableItem\n\n Return the items currently pending remove from their network box.\n These are just the values passed into the last call to\n setNetworkBoxPendingRemovals.\n\n\n \"\"\"\n def setFootprints(self, footprints: typing.Iterable[NetworkFootprint]) -> None:\n \"\"\"\n\n setFootprints(self, footprints)\n\n Configure the footprint rings that the network editor should\n display. The footprints parameter must be a tuple of\n hou.NetworkFootprint objects. See that class for more information.\n\n\n \"\"\"\n def footprints(self) -> Tuple[NetworkFootprint, ...]:\n \"\"\"\n\n footprints(self) -> tuple of hou.NetworkFootprint\n\n Return the current footprint configuration as a tuple of\n hou.NetworkFootprint objects. These are just the values passed into\n the last call to setFootprints.\n\n\n \"\"\"\n def setCursorMap(self, cursors: dict[Tuple[str, int], str]) -> None:\n \"\"\"\n\n setCursorMap(self, cursors)\n\n Tells the network editor which mouse cursor to use based on what UI\n widget is under the mouse. This configuration is specified as a\n dictionary mapping a tuple to a string. The string is the name of\n the cursor, which can be any of the cursor file names from the\n $HFS/houdini/config/Cursors directory. Each tuple consists of a\n string and an integer. The string is the name of the UI widget, and\n the integer represents the specific index value within that UI\n widget.\n\n The following code sets the network editor to show a connect cursor\n for all node inputs and outputs:\n\n > >>> editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > >>> editor.setCursorMap({\n > ... ('input', -1): 'wire',\n > ... ('output', -1): 'wire'\n > ... })\n\n The following code sets the network editor to show an appropriate\n resize icon based on the specific section of the sticky note border\n under the mouse:\n\n > >>> editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > >>> editor.setCursorMap({\n > ... ('stickynoteborder', 0): 'arrowSWNE',\n > ... ('stickynoteborder', 1): 'arrowLeftRight',\n > ... ('stickynoteborder', 2): 'arrowNWSE',\n > ... ('stickynoteborder', 3): 'arrowUpDown',\n > ... ('stickynoteborder', 4): 'arrowSWNE',\n > ... ('stickynoteborder', 5): 'arrowLeftRight',\n > ... ('stickynoteborder', 6): 'arrowNWSE',\n > ... ('stickynoteborder', 7): 'arrowUpDown'\n > ... })\n\n \"\"\"\n def cursorMap(self) -> dict[Tuple[str, int], str]:\n \"\"\"\n\n cursorMap(self) -> dict of (str, int) to str\n\n Return the current mouse cursor configuration. This will just be the\n dictionary passed into the last call to setCursorMap.\n\n\n \"\"\"\n def setDefaultCursor(self, cursor_name: str) -> None:\n \"\"\"\n\n setDefaultCursor(self, cursor_name)\n\n Tells the network editor which mouse cursor to use when none of the\n UI mentioned in the dictionary sent to setCursorMap() is under the\n mouse.\n\n\n \"\"\"\n def defaultCursor(self) -> str:\n \"\"\"\n\n defaultCursor(self) -> str\n\n Return the default mouse cursor set by the last call to\n setDefaultCursor().\n\n\n \"\"\"\n def setBackgroundImages(self, images: typing.Iterable[NetworkImage]) -> None:\n \"\"\"\n\n setBackgroundImages(self, images)\n\n Configures the background images to be displayed in the network\n editor. The network editor saves and loads the image descriptions\n into the user data for each network, which allows a different set of\n background images for each network. The images are specified as a\n tuple of hou.NetworkImage objects. See the documentation of that\n class for more information.\n\n\n \"\"\"\n def backgroundImages(self) -> Tuple[NetworkImage, ...]:\n \"\"\"\n\n backgroundImages(self) -> tuple of hou.NetworkImage\n\n Return the descriptors for the current set of background images\n being displayed in the network editor. This will be the tuple passed\n into the last call to setBackgroundImages.\n\n\n \"\"\"\n def itemRect(self, item: NetworkMovableItem, adjusted: bool = True) -> BoundingRect:\n \"\"\"\n\n itemRect(self, item, adjusted=True) -> hou.BoundingRect\n\n Return the bounding rectangle of the hou.NetworkMovableItem\n specified by the item parameter. If the adjusted parameter is set to\n True, any adjustments to this item's size and position set in the\n most recent call to setAdjustments() will be taken into account. If\n False, these adjustments will be ignored. Note that for nodes, only\n the node body is taken into account, not the node name, badges, or\n other decorations.\n\n\n \"\"\"\n def itemInputPos(self, item: NetworkMovableItem, input_index: int, adjusted: bool = True) -> Vector2:\n \"\"\"\n\n itemInputPos(self, item, input_index, adjusted=True) -> hou.Vector2\n\n Return the center point of the input connector of the hou.Node or\n hou.NetworkDot specified by item. The input_index parameter\n specifies the specific input of interest. For network dots, this\n value must be zero. If the adjusted parameter is set to True, any\n adjustments to this item's size and position set in the most recent\n call to setAdjustments() will be taken into account. If False, these\n adjustments will be ignored.\n\n\n \"\"\"\n def itemInputDir(self, item: NetworkMovableItem, input_index: int) -> Vector2:\n \"\"\"\n\n itemInputDir(self, item, input_index) -> hou.Vector2\n\n Return a normalized vector indicating the direction at which the\n wire connected to the specified input should emerge from its\n connector. The item parameter may be a hou.Node or hou.NetworkDot.\n The input_index specifies which input is of interest. This value\n must be zero if the item is a network dot.\n\n\n \"\"\"\n def itemOutputPos(self, item: NetworkMovableItem, output_index: int, adjusted: bool = True) -> Vector2:\n \"\"\"\n\n itemOutputPos(self, item, output_index, adjusted=True) -> hou.Vector2\n\n Return the center point of the output connector of the hou.Node,\n hou.NetworkDot, or hou.SubnetIndirectInput specified by item. The\n output_index parameter specifies the specific output of interest.\n For network dots and subnet indirect inputs, this value must be\n zero. If the adjusted parameter is set to True, any adjustments to\n this item's size and position set in the most recent call to\n setAdjustments() will be taken into account. If False, these\n adjustments will be ignored.\n\n\n \"\"\"\n def itemOutputDir(self, item: NetworkMovableItem, output_index: int) -> Vector2:\n \"\"\"\n\n itemOutputDir(self, item, output_index) -> hou.Vector2\n\n Return a normalized vector indicating the direction at which the\n wire connected to the specified output should emerge from its\n connector. The item parameter may be a hou.Node, hou.NetworkDot, or\n hou.SubnetIndirectInput. The output_index specifies which output is\n of interest. This value must be zero if the item is a network dot or\n subnet indirect input.\n\n\n \"\"\"\n def allVisibleRects(self, ignore_items: Sequence[NetworkMovableItem], adjusted: bool = True) -> Tuple[Tuple[NetworkMovableItem, BoundingRect], ...]:\n \"\"\"\n\n allVisibleRects(self, ignore_items) -> tuple of (hou.NetworkMovableItem,\n hou.BoundingRect)\n\n This method is equivalent to calling itemRect() for every network\n item that is currently visible in the network editor. Getting these\n results in a single method call is significantly faster, and\n eliminates the need to test each item for visibility. This method is\n used for finding items to snap against when moving nodes. The\n ignore_items parameter is a tuple of hou.NetworkMovableItem objects\n that should not be returned in the result tuple.\n\n\n \"\"\"\n def setAdjustments(self, items: Sequence[NetworkItem], adjustments: typing.Iterable[NetworkAnimValue], auto_remove: bool = False) -> None:\n \"\"\"\n\n setAdjustments(self, items, adjustments, auto_remove=False)\n\n Configures temporary adjustments to the sizes and locations of\n network items in the editor. The items parameter is a tuple of\n hou.NetworkMovableItem objects. The adjustments parameter is a tuple\n of hou.NetworkAnimValue objects to associate with each network item\n in the items tuple. See the documentation of that class for more\n information about specifying adjustments.\n\n The auto_remove parameter may be set to True to indicate that the\n network editor should automatically delete the adjustments once the\n animation on them has completed. This is useful for animations\n performed at the end of a user action, where the following events do\n not relate to the changes being made, and so it is easier not to\n have to manage the reset of the adjustment values explicitly in the\n future.\n\n\n \"\"\"\n def setShapes(self, shapes: Sequence[NetworkShape]) -> None:\n \"\"\"\n\n setShapes(self, shapes)\n\n The shapes parameter specifies a tuple of hou.NetworkShape objects\n which will be drawn into the network editor. See documentation of\n the network shape class and its subclasses for more information.\n\n\n \"\"\"\n def setOverlayShapes(self, shapes: Sequence[NetworkShape]) -> None:\n \"\"\"\n\n setOverlayShapes(self, shapes)\n\n The shapes parameter specifies a tuple of hou.NetworkShape objects\n which will be drawn into the overlay layer of the network editor\n canvas. See documentation of the network shape class and its\n subclasses for more information.\n\n\n \"\"\"\n def setTooltip(self, tooltip: str) -> None:\n \"\"\"\n\n setTooltip(self, tooltip)\n\n Sets the tooltip string that should be shown under the mouse if it\n remains stationary for a short time. This string should generally be\n set to correspond to the network item currently under the mouse\n cursor. Because it appears after a delay, it is okay to make this\n text more verbose than the prompt text passed to setPromptText().\n\n\n \"\"\"\n def tooltip(self) -> str:\n \"\"\"\n\n tooltip(self) -> str\n\n Return the current tooltip string. This is the value that was last\n passed to the setTooltip() method.\n\n\n \"\"\"\n def setPrompt(self, prompt: str) -> None:\n \"\"\"\n\n setPrompt(self, prompt)\n\n Sets the prompt text that appears at the bottom of the network\n editor. This string should generally be set to correspond to the\n network item currently under the mouse cursor. This text should be\n fairly brief. More detailed information can be put into the tooltip\n through the setTooltip() method.\n\n\n \"\"\"\n def prompt(self) -> str:\n \"\"\"\n\n prompt(self) -> str\n\n Return the current prompt string. This is the value that was last\n passed to the setPromptText() method.\n\n\n \"\"\"\n def flashMessage(self, image: str|None, message: str|None, duration: float) -> None:\n \"\"\"\n\n flashMessage(self, image, message, duration)\n\n Causes a message to appear briefly in the upper left corner of the\n network editor, then fade away. The image parameter specifies an\n icon or image file that should be displayed along with the text\n specified in the message parameter. Either of these parameters may\n be None if only an image or only text is desired. The duration\n parameter specifies the time in seconds before the message should\n fade away.\n\n\n \"\"\"\n def openTabMenu(self, key: str|None = ..., auto_place: bool = ..., branch: bool = ..., src_item: NetworkMovableItem|None = ..., src_connector_index: int = ..., dest_item: NetworkMovableItem|None = ..., dest_connector_index: int = ..., node_position: Vector2|None = ..., src_items: Sequence[NetworkMovableItem]|None = ..., src_indexes: Sequence[int]|None = ..., dest_items: Sequence[NetworkMovableItem]|None = ..., dest_indexes: Sequence[int]|None = ...) -> None:\n \"\"\"\n\n openTabMenu(self, key=None, auto_place=False, branch=False,\n src_item=None, src_connector_index=-1, dest_item=None,\n dest_connector_index=-1, node_position=None, src_items=[],\n src_indexes=[], dest_items=[], dest_indexes=[])\n\n Opens the tab menu in the network editor. When the user chooses a\n tool from the tab menu, the parameters passed to this function\n determine the context information that will be sent to the tool\n script. Generally, most tools treat these parameters in a consistent\n way as described below.\n\n\n key\n The key used (if any) to open the menu. This same key pressed\n with the menu up will cause the menu to close.\n\n auto_place\n Set to True to make the tab menu turn on auto placement when a\n tool is chosen from the menu. The new node will be placed at a\n position determined automatically by the tab menu based on the\n source and destination nodes.\n\n branch\n Set to True to cause the new node to create a new branch instead\n of inserting the new node between the source and destination\n nodes.\n\n src_item\n The node, dot, or subnet indirect input that will be connected\n to the input of the new node created by the tab menu.\n\n src_item_connector_index\n The output index of the node that will be connected to the input\n of the new node created by the tab menu.\n\n dest_item\n The node or dot that will be connected to the output of the new\n node created by the tab menu.\n\n dest_connector_index\n The input index of the node or dot that will be connected to the\n output of the new node created by the tab menu.\n\n node_position\n The location to use for the new node created by the tab menu.\n\n src_items\n A list of nodes, dot, or subnet indirect inputs that will be\n connected to the input of the new node created by the tab menu.\n This parameter (and all other list-based source and destination\n paramaters) take precedence over the single item parameters if\n both are specified.\n\n src_item_connector_indexes\n A list of output indexes of the nodes that will be connected to\n the input of the new node created by the tab menu.\n\n dest_items\n A list of nodes or dots that will be connected to the output of\n the new node created by the tab menu.\n\n dest_connector_indexes\n A list of input indexes of the nodes or dots that will be\n connected to the output of the new node created by the tab menu.\n\n\n \"\"\"\n def openNodeMenu(self, node: Node|None = ..., items: Sequence[NetworkMovableItem]|None = ...) -> None:\n \"\"\"\n\n openNodeMenu(self, node = None, items = [])\n\n Brings up a node context menu under the current mouse position. The\n two parameters contol which node(s) will be affected by the menu\n option chosen by the user. If a hou.Node object is specified in the\n node parameter, the menu operation will affect that node, and, if\n that node is currently selected, all other selected network items\n will also be affected. If the items parameter is passed a non-empty\n list of hou.NetworkMovableItem objects, those items and only those\n items will be affected by the menu, regardless of the current\n selection.\n\n If the chosen menu item only operates on a single node, the original\n node parameter value or the last hou.Node object in the items list\n will be affected. If the selected menu item can affect multiple\n nodes, all nodes will be affected. And in the few cases where\n network items other than nodes may be altered by a menu item, all\n items (nodes or otherwise) will be affected.\n\n\n \"\"\"\n def openVopEffectsMenu(self, node: VopNode, input_index: int) -> None:\n \"\"\"\n\n openVopEffectsMenu(self, node, input_index)\n\n Brings up the VOP node effects menu for the hou.VopNode specified in\n the node parameter, at the input specified by the input_index\n parameter.\n\n\n \"\"\"\n def openVopOutputInfoMenu(self, node: VopNode, output_index: int) -> None:\n \"\"\"\n\n openVopOutputInfoMenu(self, node, output_index)\n\n Brings up the VOP node output info menu for the hou.VopNode\n specified in the node parameter, at the output specified by the\n output_index parameter. This menu is used to control the behavior of\n the VOP node when the Debug or Bypass flags are enabled.\n\n\n \"\"\"\n def openFloatingParameterEditor(self, node: Node) -> None:\n \"\"\"\n\n openFloatingParameterEditor(self, node)\n\n Opens a floating parameter dialog for the given node.\n\n\n \"\"\"\n def openNameEditor(self, item: NetworkMovableItem, select_all: bool = False) -> int:\n \"\"\"\n\n openNameEditor(self, item, select_all = False) -> int\n\n Opens an input field for editing the name of the node specified in\n the item parameter. Returns an integer id which is passed to the\n network editor as part of an event indicating when the user finishes\n editing the text.\n\n If select_all is set to True, the editor is opened with all text\n selected.\n\n\n \"\"\"\n def openCommentEditor(self, item: NetworkMovableItem, select_all: bool = False) -> int:\n \"\"\"\n\n openCommentEditor(self, item, select_all = False) -> int\n\n Opens an input field for editing the comment of the network box\n specified in the item parameter. Returns an integer id which is\n passed to the network editor as part of an event indicating when the\n user finishes editing the text.\n\n If select_all is set to True, the editor is opened with all text\n selected.\n\n\n \"\"\"\n def openNoteEditor(self, stickynote: StickyNote, select_all: bool = False) -> int:\n \"\"\"\n\n openNoteEditor(self, stickynote, select_all = False) -> int\n\n Opens an input field for editing the text of the sticky note\n specified in the stickynote parameter. Returns an integer id which\n is passed to the network editor as part of an event indicating when\n the user finishes editing the text.\n\n If select_all is set to True, the editor is opened with all text\n selected.\n\n\n \"\"\"\n def closeTextEditor(self, id: int, apply_changes: bool = True) -> None:\n \"\"\"\n\n closeTextEditor(self, id, apply_changes = True)\n\n Immediately closes and commits any changes made to input fields\n opened with the openNameEditor(), openCommentEditor(), or\n openNoteEditor() methods. The id parameter is the value returned by\n the method that opened the editor. Set the apply_changes parameter\n to False if the changes made to the input field should not be\n applied.\n\n\n \"\"\"\n def runShelfTool(self, tool_name: str) -> None:\n \"\"\"\n\n runShelfTool(self, tool_name)\n\n Run the named shelf tool in the network editor.\n\n\n \"\"\"\n def scheduleTimerEvent(self, seconds: float) -> int:\n \"\"\"\n\n scheduleTimerEvent(self, seconds) -> int\n\n Requests that a timer event be sent to the network editor after\n seconds has elapsed. The returned integer id is included in the\n triggered event to differentiate between timers if more than one is\n scheduled at a time.\n\n\n \"\"\"\n def handleCurrentKeyboardEvent(self, resend: bool = False) -> None:\n \"\"\"\n\n handleCurrentKeyboardEvent(self, resend=False)\n\n Requests that the network editor handle the current keyboard event.\n This method only makes sense when handling a keyboard event.\n\n If the resend parameter is set to True, the keyboard event is sent\n to the network editor's python handling code a second time rather\n than the network editor handling the keyboard event itself. This is\n useful if the network editor is in a state or mode that does not\n know how to handle a key, but which the state recognizes as one that\n should exit the current state, and possibly trigger some other\n python event handling code. This parameter is used in the state for\n selecting the position of a new node if the Tab key is pressed\n (which exits the positions selection state, and triggers a new Tab\n menu instead).\n\n If this method is not called when handling a keyboard event, the\n network editor assumes that the python event handling code has\n handled the keyboard event.\n\n\n \"\"\"\n def setVolatileHotkeys(self, hotkey_symbols: Sequence[str]) -> None:\n '''\n\n setVolatileHotkeys(self, hotkey_symbols)\n\n The hotkey_symbols parameter specifies a tuple of hotkey symbols\n whose bound keys should be processed as volatile keys. This means\n they generate a \\\\\"keydown\\\\\" event when the key is pressed, and a\n \\\\\"keyup\\\\\" event when the key is released. All other keys simply send a\n \\\\\"keyhit\\\\\" event after the key is released, with no notification when\n the key is first pressed.\n\n\n '''\n def isVolatileHotkeyDown(self, hotkey_symbol: str) -> bool:\n '''\n\n isVolatileHotkeyDown(self, hotkey_symbol) -> bool\n\n Return True if a key bound to the specified hotkey symbol is\n currently pressed. This allows the current state of a volatile key\n to be tested without seeing the \\\\\"keydown\\\\\" event triggered when the\n user pressed the key. Calling this method with a hotkey symbol that\n has not been registered through the setVolatileHotkeys method will\n always return False even if a key bound to the hotkey symbol is\n currently pressed.\n\n\n '''\n def hotkeyAssignments(self, hotkey_symbols: Sequence[str]) -> Tuple[Tuple[str, ...], ...]:\n '''\n\n hotkeyAssignments(self, hotkey_symbols) -> tuple of tuple of str`\n\n Return a tuple of strings that represent the hotkeys currently\n assigned to each action associated with a tuple hotkey symbols. The\n key strings are of the form returned by the hou.ui.hotkeys method,\n which is a combination of the symbol on the key, and any modifier\n keys involved, such as \\\\\"Ctrl+Shift+G\\\\\".\n\n\n '''\n def setPref(self, pref: str, value: str) -> None:\n \"\"\"\n\n setPref(self, pref, value)\n\n Sets the preference named pref to value. The value is always a\n string, and must be converted to or from a number, enum, or other\n format as appropriate. If the preference specified by pref is a\n global preference, all network editors will automatically update\n with the new value. Otherwise the change will only affect this\n network editor.\n\n\n \"\"\"\n def getPref(self, pref: str) -> str:\n \"\"\"\n\n getPref(self, pref) -> str\n\n Return the value of the preference named pref. This preference may\n be a global or local preference. The returned value is always a\n string which can be interpreted as a number or other data structure\n as appropriate for the specific preference.\n\n\n \"\"\"\n def setPrefs(self, prefs: dict[str, str]) -> None:\n \"\"\"\n\n setPrefs(self, prefs)\n\n Sets a number of preference values with a single method call. The\n prefs parameter must be a python dictionary mapping preference name\n strings to value strings. The preferences may be local or global,\n but this method is most often used for saving and loading the local\n preferences for a single network editor.\n\n\n \"\"\"\n def getPrefs(self) -> dict[str, str]:\n \"\"\"\n\n getPrefs(self) -> dict of str to str\n\n Return all global and local preferences for this network editor as a\n python dictionary mapping preference name strings to value strings.\n\n\n \"\"\"\n def registerPref(self, pref: str, value: str, _global: bool) -> None:\n \"\"\"\n\n registerPref(self, pref, value, global)\n\n Registers a preference with the name pref, and default value value.\n If global is True, this preference is treated as a global preference\n that is applied to all network editors and saved in\n $HOUDINI_USER_PREF_DIR/networkeditor.pref. Otherwise the preference\n is considered local to each network editor, and will be saved to the\n desk file with each network editor instance.\n\n Registering a preference is required to ensure the preference is\n saved when it is not a preference used internally by the network\n editor. The preference that enables snapping, or the one to enable\n dropping a node onto an existing wire are examples of preferences\n that are only used by the python event handling code, and so must be\n explicitly registered. This registration should be done in response\n to the network editor initialization event which is sent once to\n each network editor when it is first created.\n\n\n \"\"\"\n def badges(self) -> Tuple[Tuple[str, ...], ...]:\n \"\"\"\n\n badges(self) -> tuple of tuple of str\n\n Return descriptions of the optional node badges that can be shown in\n the network editor. Each tuple contained in the returned value\n contains three strings describing the badge. The first is the\n preference value that controls whether the badge is hidden, or\n appears as a small or large icon. The second string is a description\n of the badge. The third string is the name of the badge icon. These\n values can be used to present an interface for configuring the\n badges.\n\n\n \"\"\"\n def textBadges(self) -> Tuple[Tuple[str, ...], ...]:\n \"\"\"\n\n textBadges(self) -> tuple of tuple of str\n\n Return descriptions of the optional node text that can be shown in\n the network editor. Each tuple contained in the returned value\n contains three strings describing the text. The first is the\n preference value that controls whether the text is hidden, or\n appears as truncated or full text. The second string is a\n description of the text. The third string is the name of an icon\n that can be used to represent the meaning of the text. These values\n can be used to present an interface for configuring the text.\n\n\n \"\"\"\n def nodeShapes(self) -> Tuple[str, ...]:\n \"\"\"\n\n nodeShapes(self) -> tuple of str\n\n Return a list of all valid node shape names. These are the values\n that can be set into the user data of a node to control the shape of\n a specific node. They are also the shape names that can be used as\n defaults for node types.\n\n This code sets a node to a random shape:\n\n > >>> import random\n > >>> editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > >>> shapes = editor.nodeShapes()\n > >>> hou.node('/obj/geo1').setUserData('nodeshape', random.choice(shapes))\n\n \"\"\"\n def reloadNodeShapes(self) -> Tuple[str, ...]:\n \"\"\"\n\n reloadNodeShapes(self) -> tuple of str\n\n Forces all node shape files to be reloaded. This may cause new\n shapes to become available, or existing shapes to be removed.\n Returns a tuple of strings that indicate the name of each loaded\n node shape, and any error messages generated while parsing each\n shape. Use nodeShapes() to get a simple list of all successfully\n loaded shapes after calling this method.\n\n\n \"\"\"\n def redraw(self) -> None:\n \"\"\"\n\n redraw(self)\n\n Forces the network editor to redraw. This may be necessary in cases\n where your code updates aspects of your Houdini session which\n indirectly affect the drawing of the network editor (such as\n changing default node shapes and colors). Direct changes to the\n network (such as changing the shape or color of a specific node)\n should automatically cause the network editor to redraw. Only use\n this function when you see that a redraw is not being triggered\n automatically by the your code.\n\n\n \"\"\"\n def setDragSourceData(self, items: Sequence[NetworkMovableItem]) -> None:\n \"\"\"\n\n setDragSourceData(self, items)\n\n Controls the network items that are put into the drag and drop\n buffer. The values in this buffer are only used when dragging items\n out of the network editor (such as when the user drags a node from\n the network editor onto a textport, or a parameter dialog.\n\n\n \"\"\"\n def setDragSourceWorkItem(self, item_id: int) -> None:\n \"\"\"\n\n setDragSourceWorkItem(self, work_item_id)\n\n Controls the Id of the pdg.WorkItem that is stored into the drag and\n drop buffer. The work item ID in the buffer is used when when\n dragging an item from a TOP node into a textport, Python shell, etc.\n\n\n \"\"\"\n def popEventContext(self) -> None: ...\n def parmScrollPosition(self) -> Vector2:\n \"\"\"\n\n parmScrollPosition(self) -> hou.Vector2\n\n Return the Parameter Editor scroll bars position as percentages.\n\n\n \"\"\"\n def setParmScrollPosition(self, position: Vector2) -> None:\n \"\"\"\n\n setParmScrollPosition(self,pos)\n\n Set Parameter Editor scroll bars position as hou.Vector2\n percentages.\n\n\n \"\"\"\n def setParmFilterEnabled(self, on: bool, keyboard_lock: bool = False) -> None:\n \"\"\"\n\n setParmFilterEnabled(self,on,keyboard_lock)\n\n Enable Parameter Editor filtering. If keyboard_lock is True and on\n is True, the filter field will be selected allowing you to use the\n keyboard right away. keyboard_lock is False by default.\n hou.parmFilterCriteria.\n\n\n \"\"\"\n def parmFilterEnabled(self) -> bool:\n \"\"\"\n\n parmFilterEnabled(self) -> bool\n\n Return True if Parameter Editor filtering is enabled.\n\n\n \"\"\"\n def setParmFilterExactMatch(self, on: bool) -> None:\n \"\"\"\n\n setParmFilterExactMatch(self,on)\n\n Set Parameter Editor filtering to use exact pattern matching.\n\n\n \"\"\"\n def parmFilterExactMatch(self) -> bool:\n \"\"\"\n\n parmFilterExactMatch(self) -> bool\n\n Return True if Parameter Editor filtering uses exact pattern\n matching.\n\n\n \"\"\"\n def setParmFilterPattern(self, filter: str) -> None:\n \"\"\"\n\n setParmFilterPattern(self,pattern)\n\n Set the Parameter Editor filter pattern. The filter pattern is\n applied on a hou.parmFilterCriteria string from parameters that\n match the hou.parmFilterMode. The pattern matching can use exact\n name matching or find the pattern within the string. The filter\n pattern can be a list of pattern separated by commas and can also\n contain wildcard * character.\n\n\n \"\"\"\n def parmFilterPattern(self) -> str:\n \"\"\"\n\n parmFilterPattern(self) -> str\n\n Return the Parameter Editor filter pattern.\n\n\n \"\"\"\n def setParmFilterMode(self, mode: EnumValue) -> None:\n \"\"\"\n\n setParmFilterMode(self,mode)\n\n Set the Parameter Editor filter mode. The hou.parmFilterMode defines\n on which parameters to apply the filter pattern.\n\n\n \"\"\"\n def parmFilterMode(self) -> EnumValue:\n \"\"\"\n\n parmFilterMode(self) -> hou.parmFilterMode\n\n Return the Parameter Editor hou.parmFilterMode.\n\n\n \"\"\"\n def setParmFilterCriteria(self, mode: EnumValue) -> None:\n \"\"\"\n\n setParmFilterCriteria(self,criteria)\n\n Set the Parameter Editor filter criteria. The hou.parmFilterCriteria\n defines how the filter pattern is applied to parameters.\n\n\n \"\"\"\n def parmFilterCriteria(self) -> EnumValue:\n \"\"\"\n\n parmFilterCriteria(self) -> hou.parmFilterCriteria\n\n Return the Parameter Editor hou.parmFilterCriteria.\n\n\n \"\"\"\n def setMultiParmTab(self, parm: str, index: int) -> None:\n \"\"\"\n\n setMultiParmTab(self,parm, tab_index)\n\n Switch a Multi Parameter Tab to a given tab using a parameter name.\n\n\n \"\"\"\n def multiParmTab(self, parm: str) -> int:\n \"\"\"\n\n multiParmTab(self,parm) -> int\n\n Returns the currently visible tab index using a parameter name.\n\n\n \"\"\"\n def pushEventContext(self, module: str, data: Any) -> bool:\n \"\"\"\n\n eventContextData(self) -> dict\n\n Accesses the context data passed into the most recent call to the\n hou.NetworkEditor.pushEventContext method. If no calls have been\n made to this method, there is still a python dict available to store\n any global information that may be used by the network editor event\n handling code. As an example, the current view bounds for each\n network visited by the editor are stored as part of this context\n data dictionary.\n\n\n \"\"\"\n def eventContextData(self) -> Any: ...\n\nclass NetworkAnimValue:\n \"\"\"\n\n hou.NetworkAnimValue\n\n A value to adjust the appearance of a network editor without changing\n the underlying node data.\n\n The hou.NetworkEditor pane allows network items to be moved or resized\n by user interactions without actually changing the node positions or\n sizes. This is accomplished by associating each NetworkAnimValue with a\n network item through the hou.NetworkEditor.setAdjustments method.\n NetworkAnimValues can either represent a single value, or they can\n represent an animation from one value to another. The actual animation\n is displayed automatically by the network editor.\n\n For example, to following code would animate the position of a couple of\n nodes:\n\n > >>> editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > >>> n1 = hou.node('/obj/geo1')\n > >>> pos1 = n1.position()\n > >>> newpos1 = pos1 + hou.Vector2(5, 5)\n > >>> anim1 = hou.NetworkAnimValue(1.0, pos1, newpos1)\n > >>> n2 = hou.node('/obj/geo2')\n > >>> pos2 = n2.position()\n > >>> newpos2 = pos2 + hou.Vector2(5, 5)\n > >>> anim2 = hou.NetworkAnimValue(1.0, pos2, newpos2)\n > >>> editor.setAdjustments([n1, n2], [anim1, anim2], auto_remove=True)\n > >>> n1.setPosition(newpos1)\n > >>> n2.setPosition(newpos2)\n\n Note that the new positions are set on the nodes immediately. But the\n animation starts them at their original positions, and makes it look\n like they move slowly to their new positions. Also note that the\n auto_remove parameter in the call to setAdjustments() has been set to\n True. This is because we are using the adjustments only to animate the\n nodes to their new positions, which have already been set. Once the\n animation is complete, the adjustments can be thrown away. Without this\n parameter, the adjustments would remain on the network editor until the\n next call the setAdjustments.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, duration: float|Vector2|Vector3|Vector4|NetworkAnimValue, value_start: float|Vector2|Vector3|Vector4 = ..., value_end: float|Vector2|Vector3|Vector4 = ...) -> None:\n \"\"\"\n\n __init__(self, duration, value_start, value_end)\n\n Construct a new adjustment value that does change over time. The\n value can be a float, hou.Vector2, hou.Vector3, or hou.Vector4. To\n animate a node or other item's position, use a hou.Vector2 value. To\n animate a size and position (such as for a hou.NetworkBox) use a\n hou.Vector4, where the values within the vector are\n hou.Vector4(x_position, y_position, width, height).\n\n The duration value is expressed in the number of seconds to get from\n the value_start to value_end. The values are interpolated linearly\n over time. The values provided are absolute values, not offsets.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n\nclass NetworkFootprint:\n \"\"\"\n\n hou.NetworkFootprint\n\n Describes the conditions under which a footprint ring should be\n displayed for a node in a network editor pane.\n\n A footprint in the network editor is a ring drawn behind the node in the\n network editor, such as the blue display flag ring around the wave1 node\n and the orange output flag ring around the wave2 node:\n\n\n This class describes to the network editor which nodes should be drawn\n with a footprint, and the color and position of that footprint. A tuple\n of these objects is passed to the hou.NetworkEditor.setFootprints\n method. This tuple should be updated every time the current network\n changes to a new node type category.\n\n The default footprint setup for SOP nodes is the following:\n\n > >>> editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > >>> editor.setFootprints([\n > hou.NetworkFootprint(\n > hou.nodeFlag.Display,\n > hou.ui.colorFromName('GraphDisplayHighlight'), 1, True\n > ),\n > hou.NetworkFootprint(\n > hou.nodeFlag.Render,\n > hou.ui.colorFromName('GraphRenderHighlight'), 0, True\n > ),\n > hou.NetworkFootprint(\n > hou.nodeFlag.Template,\n > hou.ui.colorFromName('GraphTemplateHighlight'), 2, True\n > ),\n > hou.NetworkFootprint(\n > hou.nodeFlag.Footprint,\n > hou.ui.colorFromName('GraphTemplateHighlight'), 2, True\n > ),\n > hou.NetworkFootprint(\n > 'output',\n > hou.ui.colorFromName('GraphOutputHighlight'), 1, True\n > )\n > ])\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, condition: EnumValue|str, color: Color, ring: int, use_minimum_size: bool) -> None:\n \"\"\"\n\n __init__(self, condition, color, ring, use_minimum_size)\n\n Construct a new footprint descriptor.\n\n\n condition\n Can be a hou.nodeFlag enum value, in which case any node with\n this flag set will be drawn with a footprint. Alternatively, a\n hou.nodeFootprint enum value, indicating an embedded network\n editor behavior that can be enabled to support the footprinting\n of node(s) according to a hard-coded rule set. Finally, a string\n value indicates a node type name, in which case any node of this\n type will be drawn with a footprint.\n\n color\n The color used to draw the ring expressed as a hou.Color.\n\n ring\n An integer value from 0 to 4 indicating which ring is being\n described. Ring 0 is a circle that extends from the center of\n the node. Each subsequent ring is thinner and further from the\n center of the node.\n\n use_minimum_size\n A boolean value. Set to True to indicate that the footprint\n should maintain a minimum visual size regardless of the network\n zoom level. Set to False if the footprint should scale with the\n network zoom level, even if that means the footprint becomes\n very small.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NetworkImage:\n \"\"\"\n\n hou.NetworkImage\n\n Describes a background image that can be displayed in a network editor\n pane.\n\n The network editor pane can display any number of images in the\n background behind the nodes of the network. These background images are\n described using this class, and set in the network editor using the\n hou.NetworkEditor.setBackgroundImages method.\n\n This code sets a single background image in the network editor:\n\n > \n > editor = hou.ui.paneTabOfType(hou.paneTabType.NetworkEditor)\n > image = hou.NetworkImage()\n > image.setPath('$HFS/houdini/pic/Mandril.pic')\n > image.setRect(hou.BoundingRect(0, 0, 5, 5))\n > editor.setBackgroundImages([image])\n\n The network editor pane provides a mode for creating and editing\n background images directly in the pane. The resulting image layout is\n saved into the user data for the current network so that the image\n arrangement is automatically saved and restored with the hip file.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, path: str, rect: BoundingRect) -> None:\n \"\"\"\n\n __init__(self, path, rect)\n\n Construct a new image descriptor. The path parameter is a string\n containing the path to the image file. The rect parameter is a\n hou.BoundingRect that specifies the location and size for drawing\n the image in the network.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def setPath(self, path: str) -> None:\n \"\"\"\n\n setPath(self, path)\n\n Sets the path to the image file.\n\n\n \"\"\"\n def path(self) -> str:\n \"\"\"\n\n path(self) -> str\n\n Return the path to the image file.\n\n\n \"\"\"\n def setRelativeToPath(self, path: str) -> None:\n \"\"\"\n\n setRelativeToPath(self, path)\n\n Images can be tied to network items such as nodes, network boxes, or\n sticky notes. This method sets the path to the network item to which\n this image is tied. Passing in an empty string indicates the\n location is not relative to any network item.\n\n\n \"\"\"\n def relativeToPath(self) -> str:\n \"\"\"\n\n relativeToPath(self) -> str\n\n Images can be tied to network items such as nodes, network boxes, or\n sticky notes. This method returns the path to the network item to\n which this image is tied (or an empty string if its location is not\n relative to any network item).\n\n\n \"\"\"\n def setRect(self, rect: BoundingRect) -> None:\n \"\"\"\n\n setRect(self, rect)\n\n Sets the bounding rectangle that defines the size and position of\n the image within the network. If the relativeToPath() value is set,\n then the rectangle will be translated by the position of the network\n item to which this image is tied.\n\n\n \"\"\"\n def rect(self) -> BoundingRect:\n \"\"\"\n\n rect(self) -> hou.BoundingRect\n\n Returns the bounding rectangle that defines the size and position of\n the image within the network. If the relativeToPath() value is set,\n then the rectangle is translated by the position of the network item\n to which this image is tied.\n\n\n \"\"\"\n def setBrightness(self, brightness: float) -> None:\n \"\"\"\n\n setBrightness(self, brightness)\n\n Sets the brightness adjustment for displaying this image in the\n network editor. This value should range from 0 to 1. Values less\n than 1 cause the image to be blended with the background of the\n network editor. An image with a brightness of 0 will appear as the\n background color, not black as is normally indicated by a brightness\n value of 0.\n\n\n \"\"\"\n def brightness(self) -> float:\n \"\"\"\n\n brightness(self) -> float\n\n Return the brightness adjustment for displaying this image in the\n network editor. This value should range from 0 to 1. Values less\n than 1 cause the image to be blended with the background of the\n network editor. An image with a brightness of 0 will appear as the\n background color, not black as is normally indicated by a brightness\n value of 0.\n\n\n \"\"\"\n\nclass NetworkShape:\n \"\"\"\n\n hou.NetworkShape\n\n The base class for extra shapes that can be drawn into a network editor.\n\n The network editor pane can be instructed to draw additional shapes to\n either the main canvas, or to the overlay area of the pane (drawn on top\n of the actual network). Each element that is drawn is described as a\n subclass of this NetworkShape base class, then passed to the network\n editor through either the hou.NetworkEditor.setShapes or\n hou.NetworkEditor.setOverlayShapes methods.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n\nclass NetworkShapeLine(NetworkShape):\n \"\"\"\n\n hou.NetworkShapeLine\n\n Describes a line that can be drawn into a network editor.\n\n This subclass of hou.NetworkShape describes a line that can be drawn\n into a network editor pane.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, start: Vector2, end: Vector2, color: Color = ..., alpha: float = ..., width: float = ..., screen_space: bool = ..., smooth: bool = ..., dashed: bool = ...) -> None:\n \"\"\"\n\n __init__(self, start, end, color = hou.Color((1.0, 1.0, 1.0)), alpha =\n 1.0, width = 1.0, screen_space = True, smooth = True, dashed = False)\n\n Constructs a new line descriptor.\n\n\n start\n A hou.Vector2 indicating the starting point of the line. May be\n in screen space or network units depending on the value of the\n screen_space parameter.\n\n end\n A hou.Vector2 indicating the ending point of the line. May be in\n screen space or network units depending on the value of the\n screen_space parameter.\n\n color\n The color of the line, expressed as a hou.Color.\n\n alpha\n The alpha used when drawing the line, expressed as a float value\n between 0 and 1.\n\n width\n A float value indicating the width of the line. This value is\n always expressed in pixels, regardless of the value of the\n screen_space parameter.\n\n screen_space\n A boolean value indicating whether the start and end parameters\n are expressed in screen space or network layout space. If set to\n True, the positions are expressed as pixels relative to the\n lower left corner of the pane. If False, the positions are\n expressed in network units.\n\n smooth\n A boolean value indicating whether lines should be drawn with\n smoothing turned on. Smoothing lines is a form of anti-aliasing\n which can make curved lines look better, but doing so may affect\n the color of the line.\n\n dashed\n A boolean value indicating whether lines should be drawn as a\n series of dashes rather than as solid lines.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NetworkShapeBox(NetworkShape):\n \"\"\"\n\n hou.NetworkShapeBox\n\n Describes a rectangular area that can be drawn into a network editor.\n\n This subclass of hou.NetworkShape describes a rectangle that can be\n drawn into a network editor pane.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, rect: BoundingRect, color: Color = ..., alpha: float = ..., fill: bool = ..., screen_space: bool = ..., smooth: bool = ...) -> None:\n \"\"\"\n\n __init__(self, rect, color = hou.Color((1.0, 1.0, 1.0)), alpha = 1.0,\n fill = True, screen_space = True, smooth = True)\n\n Constructs a new box shape descriptor.\n\n\n rect\n A hou.BoundingRect object which describes the size and position\n of the box. It may describe the box in screen space or in the\n network layout space, depending on the value of the screen_space\n parameter. This is the only required parameter.\n\n color\n The color of the box, expressed as a hou.Color.\n\n alpha\n The alpha used when drawing the box, expressed as a float value\n between 0 and 1.\n\n fill\n A boolean value indicating whether the box should be filled, or\n just drawn as an outline.\n\n screen_space\n A boolean value indicating whether the rect parameter describes\n the box size and position in screen space or network layout\n space. If set to True, the rectangle is expressed as pixels\n relative to the lower left corner of the pane. If False, the\n rectangle is expressed in network units.\n\n smooth\n A boolean value indicating whether lines should be drawn with\n smoothing turned on. Smoothing lines is a form of anti-aliasing\n which can make curved lines look better, but doing so may affect\n the color of the line. This parameter has no effect if fill is\n True.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NetworkShapeNodeShape(NetworkShape):\n \"\"\"\n\n hou.NetworkShapeNodeShape\n\n Describes a node shape that can be drawn into a network editor.\n\n This subclass of hou.NetworkShape describes a node shape that can be\n drawn into a network editor pane. This can draw any of the node shapes\n available to the nodes in the network through the Shape Palette.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, rect: BoundingRect, shape: str, color: Color = ..., alpha: float = ..., fill: bool = ..., screen_space: bool = ..., smooth: bool = ...) -> None:\n \"\"\"\n\n __init__(self, rect, shape, color = hou.Color((1.0, 1.0, 1.0)), alpha =\n 1.0, fill = True, screen_space = True, smooth = True)\n\n Constructs a new node shape descriptor.\n\n\n rect\n A hou.BoundingRect object which describes the size and position\n of the box. It may describe the box in screen space or in the\n network layout space, depending on the value of the screen_space\n parameter. This is the only required parameter.\n\n shape\n A string holding the name of the node shape to draw. The list of\n available node shapes can be retrieved with the\n hou.NetworkEditor.nodeShapes method.\n\n color\n The color of the node shape, expressed as a hou.Color.\n\n alpha\n The alpha used when drawing the node shape, expressed as a float\n value between 0 and 1.\n\n fill\n A boolean value indicating whether the node shape should be\n filled, or just drawn as an outline.\n\n screen_space\n A boolean value indicating whether the rect parameter describes\n the node shape size and position in screen space or network\n layout space. If set to True, the bounds are expressed as pixels\n relative to the lower left corner of the pane. If False, the\n bounds are expressed in network units.\n\n smooth\n A boolean value indicating whether lines should be drawn with\n smoothing turned on. Smoothing lines is a form of anti-aliasing\n which can make curved lines look better, but doing so may affect\n the color of the line. This parameter has no effect if fill is\n True.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass NetworkShapeConnection(NetworkShape):\n \"\"\"\n\n hou.NetworkShapeConnection\n\n Describes a wire that can be drawn into a network editor.\n\n This subclass of hou.NetworkShape describes a wire that can be drawn\n into a network editor pane. This wire is drawn using the same wire style\n set on the current network.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, input_pos: Vector2, input_dir: Vector2, output_pos: Vector2, output_dir: Vector2, color: Color = ..., alpha: float = ..., fade_factor: float = ..., smooth: bool = ..., dashed: bool = ...) -> None:\n \"\"\"\n\n __init__(self, input_pos, input_dir, output_pos, output_dir, color =\n hou.Color((1.0, 1.0, 1.0)), alpha = 1.0, fade_factor = 0.0, smooth =\n True, dashed = False)\n\n Constructs a new connection descriptor. This is different from a\n hou.NetworkShapeLine because it is drawn using the same algorithm as\n a wire connecting two nodes, rather than always using a straight\n line.\n\n\n input_pos\n A hou.Vector2 indicating the starting point of the connection,\n expressed in network coordinates.\n\n input_dir\n A hou.Vector2 expressing the starting direction of the wire.\n\n output_pos\n A hou.Vector2 indicating the end point of the connection,\n expressed in network coordinates.\n\n output_dir\n A hou.Vector2 expressing the ending direction of the wire.\n\n color\n The color of the connection, expressed as a hou.Color.\n\n alpha\n The alpha used when drawing the connection, expressed as a float\n value between 0 and 1.\n\n fade_factor\n A float value indicating the amount of fading that should be\n applied to this connection if it exceeds the fade length. By\n setting this value to 0.0, all fading logic is disabled.\n\n smooth\n A boolean value indicating whether lines should be drawn with\n smoothing turned on. Smoothing lines is a form of anti-aliasing\n which can make curved lines look better, but doing so may affect\n the color of the line.\n\n dashed\n A boolean value indicating whether lines should be drawn as a\n series of dashes rather than as solid lines.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n\nclass Bundle:\n '''\n\n hou.NodeBundle\n\n A named set of nodes whose contents can be from different networks. A\n bundle\\'s contents may be fixed or may be determined from a pattern, and\n the contents may be filtered by node type.\n\n Unlike node groups, the nodes in a bundle may be from different node\n networks. For example, the same bundle may contain /obj/geo1 and\n /obj/subnet1/geo2. Node groups are primarily used to organize and\n display very large networks, while node bundles are normally used to\n track which objects are lit by a light, which objects are visible in a\n scene, etc.\n\n There are two types of node bundles: regular and smart. You can add and\n remove individual nodes to and from a regular bundle. The nodes in a\n smart bundle, on the other hand, are determined from a pattern stored in\n the bundle. As nodes matching the pattern are created or deleted in\n Houdini, the contents of the bundle will update automatically. You can\n use hou.NodeBundle.pattern to determine if the bundle is a smart bundle\n or a regular one.\n\n When a node matches the pattern in a smart bundle, that node and its\n children will be added to the bundle. For example, if the pattern in\n \\\\\"/obj/*\\\\\" and /obj/box_object1 is a geometry object, all the nodes inside\n /obj/box_object1 will be added to the bundle, recursively. Carets (^) in\n the pattern can be used to remove nodes; for example, \\\\\"/obj/*\n ^/obj/geo1\\\\\" will match everything in /obj except for /obj/geo1.\n\n A bundle may also have a filter to specify what types of nodes may be in\n the bundle. See hou.nodeTypeFilter for the possible filters. If you try\n to add a node to a regular bundle but the node does not match the\n filter, Houdini will fail to add the node. For smart bundles, the filter\n is applied after doing any pattern matching. For example, if the pattern\n is \\\\\"/obj/*\\\\\" and the filter is hou.nodeTypeFilter.Obj, the bundle will\n contain only the objects in /obj, without any SOPs, etc. inside them.\n Because the pattern is applied recursively, however, any objects inside\n object subnets will also be in the bundle.\n\n To specify a bundle in a node parameter that expects a list of nodes,\n prefix the bundle name with @. For example, you can enter @bundle1 in\n the light mask parameter of an object so it is lit by the nodes inside\n the bundle named bundle1.\n\n You can view and edit node bundles in Houdini\\'s Bundle List pane. Use\n hou.nodeBundle_ and hou.nodeBundles to access existing node bundles, and\n hou.addNodeBundle to create a new bundle.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def destroy(self) -> None:\n \"\"\"\n\n destroy(self)\n\n Remove this bundle.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the name of the bundle.\n\n\n \"\"\"\n def setName(self, name: str) -> None:\n \"\"\"\n\n setName(self, name)\n\n Change the name of the bundle.\n\n Raises hou.OperationFailed if the name contains non-alphanumeric\n characters other than _, or if a bundle with that name already\n exists.\n\n\n \"\"\"\n def findBestFilter(self) -> EnumValue:\n \"\"\"\n\n findBestFilter(self) -> hou.nodeTypeFilter enum value\n\n Return the most restrictive bundle filter that matches all the nodes\n in the bundle.\n\n See hou.nodeTypeFilter for the possible filters.\n hou.nodeTypeFilter.NoFilter is a special value to indicate that\n there is no filtering.\n\n\n \"\"\"\n def filter(self) -> EnumValue:\n \"\"\"\n\n filter(self) -> hou.nodeTypeFilter enum value\n\n Return the bundle's filter. For smart bundles, the filter is applied\n after matching nodes to the pattern, and nodes whose types do not\n match the filter are removed from the bundle.\n\n See hou.nodeTypeFilter for the possible filters.\n hou.nodeTypeFilter.NoFilter is a special value to indicate that\n there is no filtering.\n\n See the class documentation for more information about filtering.\n\n\n \"\"\"\n def setFilter(self, filter: EnumValue) -> None:\n \"\"\"\n\n setFilter(self, node_type_filter)\n\n Set this bundle's filter to a hou.nodeTypeFilter enumerated value.\n Use hou.nodeTypeFilter.NoFilter to clear the filter.\n\n See hou.NodeBundle.filter and the class documentation for more\n information.\n\n\n \"\"\"\n def pattern(self) -> str | None:\n '''\n\n pattern(self) -> str or None\n\n Return None if this bundle is a regular bundle, or a string pattern\n if the bundle is a smart bundle.\n\n See the class documentation for more information on smart bundles.\n Note that if a node matches the pattern, all its subchildren will be\n in the bundle, as long as they match the filter. For example, if the\n pattern is \\\\\"/obj/*\\\\\" and the filter is hou.nodeTypeFilter.NoFilter,\n the bundle will contain all nodes under /obj, recursively.\n\n\n '''\n def setPattern(self, pattern_or_none: str) -> None:\n \"\"\"\n\n setPattern(self, pattern_or_none)\n\n Change the pattern of this bundle.\n\n Setting the pattern to None changes the bundle into a regular\n bundle. In this case, the bundle's contents are unchanged, but\n Houdini will no longer do pattern matching to determine the bundle's\n contents.\n\n If the pattern is a string, the bundle becomes a smart bundle and\n its contents immediately change to match the pattern. The bundle's\n contents will update as nodes are created and deleted in Houdini.\n\n See hou.NodeBundle.pattern and the class documentation for more\n information.\n\n\n \"\"\"\n def nodes(self) -> Tuple[Node, ...]:\n \"\"\"\n\n nodes(self) -> tuple of hou.OpNode\n\n Return a tuple of the nodes in this bundle.\n\n\n \"\"\"\n def containsNode(self, node: Node) -> bool:\n \"\"\"\n\n containsNode(self, node) -> bool\n\n Return True if the node is in the bundle and False otherwise. node\n must be a hou.OpNode object.\n\n This method is a shortcut for node in bundle.nodes(). For bundles\n with many nodes, this method will be slightly faster.\n\n\n \"\"\"\n def addNode(self, node: Node) -> None:\n \"\"\"\n\n addNode(self, node)\n\n Add a node to the bundle.\n\n Raises hou.OperationFailed if this bundle is a smart bundle, since\n the contents of smart bundles are automatically determined by their\n pattern.\n\n\n \"\"\"\n def removeNode(self, base_node: Node) -> None:\n \"\"\"\n\n removeNode(self, node)\n\n Remove a node from the bundle.\n\n Raises hou.OperationFailed if this bundle is a smart bundle, since\n the contents of smart bundles are automatically determined by their\n pattern.\n\n\n \"\"\"\n def clear(self) -> None:\n \"\"\"\n\n clear(self)\n\n Remove all nodes from the bundle.\n\n Raises hou.OperationFailed if this bundle is a smart bundle, since\n the contents of smart bundles are automatically determined by their\n pattern.\n\n\n \"\"\"\n def isSelected(self) -> bool:\n \"\"\"\n\n isSelected(self) -> bool\n\n Return True if the bundle is selected in the bundle list pane and\n False otherwise.\n\n\n \"\"\"\n def setSelected(self, on: bool, clear_all_selected: bool = False) -> None:\n \"\"\"\n\n setSelected(self, on, clear_all_selected=false)\n\n Select this bundle in the bundle list pane. If clear_all_selected is\n True, only this bundle will remain selected. Otherwise, this bundle\n will be added to the existing selection.\n\n\n \"\"\"\n def convertToNormalBundle(self) -> None:\n \"\"\"\n\n convertToNormalBundle(self)\n\n Convert the bundle into a normal bundle. The smart bundle pattern is\n removed.\n\n Do nothing if the bundle is already a normal bundle.\n\n\n \"\"\"\n def convertToSmartBundle(self) -> None:\n \"\"\"\n\n convertToSmartBundle(self)\n\n Convert the bundle into a smart bundle. A regular expression is\n constructed from the contents of the bundle and then set as the\n bundle pattern.\n\n Do nothing if the bundle is already a smart bundle.\n\n\n \"\"\"\n\nclass NodeConnection(NetworkItem):\n \"\"\"\n\n hou.NodeConnection\n\n Represents a connection (wire) between two Nodes.\n\n OVERVIEW\n\n You can get a list of NodeConnection objects from a hou.Node\n instance using hou.Node.inputConnections and\n hou.Node.outputConnections.\n\n\n NOTE\n It is probably easier to use the hou.Node.inputs and\n hou.Node.outputs methods (which return the endpoints of a node's\n connections) to traverse the network, rather than dealing with\n the connections themselves.\n\n This object is read-only. To create or edit connections, use methods\n on the node, such as hou.Node.setNamedInput, hou.Node.setInput,\n hou.Node.setFirstInput, hou.Node.setNextInput,\n hou.Node.createInputNode, and hou.Node.createOutputNode.\n\n INPUT AND OUTPUT MEANING\n\n The hou.NodeConnection.outputNode and hou.NodeConnection.inputNode\n are named in relation to the input and output ends of the connector.\n So, outputNode() returns the node at the output end of this\n connection, in relation to the flow of data through the network.\n inputNode() returns the node that provides data to the output node.\n\n For the other methods on this object, if the method name starts with\n input, it is referring to data on the inputNode(). If the method\n name starts with output, it is referring to data from the\n outputNode(). There is one exception to this: inputIndex() refers to\n the input number on the outputNode(), and outputIndex() refers to\n the output number of the inputNode().\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def outputNode(self) -> Optional[Node]:\n \"\"\"\n\n outputNode(self) -> hou.Node\n\n Return the node on the output side of this connection. This is the\n node that the connection goes to, in the direction of data flow. If\n this connection has a network dot as its output, this method returns\n None.\n\n\n \"\"\"\n def inputIndex(self) -> int:\n \"\"\"\n\n inputIndex(self) -> int\n\n Returns the index of the input connection on the node that the\n output side of this connections connects to.\n\n\n \"\"\"\n def outputItem(self) -> NetworkMovableItem:\n \"\"\"\n\n outputItem(self) -> hou.NetworkMovableItem\n\n Return the node or network dot on the output side of this\n connection. This is the node or dot that the connection goes to, in\n the direction of data flow. This method should never return None.\n\n\n \"\"\"\n def inputNode(self) -> Optional[Node]:\n \"\"\"\n\n inputNode(self) -> hou.Node\n\n Return the node on the input side of this connection. This is the\n node that the connection comes from, in the direction of data flow.\n If this connection goes through an indirect input, this will return\n the node connected to the parent node (or None if nothing is\n connected).\n\n\n \"\"\"\n def outputIndex(self) -> int:\n \"\"\"\n\n outputIndex(self) -> int\n\n Returns the index of the output connection on the node that the\n input side of this connections connects to. If this connection goes\n through an indirect input, this will return the index of the output\n connected to the parent node (or 0 if nothing is connected).\n\n\n \"\"\"\n def subnetIndirectInput(self) -> Optional[SubnetIndirectInput]:\n \"\"\"\n\n subnetIndirectInput(self) -> hou.SubnetIndirectInput\n\n If this connection has a subnet indirect input connected to it\n instead of a node, return the corresponding object. Otherwise,\n return None. See hou.SubnetIndirectInput for information on subnet\n indirect inputs.\n\n\n \"\"\"\n def inputItem(self) -> Optional[NetworkMovableItem]:\n \"\"\"\n\n inputItem(self) -> hou.NetworkMovableItem\n\n If this connection has a subnet indirect input connected to it,\n return the corresponding hou.SubnetIndirectInput object. If this\n connection has a node connected to it, return the corresponding\n hou.Node object. Otherwise, return None. This method is essentially\n equivalent to the following:\n\n > def getInputItem(node_connection):\n > if node_connection.subnetIndirectInput() is not None:\n > return node_connection.subnetIndirectInput()\n > return node_connection.inputNode()\n\n \"\"\"\n def inputItemOutputIndex(self) -> int:\n \"\"\"\n\n inputItemOutputIndex(self) -> int\n\n Returns zero if this connection has a subnet indirect input\n connected to it. Otherwise return the index of the output connection\n on the node that the input side of this connections connects to. In\n combination with the inputItem method, node and subnet indirect\n inputs can be processed through a common code path for many use\n cases.\n\n\n \"\"\"\n def isSelected(self) -> bool:\n \"\"\"\n\n isSelected(self) -> bool\n\n Return True if this connection is selected.\n\n\n \"\"\"\n def setSelected(self, selected: bool, clear_all_selected: bool = False) -> None:\n \"\"\"\n\n setSelected(self, selected, clear_all_selected = False)\n\n Selects or de-selects this connection. If the clear_all_selected\n parameter is set to True, all other selections (both connections,\n and nodes, network boxes, etc.) will be cleared before this\n connection is selected.\n\n\n \"\"\"\n def inputName(self) -> str:\n \"\"\"\n\n inputName(self) -> str\n\n Returns the name of the output connection on the node that the input\n side of this connections connects to.\n\n\n \"\"\"\n def inputLabel(self) -> str:\n \"\"\"\n\n inputLabel(self) -> str\n\n Returns the label of the output connection on the node that the\n input side of this connections connects to.\n\n\n \"\"\"\n def inputDataType(self) -> str: ...\n def outputName(self) -> str:\n \"\"\"\n\n outputName(self) -> str\n\n Returns the name of the input connection on the node that the output\n side of this connections connects to.\n\n\n \"\"\"\n def outputLabel(self) -> str:\n \"\"\"\n\n outputLabel(self) -> str\n\n Returns the label of the input connection on the node that the\n output side of this connections connects to.\n\n\n \"\"\"\n def outputDataType(self) -> str: ...\n\nclass ApexNodeConnection(NodeConnection):\n \"\"\"\n\n hou.ApexNodeConnection\n\n Represents a connection (wire) between two APEX Nodes.\n\n This class represents an APEX wire connection between two ports of the\n APEX nodes.\n\n RELATED\n\n * hou.apexNodeConnectionBySessionId\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n def sessionId(self) -> int:\n \"\"\"\n\n sessionId(self)\n\n Returns an integer value that uniquely identifies this item in a\n given Houdini session. This id is only guaranteed to be unique in a\n single Houdini process.\n\n\n \"\"\"\n\nclass OpNodeConnection(NodeConnection):\n \"\"\"\n\n hou.OpNodeConnection\n\n Represents a connection (wire) between two OP Nodes.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __hash__(self) -> int: ...\n\nclass NodeInfoTree:\n \"\"\"\n\n hou.NodeInfoTree\n\n A tree structure designed to contain information about nodes and the\n data they generate.\n\n This class represents a tree structure, where each branch of the tree\n can have any number of named sub-trees, as well as a two dimensional\n grid of strings. Most often this grid has two columns (Property and\n Value), with some number of rows to represent arbitrary key/value pairs.\n But the grid can also contain more complex data (such as the volume\n information in geometry data).\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, tree_root: Any, tree: Any) -> None:\n \"\"\"\n\n hou.NodeInfoTree\n\n A tree structure designed to contain information about nodes and the\n data they generate.\n\n This class represents a tree structure, where each branch of the tree\n can have any number of named sub-trees, as well as a two dimensional\n grid of strings. Most often this grid has two columns (Property and\n Value), with some number of rows to represent arbitrary key/value pairs.\n But the grid can also contain more complex data (such as the volume\n information in geometry data).\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns the name of this branch of the tree.\n\n\n \"\"\"\n def infoType(self) -> str:\n '''\n\n infoType(self) -> str\n\n Returns a string that can be used to describe the type of data\n stored in this tree. For example, a tree holding geometry\n information (generated either by a SOP node or a DOP node) will\n return \\\\\"Geometry\\\\\" from this method.\n\n\n '''\n def branchOrder(self) -> Tuple[str, ...]:\n \"\"\"\n\n branchOrder(self) -> tuple of str\n\n Returns the natural order of the child branches in the dictionary\n returned by branches(). This ordering is often not very important,\n but in situations where there are a large number of branches that do\n have some sort of natural order (such as the branches for each DOP\n object returned by a DOP node) this method can help organize the\n information.\n\n This code iterates through all child branches of a node's info tree\n in their natural order, assuming an RBD simulation created from a\n default sphere and torus object:\n\n > >>> nodeinfo = hou.node('/obj/AutoDopNetwork/output').infoTree()\n > >>> dopinfo = nodeinfo.branches()['DOP Info']\n > >>> objinfo = dopinfo.branches()['Objects']\n > >>> objbranches = objinfo.branches()\n > >>> for objname in objinfo.branchOrder():\n > ... obj = objbranches[objname]\n > ... print objname, ':', obj.branches()\n > ...\n > torus_object1 : {'Geometry': }\n > sphere_object1 : {'Geometry': }\n\n \"\"\"\n def branches(self) -> dict[str, NodeInfoTree]:\n \"\"\"\n\n branches(self) -> dict of str to hou.NodeInfoTree\n\n Return a dictionary of all child branches. Each branch has a name,\n and is a full tree, which may have it's own branches, and so on.\n\n\n \"\"\"\n def headings(self) -> Tuple[str, ...]:\n \"\"\"\n\n headings(self) -> tuple of str\n\n Returns the titles of the columns for the data returned by the\n rows() method. Usually this will be simply ('Property', 'Value'),\n for rows that are simply key/value pairs. But in some cases the\n headings can help interpret the returned information.\n\n\n \"\"\"\n def rows(self) -> Tuple[Tuple[str, ...], ...]:\n \"\"\"\n\n rows(self) -> tuple of tuple of str\n\n Return a two dimensional grid of strings. The returned tuple\n represents the rows of the grid. The contained tuples each represent\n one row. All contained tuples will be the same length, which will be\n the length of the tuple returned by the headings() method.\n\n\n \"\"\"\n\nclass OrboltURLHandler:\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def updateProgressBar(self, percentage: float) -> None: ...\n def closeSplashScreen(self, immediate: bool = False) -> None: ...\n\nclass OrientedBoundingBox:\n \"\"\"\n\n hou.OrientedBoundingBox\n\n An oriented 3D rectangular region.\n\n Computes an oriented bounding box for a set of points.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, oriented_bbox: OrientedBoundingBox = ...) -> None:\n \"\"\"\n\n __init__(self)\n\n Constructs an empty bounding box.\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, other: OrientedBoundingBox, tol: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, bbox, tolerance=0.00001) -> bool\n\n Returns whether this bounding box is equal to another, subject to\n numerical tolerances.\n\n\n \"\"\"\n def __hash__(self) -> int: ...\n def __mul__(self, matrix4: Matrix4) -> OrientedBoundingBox:\n \"\"\"\n\n __mul__(self, matrix4) -> OrientedBoundingBox\n\n Return a copy of this bounding box transformed by the given matrix.\n\n\n \"\"\"\n def center(self) -> Vector3:\n \"\"\"\n\n center(self) -> hou.Vector3\n\n Returns the position of the center of the bounding box.\n\n\n \"\"\"\n def rotation(self) -> Matrix3: ...\n def sizevec(self) -> Vector3:\n \"\"\"\n\n sizevec(self) -> hou.Vector3\n\n Returns a vector describing the size of the box in each of the x, y\n and z axes relative to its rotated coordinate system (that is, where\n the x axis is the first row of rotation).\n\n\n \"\"\"\n def contains(self, point: Sequence[float]) -> bool:\n \"\"\"\n\n contains(self, point) -> bool\n\n Given a sequence of 3 floats (such as a hou.Vector3) describing a\n position, return whether the position is inside the box.\n\n\n \"\"\"\n def isValid(self) -> bool:\n \"\"\"\n\n isValid(self) -> bool\n\n Returns whether this bounding box is valid.\n\n\n \"\"\"\n\nclass OrientedBoundingRect:\n \"\"\"\n\n hou.OrientedBoundingRect\n\n An oriented 2D rectangular region.\n\n Computes an oriented bounding rectangle for a set of points.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, points: typing.Iterable[Vector2]) -> None:\n \"\"\"\n\n __init__(self, points)\n\n Constructs the minimum area oriented bounding rectangle for the\n given points (a sequence of hou.Vector2).\n\n\n \"\"\"\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def isAlmostEqual(self, brect: OrientedBoundingRect, tolerance: float = 1e-05) -> bool:\n \"\"\"\n\n isAlmostEqual(self, brect, tolerance=0.00001) -> bool\n\n Returns whether this bounding rectangle is equal to another, subject\n to numerical tolerances.\n\n\n \"\"\"\n def __hash__(self) -> int: ...\n def sizevec(self) -> Vector2:\n \"\"\"\n\n sizevec(self) -> hou.Vector2\n\n Returns a vector describing the size of the box in the x and y axes.\n\n\n \"\"\"\n def center(self) -> Vector2:\n \"\"\"\n\n center(self) -> hou.Vector2\n\n Returns the position of the center of the bounding rectangle.\n\n\n \"\"\"\n def orientation(self) -> Matrix2:\n \"\"\"\n\n orientation(self) -> hou.Matrix2\n\n Returns a hou.Matrix2 that defines the orientation of the bounding\n rectangle.\n\n\n \"\"\"\n\nclass PackedFragment(PackedPrim):\n \"\"\"\n\n hou.PackedFragment\n\n A packed fragment primitive.\n\n See packed primitives for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def setEmbeddedGeometry(self, geometry: Geometry, attrib: str, name: str) -> None:\n \"\"\"\n\n setEmbeddedGeometry(self, geo, attrib, name)\n\n Embeds into this primitive all primitives from geo with the value\n name for the primitive attribute attrib. Use read-only frozen\n geometry to share geometry between multiple packed fragment\n primitives. See hou.Geometry.freeze for more information.\n\n\n \"\"\"\n\nclass PackedGeometry(PackedPrim):\n \"\"\"\n\n hou.PackedGeometry\n\n A packed geometry primitive.\n\n See packed primitives for more information.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def getEmbeddedGeometry(self) -> Geometry:\n \"\"\"\n\n getEmbeddedGeometry(self) -> hou.Geometry\n\n Returns the geometry of this primitive.\n\n\n \"\"\"\n def setEmbeddedGeometry(self, geometry: Geometry) -> None:\n \"\"\"\n\n setEmbeddedGeometry(self, geo)\n\n Embeds the provided geometry into this primitive. Use read-only\n frozen geometry to share geometry between multiple packed geometry\n primitives. See hou.Geometry.freeze for more information.\n\n\n \"\"\"\n\nclass Parm:\n \"\"\"\n\n hou.Parm\n\n A parameter in a node. Each parameter has a unique name within its node\n and exists inside a parameter tuple.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def node(self) -> OpNode:\n \"\"\"\n\n node(self) -> hou.OpNode\n\n Returns the node on which this parameter exists.\n\n\n \"\"\"\n def tuple(self) -> ParmTuple:\n \"\"\"\n\n tuple(self) -> hou.ParmTuple\n\n Returns the hou.ParmTuple associated with this parameter.\n\n For example, calling this method on the Parm object for the\n translation parameter tx, would return a ParmTuple that contains\n Parm objects for the three translation parameters tx, ty and tz. If\n no tuple is associated with the parameter, then the parameter itself\n is returned in a tuple of size 1.\n\n\n \"\"\"\n def parmTemplate(self) -> ParmTemplate:\n \"\"\"\n\n parmTemplate(self) -> hou.ParmTemplate\n\n Returns the template for this parameter.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Returns this parameter's name.\n\n\n \"\"\"\n def path(self) -> str:\n \"\"\"\n\n path(self) -> str\n\n Returns the full path to this parameter.\n\n\n \"\"\"\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Returns this parameter's label.\n\n\n \"\"\"\n def componentIndex(self) -> int:\n \"\"\"\n\n componentIndex(self) -> int\n\n Returns the component index of this parameter.\n\n For example, the translation parameter along the x-axis, tx, would\n return a component index of 0, while the translation parameter along\n the y-axis, ty would return a component index of 1.\n\n\n \"\"\"\n def menuContents(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuContents(self) -> tuple of str\n\n Returns a list of the tokens and labels for all possible menu items\n (for a menu parameter). This format is suitable for use in a\n parameter menu script. Raises hou.OperationFailed if this parameter\n is not a menu.\n\n\n \"\"\"\n def menuLabels(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuLabels(self) -> tuple of str\n\n Returns a list of labels for all possible menu items (for a menu\n parameter). Raises hou.OperationFailed if this parameter is not a\n menu.\n\n\n \"\"\"\n def menuItems(self) -> Tuple[str, ...]:\n \"\"\"\n\n menuItems(self) -> tuple of str\n\n Returns a list of all possible menu items (for a menu parameter).\n Raises hou.OperationFailed if this parameter is not a menu.\n\n\n \"\"\"\n def isDynamicMenu(self) -> bool:\n \"\"\"\n\n isDynamicMenu(self) -> bool\n\n Returns True if the parameter's menu item list is specified using\n custom logic defined in the Houdini source code. Returns False if\n the parameter's menu items are specified with a script or item list,\n or if the parameter is not a menu.\n\n\n \"\"\"\n def pressButton(self, arguments: Mapping[str, int|bool|float|str] = ...) -> None:\n \"\"\"\n\n pressButton(self, arguments={})\n\n Emulates clicking a button parameter to trigger its callback script.\n Raises hou.OperationFailed if the callback script could not be run.\n An optional dictionary of arguments can be passed to the callback\n script. Raises TypeError if a n argument value type is unsupported.\n\n\n NOTE\n This can be called on any type parameter to trigger its callback\n script, it is not limited to only button parameters.\n\n\n arguments\n An optional dictionary of arguments for the callback script. The\n dictionary is merged with the keyword values passed to the\n callback. The arguments values are single values of the\n following types: int, bool, float, str.\n\n\n \"\"\"\n def referenceExpression(self, to_base_parm: Parm, language: Optional[EnumValue] = None, follow_parm_reference: bool = True) -> str:\n \"\"\"\n\n referenceExpression(self, parm, language=None,\n follow_parm_reference=True) -> str\n\n Returns an expression string that contains a channel reference from\n this parameter to the specified parm.\n\n\n \"\"\"\n def setFromParm(self, src: Parm) -> None:\n \"\"\"\n\n setFromParm(self, src)\n\n Copies the value of an entire parameter, including channels, from\n the provided src parameter.\n\n\n \"\"\"\n def setFromParmDefaults(self, src: Parm) -> None: ...\n def overwriteDefaults(self) -> None:\n \"\"\"\n\n overwriteDefaults(self)\n\n Overwrite the default values with the current parameter tuple\n values.\n\n\n \"\"\"\n def revertToDefaults(self) -> None:\n \"\"\"\n\n revertToDefaults(self)\n\n Change the value back to the default(s). See also the\n revertToAndRestoreFactoryDefaults() method.\n\n\n \"\"\"\n def revertToAndRestorePermanentDefaults(self) -> None:\n \"\"\"\n\n revertToAndRestorePermanentDefaults(self)\n\n Changes the value back to the default that ships with Houdini, and\n restores that default.\n\n See also the revertToDefaults() method, and\n hou.ParmTuple.revertToAndRestorePermanentDefaults\n\n\n \"\"\"\n def revertToRampDefaults(self) -> None:\n \"\"\"\n\n revertToRampDefaults(self)\n\n Change the value back to the default(s), removing all the non-\n default control points from the ramp.\n\n Raises TypeError if the parameter is not a ramp.\n\n\n \"\"\"\n def hasTemporaryDefaults(self) -> bool:\n \"\"\"\n\n hasTemporaryDefaults(self) -> bool\n\n Returns whether a default has been explicitly set on the parameter.\n\n See also the revertToDefaults() and\n revertToAndRestorePermanentDefaults()methods.\n\n\n \"\"\"\n def isAtDefault(self, compare_temporary_defaults: bool = True, compare_expressions: bool = True) -> bool:\n \"\"\"\n\n isAtDefault(self, compare_temporary_defaults=True,\n compare_expressions=False) -> bool\n\n Returns whether the parameter is currently at its default.\n\n compare_temporary_defaults: When is\n True, isAtDefault also checks\n\n compare_expressions: When is True, isAtDefault\n compares the actual\n\n See also the revertToDefaults() and\n revertToAndRestorePermanentDefaults()methods.\n\n\n \"\"\"\n def isAtRampDefault(self) -> bool:\n \"\"\"\n\n isAtRampDefault(self) -> bool\n\n Returns whether the ramp parameter is currently at its default.\n\n This tests all of the multiparm parameters associated with the ramp\n by comparing to the special ramp default spare paramater data. Ramps\n with no default spare data will never be at default.\n\n\n \"\"\"\n def setExpression(self, expression: str, language: Optional[EnumValue] = None, replace_expression: bool = True) -> None:\n \"\"\"\n\n setExpression(self, expression, language=None, replace_expression=True)\n\n Sets this parameter's expression.\n\n expression: A string containing the expression that will go inside\n the parameter.\n\n language: Either a hou.exprLanguage enumeration value or None.\n\n If language is None and the parameter does not already contain an\n expression, the language will be the node's expression language.\n (See hou.OpNode.expressionLanguage.) Otherwise, if language is None\n and the parameter already has an expression, the expression language\n will not change.\n\n replace_expression: This parameter only has effect if the parameter\n already contains keyframes. If it is True, Houdini will replace the\n keyframe before the current time with one containing the new\n expression. Otherwise, it will always add a keyframe at the current\n time. Note that this behavior matches what happens when you edit an\n expression from Houdini's parameter dialog.\n\n Unlike hou.Parm.set, this method does not follow channel references.\n That is, if this parameter is referencing another parameter and you\n call setExpression(), it change the channel reference expression\n into the specified expression.\n\n If the parameter does not already contain any keyframes, this method\n is roughly equivalent to setting a keyframe at frame 1, where the\n keyframe's expression and language are the ones specified.\n\n This method can be approximately implemented as follows:\n\n > def setExpression(self, expression, language=None, replace_expression=None)\n > if self.template().type() == hou.parmTemplateType.String:\n > k = hou.StringKeyframe()\n > else:\n > k = hou.Keyframe()\n > \n > k.setExpression(expression, language)\n > \n > if len(self.keyframes()):\n > if replace_expression:\n > k.setTime(self.effectiveKeyframeAtFrame(hou.frame()).time())\n > else:\n > k.setTime(hou.time())\n > else\n > k.setTime(0.0)\n > \n > self.setKeyframe(k)\n\n See also the expression, expressionLanguage, and setKeyframe\n methods, hou.OpNode.expressionLanguage, and\n hou.OpNode.setExpressions.\n\n\n \"\"\"\n def expression(self) -> str:\n \"\"\"\n\n expression(self) -> str\n\n Returns this parameter's expression.\n\n For example, a parameter might contain the Python expression frame()\n * 2. In this case hou.Parm.eval at frame 2 would return the value 4,\n while calling expression() would return the string frame() * 2.\n\n If the parameter does not contain an expression, this method will\n raise hou.OperationFailed. Also, if the parameter contains more than\n one keyframe then it could contain multiple different expressions,\n so it also raises hou.OperationFailed in that case.\n\n This method is roughly equivalent to...\n\n > parm.keyframes()[0].expression()\n\n See also the setExpression(), expressionLanguage(), keyframes(), and\n eval() methods.\n\n\n \"\"\"\n def expressionLanguage(self) -> EnumValue:\n \"\"\"\n\n expressionLanguage(self) -> hou.exprLanguage enum value\n\n Returns the parameter's expression's language.\n\n If the parameter does not contain an expression, this method will\n raise hou.OperationFailed. Also, if the parameter contains more than\n one keyframe then it could contain multiple different expressions,\n so it also raises hou.OperationFailed in that case.\n\n To change the expression language, use hou.Parm.setExpression and\n explicitly specify the language:\n parm.setExpression(parm.expression(), language).\n\n This method is roughly equivalent to...\n\n > parm.keyframes()[0].expressionLanguage()\n\n See also the expression(), setExpression(), keyframes(), and\n setExpressionLanguage() methods.\n\n\n \"\"\"\n def rawValue(self) -> str:\n \"\"\"\n\n rawValue(self) -> str\n\n Returns the parameter's raw text value without evaluation or\n expansion. If the parameter has an expression then the expression is\n returned otherwise the parameter's plain text value is returned.\n\n\n \"\"\"\n def isShowingExpression(self) -> bool:\n \"\"\"\n\n isShowingExpression(self) -> bool\n\n Return whether this parameter is shown as an expression or as the\n\n See also the showExpression() method.\n\n\n \"\"\"\n def showExpression(self, value: bool) -> None: ...\n def setKeyframe(self, keyframe: BaseKeyframe) -> None:\n \"\"\"\n\n setKeyframe(self, keyframe)\n\n Sets a keyframe on this parameter.\n\n Raises TypeError if keyframe is not of type hou.BaseKeyframe. Raises\n hou.PermissionError if this parameter is not writable.\n\n\n \"\"\"\n def setKeyframes(self, keyframes: Sequence[BaseKeyframe]) -> None:\n \"\"\"\n\n setKeyframes(self, keyframes)\n\n Sets multiple keyframe on this parameter. Calling this method is\n more efficient than calling hou.Parm.setKeyframe several times\n because it sends out only one update event to Houdini for the entire\n batch of keyframes that are set.\n\n keyframes must be a tuple or list of hou.BaseKeyframe objects.\n\n Raises hou.PermissionError if this parameter is not writable.\n\n\n \"\"\"\n def keyframes(self) -> Tuple[BaseKeyframe, ...]:\n \"\"\"\n\n keyframes(self) -> tuple of hou.BaseKeyframe\n\n Returns the keyframes on this parameter.\n\n\n \"\"\"\n def keyframesInRange(self, start_frame: float, end_frame: float) -> Tuple[BaseKeyframe, ...]:\n \"\"\"\n\n keyframesInRange(self, start_frame, end_frame) -> tuple of\n hou.BaseKeyframe\n\n Returns a tuple of keyframes on this parameter that fall in the\n range start_frame to end_frame, inclusive. If no keyframes are found\n an empty tuple is returned.\n\n\n \"\"\"\n def keyframesBefore(self, frame: float) -> Tuple[BaseKeyframe, ...]:\n \"\"\"\n\n keyframesBefore(self, frame) -> tuple of hou.BaseKeyframe\n\n Returns a tuple of keyframes on this parameter that occur at or\n before frame. If no keyframes are found an empty tuple is returned.\n\n\n \"\"\"\n def keyframesAfter(self, frame: float) -> Tuple[BaseKeyframe, ...]: ...\n def evalAsFloat(self) -> float:\n \"\"\"\n\n evalAsFloat(self) -> float\n\n Evaluates this parameter at the current frame and returns the result\n as a float.\n\n Raises TypeError if the value cannot be converted to a float.\n\n\n \"\"\"\n def evalAsFloatAtFrame(self, frame: float) -> float:\n \"\"\"\n\n evalAsFloatAtFrame(self, frame) -> float\n\n Evaluates this parameter at a certain frame and returns the result\n as a float.\n\n Raises TypeError if the value cannot be converted to a float.\n\n\n \"\"\"\n def evalAsInt(self) -> int:\n \"\"\"\n\n evalAsInt(self) -> int\n\n Evaluates this parameter at the current frame and returns the result\n as an integer.\n\n Raises TypeError if the value cannot be converted to an integer.\n\n\n \"\"\"\n def evalAsIntAtFrame(self, frame: float) -> int:\n \"\"\"\n\n evalAsIntAtFrame(self, frame) -> int\n\n Evaluates this parameter at a certain frame and returns the result\n as an integer.\n\n Raises TypeError if the value cannot be converted to an integer.\n\n\n \"\"\"\n def evalAsString(self) -> str:\n \"\"\"\n\n evalAsString(self) -> str\n\n Evaluates this parameter at the current frame and returns the result\n as a string.\n\n If you want the string contents of the parameter before variable\n expansion and expression evaluation then call\n hou.Parm.unexpandedString.\n\n Raises TypeError if the value cannot be converted to a string.\n\n\n \"\"\"\n def evalAsStringAtFrame(self, frame: float) -> str:\n \"\"\"\n\n evalAsStringAtFrame(self, frame) -> str\n\n Evaluates this parameter at a certain frame and returns the result\n as a string.\n\n If you want the string contents of the parameter before variable\n expansion and expression evaluation then call\n hou.Parm.unexpandedString.\n\n Raises TypeError if the value cannot be converted to a string.\n\n\n \"\"\"\n def evalAsGeometry(self) -> Optional[Geometry]:\n \"\"\"\n\n evalAsGeometry(self) -> hou.Geometry\n\n Evaluates this parameter at the current frame and returns the result\n as a geometry.\n\n Raises TypeError if the parameter is not a geometry.\n\n\n \"\"\"\n def evalAsGeometryAtFrame(self, frame: float) -> Optional[Geometry]:\n \"\"\"\n\n evalAsGeometryAtFrame(self, frame) -> hou.Geometry\n\n Evaluates this parameter at a certain frame and returns the result\n as a geometry.\n\n Raises TypeError if the parameter is not a geometry.\n\n\n \"\"\"\n def evalAsImageLayer(self) -> Optional[ImageLayer]:\n \"\"\"\n\n evalAsImageLayer(self) -> hou.ImageLayer\n\n Evaluates this parameter at the current frame and returns the result\n as a layer.\n\n Raises TypeError if the parameter is not a layer.\n\n\n \"\"\"\n def evalAsImageLayerAtFrame(self, frame: float) -> Optional[ImageLayer]:\n \"\"\"\n\n evalAsImageLayerAtFrame(self, frame) -> hou.ImageLayer\n\n Evaluates this parameter at a certain frame and returns the result\n as a layer.\n\n Raises TypeError if the parameter is not a layer.\n\n\n \"\"\"\n def evalAsNanoVDB(self) -> Optional[NanoVDB]:\n \"\"\"\n\n evalAsNanoVDB(self) -> hou.NanoVDB\n\n Evaluates this parameter at the current frame and returns the result\n as a VDB.\n\n Raises TypeError if the parameter is not a VDB.\n\n\n \"\"\"\n def evalAsNanoVDBAtFrame(self, frame: float) -> Optional[NanoVDB]:\n \"\"\"\n\n evalAsNanoVDBAtFrame(self, frame) -> hou.NanoVDB\n\n Evaluates this parameter at a certain frame and returns the result\n as a VDB.\n\n Raises TypeError if the parameter is not a VDB.\n\n\n \"\"\"\n def evalAsJSONMap(self) -> dict[str, str]:\n \"\"\"\n\n evalAsJSONMap(self) -> dict of str to str\n\n Evaluates this parameter at the current frame and returns the result\n as a JSON map structure (i.e. Python dictionary).\n\n Raises TypeError or hou.OperationFailed if the parameter is not a\n JSON map data parameter.\n\n\n \"\"\"\n def evalAsJSONMapAtFrame(self, frame: float) -> dict[str, str]:\n \"\"\"\n\n evalAsJSONMapAtFrame(self, frame) -> dict of str to str\n\n Evaluates this parameter at a certain frame and returns the result\n as a JSON map structure (i.e. Python dictionary).\n\n Raises TypeError or hou.OperationFailed if the parameter is not a\n JSON map data parameter.\n\n\n \"\"\"\n def evalAsRamp(self) -> Ramp:\n \"\"\"\n\n evalAsRamp(self) -> hou.Ramp\n\n Evaluates this parameter at the current frame and returns the result\n as a ramp.\n\n Raises TypeError if the parameter is not a ramp.\n\n\n \"\"\"\n def evalAsRampAtFrame(self, frame: float) -> Ramp:\n \"\"\"\n\n evalAsRampAtFrame(self, frame) -> hou.Ramp\n\n Evaluates this parameter at a certain frame and returns the result\n as a ramp.\n\n Raises TypeError if the parameter is not a ramp.\n\n\n \"\"\"\n def evalAsNode(self) -> OpNode | None:\n \"\"\"\n\n evalAsNode(self) -> hou.OpNode\n\n Evaluates this parameter at the current frame and returns the result\n as a hou.OpNode.\n\n If the parameter resolves to multiple node paths, None will be\n returned. See evalAsNodes for this.\n\n Raises TypeError if the value cannot be converted to a hou.OpNode.\n\n\n \"\"\"\n def evalAsNodeAtFrame(self, frame: float) -> OpNode | None:\n \"\"\"\n\n evalAsNodeAtFrame(self, frame) -> hou.OpNode\n\n Evaluates this parameter at a certain frame and returns the result\n as a hou.OpNode.\n\n If the parameter resolves to multiple node paths, None will be\n returned. See evalAsNodesAtFrame for this.\n\n Raises TypeError if the value cannot be converted to a hou.OpNode.\n\n\n \"\"\"\n def evalAsNodes(self) -> Tuple[Node, ...]:\n \"\"\"\n\n evalAsNodes(self) -> tuple of hou.OpNode\n\n Evaluates this parameter at the current frame and returns the result\n as a tuple of hou.OpNode.\n\n Raises TypeError if the value cannot be converted to a hou.OpNode.\n\n\n \"\"\"\n def evalAsNodesAtFrame(self, frame: float) -> Tuple[Node, ...]:\n \"\"\"\n\n evalAsNodesAtFrame(self, frame) -> tuple of hou.OpNode\n\n Evaluates this parameter at a certain frame and returns the result\n as a tuple of hou.OpNode.\n\n Raises TypeError if the value cannot be converted to a hou.OpNode.\n\n\n \"\"\"\n def evalAsNodePath(self) -> str:\n \"\"\"\n\n evalAsNodePath(self) -> str\n\n Evaluates this parameter at the current frame and returns the result\n as an absolute node path.\n\n If the parameter resolves to multiple node paths, an empty string\n will be returned. See evalAsNodePaths for this.\n\n\n \"\"\"\n def evalAsNodePathAtFrame(self, frame: float) -> str:\n \"\"\"\n\n evalAsNodePathAtFrame(self, frame) -> str\n\n Evaluates this parameter at a certain frame and returns the result\n as an absolute node path.\n\n If the parameter resolves to multiple node paths, an empty string\n will be returned. See evalAsNodePathsAtFrame for this.\n\n\n \"\"\"\n def evalAsNodePaths(self) -> Tuple[str, ...]:\n \"\"\"\n\n evalAsNodePaths(self) -> tuple of str\n\n Evaluates this parameter at the current frame and returns the result\n as a tuple of strings where each is an absolute node path.\n\n\n \"\"\"\n def evalAsNodePathsAtFrame(self, frame: float) -> Tuple[str, ...]:\n \"\"\"\n\n evalAsNodePathsAtFrame(self, frame) -> tuple of str\n\n Evaluates this parameter at a certain frame and returns the result\n as a tuple of strings where each is an absolute node path.\n\n\n \"\"\"\n def unexpandedString(self) -> str:\n \"\"\"\n\n unexpandedString(self) -> str\n\n Returns the contents of the parameter before dollar sign and back-\n tick expansion.\n\n Examples of unexpanded strings would be image$F.pic, $HIP/split.hda,\n or chs('../font1/text'). If you were to call eval() on them, Houdini\n would perform variable expansion and back-tick expression\n evaluation, so you would get back something like image1.pic instead\n of image$F.pic.\n\n Because only string parameters will attempt to do dollar sign and\n string expansion, this method will raise hou.OperationFailed if\n called from a non-string parameter.\n\n Suppose a string parameter contains keyframes. In this situation,\n Houdini will not attempt to do string expansion on the parameter's\n value, so calling this method will raise hou.OperationFailed.\n Instead of calling this method, you can call expression() to access\n the first Keyframe's expression. If there are multiple keyframes,\n you can call keyframes() to get a list of hou.StringKeyframe objects\n and call expression() on those objects to retrieve the expression.\n\n\n \"\"\"\n def deleteKeyframeAtFrame(self, frame: float) -> None:\n \"\"\"\n\n deleteKeyframeAtFrame(self, frame)\n\n Removes a keyframe from this parameter at the given frame.\n\n This function will raise a hou.ObjectWasDeleted exception if it is\n invoked on a parameter that does not exist in Houdini.\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n This function will raise a hou.OperationFailed exception the\n parameter doesn't have a keyframe at the given frame.\n\n See also hou.Parm.deleteAllKeyframes.\n\n\n \"\"\"\n def deleteAllKeyframes(self) -> None:\n \"\"\"\n\n deleteAllKeyframes(self)\n\n Removes all keyframes from this parameter.\n\n This has no effect if there are no keyframes to delete. The value of\n the parameter after all keyframes are removed will be the one it\n evaluated to at the current frame.\n\n This function will raise a hou.ObjectWasDeleted exception if it is\n invoked on a parameter that does not exist in Houdini.\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n See also hou.Parm.deleteKeyframeAtFrame and\n hou.ParmTuple.deleteAllKeyframes.\n\n\n \"\"\"\n def getReferencedParm(self) -> Parm:\n \"\"\"\n\n getReferencedParm(self) -> hou.Parm\n\n Returns the referenced parameter. If no parameter is referenced,\n returns this parameter.\n\n\n \"\"\"\n def parmsReferencingThis(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n parmsReferencingThis(self) -> tuple of hou.Parm\n\n Return a tuple of all the parameters in the scene that have channel\n references to this parameter.\n\n\n \"\"\"\n def isLocked(self) -> bool:\n \"\"\"\n\n isLocked(self) -> bool\n\n Returns whether this parameter is locked (uneditable).\n\n\n \"\"\"\n def lock(self, on: bool) -> None:\n \"\"\"\n\n lock(self, on)\n\n Locks (lock(True)) or unlocks (lock(False)) this parameter (this is,\n makes the value uneditable).\n\n Raises hou.PermissionError if this parameter is part of a locked\n digital asset.\n\n\n \"\"\"\n def isAutoscoped(self) -> bool:\n \"\"\"\n\n isAutoscoped(self) -> bool\n\n Returns whether this parameter's autoscope property is on.\n\n\n \"\"\"\n def setAutoscope(self, on: bool) -> None:\n \"\"\"\n\n setAutoscope(self, on)\n\n Changes the autoscope property of the parameter. If this property is\n on, this parameter is automatically scoped when the object is\n selected.\n\n\n \"\"\"\n def isScoped(self) -> bool:\n \"\"\"\n\n isScoped(self) -> bool\n\n Returns whether this parameter's channel is scoped. If it is scoped,\n then it is loaded in the animation editor.\n\n\n \"\"\"\n def setScope(self, on: bool) -> None:\n \"\"\"\n\n setScope(self, on)\n\n Changes the scope property of this parameter's channel, which\n affects whether it is loaded in the animation editor.\n\n\n \"\"\"\n def isAutoSelected(self) -> bool:\n \"\"\"\n\n isAutoSelected(self) -> bool\n\n Returns whether this parameter's autoselect property is on.\n\n\n \"\"\"\n def setAutoSelect(self, on: bool) -> None:\n \"\"\"\n\n setAutoSelect(self, on)\n\n Changes the autoselect property of the parameter. If this property\n is on, this parameter defines the default selection state when it is\n displayed in the animation editor.\n\n\n \"\"\"\n def isSelected(self) -> bool:\n \"\"\"\n\n isSelected(self) -> bool\n\n Returns whether this parameter's channel is selected. If it is\n selected, then it is selected in the animation editor.\n\n\n \"\"\"\n def setSelect(self, on: bool) -> None:\n \"\"\"\n\n setSelect(self, on)\n\n Changes the select property of this parameter's channel, which\n affects whether it is selected in the animation editor.\n\n\n \"\"\"\n def alias(self) -> str:\n \"\"\"\n\n alias(self) -> str\n\n Returns the parameter's channel alias name. Returns an empty string\n if no such name exists.\n\n\n \"\"\"\n def setAlias(self, alias_name: str) -> None:\n \"\"\"\n\n setAlias(self, alias_name)\n\n Gives the parameter another name by which it can be referenced in\n channels. You can pass in an empty string to remove an existing\n alias name.\n\n\n \"\"\"\n def isSpare(self) -> bool:\n \"\"\"\n\n isSpare(self) -> bool\n\n Returns whether this parameter is a spare (user-defined) parameter.\n\n\n \"\"\"\n def isTimeDependent(self) -> bool:\n \"\"\"\n\n isTimeDependent(self) -> bool\n\n Returns whether this parameter is time dependent, that is, its value\n changes depending on the point on the timeline at which it's\n evaluated. For example the parameter has an expression containing\n the $F (current frame number) variable.\n\n\n \"\"\"\n def isMultiParmInstance(self) -> bool:\n \"\"\"\n\n isMultiParmInstance(self) -> bool\n\n Return whether this parameter is an instance of a multi parm. For\n example, the pt0x, pt1x, pt2x, etc. parameters in an add SOP are\n instances of a multiparm.\n\n\n \"\"\"\n def isMultiParmParent(self) -> bool:\n \"\"\"\n\n isMultiParmParent(self) -> bool\n\n Return whether this parameter is a parent multi parm, ie: the number\n of instances parameter.\n\n\n \"\"\"\n def parentMultiParm(self) -> Optional[Parm]:\n \"\"\"\n\n parentMultiParm(self) -> hou.Parm\n\n Return the parent multi-parameter if this parameter is a multi-\n parameter instance and None otherwise.\n\n\n \"\"\"\n def multiParmInstanceIndices(self) -> Tuple[int, ...]:\n \"\"\"\n\n multiParmInstanceIndices(self) -> tuple of int\n\n If this parameter is a multi-parameter instance, then return a tuple\n of indices of where the parameter appears in the multi-parameter\n block and any nested blocks. Indices for outer multi-parameter\n blocks are listed first.\n\n For example if this parameter appears as the fourth instance in the\n multi-parameter block then (3,) is returned.\n\n As another example if this parameter appears as the third instance\n in the multi-parameter block and the block itself appears as the\n first instance of an outer multi-parameter block then (0, 2) is\n returned.\n\n\n \"\"\"\n def multiParmInstancesPerItem(self) -> int:\n \"\"\"\n\n multiParmInstancesPerItem(self) -> int\n\n If this parameter corresponds to the number of instances for a\n multiparm, return number of parameters per instance.\n\n Returns 0 if this parameter is not for a multiparm.\n\n\n \"\"\"\n def multiParmInstancesCount(self) -> int:\n \"\"\"\n\n multiParmInstancesCount(self) -> int\n\n If this parameter corresponds to the number of instances for a\n multiparm, return number of parameters per instance.\n\n Returns 0 if this parameter is not for a multiparm.\n\n\n \"\"\"\n def multiParmStartOffset(self) -> int:\n \"\"\"\n\n multiParmStartOffset(self) -> int\n\n If this parameter corresponds to the number of instances for a\n multiparm, return the starting index used when building multi\n parameter names. The default value is 1.\n\n Returns 0 if this parameter is not for a multiparm.\n\n\n \"\"\"\n def multiParmInstances(self) -> Tuple[Parm, ...]:\n \"\"\"\n\n multiParmInstances(self) -> tuple of hou.Parm\n\n If this parameter corresponds to the number of instances for a\n multiparm, return all the parameters corresponding to all instances\n of this multiparm.\n\n Returns an empty tuple if this parameter is not for a multiparm.\n\n\n \"\"\"\n def insertMultiParmInstance(self, inst_index: int) -> None:\n \"\"\"\n\n insertMultiParmInstance(self, index)\n\n Insert a new multi parm instance before the given index. To append a\n new multi parm instance, set the index to be the current number of\n instances. The current number can be queried by calling evalAsInt on\n the this parameter.\n\n\n \"\"\"\n def removeMultiParmInstance(self, inst_index: int) -> None:\n \"\"\"\n\n removeMultiParmInstance(self, index)\n\n Removes the multi parm instance at the given index.\n\n\n \"\"\"\n def moveMultiParmInstances(self, moves: Sequence[int]) -> None:\n \"\"\"\n\n moveMultiParmInstances(self, moves)\n\n Perform a sequence of move operations on Multi Parm Instances. The\n 'moves' argument must be an array of integers containing an even\n number of entries. Entries at the odd-numbered array positions\n represent a 'from' multi parm index. Entries at the even-numbered\n array positions represent the associated 'to' multi parm index.\n\n * To move the instance at index 2 up, 'moves' should be [2,3].\n\n * To move the instance at index 2 down, 'moves' should be [2,1].\n\n * To move the instance at index 0 to position 2, 'moves' should be\n [0,2].\n\n You can move multiple parm instances in one operation:\n\n * To move the first 2 instances at index 0 and 1 up to index 1,\n 'moves' should be [0,1, 1,2].\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n This function will raise a hou.Error exception with descriptive text\n if the 'moves' argument doesn't have an even number of entries or if\n an index is invalid.\n\n\n \"\"\"\n def moveUpMultiParmInstance(self, inst_index: int) -> None:\n \"\"\"\n\n moveUpMultiParmInstance(self, index)\n\n Perform a move up operation on a Multi Parm Instance at the given\n index.\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n This function will raise a hou.Error exception if the index is\n invalid or is the last index or the only index.\n\n\n \"\"\"\n def moveDownMultiParmInstance(self, inst_index: int) -> None:\n \"\"\"\n\n moveDownMultiParmInstance(self, index)\n\n Perform a move down operation on a Multi Parm Instance at the given\n index.\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n This function will raise a hou.Error exception if the index is\n invalid or is the first index or the only index.\n\n\n \"\"\"\n def containingFolders(self) -> Tuple[str, ...]:\n \"\"\"\n\n containingFolders(self) -> tuple of str\n\n Returns a tuple of strings corresponding to the names of the folders\n containing this parameter.\n\n For example, if this parameter is in the Shading folder and the\n Shading folder is inside the Render folder, this method will return\n (Render, Shading). Note that by folder name, we mean the label used\n in the parameter dialog, not the internal parameter name.\n\n Returns an empty tuple if this parameter is not inside a folder.\n\n Note that calling this method on many parameters may be slow. For a\n faster alternative, see hou.OpNode.parmsInFolder.\n\n See also the containingFolderSetParmTuples method, and\n hou.OpNode.parmTuplesInFolder.\n\n\n \"\"\"\n def containingFolderIndices(self) -> Tuple[int, ...]:\n \"\"\"\n\n containingFolderIndices(self) -> tuple of int\n\n Return a tuple of indices corresponding to the folders containing\n this parameter. Each index refers to a folder in the corresponding\n folder set parameter.\n\n This method can be implemented as follows:\n\n > def containingFolderIndices(self):\n > return tuple(\n > list(folder_set_parm_tuple.parmTemplate().folderNames()).index(\n > folder_name)\n > for folder_set_parm_tuple, folder_name in zip(\n > parm.containingFolderSetParmTuples(), parm.containingFolders()))\n\n This example makes a parameter visible in the parameter pane by\n opening all the folders containing it.\n\n > def makeParmVisible(parm):\n > for folder_set_parm_tuple, folder_index in zip(\n > parm.containingFolderSetParmTuples(),\n > parm.containingFolderIndices()):\n > folder_set_parm_tuple[0].set(folder_index)\n\n \"\"\"\n def containingFolderSetParmTuples(self) -> Tuple[ParmTuple, ...]:\n \"\"\"\n\n containingFolderSetParmTuples(self) -> tuple of hou.ParmTuple\n\n Return a tuple of ParmTuples corresponding to the folders containing\n this parameter.\n\n For example, if this parameter is in the Shading folder and the\n Shading folder is inside the Render folder, this method will return\n a tuple containing the Render parm tuple and the Shading parm tuple.\n Any parm tuples returned will be folder sets.\n\n If this parameter is not inside a folder, an empty tuple is\n returned.\n\n See also the containingFolders() method, and\n hou.OpNode.parmsInFolder and hou.OpNode.parmTuplesInFolder.\n\n\n \"\"\"\n def asCode(self, brief: bool = False, save_values: bool = True, save_keyframes: bool = True, save_keys_in_frames: bool = False, save_flag_values: bool = True, save_aliases: bool = True, function_name: Optional[str] = None) -> str:\n '''\n\n asCode(self, brief=False, save_values=True, save_keyframes=True,\n save_keys_in_frames=False, save_flag_values=True, save_aliases=True,\n function_name=None) -> str\n\n Returns a script of Python statements that can be executed to set\n the parameter tuple\\'s values, flags and other properties. To run the\n script, use either Python\\'s exec or execfile functions.\n\n\n brief\n When is True, the output script omits commands for\n setting values and flags that are set to the factory defaults.\n The script also omits keyframe commands that set unused values,\n slopes and accelerations. The value of must be either\n True or False. save_values: When is True, asCode\n outputs commands for setting the parameter tuple\\'s values. The\n value of must be either True or False.\n\n save_keyframes\n When is True, asCode outputs commands for\n creating the parameter tuple\\'s keyframes (if any). The value of\n must be either True or False.\n\n save_keys_in_frames\n When is True, asCode outputs commands for\n setting channel and key times in samples (frames) instead of\n seconds. This parameter has no effect if is set\n to False. The value of must be either True\n or False.\n\n save_flag_values\n When is True, asCode outputs commands for\n setting the parameter tuple\\'s flag values. The value of\n must be either True or False.\n\n save_aliases\n When is True, asCode outputs commands for setting\n the parameter tuple\\'s channel aliases. The value of\n must be either True or False.\n\n function_name\n If is specified, then the output script is\n wrapped in a Python function definition with the given name.\n must be a non-zero length string consisting of\n only alphanumeric and underscore characters. Any invalid\n characters are internally converted to underscores.\n\n The wrapper function takes in a single argument which must be a\n reference to an existing node parameter tuple. For symmetry, the\n function also returns the parameter tuple reference.\n\n Here is an example of saving the output to a file and then loading\n it back into Houdini:\n\n > # Get a reference to the target parameter tuple.\n > pt = hou.parmTuple(\\\\\"/obj/geo1/t\\\\\")\n > \n > # Execute asCode and write the output script to file.\n > script = pt.asCode()\n > f = open(\\\\\"set_parm_tuple_properties.py\\\\\", \\\\\"w\\\\\")\n > f.write(script)\n > f.close()\n > \n > # Execute the script. This will set the values, flag values\n > # and other properties on /obj/geo1\\'s t parameter tuple. It will\n > # also store a reference to the t parameter tuple into a variable\n > # named \\'hou_parm_tuple\\'.\n > execfile(\\\\\"set_parm_tuple_properties.py\\\\\")\n\n Here is an example of saving the output into a function and then\n calling it in Houdini:\n\n > # Get a reference to the target parameter tuple.\n > node = hou.parmTuple(\\\\\"/obj/geo1/t\\\\\")\n > \n > # Execute asCode and write the function definition to file.\n > func = p.asCode(function_name=\\\\\"setParmTupleProperties\\\\\")\n > f = open(\\\\\"parmtuplelib.py\\\\\", \\\\\"w\\\\\")\n > f.write(func)\n > f.close()\n > \n > # Call the function definition to set the properties on another\n > # parameter tuple.\n > import parmtuplelib\n > hou_parm_tuple = parmtuplelib.setParmTupleProperties(node.parm(\\\\\"t\\\\\"))\n\n '''\n def createClip(self, parent_node: Node, name: str, create_new: bool, apply_immediately: bool, current_value_only: bool = False, create_locked: bool = False, set_value_to_default: bool = False) -> ChopNode:\n \"\"\"\n\n createClip(self, parent_node, name, create_new, apply_immediately,\n current_value_only, create_locked, set_value_to_default) -> hou.ChopNode\n\n Creates a Channel CHOP representing this parameter. The Channel CHOP\n is created with the given name as a child of the given parent node.\n The parent_node is typically created via\n hou.OpNode.findOrCreateMotionEffectsNetwork.\n\n create_new: Always create a new Channel CHOP. If set to False, then\n if a Channel CHOP already exists with the same name, it will be re-\n used. If the parameter already exists on the Channel CHOP, the older\n parameter will be removed first.\n\n apply_immediately: If set to True, then the export flag on the\n Channel CHOP will be set.\n\n current_value_only: If set to True, then only the current value of\n the parameter will be stored.\n\n create_locked: If set to True, then the parameters are locked on\n creation.\n\n set_value_to_default: If set to True, then the parameters are\n reverted to their default values on creation\n\n See also hou.OpNode.findOrCreateMotionEffectsNetwork.\n\n\n \"\"\"\n def appendClip(self, chop_node: Node, apply_immediately: bool, current_value_only: bool = False, create_locked: bool = False, set_value_to_default: bool = False) -> None:\n \"\"\"\n\n appendClip(self, chop_node, apply_immediately, current_value_only,\n create_locked, set_value_to_default)\n\n Appends this parameter to the specified Channel CHOP.\n\n apply_immediately: If set to True, then the export flag on the\n Channel CHOP will be set.\n\n current_value_only: If set to True, then only the current value of\n the parameter will be stored.\n\n create_locked: If set to True, then the parameters are locked on\n creation.\n\n set_value_to_default: If set to True, then the parameters are\n reverted to their default values on creation\n\n\n \"\"\"\n def overrideTrack(self) -> Optional[Track]:\n \"\"\"\n\n overrideTrack(self) -> hou.Track or None\n\n Returns the CHOP track overriding this parameter, if any.\n\n\n \"\"\"\n def isOverrideTrackActive(self) -> bool:\n \"\"\"\n\n isOverrideTrackActive(self) -> bool\n\n Returns True if the CHOP track overriding this parameter is active.\n\n\n \"\"\"\n def copyToParmClipboard(self) -> None:\n \"\"\"\n\n copyToParmClipboard(self)\n\n Copies this to the parameter clipboard. See also\n hou.parmClipboardContents.\n\n\n \"\"\"\n def isDisabled(self) -> bool:\n \"\"\"\n\n isDisabled(self) -> bool\n\n Returns the disable state of the parameter, ignoring the lock state.\n This can be used to read the result of a disable-when conditional.\n\n It is recommended that hou.OpNode.updateParmStates is called before\n executing this method either in non-graphical Houdini or when the\n owner node has not yet been loaded into the Parameter Pane.\n\n\n \"\"\"\n def disable(self, on: bool) -> None:\n \"\"\"\n\n disable(self, on)\n\n Sets the UI disable state of this parameter in its node. This is not\n the same as locking a parameter, as the underlying value can still\n be modified. It's closer to what a disable-when conditional does,\n when a parameter is disabled automatically by it.\n\n\n \"\"\"\n def isHidden(self) -> bool:\n \"\"\"\n\n isHidden(self) -> bool\n\n Returns the hidden state of the parameter. This can be used to read\n the result of a hide-when conditional.\n\n It is recommended that hou.OpNode.updateParmStates is called before\n executing this method either in non-graphical Houdini or when the\n owner node has not yet been loaded into the Parameter Pane.\n\n\n \"\"\"\n def hide(self, on: bool) -> None:\n \"\"\"\n\n hide(self, on)\n\n Sets the UI hidden state of this parameter in its node. Calling this\n method has the same effect as changing the Invisible checkbox on the\n Edit Parameter Interface dialog, or hiding the parameter with a\n hide-when conditional.\n\n However, changing the UI state with this function is transient and\n does not affect node parameter templates, which means that the new\n state is not saved to .hip file and can be restored when refreshing\n the node to its spare parameter templates.\n\n To permanently change the UI state of a parameter on a node, please\n use hou.ParmTemplate.hide instead:\n\n > parms = hou.node('/obj/node').parmTemplateGroup()\n > p = parms.find('lookatpath')\n > p.hide(True)\n > parms.replace('lookatpath', p)\n > hou.node('/obj/node').setParmTemplateGroup(parms)\n\n \"\"\"\n def isVisible(self) -> bool:\n \"\"\"\n\n isVisible(self) -> bool\n\n Returns whether or not this parameter would be visible in the\n parameter dialog for this node. It checks both the parameter's\n template, and the hidden state of the parameter. This is equivalent\n to the following code (but runs faster because it avoids creating\n the hou.ParmTemplate):\n\n > >>> p = hou.parm('/obj/geo1/tx')\n > >>> not p.isHidden() and not p.parmTemplate().isHidden()\n > True\n\n \"\"\"\n def isConstrained(self) -> bool:\n \"\"\"\n\n isConstrained(self) -> bool\n\n Returns True if the Parm's parent node is an OBJ that is cooked and\n has constraints.\n\n\n \"\"\"\n def isPending(self) -> bool:\n \"\"\"\n\n isPending(self) -> bool\n\n Returns whether this keyed parameter has been changed, but hasn't\n been explicitly keyed.\n\n\n \"\"\"\n def keyframeExtrapolation(self, before: bool) -> EnumValue: ...\n def setKeyframeExtrapolation(self, before: bool, e: EnumValue) -> None:\n \"\"\"\n\n setKeyframeExtrapolation(self, before, extrapol)\n\n Sets a extrapolation on this parameter for time before the first\n keyframe or after the last keyframe. Extrapolation defines how a\n parm value is evaluated outside the keyframe range.\n\n\n before\n If set to true, the extrapolation for evaluations before the\n first keyframe will be set. If set to false, the extrapolation\n for evaluations after the last keyframe will be set.\n\n extrapol\n A hou.parmExtrapolate enumeration value.\n\n This function will raise a hou.ObjectWasDeleted exception if it is\n invoked on a parameter that does not exist in Houdini.\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n This function will raise a hou.OperationFailed exception the\n parameter doesn't have a valid animation channel.\n\n\n \"\"\"\n def keyframesRefit(self, refit: bool, refit_tol: float, refit_preserve_extrema: bool, refit_bezier: bool, resample: bool, resample_rate: float, resample_tol: float, range_: bool, range_start: float, range_end: bool, bake_chop: EnumValue, refit_smooth: bool) -> None:\n \"\"\"\n\n keyframesRefit(self, refit, refit_tol, refit_preserve_extrema,\n refit_bezier, resample, resample_rate, resample_tol, range, range_start,\n range_end, bake_chop)\n\n Performs a refitting operation with resampling and range controls.\n\n\n refit\n If set to true, a cubic refitting will be performed with the\n supplied refit options. If set to false, the refitting is\n skipped and only the resampling or range operation will be\n performed.\n\n refit_tol\n Refit Tolerance in absolute value.\n\n refit_preserve_extrema\n Preserves the keys that are local minima or maxima.\n\n refit_bezier\n If True, the new keyframes will be set to use bezier() segments.\n If False, the new keyframes will be set to use cubic() segments.\n\n resample\n If True, a resampling operation is performed prior to the\n refitting. If False, the channel is used as is.\n\n resample_rate\n Resample rate in frames. If set to 1.0, a keyframe will be added\n at every frame.\n\n resample_tol\n Resample Tolerance in frames. If set to 1.0, the resampling\n won't happen if a frame exists within one frame.\n\n range\n If True, the range_start and range_end arguments are used. It's\n useful when baking cycles when using cycle/cycle offset or\n oscillate channel extrapolation. If False, the channel range\n will be used based on the first and last keyframes.\n\n range_start\n Start frame of the range.\n\n range_end\n End frame of the range.\n\n bake_chop\n A hou.parmBakeChop enumeration value.\n\n refit_smooth\n If True, the new keyframes will have auto slopes applied to\n them. If False, the new keyframes use slopes chosen by the\n refitting algorithm.\n\n\n \"\"\"\n def uiBackgroundColor(self) -> Color:\n \"\"\"\n\n uiBackgroundColor(self) -> hou.Color\n\n Returns the background color used to indicate the state of this parm\n in parm dialogs. Raises hou.NotAvailable if there is no UI.\n\n\n \"\"\"\n def eval(self) -> int|float|str:\n \"\"\"\n\n eval(self) -> int, float, or str\n\n Evaluates this parameter at the current frame and returns the\n result. See also the evalAtFrame and evalAtTime methods.\n\n\n \"\"\"\n def evalAtFrame(self, frame: float) -> int|float|str:\n \"\"\"\n\n evalAtFrame(self, frame) -> int, float, or str\n\n Evaluate this parameter at a given frame and return the result as an\n integer, float or string.\n\n See also evalAtTime.\n\n\n \"\"\"\n def evalAtTime(self, frame: float) -> int|float|str:\n \"\"\"\n\n evalAtTime(self, time) -> int, float, or str\n\n Evaluate this parameter at a given time and return the result as an\n integer, float or string.\n\n See also evalAtFrame.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def appendMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]]) -> None: ...\n def asData(self, value: bool=True, evaluate_value=False, locked: bool=True, brief: bool=True, multiparm_instances: bool=True, metadata: bool=False, verbose: bool=False, default_values: bool=...) -> dict[str, Any]: ...\n def clipData(self, start:float|None=None, end:float|None=None, binary:bool=True, use_blosc_compression: bool=True, sample_rate:float=0) -> bytes: ...\n def insertMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]], index: int=0) -> None: ...\n def insertTemplatesFromData(self, data: dict[str, Any], operation: str=..., rename_conflicts:bool=True) -> None: ...\n def multiParmInstancesAsData(self, start_index: int=0, end_index: int=-1, value: bool = True, evaluate_value: bool = False, links: bool = True, locked: bool = True, brief: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]: ...\n def rampPointsAsData(self, evaluate: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]: ...\n def saveClip(self, file_name:str, start:float|None=None, end:float|None=None, sample_rate: float=0) -> None: ...\n def set(self, value: int | float | str | dict[str, str] | Parm | Ramp | Geometry, language: EnumValue | None = None, follow_parm_reference: bool = True) -> None: ...\n def setFromData(self, data: dict[str, Any]) -> None: ...\n def setMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]]) -> None: ...\n def setRampPointsFromData(self, data: Sequence[dict[str, Any]]) -> None: ...\n def setValueFromData(self, data: int | str | float | dict[str, Any] | Sequence[int] | Sequence[float] | Sequence[str]) -> None: ...\n def templateAsData(self, children: bool = True) -> dict[str, Any]: ...\n def templateChildrenAsData(self, parmtemplate_order: bool = False) -> dict[str, Any]: ...\n def valueAsData(self, evaluate: bool = True, verbose: bool = True) -> int | str | float | dict[str, Any] | list[int] | list[float] | list[str]: ...\n\nclass ParameterEditor(PathBasedPaneTab):\n \"\"\"\n\n hou.ParameterEditor\n\n Represents a Parameter Editor panetab.\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def scrollPosition(self) -> Vector2:\n \"\"\"\n\n scrollPosition(self) -> hou.Vector2\n\n Return the Parameter Editor scroll bars position as percentages.\n\n\n \"\"\"\n def setScrollPosition(self, position: Vector2) -> None:\n \"\"\"\n\n setScrollPosition(self,pos)\n\n Set Parameter Editor scroll bars position as hou.Vector2\n percentages.\n\n\n \"\"\"\n def setFilterEnabled(self, on: bool, keyboard_lock: bool = False) -> None:\n \"\"\"\n\n setFilterEnabled(self,on,keyboard_lock)\n\n Enable Parameter Editor filtering. If keyboard_lock is True and on\n is True, the filter field will be selected allowing you to use the\n keyboard right away. keyboard_lock is False by default.\n hou.parmFilterCriteria.\n\n\n \"\"\"\n def filterEnabled(self) -> bool:\n \"\"\"\n\n filterEnabled(self) -> bool\n\n Return True if Parameter Editor filtering is enabled.\n\n\n \"\"\"\n def setFilterPattern(self, filter: str) -> None:\n \"\"\"\n\n setFilterPattern(self,pattern)\n\n Set the Parameter Editor filter pattern. The filter pattern is\n applied on a hou.parmFilterCriteria string from parameters that\n match the hou.parmFilterMode. The pattern matching can use exact\n name matching or find the pattern within the string. The filter\n pattern can be a list of pattern separated by commas and can also\n contain wildcard '*' character.\n\n\n \"\"\"\n def filterPattern(self) -> str:\n \"\"\"\n\n filterPattern(self) -> str\n\n Return the Parameter Editor filter pattern.\n\n\n \"\"\"\n def setFilterExactMatch(self, on: bool) -> None:\n \"\"\"\n\n setFilterExactMatch(self,on)\n\n Set Parameter Editor filtering to use exact pattern matching.\n\n\n \"\"\"\n def filterExactMatch(self) -> bool:\n \"\"\"\n\n filterExactMatch(self) -> bool\n\n Return True if Parameter Editor filtering uses exact pattern\n matching.\n\n\n \"\"\"\n def setFilterMode(self, mode: EnumValue) -> None:\n \"\"\"\n\n setFilterMode(self,mode)\n\n Set the Parameter Editor filter mode. The hou.parmFilterMode defines\n on which parameters to apply the filter pattern.\n\n\n \"\"\"\n def filterMode(self) -> EnumValue:\n \"\"\"\n\n filterMode(self) -> hou.parmFilterMode\n\n Return the Parameter Editor hou.parmFilterMode.\n\n\n \"\"\"\n def setFilterCriteria(self, criteria: EnumValue) -> None:\n \"\"\"\n\n setFilterCriteria(self,criteria)\n\n Set the Parameter Editor filter criteria. The hou.parmFilterCriteria\n defines how the filter pattern is applied to parameters.\n\n\n \"\"\"\n def filterCriteria(self) -> EnumValue:\n \"\"\"\n\n filterCriteria(self) -> hou.parmFilterCriteria\n\n Return the Parameter Editor hou.parmFilterCriteria.\n\n\n \"\"\"\n def isShowingParmDialog(self) -> bool:\n \"\"\"\n\n isShowingParmDialog(self) -> bool\n\n Return True if the Parameter Editor is currently displaying a\n parameter dialog (as opposed to, for example, a Python Panel).\n\n\n \"\"\"\n def setShowParmDialog(self, show: bool) -> None:\n \"\"\"\n\n setShowParmDialog(self,show)\n\n Set the Parameter Editor to display a parameter dialog if show is\n True, and switch to a Python Panel if show is False.\n\n Raise hou.OperationFailed if the Parameter Editor's current node has\n no corresponding Python Panel interface and show is set to False.\n\n\n \"\"\"\n def setMultiParmTab(self, parm: str, index: int) -> None:\n \"\"\"\n\n setMultiParmTab(self,parm, tab_index)\n\n Switch a Multi Parameter Tab to a given tab using a parameter name.\n\n\n \"\"\"\n def multiParmTab(self, parm: str) -> int:\n \"\"\"\n\n multiParmTab(self,parm) -> int\n\n Returns the currently visible tab index using a parameter name.\n\n\n \"\"\"\n def visibleParms(self) -> Tuple[ParmTuple, ...]:\n \"\"\"\n\n visibleParms(self) -> tuple of hou.ParmTuple\n\n Returns the currently visible parameters.\n\n\n \"\"\"\n\nclass ParmTuple:\n '''\n\n hou.ParmTuple\n\n A tuple of one or more node parameters. Each parameter tuple has a\n unique name within its node.\n\n The ParmTuple class behaves like a Python sequence, so you can index\n into it using square brackets, iterate over it, call len on it, etc. The\n elements inside the parameter tuple are hou.Parm objects.\n\n A parameter tuple\\'s name may only contain letters, numbers, and\n underscores. For example, objects contain a parameter tuple named \\\\\"t\\\\\"\n that contains three integer parameters. The names of the parameters\n inside the tuple are determined from the parameter tuple\\'s name and its\n naming scheme. For example, the \\\\\"t\\\\\" parameter uses the XYZW naming\n scheme, so the three parameters inside it are named \\\\\"tx\\\\\", \\\\\"ty\\\\\", and\n \\\\\"tz\\\\\". Note that if the parameter tuple only contains one parameter, the\n tuple and the parameter inside it may have the same name.\n\n In addition to a name, a parameter tuple also has a label that is\n displayed to the user in the parameter dialog. For example, the \\\\\"t\\\\\"\n parameter\\'s label is \\\\\"Translate\\\\\". The label may contain spaces and\n punctuation characters.\n\n Each parameter in a tuple stores a value. Different instances of parm\n tuples in different nodes will store their own set of parameter values.\n The value in a parameter may be animated, in which case the parameter\n evaluates to a different result depending on the current time on the\n playbar. See hou.Keyframe for more information about animated\n parameters.\n\n Each hou.NodeType has a set of parameter tuple descriptions associated\n with it, and each instance of a hou.OpNode has a corresponding set of\n parameter tuple instances. The parameter tuples store specific values\n that are saved with the node. The descriptions of the parameter tuples,\n however, are represented by a hou.ParmTemplate. A parameter template\n describes the type, default values, ranges, etc. of a parameter tuple.\n\n See also hou.parmTuple_ and hou.OpNode.parmTuple.\n\n\n '''\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def __eq__(self, other: object) -> bool: ...\n def __ne__(self, other: object) -> bool: ...\n def __hash__(self) -> int: ...\n def node(self) -> OpNode:\n \"\"\"\n\n node(self) -> hou.OpNode\n\n Return the node containing this parameter tuple.\n\n\n \"\"\"\n def parmTemplate(self) -> ParmTemplate:\n \"\"\"\n\n parmTemplate(self) -> hou.ParmTemplate\n\n Return this parameter tuple's template.\n\n Note that a folder parameter will have a hou.FolderSetParmTemplate\n template and a multiparm parameter will have a\n hou.FolderParmTemplate template.\n\n\n \"\"\"\n def name(self) -> str:\n '''\n\n name(self) -> str\n\n Return the name of this parameter tuple. Note that the parameter\n tuple\\'s name and its naming scheme determine the names of the\n parameters inside it.\n\n > >>> node = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\")\n > >>> node.parmTuple(\\\\\"t\\\\\").parmTemplate().namingScheme()\n > parmNamingScheme.XYZW\n > >>> [parm.name() for parm in node.parmTuple(\\\\\"t\\\\\")]\n > [\\'tx\\', \\'ty\\', \\'tz\\']\n > \n > >>> parm_tuple = node.parent().createNode(\\\\\"cam\\\\\").parmTuple(\\\\\"dcolor\\\\\")\n > >>> parm_tuple.parmTemplate().namingScheme()\n > parmNamingScheme.RGBA\n > >>> [parm.name() for parm in parm_tuple]\n > [\\'dcolorr\\', \\'dcolorg\\', \\'dcolorb\\']\n\n '''\n def description(self) -> str:\n \"\"\"\n\n description(self) -> str\n\n Return this parameter tuple's label that is displayed in the\n parameter dialog.\n\n\n \"\"\"\n def setPending(self, values: Sequence[float|str]) -> None:\n \"\"\"\n\n setPending(self, values)\n\n Sets the value of a parameter in the tuple at the current frame and\n marks it as pending if the parameter is keyed.\n\n\n values\n A sequence of floats or strings, corresponding to the components\n of this parameter tuple.\n\n For example, the parameter tuple for translation contains Parm\n objects for translation along each of the axes, tx, ty and tz. If\n set is called with following tuple of floats, (2.5, 4.0, 5.5), then\n the parameter tx with be set to 2.5, ty will be set to 4.0 and tz\n will be set to 5.5.\n\n Raises hou.InvalidSize if values has a different length than this\n parameter tuple. Raises hou.PermissionError if any of the parameters\n in this parameter tuple are not writable.\n\n\n \"\"\"\n def overwriteDefaults(self) -> None: ...\n def revertToDefaults(self) -> None:\n \"\"\"\n\n revertToDefaults(self)\n\n Changes the value back to the default(s). See also the\n revertToAndRestoreFactoryDefaults() method.\n\n\n \"\"\"\n def revertToAndRestorePermanentDefaults(self) -> None:\n \"\"\"\n\n revertToAndRestorePermanentDefaults(self)\n\n Changes the value back to the defaults that ship with Houdini, and\n restore those defaults.\n\n See also the revertToDefaults() method.\n\n\n \"\"\"\n def isAtDefault(self, compare_temporary_defaults: bool = True, compare_expressions: bool = True) -> bool:\n \"\"\"\n\n isAtDefault(self, compare_temporary_defaults=True,\n compare_expressions=False) -> bool\n\n Returns whether the parameter tuple is currently at its defaults.\n\n compare_temporary_defaults: When is\n True, isDefault also checks\n\n compare_expressions: When is True, isDefault\n compares the actual\n\n See also the revertToDefaults() and\n revertToAndRestorePermanentDefaults()methods.\n\n\n \"\"\"\n def isAtRampDefault(self) -> bool:\n \"\"\"\n\n isAtRampDefault(self) -> bool\n\n Returns whether the ramp parameter is currently at its default.\n\n This tests all of the multiparm parameters associated with the ramp\n by comparing to the special ramp default spare paramater data. Ramps\n with no default spare data will never be at default.\n\n\n \"\"\"\n def evalAsFloats(self) -> Tuple[float, ...]:\n \"\"\"\n\n evalAsFloats(self) -> tuple of float\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple of floats.\n\n Raises TypeError if a value cannot be converted to a float.\n\n\n \"\"\"\n def evalAsFloatsAtFrame(self, frame: float) -> Tuple[float, ...]:\n \"\"\"\n\n evalAsFloatsAtFrame(self, frame) -> tuple of float\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a tuple of floats.\n\n Raises TypeError if a value cannot be converted to a float.\n\n\n \"\"\"\n def evalAsInts(self) -> Tuple[int, ...]:\n \"\"\"\n\n evalAsInts(self) -> tuple of int\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple of integers.\n\n Raises TypeError if a value cannot be converted to an integer.\n\n\n \"\"\"\n def evalAsIntsAtFrame(self, frame: float) -> Tuple[int, ...]:\n \"\"\"\n\n evalAsIntsAtFrame(self, frame) -> tuple of int\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a tuple of integers.\n\n Raises TypeError if a value cannot be converted to an integer.\n\n\n \"\"\"\n def evalAsStrings(self) -> Tuple[str, ...]:\n \"\"\"\n\n evalAsStrings(self) -> tuple of str\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple of strings.\n\n Raises TypeError if a value cannot be converted to a string.\n\n\n \"\"\"\n def evalAsStringsAtFrame(self, frame: float) -> Tuple[str, ...]:\n \"\"\"\n\n evalAsStringsAtFrame(self, frame) -> tuple of str\n\n Evaluates the parameter tuple at a frame and returns the result as a\n tuple of strings.\n\n Raises TypeError if a value cannot be converted to a string.\n\n\n \"\"\"\n def evalAsRamps(self) -> Tuple[Ramp, ...]:\n \"\"\"\n\n evalAsRamps(self) -> hou.Ramp\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple containing a hou.Ramp object.\n\n Raises TypeError if this is not a ramp parameter.\n\n\n \"\"\"\n def evalAsRampsAtFrame(self, frame: float) -> Tuple[Ramp, ...]:\n \"\"\"\n\n evalAsRampsAtFrame(self, frame) -> hou.Ramp\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a tuple containing a hou.Ramp object.\n\n Raises TypeError if this is not a ramp parameter.\n\n\n \"\"\"\n def evalAsGeometries(self) -> Tuple[Geometry, ...]:\n \"\"\"\n\n evalAsGeometries(self) -> tuple of hou.Geometry\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple containing a hou.Geometry object.\n\n Raises TypeError if a value cannot be converted to a hou.Geometry.\n\n\n \"\"\"\n def evalAsGeometriesAtFrame(self, frame: float) -> Tuple[Geometry, ...]:\n \"\"\"\n\n evalAsGeometriesAtFrame(self, frame) -> tuple of hou.Geometry\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a tuple containing a hou.Geometry object.\n\n Raises TypeError if a value cannot be converted to a hou.Geometry.\n\n\n \"\"\"\n def evalAsImageLayers(self) -> Tuple[ImageLayer, ...]:\n \"\"\"\n\n evalAsImageLayers(self) -> tuple of hou.ImageLayer\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple containing a hou.ImageLayer object.\n\n Raises TypeError if a value cannot be converted to a hou.ImageLayer.\n\n\n \"\"\"\n def evalAsImageLayersAtFrame(self, frame: float) -> Tuple[ImageLayer, ...]:\n \"\"\"\n\n evalAsImageLayersAtFrame(self, frame) -> tuple of hou.ImageLayer\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a tuple containing a hou.ImageLayer object.\n\n Raises TypeError if a value cannot be converted to a hou.ImageLayer.\n\n\n \"\"\"\n def evalAsNanoVDBs(self) -> Tuple[NanoVDB, ...]:\n \"\"\"\n\n evalAsNanoVDBs(self) -> tuple of hou.NanoVDB\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple containing a hou.NanoVDB object.\n\n Raises TypeError if a value cannot be converted to a hou.NanoVDB.\n\n\n \"\"\"\n def evalAsNanoVDBsAtFrame(self, frame: float) -> Tuple[NanoVDB, ...]:\n \"\"\"\n\n evalAsNanoVDBsAtFrame(self, frame) -> tuple of hou.NanoVDB\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a tuple containing a hou.NanoVDB object.\n\n Raises TypeError if a value cannot be converted to a hou.NanoVDB.\n\n\n \"\"\"\n def evalAsJSONMaps(self) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n evalAsJSONMaps(self) -> tuple of dict of str to str\n\n Evaluates this parameter tuple at the current frame and returns the\n result as a tuple containing JSON map structures (i.e. Python\n dictionary).\n\n Raises TypeError or hou.OperationFailed if the parameter tuple is\n not a JSON map data parameter tuple.\n\n\n \"\"\"\n def evalAsJSONMapsAtFrame(self, frame: float) -> Tuple[dict[str, str], ...]:\n \"\"\"\n\n evalAsJSONMapsAtFrame(self, frame) -> tuple of dict of str to str\n\n Evaluates this parameter tuple at a certain frame and returns the\n result as a a tuple containing JSON map structures (i.e. Python\n dictionary).\n\n Raises TypeError or hou.OperationFailed if the parameter tuple is\n not a JSON map data parameter tuple.\n\n\n \"\"\"\n def lock(self, bool_values: bool|Sequence[bool]) -> None:\n \"\"\"\n\n lock(self, bool_values)\n\n Lock or unlock all the parameters in this tuple. Houdini displays\n locked parameters as disabled and does not let you change their\n values.\n\n\n bool_values\n Either a single True or False value to be applied to all\n components of this parameter or a sequence of them where each\n value corresponds to a single component. Where an element of\n bool_values is True, that component will be locked (uneditable),\n and where an element is False, the corresponding component will\n be unlocked (editable).\n\n For example, the parameter tuple for translation contains Parm\n objects for translation along each of the axes, tx, ty and tz. If\n lock is called with the following tuple of boolean values, (True,\n True, False), then the parameter tx and ty will be locked and made\n non-editable, while tz will be unlocked and made editable.\n\n Raises hou.InvalidSize if bool_values has a different length than\n this parameter tuple. Raises hou.PermissionError if any of the\n parameters in this parameter tuple are not writable.\n\n\n \"\"\"\n def setAutoscope(self, bool_values: Sequence[bool]) -> None:\n \"\"\"\n\n setAutoscope(self, bool_values)\n\n Changes the autoscope property of components of this parameter\n tuple.\n\n\n bool_values\n A sequence of True or False values, where each value corresponds\n to a component of this parameter. Where an element of\n bool_values is True, that component will be autoscope.\n\n For example, the parameter tuple for translation contains Parm\n objects for translation along each of the axes, tx, ty and tz. If\n setAutoscope is called with the following tuple of boolean values,\n (True, True, False), then the parameter tx and ty will be\n automatically scoped, while tz will not.\n\n Raises hou.InvalidSize if values has a different length than this\n parameter tuple. Raises hou.PermissionError if any of the parameters\n in this parameter tuple are not writable.\n\n\n \"\"\"\n def isSpare(self) -> bool:\n \"\"\"\n\n isSpare(self) -> bool\n\n Returns whether the parameter is a spare (user-defined) parameter.\n\n\n \"\"\"\n def isTimeDependent(self) -> bool:\n \"\"\"\n\n isTimeDependent(self) -> bool\n\n Returns whether any of the parameters in the tuple are time\n dependent, that is, a parameter's value changes depending on the\n point on the timeline at which it's evaluated. For example the\n parameter has an expression containing the $F (current frame number)\n variable.\n\n\n \"\"\"\n def isMultiParmInstance(self) -> bool:\n \"\"\"\n\n isMultiParmInstance(self) -> bool\n\n Return whether this parameter is an instance of a multi parm. For\n example, the pt0, pt1, pt2, etc. parameter tuples in an add SOP are\n instances of a multiparm.\n\n\n \"\"\"\n def isMultiParmParent(self) -> bool:\n \"\"\"\n\n isMultiParmParent(self) -> bool\n\n Return whether this parameter is a parent multi parm, the number of\n instances parameter or returns None otherwise\n\n\n \"\"\"\n def parentMultiParm(self) -> Optional[Parm]:\n \"\"\"\n\n parentMultiParm(self) -> hou.Parm\n\n Return the parent multi-parameter if this parameter is a multi-\n parameter instance and None otherwise.\n\n\n \"\"\"\n def multiParmInstanceIndices(self) -> Tuple[int, ...]:\n \"\"\"\n\n multiParmInstanceIndices(self) -> tuple of int\n\n If this parameter is a multi-parameter instance, then return a tuple\n of indices of where the parameter appears in the multi-parameter\n block and any nested blocks. Indices for outer multi-parameter\n blocks are listed first.\n\n For example if this parameter appears as the fourth instance in the\n multi-parameter block then (3,) is returned.\n\n As another example if this parameter appears as the third instance\n in the multi-parameter block and the block itself appears as the\n first instance of an outer multi-parameter block then (0, 2) is\n returned.\n\n\n \"\"\"\n def multiParmInstancesPerItem(self) -> int:\n \"\"\"\n\n multiParmInstancesPerItem(self) -> int\n\n If this parameter corresponds to the number of instances for a\n multiparm, return number of parameters per instance.\n\n Returns 0 if this parameter is not for a multiparm.\n\n\n \"\"\"\n def multiParmInstancesCount(self) -> int:\n \"\"\"\n\n multiParmInstancesCount(self) -> int\n\n If this parameter corresponds to the number of instances for a\n multiparm, return number of parameters per instance.\n\n Returns 0 if this parameter is not for a multiparm.\n\n\n \"\"\"\n def multiParmStartOffset(self) -> int:\n \"\"\"\n\n multiParmStartOffset(self) -> int\n\n If this parameter corresponds to the number of instances for a\n multiparm, return the starting index used when building multi\n parameter names. The default value is 1.\n\n Returns 0 if this parameter is not for a multiparm.\n\n\n \"\"\"\n def multiParmInstances(self) -> Tuple[ParmTuple, ...]:\n \"\"\"\n\n multiParmInstances(self) -> tuple of hou.ParmTuple\n\n If this parameter corresponds to the number of instances for a\n multiparm, return all the parameter tuples corresponding to all\n instances of this multiparm.\n\n Returns an empty tuple if this parameter is not for a multiparm.\n\n\n \"\"\"\n def containingFolders(self) -> Tuple[str, ...]: ...\n def containingFolderIndices(self) -> Tuple[int, ...]: ...\n def containingFolderSetParmTuples(self) -> Tuple[ParmTuple, ...]: ...\n def setKeyframe(self, keyframes: Sequence[BaseKeyframe]) -> None:\n \"\"\"\n\n setKeyframe(self, keyframe_vector)\n\n Sets a keyframe on this parameter.\n\n\n keyframe_vector\n A sequence of keyframes for each component of the parameter\n tuple.\n\n Raises TypeError if keyframe is not of type hou.BaseKeyframe. Raises\n hou.PermissionError if this parameter is not writable. Raises\n hou.InvalidSize if keyframe_vector has a different length than this\n parameter tuple.\n\n\n \"\"\"\n def deleteKeyframeAtFrame(self, frame: float) -> None:\n \"\"\"\n\n deleteKeyframeAtFrame(self, frame)\n\n Removes a keyframe from this parameter tuple at the given frame.\n\n This function will raise a hou.ObjectWasDeleted exception if it is\n invoked on a parameter that does not exist in Houdini.\n\n This function will raise a hou.PermissionError exception if writing\n to the specified parameter is impossible.\n\n This function will raise a hou.OperationFailed exception the\n parameter doesn't have a keyframe at the given frame.\n\n See also hou.ParmTuple.deleteAllKeyframes.\n\n\n \"\"\"\n def deleteAllKeyframes(self) -> None:\n \"\"\"\n\n deleteAllKeyframes(self)\n\n Remove all the keyframes from this parameter tuple.\n\n This method be approximately implemented as follows:\n\n > def deleteAllKeyframes(self):\n > for parm in self:\n > parm.deleteAllKeyframes()\n\n See also hou.Parm.deleteAllKeyframes.\n\n\n \"\"\"\n def __getitem__(self, index: int) -> Parm:\n '''\n\n __getitem__(self, index) -> hou.Parm\n\n Return the Parm object for the specified component of this parameter\n tuple. Negative indices will index from the end.\n\n This method makes instances of this class appear like a tuple, and\n lets you iterate over the parms in a ParmTuple.\n\n Raises IndexError if the index is not valid.\n\n > >>> parm_tuple = hou.node(\\\\\"/obj\\\\\").createNode(\\\\\"geo\\\\\").parmTuple(\\\\\"t\\\\\")\n > >>> for parm in parm_tuple:\n > ... print parm.name(),\n > tx ty tz\n > >>> tuple(parm_tuple)\n > (, , )\n\n '''\n def __len__(self) -> int:\n \"\"\"\n\n __len__(self) -> int\n\n Return the number of hou.Parms in this parameter tuple.\n\n\n \"\"\"\n def __bool__(self) -> bool: ...\n def createClip(self, parent_node: Node, name: str, create_new: bool, apply_immediately: bool, current_value_only: bool = False, create_locked: bool = False, set_value_to_default: bool = False) -> ChopNode:\n \"\"\"\n\n createClip(self, parent_node, name, create_new, apply_immediately,\n current_value_only, create_locked, set_value_to_default) -> hou.ChopNode\n\n Creates a Channel CHOP representing this parameter. The Channel CHOP\n is created with the given name as a child of the given parent node.\n The parent_node is typically created via\n hou.OpNode.findOrCreateMotionEffectsNetwork.\n\n create_new: Always create a new Channel CHOP. If set to False, then\n if a Channel CHOP already exists with the same name, it will be re-\n used. If the parameter already exists on the Channel CHOP, the older\n parameter will be removed first.\n\n apply_immediately: If set to True, then the export flag on the\n Channel CHOP will be set.\n\n current_value_only: If set to True, then only the current value of\n the parameter will be stored.\n\n create_locked: If set to True, then the parameters are locked on\n creation.\n\n set_value_to_default: If set to True, then the parameters are\n reverted to their default values on creation\n\n See also hou.OpNode.findOrCreateMotionEffectsNetwork.\n\n\n \"\"\"\n def appendClip(self, chop_node: Node, apply_immediately: bool, current_value_only: bool = False, create_locked: bool = False, set_value_to_default: bool = False) -> None:\n \"\"\"\n\n appendClip(self, chop_node, apply_immediately, current_value_only,\n create_locked, set_value_to_default)\n\n Appends this parameter to the specified Channel CHOP.\n\n apply_immediately: If set to True, then the export flag on the\n Channel CHOP will be set.\n\n current_value_only: If set to True, then only the current value of\n the parameter will be stored.\n\n create_locked: If set to True, then the parameters are locked on\n creation.\n\n set_value_to_default: If set to True, then the parameters are\n reverted to their default values on creation\n\n\n \"\"\"\n def copyToParmClipboard(self) -> None:\n \"\"\"\n\n copyToParmClipboard(self)\n\n Copies this to the parameter clipboard. See also\n hou.parmClipboardContents.\n\n\n \"\"\"\n def asCode(self, brief: bool = False, save_values: bool = True, save_keyframes: bool = True, save_keys_in_frames: bool = False, save_flag_values: bool = True, save_aliases: bool = True, function_name: Optional[str] = None) -> str: ...\n def help(self) -> str: ...\n def helpUrl(self) -> str: ...\n def isDisabled(self) -> bool:\n \"\"\"\n\n isDisabled(self) -> bool\n\n Returns the disable state of the parameter tuple, ignoring the lock\n state. This can be used to read the result of a disable-when\n conditional.\n\n It is recommended that hou.OpNode.updateParmStates is called before\n executing this method either in non-graphical Houdini or when the\n owner node has not yet been loaded into the Parameter Pane.\n\n\n \"\"\"\n def disable(self, on: bool) -> None:\n \"\"\"\n\n disable(self, on)\n\n Sets the UI disable state of this parameter tuple in its node. This\n is not the same as locking a parameter, as the underlying value can\n still be modified. It's closer to what a disable-when conditional\n does, when a parameter is disabled automatically by it.\n\n\n \"\"\"\n def isHidden(self) -> bool:\n \"\"\"\n\n isHidden(self) -> bool\n\n Returns the hidden state of the parameter tuple. This can be used to\n read the result of a hide-when conditional.\n\n It is recommended that hou.OpNode.updateParmStates is called before\n executing this method either in non-graphical Houdini or when the\n owner node has not yet been loaded into the Parameter Pane.\n\n\n \"\"\"\n def hide(self, on: bool) -> None:\n \"\"\"\n\n hide(self, on)\n\n Sets the UI hidden state of this parameter tuple in its node.\n Calling this method is equivalent to changing the Invisible checkbox\n on the Edit Parameter Interface dialog, or hiding the parameter with\n a hide-when conditional.\n\n To hide a folder, use hou.OpNode.setParmTemplateGroup. This method\n cannot be used to hide a folder because a parm tuple corresponds to\n a set of folders, not an individual folder.\n\n To change the visibility of all new instances of the node type\n defined by a digital asset, use\n hou.HDADefinition.setParmTemplateGroup as in the following example:\n\n > def showParmTupleInDefinition(parm_tuple, visible):\n > '''parm_tuple is a hou.ParmTuple on an instance of the digital asset.'''\n > definition = parm_tuple.node().type().definition()\n > parm_template_group = definition.parmTemplateGroup()\n > parm_template = parm_template_group.find(parm_tuple.name())\n > parm_template.hide(not visible)\n > parm_template_group.replace(parm_tuple.name(), parm_template)\n > definition.setParmTemplateGroup(parm_template_group)\n\n \"\"\"\n def isConstrained(self) -> bool: ...\n def isShowingExpression(self) -> bool: ...\n def showExpression(self, value: bool) -> None: ...\n def eval(self) -> Tuple[int,...]|Tuple[float,...]|Tuple[str,...]|Ramp:\n \"\"\"\n\n eval(self) -> tuple of int, float, str, or hou.Ramp\n\n Evalute this parameter tuple at the current frame and returns the\n result as a tuple of integers, floats or strings, or a hou.Ramp\n object, depending on the type of the parameter.\n\n See also the evalAtFrame and evalAtTime methods.\n\n\n \"\"\"\n def evalAtFrame(self, frame: float) -> Tuple[int,...]|Tuple[float,...]|Tuple[str,...]|Ramp:\n \"\"\"\n\n evalAtFrame(self, frame) -> tuple of int, float, str, or hou.Ramp\n\n Evalute the parameter tuple at a given frame and return the result\n as a tuple of integers, floats, strings, or a Ramp object, depending\n on the type of the parameter.\n\n See also evalAtTime.\n\n\n \"\"\"\n def evalAtTime(self, frame: float) -> Tuple[int,...]|Tuple[float,...]|Tuple[str,...]|Ramp:\n \"\"\"\n\n evalAtTime(self, time) -> tuple of int, float, str, or hou.Ramp\n\n Evalute the parameter tuple at a given time and return the result as\n a tuple of integers, floats, strings, or a Ramp object, depending on\n the type of the parameter.\n\n See also evalAtFrame.\n\n\n \"\"\"\n\n # Missing methods added by stubgen\n def __iter__(self) -> Iterator[Parm]: ...\n def asData(self, value: bool=True, evaluate_value=False, locked: bool=True, brief: bool=True, multiparm_instances: bool=True, metadata: bool=False, verbose: bool=False, default_values: bool=...) -> dict[str, Any]: ...\n def clipData(self, start:float|None=None, end:float|None=None, binary:bool=True, use_blosc_compression: bool=True, sample_rate:float=0) -> bytes: ...\n def insertMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]], index: int=0) -> None: ...\n def insertTemplatesFromData(self, data: dict[str, Any], operation: str = ..., rename_conflicts: bool = True) -> None: ...\n def multiParmInstancesAsData(self, start_index: int=0, end_index: int=-1, value: bool = True, evaluate_value: bool = False, links: bool = True, locked: bool = True, brief: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]: ...\n def rampPointsAsData(self, evaluate: bool = True, metadata: bool = False, verbose: bool = False) -> Sequence[dict[str, Any]]: ...\n def saveClip(self, file_name:str, start:float|None=None, end:float|None=None, sample_rate: float=0) -> None: ...\n def set(self, value: Sequence[int] | Sequence[float] | Sequence[str] | Sequence[Parm] | ParmTuple, language: EnumValue | None = None, follow_parm_reference: bool = True) -> None: ...\n def setFromData(self, data: dict[str, Any]) -> None: ...\n def setMultiParmInstancesFromData(self, data: Sequence[dict[str, Any]]) -> None: ...\n def setRampPointsFromData(self, data: Sequence[dict[str, Any]]) -> None: ...\n def setValueFromData(self, data: int | str | float | dict[str, Any] | Sequence[int] | Sequence[float] | Sequence[str]) -> None: ...\n def templateAsData(self, children: bool = True, parmtemplate_order: bool = False) -> dict[str, Any]: ...\n def templateChildrenAsData(self, parmtemplate_order: bool = False) -> dict[str, Any]: ...\n def valueAsData(self, evaluate: bool = True, verbose: bool = True) -> int | str | float | dict[str, Any] | list[int] | list[float] | list[str]: ...\n\nclass perfMon:\n \"\"\"\n\n hou.perfMon\n\n Module containing performance monitor related functions.\n\n\n NOTE\n HOM performance monitor submodules, classes and methods report time\n and memory statistics in milliseconds and bytes respectively.\n\n RELATED\n\n * hou.PerfMonProfile\n\n * hou.PerfMonEvent\n\n * hou.PerfMonRecordOptions\n\n * Performance monitor pane\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n @staticmethod\n def startProfile(title: str, options: Optional[PerfMonRecordOptions] = None) -> PerfMonProfile:\n \"\"\"\n\n startProfile(title, options=None) -> hou.PerfMonProfile\n\n Create a new profile and start it so that it can record events. When\n the profile is stopped, it will generate statistics for the events\n that it recorded.\n\n\n options\n A hou.PerfMonRecordOptions object that specifies the types of\n Houdini events and statistics to record. If None is passed in or\n if the options argument is not specified, then the profile will\n record all events and statistics.\n\n\n \"\"\"\n @staticmethod\n def loadProfile(file_path: str) -> PerfMonProfile:\n \"\"\"\n\n loadProfile(file_path) -> hou.PerfMonProfile\n\n Load a profile from disk and return the loaded profile.\n\n Raises hou.OperationFailed if file_path points to a file that does\n not exist or is not a valid Houdini performance monitor profile\n file.\n\n\n \"\"\"\n @staticmethod\n def saveProfile(profile: PerfMonProfile, file_path: str) -> None:\n \"\"\"\n\n saveProfile(profile, file_path)\n\n Save the profile to disk.\n\n Raises hou.OperationFailed if the profile is still active or if the\n file could not be written to disk (i.e. permission problems).\n\n\n \"\"\"\n @staticmethod\n def activeProfile() -> Optional[PerfMonProfile]:\n \"\"\"\n\n activeProfile() -> hou.PerfMonProfile or None\n\n Return the profile currently visible in the performance monitor\n pane, or\n\n\n \"\"\"\n @staticmethod\n def startTimedEvent(description: str, auto_nest_events: bool = True) -> PerfMonEvent:\n \"\"\"\n\n startTimedEvent(description, auto_nest_events=True) -> hou.PerfMonEvent\n\n This method is deprecated in favor of startEvent.\n\n\n \"\"\"\n @staticmethod\n def startEvent(description: str, auto_nest_events: bool = True) -> PerfMonEvent:\n \"\"\"\n\n startEvent(description, auto_nest_events=True) -> hou.PerfMonEvent\n\n Create a generic event and start it. When the event is stopped, it\n will be logged by the performance monitor and added to any profiles\n that are recording script or memory statistics.\n\n Use this function to time and measure memory growth in generic\n scripts, functions or code blocks.\n\n Return the new event.\n\n\n description\n The description of the event that you are starting. For example,\n this can be a function name or a script name or a description of\n a code block.\n\n auto_nest_events\n If set to True, the event will automatically 'nest' other events\n that are started and stopped while this event is running. When\n the event is stopped, it will decrement the times and memory of\n its nested events from its total time and memory. That way, the\n event's total time and memory will reflect the work performed in\n the event itself and not in any of its nested events.\n\n Raises hou.OperationFailed if description is an empty string.\n\n\n \"\"\"\n @staticmethod\n def startTimedCookEvent(description: str, node: Node) -> PerfMonEvent:\n \"\"\"\n\n startTimedCookEvent(description, node) -> hou.PerfMonEvent\n\n This method is deprecated in favor of startCookEvent.\n\n\n \"\"\"\n @staticmethod\n def startCookEvent(description: str, node: Node) -> PerfMonEvent:\n \"\"\"\n\n startCookEvent(description, node) -> hou.PerfMonEvent\n\n Create an event that is related to node cooking and start it. When\n the event is stopped, it will be logged by the performance monitor\n and added to any profiles that are recording cook or memory\n statistics.\n\n Use this function to time code blocks and measure memory growth in\n the Code section of Python operators.\n\n Return the cook event.\n\n\n description\n The description of the event that you are timing. For example,\n this can be a function name or a description of a code block.\n\n node\n The node that the timed event applies to. This must be a\n hou.OpNode object. When calling startCookEvent() from within the\n Code section of a Python operator, set node to the current node\n (i.e. hou.pwd()).\n\n Raises hou.OperationFailed if description is an empty string or if\n node does not exist.\n\n\n \"\"\"\n @staticmethod\n def startPaneEvent(panetype: str, operation: str) -> PerfMonEvent:\n \"\"\"\n\n startPaneEvent(panetype, operation) -> hou.PerfMonEvent\n\n Create an event that is related to the operation of a scriped pane\n and start it. When the event is stopped, it will be logged by the\n performance monitor and added to any profiles that are recording\n cook or memory statistics.\n\n Use this function to time code blocks and measure memory growth in\n the code for python panels.\n\n Return the cook event.\n\n\n panetype\n A description of the python panel running this code.\n\n operation\n The specific operation being timed by this event.\n\n Raises hou.OperationFailed if either panetype or operation are empty\n strings.\n\n\n \"\"\"\n @staticmethod\n def isRecording() -> bool:\n \"\"\"\n\n isRecording() -> bool\n\n Return True if the performance monitor is recording Houdini events.\n\n\n \"\"\"\n\nclass PerfMonEvent:\n \"\"\"\n\n hou.PerfMonEvent\n\n Represents an event that is recorded by the performance monitor and used\n to generate time and memory growth statistics for profiles.\n\n Note that all methods in this class may raise an hou.OperationFailed\n exception if the event was not actually recorded in the Performance\n Monitor. This can happen if hou.perfMon.startEvent or\n hou.perfMon.startCookEvent was called when the Performance Monitor was\n not recording.\n\n\n NOTE\n HOM performance monitor submodules, classes and methods report time\n and memory statistics in milliseconds and bytes respectively.\n\n NOTE\n The stopTime(), memory() and time() methods have been removed.\n Memory and time values are now returned by the stop() method.\n\n RELATED\n\n * hou.perfMon\n\n * hou.PerfMonProfile\n\n * hou.PerfMonRecordOptions\n\n * Performance monitor pane\n\n\n \"\"\"\n thisown: Incomplete\n def __init__(self, *args, **kwargs) -> None: ...\n __swig_destroy__: Incomplete\n def id(self) -> int:\n \"\"\"\n\n id(self) -> int\n\n Return the event's unique identifier which is used internally by the\n performance monitor.\n\n This method is deprecated.\n\n\n \"\"\"\n def name(self) -> str:\n \"\"\"\n\n name(self) -> str\n\n Return the event name.\n\n This method is deprecated.\n\n\n \"\"\"\n def object(self) -> str:\n \"\"\"\n\n object(self) -> str\n\n Return the object that the event applies to. Return None if the\n event is not associated with an object.\n\n\n \"\"\"\n def isAutoNestEnabled(self) -> bool:\n \"\"\"\n\n isAutoNestEnabled(self) -> bool\n\n Return True if the event will automatically 'nest' other events that\n are started and stopped while this event is running. When the event\n is stopped, it will decrement the times and memory of its nested\n events from its total time and memory. That way, the event's total\n time and memory will reflect the work performed in the event itself\n and not in any of its nested events.\n\n\n \"\"\"\n def stop(self) -> Tuple[float, ...]:\n \"\"\"\n\n stop(self)\n\n Stop the event timer and return a 2-tuple, (