erical harmonics is equal with the given one. * * @param {SphericalHarmonics3} sh - The spherical harmonics to test for equality. * @return {boolean} Whether this spherical harmonics is equal with the given one. */ equals( sh ) { for ( let i = 0; i < 9; i ++ ) { if ( ! this.coefficients[ i ].equals( sh.coefficients[ i ] ) ) { return false; } } return true; } /** * Copies the values of the given spherical harmonics to this instance. * * @param {SphericalHarmonics3} sh - The spherical harmonics to copy. * @return {SphericalHarmonics3} A reference to this spherical harmonics. */ copy( sh ) { return this.set( sh.coefficients ); } /** * Returns a new spherical harmonics with copied values from this instance. * * @return {SphericalHarmonics3} A clone of this instance. */ clone() { return new this.constructor().copy( this ); } /** * Sets the SH coefficients of this instance from the given array. * * @param {Array} array - An array holding the SH coefficients. * @param {number} [offset=0] - The array offset where to start copying. * @return {SphericalHarmonics3} A clone of this instance. */ fromArray( array, offset = 0 ) { const coefficients = this.coefficients; for ( let i = 0; i < 9; i ++ ) { coefficients[ i ].fromArray( array, offset + ( i * 3 ) ); } return this; } /** * Returns an array with the SH coefficients, or copies them into the provided * array. The coefficients are represented as numbers. * * @param {Array} [array=[]] - The target array. * @param {number} [offset=0] - The array offset where to start copying. * @return {Array} An array with flat SH coefficients. */ toArray( array = [], offset = 0 ) { const coefficients = this.coefficients; for ( let i = 0; i < 9; i ++ ) { coefficients[ i ].toArray( array, offset + ( i * 3 ) ); } return array; } /** * Computes the SH basis for the given normal vector. * * @param {Vector3} normal - The normal. * @param {Array} shBasis - The target array holding the SH basis. */ static getBasisAt( normal, shBasis ) { // normal is assumed to be unit length const x = normal.x, y = normal.y, z = normal.z; // band 0 shBasis[ 0 ] = 0.282095; // band 1 shBasis[ 1 ] = 0.488603 * y; shBasis[ 2 ] = 0.488603 * z; shBasis[ 3 ] = 0.488603 * x; // band 2 shBasis[ 4 ] = 1.092548 * x * y; shBasis[ 5 ] = 1.092548 * y * z; shBasis[ 6 ] = 0.315392 * ( 3 * z * z - 1 ); shBasis[ 7 ] = 1.092548 * x * z; shBasis[ 8 ] = 0.546274 * ( x * x - y * y ); } } /** * Light probes are an alternative way of adding light to a 3D scene. Unlike * classical light sources (e.g. directional, point or spot lights), light * probes do not emit light. Instead they store information about light * passing through 3D space. During rendering, the light that hits a 3D * object is approximated by using the data from the light probe. * * Light probes are usually created from (radiance) environment maps. The * class {@link LightProbeGenerator} can be used to create light probes from * cube textures or render targets. However, light estimation data could also * be provided in other forms e.g. by WebXR. This enables the rendering of * augmented reality content that reacts to real world lighting. * * The current probe implementation in three.js supports so-called diffuse * light probes. This type of light probe is functionally equivalent to an * irradiance environment map. * * @augments Light */ class LightProbe extends Light { /** * Constructs a new light probe. * * @param {SphericalHarmonics3} sh - The spherical harmonics which represents encoded lighting information. * @param {number} [intensity=1] - The light's strength/intensity. */ constructor( sh = new SphericalHarmonics3(), intensity = 1 ) { super( undefined, intensity ); /** * This flag can be used for type testing. * * @type {boolean} * @readonly * @default true */ this.isLightProbe = true; /** * A light probe uses spherical harmonics to encode lighting information. * * @type {SphericalHarmonics3} */ this.sh = sh; } copy( source ) { super.copy( source ); this.sh.copy( source.sh ); return this; } toJSON( meta ) { const data = super.toJSON( meta ); data.object.sh = this.sh.toArray(); return data; } } const _customMaterials = {}; /** * Class for loading materials. The files are internally * loaded via {@link FileLoader}. * * ```js * const loader = new THREE.MaterialLoader(); * const material = await loader.loadAsync( 'material.json' ); * ``` * This loader does not support node materials. Use {@link NodeMaterialLoader} instead. * * @augments Loader */ class MaterialLoader extends Loader { /** * Constructs a new material loader. * * @param {LoadingManager} [manager] - The loading mana