TSL: Support defined color spaces in ColorSpaceNode

[donmccurdy]

Adds support to 'ColorSpaceNode' (and related chaining helpers) for any color space registered on THREE.ColorManagement. Adds a generic X-to-Y chaining TSL node:

import {
  DisplayP3ColorSpace,
  DisplayP3ColorSpaceImpl,
  LinearDisplayP3ColorSpace,
  LinearDisplayP3ColorSpaceImpl
} from 'three/addons/math/ColorSpaces.js';

THREE.ColorManagement.define( {
  [ DisplayP3ColorSpace ]: DisplayP3ColorSpaceImpl,
  [ LinearDisplayP3ColorSpace ]: LinearDisplayP3ColorSpaceImpl,
} );

const color1 = color2.convertColorSpace( LinearDisplayP3ColorSpace, DisplayP3ColorSpace );

Related:

• ColorManagement: Add ColorManagement.define( { ... } ) #29450
• WebGPURenderer: Add HDR Support #29573
• Roadmap for supporting wide-gamut color workflows #26479

/cc @WestLangley @sunag

[github-actions]

📦 Bundle size

Full ESM build, minified and gzipped.

	Before	After	Diff
WebGL	692.42 171.34	692.42 171.34	+0 B +0 B
WebGPU	816.84 220.03	816.59 220.02	-246 B -9 B
WebGPU Nodes	816.35 219.9	816.1 219.89	-246 B -5 B

🌳 Bundle size after tree-shaking

Minimal build including a renderer, camera, empty scene, and dependencies.

	Before	After	Diff
WebGL	464.65 112.12	464.65 112.12	+0 B +0 B
WebGPU	538.6 145.39	538.35 145.36	-248 B -31 B
WebGPU Nodes	494.71 135.27	494.46 135.22	-248 B -49 B

[donmccurdy]

Hm, I'm not sure what to do with this circular dependency:

• src/nodes/tsl/TSLBase.js
  • src/nodes/display/ColorSpaceNode.js
    • src/nodes/display/ColorSpaceFunctions.js
      • src/nodes/tsl/TSLBase.js

I'm tempted to move the EOTF and OETF implementations into ColorSpaceNode.js. @sunag do you have a preference?

[sunag]

I have plans to have the color space information present in the flow of code, that way we will always know what the color space source of the current value. I was thinking about adding a node.toColorSpace( targetColorSpace ) function in the method chaining.

Maybe we could reverse the order to:

addMethodChaining( 'toColorSpace', ( node, targetColorSpace, sourceColorSpace = null  ) => convertColorSpace( node, sourceColorSpace, targetColorSpace ) );

Thinking about the future... Or maybe just remove this method from chaning for now?