Skip to content

Conversation

@pmolodo
Copy link
Contributor

@pmolodo pmolodo commented Jul 31, 2024

Description of Change(s)

This modifies the hdEmbree example plugin to do direct lighting so as to provide a reference implementation of the expected behaviour for UsdLux.

If no lights are present in the stage, the old ambient occlusion path will be used.


Related PRs:

This PR is part of a chain of PRs that provide a reference implementation of UsdLux as part of hdEmbree.

◀️ Previous PR in chain: 🔽 This PR changes only: ▶️ Next PR in chain:
#3198 Diff vs Previous

Due to a github limitation, this PR must include all previous PRs in the chain. To see JUST the changes in this PR vs the previous in the chain, click this link

#3196

⛓️ All PRs in this chain:

📃 Documentation PR:
This chain of PRs (implementing UsdLux support in hdEmbree), was made separate from the PR documenting expected UsdLux behavior:

✳️ All UsdLux update related PRs:
To see ALL UsdLux update related PRs (documentation AND reference implementation) in one place, see:

Original PR:
These PRs are an update of this original PR:


But... why??

Why make these PRs in the first place?

The current specifications of the various UsdLux prims + attributes are imprecise or vague in many places, and as a result, actual implementations of them by various renderers have diverged, sometimes quite significantly. For instance, here is Intel's 4004 Moore Lane scene, with the same UsdLux lights defined, in 3 different renderers:

Karma:
4004 Moore Lane, rendered in Karma

Arnold:
4004 Moore Lane, rendered in Arnold

Omniverse RTX:
4004 Moore Lane, rendered in Omniverse RTX

For a full descpription of the problem, see here:

Why so many PRs?
This was my attempt to break up a rather large change into smaller, more easily reviewable changes, that can be merged in incrementally, to help ease the burden for code reviewers.

If you find this confusing, and would rather just one big PR (ie, just this one), or have them organized in some other way, please let me know!

Why are the documentation changes in their own PR?
In some ways, the documentation changes are the heart of this effort - we wish to specify more exactly what the various UsdLux prims and attributes represent. However, building consensus on this may take time - so we expect some dialogue on the exact language or formulas.

Because that may take time, the hdEmbree reference implementation changes are separate, and broken up, so we can hopefully start integrating portions of them even before final consensus has been reached on the final form of the specification.

Why are the documentation changes not broken up into smaller pieces, like the hdEmbree reference implementation changes?
Because I wasn't sure if that would be desirable or not! If people think that would be helpful, I can do so - perhaps breaking out by schema or individual attribute?


  • I have verified that all unit tests pass with the proposed changes
  • I have submitted a signed Contributor License Agreement

@jesschimein
Copy link
Collaborator

Filed as internal issue #USD-9904

@jesschimein
Copy link
Collaborator

/AzurePipelines run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@pmolodo pmolodo changed the title [hdEmbree] Initial UsdLux reference implementation [hdEmbree] Initial UsdLux reference implementation (hdEmbree-UsdLux-PR04) Aug 7, 2024
@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from a6a9136 to 9088c1b Compare September 23, 2024 18:11
@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from 9088c1b to 2c9ff46 Compare October 21, 2024 17:06
@pmolodo pmolodo changed the title [hdEmbree] Initial UsdLux reference implementation (hdEmbree-UsdLux-PR04) [hdEmbree] Initial UsdLux reference implementation (hdEmbree-UsdLux-PR06) Oct 21, 2024
@jesschimein
Copy link
Collaborator

/AzurePipelines run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch 3 times, most recently from be07932 to 76c2135 Compare October 23, 2024 18:20
@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from 76c2135 to db8377c Compare January 28, 2025 22:27
@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from db8377c to 3a6afbf Compare February 5, 2025 17:28
@jesschimein
Copy link
Collaborator

/AzurePipelines run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from 3a6afbf to 93974aa Compare June 11, 2025 22:22
@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from 93974aa to 98641e4 Compare July 24, 2025 16:46
This modifies the hdEmbree example plugin to do direct lighting so as to
provide a reference implementation of the expected behaviour for UsdLux.

If no lights are present in the stage, the old ambient occlusion path
will be used.
@pmolodo pmolodo force-pushed the pr/hdEmbree-usd-lux-ref-implementation branch from 98641e4 to 99a672b Compare July 24, 2025 21:26
Copy link
Contributor

@tcauchois tcauchois left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lots of really great improvements here! :). Had to make a few changes locally and it's running through testing for (hopefully) the final time! Let me know your take on my comments so we can land this.

@pixar-oss pixar-oss closed this in 1493197 Aug 25, 2025
meshula pushed a commit to meshula/USD that referenced this pull request Sep 11, 2025
This modifies the hdEmbree example plugin to do direct lighting so as to provide a reference implementation of the expected behaviour for UsdLux.

If no lights are present in the stage, or if direct lighting is turned off (default) via the render setting "enableLighting", the old ambient occlusion path will be used.

The intent for this implementation is to be spec-compliant and readable, more than scalable.

Closes PixarAnimationStudios#3186

(Internal change: 2376413)
(Internal change: 2376439)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants