Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[hdEmbree] minor fixes / tweaks (hdEmbree-UsdLux-PR03) #3185

Merged

Conversation

pmolodo
Copy link
Contributor

@pmolodo pmolodo commented Jul 31, 2024

Description of Change(s)

Small changes in HdEmbree, that don't depend on any UsdLux changes

  • Factored out a separate _CalculateHitPosition utility function
  • Documentation typo fix

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:
#3183 Diff vs previous #3234

⛓️ 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
Contributor

Filed as internal issue #USD-9903

@jesschimein
Copy link
Contributor

/AzurePipelines run

Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@pmolodo pmolodo changed the title [hdEmbree] minor fixes / tweaks [hdEmbree] minor fixes / tweaks (hdEmbree-UsdLux-PR03) Aug 7, 2024
- forward-declare some types as struct instead of class (avoids msvc
  compiler warning)
- comment typo fix
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.

3 participants