{"id":31039601,"url":"https://github.com/pablode/usdshadeview","last_synced_at":"2025-09-19T14:02:55.378Z","repository":{"id":314493400,"uuid":"1055642514","full_name":"pablode/usdshadeview","owner":"pablode","description":"usdview plugin for inspecting shading networks","archived":false,"fork":false,"pushed_at":"2025-09-12T18:21:54.000Z","size":25,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-12T20:54:59.128Z","etag":null,"topics":["materialx","openusd","qt","usd"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pablode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-12T15:13:55.000Z","updated_at":"2025-09-12T19:24:39.000Z","dependencies_parsed_at":"2025-09-12T20:55:03.599Z","dependency_job_id":"4f654e4e-8557-4e41-b23d-c8e831984966","html_url":"https://github.com/pablode/usdshadeview","commit_stats":null,"previous_names":["pablode/usdshadeview"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pablode/usdshadeview","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablode%2Fusdshadeview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablode%2Fusdshadeview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablode%2Fusdshadeview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablode%2Fusdshadeview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pablode","download_url":"https://codeload.github.com/pablode/usdshadeview/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pablode%2Fusdshadeview/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275076591,"owners_count":25401318,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["materialx","openusd","qt","usd"],"created_at":"2025-09-14T08:01:00.354Z","updated_at":"2025-09-16T10:24:02.488Z","avatar_url":"https://github.com/pablode.png","language":"Python","funding_links":[],"categories":["Libraries \u0026 Tools"],"sub_categories":["Technical Explanation"],"readme":"# usdshadeview\n\nA usdview plugin for inspecting UsdShade networks.\n\n\u003cp align=\"middle\"\u003e\n  \u003cimg width=\"1293\" height=\"1060\" src=\"https://github.com/user-attachments/assets/0088b54e-3ab0-4426-971a-9524e6c44807\" /\u003e\n\u003c/p\u003e\n\n## Installation\n\nCopy the `lib` and `plugin` directories into your USD installation directory.\n\nFor [Advanced Instructions](#advanced-installation) see below.\n\n## Features\n\n### 1. Node Graphs\n\nusdshadeview visualizes [UsdShade NodeGraphs](https://openusd.org/release/api/class_usd_shade_node_graph.html) and Materials (which are specialized node graphs) in an interactive Qt dialog:\n\n\u003cp align=\"middle\"\u003e\n  \u003cimg width=\"1959\" height=\"559\" src=\"https://github.com/user-attachments/assets/0d686165-0eed-49ea-98f4-26b0d65a2b42\" /\u003e\n\u003c/p\u003e\n\nThe dialog can be shown by **right clicking** a prim of one of both types, which brings up a new option in the context menu:\n\n\u003cimg width=\"484\" height=\"330\" src=\"https://github.com/user-attachments/assets/eaf5291b-cda6-4585-8dcd-6e4470c8fddf\" /\u003e\n\nThe network shown in the dialog has a layout depending on network topology, and node colors are based on the classification (USDA, MaterialX, MDL, OSL, node graph, unknown). Child node graphs can be entered using the \"E\" button.\n\nIt is also possible to **right click** value widgets, which exposes following actions:\n\n\u003cimg width=\"277\" height=\"144\" src=\"https://github.com/user-attachments/assets/d6841521-b734-45d0-92fb-c391674ab653\" /\u003e\n\nIn the main graph dialog, the menu bar offers following features:\n- _View_ → _Filter Output_: filter nodes and connections to a single output\n- _Tools_ → _Bake to Texture_: (only for MaterialX materials) invoke UsdBakeMtlx\n- _Tools_ → _Export as Image_: save the scene with a transparent background\n\n**Note:** To display thumbnails for EXRs, the _OpenImageIO_ python package has to be additionally installed.\n\n### 2. Node Def Info\n\nClicking the \"?\" button of a node widget opens up the node definition dialog which lists all inputs and outputs with their respective documentation.\n\n\u003cimg width=\"752\" height=\"454\" src=\"https://github.com/user-attachments/assets/1f7c3cb7-7483-4607-9970-df4782349c0b\" /\u003e\n\nThe information is only available for nodes registered in the Sdr registry.\n\n### 3. Sdr Node List\n\nA list of all nodes in the Sdr registry can be accessed from the usdview menu bar _Window_ → _Sdr Nodes_ submenu.\n\n\u003cimg width=\"606\" height=\"399\" src=\"https://github.com/user-attachments/assets/5e6e84db-50aa-4039-a65e-031ad45a76e2\" /\u003e\n\nClicking on an entry brings up its node definition dialog.\n\n## Compatibility\n\nI have tested this plugin on Windows and macOS with PySide2 and PySide6, and Python 3.7, 3.9 and 3.11.\n\nIt has been verified to be compatible with OpenUSD versions down to v22.11.\n\n## Advanced Installation\n\nThe plugin can be used outside of the build tree by setting following environment variables:\n* `PYTHONPATH` to include `\u003cREPO_ROOT\u003e/lib/python`\n* `PXR_PLUGINPATH_NAME` to include `\u003cREPO_ROOT\u003e/plugin/usd/usdshadeview/resources`\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpablode%2Fusdshadeview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpablode%2Fusdshadeview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpablode%2Fusdshadeview/lists"}