an optional root object. Before using this method make * sure to call {@link AnimationAction#stop} to deactivate the action. * * @param {AnimationClip|string} clip - An animation clip or alternatively the name of the animation clip. * @param {Object3D} [optionalRoot] - An alternative root object. */ uncacheAction( clip, optionalRoot ) { const action = this.existingAction( clip, optionalRoot ); if ( action !== null ) { this._deactivateAction( action ); this._removeInactiveAction( action ); } } } /** * Represents a 3D render target. * * @augments RenderTarget */ class RenderTarget3D extends RenderTarget { /** * Constructs a new 3D render target. * * @param {number} [width=1] - The width of the render target. * @param {number} [height=1] - The height of the render target. * @param {number} [depth=1] - The height of the render target. * @param {RenderTarget~Options} [options] - The configuration object. */ constructor( width = 1, height = 1, depth = 1, options = {} ) { super( width, height, options ); /** * This flag can be used for type testing. * * @type {boolean} * @readonly * @default true */ this.isRenderTarget3D = true; this.depth = depth; // overwrite attachments with 3D textures for ( let i = 0; i < this.textures.length; i ++ ) { const texture = new Data3DTexture( null, width, height, depth ); texture.isRenderTargetTexture = true; texture.renderTarget = this; this.textures[ i ] = texture; } this._setTextureOptions( options ); } } /** * Represents a uniform which is a global shader variable. They are passed to shader programs. * * When declaring a uniform of a {@link ShaderMaterial}, it is declared by value or by object. * ```js * uniforms: { * time: { value: 1.0 }, * resolution: new Uniform( new Vector2() ) * }; * ``` * Since this class can only be used in context of {@link ShaderMaterial}, it is only supported * in {@link WebGLRenderer}. */ class Uniform { /** * Constructs a new uniform. * * @param {any} value - The uniform value. */ constructor( value ) { /** * The uniform value. * * @type {any} */ this.value = value; } /** * Returns a new uniform with copied values from this instance. * If the value has a `clone()` method, the value is cloned as well. * * @return {Uniform} A clone of this instance. */ clone() { return new Uniform( this.value.clone === undefined ? this.value : this.value.clone() ); } } let _id = 0; /** * A class for managing multiple uniforms in a single group. The renderer will process * such a definition as a single UBO. * * Since this class can only be used in context of {@link ShaderMaterial}, it is only supported * in {@link WebGLRenderer}. * * @augments EventDispatcher */ class UniformsGroup extends EventDispatcher { /** * Constructs a new uniforms group. */ constructor() { super(); /** * This flag can be used for type testing. * * @type {boolean} * @readonly * @default true */ this.isUniformsGroup = true; /** * The ID of the 3D object. * * @name UniformsGroup#id * @type {number} * @readonly */ Object.defineProperty( this, 'id', { value: _id ++ } ); /** * The name of the uniforms group. * * @type {string} */ this.name = ''; /** * The buffer usage. * * @type {(StaticDrawUsage|DynamicDrawUsage|StreamDrawUsage|StaticReadUsage|DynamicReadUsage|StreamReadUsage|StaticCopyUsage|DynamicCopyUsage|StreamCopyUsage)} * @default StaticDrawUsage */ this.usage = StaticDrawUsage; /** * An array holding the uniforms. * * @type {Array} */ this.uniforms = []; } /** * Adds the given uniform to this uniforms group. * * @param {Uniform} uniform - The uniform to add. * @return {UniformsGroup} A reference to this uniforms group. */ add( uniform ) { this.uniforms.push( uniform ); return this; } /** * Removes the given uniform from this uniforms group. * * @param {Uniform} uniform - The uniform to remove. * @return {UniformsGroup} A reference to this uniforms group. */ remove( uniform ) { const index = this.uniforms.indexOf( uniform ); if ( index !== -1 ) this.uniforms.splice( index, 1 ); return this; } /** * Sets the name of this uniforms group. * * @param {string} name - The name to set. * @return {UniformsGroup} A reference to this uniforms group. */ setName( name ) { this.name = name; return this; } /** * Sets the usage of this uniforms group. * * @param {(StaticDrawUsage|DynamicDrawUsage|StreamDrawUsage|StaticReadUsage|DynamicReadUsage|StreamReadUsage|StaticCopyUsage|DynamicCopyUsage|StreamCopyUsage)} value - The usage to set. * @return {UniformsGroup} A reference to this uniforms group. */ setUsage( value ) { this.usage = value; return this; } /** * Frees the GPU-related resources