Renderer: .setRenderObjectFunction()

[sunag]

Related issue: #25822, #27053, #25933

Description

renderer.renderObjectFunction() offers the ability to filter or change the object in the rendering state, this fixes the current optimization problem in shadow rendering in WebGPURenderer and can also be used in cases like this #25933 and others where users use scene.traverse() to make the filter of objects could use this method which already pass through the frustumCulled filter.

Usage

function renderObjectFunction( object, ...params ) {

	if ( object.castShadow === true ) {

		renderer.renderObject( object, ...params );

	}

}


renderer.setRenderTarget( rtt );
renderer.setRenderObjectFunction( renderObject );

renderer.render( scene, camera );

[mrdoob]

.setRenderObjectFunction() may be better?

[LeviPesin]

Maybe it would be simpler to do something like... renderer.setRenderObjectFilter( object => object.castShadow === true )? /ping @sunag

[sunag]

I think setRenderObjectFunction is more handler-oriented than filter-oriented. If there were any changes I would suggest setRenderObjectHandler.

[LeviPesin]

Yeah, I certainly agree "handler" would be a better name -- but I just think maybe it would be better for a user-facing API to be simpler and don't provide full "handling" behavior, but only the "filtering" one.

[sunag]

We have more applications this way, for example, such as adding onBeforeShadow and onAfterShadow soon.