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

Nodes: Introduce Node.needsUpdate=true #27904

Merged
merged 4 commits into from
Mar 12, 2024
Merged

Conversation

sunag
Copy link
Collaborator

@sunag sunag commented Mar 12, 2024

Related issue: Closes #27895

Description

In the vast majority of cases, cacheKeys are being generated without any real need, which would be to change the TSL code, causing overloading. This PR introduces node.needsUpdate=true so that the system can identify when it is really necessary to recreate the Node's cacheKey.

Comparation

Comparison below of webgpu_backdrop_water in the range of 1 to 4 seconds.

Before Now
image image

When should I use it?

Every time you need to update a specific Node chain, for exemple:

// mix( a, b, c ) = mix( aNode, bNode, cNode )
material.colorNode = mix( color( 0x0487e2 ), color( 0x0066ff ), normalWorld.y );

// ... in the software cycle

material.colorNode.aNode = color( 0xffffff );
material.colorNode.needsUpdate = true;
@sunag sunag marked this pull request as ready for review March 12, 2024 04:49
@sunag sunag added this to the r163 milestone Mar 12, 2024
@RenaudRohlinger
Copy link
Collaborator

This solution is so good!! 🙏

@mrdoob
Copy link
Owner

mrdoob commented Mar 12, 2024

this.version and this._version?

@RenaudRohlinger
Copy link
Collaborator

In the WebGLRenderer the strategy was often this.version !== thisProperties.__version.

Would rename this._version to this.__version be better? Where this.__version is basically this.cachedVersion.
/cc @mrdoob

@mrdoob
Copy link
Owner

mrdoob commented Mar 12, 2024

Ah right yes.
Forgot about the internal usage...

Looking good then! Let's follow how we did it in WebGLRenderer. I've never seen anyone having issues with it.

@sunag sunag merged commit 4736375 into mrdoob:dev Mar 12, 2024
11 checks passed
@sunag sunag deleted the dev-optimization branch March 12, 2024 15:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
4 participants